This is an old revision of the document!
Table of Contents
FAQ
What does the QR Code mean on the back side of the case?
If you scan the QR code with a mobile phone, you will be directed to the “Node Admin page” of this device. URL https://opentrafficmap.org/service/?nodeId=nodeXXX ATTENTION: Please change the “User Passwort” to protect your node settings!
What do the LEDs mean?
| Label | Color | Meaning |
|---|---|---|
| SYS | red / white | |
| RCV | orange | |
| ETH | green | |
| MQT | blue | |
| PKT | purple |
Does it matter which USB-C port powers it?
My phone won't do USB tethering — why?
Common causes:
- The cable is a charge-only cable with no data wires → use a proper data cable.
- USB tethering is not enabled on the phone (Settings → Hotspot/Tethering).
- The node's port is a power-only port (see above).
- Missing driver / USB role (host vs. device) — some nodes must be configured as USB host.
Is there a data buffer when offline?
No. At the moment (Firmware 0.5.1) ther is no support for local data logging to the SD-card.
Which antennas can I use?
The node with the case has an integrated antenna. (comes with the ESP32)
Why is my node so hot?
Typical temperature is about 55°C.
Possible reasons:
- Status LEDs at full power (set via Admin Node Portal > Set brightness (0 = off, 255 = maximum)
- Direct sunlight on outdoor installations.
In direct sunlight in summer season more than 83°C where seen. 
Why is reception poor despite good height?
- interference of a 5GHz WALN Access Point near by → seperate devices od deactivate 5GHz (ESP32 only uses 2.4GHz)
- indoor usage (Tinted windows also reflect waves) → mount outdoor
How do I monitor my node in Home Assistant?
Common approaches:
- MQTT: the node publishes telemetry to a broker, HA reads it via the MQTT integration.
From there you can build sensors, automations, and dashboards in HA.
PoE vs USB powered / jumper settings?
To switch the mode, the blue jumper must be removed and placed on the correct pins.
| Connector | Mode |
|---|---|
| 802.3af | PoE Mode - Power is supplied via LAN cable. |
| Passive | USB Mode - Power supply comes via USB port (it doesn't matter which one) |
Does the node support WIFI?
No. The Espressif ESP32 C5 is used to receive the C-ITS signals only. So you have to use the LAN port.
How to view the raw data (MQTT packets) the node sends to the server?
To view (“subscribe” in MQTT language) you can use the MQTT client of your choice.
Here's a (incomplete) list of clients:
| OS | MQTT Client | Homepage |
|---|---|---|
| Linux | MQTTX | https://mqttx.app |
| Linux | MQTT Explorer | https://mqtt-explorer.com |
| Linux | MQTT Viewer | https://mqttviewer.app |
| Windows | MQTTX | https://mqttx.app |
| Windows | MQTT Explorer | https://mqtt-explorer.com |
| Windows | MQTT.fx | https://mqttfx.jensd.de |
| Mac | MQTTX | https://mqttx.app |
| Mac | MQTT Explorer | https://mqtt-explorer.com |
| Mac | MQTT Viewer | https://mqttviewer.app |
How does OpenTrafficMap know the location of my node?
The location is unknown until you specify it in the Node Admin Portal under “Set coordinates on map”.