Coronis WaveCard 25mW User manual

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
WaveCard user handbook page 1 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
REVISIONS HISTORY
Rev. # Description Auteur Date Commentaires
1 Original document RCS 19/01/05 Version 1
2 Addon Text FCC RCS 17/02/05 Version 2
➢IRMWARE VERSIONS O SUPPORTED WAVECARD AND WAVEPORT
WaveCard 25mW : Compatible with the version v2.01, and later
WaveCard 500mW : Compatible with the version v4.01, and later
This device complies with part 15 of the FCC rules. Operation is subject to the
following two conditions : this device may not cause harmful interference and
this device must accept any interference received including interference that
may cause undesired operation.
Caution : any changes or modifications not expressly approved by Coronis-
Systems could void the user's authority to operate the equipment.
WaveCard user handbook page 2 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
TABLE O CONTENTS
1. INTRODUCTION.............................................................................................................................................5
2. RS232 SERIAL PROTOCOL PRESENTATION.............................................................................................6
2.1- Exchanges principle.............................................................................................................................6
2.1.1 - Low eve acknow edge..................................................................................................................6
2.1.2 - Request/ Response princip e.........................................................................................................7
2.2- Exchanged frames format....................................................................................................................8
2.2.1 - Wake Up and synchronization mechanism....................................................................................8
2.2.2 - Frame description..........................................................................................................................8
2.3- Commands description......................................................................................................................10
2.3.1 - Contro type commands...............................................................................................................10
2.3.2 - App icative type commands.........................................................................................................10
2.3.3 - Service type commands...............................................................................................................12
3. SETTING THE INTERNAL PARAMETERS O THE WAVECARD..............................................................13
3.1- Configuration of the functional parameters....................................................................................13
3.1.1 - Format of the interna parameters access...................................................................................14
3.1.2 - Wake Up and synchronization mechanism.................................................................................17
a) Principle when transmitting, or receiving a frame......................................................................................... 17
b) Example describing a point-to-point exchange of the type Re uest / Response.........................................19
3.2- Configuration of the control parameters.........................................................................................20
3.2.1 - se ection of the radio operating channe when FHSS is dese ected............................................20
a) reading commands format of the channel used............................................................................................ 20
b) Writing commands format of the channel to use........................................................................................... 21
3.2.2 - Se ection of the RF medium physica mode...............................................................................22
a) reading commands format of the physical layer mode..................................................................................22
b) selection commands format of the physical layer mode to use.................................................................... 23
c) Automatic selection of Radio physical mode to use...................................................................................... 23
3.2.3 - Se ection of the radio board emission power...............................................................................24
a) selection commands format of the emission power...................................................................................... 24
b) reading commands format of the emission power........................................................................................ 25
3.2.4 - Activation of the Wavenis RF Asic RSSI thresho d autocorrection..............................................26
a) Modification commands format of the RSSI threshold autocorrection state ................................................26
b) Reading commands format of the RSSI threshold autocorrection state ...................................................... 27
3.2.5 - Se ection de a vitesse de transmission série..............................................................................28
a) Selection commands format of the baudrate................................................................................................ 28
3.2.6 - Reading the firmware version of the WaveCard..........................................................................29
a) Commands format......................................................................................................................................... 29
3.2.7 - Reading the RSSI eve (Received Signa Strengh Indicator)....................................................30
a) Commands.................................................................................................................................................... 30
b) Format of the commands...............................................................................................................................31
3.2.8 - TEST Mode..................................................................................................................................32
a) Command...................................................................................................................................................... 32
b) Format of the command................................................................................................................................ 32
4. SERVICE COMMANDS................................................................................................................................33
4.1- Description of the commands and their formats...........................................................................33
WaveCard user handbook page 3 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
4.2- Request types.....................................................................................................................................34
4.3- Presence detection principle between WAVECARD.......................................................................35
5. COMMUNICATION MODES.........................................................................................................................36
5.1- 'Frame Exchange’ Mode.....................................................................................................................36
5.1.1 - Configuration of the parameters re ating to the 'Frame Exchange' mode...................................36
5.1.2 - Description of the commands, and their formats.........................................................................37
5.1.3 - Use of the Re aying mode............................................................................................................38
a) On frame transmission.................................................................................................................................. 38
b) On frame reception........................................................................................................................................ 38
5.1.4 - Time-out management.................................................................................................................41
5.2- 'Message’ Mode...................................................................................................................................43
5.2.1 - Configuration of the parameters re ating to the 'Message' mode................................................43
5.2.2 - Description of the commands, and their formats.........................................................................43
5.2.3 - Use of the Re aying mode............................................................................................................45
a) On frame transmission.................................................................................................................................. 45
b) On frame reception........................................................................................................................................ 45
c) Diagram of the relaying mode....................................................................................................................... 46
5.3- ’Polling’ Mode.....................................................................................................................................49
5.3.1 - Configuration of the parameters re ating to the 'Po ing' mode....................................................49
5.3.2 - Description of the commands, and their formats.........................................................................50
5.3.3 - Difference between se ective, and not-se ective Po ing mode....................................................51
5.3.4 - Diagram of an exchange in po ing mode....................................................................................54
5.4- ’Broadcast’ mode...............................................................................................................................56
5.4.1 - Configuration of the parameters re ating to the 'Broadcast' mode..............................................56
5.4.2 - 'BroadCast' mode without waiting for a response........................................................................56
a) Description of the commands........................................................................................................................ 56
b) Example of operations during a broadcast exchange, without waiting for responses..................................57
5.4.3 - 'BroadCast' mode with waiting for responses..............................................................................57
a) Description of the commands........................................................................................................................ 57
b) Example of operations during a broadcast exchange, with waiting for responses.......................................58
5.4.4 - Format of the commands – from the request transmitter side....................................................59
5.4.5 - Format of the commands – from the request receiver side.........................................................60
5.4.6 - Use of the se ective, or not-se ective broadcast mode................................................................60
5.5- ’Multi frames' Mode.............................................................................................................................61
5.5.1 - Princip e.......................................................................................................................................61
5.5.2 - Format of the received frames.....................................................................................................61
APPENDIX 1 : Mechanical description of the WAVECARD..........................................................................62
APPENDIX 2 : Electric interface of the WAVECARD.....................................................................................64
APPENDIX 3 : List of the functional parameters..........................................................................................65
APPENDIX 4 : List of the commands of parameters setting.......................................................................66
APPENDICE 5 : List of the commands of data transmission......................................................................67
WaveCard user handbook page 4 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
1. INTRODUCTION
The WAVECARD equipment acts ike a RS232 Radio frequency gateway.
This device is driven through a USART ink (RS232 or TTL) by a c ient app ication (ca ed HOST in the
continuation of this document) embedded on a microcontro er or on a PC equipment.
The main features of the WAVECARD are :
to send a frame on the RF medium depending on Host equipment
to inform Host equipment about received frame
Exchanges between two WAVECARD require that each one is
connected to a Host device.
However, Wavecard can process some specific frames without Host
connected. These exchanges are ca ed Service Exchanges and are
main y used for insta ation and maintenance procedures.(cf. §4).
The purpose of this document is to present:
the ow eve of the exchange protoco to drive the Wavecard radio board through an
asynchronous seria RS232 interface (±12V) or comp iant with TTL eve (0-3V) ;
the e ectrica interface of the Wavecard radio board ;
the mechanica interface of the Wavecard radio board ;
This document serves as a specification to drive a DLL driving ibrary on PC environment in the case the
Wavecard radio board is used as a RF Modem either to be integrated in a existing e ectronic device or to be
driven by a specific CPU mother board.
This document is a so usefu for the Waveport equipment. Waveport is a PC connected oriented RF modem
based on the Wavecard.
In this document the Host term is used to speak about the equipment or sub-equipment that is driving the
Wavecard radio board. The radio board term indicates the Wavecard equipment .
WaveCard user handbook page 5 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
2. RS232 SERIAL PROTOCOL PRESENTATION
This protoco is dedicated to an asynchronous RS232 or TTL ink between the host and the radio board.
➢Transmission format :
8 bits data,
1 stop bit,
no parity
➢Transmission speed : 9600 baud (contact us for other speed : mar[email protected]m)
2.1- Exchanges principle
The host or the radio board can take the initiative of the exchange. Neverthe ess in the high majority of the
cases, the host wi take the initiative.
Fig 1 – synoptic of the exchanges between a WavePort modem, and its host
2.1.1 - Low level acknowledge
In a the cases, the seria frames exchanged between the host and the radio board are managed by an
acknow edge mechanism.
A minimum atency time of 1 ms must be respected between the frame reception and the corresponding
acknow edge emission in order to respect the radio board processing time after a frame reception.
If the Acknow edge frame is not received by the initiator, it can decide to re-send severa times the frame
(retries mechanism). The RF defau t setting is :
Time-out = 500 ms
repetition number = 3
WaveCard user handbook page 6 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
2.1.2 - Request/ Response principle
Some exchanges need a Request/response mechanism.
In this case , an high eve acknow edge (RES prefix command) is initiated by the RF board fo owing the
request frame (REQ prefix command) sent by the host.
The re uest frame are identified by REQ_XXX_XXX
example : REQ_SEND_FRAME
The high level acknowledge frame are identified by RES_XXX_XXX
example : RES_SEND_FRAME
In this examp e, from the request transmitter side, the frame RECEIVED_FRAME is the response associated
to the request REQ_SEND_FRAME.
The high eve acknow edgement of the request is identified by the RES_SEND_FRAME frame.
WaveCard user handbook page 7 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
2.2- Exchanged frames format
2.2.1 - Wake Up and synchronization mechanism
In the purpose to optimize power consumption, the Wavecard is in a STANDBY mode and is wakening up
either :
periodica y to po a radio activity ;
on a seria frame reception coming from the host equipment.
A synchronization character is needed before the data in the seria frame to give time to the radio board to
wake up. This character is in hexadecima notation : 0xFF.
To be homogeneous, the radio board precedes as we its frames emissions with this synchronization
character.
2.2.2 - Frame description
The frames format is standardized as fo owing :
SYNC STX LENGTH CMD DATA CRC ETX
1 byte 1 byte 1 byte 1 byte De 0 à 250 bytes 2 bytes 1 byte
Synchro.
character
Start of
transmission
character
Frame
ength Command Data
Contro
Redundancy
Check
LSB First
End of
transmission
character
0x 0x02 0x03
LENGTH
Note : - The frame minimum size is 6 bytes.
- The frame maximum size is 256 bytes.
The frame length (byte LENGTH) is computed from its own position until the included CRC. Bytes
SYNC STX and ETX are not included in the length.
To insure transmitted information integrity between the host and the radio board, a CRC code on 16 bits is
computed on overa frame data excepted STX and ETX characters ( the byte LENGTH is inserted in the
CRC).
The CRC code is computed by a division of the frame binary sequence by the fo owing po ynomia :
X16 + X12 + X5 + 1
A coding examp e is indicated on the next page.
WaveCard user handbook page 8 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
CRC principle coding in C language :
#inc ude <iostream.h>
#inc ude <stdio.h>
#inc ude <string.h>
void main ( )
{
int Po y = 0x8408;
int g = 9;
unsigned int Frame [] = { 0x0B, 0x20, 0x43, 0x06, 0x01, 0x00, 0x00, 0x02, 0X01};
unsigned int Crc;
int j, i_bits, carry;
Crc = 0;
for ( j=0 ; j < g ; j++ )
{
Crc = Crc ^ Frame[j] ;
for ( i_bits=0 ; i_bits < 8 ; i_bits++ )
{
carry = Crc & 1 ;
Crc = Crc / 2 ;
if ( carry )
{
Crc = Crc ^ Po y;
}
}
}
printf ( “CRC = %x “, Crc);
}
The computed CRC is the following : 41D2 hexadecimal
Then LSB byte and MSB byte must be inverted before storage in the frame.
This example allows to compute a CRC on a fix frame length equal to 9.
WaveCard user handbook page 9 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
2.3- Commands description
A the frames circu ating on the seria bus are formatted as described in chapter 2.2.2. The distinction
between the various frames is carried out via the 'CMD' fie ds representing the command (or the action) to
carry out.
The avai ab e commands types can be c assified in three parts :
Contro type commands
App icative commands
Service type commands
2.3.1 - Control type commands
This commands are used for the ow eve acknow edgement of the seria frames.
CMD NAME DESCRIPTION DATA FIELD FORMAT
0x06 ACK
Acknowledge Frame :
Sent by the receiver after reception of a Re uest /Response
frame type supported and understood.
No data field.
0x15 NAK
Non Acknowledge Frame :
Sent by the receiver after reception of a Re uest /Response
frame not understood.
No data field.
0x00 ERROR
Error frame :
Sent by the receiver after reception of a Re uest/response
frame understood but not supported.
Byte 1 :
0x01 : unknown command.
2.3.2 - Applicative type commands
The app icative type commands use the Request/response mechanism.
We distinguish two parts in the app icative type commands : the commands re ating to the parameter setting
and the configuration of the board ; and in addition the commands re ating to radio exchanges.
➢Commands relating to the parameter setting
Read, or update the interna parameters,
Read, or se ect the radio operating channe when FHSS is dese ected,
Read, or se ect the RF medium physica mode,
Read, or se ect the radio board emission power,
Activation of the Wavenis RF Asic RSSI thresho d autocorrection,
Modification of the seria ink baudrate,
Reading the RSSI eve of a distant equipment,
Reading the RSSI eve of the wavecard, fo owing an exchange with a distant equipment,
Reading the firmware version of the WaveCard,
Set the WaveCard into a test mode.
WaveCard user handbook page 10 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
➢Commands relating to radio exchanges
The radio exchanges are composed of severa modes of transmission/reception. With in certain cases, the
possibi ity of receiving severa consecutive radio frames (mu ti frames mode, accessib e in reception on y).
The fo owing modes a ow point-to-point exchanges :
’ rame Exchange’ mode : This mode a ows to emit a request, with waiting of a radio response
from the distant equipment.
Fo owing the radio frame sending, the Wavecard radio board stay in radio reception during a time
(fixed by defau t at 2s, cf. RADIO_USER_TIMEOUT) in order to receive the response from the
addressed equipment. During this time the seria RS232 ink is not managed. This command is
particu ar y intended to read CORONIS SYSTEMS radio modu es used to co ect remote information
(temperature, humidity, meters index, ...).
‘Message’ mode : a ows to emit a request, without waiting of a radio response from the distant
equipment.
After radio frame emission, the Wavecard radio board is istening again the seria RS232 ink. This
command is suited to a simp e data transfer between severa Wavecard equipments.
Moreover exchanges of the point-to-point types have an additiona mode which a ow to reach a modu e out
of radio range of the transmitter, by re aying the frames via other equipments.
'Relaying' mode : this functiona ity a ow to use a radio equipment to repeat a frame which is not
initia y intended to him.
This functiona ity is used when the transmitter equipment, and the recipient of the request are out of
radio range. The maximum number of repeaters is imited to 3.
The remaining modes a ow exchanges with severa distant equipments, in a se ective way or not.
‘Polling’ mode : a ows to address a request to a ist of known distant equipment. The response
is sent to the host, transmitter of the request, when a the distant equipment responded, or on time-
out.
In this case, the ist of the distant equipments is configured via a command of parameter setting (see
chapter 3)
’Broadcast’ mode : a ows to address a request to a the distant equipment within radio range
of the transmitter, or on y to a group of equipment in radio range of the transmitter.
Particular Case: multi-frames reception
Mu ti frame mode a ows mu ti frame exchange between the Wavecard/Waveport (considered ike the
master of the exchange) and one of the te emetry equipments of the Coronis Systems product fami y
( WaveTherm, WaveF ow, WaveSens, ...).
Current version of Wavecard does not a ow mu ti frame mode between two Wavecard/Waveport
equipments.
WaveCard user handbook page 11 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
2.3.3 - Service type commands
Services commands are used to configure the Wavecard or to read radio parameters independent y of the
connected host equipment.
When the wavecard recognizes Service command, no data are sent to the connected host.
These commands are main y used to:
Process detection of a distant RF equipment
Process a ink budget with a distant equipment (RSSI eve detection)
Process the setting of parameters by RF way
the detai s of the frame format, and its usage is described in chapter 4.
WaveCard user handbook page 12 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
3. SETTING THE INTERNAL PARAMETERS O THE WAVECARD
The interna parameters of WaveCard are dec ined in two categories :
parameters of contro (emission power eve , channe se ection, etc...) carried out by specific
frame of type Request/Response. this parameters a ows to modify the mode of communication
(either seria , and RF).
Functiona parameters (WakeUp period, group number, etc...) carried out by the same frame of
writing of interna parameters. this parameters a ows to modify the behavior of WaveCard,
according to the type of radio exchange used.
Attention, the setting parameter commands apply only to a local WaveCard, not to a distant one.
3.1- Configuration of the functional parameters
The functiona parameters are direct y re ated to the defau t operation of WaveCard, and to the types of radio
exchanges used. I.e. according to the type of radio exchange which wi be used, the functiona parameters
wi have to be initia ized.
Defau t va ues are set at the first initia ization of the product.
Parameter
number
Description Value Size
(in
byte)
0x00 AWAK NING_P RIOD : polling period of RF medium
radio, in multiples of 100ms
Period in multiples of 100ms
(by default, 0x0A for one second)
0 = quasi-permanent reception (every 20ms)
1
0x01 WAK UP_TYP : Wake Up type used during a frame
emission
0 : long Wake Up (default setting)
1 : short Wake Up = 50 ms 1
0x02
WAK UP_L NGTH : duration of the Wake up when
long wake up is set up.
This value must be higher than the polling period of RF
medium radio
Value in multiples of 1ms, defined LSB first
Default value : 1100 ms
min value = 20 ms (0x1400)
max value = 10 sec (0x1027)
2
0x03 WAV CARD_POLLING_GROUP : Byte containing the
Polling Group of the Wavecard
Byte 1 : Polling_Group
by default, Polling_Group = 0x00 1
0x04 RADIO_ACKNOWL DG : indicates if the radio frames
must be acknowledged by the receiver
0 : no acknowledge (default value)
1 : acknowledge used 1
0x05 RADIO_ADDR SS : radio board address This Value is issue from the manufacturing
In Reading only 6
0x06 R LAY_ROUT _STATUS : Parameter relative to Relay
route transmission in each relayed frame received
0x00 : Relay route transmisson deactivated
0x01 : Relay route transmission activated
by default, Relay route transmisson deactivated
1
0x07
R LAY_ROUT : Table containing the radio addresses
for successive repeaters to use to reach the final
equipment.
BYTE 1 : number of repeaters in the route
Maximum repeater number = 3
Si BYTE 1 != 0
BYTES 2 à 7 : First repeater radio address
…, and so on
1 à 19
WaveCard user handbook page 13 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
0x08 POLLING_ROUT : Table containing the list of modules
radio address to be addressed
BYTE 2 : number of equipments to interrogate
IF BYTE 2 != 0
BYTES 3 to 8 : radio address of the first module ,
and so on
1 à 241
0x09 GROUP_NUMB R : Byte containing the number of the
group of radio equipment to address in radio polling mode
Group number
by default, GROUP_NUMBER = 0x00 1
0x0A POLLING_TIM : delay between two consecutive
emission in polling mode
Value in multiples of 100ms
By default, POLLING_TIME = 0x0A 1
0x0C RADIO_US R_TIM OUT : time-out used for the reception
of a response frame
Value in multiples of 100ms
default value = 0x14 (2 seconds) 1
0x0E XCHANG _STATUS : parameter relative to the error or
status frame management activation
0 : status and error frame deactivated,
1 : error frame activated,
2 : status frame activated,
3 : both status and error frames activated,
by default, RECEPT_ERROR_STATUS = 0x00
1
0x10
SWITCH_MOD _STATUS : automatic selection of Radio
physical mode used to address an equipment depending
on radio address
0 : automatic selection deactivated
1 : automatic selection activated
Default value, SWITCH_MODE_STATUS = 0x00
1
0x16
WAV CARD_MULTICAST_GROUP : Byte containing the
Multicast Group of the Wavecard (available from V2 00
version )
By default, no group selected = 0xFF 1
0x17
BCST_RECEPTION_TIMEOUT : timeout used for the
reception of CSMA frame consecutively to
REQ_SEND_BROADCAST Command emission (available
from firmware V2 01 version )
Valeur in multiples of100ms
Default = 0x3C (6 seconds) 1
3.1.1 - Format of the internal parameters access
The Wavecard equipment manage interna parameters main y re ative to RF features. RS232 commands
a ow to access these parameters in read or write mode. Defau t va ues are set at the first initia ization of the
product.
REQ_READ_RADIO_PARAM command is used to read parameters and REQ_WRITE_RADIO_PARAM is
used to write parameters. Each parameter must be accessed individually.
CMD NOM DESCRIPTION
0x40 REQ_WRITE_RADIO_PARAM Re uest to update the radio parameters
0x41 RES_WRITE_RADIO_PARAM Response from the radio board to the radio parameters
update
0x50 REQ_READ_RADIO_PARAM Re uest to read the radio parameters.
0x51 RES_READ_RADIO_PARAM Response from the radio board to a parameters reading.
Remark : In the command byte coding the Response frame type are taking the Request command
byte value with the LSB bit set to 1.
WaveCard user handbook page 14 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
Data fie d formats to read or to update the radio parameters is the fo owing :
Request to read the radio parameters
R Q_R AD_RADIO_PARAM
H AD R CMD DATA CRC TX
3 bytes 1 byte 1 byte 2 bytes 1 byte
0xFF ; 0x02 ; 0x05 0x50 Number of the parameter to read 0x03
Response from the radio board to a parameters reading
R S_R AD_RADIO_PARAM
H AD R CMD DATA CRC TX
3 bytes 1 byte 1 byte 1 byte variable 2 bytes 1 byte
0xFF ; 0x02 ; 0xXX 0x51 Status = 0x00 read ok
Status = 0x01 read error
Parameter number value
-0x03
Request to update the radio parameters
R Q_WRIT _RADIO_PARAM
H AD R CMD DATA CRC TX
3 bytes 1 byte 1 byte variable 2 bytes 1 byte
0xFF ; 0x02 ; 0xXX 0x40 Number of the parameter to update Parameter data 0x03
Response from the radio board to the radio parameters update
R S_WRIT _RADIO_PARAM
H AD R CMD DATA CRC TX
3 bytes 1 byte 1 byte 2 bytes 1 byte
0xFF ; 0x02 ; 0x05 0x41
STATUS
= 0x00 update OK
= 0x01 update error
0x03
Timeout management : The WaveCard can be considered in fault, beyond the value of the following
latencies:
REQ_WRITE_RADIO_PARAM 2 seconds.
REQ_READ_RADIO_PARAM 2 seconds.
WaveCard user handbook page 15 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
EXAMPLE : configuration of the repeaters table and activation of error frames.
Between WaveCard (exchange instigator), and the recipient equipment, we have a repeater equipment
(radio address : 0X AA AA AA AA AA AA). In addition, we must authorize the error frame, in order to
determine which distant equipment caused the error.
•Writing new parameters
repeaters list configuration (Request/Response mechanism)
Re uest from the host to the WaveCard (REQ_WRITE_RADIO_PARAM)
H AD R
SYNC STX L NGTH CMD
DATA
Parameter
number Parameter data CRC TX
0xFF 0x02 0x0C 0x40 0x07 0x01 ; 0xAAAAAAAAAAAA 0xXXXX 0x03
Response from the WaveCard to the host (RES_WRITE_RADIO_PARAM)
H AD R
SYNC STX L NGTH CMD DATA Status of the update
CRC TX
0xFF 0x02 0x05 0x41 0x00 0xXXXX 0x03
Activation of the error frames (Request/Response mechanism)
Re uest from the host to the WaveCard (REQ_WRITE_RADIO_PARAM)
H AD R
SYNC STX L NGTH CMD
DATA
Parameter
number Parameter data CRC TX
0xFF 0x02 0x06 0x40 0x0 0x01 0xXXXX 0x03
Response from the WaveCard to the host (RES_WRITE_RADIO_PARAM)
H AD R
SYNC STX L NGTH CMD DATA Status of the update
CRC TX
0xFF 0x02 0x05 0x41 0x00 0xXXXX 0x03
WaveCard user handbook page 16 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
3.1.2 - Wake Up and synchronization mechanism
In the purpose to optimize power consumption, the Wavecard is in a STANDBY mode and is wakening up
periodica y to po a radio activity. The wakeup period is given by the va ue of the AWAKENING_PERIOD
parameter, expressed in mu tip es of 100ms (1 second by defau t).
a) Principle when transmitting, or receiving a frame
When transmitting a frame to a distant equipment, the transmitter begins an awakening preamb e ca ed
'WakeUp' being used to awake the receiving equipments which wi position then in radio reception. This
preamb e resu ts in the sending on the radio medium, of a binary succession of symbo .
This awakening preamb e (WakeUp) can be of two types,
Long WakeUp : used when transmitting a request towards distant equipment. Its duration can be
parameterized by the user (1100ms by defau t); and is genera y equa to the WakeUp period of
the equipment to address, p us 100ms, in order to avoid transmitting between two periods of
reception.
Short WakeUp : used on y when responding to a point-to-point request. Its duration is equa to
50ms, and cannot be configured.
NUM DESCRIPTION VALUE SIZE (in
bytes)
0x00 AWAK NING_P RIOD : polling period of RF medium radio, in
multiples of 100ms
Period in multiples of 100ms
(by default, 0x0A for one second)
0 = quasi-permanent reception (every 20ms)
1
0x01 WAK UP_TYP : Wake Up type used during a frame emission 0 : long Wake Up (default setting)
1 : short Wake Up = 50 ms 1
0x02
WAK UP_L NGTH : duration of the Wake up when long wake
up is set up.
This value must be higher than the polling period of RF medium
radio
Value in multiples of 1ms, defined LSB first
Default value : 1100 ms
min value = 20 ms (0x1400)
max value = 10 sec (0x1027)
2
The receiver of the exchange, when it detect WakeUp preamb e on the radio medium, carries out the
fo owing operations:
It starts a timeout of waiting for the synchronization word (sync), which the duration is s ight y
higher than its WakeUp period. This duration cannot be configured.
It begins a va idation phase of the WakeUp preamb e (detection of WakeUp). This phase
corresponds to the detection of severa successive symbo s composing the preamb e. If the
detection fai s, the equipment is repositioned in stand-by mode. The time of detection depends on
the speed transmission used.
The periodic wakeup having to occur when waiting of synchronization, are memorized (in order to
preserve the periodicity), but not carried out.
At the end of the phase of WakeUp, the transmitter equipment send a sequence of synchronization, fo owed
by data to be transmitted.
WaveCard user handbook page 17 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
➢Typical case (Long WakeUp = receiver WakeUp period + 100ms)
➢Case of too short WakeUp (lower than the receiver WakeUp period)
➢Case of too long WakeUp (much higher than the receiver WakeUp period)
WaveCard user handbook page 18 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
b) Example describing a point-to-point exchange of the type Re uest / Response.
When using a point-to-point exchange of the type request/ Response, the transmission of the request is
made in the same way that previous y. But the transmitter, after the sending of the data, awaits for a
response, during a time which can be configured by the RADIO_USER_TIMEOUT parameter (0x0C).
The receiver, after treatment of the request, wi return its response by using a specific WakeUp preamb e,
ca ed short WakeUp (Long WakeUp being use ess since the transmitter is a ready in phase of reception).
➢Exchange without radio acknowledge
➢Exchange with radio acknowledge
Configuration example of the parameters of wakeup management.
during an exchange between two WaveCard, where between two idle periods the transmitter must uickly
transmit data to the receiver.
1- Send a command of parameter modification to the receiver of the exchange, to modify its
WakeUp period to 0 ( uasi-permanent reception) ;
2- Configure WakeUp_Length parameter of the transmitter with 40ms ;
3- transmit the data to the receiver ;
4- To send a command of parameter modification to the receiver of the exchange, to modify its
wakeup period to 10s (default value).
5- Configure WakeUp_Length parameter of the transmitter with 1100ms (default value).
WaveCard user handbook page 19 of 67

