background image

 

56

CCR

TM8100/TM8200 Computer-Controlled Data Interface (CCDI) Protocol Manual

© Tait Electronics Limited

 

April 2007

Where:

General characteristics of the message format worth noting are as follows:

All characters in a message are printable ASCII

Where numeric values are represented in ASCII-hex notation (two 
characters per byte), digits A...F are upper case

The minimum length of a command packet is 5 characters; i.e. when 
[SIZE] = 00. For example, c003D is the CANCEL command which is 
5 characters.

The maximum length of the [PARAMETERS] field is 32 characters, so 
that the maximum length of the command packet is therefore 
37 ([SIZE]=“20”) characters

2.4.2

Calculating [CHECKSUM]

[CHECKSUM] is calculated by applying the following algorithm:

5.

Take the modulo-2 sum of all message bytes preceding 
[CHECKSUM].

6.

Retain bits 0...7, discarding any higher order bits resulting from the 
summation.

7.

Form the two's complement of the remainder.

8.

Convert the binary number into two ASCII-hex digits, MSD first.

Checksum Example

s0D050800TESTHi!DA

9.

Take the modulo-2 sum of all message bytes preceding 
[CHECKSUM].

s = 73h, 0 = 30h, D = 44h etc. therefore the modulo-2 sum is:

73 + 30 + 44 + 30 + 35 + 30 + 38 + 30 + 30 + 54 + 45 + 53 + 54 
+ 48 + 69 + 21 = 426h

Parameter

Value

[IDENT]

is the message identifier. Identifiers are single ASCII characters 
which categorise the message type

[SIZE]

is the number of characters which make up the [PARAMETERS] 
field. [SIZE] is an 8-bit number expressed in ASCII-hex notation 
(two characters)

[PARAMETERS]

is an optional field, depending upon the command. Parameter 
values are generally character strings unless explicitly stated 
otherwise. Parameter type is dependent upon the command - 
there is no explicit type definition.

[CHECKSUM]

s an 8-bit checksum of the [IDENT], [SIZE] and [PARAMETERS] 
fields. It is expressed in ASCII-hex notation (two characters)

<CR>

is the packet terminator. It is the ASCII “carriage return” 
character (0Dh).

Summary of Contents for TM8100 mobiles

Page 1: ...TM8100 mobiles TM8200 mobiles Computer Controlled Data Interface CCDI Protocol Manual MMA 00038 02 Issue 2 April 2007...

Page 2: ...f improving the performance reliability or servicing of the equipment Tait Electronics Limited reserves the right to update the equipment or this manual or both without prior notice Updates of Manual...

Page 3: ...15 1 6 1 XON XOFF Software Flow Control 15 1 6 2 Hardware Flow Control 15 1 7 CCDI Transparent Mode 16 1 7 1 Entering Transparent Mode 16 1 7 2 Exiting Transparent Mode 17 1 7 3 Transparent Mode Form...

Page 4: ...5 2 CCR CCDI Mode Independence 57 2 5 3 CCR Mode Activated 57 2 5 4 CCR Mode Busy 57 2 5 5 Blocked Functions 57 2 5 6 CCR Persistence 58 2 5 7 CCR Response Time 58 2 5 8 Exiting CCR Mode 58 2 6 CCR P...

Page 5: ...8 13 Transmitter Output Power 69 2 8 14 Set Bandwidth 69 2 8 15 Query Radio Pulse 70 2 8 16 Exit CCR Mode 70 2 9 Unsolicited Messages from the Radio 72 2 9 1 Summary and Examples 72 2 9 2 PTT exceeds...

Page 6: ...6 TM8100 TM8200 Computer Controlled Data Interface CCDI Protocol Manual Tait Electronics Limited April 2007...

Page 7: ...M8100 for Data Operation Technical Note TN 1075 AN MAP27 Implementation Form Appendix A7 Publication Record 1 Technical notes are available in PDF format from the Tait support website Consult your nea...

Page 8: ...rmed correctly Abbreviations Abbreviation Description ASCII American Standard Code for Information Interchange AVL Automatic Vehicle Location CCDI Computer Controlled Data Interface CCR Computer Contr...

Page 9: ...ded transmit GPS data RTS Request to Send ready to receive Rx Receive RXD Receive Data SDM Short Data Message SFI Specific Format Information for an SDM THSD Tait High Speed Data TIA Telecommunication...

Page 10: ...10 TM8100 TM8200 Computer Controlled Data Interface CCDI Protocol Manual Tait Electronics Limited April 2007...

