Instructions for installing UPDD USB touch driver on the Cisco DMP 4310G device.

Date: 3rd Oct 2013

 

The following instructions allow UPDD version 5.1.0 (or higher) to be installed and used on a Cisco DMP 4310 media player for a USB device. This is an MIPS based system.

 

Touch-Base will deliver to you a UPDD Linux package in a file updddmp4310.tgz and an additional file tbupdd.ini

 

These instructions assume that you have an SSH connection to the DMP in order to access the unit via SSH and that the unit is configured for such access. In our environment we used a Virtual Linux system running under Windows. If you are using a Windows system to access the DMP device we understand the PuTTy Telnet/SSH Client works well.

 

The delivered tgz file cannot be opened using the tar utility on the DMP unit so you will need to extract the files on another system with tar installed.

 

Installing the software

 

The driver package contains 5 modules. Their usage and requirements are listed below:

 

Module

Description

 

tbupddwu

This is the main driver file. It should be executed at startup as root (because libusb required root privileges). It has the additional dependency (over those already on the dmp) of libACE.

 

tbutils

This utility program allows access to various UPDD functions e.g. for support and diagnostics - see http://ww5.touch-base.com/documentation/UserInterface.htm.

 

A new option has been added for the DMP4310 “calibrate”. This new option initiates the built in DMP4310 calibration utility via a request from the driver. It has additional dependencies (over those already on the dmp) on libACE and libtbapi.

 

tbupdd.ini

A settings file. This specifies the options in effect for the driver, including which controllers are supported and records calibration data.

 

The 5.1.0 build looks for tbupdd.ini in several locations

 

  /tmp/ftproot/usb_1/tbupdd/

  /usb_1/tbupdd/

  /var/touch/touch-base/

  <current working directory>

 

The file needs to be writable and persistent

 

libtbapi.so

The driver API interface library required by tbutils.

 

libACE.so

ACE (http://www.cs.wustl.edu/~schmidt/ACE.html) a cross platform toolkit used mainly for thread synchronisation and IPC. Required by all UPDD components.

 

Calibrating the DMP.

By executing tbutils with the calibrate option (tbutils calibrate) the built in calibration utility is invoked. Note that a range of calibration options are supported; with various numbers of points and differing start margins. These options are set in the settings file at release time. It should be noted that although any number of points from 2 – 25 is supported, the nature of the graphics on the DMP calibration make it unsuitable for calibration at the edge (10% in is ok). 

 

-------------------

Notes

 

1) Calibration

In our tests with various touch screens we used 2 and 4 point calibrations with a 10% margin.  We suggest that this initial settings file we send you will be for 4 calibration point, 10% margin and adjust if necessary when tested on the target foils (e.g. increase number of calibration points etc)

 

2) Settings file

The settings file, tbupdd.ini, defines the touch screen in use and resides in one of the locations mentioned above