The current version of the firmware of a TSE can be checked in different ways:
- via Client API
- via the TSE Test-Tool
Checking TSE firmware version via Client API
The following call returns all TSEs available on the system, including their status:
Within the response, the firmware version installed on the TSE is being returned.
If "1.1.0" is returned within the answer in field "tseSoftwareVersion", no firmware update is necessary.
If e.g. version 1.0.4. is displayed, carry out a firmware update (see below).
Checking TSE firmware version via TSE Test-Tool
Download the TSE test tool from the Downloads section of the RetailForce website. You can find the test tool as a .zip file at: https://www.retailforce.cloud/downloads/Swissbit/TseFirmwareUpdate/.
With the following steps, you can check which firmware version is installed on the swissbit hardware TSE:
- select TSE ("Choose Tse")
- Enter client name ("Cash Register ID") - if the client name is unknown, click on "Get Register List" (2a.)
- Execure "Run self test".
If "1.1.0" is displayed in the right-hand info box under the entry "TseSoftwareVersion", no firmware update is necessary.
If the self-test fails because the client was not known, click on "Get Register List" (as described above). This will display all registered clients in the list box.
Then enter the client name in the "Cash Register ID" field (2.) and run the self-test again.
Carry out firmware update
To be able to update the firmware, you need the TSE test tool. Where to find it is described at the beginning of the previous section.
Follow the steps below to perform a firmware update:
- click "Additional commands"
- field "TseSecuritySelfTestPassed" has to contain "true" - if this is not the case, run self test again.
- click "Update firmware" and select file: <RLS_1_1_0.ucp_swissbit_tse_usb.bin>.
As soon as the firmware update is completed, the message "Firmware update complete" is displayed.
If the firmware update is not successful, the TSE data is saved in a backup file (<YYYYMMDDHHNNSS.tarbackup>) on the desktop. After successfully completing the update, this file can simply be deleted.
Finally, check the firmware version (first two sections) of the TSE. This should now be 1.1.0.