Terminal Professional Firmware Update
Terminal Professional models – firmware compatibility
Hardware / Firmware | 2.x.x | 3.0.x – 3.4.x | 3.5.x – 3.7.x | 3.8.x – 3.13.x (or newer) |
2.x.x | Yes | No | No | No |
3.3.x | No | Yes | Yes | Yes |
3.4.x | No | Yes | Yes | Yes |
3.5.x (Display type 1) | No | No | Yes | Yes |
3.5.x (Display type 2) | No | No | No | Yes |
Downloading new firmware
For any type of firmware update on Terminal Professional, new firmware files must be downloaded first.
1 | Download the new firmware files from the Y Soft Partners' Portal (http://partners.ysoft.com). |
2 | Copy downloaded files into the "update" folder on SafeQ server - typically C:/SafeQ5/server/update. |
Scheduled firmware update via SafeQ Web Interface
1 | Log in to the SafeQ Web Interface with sufficient rights to administer printers (for example, "admin") Go to Devices > Terminals selection
|
2 | Select terminal(s) which you want to update and click Schedule firmware update.
|
3 | Set Date and time, firmware version and click Schedule update. Your update will be saved and performed at given time.
|
4 | You can see bar with updates status as displayed here. Click If you want to delete scheduled update click
|
5 | Firmware version is periodically checked every five minutes. See terminal-update-checker-interval in SafeQ System settings if any change is needed. Example of firmware update logged in cml.log: 2012-01-23 16:34:27,253 DEBUG TermUpdChecker| Terminal3Protocol| Sending update request for terminal with IP 10.0.5.130 |
Firmware update via fwupdate.conf
1 | Edit the configuration file (safeQ.fwupdate.conf or fwupdate.conf), which is located in the SafeQ home directory in the folder ...\conf\modules (or ...\conf\), as described in the following example. (The configuration file includes parameters for different versions of terminals and for the recharging station.) In the Terminal v3 firmware area, look at the highlighted. As a general rule, on the left side of the equal sign ( = ) is the definition of the current firmware, and on the right is the new firmware. In the example shown here, the last time the firmware was updated, version 3.12.[0-9] was updated to version 3.13.3.
To perform the update, you can use either a full update file or a differential update file. Differential files are smaller and therefore the update is faster, but can be used only when the third-level version of the firmware changes. For example, if you're updating from 3.12.0 to 3.12.5, you can perform a differential update. But if you're updating from 3.12.0 to 3.13.0, you must perform a full update. If you are not sure, perform a full update. |
2 | Open the configuration file on the server.
|
3 | Authenticate at the terminal. The update process begins. The update process can take several minutes, depending on the connection. The terminal service menu indicates when the update is complete.
|
4 | Try to authenticate on the terminal. If you are able to authenticate, you have now successfully upgraded the terminal firmware. |
Emergency firmware update via fwupdate.conf
NOTE: Emergency updates are always full updates – not differential updates.
1 | Edit the configuration file (safeQ.fwupdate.conf or fwupdate.conf), which is located in the SafeQ home directory in the folder conf\modules (or conf\), as described in the following example. (The configuration file includes parameters for different versions of terminals and for the recharging station.) In the Terminal v3 firmware area, look at the line that includes “emergency”. On the left side of the equal sign ( = ) is the version of the terminal and on the right is the new firmware. In the example shown here, the last time an emergency update was performed, Terminal Professional version 3 was updated with firmware version 3.13.3. |
2 | Open the configuration file on the server.
|
3 | Use either of these methods to invoke the emergency firmware update: Method 1: Invoking the firmware update from the Service menu
Method 2: Invoking the firmware update during power up
The update process can take several minutes, depending on the connection. The terminal Service menu indicates when the update is complete. You have now successfully upgraded the terminal firmware. |
Firmware update via Termtool utility
Termtool utility is standard part of YSoft SafeQ installation package. You can find it in Support folder of installation package in Remote Configuration Tool folder.
With Termtool utility you can perform many types of updates (regular, emergency, push,...).
1 | Edit fwupdate.conf file as described in Firmware update via fwupdate.conf or Emergency firmware update via fwupdate.conf in steps 1 and 2, depends on type of update which you want to perform.
|
2 | Run termtool.exe from command line with appropriate parameters (depends on type of update) You can find all parameters and other documentation about Termtool here: Remote configuration tool for hardware terminals |


icon to see details of scheduled updates.
icon.