Thursday, August 27, 2009

Waris MPT1327 ESN Programming Tool


=======================================================
SOFTWARE RELEASE NOTES
=======================================================
PRODUCT: ESN Programming Tool
VERSION: R01.02.00
DATE OF BUILD: 19-Apr-09

=======================================================
Purpose of this release
=======================================================
This is the second release of the ESN Programming Tool
for Waris MPT1327 radios.
You can use it for Waris MPT1227 radios with a blanked
ESN in the codeplug and set a new regional code.



=======================================================
How to install and use this release
=======================================================
Disk installation:
------------------
Copy the files from the disk to a directory of your
choice on your computer's hard disk drive.

Usage:
------
To start the program double click on the file "ESN Tool EN.exe".
The ESN Tool software will start with the main program window.

Before using the tool you need to select the serial port used
for serial communication with the radio. To do this open the
Options menu followed by the Configuration sub-menu.
The Configuration dialog appears. Select the serial port
you wish to use for radio communication from the serial port
combo-box. When finished press the OK button to store your
serial port selection. The next time you start the ESN Tool
it will remember your previous selection so you do not need
to select the serial port again unless you wish to use a
different port.



The ESN Tool offers the following functionality:

1) Retrieve status information about the connected radio:

To retrieve status information select the Radio Access menu
followed by the Radio Info sub-menu. If a valid radio is
connected to your computer the Radio Info dialog appears
after a few seconds. This dialog shows the following
information as reported by the radio:

Model Number, Serial Number, ESN (Electronic Serial Number),
Software Version, Codeplug Version, Last Programmed (Date & Time),
Codeplug Part Number, Firmware Part Number, Radio IC Version
Numbers (hexadecimal hardware identification), Regional Identifier,
UUID (CPS identification).

The information shown is read only and cannot be changed.



2) Program ESN (Electronic Serial Number):

To program the ESN select the Radio Access menu followed by the
Program ESN sub-menu. Please note that the ESN can only be
programmed once so an error message appears in case the ESN
in the radio is not blank. If the ESN in the radio is blank the
Program ESN dialog appears. Enter the ESN you wish to program
into the radio in the format "mmm/rr/ssssss" where "mmm" is the
3-digit manufactures code, "rr" is the 2-digit radio model code
and "ssssss" is the 6-digit serial number. Make sure the ESN
is correct because once programmed it cannot be changed anymore.

To program the previously entered ESN into the radio press the
Program button. After a few seconds an additional dialog appears
to inform you wether the ESN has been programmed successfully or
not.

3) Set the Regional Code

Error Messages:
---------------

1) Serial communication errors:

"The serial port COMx could not be opened."
"It may be in use by another program."

If this error message appears verify that no other program
using a serial port is running. The port may be used by the
serial mouse (if you have one) as well. In this case use
a different port for serial communication with the radio.

"No response from radio."

If this error message appears verify that the radio is switched
on and it is powered correctly. If the error persist check the
serial connection between the radio and the computer (cables,
RIP box, correct port usage etc.).

"Operation not supported by this radio."

If this error message appears the radio connected to the computer
is not a valid Waris MPT1327 radio. The ESN Tool cannot be used
for other radios.

"NAK received from radio."
"Unexpected response from radio."
"Checksum error in received message."
"Received message too long."
"Received message incomplete."

If one of the above error messages appears the serial communication
between the radio and the computer could not be completed
successfully. In this case you should 1st try again. If the same
error message appears again check the serial connection between
the radio and the computer as described above and verify the
radio and the RIB box are powered correctly.




2) ESN programming errors:

"An ESN has already been programmed to the connected radio."

The ESN can only be programmed once. The radio connected to the
computer has already a valid ESN programmed and can therefore
not be programmed again.

"The ESN format of the connected radio is not supported."

The radio connected to the computer is not a valid Waris MPT1327
radio. The ESN Tool cannot be used for other radios.

"Invalid ESN entered."

The ESN you entered is not a legal ESN. Make sure you entered
the ESN correctly as described earlier in the section "Program ESN".

"An error occured during programming of the ESN."
"The ESN has not been programmed."

Either a serial communication error occured between the radio and
the computer or the radio is not a valid Waris MPT1327 radio with
no ESN already programmed. You may use the information described
earlier in the section "Retrieve status information" to verify
the radio.