Jetstream API
Jetstream Navigator
Device Details
10min
this page opens to the specific device selected from the all devices page, either by clicking the device name or selecting the view option in the quick action menu once you navigate to the page, the device details will be loaded for that device, including 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 name the name of the device serial number the serial number of the device 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 deleted (inactive) websocket connected (commands will be received by the device immediately) or disconnected (commands will be executed when the device does its poll for commands) region the geographic region where the terso 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 jetstream 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 it allows the searching, sorting, filtering, and export of the last 30 days of events from the device the table includes a date range setting to filter the events based on received time the default date range is from yesterday to today the table is sorted by received time descending (most recent events first), and includes the following columns event type the type of event all event types are listed in the 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 this column contains a filter so that you can 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 rl8govwbokktttojfnn5 documentation for more details on each event event message a brief summary of the key contents of the events not all event types have details generated received time the time that the event was received, as timestamped by jetstream the table also includes a table options button this table allows you to show additional columns in the table for event guid and generated time 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 7onvtntdtfl9ptdal2nvo command and update the tag list based on the commandcompletionevent docid\ sj1tshbqvf4fri6az1ywg , as appropriate the "get tags" button will trigger a get all rfid tags docid 7onvtntdtfl9ptdal2nvo command and update the tag list based on the commandcompletionevent docid\ sj1tshbqvf4fri6az1ywg , as appropriate last update the date/time of latest object or aggregateevent from the device, or click of the get tags button, 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 passes are added to the current list when 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 passes are removed from the current list when you click "save" commands the commands tab displays many of the device commands docid\ mxiogfjjtfpvtw2eh1xj1 that are available for the device, as determined by the device definition if a device type supports none of these commands, navigator will display, "device's definition does not currently support any commands " 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