Devices come in a wide variety of shapes, sizes and feature sets, but what they all have in common is the ability to report the presence and movement of RFID-tagged items. Many devices report temperature, some can report who took the items based on secure badge access, and a couple can even report their geolocation and battery levels.

To learn more about the characteristics and features of specific devices, please visit tersosolutions.com, or review the Device Types section of the API documentation.

Viewing Devices

Devices can be viewed and managed on the My Devices page available from the Admin Console menu.

Users will be able to see all devices that are in the Jetstream application currently selected in their profile.

Device Details

To view a device's details, click the name of the device. In the details page you will all the available information and commands for that device. The top gray box contains general info about the device, as well as a list of applicable action buttons on the top right.

  1. Name* - The unique name of the device.
  2. Serial Number* - The unique digital serial number of the device, may be labeled "DSN" on the device. Note that this is not the hardware serial number.
  3. Device Definition* - The device's model, hardware region, and major firmware version for Terso devices. This information is necessary for Jetstream to know how to communicate with the device.
  4. Policy - The device's policy, which specifies the values that should be set for each of the device's configuration parameters. Currently this can only be set through the API or by contacting Terso Support, not through Admin Console
  5. Region* - The general region of the world where the device is installed. Does not have to match the hardware region in the Device Definition, since the regions listed here are less specific than those in the device definition can be. This value cannot be edited. To change a region, delete and re-add the device.
  6. Last Communication - The last time the device sent any event to Jetstream.
  7. Last Transaction - The last time the device sent an aggregateevent to Jetstream.
  8. Number of Items - The total number of items read by the device when the device last reported its inventory.
  9. Sensor Date - Some devices contain sensors, which are reported to Jetstream in a sensorreadingevent. All data in the device's latest sensorreadingevent will be displayed here. This can include:
    1. TemperatureA - The last reported temperature, in Celsius, from temp probe A.
    2. TemperatureB - The last reported temperature, in Celsius, from temp probe B.
    3. Battery Level - The last reported percentage battery level of the device. This is only reported by mobile cases. Backup batteries in devices such as fridges and freezers do not report their battery level.
    4. Latitude - The latitude where the mobile case is currently positioned in degrees.
    5. Longtitude - The Longitude where the mobile case is currently positioned in degrees.
    6. Range - The measure of error from the Latitude/Longitude point where the mobile case is currently positioned in meters.
    7. Signal Strength - The cellular network signal strength where the mobile case is currently positioned in dB.
  10. Device Simulator - This only appears if you have selected the developer mode checkbox in your profile. Allows you to generate events as if they came from the device (the device will not actually be sending these events).

    Use the Device Simulator only for testing or troubleshooting your integration, preferably on a Jetstream device added explicitly for the purpose of testing. Using the simulator on an active physical device could cause data inaccuracies for your Jetstream integration.

  11. Lock this Device - Issues a Lock a Device command which will prevent any access to the cabinet for a specified number of hours (between 1-168). Issuing a Lock of 0 hours will cancel any existing lockdown.
  12. Restart this Device - Issues a Restart a Device command which will cause the device to immediately restart as soon as it receives the command.
  13. Edit this Device - See Editing Devices below. 
  14. Delete this Device - See Deleting Devices below.

Device Inventory

  1. Inventory Tab- Contains a list of all RFID tags currently considered in the device, a last updated time, and the ability to generate a GetEPCList Command.
  2. Last Updated - The date and time that a change to the device's inventory was reported (via either an aggregateevent, an objectevent, or a GetEPCList Command)
  3. Get All RFID Tags - Issues a GetEPCList Command to the device. The device will respond within a few minutes if it is online. Note that no inventory change may be reported.
  4. The list of all RFID Tag EPC's (Electronic Product Codes) currently in the device's inventory, as calculated by the latest objectevent plus or minus any aggregateevent adds and removes.

Passes

If a device does not have secure access functionality, the passes tab will not be available.

  1. Passes Tab - Contains a list of all passes that can currently access the device, a last updated time, and the ability to add or remove passes.
  2. Add Passes - List any number of Pass RFID values to add to the device's access list, placing each on a separate row, then press ADD. Triggers a create or modify device credentials command, followed by a sync credentials command.
  3. Last Updated - Displays the last time that passes were added to or deleted from the device.
  4. The list of all pass RFID values that are currently allowed to access the device.
  5. Delete Passes - Remove the pass from the device's access list, prevenitng future access. Triggers a delete device credentials command, followed by a sync device credentials command.

Aliases

Only the TS084 RFID Handheld Reader will display the Aliases tab.

  1. Aliases Tab - Contains a list of all Aliases currently available to this device, and the ability to add or remove aliases.
  2. Add Aliases - Select any number of Aliases from the dropdown, and click Add. The dropdown is populated via a Get All Alias Names call. Clicking add triggers a Modify a Device call, with an updated Aliases array. To add Aliases to your application, see the My Device Aliases page.
  3. The list of all Aliases currently assigned to the device. The user of hte RFID Handheld can then select any of the available Aliases to report along with the objectevent.
  4. Remove Aliases - Remove the alias from this device, by triggering a Modify a Device call, with a updated Aliases array. To delete the Alias from your application altogether, see the My Device Aliases page.

Events

The Events tab displays all events from, and commands to, the device over the past 30 days. Click the Event Id number to see the complete details of the event in its original JSON formatting.


Adding Devices

You can add a device using the Create a Device API endpoint, or you can add a device via Admin Console (which makes the call to Create a Device with your user access key for you).

To add a device:

  1. Press "Add Device" in the top left of the Devices page.
  2. Enter a Device Name. The name must be universally unique across all Jetstream applications, not just your own. The name can contain numbers, letters, and the _ character. No spaces or other special characters are allowed.
  3. Enter the Device Serial Number (DSN). This will be labeled on the device.
  4. Select a Device Definition. First find the device definitions that start with the TS0XX model number labeled on the device. Then, find the device definitions that contain your country abbreviation. Finally, select the device definition with the highest listed Firmware (FW) version number.
  5. Select a Region. Simply make the region selection that is closest to where the device will be located. USGOV should only be used if you have been explicitly instructed to use this region.
  6. Click Save Changes to finish adding the device. The device will now appear in the devices table. Once it is powered and connected to the internet, it will now begin reporting its data to Jetstream, which Admin Console will display.

Editing Devices

  1. On the My Devices page, click the device name link
  2. In the device details page, click the pencil icon in the top right, and make any desired changes in the window that appears.
  3. Click "Save Changes" to save the edited record. To cancel your edits, simply close the edit popup without saving.

Deleting Devices

  1. On the My Devices page, click the device name link for the device you wish to delete.
  2. On the Device Details page that opens, click the circular delete icon in the top right.
  3. In the "Delete Device" confirmation window that appears, click "Delete Device " to confirm the deletion of the device. This cannot be undone. Clicking "Cancel" or the X in the top right of the window will not delete the device.