Document : CS-SUP-MUTI-WPORTAPP-E02.sxw
3.2- Configuration of the control parameters
The parameters of contro a ow on the one hand, to modify the mode of radio communication, and seria
communication; and furthermore, fetch information on the oca modu e, and the qua ity of the communication
with a distant modu e.
3.2.1 - selection of the radio operating channel when FHSS is deselected
It is possib e to modify the transmission channe Reception via requests of reading, and writing. The
commands are as fo ows,
CMD NOM DESCRIPTION
0x60 REQ_SELECT_CHANNEL Request to se ect the radio operating channe when FHSS is
dese ected
0x61 RES_SELECT_CHANNEL Response to the channe se ection request
0x62 REQ_READ_CHANNEL Request to read the radio operating channe when FHSS is
dese ected
0x63 RES_READ_CHANNEL Response to the read channe request
Remark : These commands are used only when the mode of radio communication is mono-fre uency with
selection of channel.
a) reading commands format of the channel used
Request, from the host to the WaveCard
R Q_R AD_CHANN L
H AD R CMD CRC TX
3 bytes 1 byte 2 bytes 1 byte
0xFF ; 0x02 ; 0x04 0x62 0x03
Response, from the WaveCard to the host
R S_R AD_CHANN L
H AD R CMD DATA CRC TX
3 bytes 1 byte variable 2 bytes 1 byte
0xFF ; 0x02 ; 0xXX 0x63
Status = 0x00
reading ok
Channel number
1 byte
Status = 0x01
reading error -
0x03
WaveCard user handbook page 20 of 67