Device settings

Device settings

Every device card has a gear button. It opens the settings dialog, which has five tabs: Settings, Data, Logs, Update and Access.

Settings

The everyday options.

FieldWhat it does
NameWhat the device is called throughout the interface. Changing it here doesn’t touch your firmware.
IconThe picture on the device card. Handy when you have a row of identical boards.
NotificationsWhich service delivers notifications from this device — see below
Home PageA URL for the device, e.g. its own web page on your network
Device InfoFree text for your own notes

Notifications

When your firmware sends a notification, this setting decides how it reaches you:

  • Sensordata app (the default) — a push notification to the Sensordata Android app, on every phone you’re signed into. Each person with access chooses whether they receive them, in the Access tab. Tapping one opens the device’s dashboard.
  • Pushover — sent through Pushover instead. You’ll need to supply your Pushover token and user key for the device.

There’s a test button next to the setting, which sends a notification immediately so you can check delivery without waiting for your device to send a real one.

Nothing arrives?

For the Sensordata app, the most common causes are notifications not being switched on for your user in the Access tab, the app not having been opened and signed into on that phone yet, or Android’s notification permission for the app being off. Signing out of the app stops its notifications until you sign in again.

Data

A JSON editor for the device’s connection data — a small object the platform hands to your device each time it connects. Use it for settings you want to change without reflashing: thresholds, intervals, a server address.

Your firmware receives it in the connected callback. The editor validates the JSON before saving and enforces a size limit, so keep it small.

This tab is not a view of your sensor history.

Logs

Messages your device has sent up as logs, newest first, with controls to refresh and to clear the list. This is the first place to look when a device is behaving oddly but is still online.

Update

Two things live here.

OTA Update — upload a compiled .bin and the device installs it over the air and reboots. The device must be online. Don’t cut power while it’s writing.

File Transfer — send a small file (up to 4 kB) to the device. It arrives in the firmware’s fileReceived callback, which is told who sent it. Going the other way — asking the device for a file and downloading it — is what the dashboard’s File element is for.

Access

Sharing with other people, and deleting the device — covered in Sharing a device.