MQTT Reference

Base Topic

scalior-slc-{MAC}/

Where {MAC} is the device's MAC address in lowercase without separators, e.g. scalior-slc-aabbccddeeff/.

---

Master Topics (global for entire staircase)

Prefix: scalior-slc-{MAC}/M/

Topic	Direction	Values	Description
M/Switch	pub / sub	0 / 1	Turn all lighting on/off
M/Standby	pub / sub	0 / 1	Standby mode (night lighting)
M/Sensors	pub / sub	0 / 1	Enable/disable motion sensors
M/Brightness	pub / sub	25–100	Brightness (%)
M/UpperSens	pub	0 / 1	Top sensor state
M/BottomSens	pub	0 / 1	Bottom sensor state
M/Illuminance	pub	0–255	Light sensor reading
M/LightSensorState	pub	0 / 1 / 2	Sensor state: 0=off, 1=bright, 2=dark
M/Version	pub	string	Firmware version
M/Uptime	pub	number	Uptime (seconds)

---

Flight Topics

Prefix: scalior-slc-{MAC}/{N}/, where {N} = 1–4.

Topic	Direction	Values	Description
{N}/Switch	pub / sub	0 / 1	Turn flight on/off
{N}/Standby	pub / sub	0 / 1	Flight standby mode
{N}/Sensors	pub / sub	0 / 1	Flight sensors
{N}/Brightness	pub / sub	25–100	Flight brightness (%)
{N}/UpperSens	pub	0 / 1	Top sensor triggered
{N}/BottomSens	pub	0 / 1	Bottom sensor triggered

Flight topics are only available if the Master topics only mode is not enabled in MQTT settings.

---

Command Examples

Turn on all lighting

Topic:   scalior-slc-aabbccddeeff/M/Switch
Payload: 1

Set flight 2 brightness to 75%

Topic:   scalior-slc-aabbccddeeff/2/Brightness
Payload: 75

Enable standby mode

Topic:   scalior-slc-aabbccddeeff/M/Standby
Payload: 1

Disable sensors for flight 1

Topic:   scalior-slc-aabbccddeeff/1/Sensors
Payload: 0

---

Metadata (retained)

The device publishes JSON descriptions of its topics in retained messages:

scalior-slc-{MAC}/M/meta   → master topic descriptions
scalior-slc-{MAC}/{N}/meta → flight N topic descriptions

---

Home Assistant Integration

Example configuration for automatic addition via MQTT Discovery or manual addition:

# configuration.yaml
mqtt:
  light:
    - name: "Staircase"
      state_topic: "scalior-slc-aabbccddeeff/M/Switch"
      command_topic: "scalior-slc-aabbccddeeff/M/Switch"
      brightness_state_topic: "scalior-slc-aabbccddeeff/M/Brightness"
      brightness_command_topic: "scalior-slc-aabbccddeeff/M/Brightness"
      brightness_scale: 100
      payload_on: "1"
      payload_off: "0"

  sensor:
    - name: "Staircase Illuminance"
      state_topic: "scalior-slc-aabbccddeeff/M/Illuminance"
      unit_of_measurement: "lx"

---

"Master Topics Only" Mode

If the Master topics only option is enabled in MQTT settings:

• Only M/* topics are published
• 1/* – 4/* topics are not used
• Suitable for simple single-flight installations

---

Quality of Service (QoS)

All messages are published with QoS 0. The retained flag is set for metadata and status topics.