Toshiba POS Monitor Upgrade Solution for Linux v2.1-10.x

 

This package is the Monitor Upgrade Solution (MUS) by Toshiba Global Commerce Solutions, Inc. This will perform silent and remote updating of the Touch and Video Firmware of Toshiba Monitor type 6149-5xx.

 

OS Support


The instrumentation may run on other operating systems but this is not supported by Toshiba Global Commerce Solutions at this time.

 

Monitor Support SLE 12 SP2 64-bit

 

Connection

The monitor should be connected to the system unit by the usb cable provided with the monitors.

 

Pre-requisites

1.      C/C++ Compiler and Tools (Will need this to compile the downloaded Python 2.6.8)

NOTE: When performing a fresh install of SLE 12 SP2, please include "C/C++ Compiler and Tools" from "Software" headline within "Installation Settings" page. If your system comes pre-installed with SLE 12 SP2, please check that “C/C++ Compiler and Tools” is installed from "Software Management" in YaST2.

Required only C/C++ 64Bit module - patterns-sles-Basis-Devel or patterns-sled-Basis-Devel.

 

2.      Python 2.6.8 on SLE 12 SP2. Download Python 2.6.8 from the Python web site https://www.python.org/download/releases/2.6.8/

     

Before installing MUS OP, please follow these steps below to install Python 2.6.8 first.
        a. Unzip Python-2.6.8.tgz or Python-2.6.8.tar.bz2.

        b. Open a bash or terminal from unzipped Python-2.6.8.tgz or
            Python-2.6.8.tar.bz2 directory/folder.

        c. To check current Python version, type 'python -V' and system will return
            Python 2.7.9 (default SLE12 SP2’s Python version).

        d. Next, type './configure' (Ignore all warning messages shown during this
            process).

        e. Then type 'make' (Ignore all warning messages shown during this process).

        f. Finally, type 'make install' to install Python 2.6.8 into SLE 12 SP2 (Ignore all
           warning messages shown during this process).

        g. When the installation has completed, type 'python -V' to verify that current
            Python version is 2.6.8. Once the above (Python 2.6.8) is confirmed, proceed
            to MUS OP installation.

 

3.      Required to install Libusb-1_0-0-32bit-USB Library Module.

It is required to install Libusb-1_0-0-32bit USB library module to avoid receive error message “error while loading shared libraries: libusb-1.0.so.0: cannot open shared object file: No such file or directory”.

 

 

Operational Package (OP) Install

The toshiba-mus_op-suse-2.1-{Release-Version}.noarch.rpm contains the operational package and support files that forms the monitor upgrade solution.

Type this command to install MUS OP

# rpm -ivh toshiba-mus_op-suse-2.1-{Release-Version}.noarch.rpm

This will install the Monitor Upgrade Solution (MUS) service and the firmware update utilities in the system as well as other support scripts

 

 

Upgrade Package (UP) Installation

Each Upgrade Task is contained in its own RPM package.

These RPMs will install UP Task files under a folder called opt/toshiba/mus/UpdateTasks/. Each task (video, touch, touch configuration) will be installed into its appropriate part of the sub-tree.

 

Currently known UP Tasks :

toshiba-mus2.1_up_6149_touch-GUID-1.0-n.noarch.rpm

toshiba-mus2.1_up_6149_video-xxxx_xxxx-1.0-n.noarch.rpm

 NOTE:

1. xxxx is the version of the firmware.

2. n is the incremental version of the UP which normally contains bug fixes and always start from 1.

3. GUID is the Globally Unique Identifier with 22 characters to identify the content of the UP. Since MUS 2.1, the firmware version of the UP will no longer be included in the UP name as it may contain multiple firmware versions in a UP. User has to check on the release note for the firmware versions it contains.

 

1. Install via command line

#rpm -ivh toshiba-mus2.1_up_6149_touch-GUID-1.0-1.noarch.rpm

 

2. Install at boot time (via the RpmUpdates directory)

The /opt/toshiba/mus/RpmUpdates directory is the ‘depository directory' where the UP RPMs may also be placed whenever there is a new UP available.

RPMS ‘dropped’ into this directory will automatically be installed by the Monitor Upgrade Service on the next bootup. As such, another reboot is required before any new UP can be used to upgrade the device.

Upon successful UP installation via the above methodology, the RPM package will be removed from this directory.

 

MUS Uninstall

Run the script “mus_uninstall_script” found at the directory /opt/toshiba/mus

 

Support Logging

The ten most-recent MUS log files are stored in /var/log/toshiba/mus/latest/ folder. There will be a thorough logging of processes that took place especially when any firmware gets updated. To view older logs, please go to the history folder.

 

Known Limitations

1.      MUS 2.1 Linux does not support power loss/ unplug power cable and unplugging of power USB cable from the attached 6149-5XX monitor while a touch firmware update is ongoing. Doing so will cause undesirable damage to the firmware and perhaps to the monitor itself.

2.      In the event video firmware, touch firmware and touch configuration are installed to update 6149-5xx monitor, please perform either of the following to ensure that the touch configuration is updated together with the video and touch firmware update. This is due to an interrupt triggered by SLE 12 SP2 kernel, and hence disconnecting the USB device.

a        Alternative 1: Reboot the system after the machine has booted up for at least 5 minutes or more. (It is noted that the total time required for video firmware, touch firmware and touch configuration updates in one instance will require at least 5 minutes or more).

b        Alternative 2: Install the Video UP only, reboot the system to allow Video UP to be updated. After which, install the Touch UP, reboot the system and allow the Touch UP to be updated.