Page 11: ...n the PC and the radio using the CCDI protocol CCDI commands can also be used to obtain GPS data and NMEA messages from the radio Refer to QUERY and SEND_ADAPTABLE_SDM The baud rate is set to 1200 240...

Page 12: ...Communications tab Select Mic Aux or Internal Connector Mic The radio will transmit and receive data via the MIC_TXD and MIC_RXD lines on the microphone connector Aux The radio will transmit and recei...

Page 13: ...ne on the internal options connector 1 2 4 MAP27 Port MAP27 data transmission and reception also requires an asynchronous serial port and must be different to the CCDI UART Port The MAP27 port is set...

Page 14: ...e CCDI Go_To_Channel command Refer to GO_TO_CHANNEL on page 29 The radio will power on into the mode selected in the Powerup State field in the Data form Power Tx and Rx LED indicators are helpful for...

Page 15: ...es for XOFF and XON Important When using XON XOFF software handshaking the data stream or the data file must not include the programmed XON and XOFF characters It is recommended that only ASCII text b...

Page 16: ...ffer is 512 bytes for the TM8100 and 600 bytes for the TM8200 to adequately cope with the data flow Communication in Transparent mode is free format with the protocol determined entirely by the PC and...

Page 17: ...into data blocks before it is sent over air The start and stop bits are removed and a header is sent at the start of each data block FFSK Transmission Format The Transparent Mode transmission format i...

Page 18: ...g base station is set to Repeater mode the carrier is detected and Rx Gate becomes active opens which in turn makes the PTT line active The active PTT line keys up the transmitter This sequence is rep...

Page 19: ...d a SDM Received RING messages are generated by the radio to indicate that SDM data has been received When using FFSK an FFSK Data Received PROGRESS message will also be generated 1 8 1 Entering Comma...

Page 20: ...o character ASCII hex notation CR The carriage return 0Dh packet terminator 1 8 4 Restrictions All characters in a message are printable ASCII Where numeric values are represented in ASCII hex notatio...

Page 21: ...y higher order bits resulting from the summation 26h 3 Form the two s complement of the remainder 26h 0010 0110 two s complement 1101 1010 4 Convert the binary number into two ASCII hex digits MSD fir...

Page 22: ...ction Valid in Mode Mode radio must be in or switch to to act upon the message TM8200 only CANCEL c Cancel current activities Conventional Conventional DIAL d Initiate a conventional call Trunked Conv...

Page 23: ...el the existing call c003D also a command to cancel the existing call c0110B a command to delete the currently held SDM CANCEL_TYPE Function 0 cancel call Cancel Call In conventional mode Cancel can d...

Page 24: ...e to get through especially if the channel is busy or the system heavily loaded The receiver will return a prompt as soon as the DIAL command is accepted but the PC may have to wait for a PROGRESS mes...

Page 25: ...TM8100 Yes TM8200 No 1 0 Disable CCDI volume control Yes 1 Enable CCDI volume control refer to SUBFUNCTION 2 Yes 2 0 9 Set volume level 0 off 1 9 loudness TM8100 before v2 06 TM8200 No 2 0 25 Set vol...

Page 26: ...none 000 009 PTT keypress length 0 constantly off 1 8 x 8 seconds on 9 constantly on Yes 010 019 Hookswitch keypress length 0 constantly off 1 8 x 8 seconds on 9 constantly on Yes 020 029 On off keyp...

Page 27: ...ional mode only Yes 7 subaudible signalling none 0 Deactivate validation of CTCSS and DCS subaudible signalling Incoming data will be processed regardless of the subaudible signalling The default radi...

Page 28: ...ume control f03020A5 set volume level off f0402256D set volume level to the maximum of 25 f03025A0 set volume level to 5 f03031A3 enable Selcall output f03030A4 disable Selcall output f03041A2 enable...

Page 29: ...r TM8200 not applicable for TM8100 is a two character string representing the new zone When ZONE is omitted the radio stays in the current zone CHANNEL_NO is a maximum of four characters representing...

Page 30: ...sage The SDM buffer is then cleared Available in conventional mode only Yes 3 version none Query the radio version information The data is returned to the PC as a RADIO_VERSION message Refer to RADIO_...

Page 31: ...e acknowledgement is sent and how long the radio waits is also set in the programming application In Command mode when any SDM is received whether valid or not the radio sends an FFSK Data Received PR...

