Toshiba POS Monitor Inventory Drivers for Linux 1.3


Package Install

The toshiba-dspdrv-suse-1.3.0-1.0.i586 contains the user mode libraries and support files that form the instrumentation. This rpm requires that the sblim-sfcb cimserver and the libusb-1_0-0 usb support packages are already installed. Remove any previous versions before install of version 1.3. Please note that this package also obsoletes earlier packages with the name ibm-dspdrv-suse-<package version>

% rpm -ivh toshiba-dspdrv-suse-1.3.0-1.0.i586.rpm

This will install the libraries and update the SFCB repository with class definitions for RSS_Display CIM class.


Connection

The monitor(s) should be connected to the system unit by the usb cable provided with the monitors identified in the section: Monitor Support below.


Remote Management Agent Support

Most Toshiba Global Commerce Solutions customers will want to use RMA to allow interconnection of the instrumentation CIM classes to remote systems management software such as IBM Director. After install of the instrumentation the RMA General Agent daemon on the POS machine should be stopped and restarted in order to activate cimserver repository and other system changes.


Support Logging

The drivers log abnormal conditions to /var/log/dspdrv/dspdrv.log. For normal production usage there is no need to change this behaviour. In fact it is not recommended. If any problems surface however additional information may be logged for purposes of support.

To enable detailed logging edit the /etc/dspdrv/log.conf file. Change the Level property to 4 to enable very detailed trace logging. You may also wish to change the MaxLength property if you wish to log for any length of time as the logfile will fill quickly. Restart the SFCB cimserver to activate the logger configuration changes.


Log Levels:



Configuration

There is a configuration file /etc/dspdrv/dspdrv.conf. This currently contains the names of firmware update utilities named elodownload, eloconfig, elo_download, elo_config, aipflash, aipfwupdate, mxt-app. The purpose of this list is to inhibit the Monitor Inventory drivers from accessing the monitor while any one of these programs is running a video or touch firmware update. The values should not need changing.


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

Older monitors do not have the capability to provide the systems management information


Known Issues

For customers using RMA 2.5 or 2.6 you may need to do additional configuration to include the Monitor Inventory Drivers CIM class in the filter-list that the RMA General Agent accepts.

Edit /opt/ibm/StoreIntegrator/user/rma/cim/CIMconfig.xml and make sure these lines are included in the filter-list:

<CIMFilterElement lifeCycleEvents="true">RSS_Display</CimFilterElement>

This will allow this CIM class to be 'seen' by RMA and thus available in the IBM Director JMX Browser.


Changelist

Tue April 13, 2010 - Initial version

Mon October 18, 2010 - Release 1.0

Tue February 2, 2011 - Release 1.1

Wed November 7, 2012 - Release 1.2

Mon May 20, 2013 - SLE 11 SP3

Thu May 29, 2014 - Release 1.3