About

RFID Mobile Cases are Jetstream enabled devices used to transport, protect, and track field or mobile inventory. These devices not only support most Jetstream commands and events, but extend them by adding mobile features such as Geolocation through Location Based Services (LBS). To learn more, visit https://www.tersosolutions.com/products/rfid-mobile-case/.

Model: TS080

Commands


ConfigParameters

NameDescriptionData TypeMinMaxDefaultFirmware
AggregateEventScanCountNumber of times the case should scan after an end user closes the lid.Int11002v4.7+
AggregateEventScanDelayNumber of seconds the case should wait between scans after an end user closes the lid.Int1601v4.7+
AggregateEventScanTimeThe time of each individual scan in seconds after an end user closes the lid.Int13002v4.7+
AntennaTxPowerThe dB transmit power of all antennas.Int102323v4.7+
BatteryCriticalThe battery percentage threshold to flag if the battery is at a critical charge level. In this state, the case will not perform RFID scans. It may also not be able to communicate depending on charge level.Int22010v4.7+
BatteryLedEnable the LED to indicate battery level.Bool010v4.7+
BatteryLowThe battery percentage threshold to flag if the battery is at a low charge level. The case will continue to operate normally by scanning and communicating results.Int55020v4.7+
CommsReconnectIntervalTime in seconds to wait before attempting to communicate with Jetstream if there were any communication problems.Int06010v4.7+
CommsTimeoutTime in seconds to wait for a reply from Jetstream after sending an event or command response.Int06010v4.7+
ConnectRetriesNumber of times to retry connecting to the cellular network.Int153v4.7+
JetstreamDeviceUrlThe URL to which the case sends Jetstream messages.String--us-device.jetstreamrfid.comv4.7+
JetstreamVersionVerson of Jetstream that the events will be available after DWS receives them
 "3" - sends to v3 endpoints as v3 JSON events
"2" - send to v2 endpoints as v2 JSON events
"1.5" - sends to v1.5 endpoints as XML events
String1.531.5v4.8+
LidClosedShutdownTimeThe number of seconds to wait after the lid is closed before automatically shutting down to conserve power.Int160030v4.7+
LidOpenTimeLimitThe number of seconds to wait while the lid remains open before automatically shutting down to conserve power.Int1600300v4.7+
LocationServiceUse location based services for the case. The Geolocation of the case will be sent in a SensorReadingEvent.Bool011v4.7+
LogEntryLevelThe verbosity of the logs sent by the case
  • Off
  • Error
  • Warning
  • Information
StringOffTraceErrorv4.7+
LogFileLevelThe verbosity of the logs saved locally on the case
  • Off
  • Error
  • Warning
  • Information
  • Verbose
  • Trace
  • Debug
StringOffDebugOffv4.7+
ObjectEventHourThe hour to perform the daily system scan as well as other system checks.Int-1230v4.7+
ObjectEventOnlyWhen true, all scans are reported as ObjectEvent. Otherwise, lid open/close report as AggregateEvents.Bool010v4.7+
ObjectEventScanCountThe number of times to scan during a GetEPCListCommand or during the daily system scan.Int11002v4.7+
ObjectEventScanDelayNumber of times the case should wait between scans after an end user closes the lid.Int1601v4.7+
ObjectEventScanTimeThe time in seconds for each scan during a GetEPCListCommand or during the daily system scan.Int13002v4.7+
OperationLedEnable the LED to indicate operation state.Bool010v4.7+
RangeLimitWhen the range received from the location service is greater than this number, it will disconnect the cell, and reconnect for 2 retries. If it does not get below the range specified, "NA" will be returned in the SensorReadingEvent.Int099995000v4.8+
ReaderLogEntryOnFailureGenerate a LogEntryEvent when communications to the internal RFID reader fails.Bool011v4.7+
RegionCodeThe region determines the RFID frequency of operation.String--FCCv4.8+
SecureSocketUse secure communications over HTTPS for the case.Bool011v4.7+
SensorALogEntryEventHighTempHigh temperature threshold in Celsius for probe A to send a LogEntryEvent.Int-100100100v4.7+
SensorALogEntryEventLowTempLow temperature threshold in Celsius for probe A to send a LogEntryEvent.Int-100100-100v4.7+
SensorReadingEventIntervalThe number of minutes between sending a SensorReadingEvent.Int0144060v4.7+
TempOffsetThe offset, in degrees Celsius, to apply to the temperature readings from temperature probe A.Int-1001000v4.8+
TempSensor

The event that triggers a temperature reading.

None - The device will never take or report temperature

Lid - The device will record and report temperature every time the lid is closed.

Stringnonelidnonev4.7+

LogEntryEvents

The list below are some common, potential LogEntryEvents an enclosure may send in. However, not all possible LogEntryEvents are listed in this table. The LogEntryLevel in use determines which LogEntryEvents are sent to Jetstream.

NameDescription
CriticalBatteryCriticalBattery occurs whenever the percent of battery charge is below BatteryCritical. The battery percentage will also be reported.
LowBatteryLowBattery occurs whenever the percent of battery charge is below BatteryLow but above BatteryCritical. The battery percentage will also be reported.
LowFlashMemoryLowFlashMemory occurs when the mobile case has less than 25% flash memory.
LowMemoryLowMemory occurs when the mobile case has less than 25% memory. This event will be sent every hour until the device reboots. Reboot occurs automatically if memory drops to 10%.
NewFirmwareDownloadErrorNewFirmwareDownloadError occurs when a request to upgrade firmware fails because the case is not able to download the new firmware.
ReadExceptionReadException occurs when there is an issue performing an RF read.
ScanInterruptionAlarmScanInterruptionAlarm occurs when someone interrupts a scan by opening the lid.
ShutdownShutdown occurs when the case is signaled to shutdown.
StartupStartup occurs whenever a case is started up.
TemperatureTemperature occurs when a temperature threshold set by SensorALogEntryEventHighTemp or SensorALogEntryEventLowTemp has been reached.
TemperatureRestoreTemperatureRestore occurs when an enclosure has gone back into normal temperature range.
WakeReasonOccurs whenever the case boots up. The message contains the reason why the case booted.

SensorReadingEvents

Geolocation for the case (Latitude, Logitude, and Range) is reported as part of a SensorReadingEvent.

NameDescription
BatteryLevelThe percent charge remaining of the battery.
ConnectionThe frequency standard the device communicated through: LTE, CDMA, or GSM.
LatitudeThe Latitude where case is currently positioned in degrees.
LongitudeThe Longitude where case is currently positioned in degrees.
RangeThe measure of error from the Latitude/Longitude point where case is currently positioned in meters.
SignalStrengthThe cellular network signal strength where the case is currently positioned in dB.
TemperatureAThe temperature reported on probe A in Celsius.