Page 32: ...0 Default Value Default Value 01 GPS_0 GPS related CDP only 02 Text Text 03 CCR SDM is directed to the CCR module Refer to CCR SDM TM8100 only on page 33 04 Extended SDM Up to 128 bytes split into mul...

Page 33: ...ge ID 12345678 and SDM data Hi with 5 1s lead in delay through the current channel Extended SDM An adaptable SDM with a SFI of 04 can have up to 128 bytes of data This is split up into multiple SDMs w...

Page 34: ...NMEA message is to be returned to If not in the message then the message shall be returned to the default GPS dispatcher Examples a120520612345678GPRMC22 This message transmits data message to ID 123...

Page 35: ...to issue an audible indicator when a valid SDM is received while in Command mode Note The radio can not receive any further SDMs if one is already stored in the buffer The buffer must be cleared usin...

Page 36: ...me and packet size according to the settings in the database Note A TDMA channel is different to a normal channel with the same channel number Sending TDMA Data Sending TDMA data requires a second TDM...

Page 37: ...ON is a one digit ASCII character specifying the TDMA sub function 0 OPEN_TDMA_CHANNEL 1 QUEUE_TDMA_DATA_FOR_SENDING 2 CLOSE_TDMA_CHANNEL CHANNEL_NO is a two digit string specifying the TDMA decimal c...

Page 38: ...h side When the escape sequence is sent to the radio it is forced into Command mode See Entering Transparent Mode on page 16 for details MODE is a single ASCII character representing the modulation sc...

Page 39: ...e command initiates a return message then when the return message has been sent the radio sends another prompt If the radio sends an unsolicited message it sends a prompt after the message Message Cha...

Page 40: ...gth character string representing the CCTM value requested Note If the CCTM command gives multiple results then a separate query result will be given for each one Examples q0450475B This command queri...

Page 41: ...ters of the currently received message are incorrect ETYPE ERRNUM Error 0 Transaction Error 01 Unsupported Command Unsupported command errors can arise when the PC expects a later version of CCDI than...

Page 42: ...TA CHECKSUM s is sent as a single ASCII character and represents the GET_SDM command SDM_DATA is a optional string of up to 32 character or 128 for an extended SDM Note If no SDM_DATA is sent then the...

Page 43: ...is a single character representing the model of the radio RUTIER is a single character representing the tier of the radio Character Function 1 Conventional radio 2 Reserved for Trunked radio 3 North...

Page 44: ...RA2 is appended if PTYPE is 21 22 or 23 PTYPE PARA1 Function 00 none Call Answered A standard Selcall or Type 99 call has been answered This message will be sent when the call has been answered either...

Page 45: ...mode it will be sent directly to the PC without sending this progress message 1C Selcall Auto acknowledge Indicates whether an auto acknowledge was received from the last Selcall call Note that this...

Page 46: ...available or invalid 22 2 digit decimal channel ID TDMA channel ID PARA2 2 digit hexadecimal number 00 TDMA open accepted 01 TDMA not available 02 TDMA channel invalid 03 TDMA open slot not assigned...

Page 47: ...rmat d SIZE PTYPE PARA1 PARA2 CHECKSUM d is sent as a single ASCII character representing the QUERY_DISPLAY_RESPONSE command PTYPE is a single digit character hexadecimal value indicating either start...

Page 48: ...following table shows the font identifiers for text strings and icons Icon ID The following table shows the icon IDs IDs not listed in the table are not used Font ID Font Name 1 FontDispatch 10 2 Font...

Page 49: ...control head is reported with response messages Limitations The QUERY DISPLAY RESPONSE messages should represent a sequence of text and Icon data which are used during a complete display refresh proc...

Page 50: ...ION message is sent to the PC in response to a QUERY 3 version command It conveys the versions of the various software and hardware components in the radio Format v SIZE RECORD NUMBER VERSION CHECKSUM...

Page 51: ...of the incoming call The RING type is a four character string qualifying the type of call received Character Function 0 Selcall 1 Undefined 2 Type 99 Type Character Function TYPE1 0 Voice Call receive...

Page 52: ...art is missed or not Example r0714000FFA6 This message indicates that the received call is an SDM call 1 10 10 TDMA_DATA Unsolicited TM8200 only The TDMA_DATA message is sent to the DTE in response to...

Page 53: ...dio support CCR Microphone Auxiliary and Internal Options The CCR mode is a sub mode of CCDI Entry into CCR is via a CCDI command f0200D8 Once in CCR mode the radio will accept serial CCR commands and...

Page 54: ...its multi system MDT controlled radio Remote off air monitoring System integration Self healing RF networks Rapid deployment inter operability Hybrid solutions 2 2 Programmable Parameters CCR depends...

