Professional Documents
Culture Documents
AISG Test Tool (Secondary Demo Mode) Installation and User Guide
AISG Test Tool (Secondary Demo Mode) Installation and User Guide
Revision History
DATE ISSUE NOTES
2004.02.24 1.0 Document First release – M. Lopez
2004.04.15 1.1 Release for Secondary Mode
Demo version
TABLE OF CONTENTS
1. REQUIREMENTS.......................................................................................................3
1.1 HARDWARE ..............................................................................................................................................3
1.2 SOFTWARE ...............................................................................................................................................3
2. INSTALLATION .........................................................................................................3
2.1 JAVA RUNTIME ENVIRONMENT (JRE) MANUAL INSTALLATION ....................................................3
2.2 JAVA COMMUNICATIONS API (JCA) MANUAL INSTALLATION ......................................................3
2.1 AISG T EST TOOL MANUAL INSTALLATION........................................................................................3
2.2 MODIFICATION OF THE SHORTCUT PARAMETERS .............................................................................3
3. APPLICATION MODE SELECTION ............................................................................3
4. VIRTUAL RET DEVICE TEST INTERFACE ................................................................3
4.1. OPERATION OF S ECONDARY VIRTUAL D EVICE ................................................................................3
4.1.1. Device creation: Create Button ..............................................................................................3
4.1.2. Device creation: Load Button ..................................................................................................3
4.2. SAVE BUTTON .........................................................................................................................................3
4.3. D ELETE BUTTON. ....................................................................................................................................3
4.4. ALARMS LIST BUTTON. .........................................................................................................................3
4.5. D EVICE ERRORS . ....................................................................................................................................3
4.6. COMMUNICATION EXCHANGE L OG .....................................................................................................3
1. REQUIREMENTS
1.1 Hardware
• 1 serial port (2 if Interface will be run as Control station and Virtual device
in the same machine)
• 1 Null modem cable (RS232).
• Serial Connection parameters supported are: 9600, 38400 and 115200
Kbps, no flow control, 8 bits data, no parity, 1 stop bit.
• Video Graphics Adapter – at least 256 colour palette (Java requirement)
• Hard Disk space – at least 50 MB for operation (depends on application
log size), 20 MB in Windows root directory for temporary files during
installation.
• Software was tested on PC’s with Pentium III @ 800 MHz, 256 Mb RAM
and Pentium Celeron @ 1.3GHz, 256 Mb RAM
1.2 Software
• Windows 98/NT4.0_SP6/2000/XP.
• Java™ 2 Runtime Environment, Standard Edition, build 1.4.1_02-b06 or
higher.
• Java HotSpot™ Client VM, build 1.4.1_02-b06, mixed mode.
• Java™ Communications API version 2.0.
• Tested on Windows 98, Windows 2000 SP2 and Windows XP SP1.
• REQUIRED VERSIONS OF
JAVA COMPONENTS ARE NOT SUPPORTED IN WINDOWS 95
2. INSTALLATION
2.1 Java Runtime Environment (JRE) manual installation
2. Copy the Java Communications API files to the destinations in the JRE
installation path as listed in table 1. The JCA files are provided in the
University of Sheffield website (http://www.shef.ac.uk/eee/cr/, 3rd party
software, javacomm20-win32-essentialfiles.zip).
Alternatively, download the files from the Java homepage. The correct
version is JCA 2.0. Download the file javacomm20-win32.zip and extract
only the relevant files.
DO NOT “Select” text from the DOS window unless the Java application
has already been stopped.
Doing so while the application is running will stop all Java execution
threads as long as the DOS window is in Select text mode.
The device emulator can hold the description data of only one device at a
time, and the represented device can not be deleted. It is possible to
overwrite a device, but devices can not have the same Unique ID.
Figure 4. Main interface as Primary Station and as Secondary Device. Notice that when
used as secondary device, the interface prevents access to management components
The input fields are verified for format before being input:
• Address: integers 0 to 254. If “0” is input, a warning will be generated
to inform the user that such address corresponds to a manufacturer
default value. Unrecognised values/format will be defaulted to 0.
• Model Number (Product number): 15 ASCII characters, longer strings
are truncated. If non-ASCII characters are found, they will be rejected
and replaced by 0x00.
• Serial Number: 17 ASCII characters, longer strings are truncated. The
input format verifiers provide no padding, if a shorter, non-zero length
string is input, the serial number length will be equal to the length of the
input string. If Non-ASCII characters are found, a message informs the
user, if ignored, the input is truncated on the position where the first
non-ASCII character is found.
each log is kept as a plain text file containing the information exchange of the
day, they usually consume a significant amount of hard drive space.
In order to save resources on the PC there is a maintenance task that
obtains a list of the files in the system log directory and erases all files that are
more than 7 days old. This task is run at start-up time and, if the application is
left connected continuously, every day at midnight.
GetDeviceType Implemented
Reset Implemented
GetErrorStatus Implemented
GetHWSWInfo Implemented
ClearAlarms Implemented
Alarm Implemented
EnableDevice Implemented
Mandatory
DisableDevice Implemented
SelfTest Implemented
Global ReadMemory Implemented
Commands WriteMemory Implemented
GetSupportedBitRates Implemented
SetDeviceData Implemented
AISG
Application Layer GetDevice Data Implemented
Command Set DownloadStart Not available
StoreDataStart Not available
Software Download
Optional Command Sequence StoreDataBlock Not available
Segment
DownloadEnd Not available
SetBitRate* Implemented
Calibrate Not available
RET SendConfigData Not available
Specific
commands SetTilt Not available
GetTilt Not available
SetTMAMode Not available
TMA GetTMAMode Not available
Specific
commands SetTMAGain Not available
GetTMAGain Not available
* SetBitRate will be understood if the command issued from the primary station is embedded
in an HDLC UI frame with the control byte set to 0x03 (UI with poll bit cleared). The
secondary device runs a thread that verifies long periods of “silence” over the link.