Gateway LED State Indicator

Overview

This feature is not available to BlueRange Gateways prior to V4.

The BlueRange Gateway (starting from V4) can indicate its state to the outside world by using a built-in status LED on the right side (not to be confused with the power button LED).

gateway v4 led

OS Versions starting from 2024-12-03_19-03

An orange LED sequence indicates that the gateway is either booting or that an error has occured. A green LED sequence indicates that the gateway is performing as intended. A single flash takes around one second and a sequence of flashes is always followed by a two second pause.

It is possible to use the BlueRange Setup App for in detail information, except if the BlueRange Gateway is in the Booting or BlueRange Connect USB not found state.

State	Description	Sequence
Booting	The Gateway software is booting or has encountered an internal error while booting (if the state does not change after more than 5 minutes).	One orange flash: 🟧 [2s pause]
No BlueRange Server connection	Internet or Network connection faulty, misconfigured or BlueRange server not running. Use the BlueRange Setup App for in detail information.	Two orange flashes: 🟧 - 🟧 [2s pause]
BlueRange Connect USB not found	No BlueRange Connect USB is plugged in (or dysfunctional).	Three orange flashes: 🟧 - 🟧 - 🟧 [2s pause]
Ready but not enrolled	The Gateway is functional but not enrolled with a BlueRange Server. (The network connectivity cannot be checked without an enrollment).	One green flash: 🟩 [2s pause]
Ready but BlueRange Mesh not connected	The Gateway is working but not connected to other BlueRange Mesh devices.	Two green flashes: 🟩 - 🟩 [2s pause]
Ready	Everything is working as expected.	Constant Green: 🟩

State

Description

Sequence

Booting

The Gateway software is booting or has encountered an internal error while booting (if the state does not change after more than 5 minutes).

One orange flash:
🟧 [2s pause]

No BlueRange Server connection

Internet or Network connection faulty, misconfigured or BlueRange server not running. Use the BlueRange Setup App for in detail information.

Two orange flashes:
🟧 - 🟧 [2s pause]

BlueRange Connect USB not found

No BlueRange Connect USB is plugged in (or dysfunctional).

Three orange flashes:
🟧 - 🟧 - 🟧 [2s pause]

Ready but not enrolled

The Gateway is functional but not enrolled with a BlueRange Server. (The network connectivity cannot be checked without an enrollment).

One green flash:
🟩 [2s pause]

Ready but BlueRange Mesh not connected

The Gateway is working but not connected to other BlueRange Mesh devices.

Two green flashes:
🟩 - 🟩 [2s pause]

Ready

Everything is working as expected.

Constant Green:
🟩

OS Versions lower than 2024-12-03_19-03

Table 1. The different LED indications. A short flash is ~0.5 seconds and depicted by 🟩-, a long flash is ~2 seconds and depicted by 🟩🟩-
State	Sequence
`invalid` The Gateway software has not started or an internal error occured	Long Orange Flashes 🟧🟧 - 🟧🟧 - 🟧🟧 [no pause]
`starting` The Gateway software is running, the state is not yet known	3 Long Green Flashes 🟩🟩 - 🟩🟩 - 🟩🟩 [3s pause]
`ready_but_no_bluerange_connection` No connection to the BlueRange server, e.g. no internet or network	3 Short Flashes: green, orange, orange 🟩 - 🟧 - 🟧 [3s pause]
`ready_but_not_enrolled` The Gateway is not enrolled in BlueRange	3 Short Flashes: green, green, orange 🟩 - 🟩 - 🟧 [3s pause]
`ready_but_bluetooth_not_available` No BlueRange Connect USB Dongle is plugged in (or dysfunctional)	3 Short Orange Flashes 🟧 - 🟧 - 🟧 [3s pause]
`ready_but_bluetooth_not_connected` The Gateway is not connected to the mesh (e.g. when no other devices but the gateway have been enrolled or the mesh cannot be reached)	3 Short Green Flashes 🟩 - 🟩 - 🟩 [3s pause]
`ready_and_dfu_in_progress` A BlueRange Mesh update is in progress	Alternating Green + Yellow 🟩 - 🟨 - 🟩 - 🟨 [no pause]
`ready` Everything is working	Constant Green 🟩