Page 55: ...ignalling as follows Enable network to be selcall The radio will upon entry to CCR inherit programmable parameters from the channel that was active when CCR was entered Modifications while in CCR mode...

Page 56: ...s resulting from the summation 7 Form the two s complement of the remainder 8 Convert the binary number into two ASCII hex digits MSD first Checksum Example s0D050800TESTHi DA 9 Take the modulo 2 sum...

Page 57: ...g transmitting or processing emergency mode activities CCR mode is not however blocked when the radio is stunned CCR can run in this state 2 5 2 CCR CCDI Mode Independence CCDI and CCR are independent...

Page 58: ...a radio is reset nothing is saved from the current CCR session to the next power up Third party devices can check that the radio is alive with the pulse command and reprogram it when a power outage h...

Page 59: ...mething else inhibiting its execution it is rejected and a negative acknowledgement is sent to the user The negative acknowledgement has the following format Response ssrrxcc Where Note A command is o...

Page 60: ...he command specific tests a parameter error is sent For details on validation rules see the specific commands data length check range check on message data correct sequence of commands 2 7 5 Radio Bus...

Page 61: ...P when minimum config exists P0111E Set power to Very Low P0141B Set power to High H01324 Set bandwidth to Wide H01126 Set bandwidth to Narrow A0406708E Set Rx ctcss to 67Hz A0400009B Set Rx ctcss to...

Page 62: ...ransmitting then a NAK response will also be sent Command Rssxxxxxxxxxcc Where Effect This command has immediate effect with the receiver retuning to this channel If the synthesizer is out of lock the...

Page 63: ...Where Effect This command has immediate effect If there is a volume knob on the radio there is no guarantee that the value set with this command will be the volume The radio will use the level last se...

Page 64: ...ed whenever the radio is transmitting audio If the reference number is out of range the radio does not act on the command and sends a NAK range error back to the radio If the radio is already transmit...

Page 65: ...r back Command D03xxxcc Where Effect This command loads the value into memory ready for the next PTT or Selcall encode activity 2 8 9 Encode Selcall Sequence Description This command turns the transmi...

Page 66: ...tive causes busy error 2 8 10 Set Selcall Parameters Description This command allows the user to modify the Selcall default parameters tone set to use tone period number of tones in Tx sequence and nu...

Page 67: ...n the ANI sequence is to be sent If p is not 0 the tone sequence gets stored If the number of tones xx xx does not match the currently configured length then the command is rejected NAK format error I...

Page 68: ...resent the monitor state The radio will use the state last set with any control Parameter Value N ASCII letter N denotes the Automatic Number Identification command ss ASCII hex number ss is the numbe...

Page 69: ...call Note If there is a front panel key or programmable input with low power configured there is no guarantee that the value set with this com mand will represent the effective output power The radio...

Page 70: ...received a set receive frequency command QssDcc is returned if the radio has loaded its default set up and has not yet received a set receive frequency command Effect These commands invoke an immedia...

Page 71: ...Tait Electronics Limited April 2007 Command E005B Where Effect This command is immediate The radio will reset Parameter Value E ASCII letter E indicates it is an exit command 00 ASCII hex number 00 i...

Page 72: ...ontrol head that PTT is about to timeout For control heads with user interfaces the warning threshold is the duration timer configured for the network minus 10s Response Msspcc Where Effect Whenever t...

Page 73: ...command allow the user to define the size of the decode tone buffer This buffer sets the maximum time period that the radio will decode and log tones before reporting to the user when continuously rec...

Page 74: ...of tones in a continuous sequence as follows If the decode buffer contains less than the selected number of tones when it is reset the contents shall be discarded If a radio in CCR receives a speech c...

Page 75: ...NOT DUPLICATE MODIFY REVERSE COMPILE OR REVERSE ASSEMBLE ANY SOFTWARE OR FIRMWARE IN WHOLE OR PART Important Notice THE SOFTWARE OR FIRMWARE MAY CONTAIN OPEN SOURCE SOFTWARE COMPONENTS OPEN SOURCE CO...

Page 76: ...CONTRACT AND TAIT S SOLE AND TOTAL LIABILITY FOR ANY SUCH CLAIM SHALL BE LIMITED AT THE OPTION OF TAIT TO THE REPAIR OR REPLACEMENT OF THE SOFTWARE OR FIRMWARE OR THE REFUND OF THE PURCHASE PRICE OF T...

Reviews: