Inspector User Guide

The Afero Inspector provides a real-time, in-depth view of the state of each device associated with a given Afero account. The tool is useful for developers when testing and debugging device behavior.

You can open the Inspector by going to https://inspector.afero.io then signing in with your Afero developer account.

The Inspector Home window

After you sign in, the Inspector Home window appears:

Inspector Home Window

This window offers you the following information and actions:

  • Directly under the Welcome banner is the number of total devices associated with your account and the currently active (online) devices.
  • A “card” is shown for each of your associated devices. Within each card you’ll see the device icon, the device’s friendly name, Device ID (alpha-numeric string under the device name), and connectivity status.
  • Click the Device ID to copy the ID to your clipboard.
  • View details for any of your devices by selecting the associated card. (Read more in Device Details Window.)
  • The icons in the upper-right of the window are links to the following:
    • Inspector Home Window Icon- Returns you to this Home window from the Device Details or Account Information windows.
    • Inspector Account Icon- Opens a window with your account information. (Read more in Developer Account Information.)
    • Inspector User Guide Icon- Opens this Inspector User Guide in a new window.
    • Inspector Sign Out Icon- Signs you out from Inspector.

Device Details Window

After you select a device card in the Home window, that device’s Details window opens. To look at the details for a different device, use the left-hand Navigation pane, where all the devices associated with your account are listed. Devices with an orange dot are online; devices with a greyed-out dot are offline.

Inspector Device Details Window

The selected device details are presented in the following panes:

Attribute Tabs

The attributes relevant to the selected device are displayed in two tabs: Device Attributes and Afero System Attributes.

You can download the information and even edit the READ/WRITE attributes from these windows.

  • ClickInspector Download Icon(there is one on each tab) to download the attribute information to a file in JSON format.
  • You can edit READ/WRITE attribute values in real-time when the device is online; these values are indicated with a pencil icon. Click the pencil to edit and update a value:
    Edit Attribute Value
    ClickCheck Iconto save or dismiss the edit box. If the value you type is invalid or if your device is offline, you’ll see an error message (in orange text) in the Device Log pane.

Device Attributes

The Device Attributes tab details the activity of your device attributes:

Field Description Example
Attribute ID Attributes are identified by a 2-byte ID and can contain a variable amount of information based on the type of attribute. Attributes can come in many types and have specific ID ranges. 1024
Attribute Name Name assigned to this attribute. You assign device attributes in the Afero Profile Editor. LED
Value Current value of the attribute. 1
Operations Operations that have been set for the attribute in the device profile. READ/WRITE
Last Update Timestamp of when the attribute was last changed. Jun 21st 2018, 9:55 AM

Afero System Attributes

The attributes shown in the Afero System Attributes tab are generally set by the Cloud and read by the ASR module, but they can also be set by ASR. For a description of these attributes, refer to the Device Attribute Registry.

RSSI - Wi-Fi/Bluetooth Signal Strength

For the selected device, this pane displays either the Received Signal Strength Indicator (RSSI) signal status for Wi-Fi or, if the device is connected via Bluetooth and a hub, the signal strength (in dBm), as seen by the hub(s).

ClickInspector Collapse Iconto show/hide this pane.

Wi-Fi RSSI

For devices connected via Wi-Fi, the following information is displayed (see above for illustration):

Field Description Example
Last Reported Wi-Fi SSID Name of the Wi-Fi network the device is connected to. SHAW-66E150
Last Reported Wi-Fi Bars Wi-Fi signal strength for UI purposes. -48
Last Reported Wi-Fi Steady State

Wi-Fi connection state when last stable. The value is used to communicate the Wi-Fi state to the applications outside the Wi-Fi setup.

Possible values are:

  • 0 = Not Connected
  • 1 = Pending
  • 2 = Connected
  • 3 = Unknown Failure
  • 4 = Association Failed
  • 5 = Handshake Failed
  • 6 = Echo Failed
  • 7 = SSID (Network Name) Not Found
  • 8 = NTP (Network Time Protocol) Failed
2 (Connected)

Bluetooth RSSI

For devices connected via Bluetooth and a hub, the RSSI is primarily a function of distance and battery power; but of course there are other interferences, such as refractions, reflections, and scattering. RSSI is expressed in decibels from 0 (zero) to -120db. (Zero being the strongest signal.) Typical values will be between -25 (a few inches away) and -100 (~50 meters away).

RSSI for Bluetooth Connections

Device Log

This section lists the activity (events) between this device and Afero in real-time.

  • ClickInspector Download Iconto download the log contents to a file. Note that this file also contains the current RSSI connectivity data.
  • ClickInspector Clear Iconto remove the current log contents.

Device Information

This section contains details that you have defined for the device in the Afero Profile Editor, as well as system-assigned information, such as device location. ClickInspector Download Iconto download the device information to a file.

Field Description Example
Device ID Unique alphanumeric string assigned to every Afero Platform device. 01231732d62ca571
Profile ID Unique alphanumeric string assigned to a device profile. ED2B11B7‑1597‑42E7‑8E0A‑3F1AF92E347D
Partner ID Unique alphanumeric string assigned to the partner with which the developer is associated. 3BFFBED9‑D443‑4962‑89D1‑59B4B06E3864
Device Type ID Universally unique identifier (UUID) value that maps to a specific Device Type (thermostat, washing machine, camera, etc.). Device Type IDs are unique across the Platform and do not change even if you change a device name. 0B84D736‑240D‑4D2D‑9696‑34B9DF138F49
Latitude/Longitude Latitude/longitude of the device’s last reported location. 48.415876094949 , -123.318191214954

Developer Account Information

To view your account information, clickInspector Account Iconin the upper-right of the window. Most of the information in this section was provided by you when registering for an Afero developer account:

Field Description Example
Name The given name and surname you used when registering your Afero developer account. Cera Smith
User ID Unique alphanumeric string assigned to you. 47622660‑D8BE‑40CB‑9F7B‑XXXXXXXXXXXX
Username (email) Email address that you used when registering your Afero developer account. csmith@example.io
Accounts Name and ID of all Afero accounts you are part of. Cera Enterprise - 43facfc9‑aae3‑4fb4‑9ed1‑9c5cfxxxxxxx
Partners Any partners with which you are associated. Smart & E-Z Corp - 91812ca6‑69fc‑45b2‑bbbb‑d7112xxxxxxx