The information contained in this manual and the accompanying
software programs are copyrighted and all rights are reserved by
EROCOMM
A
, Inc. A
EROCOMM
, Inc. reserves the right to make
periodic modifications of this product without obligation to notify
any person or entity of such revision. Copying, duplicating, selling,
or otherwise distributing any part of this product without the prior
consent of an authorized representative of A
EROCOMM
, Inc. is
prohibited.
All brands and product names in this publication are registered
trademarks or trademarks of their respective holders.
Class B digital device, pursuant to Part 15 of the FCC Rules. These limits
are designed to provide reasonable protection against harmful
interference when the equipment is operated in a residential environment.
This equipment generates, uses, and can radiate radio frequency energy
and, if not installed and used in accordance with the instruction manual,
may cause harmful interference to radio communications. However, there
is no guarantee that interference will not occur in a particular installation.
If this equipment does cause harmful interference to radio or television
reception, which can be determined by turning the equipment off and on,
the user is encouraged to try to correct the interference by one or more of
the following measures:
FCC N
• Reorient or relocate the receiving antenna
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from the
one the receiver is connected.
OTICE
WARNING: This device complies with Part 15 of the FCC Rules. Operation is subject to the
following two conditions: (1) this device may not cause harmful interfe rence and
(2) this device must accept any interference received, including interference that
may cause undesire d operation.
Revision sDescription
Version 1.0Initial Release Version - 2/4/99
Version 1.1page 24 - System ID Address corrected from 30h to 34h
Version 2.0Add transparent serial modes – 5/25/1999
Added EEPROM Write Protect
Changed Pin 27 Definition to Forced API Mode 03
Version 3.0Add broadcast packet attempts – 6/10/1999
Broadcast Packet size increased from 256Bytes to 2KBytes
Version 3.1Correct number of channels from 75 to 77 – 7/22/1999
Change nomenclature for Serial Packet Mode 03 to Serial API Mode 03
Information furnished by AeroComm in this specification is believed to be accurate. Devices sold by
AeroComm are covered by the warranty and patent indemnification provisions appearing in its Terms of
Sale only. AeroComm makes no warranty, express, statutory, implied or by description, regarding the
information set forth herein. AeroComm reserves the right to change specifications at any time and without
notice.
AeroComm’s products are intended for use in normal commercial applications. Applications requiring
extended temperature r ange or unusual environmental requir ements such as military, medical life-support or
life-sustaining equipment, are specifically not recommended without additional testing for such application.
8.INITIALIZING THE PKLR2400 RADIO........................................................................................ 39
Preliminary5
Overview
1. Overview
This document contains information about the hardware and software interface between an
AeroComm PKLR2400 Radio and an OEM host. Information includes the theory of operation, system
issues, and a basic command set for operational control of the system and radio.
The Radio is designed to allow flexibility at the hardware interface level with a minimum number
of actual hardware pins connecting the radio and the OEM Product. The radio is controlled by a Dallas
87C520 microcontroller providing program storage. A separate EEPROM provides user definable
parameter storage.
The RF system is a Client/Server (Slave/Master) architecture. Data can be transmitted from client
to server or server to client, but not from client to client, or server to server. Clients can only hear servers
and servers can only hear clients.
The Serial Interface Modes provide four main serial user interfaces. This protocol provides
significant flexibility to the OEM allowing them to provide data in many forms including packet, end
character and fixed-length with and without timeouts.
Preliminary6
PKLR2400 Specifications
2. PKLR2400 Specifications
GENERAL
Bus InterfaceSerial (TTL Level Asynchronous) or Parallel through 40
pin mini con nect or. Amp P/N 177986-1 or Berg
Interface Data Rate
Serial
Parallel
ComplianceCertifiable under:
Power Consumption
TX/RX Active (All Modes)
Interface ON/RF OFF (API Mode Only)
Sleepwalk (All Modes)
Standby (API Mode Only)
ChannelsSupports 77 non-in terf ering chan nel s
SecurityUser assigned Syst em ID. Unique IEEE addres s on each
Prog to 800 kbps. Supports PC rate s to 57.6 Kbps
4 Mbps
US - FCC15.247
Canada - DOC
Europe - ETSI
Japan - MKK
115mA ty pical
45mA typi cal
35mA typi cal
30mA typi cal
radio.
RADIO
Frequency Ban d2.402 – 2.478 GHz
Radio TypeSpread Spectrum Freque ncy Hoppi ng
Output Pow er10mW
Voltage5V nominal +5%, +
Sensitivity-90dBm
Data Rate1Mbps
RangeIndoors up to 300ft, Ou tdoors u p to 3000f t
Can be extended with directional antenna
50mV ripple
ENVIRONMENTAL
Temperature (Operating)0 to +60 C
Temperature (Storage)-50 to +85 C
Humidity (n on- conden si ng )10% to 90%
PHYSICAL
Dimension s1.65” x 2.65” x 0.20”
Antenna ConnectorStandard MMCX jack
WeightLess than 0.5 ounce
SOFTWARE
User Configurable Options
Host Interface Data RateUp to 800Kbps
Variable Packet LengthUp to 2Kbyte
Serial Interface Modes(3) Transparent and (1) API
Diagnostic Error Counters
User Programmable Attem ptsUp to 255
Preliminary7
PKLR2400 Specifications
3. Theory of Operation
3.1 Definitions
Server Host:
Client Host:
Host refers to both the server host and the client host
Host:
Server Radio:
Client Radio:
server radio
Authentication:
subsequent issuance of an In-Range* command by the Client Radio to the Client Host.
Unicast Address:
Broadcast Address:
The server host is the OEM device controlling the server radio
The client host is the OEM device controlling the client radio
The server radio is the “master” radio. It is the hub of communications
The client radio is a “slave” radio. It is controlled by it’s own Host, but is a slave to the
The acquisition of the IEEE 802.3 address of the Server Radio by the Client Radio and the
A frame that is directed to a single recipient as specified in IEEE 802.3.
A frame that is directed to multiple recipients as specified in IEEE 802.3.
3.2 Serial Interface Modes
The PKLR2400 provides four Serial Interface Modes with programmability within each mode
allowing maximum system flexibility. These four Serial Interface Modes include three transparent modes
and one API mode. The radio-to-radio protocol is identical on all three Transparent Serial Interface Modes.
This allows all three Transparent Serial Interface Modes to coexist within the same network. The API
Serial Interface Mode 03 is not interoperable with the Transparent Serial Interface Modes 01, 02 and 04.
3.2.1 Serial Interface Mode 01 – Transparent, Fixed Length, with Timeout
Mode 01 specifies Transparent mode with fixed length packets and active timeout. Packets will be
transmitted over the RF interface when one of the following conditions occurs:
•The number of data bytes received over the interface is equal to the buffer specified by
the user in EEPROM address locations 43H and 44H.
•A byte gap larger the timeout specified by the user in EEPROM location 4DH occurs.
3.2.2 Serial Interface Mode 02 – Transparent, End Character
Mode 02 specifies Transparent mode with End Character. Packets will be transmitted over the RF
interface when the user-defined End Character is received by the radio over the interface. The End
Character is defined by the user at EEPROM location 3EH.
Preliminary8
Theory of Operation
3.2.3 Serial Interface Mode 03 – API
Mode 03 specifies API Mode. In this mode, the OEM has control of the radio command set
detailed in Section 6.2. Packets are transmitted upon completion of the Send_Data command.
In API Serial Interface Mode 03, the OEM host may utilize a set of basic commands to control the
radio and system. These commands allow the customer to establish system parameters through the
programming of variables in EEPROM as well as monitoring system performance.
only be exercised when the radio is in API Serial Interface Mode 03
aspects of the software commands.
1. There are only three commands that are issued from the client radio to the Client Host. These
three commands are Out_of_range*, In_range* and Receive_data*. The Receive_data*
command is the only command issued from the Server radio to the Server Host. It is
important to note that these commands will
the Host to alert it to incoming data, or a change of status.
2. All remaining commands initiated by the Host MUST receive an acknowledge from the radio
to signal completion of the assigned task. This works as flow control for the information
going to the radio.
The server radio can receive data from a total of 75 different clients, but from only 8 different
clients in any 30 millisecond interval. It is possible that there will be multiple Receive_data* commands at
the same time. Since there is no reply command at the completion of Receive_data*, the Host must be
capable of handling up to 8 Receive_data* commands at one time.
get an acknowledgement, they are signals to
NOT
. It is important to understand two
These commands can
Note: This means that whenever a command is initiated by the radio to the Host, the Host must be
ready to accept the command and any data following the command.
Note: A full list of commands, definitions, and implementation can be found in Section 6.
3.2.4 Serial Interface Mode 04 – Transparent, Fixed Length, No Timeout
Mode 04 specifies Transparent mode with fixed length packets and no timeout. Packets will be
transmitted over the RF interface when the number of data bytes received over the interface is equal to the
buffer specified by the user in EEPROM address locations 43H and 44H.
3.2.5 Serial Interface Buffer
The serial interface buffer provides 8Kbytes of memory broken into four dynamic regions. In the
API Serial Interface Mode 03, only one region is utilized. In the Transparent Serial Interface Modes 01, 02
and 04, a buffer region is used each time a packet release condition is met. As an example, in End
Character Mode 02, if 500 bytes are transmitted followed by the specified end character, 500 bytes will be
stored in the first region and the remianing 7.5Kbytes will be dynamically allocated for the next three
packets. It is strongly recommended that CTS or upper layer protocol with acknowledgements be used by
the OEM when operating in Transparent Serial Interface Control Modes to eliminate the following system
issues:
Note: If all four buffers are filled and the OEM host continues to send data over the interface, it will
be discarded by the radio. This can be eliminated if the OEM utilizes CTS.
Preliminary9
Theory of Operation
3.3 Initialization Sequence
When operating in the three Transparent Serial Interface Modes, the initilization sequence is
managed by the AeroComm protocol. In-Range commands are not issued and there is no acknowledge from
the radio on data delivery unless the OEM protocol has built-in acknowledgement.
When operating in the API Serial Interface Mode 03, the following initialization sequence
. During the power up sequence or upon a Reset* command, the Clear to Send (CTS) line is set high
occurs
(5V TTL logic levels). While CTS is high, initialization occurs, and when finished, CTS is put low
indicating successful initialization is complete.
Note: At this point, the only command that can not be issued is the
command can only be issued after the
Before data communications can begin, a client radio needs to be authenticated. The client host
must issue an RF_enable* command to activate the client radio and receive an acknowledgement from the
client radio. The server radio transmits a beacon containing it’s IEEE 802.3 address. Once the client radio
has been activated by use of the RF_enable* command, it will receive the server radio IEEE 802.3 address
once it is in range. Upon receiving the IEEE 802.3 server radio address, the client radio will issue an
In_range* command to the Client Host containing the IEEE 802.3 server radio address.
The client host must receive the In_range* command from the client radio before the Send_data*
command is invoked. Broadcast mode, as defined by IEEE 802.3, is supported and can be used to send
data to all radios that are within range but its use should be limited because reception of the message is not
guaranteed.
When the last bit of data is transferred from the Host to the radio, the Host must wait for the CTS
line to transition high (meaning that the radio has found the end of the data packet) and then transition back
low (meaning that the radio is ready for the next command).
*Note:
CTS
from
Radio
TXD
LSB First
From Host
used the CTS signal will be
inverted coming from the radio .
Command LengthChecksumData
RF_enable*
If level translators are
and
In_range*
Send_data*
commands have been issued.
command . Th is
Delay for reply command
(1)(2)
Clear To Send minimum delay of 40
Note: All serial data must be transmitted LSB first.
Note: These radios are designed to be single threaded, meaning that for every command issued, there
is a reply command that signifies the completion of the command issued. There can be no
interleaving of commands.
Preliminary10
µµµµ
s between (1) and (2) after end of data packet
Hardware Interface
4. Hardware Interface
4.1 Mechanical Overview
The PKLR2400 measures 1.65” x 2.65”. Critical parameters are as follows:
Note: The AeroComm radio provides 5Volt logic levels at the interface connector, J1
Note: DCD is not utilized.
Note: * Parallel interface not implemented at this time.
Preliminary12
Developers Kit
4.3 Pin Descriptions for Connector J1
Special considerations for the hardware interface at connector, J1, are described in this section.
All remaining pin descriptions are standard for serial hardware interfaces.
4.3.1 No Connect
All No Connect pins 2, 4, 6-19, 22, 28-35 and 37 must not be connected to logic high or low
levels, but must be left floating.
4.3.2 Vcc
All Vcc pins 3, 5 and 39 require power of 5Vdc + 5% with ripple of less than 50mv p-p.
4.3.3 Clear To Send (CTS)
Clear To Send (CTS), pin 23, requires a minimum delay of 40µs between (1) and (2) after end of
each data packet.
If level translators are
CTS
from
Radio
TXD
MSB First
From Host
*Note:
used the CTS signal will be
inverted coming from the radio .
Command LengthChecksumData
Figure 1. Timing No te for CTS Pin
Delay for reply command
(1)(2)
4.3.4 Reserved
The reserved pins 24 and 25 are used by AeroComm for internal testing and/or future radio
enhancements. These pins should be treated as No Connect pins and must not be connected to logic high or
low levels, but must be left floating.
4.3.5 Baud Rate Selector (BDSEL)
The Baud Rate Selector (BDSEL), pin 26, provides the user a default method of communicating
with the radio in the event the EEPROM baud rate parameters become corrupted. If pin 26 is logic high
level or not connected, the baud rate will default to the variables specified in EEPROM. If pin 26 is logic
low level, the baud rate will default to 9600 baud.
4.3.6 Forced API Mode 03 (PKTMODE)
Forced API Mode 03 (PKTMODE), pin 27, provides the user a method of programming the radio
from any of the Transparent Serial Interface Modes to the API Serial Interface Mode
Preliminary13
. It is required that
Developers Kit
the radio be in API Serial Interface Mode to execute the Command Set or to configure any of the
EEPROM parameters.
low level and the radio reset. The radio can not be placed into any of the Transparent Serial Interface
Modes 01, 02 or 04 until pin 27 is held at logic high level and reset.
To force the radio into API Serial Interface Mode 03, pin 27 must be held at logic
4.3.7 Microprocessor Reset (uP RESET)
Microprocessor Reset (uP RESET) is a chieved by holding pin 38 at logic high level for a
minimum of 2ms. If uP RESET is performed after power has been applied to the radio and is stable, the
reset time will be significantly less. At all other times, pin 38 should be logic low level. If pin 38 is not
connected, the microprocessor will hold pin 38 at logic low level.
4.3.8 EEPROM Write Protect (E2WP)
EEPROM Write Protect (EEWP) is enabled when pin 37 is at logic high level or left floating. Pin
37 must be logic low level to Write to the EEPROM.
Preliminary14
Developers Kit
5. Developers Kit
SDK-PKLR2400P (Paralle l) and S DK- PKL R2400S (S erial) D evel oper Kits hel p sy st em desi gn ers
implement radio designs quickly . The kit offers all the cables, pow er supplies, circuit schem atics, documen tation
and accessories needed to begin us ing the PKLR 2400 quick ly .
The kit includes:
• (2) PKLR2400 Data Radios ei ther s erial or paral lel
• (2) Serial Adapter Boards with 40 pin interf ace, 40 pin h eader, LED in dicators, pow er con nector and DB9
connector. (SDK-PKLR 2400S in clu des RS232 t rans ceivers )
• (2) AC Power Adapters
• (2) DB9 to DB9 or (2) DB9 to DB25 for the SDK- PKL R2400S an d SD K-PK LR 2400P respecti vely
• Hardware and softw are interf ace specifi cation
• (2) Antenna cables w ith patch ante nn a (m onopole or di pole ant enn a option al)
• Software utilities
• Technical Support
Preliminary15
Developers Kit
5.1 Serial Adapter Board
The Serial Adapter Board allows the use of different forms of communication with the OEM
radios. The user must choose between using RS-232 levels or 5 Volt TTL logic levels for interfacing with
the OEM radio when using the adapter board.
Figure 2. Serial Adapter Board Assembly Drawing
Item Qty ReferenceDescription
11J1
21J2DB9 Male connector mates with provided cable to PC or OEM Host
31P1Power Connector provides power to entire kit with provided 5Vdc PS
42J10Generic 40 Pin Dip Header 0.100 Centers for test points
57J3-9Generic 3 Pin Sip Header 0.100 Centers for level translator selection
62U1-2Max202 Voltage Level Conversion Chips
71SW1SPST Switch for Reset
81SW2EEPROM Write Enable when Depressed
NOTE: The pins on the 40 pin header strip match up 1 to 1 with the pin-out of the OEM Connector
J1.
Preliminary16
Amp 40 Pin Connector (177985-1) mates directly with J1 on Radio
Developers Kit
J3-J9 Level Translator Settings
If a PC will be used as the OEM server or client host, then level conversion must be enabled to
convert from the RS-232 levels at the PC to the 5 Volt TTL logic levels used on the radio. To enable level
conversion, place jumpers J3-J9 on pins 2 and 3, see Figure 3. If another device (0-5 volt TTL logic levels)
is to act as the Host for the radio then the user must disable level conversion. To disable level conversion,
place jumpers J3-J9 on pins 1 and 2 see figure 4.
Note: If level translation is enabled it is important to note that the signal level will be inverted at the
interface connector, J1, between the OEM radio and the Serial Adapter Board.
If running under Windows, jumper J6
Figure 5. Jumper Definitions.
Jumper Associated Serial Signal
From DB-9
J3RX Data
J4TX Data
J5Clear to Send
J6PKTMODE/RTS
J7NA
J8NA
• *.RTC – Script files that automate radio mode setup and demonstrates operation.
• PORTS.CFG – Com port address and baud rate information
• README.TXT – Further utility software documentation and latest release notes
• OEM.CFG – Confi guration file for OEM.EXE
• OEMRWSP.INI –
These files are located in each of three directories as follows:
1.
OnePC
PC. The Client Radio must be connected to Com1 (3F8) and the Server Radio must be connected to
Com 2 (2F8)
2.
ClientPC
one PC and the Server Radio on a separate PC. The Client Radio should be connected to Com 1 (3F8)
3.
ServerPC
PC and the Server Radio on a separate PC. The Server Radio should be connected to Com 1 (3F8)
– This directory contains all the files required to run the Client and Server radios on a single
- This directory contains the Client Radio files that are required to run the Client Radio on
- This directory contains Server Radio files that are required to run the Client Radio on one
The software utilities are written for a DOS environment. The software
The software includes
AeroComm Use Only
5.2.1 OEM.EXE
This software contains three unique utilities to exercise, monitor and setup modes in the radios.
These utilities are: Transmit/Receive Emulator, Single Line Command Interface, and EEPROM
Viewer/Editor.
5.2.1.1 Transmit/Receive Emulator
This software allows (1) Server and (1) Client radio to communicate with each other. The
software comes pre-configured for the two radios in the development kit.
When connecting the Client and Server Radios to the same PC
Com 2 (2F8), then connect the Client Radio to Com 1 (3F8). Copy the OnePC directory and contents to the
PC.
When connecting the Client and Server Radios to separate PCs
Com 1 (3F8) on one PC, then connect the Client Radio to Com 1 (3F8) on a separate PC. Copy the
ClientPC directory and contents to the PC with the Client Radio attached. Copy the ServerPC directory and
contents to the PC with the Server Radio attached.
Note: The factory default for the Client Radio and Server Radio is API Serial Interface Mode 03.
Run OEM.EXE on one or both PCs as dictated by your setup. Press the 'F3' key to perform a
RESET and RF_Enable on all PCs. Press the 'F9' key to run the script files and demonstrate continuous
data transfers between radios. Press the 'Esc' key to stop. Pressing the 'Esc' key again will exit from the
program.
, connect the Server Radio to
, connect the Server Radio to
Note: The “F3” key should be used only when the radios are in API Serial Mode 03. Use “Alt R” to
perform a RESET of the radios in Transparent Serial Modes 01, 02 and 04.
While running, the screen will display transmit timeouts, receive timeouts, and run number. The
Emulator program is controlled by script files. The script files can be edited by the user and detailed
Preliminary18
Developers Kit
instructions on how to write a script file can be found in the section below describing
Emulator, pressing the ‘Alt’ key will bring up a window with 7 choices: File, Settings, Window, Reset,
Enable, Help and About. The
to ports 1 or 2. The
option allows the user to view the trace buffer or a list of the script commands. The
Reset command to all ports configured in
ports confi gured in
Note: The factory default for the Client Radio and Server Radio is API Serial Interface Mode 03.
Therefore, both radios must receive an RF_enable before scripts can be run.
Note: Receive commands expecting more than 16 bytes will fail in 'F10' single-step mode.
The Transmit/Receive Emulator can also be used to execute the setup scripts provided with the
program. For a full list of the scripts, see the readme.txt file in the directory labeled ‘Scripts’ on the disk.
To execute a script, press ‘alt-F’ and then ‘Enter’ to bring up a selection window. You can enter the name
of the setup script to be run, or hit ‘Enter’ to see a list of all the available script files. It is important to note
that when you hit ‘Enter’ it will show all the script files that are in the same directory as the executable
oem.exe. Once you have a script file loaded, then you will need to depress the write protect tab on the
serial adap t er board while you single step (‘F10’) through the commands in the scrip t. Once you have
executed all the commands in the set-up script you must press the reset button on the serial adapter board
before any of the changes will be implemented.
Settings
PORTS.CFG
option allows the user to load a script file or execute a mode setup script
File
option allows the user to change baud rate and other settings. The
Reset
PORTS.CFG
.
. The
command sends a RF_Enable to all
Enable
. While in the
*.RTC
Window
command issues a
5.2.1.2 Single Line Command Interface
While in the Transmit/Receive Emulator press the ‘F5’ key to enter into the One Line Command
Interface. The one line Command Interface allows the user to command the radios into various operation
modes. The command set has already been entered. To invoke a command, scroll to the appropriate
command, using the up/down arrows on the keyboard, until the appropriate command is highlighted. Press
the 'F10' key to send the command to the radio. Press the 'F9' key to continuously retransmit the same
command until the 'Esc' key is pressed. Press the 'F8' key to toggle between ports 1 and 2 (com1 and
com2). You will see the active port and address displayed at the top of the screen
Upon successfully receiving and executing the command, the radio will send back a acknowledge
displayed in the "Receive Data" window. At the end of each command sequence line, a highlighted
checksum is displayed. When entering a new command, it is not necessary to enter a checksum. The
program automatically calculates and enters the checksum. On exit, changes to the command interface can
either be saved or ignored. Press the 'Esc' key to exit.
5.2.1.3 EEPROM Viewer/Editor
Press the 'F2' key to enter the EEPROM viewer/editor screen. To edit a value on this screen,
simply move the cursor to highlight the appropriate value, type in the new value and press the 'Enter' key.
To undo an edit, either press the 'Esc' key to return to the Command Interface, or press any arrow key. To
update the radio with the new EEPROM values, press the 'F10' key. An EEPROM read can be performed
on this page by pressing the 'F9' key.
5.2.2 *.RTC
Preliminary19
Developers Kit
*.RTC files contain all of the configuration information for OEM.EXE. *.RTC files can be
modified to change timeouts, ports, and commands. *.RTC files require very specific format as detailed
below:
* -- begins and ends each command sequence
T -- invoke transmit sequence over serial host/radio interface (API Mode 3)
R -- invoke receive sequence over serial host/radio interface (API Mode 3)
C -- invoke transmit sequence over serial host/radio interface (Transparent Modes 1,2,4)
S -- invoke receive sequence over serial host/radio interface (Transparent Modes 1,2,4)
D -- invoke dela y
Note: Any line beginning with a "space" character is interpreted as a comment
Note: The first line in PING.RTC is always interpreted as a comment
Example Command Format
*T[transmit port number] [timeout]
[transmit port number] is either "1" or "2" as designated in PORTS.CFG
[timeout] is between "0000" and "9999" and is measured in milliseconds
Before attempting to run the executables, the user must ensure the development kit radios are
attached to the two ports specified in PORTS.CFG. The default configuration for PORTS.CFG assumes
that both developer kit radios are connected to the same computer.
The default baud rate in PORTS.CFG is 57600.
EEPROM has been corrupted
to change the baud rate to 9600 and pin 26 on the interface connector, J1, of the radio must be logic low
level to communicate.
Note: If the EEPROM parameters for baud rate are changed, and the radio is reset, these utilities
will not communicate with the radio until pin 26 is held at logic low level and the third line o f
PORTS.CFG is changed to 9600.
. In the event of corrupted EEPROM, hit “AltS” in the OEM.EXE program
This should not be changed unless the
5.2.4 Setup Scripts
AeroComm provides several scripts to allow easy setup and configuration for different modes. These setup
scripts are as follows:
S1AC.RTC – Setup client radio to Mode 1 Addressed
S1AS.RTC – Setup server radio to Mode 1 Addressed
S1NC.RTC– Setup client radio to Mode 1 Non-Addressed
S1NS.RTC– Setup server radio to Mode 1 Non-Addressed
S2AC.RTC– Setup client radio to Mode 2 Addressed
S2AS.RTC– Setup server radio to Mode 2 Addressed
S2NC.RTC– Setup client radio to Mode 2 Non-Addressed
S2NS.RTC– Setup server radio to Mode 2 Non-Addressed
S4AC.RTC– Setup client radio to Mode 4 Addressed
S4AS.RTC– Setup server radio to Mode 4 Addressed
S4NC.RTC– Setup client radio to Mode 4 Non-Addressed
Preliminary20
Developers Kit
S4NS.RTC– Setup server radio to Mode 4 Non-Addressed
SP3CS.RTC –This file is used to configure both the client and server radio into Mode 3 Receive mode 1
(Unicast/Broadcast).
SP3CS02.RTC – This file is used to configure both the client and server radio into Mode 3, receive mode 2
(unicast only)
SP3CS03.RTC – This file is used to configure both the client and server radio into Mode 3, receive mode 3
(Promiscuous)
In general, the filenames are defined as follows: S – Setup; X – Mode (X= mode1-4); A or N –
Addressed or Non-addressed; C or S – Client or Host. Example script name: S2NC.RTC, this would be the
setup script to set up the client radio in Mode 2, with Non-addressed broadcast mode enabled.
Also included are ping files which provide data to the radios so that out of the box, the radio’s can
be demonstrated. The included ping files are:
PINGT1B.RTC – This file is used when the radios are in Mode 1. This has big packet size just about 1K
PINGT1S.RTC – This file is used when the radios are in Mode 1. This has small packet size, < 256 Bytes
PINGT2.RTC – This file is used when the radios are in Mode 2. Has 0D as the end character
PINGT22.RTC – This file is used when the radios are in Mode 2. Has 27 as the end character.
UNICAST.RTC – This file is used when the radios are in Mode 3. As the name implies this utilizes unicast
packet structure.
BCAST.RTC – This file is used when the radios are in Mode 3. As the name implies this utilizes broadcast
packet structure.
JUNK.RTC – This is a j unk packet with no accurate destination or source addr ess, this is used to test
promiscuous mode as well as can be used to prove that such a packet is disregarded in receive
mode 1 & 2.
PINGP3B.RTC – This file is a joint packet structure to be used in Mode 1 or Mode 3. It has a broadcast
packet followed by a unicast packet.
PINGT4B.RTC – This file is used when the radios are in Mode 4. This has a big packet size..just about 1K
PINGT4S.RTC – This file is used when the radios are in Mode 4. This has a small packet size, < 256 Bytes
Preliminary21
Developers Kit
5.3 Antenna Board
The developer kits are provided with (2) patch antennae mounted on a ground plane. In addition,
(2) SMA male to MMCX plug, cables are provided to interface the antenna boards to the radio. Optional
antennae are available for testing. Antenna selection is instrumental to and will impact overall system
performance.
5.4 Power Supply Specification
(2) power supplies are also provided to power both units in the developer kit. These supplies are
rated at regulated 5Vdc and 300ma.
Preliminary22
Command Set
6. Command Set
The basic command set consists of several commands from the Host and Radio
set can be used ONLY when the radio is in Serial Interface API Mode 03 determined by the
EEPROM address at 4AH (See Chapter 7, Configuring the PKLR2400).
as follows:
CommandLengthDataChecksum
Command
Length
is in little endian format.(i.e. low byte/hi byte). This length does not include the checksum.
Data
Checksum
block beginning after the Length.
-- 1 Byte. This is the actual command from the appropriate processor.
-- 2 Bytes. This is the total size of the remaining data for this command. The length field
-- N Bytes. The actual data associated with the command.
-- 1 Byte. The checksum is a byte-by-byte, bitwise “EXCLUSIVE OR” of the Data
The command set is de si gned
. The command
6.1 System Command Set Summary
The System Commands allow the user to initialize the system and perform general system analysis
when operating in API Serial Interface Mode 03.
NameCommandLengthDataChecksum
Reset*AAH0H0HAAH
Control*86H1 to 5 (depends of sub command)As RequiredAs Required
Diagnostic Result*87HAs RequiredAs RequiredAs Required
Standby*88HNo yet supported
Reset EEPROM*89H0H0H89H
Status Request*8AH1H0-reset error counter
1-don’t do anything
Status Reply*8BH14H-611HSee 5.1.16
Update EEPROM
Checksum*
Check EEPROM
Checksum*
EEPROM Checksum
Status*
Acknowledge*As Required0HAs Required
8CH0H0H8CH
8DH0H0H8DH
8EH1H0-Checksum invalid
1-Checksum valid
8AH
8EH
6.1.1 Reset*
This command is issued from the Host processor to the Radio. This command provides a software
reset to the PKLR2400 Radio initializing the code at the same location as a hardware reset. This must be
followed by an RF Enable.
Preliminary23
Command Set
6.1.2 Control*
The Host processor will issue this command to Write and Read EEPROM as well as for NOP.
Sub Command one byteDescription
2H*Read EEPROM. Additional data: first two bytes
specify starting address. Second two bytes specify
ending address.
8H*NOP.
9H*Write EEPROM. Additional data first two bytes
specify starting address. Second two bytes specify
ending address. Remaining bytes specify data to be
written. (Range 00 to 7F)
Data Frame:
86HLength Low0HDataChecksum
Note: Any additional subcommands are reserved by the system and if used may cause system
operation problems.
Note: Following and
Checksum*
Note: Following the
any EEPROM changes will beco me active.
command .
EEPROM Write*
EEPROM Write*
Command, the user should invoke the
Command, the user MUST invoke the
Update EEPROM
Reset*
command before
6.1.3 Diagnostic result*
The Radio will issue this command upon completion of the diagnostic process.
Sub result one byteDescription
2H*Read EEPROM. Additional data: first two bytes
specify starting address. Second two bytes specify
This command is issued by the Host processor to put the Radio in one of two low power modes.
For mode 0, the Radio should disable the radio and enter a low power state. The hop synching is the only
allowed operation in this mode. For mode 1, the Radio should go into deep sleep mode. The Radio should
come out of low power modes when a command is issued from the Host processor. This command requires
an acknowledge.
This command is sent by the OEM Host to the Radio, the result of which sets the various
locations/parameters in the EEPROM to their default values. The execution of this command does NOT
affect the IEEE Address and Operation Mode parameters in the EEPROM. This command returns a generic
positive acknowledgment.
6.1.6 Status Request*
This command is sent by the OEM Host to the Radio to find out the various statistics associated
with the RF Data Link Layer. The Radio sends back the values of the various parameters/statistics as part of
the Status Reply command. 1 byte of data is supplied along with the command that determines whether the
Radio resets the various Error Counters or not.
Preliminary25
Command Set
6.1.7 Status Reply*
This command will be sent by the Radio to the OEM Host in response to a Status Request
command. All the different parameters pertain to the data link layer and are cumulative totals. Once this
command has been sent back to the OEM Product, depending on whether the OEM Product desired an error
counter variable reset, the reset operation is carried out. The different statistics and their sizes are shown
below:
NameTypeDescriptionSize
Radio TimeTime
Counter
Tx FailuresError
Counter
Tx RetriesError
Counter
Rx FailuresError
Counter
Rx RetriesError
Counter
Num Active
Radios
List of
Registered
Radios
Data CounterNumber of clients registered to a
IdentityA list of 6 byte IEEE Addresses of all the
Incremented by 1 every 250ms. Initialized to
0 at power on or reset.
Number of times the Radio was not able to
deliver a data frame to the destination
Number of times the Radio had to retry before
delivering a data frame to the destination
Number of times the Radio had to throw away
a received data frame because of bad
CRC/checksum
Number of times data frames had to be
retransmitted before a valid data frame was
received
Server Radio. If the Radio under
consideration is a Client radio, just return 0
radio devices + 3 byte time stamp + 3 byte
packet count. Time stamp and packet counter
are reset at power on or RESET.
Unsigned Byte – 3
bytes, Low Byte
first
Unsigned Long 4 bytes
Unsigned Long 4 bytes
Unsigned Long 4 bytes
Unsigned Long 4 bytes
Unsigned Byte - 1
Byte
12 bytes * Num
Reg Client Radios
Status Reply Example
NameType0 Active Radios2 Active Radios
Radio TimeTime Counter1 Byte – TL
1 Byte – TM
1 Byte – TH
Tx FailuresError Counter4 Bytes4 Bytes
Tx RetriesError Counter4 Bytes4 Bytes
Rx FailuresError Counter4 Bytes4 Bytes
Rx RetriesError Counter4 Bytes4 Bytes
Num Active RadiosData Counter02
List of Registered RadiosIdentity6 bytes IEEE Address
ChecksumActualActual
Data Frame:
8BH17H00HDataChecksum
Preliminary26
1 Byte – TL
1 Byte – TM
1 Byte – TH
3 bytes time stamp
3 bytes packet count
6 bytes IEEE Address
3 bytes time stamp
3 bytes packet count
Command Set
6.1.8 Update EEPROM Checksum*
This command is sent by the Host to the AeroComm module to tell it to recalculate the checksum.
This is typically done by the Host CPU after it has completed writing data to the EEPROM on the
AeroComm module. The response to this command is an acknowledge.
6.1.9 Check EEPROM Checksum*
This command is sent by the Host CPU to the AeroComm module to validate the EEPROM
checksum. This is typically done after bringing up the AeroComm module out of reset. The AeroComm
module reports either a good or a bad checksum, by sending back a response called EEPROM Checksum
Status
6.1.10 EEPROM Checksum Status*
This command is sent by the AeroComm module in response to a Check EEPROM Checksum
command from the Host CPU. The data portion of the command indicates whether the checksum is good or
bad, based on which the Host CPU takes the appropriate action.
6.1.11 Acknowledge*
Some commands in the above set have an implied positive response. The generic positive
response is defined as the command sequence just received retransmitted back with a zero length.
Preliminary27
Command Set
6.2 Radio Command Set Summary
The Radio Commands allow the user to control the flow of data into and out of the radio as well as
initialization of the radio in API Serial Interface Mode 03.
NameCommandLengthDataChecksum
RF enable*80H0H0H80H
Send Data*81H1 to 7f0h (includes 802.3 Header)As requiredAs Required
Send Data Complete*82H1H0 or 1 (see 5.1.4)As Required
Received Data*83H1 to 7f0h (includes 802.3 Header)As RequiredAs Required
In range*84H06HIEEE address of
Server Radio
Out of Range*85H0H0H85H
As Required
6.2.1 RF enable*
This command is issued from the Host processor to the Radio. The Radio must have this command
issued to it prior to any RF data transfers. This is a command with no data. Typically, this command is
issued to the Radio just after it has b een brought out of r eset. This enabl es the RF portion o f the Radio and
turns the transmitter/receiver ON. This command requires an acknowledge.
6.2.2 Send data*
This command is issued by the Host to the Radio to send a data frame. The data frame here is the
actual frame that the transport/network protocol wants to send out. The data portion will be delivered to the
appropriate RF device. Broadcast frames will be delivered to all registered Client Radios without a RF data
link ACK. Broadcast frames are not required to reach all destinations. They are typically sent to everyone
at once.
Data Frame:
81HLength LowLength HighDataChecksum
Destination AddressSource AddressData
MS Byte…LS ByteMS Byte…LS Byte
Note: The Data must include header information as follows:
(6)Bytes for the IEEE 802.3 standard
(6)Bytes for the IEEE 802.3 standard
destination
source
address and
address.
These unique IEEE addresses are provided by AeroComm. See Section 4 for
EEPROM location
Note: The Length must include the IEEE 802.3 Header
Preliminary28
Command Set
6.2.3 Send data complete*
The Radio will issue this command upon completion of the data transmission process, as indicated
by a RF-layer Acknowledgment from the destination RF-device. An additional byte of data indicates a
success or a failure code. This command must be returned for every send data command unless the device
power fails.
The Radio will issue this command upon reception of data from the RF link. The information in
the data frame is the received data.
Data Frame:
83hLength LowLength HighDataChe cksum
Destination AddressSource AddressData
MS Byte…LS ByteMS Byte…LS Byte
6.2.5 In range*
The Client Radio will issue this command upon detecting that it is in range of a Server Radio. This
command is only valid after reset or after an out of range command has been issued. This command should
have some hysterisis so that the Host processor isn’t flooded with these commands in a fringe coverage
area. The state of the RF link should be
Parameters, Chapter 7.2,
IEEE802 Address.
Data Frame:
84H06H00HDataChecksum
to provide the needed hysterisis. This command includes the Server Radio
updated with the frequency specified in the Protocol EEPROM
Server IEEE Address
MS Byte…LS Byte
Note: This is only valid from the viewpoint of Client Radio.
Preliminary29
Command Set
6.2.6 Out of range*
The Radio will issue this command upon detecting that it is out of range of a Server Radio. This
command is only valid after reset or after an in range command has been issued to the Host processor. This
command should have some hysterisis so that the Host processor isn’t flooded with these commands in a
fringe coverage area. The state of the RF link should be
configuration command
Note: This is only valid from the viewpoint of a Client Radio.
to provide the needed hysterisis.
updated with the frequency specified in the
Preliminary30
Configuring the PKLR2400
7. Configuring the PKLR2400 Radio
The various configurable parameters are stored in the EEPROM in the Radio. These parameters
are read by the AeroComm firmware on power-up reset. These parameters can be configured
AeroComm
customer
must use the Write EEPROM Command and enable E2WP, pin 37, or switch 2 on the serial adapter board
included with the developer kit. The different configurable parameters and their respective EEPROM
locations are highlighted in this chapter.
as AeroComm defaults or customer defaults. These parameters can also be configured
using a PC and an AeroComm provided adapter. If the customer is writing to the EEPROM, they
7.1 System EEPROM Parameters
The system EEPROM parameters provide general system configuration information for the radio.
These parameters can be monitored and changed independent of the serial interface protocol.
parameters can only be changed when the API Serial Interface Mode 03, described in Section 7.1, is
active.
by
by the
These
EEPROM
Address
0H40 bytesProduct identifier string/Version Info
28H6 bytesIEEE assigned MAC Address
2EH1 byteChannel number; Range = 01- 75; Default = 00;
33H1 byteClient/Server mode
34H8 bytesSystem ID - used to demarcate RF networks (default=00 00 00 00 00
40H1 byteBaud High (BH) – Default is FF
41H1 byteBaud Low (BL) – Default is F7
SizeDescription
01 – Server Radio mode
02 – Client Radio mode (default)
00 00 01)
7.1.1 Product Identifier String/Version Information
EEPROM Address: 0H
Size: 40 bytes
Useful for OEM to read AeroComm version information. This information should not be
overwritten by the OEM. Original information is restored when a
RESET EEPROM
command is issued.
7.1.2 IEEE assigned MAC Address
EEPROM Address: 28H
Size: 6 bytes
This is the unique, 6-byte, IEEE 802.3 ethernet address assigned by AeroComm to each radio.
This provides 75 unique and non-interfering pseudorandom hopping sequences or channels. This
allows for up-to 75 independent, co-located data networks. Default shipped at 00. It is highly
recommended that this be changed to a channel number other than 00.
Note: Channel Number AND System ID between clients and server must be identical for radios to
communicate.
Note: Channel Number AND System ID between clients and server must be identical for radios to
communicate.
Preliminary32
Configuring the PKLR2400
7.1.6 Baud High (BH) and Baud Low (BL)
EEPROM Address: 40H and 41H respectively
Size: 1 bytes
Default: FF for BH and F1 for BL
Range: 00-FF for BH and BL
Baud High (BH) along with Baud Low (BL) is used to establish the data rate over the interface
between the OEM radio and host as follows:
Sample BHBL selections for common Baud Rates
(Using a 28.224 MHz Crystal)
Baud RateBHBL
300F484
2,400FE91
4,800FF48
9,600FFA4
19,200FFD2
28,800FFE1
57,600 (default)FFF1
115,200Not SupportedNot Supported
Custom baud rates can be obtai ned through the use of the following formula:
28.224 * 10
BAUD RATE = 32.0 * (65,536 – BH,BL)
Note: The calculated value must be within 3% of the actual value.
6
Preliminary33
Configuring the PKLR2400
7.2 Protocol EEPROM Parameters
The protocol EEPROM parameters are related to the Serial Mode interface selection. A summary
of the required EEPROM settings is illustrated in Section 7.3
Note: These parameters can only be changed when the API Serial Interface Mode 03 is active.
When in Transparent Serial Interface Modes, this can be accomplished by holding pin 27,
PKTMODE, low a nd resetting.
Note: When writing to EEPROM using the developer kit, remember to hold the EEPROM write
protect switch during the write command.
.
EEPROM
Address
2FH1 byteTransmit data link attempts; Range = 01 - FF;
31H1 byteReceive mode - determines what type of data frames are received by the
32H1 byteIn-Range, Out-of-Range Refresh. This byte specifies the number of
3EH1 byteEnd Character Definition. This byte specifies the character that will be
4EH1 b yteBroadcast Attempts; Range 01-FF; Default 04
SizeDescription
Default = 10H;
OEM Product, based on MAC address of received frame
01 - unicast/broadcast data (default)
02 - unicast only
03 - all (promiscuous mode)
250 ms ticks between range indications. This gives a range of .05
seconds to 12.5 seconds.
used to signify the end of a packet.
01 – Transparent, Fixed Length, with Timeout
02 – Transparent, End Character
03 – API
04 – Transparent, Fixed Length, No Timeout
00 – Addressed Mode: Destination address is the IEEE 6 bytes at 50H.
This mode utilized RF-Layer acknowledges to guarantee delivery of the
packet.
01 – Broadcast Mode: No RF-Layer acknowledge, must set Attempts
(2FH) to 01.
This parameter specifies the maximum number of attempts over the RF interface. Serial Interface
mode 03 will respond with a Send Data Failure when maximum Data Link attempts is achieved. All other
modes will not receive an acknowledge.
Note: Transmit Data Link Attempts must be set to 01 when operating in the Broadcast Mode of the
Address Transparent Control.
This parameter applies only to API Serial Interface Mode 03. The default, 01, specifies
Unicast/Broadcast. Unicast will receive all packets that match the receiving unit IEEE assigned address.
Broadcast is achieved by placing FF in all six bytes of the IEEE assigned destination address sent from
sender. In Broadcast mode, the receiver will accept all data with a destination address that has FF in all six
bytes.
It is important to note that there is no RF acknowledge on Broadcast packets
accept Unicast and Broadcast data packets and discard all others. In Unicast only mode, 02, The receiving
radio will receive only Unicast packets and discard all others. In Promiscuous mode, 03, the receiving radio
will accept all packets with the same System ID.
Note: The Receive Mode must be set to 03 in all Transparent Serial Interface Modes including 01, 02
and 04 at EEPROM location 4AH.
This parameter is used only when the radio is operating in API Serial Interface Mode 03. The InRange, Out-of-Range Refresh parameter allows the user to select the interval between which the client radio
searches for Server beacon that includes the Server IEEE source address. This parameter is very useful
when operating in a fringe condition to minimize the In-Range and Out-of-Range commands that may flood
the host. AeroCo mm has established a defa ult value of 5 seco nds through extensive testing.
This parameter is used only when the radio is operated in Serial Interface Mode 02 specified by
EEPROM address 4AH. Otherwise, this parameter is ignored by the system. The parameter specified by
the user will indicate the last character in a data packet. When this end character is seen by the radio, the
packet will be transmitted.
The packet length including the end character can not exceed 2Kbytes.
7.2.5 Fixed Packet Length High Byte/Low Byte
EEPROM Address: 43H/44H
Size: 1 byte each
Default: 01/00
Range: 00/01 to 07/FFH
This parameter is active only when the radio is in Serial Interface Modes 01 or 04 specified by
EEPROM address 4AH. This parameter is ignored in all other modes.
There are four Serial Interface Modes for the OEM radio including one packet mode and three
transparent modes. All modes are differentiated by the definition of when data will be transmitted by the
radio.
Mode 01 specifies Transparent mode with fixed length packets and active timeout. Packets will be
transmitted over the RF interface when one of the following conditions occurs:
•The number of data bytes received over the interface is equal to the buffer specified by
the user in EEPROM address locations 43H and 44H.
•A byte gap larger the timeout specified by the user in EEPROM location 4DH occurs.
Mode 02 specifies Transparent mode with End Character. Packets will be transmitted over the RF
interface when the user-defined End Character is received by the radio over the interface. The End
Character is defined by the user at EEPROM location 3EH.
Mode 03 specifies API Mode. In this mode, the OEM has control of the radio command set
detailed in Section 6.2. Packets are buffered and transmitted at the direction of the OEM.
Preliminary36
Configuring the PKLR2400
Mode 04 specifies Transparent mode with fixed length packets and no timeout. Packets will be
transmitted over the RF interface when the number of data bytes received over the interface is equal to the
buffer specified by the user in EEPROM address locations 43H and 44H.
Note: EEPROM parameters can not be programmed once the radios are programmed and reset in
any of the Transparent modes 01, 02 or 04. The radio must be programmed to API mode 03 to access
EEPROM parameters. This can only be accomplished by holding pin 27 low during and after reset.
This parameter sets the destination address for
API Serial Interface Mode 03 utilizes the Receive Mode at EEPROM address 31H to specify address
modes. With Destination Address Control set at the default, 00, the radio will determine if the six byte
IEEE address at 50H matches. If the destination address matches, the data packet is forwarded to the OEM
host. Otherwise the data is discarded. This addressed mode guarantees delivery of the data packet over the
radio link by using aknowledgements.
With Destination Address Control set to Broadcast Mode, 01, clients will receive all data packets.
There are no acknowledgements and no data packet retries in this mode.
Client radios can operate in Destination Address Control Mode 00, providing more reliable
delivery of data to the Server radio. At the same time, the Server radio can operate in Destination
Control Mode 01, acting as a broadcasting server without guaranteed delivery. This provides a
unique method of implementing a data network of many-to-one or one-to-many.
The Timeout parameter applies only to the Transparent Serial Interface Mode 01 with fixed length
packets and timeout. This parameter specifies the amount of time between bytes that the radio will wait
before transmitting the data packet.
The Broadcast Attempt parameter applies only to the Broadcast modes for all four serial packet
modes and specifies the number of times that the RF will broadcast every packet. The receiving radio will
discard duplicate packets.
A. Mode 01 – Transparent, Fixed Length Packet, Timeout,
B. Mode 01 – Transparent, Fixed Length Packet, Timeout,
C. Mode 02 – Transparent, End Character,
D. Mode 02 – Transparent, End Character,
E. Mode 03 – API,
F. Mode 03 – API,
G. Mode 03 – Packet,
H. Mode 04 – Transparent, Fixed Length, No Timeout,
I. Mode 04 – Transparent, Fixed Length, No Timeout,
Preliminary38
Unicast/Broadcast
Unicast Only
Promiscuous
Addressed
Broadcast
Addressed
Broadcast
Addressed
Broadcast
Initializing the PKLR2400 Radio
8. Initializing the PKLR2400 Radio
Following is an example of the initialization sequence for both the Client and Server Radios
following AeroComm or customer configuration of the EEPRO M configuratio n parameters. This occurs
only in the API Serial Interface Mode 03.
Apply Power
Wait for CTS logic low (if 5V)
Host issues RF enable command
Host awaits Acknowledge
Client Radio
Await Server Radio Beacon with
IEEE Server Radio address
Client Radio issues In range
command to Host with Server
Radio address
Client Radio can now transmit or
receive data
Host reads EEPROM for IEEE
source address
Server Radio
Issue Server Radio beacon every
5ms – 500ms with IEEE Server
Radio address
Server Radio can now transmit or
receive data
Preliminary39
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.