Computer_controlled_Radio_Interface_-_CCRI
Computer_controlled_Radio_Interface_-_CCRI
Computer controlled
Radio-interface
(CCRI)
Protocol Manual
version 01-03
Scope of Manual
Publication Record
Within this manual, four types of alerts are given to the reader:
warning,
caution, important and note. The following paragraphs illustrate each
type
of alert and its associated symbol.
Warning!!
This alert is used when there is a potential risk of death or serious
injury.
Caution
This alert is used when there is the risk of minor or moderate injury to
people.
Important
This alert is used to warn about the risk of equipment damage or
malfunction.
Note
This alert is used to highlight information that is required to ensure
that procedures are performed correctly.
Contact details:
Rotronix Ltd
135 Darnley Road
RD3 Amberley, New Zealand
Commercial e-mail: [email protected]
Technical e-mail: [email protected]
Copyright:
Copyright protects original works, regardless of whether the
work is published or unpublished. Under the Copyright Act
1994, copyright automatically applies as soon as the work is
put into material form – whether in print, stored on computer
or recorded in some way. As a signatory to the Berne
convention, New Zealand protects the rights of copyright
owners from other countries in the same way it does for our
own copyright owners. It is unlawful to copy all or part of this
manual without a license or without approval from the
copyright owner, unless there is a statutory exception to such
infringement.
Abbreviation Description
3DK Third-Party Developer‟s Kit
ASCII American Standard Code for Information Interchange
AVL Automatic Vehicle Location
CCRI Computer Controlled Radio Interface
CRC Cyclic Redundancy Check
CTCSS Continuous Tone Coded Squelch System
CTS Clear to Send
DCE Data Circuit-Terminating Equipment
DCS Data Carrier System
DTE Data Terminal Equipment
DTMF Dual Tone Multi-Frequency
FEC Forward Error Correction
FFSK Fast Frequency Shift Keying
GPIO General Purpose Input/Output
IPN Internal Part Number
LED Light-Emitting Diode
MSD Most Significant Digit
National Marine Electronics Association standard.
NMEA Combined electrical and data specification for
communication between marine electronics and GPS
PC receivers.
Personal Computer
PTT Press To Talk
Motorola proprietary Professional Radio Option
PROIS
Interface Specification
Recommended Minimum sentence C. NMEA GPS
RMC
message type for the minimum recommended
RTS transmit/GPS data.
Request to Send
Rx Receive
RXD Receive Data
SDM Short Data Message
TX Transmit
TXD Transmit Data
UART Universal Asynchronous Receiver-Transmitter
XON Transmitter On
XOFF Transmitter Off
The radio is the DCE and is connected directly to the DTE, usually a
PC, via the serial port.
PC running
Com
Application
GM399
1.1 Compability
This manual supports CCRI version 1.xx and later.
The radio programming software used should be the latest released
version for the Motorola Professional Mobile Radios. Refer to the
Motorola authorized dealer for the latest version.
Note The space for a mating plug is limited to 18.6 mm width and
2.6 mm in height. It is recommended that you test the plug to be
used before manufacturing a cable.
Auxiliary
Connector
Pin 1
Accessory
connector
1.5 Limitations
4. Convert the binary number into two ASCII hex digits, 44h 41h.
1
1 Enable RX audio (Unmute radio).
0 (functions)
0 Disable Public Address Mode.
4
Enable Public Address Mode.
1 (Enable audio input to the radio Audio
Amplifier)
10, 0 Red LED OFF
11, 0 Red LED ON steady
11, 1 Red LED ON steady, slow on/off
6
11, 2 Red LED ON steady, fast on/off
20, 0 Green LED OFF
21, 0 Green LED ON steady
f17 43 1 12345678901234 CS
Send text “12345678901234” to dislay line 1.
f06 41 01 10 CS
Sound alert tone 1 in radio speaker, with volume level
10
The tone is self-terminating
f04 0101CS
Mute speaker audio
f04 0100CS
Unmute speaker audio
ZONE = 02:
CHANNEL_NO is sent as two ASCII character and represents the
channel number.
Example:
Hard-channel change to channel 1: g04020172
ZONE = 08:
Soft-channel change.
CHANNEL_NO = (txFrequency/125) (rxFrequency/125)
(txCTCSS*10) (rxCTCSS*10) 0 0
The following messages are sent from the radio to the PC. Some are
solicited by commands from the PC, while others are unsolicited and
are sent because of changes within the radio-status.
2.6.1 ACKNOWLEDGE
Solicited.
The ACKNOWLEDGE message advises the PC that the radio has
received the command successfully.
The ERROR message has the following format:
The PARITY_ERROR Flag indicates that the next frame in the receive
buffer had a parity error when received. If parity check is not enabled
the PARITY_ERROR Flag will always be read zero.
2.6.3 ERROR
Solicited and unsolicited.
The ERROR message advises the PC that the radio has detected an
error condition and cannot proceed with the current transaction. In
some cases an exception condition in the radio may cause an ERROR
message to be sent to the PC independently of any control
transactions. This is a system error, which is an unsolicited message.
[ETYPE] „R‟ indicates a restart of the radio, this means that after
the restart the radio is in default CCRI state, i.e. the same as after a
“power-up” and switch to CCDI state.
[PARA] Function
Volume
Volume
Volume control, range is from 0 (min) to 25 (max),
XX
26 indicates that radio is in control of the volume
Hook Hook
X “1” If a microphone is of the hook, “0” otherwise
Channel
Channel The channel the radio is working on.
XX Range 01- 255, “00” indicates that the radio is in
“soft-channel” mode
RSSI
RSSI
Receive signal strength from 0 (> -50dBm) to 255
XX
(< -123dBm)
p progress command
Characters to follow 14
Button 00(no button pressed)
Up/down 0 (key is up (not pressed))
Volume 26 (under radio control)
Hook 0 (on hook)
Channel 03 (channel 3 selected)
RSSI FF (< -123 dBm)
CC $0E checksum
This message was sent to the PC after the channel was changed to
channel 03.
Right $19
[PARA] Function
This message was sent after the transmitter was switched on.
This legal document is an Agreement between you (the “Licensee”) and Rotronix Ltd. By using any of the
Software or Firmware items prior-installed in the related ROTRONIX LTD product, included on CD or
downloaded from the ROTRONIX LTD website, (hereinafter referred to as “the Software or Firmware”) you
agree to be bound by the terms of this Agreement. If you do not agree to the terms of this Agreement, do not
install and use any of the Software or Firmware. If you install and use any of the Software or Firmware that will
be deemed to be acceptance of the terms of this license agreement. The terms of this Agreement shall apply
subject only to any express written terms of agreement to the contrary between ROTRONIX LTD and the
licensee.
License
ROTRONIX LTD GRANTS TO YOU AS LICENSEE THE NON- EXCLUSIVE RIGHT TO USE THE SOFTWARE OR
FIRMWARE ON A SINGLE MACHINE PROVIDED YOU MAY ONLY:
1. COPY THE SOFTWARE OR FIRMWARE INTO ANY MACHINE READABLE OR PRINTED FORM FOR BACKUP
PURPOSES IN SUPPORT OF YOUR USE OF THE PROGRAM ON THE SINGLE MACHINE (CERTAIN PROGRAMS,
HOWEVER, MAY INCLUDE MECHANISMS TO LIMIT OR INHIBIT COPYING, THEY ARE MARKED “COPY
PROTECTED”),PROVIDED THE COPYRIGHT NOTICE MUST BE REPRODUCED AND INCLUDED ON ANY SUCH
COPY OF THE SOFTWARE OR FIRMWARE;
AND / OR
2. MERGE IT INTO ANOTHER PROGRAM FOR YOUR USE ON THE SINGLE MACHINE (ANY PORTION OF ANY
SOFTWARE OR FIRMWARE MERGED INTO ANOTHER PROGRAM WILL CONTINUE TO BE SUBJECT TO THE TERMS
AND CONDITIONS OF THIS AGREEMENT). THE LICENSEE MAY 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
COMPONENTS”). OPEN SOURCE COMPONENTS ARE EXCLUDED FROM THE TERMS OF THIS AGREEMENT EXCEPT
AS EXPRESSLY STATED IN THIS AGREEMENT AND ARE COVERED BY THE TERMS OF THEIR RESPECTIVE
LICENCES WHICH MAY EXCLUDE OR LIMIT ANY WARRANTY FROM OR LIABILITY OF THE DEVELOPERS AND/OR
COPYRIGHT HOLDERS OF THE OPEN SOURCE COMPONENT FOR THE PERFORMANCE OF THOSE OPEN SOURCE
COMPONENTS. YOU AGREE TO BE BOUND BY
THE TERMS AND CONDITIONS OF EACH SUCH LICENCE. FOR MORE INFORMATION SEE:
http://www.opensource.org/licenses
Title to Software
THIS AGREEMENT DOES NOT CONSTITUTE A CONTRACT OF SALE IN RELATION TO THE SOFTWARE OR
FIRMWARE SUPPLIED TO THE LICENSEE. NOT WITHSTANDING THE LICENSEE MAY OWN THE MAGNETIC OR
OTHER PHYSICAL MEDIA ON WHICH THE SOFTWARE OR FIRMWARE WAS ORIGINALLY SUPPLIED, OR HAS
SUBSEQUENTLY BEEN RECORDED OR FIXED, IT IS A FUNDAMENTAL TERM OF THIS AGREEMENT THAT AT ALL
TIMES TITLE AND OWNERSHIP OF THE SOFTWARE OR FIRMWARE, WHETHER ON THE ORIGINAL MEDIA OR
OTHERWISE, SHALL REMAIN VESTED IN ROTRONIX LTD OR THIRD PARTIES WHO HAVE GRANTED LICENCES
TO ROTRONIX LTD.
Exclusion of Liability
IN NO CIRCUMSTANCES SHALL ROTRONIX LTD BE UNDER ANY LIABILITY TO THE LICENSEE, OR ANY OTHER
PERSON WHATSOEVER, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT (EXCEPT AS EXPRESSLY
PROVIDED IN THIS AGREEMENT), EQUITY, UNDER ANY STATUTE, OR OTHERWISE AT LAW FOR ANY LOSSES
OR DAMAGES WHETHER GENERAL, SPECIAL, EXEMPLARY, PUNITIVE, DIRECT, INDIRECT OR CONSEQUENTIAL
ARISING OUT OF OR IN CONNECTION WITH ANY USE OR INABILITY OF USING THE SOFTWARE OR FIRMWARE
(INCLUDING OPEN SOURCE COMPONENTS). THE LICENSEE‟S SOLE REMEDY AGAINST ROTRONIX LTD WILL BE
LIMITED TO BREACH OF CONTRACT AND ROTRONIX LTD‟S SOLE AND TOTAL LIABILITY FOR ANY SUCH CLAIM
SHALL BE LIMITED AT THE OPTION OF ROTRONIX LTD TO THE REPAIR OR REPLACEMENT OF THE SOFTWARE
OR FIRMWARE OR THE REFUND OF THE PURCHASE PRICE OF THE SOFTWARE OR FIRMWARE.
General
THE LICENSEE CONFIRMS THAT IT SHALL COMPLY WITH THE PROVISIONS OF LAW IN RELATION TO THE
SOFTWARE OR FIRMWARE.
No Dealings
THE LICENSEE MAY NOT SUBLICENSE, ASSIGN OR TRANSFER THE LICENCE OR THE PROGRAM EXCEPT AS
EXPRESSLY PROVIDED IN THIS AGREEMENT. ANY ATTEMPT OTHERWISE TO SUBLICENSE, ASSIGN OR
TRANSFER ANY OF THE RIGHTS, DUTIES OR OBLIGATIONS HEREUNDER IS VOID.
No Other Terms
THE LICENSEE ACKNOWLEDGES THAT IT HAS READ THIS AGREEMENT, UNDERSTANDS IT AND AGREES TO BE
BOUND BY ITS TERMS AND CONDITIONS. THE LICENSEE FURTHER AGREES THAT SUBJECT ONLY TO ANY
EXPRESS WRITTEN TERMS OF AGREEMENT TO THE CONTRARY BETWEEN ROTRONIX LTD AND THE LICENSEE
THIS IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN IT AND ROTRONIX LTD IN
RELATION TO THE SOFTWARE OR FIRMWARE WHICH SUPERSEDES ANY PROPOSAL OR PRIOR AGREEMENT,
ORAL OR WRITTEN AND ANY OTHER COMMUNICATIONS BETWEEN THE LICENSEE AND ROTRONIX LTD
RELATING TO THE SOFTWARE OR FIRMWARE