Chapter 6

Troubleshooting

Common issues and their resolutions
T1 - Device Unreachable After IP Change
Symptom: Browser cannot connect after saving new network settings.
Browser redirected to old IP.
Manually navigate to the new IP address in the browser address bar.
New IP is on a different subnet from the operator's computer.
Ensure both the SM5000 and the operator's PC are on the same network segment before saving.
IP conflict with another device on the network.
Connect the SM5000 directly (isolated) and use the LCD to read the current IP, then resolve the conflict.
DHCP was selected but no DHCP server is available.
The device falls back to the static IP stored in NVS. Check the LCD for the displayed IP address.
T2 - MQTT Shows "Disconnected" in System Status
Symptom: System Status shows 🔴 Disconnected for MQTT.
SyncFM is not running or is unreachable.
Verify the SyncFM service is active on the host machine.
Broker IP in MQTT settings does not match the SyncFM host.
Verify the broker address in §2.4.
Firewall or switch ACL blocking port 1883 between the SM5000 and SyncFM host.
Check switch ACLs and any firewall rules on the SyncFM host for port 1883.
Broker requires credentials that have not been configured.
Check the MQTT username and password fields in §2.4.
Device recently rebooted and is still in the reconnect window.
MQTT reconnect interval is 60 seconds. Wait and refresh the System Status page.
T3 - Sensor Reading Shows 0.0
Symptom: Sensor Front or Sensor Rear reads 0.0°C / 0.0%RH.
Sensor not connected or RJ12 cable is loose.
Check the physical connection. Both operational sensors share the same RS485 bus - either port (Port 1 or 2) is valid as long as the Modbus ID on the sensor matches.
Sensor Modbus address mismatch.
The SM5000 polls Modbus ID 1 for Sensor Front and ID 2 for Sensor Rear. Verify the sensor’s configured address matches.
Faulty sensor or cable.
Swap with a known-good sensor to isolate the fault.
A calibration offset of −100 has been set accidentally, driving the reading to zero.
Check the calibration offsets in §2.2.2 and reset if necessary.
T4 - 24-Hour Charts Not Loading
Symptom: The Data Logger page loads but the chart area is blank.
SyncFM is unreachable.
The chart library (Chart.js) is served by SyncFM at port 3000. If SyncFM is down or that port is blocked, the library cannot load. All other Data Logger functionality (CSV export, statistics) remains available regardless.
No logged data yet.
Check the Total Entries counter. If it reads 0, the device has not yet logged any data since the last factory reset or since time sync was first acquired.
Time source not synced - DataLogger is paused.
The DataLogger only writes entries once a valid time is acquired. If the sync state is AWAITING_SYNC, logging is paused. Check the Time page (§3).
T5 - OTA Update Not Triggering / Failing
Symptom: A firmware update was initiated from SyncFM but the device does not begin downloading, or the update fails part-way through.
MQTT not connected.
The OTA command is delivered via MQTT. If the device shows 🔴 Disconnected, it will never receive the command. Resolve the MQTT connection first - see T2.
Time not synchronised - even if MQTT is connected.
OTA security verification requires the device to have a valid, accurate current time. If the Time page shows AWAITING_SYNC or UNSYNCED_NEVER, OTA commands cannot be processed. Ensure SyncFM's time broadcast is reaching the device - this is the recommended resolution since MQTT is already connected. If SyncFM cannot reach the device for time sync, set the device's Default Time to the current time manually via the Time page (§3.3) as a temporary workaround. If MQTT is connected but time is not syncing, check that the MQTT topic hierarchy is correctly configured - a mismatch can prevent time broadcasts from being received.
MQTT topic hierarchy mismatch.
The OTA security check is bound to the device's configured MQTT hierarchy path. If the hierarchy on the device does not exactly match what SyncFM has on record, the command is silently discarded. Verify the full topic in §2.4.
Incorrect passkey uploaded to SyncFM.
The passkey entered in SyncFM when uploading the firmware binary must match the passkey compiled into the target device’s firmware. Re-upload the firmware to SyncFM with the correct passkey.
Stagger delay - device appears idle.
Each device waits up to 150 seconds before beginning its download. Allow at least 3 minutes from when SyncFM broadcast the command before concluding the device has not received it.
Network instability during download.
Up to 3 total attempts are made automatically (3-minute intervals). If failures persist, check the switch port for link drops. After all 3 attempts fail, the device reports the failure to SyncFM and resumes normal operation - it does not require manual intervention.
Firmware file not present on SyncFM.
Verify the firmware binary for the target version was uploaded to SyncFM before triggering the update.
T6 - Web Interface Unreachable (No IP Change)
Symptom: Browser cannot connect to the device at its known IP address.
Device is mid-OTA update.
The web interface is suspended during OTA. Wait 2-3 minutes and retry. The LCD will show the OTA progress states.
Device has lost its Ethernet link.
Check the physical cable and PoE switch port. The LCD will show Connecting... / Waiting for IP if there is no active link.
Session token is being blocked by the browser.
Try a different browser or clear cookies, then log in fresh.
Free memory critically low.
In rare cases, the web server can become unresponsive under a memory exhaustion condition. A power cycle will recover the device.
T7 - Factory Reset Does Not Restore Expected IP / Device Name
Symptom: After factory reset, the device boots with an unexpected IP address or device name.
An OTA firmware update was applied prior to the factory reset.
Factory reset restores the defaults embedded in the currently installed firmware, which may differ from the originally shipped firmware. This is expected behaviour. Reconfigure the IP address and device name manually via the web interface after the reset. See §5.4 for details.