Device Firmware Release Notes
Readpoint Firmware Releases

20250131 Surface Read Point FW v4.9.25

2min

Surface Read Point Firmware Version 4.9.25 Release Notes

Release Dates:

·        Production go-live: January 31, 2025

·        Field go-live: As needed after January 31, 2025

Platforms: Falcon

Affected Models:

  • TS082 – Surface Read Point

Firmware Version: FW v4.9.25

Application:

  • Production: FW v4.9.25 should be installed on all new production TS082 devices.
  • Field: FW v4.9.25 may be installed on TS082 devices in the field at the discretion of the Terso support.

Overview of Changes: This release provides an update to the firmware used by the TS082 RFID Surface Read Point from version 4.7 to 4.9. This update introduces new functionality and parameters, including the GetEPCList command and the Periodic Scanning feature, and addresses technical debt through minor bug fixes and security improvements.

  • Adds:
    • Periodic Scanning
      • Enables the TS082 to perform scans on defined interval, rather than continuously. The following parameters must be available for periodic scanning:
        • PeriodicScanInterval: Time in seconds between scans
        • PeriodicScanTime: Length of scan in seconds
        • PeriodicAgg: Activate or deactivate aggregate events for periodic scans
        • PeriodicObj: Activate or deactivate object events for period scans
    • GetEPCList Command
      • Enable the use of Jetstream’s GetEPCList command for both continuous and periodic scan modes.
        • Continuous Scanning: The firmware maintains a list of the tags that are currently in the RFID field, based on the device's CaptureTime and ReleaseTime parameters. When the GetEPCList command is received from Jetstream, this “current” list of tags is returned in the CommandCompletionEvent.
        • Periodic Scanning: The GetEPCList command causes a scan to occur for the number of seconds specified in the PeriodicScanTime parameter. The tags found in this scan are returned in the CommandCompletionEvent.
  • Removes:
    • None
  • Changes:
    • Minor bug fixes and security improvements
  • Known Issues:
    • None
  • Device Configuration Parameters:
    • Adds:
      • AutoUpdateFw
        • Description: Activate or deactivate auto firmware update
        • Data Type: Bool
        • Min: 0
        • Max: 1
        • Default: 0
      • CommsInterfaceRestart
        • Description: Number of minutes after the unit loses communication with Jetstream before the ethernet interface is restarted
        • Data Type: Int
        • Min: 1
        • Max: 480
        • Default: 15
      • JetstreamVersion
        • Description: The version of Jetstream that will be used to create events. The only settings allowed are: 1.5, 2, 3. Note that 1.5 sends events in XML and 2 and 3 send in JSON.
        • Data Type: String
        • Min: N/A
        • Max: N/A
        • Default: 3
      • MinRssi
        • Description: The minimum RSSI strength a tag must be to be kept and reported. Set to 0 (default) to not use this feature.
        • Data Type: Int
        • Min: -100
        • Max: 0
        • Default: 0
      • PeriodicAgg
        • Description: Activate or deactivate aggregate events for period scans
        • Data Type: Bool
        • Min: 0
        • Max: 1
        • Default: 1
      • PeriodicObj
        • Description: Activate or deactivate object events for period scans
        • Data Type: Bool
        • Min: 0
        • Max: 1
        • Default: 0
      • PeriodicScanInterval
        • Description: Dictates the time between the start of each scan in seconds
        • Data Type: Int
        • Min: 0
        • Max: 86400
        • Default: 0
      • PeriodicScanTime
        • Description: Length of the periodic scan in seconds
        • Data Type: Int
        • Min: 0
        • Max: 60
        • Default: 5
      • ReadCountThreshold
        • Description: The number of times a tag must be seen must be greater than this to be reported.
        • Data Type: Int
        • Min: 0
        • Max: 1000
        • Default: 0
      • ReleaseTime
        • Description: Dictates in seconds how long a tag is out of the field to be considered “removed” from a device.
        • Data Type: Int
        • Min: 1
        • Max: 86400
        • Default: 60
      • ScanMode
        • Description: Specifies whether the reader should scan in Single or Dual modes.
        • Data Type: String
        • Min: N/A
        • Max: N/A
        • Default: Single
      • UpdateDay
        • Description: Day of week to check to Auto FW update. 0 is every day. 1 is Sunday.
        • Data Type: Int
        • Min: 0
        • Max: 7
        • Default: 0
      • UpdateHour
        • Description: Hour of day to check for Auto FW update. -1 aligns with ObjectEventHour. 0 is midnight UTC.
        • Data Type: Int
        • Min: -1
        • Max: 23
        • Default: -1
    • Removes:
      • SearchMode – Replaced by ScanMode
      • AutoUpdate – Replaced by AutoUpdateFw
      • ObjectEventScanCount – Replaced by periodic scan parameters
      • ObjectEventScanDelay – Replaced by periodic scan parameters
      • ObjectEventScanTime – Replaced by periodic scan parameters
      • VersionsFileUrl – Because of the addition of the AutoUpdateFw parameter, VersionsFileUrl is no longer needed.
    • Changes:
      • N/A

Device Definitions:

New production units should utilize the most current device definition, listed below, for the Surface Read Point. Field units should utilize the device definition listed below after being updated.

It is recommended that customers use the most current device definitions available unless instructed otherwise by the Terso Customer Success team.

·        FW v4.9.x, Surface Read Point