Devices
The Devices tab lists every board with its live state, its firmware and config, and everything you need to judge it at a glance.
Find a device and see its state
Six tiles sit above the list. Click one to show only those devices, click it again or click Sensors to show all. The active filter also appears as a chip next to the search, where its × removes it.
| Tile | Counts |
|---|---|
| Sensors | Every device in your fleet. Click it to remove the filter. |
| Healthy | Devices that report on time. |
| Delayed | Devices whose readings arrive late. |
| Offline | Devices that stopped reporting. |
| Update available | Devices that can take a newer firmware over the air right now. |
| Jobs running | Devices with an open job, from Queued to Verifying. |
The search looks at the name, the chip family, the firmware version and the template name. Type custom to find devices without a template. Group sorts the list by template (the default), by chip family, by status, or not at all. Every group has a Select group button. Columns turns the optional columns on and off and has Compact rows for long lists. The browser remembers your choice.
| Column | Shows |
|---|---|
| Device | Health dot, name, chip family and template, or Custom setup. |
| Live state | What the device is doing right now. See the next section. |
| Firmware | The version the board reports, with a hint below it. |
| Config | Config revision, plus drifted when the device left its template. Optional. |
| Contact | Last contact (94 s ago, just now) and the next expected one (next in ~5 min, overdue). Optional. |
| Battery | Battery level from the battery channel, amber below 30 %. USB without a battery channel. Optional. |
| Errors 7d | Share of refused readings and missed rounds over seven days, with a small trend line. Amber from 3 %. Optional. |
Tick devices to select them. A bar appears at the bottom with Update firmware, which goes straight to the check for the latest firmware, and Bulk change… for everything else. The checkbox in the header selects every device the filter shows. On a phone each device is a card with the same facts, and the list never scrolls sideways.
The gear next to Columns opens Fleet settings with your Default verify mode. It appears once you own at least one sensor.
What each device is doing right now
The Live state column combines the open job, the monitoring status and what the board last reported. States that are happening right now pulse. A download shows a progress bar.
| State | Meaning |
|---|---|
| Running stable | Healthy, no open job. Right after an update it adds "Updated to 0.5.1 just now". |
| Sending reading | A reading arrived within the last three seconds. |
| Asleep | Healthy, in deep sleep or hibernate between rounds. Shows when it wakes. |
| Queued | A job waits for the next check-in of an awake device. |
| Offered | The update went out with the reply to the last reading. |
| Waiting for check-in | A job waits for a sleeping or silent device. It starts on the next contact. |
| Downloading update | The board loads the new firmware. Shows the percentage and the size. |
| Restarting | The board boots into the new firmware. |
| Verifying firmware | The new firmware checks itself, for example "Strict · try 1 of 3 · max 2 min". |
| Applying config | The board writes the new config. The old one stays as a backup. |
| Verifying config | The new config checks itself, the same way as new firmware. |
| Rolled back | The last update failed its check within the last 24 hours. The board runs its old version again. The reason is shown. |
| Delayed | Readings arrive late. Shows how many rounds were missed. |
| Offline | No contact for a long time. Check power or network. |
| No data yet | The device has never sent a reading. |
The Jobs running tile counts Queued, Offered, Waiting for check-in, Downloading, Restarting, Applying and both Verifying states. Healthy, Delayed and Offline follow the same rule as Sensor Monitoring.
What the board runs and what it can take
The version comes from the board itself. It reports it with every reading, together with its config revision (r14), restarts, WiFi signal and sensors that failed to read. The hint below the version says what the device can take.
| Hint | Meaning |
|---|---|
| → 0.5.1 | A newer firmware is ready for this board. Update it from the selection bar, the details or Bulk change. |
| latest | The board runs the latest firmware. |
| config only | ESP8266: config changes go over the air, new firmware needs USB. |
| needs USB once | HydroNode firmware that cannot update itself yet. Reflash it once with the device builder. |
| own sketch | Your own code with the HydroNode library. Listed with health and errors, not updated by HydroNode. |
| ESPHome | Built with ESPHome. ESPHome installs its own updates. |
| not reported | The board has not sent its version. Firmware before 0.5.0 and older libraries do not report it. |
| LoRaWAN | A LoRaWAN device. It takes no updates over the air. |
The Config column shows the config revision. It counts up with every flash and every config change, so r15 after r14 means the board took the new settings. The chip drifted marks a device that came from a template but was changed on its own since.
One device, everything about it
Click a row to open its details on the right. The address bar gets ?device=…, so you can bookmark or share the view. Esc, the close button, a click next to the panel or the back button closes it.
- 1StateThe live state in large type with time since the last contact, a sentence that explains it and the five job steps from Queued to Installed.
- 2ProblemsWhat the device reported going wrong, in plain words: a power drop or crash that restarted it, WiFi that rejected the password or was not found, a sensor that does not answer (with the pins of its saved setup to check), and a round that keeps it awake far longer than its setup needs. Firmware 0.6.0 and later also report how long the last round was awake.
- 3ActionsUpdate to the latest firmware, Change config or Reflash via USB. The first button reads Up to date, Needs USB reflash, Config only or Job running when an update is not possible, and its tooltip says why. Change config opens the device builder for this device; the arrow next to it offers Bulk change instead. When the device takes no config, the reason stands under the buttons.
- 4FactsFirmware, config revision, last and next contact, battery, signal (dBm, Ethernet, or RSSI and SNR for LoRaWAN), verify mode and template. Click Verify mode to choose Account default, Strict or Lenient for this device.
- 5Error rateRefused readings, missed rounds, refused commands, failed or rolled back updates and restarts, each for 24 hours and 7 days with a trend line.
- 6Device setupWhat the device builder put on the board: sensors with bus, pins and values, outputs, and how it reports. Marked "differs from template" when it drifted.
- 7JobsThe last ten jobs with who started them, the verify mode, the result and the reason.
- 8ConsoleThe last twelve lines of the Device Console, live. Open console jumps to the full console on the sensor page.