Jetstream API
Jetstream Navigator
Device Details
12min
this page opens to the specific device selected from the all devices page you can also navigate to this page directly from the menu and search for a device by name or serial number selecting a device you can select a device by either entering a device name entering a device serial number then selecting "go" both fields will autosuggest matching devices as you type in the field the name field will suggest both active and inactive devices (inactive will be indicated by an "(inactive)" label), while the serial number field will only suggest active devices once a device is selected, the device details will be loaded for that device, this will include the device information sidebar, the events tab, and additional tabs, depending on the device definition device information once a device is selected, the device information sidebar will load with several pieces of data about the device first, at the very top next to the device information header, are the "configuration" options, in the quick action ( ) menu edit change the editable fields for the currently selected device, including device name, serial number, and device definition delete delete the device from jetstream, rendering it "inactive" within the sidebar itself, the following info may be available if a piece of info is not available, it will display "unknown" device definition the name of the device definition associated with the device the device definition defines what commands and parameters are available to a device policy the name of the policy associated with the device the policy defines the baseline configuration parameter values of the device status active (in jetstream) or inactive (deleted from jetstream) this does websocket connected (commands will be received by the device immediately) or disconnected (commands will be executed when the device does it's poll for commands) region the geographic region that the rfid device is being placed this is used to create the most reliable and lowest latency connection to the device options are us, eu, ap, & usgov added on the date/time the device was first created in jetstream application name the application to which the device was added last comm the most recent time the device communicated an event of any type last aggregateevent the most recent aggregateevent the device communicated last objectevent the most recent objectevent the device communicated agent the version of terso's firmware running on the device reader the version of firmware the rfid reader on the device is running sensor data the values from the most recent sensorreadingevent from the device events the events tab is the default device details tab, and allow the searching, sorting, filtering, and export of all events from the device the filters include event type select all types of events you wish to view in the table from the selected date range by default, all types will be displayed see the event types docid\ idzrd9kaz2ommxnq6gy documentation for more details on each event received time select any start and end date range longer ranges may take longer to load the default is today and yesterday search filter the rows in the table down to only rows which contain the search term all columns are searchable the table is sorted by generated time descending (most recent events first), and includes the following columns event type the type of event all event types are listed int he event types filter above the table clicking the link will open the exact json of the jetstream event in a modal window, including additional info beyond the 4 columns of the table note that the dates and times in this json message are always in utc note that sensorreadingevents will occupy multiple rows for improved table feature function, although the various sensors are all reported in a single sensorreadingevent details a brief summary of the key contents of the events not all event types have details generated generated time the time that the event actually occurred, as timestamped by the device firmware received time the time that the event was received, as timestamped by jetstream tags the tags tab is the second device details tab, and presents the "current" count and list of rfid tag epcs in the device's read range, as determined by the latest objectevent, plus or minus any tags reported as added or removed in aggregateevents following the latest objectevent the "get tags" button will trigger a get all rfid tags docid\ ci32mn8hwosbcmjmdu4tp command and update the tag list based on the commandcompletionevent docid\ t 7slqwzzeabu593fnbwt , as appropriate the "get tags" button will trigger a get all rfid tags docid\ ci32mn8hwosbcmjmdu4tp command and update the tag list based on the commandcompletionevent docid\ t 7slqwzzeabu593fnbwt , as appropriate last update the date/time of latest object or aggregateevent from the device which updated the tag list credentials the credentials tab will not appear for some device types which do not offer secured access controls for those which do require a credential to be presented for access, this tab displays the count and list of current credentials (10 40 digit hexadecimal values) the last sync date/time is the last time a sync was successfully completed the current list is re synced with the device every time "save" is selected on this tab (sends a "sync device credentials" command) note that credentials can be added and removed in a single command, but for clarity we will present the add and remove credentials steps separately adding credentials in the "add" field, enter any number of 10 40 digit hexadecimal rfid pass values you would like to allow to access this device enter each value on a new line, with no additional characters no passes are actually added until you click "save" removing credentials from the "current list" simply select a credential to move it into the "remove" column you may remove any number of credentials passes can be "unremoved" (placed back in current list) by selecting them in the remove column no passes are actually removed until you click "save" commands the commands tab displays many of the device commands docid\ y5jyztu yrfznqvzqyb2m that are available for the device, as determined by the device definition if a device type supports none of these commands, a "device's definition does not currently support any commands" message will be displayed the following commands may be available on this tab for your device restart instruct the device to restart this takes roughly 1 2 minutes, during which the device will not be accessible enter an execution date/time, and "execute" to schedule the command a scheduled restart cannot be undone lockdown instructs the specified device to lock for a defined number of hours during a lockdown period, a device cannot be accessed, even with valid credentials set value to 0 to end an active lockdown enter a number of locked hours between 0 and 168 hours enter an execution date/time, and "execute" to schedule the command unlock a device's door virtually presents a device credential to the device to unlock its door for the duration defined by the doorunlocktimelimit parameter of the device's policy default is 5 seconds " enter a a 10 40 character hexadecimal number or a 36 character guid if a 10 40 character hexadecimal number is defined, it needs to be in the access control list of the device enter an execution date/time, and "execute" to schedule the command update firmware update the firmware version for a device at a specified date and time enter the url for the firmware update enter the date and time for the firmware update to execute some commands are handled elsewhere in navigator, and will not be replicated here including sync device credentials and get last device credentials sync date/time of the credentials tab, and get device status (the "websocket" status in the device information sidebar ) some device commands are not yet available in navigator, including get all rfid tags, get a device's configuration parameter's, and set a device's configuration parameters aliases the aliases tab displays a list of the aliases that are associated with the device policy create, edit, or view policies associated with the device local access generate a one time multi factor authentication passcode for the device the passcode updates every 30 seconds