integration
Finding your Display Screen's MQTT base topic
Every ROAMiQ Display Screen publishes under roamiq/panel/<device_id>. Grab your device ID from Settings → MQTT.
Every ROAMiQ Display Screen publishes all of its MQTT traffic under a unique base topic:
roamiq/panel/<device_id>
For example: roamiq/panel/roamiq_a1b2c3d4.
You'll need this when you:
- Write custom Home Assistant automations that don't use auto-discovery
- Subscribe to the screen in Node-RED
- Debug with MQTT Explorer
Where to find your device ID
1
On the tablet, swipe down and tap Settings.
2
Select MQTT Settings.
3
Your Device ID is shown as roamiq_xxxxxxxx.
Your full base topic is roamiq/panel/ followed by that device ID.
Common subtopics
| Subtopic | Purpose |
|---|---|
<base>/availability | online / offline (retained) |
<base>/sensor/wifi | Wi-Fi signal strength JSON |
<base>/led/state + /led/set | RGB LED state and command |
<base>/brightness/state + /brightness/set | Screen brightness 0–255 |
<base>/volume/state + /volume/set | Media volume 0–100 |
<base>/command/wake | Publish ON to wake the screen |
<base>/command/sleep | Publish ON to sleep the screen |
A complete reference lives in the User Guide on the Display Screen manual page.