Status LED

A lamp, or the state written out, over a Bool point, an alarm or a point that reports a state code.

Status LED is the glance indicator: one point shown as a colored lamp, or as the state's name written out in the integrator's own words. It is a Display component; a new one occupies 3 × 1 cells. The indication takes the whole cell, centred — naming it is a Label you place where you want it.

Bound to a plain point, the LED reads its truthiness. Bound to an alarm (Alarms.<name>), the value read is the alarm's active state, and the LED blinks while the alarm awaits acknowledgement — both while it is active unacknowledged and during the cleared-but-unacknowledged latch.

Data

Field	What it does	Values	Default
Address	The rooted Logic address of the watched point: a Bool point, `Alarms.<name>`, or — once states are declared — the point reporting the state code. The suggestion list leads with Bool points.	Free text; suggestions from the live point list	empty

State

The section asks about the two sides of a flag or about a declared list of states, never both: one of the two is in force, and the panel shows only that one.

The two sides of a flag

Field	What it does	Values	Default
Shows	The two drawings this kind has: a colored lamp, or the state's declared wording in its own color.	`A lamp` · `The state, written out`	`A lamp`
On	The named palette color while the point reads true.	`Green` · `Red` · `Yellow` · `Orange` · `Blue` · `Gray`	`Green`
Off	The color while the point reads false.	same palette	`Gray`
On text / Off text	What the written-out presentation says for each side. Explicit because the two sides of a state are your vocabulary — "Running", "Open", "Auto" — and no component can guess which pair a flag stands for. Only asked of the presentation that writes them.	Free text	`On` / `Off`

The color palette is the LED's own fixed set, painted the same in the editor's pickers and on the canvas; Gray is the neutral. What a color means is your convention — the component reads none.

Declared states

A point reporting a code (stopped, starting, running, faulted) has more than two sides. Declare states writes the two sides above down as the first two states and opens a row to fill, so nothing already configured is authored twice. Each state is one card:

Field	What it does	Values	Default
value	The code the point reports while the plant is in this state. Matched exactly — what lies between two codes is not a state. A flag reports 1 for its true side and 0 for the other.	Any number	empty (declares nothing until typed)
color	The state's palette color.	the same fixed palette	`Gray`
text	What the written-out presentation says while this state is in force; blank writes nothing. The widest declared word is what the written state reserves room for, so the word keeps one size as the plant moves between states.	Free text	empty
icon	Optional mark drawn in place of the lamp while this state is in force — picked from the app's icon library by name, searched by name or tag. Only the lamp presentation asks for one; a name the catalog does not carry draws no mark and leaves the lamp. `—` in the grid is the choice of no icon.	Catalog icon name	none

The rows order themselves by their codes — the list read top-down is the state word counting up — and a row with no code yet waits at the end. Removing every state hands the indicator back to the two sides of a flag. A value no state claims is shown as it came, never as the nearest state.

What the indicator shows

The lamp and the written state answer the same three situations, each in its own vocabulary:

Situation	Lamp	Written out
A state (or flag side) is in force	Solid lamp in the state's color; the state's icon replaces the lamp when one is named; the tooltip carries the state's word	The state's word, in the state's color
The point answered, but no declared state claims the reading	A solid neutral ring — not a state's color, which would claim a state the declaration does not have	The reading itself, written out (the number as the station writes one, or the raw answer for a non-numeric point)
The point fails to read	A hollow lamp	The gap dash `—`

Only the third situation lights the shared bad-reading mark on the component (see the components page); good-quality silence hollows the lamp without marking the component. Only a visible (readable) LED blinks.

Status LED is a display component: it commands nothing and never wears the lock mark. The shared Appearance, Position and layer and Actions sections are described on the components page.