IoT Devices
AMI and IoT endpoints that post their own reads: each with a key the server makes and a secret shown once, its health (last seen, battery, signal) and its alarms.
Where to find it
- Module: CRM
- Group: Utilities
- Section: Utility Meters & Reads
- Screen: IoT Devices
Address in the console: /crm/util-iot-devices
List · 12 columns · 7 fields on its form · 1 of them required · 1 action
What the list shows
These are the columns of the list, in the order they are drawn. Any of them can be sorted on, filtered on, hidden, or exported.
| Column | Kind | Field name |
|---|---|---|
| Device | Text | device_label |
| Key | Code | key_id |
| Meter | Code | meter_serial |
| Signs with | Status | auth_mode |
| Status | Status | status |
| Last seen | Date and time | last_seen_at |
| Battery % | Number | battery_pct |
| Signal dBm | Number | signal_dbm |
| Firmware | Code | firmware |
| Open alarms | Number | open_alarms |
| Refused | Number | rejected_count |
| Secret ends | Code | secret_last4 |
The form
What is asked for when a record is created here. Required fields are marked; a choice drawn from a configuration list is one an administrator can extend without a release.
| Field | Type | Choices | Notes |
|---|---|---|---|
| Label required | Text | ||
| Meter | Choice | Looked up from existing records | |
| Signs with | Choice | hmac, bearer, both | hmac: an HMAC-SHA256 signature of each request. bearer: the key and secret as a token. |
| Status | Choice | active, disabled, retired | |
| Reads per minute at most | Number | ||
| Firmware | Text | ||
| Notes | Long text |
What you can do here
New secret
Asks for confirmation: Issue a new secret? The device stops being accepted until it is given the new one.
The rules that apply here
Everything on this screen obeys the platform rules rather than rules of its own. The ones worth knowing before you use it:
- Narrowing a list — search, conditions, sort, totals, export and saved views.
- What may be changed — the five grounds a record may not be edited on.
- Companies and business units — what the switcher above this list is doing to it.
- Creating a record — required fields, where choices come from, and how the number is allocated.
- Importing a spreadsheet — this screen accepts one, and it runs through the same rules as typing.