| Reader Communication Protocol Developer's Guide |
|
Set Antenna Ports
This command uses the concept of a logical antenna number. The logical antenna number of a reader is different from the physical antenna port number of a reader which is marked with number on the reader. The antenna is classified into antennas used for reception and antennas used for transmission. The logical antenna number of antennas used for reception is called RX Logical Antenna Number. The logical antenna number of antennas used for transmission is called TX Logical Antenna Number.
At present, all the reader products of our company use transceiver integrated antenna mode, that is, when a physical antenna port of the reader works, it uses both this port to send and receive signals.
There are multiple formats for Set Antenna Ports command. We will introduce the command format for each case separately.
Physical/logical Antenna Number Mapping Relationship
Now The TX Logical Antenna Number and RX Logical Antenna Number of all the reader products except for SLR11xx serial of readers equal the physical antenna port number. The relationship of physical/logical antenna port number of SLR11xx serial of readers is as follows.
| Physical Antenna Port Number | TX Logical Antenna Number | RX Logical Antenna Number |
|---|---|---|
| 1 | 1 | 1 |
| 2 | 3 | 3 |
| 3 | 2 | 2 |
| 4 | 4 | 4 |
Command Attribute
| Command Code | Bootloader Command | App Firmware Command |
|---|---|---|
| 0x91 | No | Yes |
Host to Reader
Set Antenna for Tag Access Operations
This kind of format is used to set the antenna for tag access operations, every kind of tag access operation only can specify one antenna for operation.
Format of Data Field
| Field | Byte Length | Description |
|---|---|---|
| Option | 1 byte | Always be 0x00 |
| TX Logical Antenna Number | 1 byte | |
| RX Logical Antenna Number | 1 byte |
Set Antennas for Tag Inventory Operation
Tag inventory operation can use one or multi-antennas.
Format of Data Field
| Field | Byte Length | Description |
|---|---|---|
| Option | 1 byte | Always be 0x02 |
| TX,RX Logical Antenna Number pairs | M*2 bytes | M 2-byte TX,RX Logical Antenna Number pairs, after multiple Logical Antennas are set, the order of switching antennas of tag inventory is the same as the order of TX,RX Logical Antenna Number pairs in the command. |
Set the Power of Antennas
Set the transmission power of the antenna ports
Format of Data Field
| Field | Byte Length | Description |
|---|---|---|
| Option | 1 byte | Always be 0x03 |
| TX Logical Antenna Power Configuration | M*5 bytes | M TX Logical Antenna Power Configurations |
TX Logical Antenna Power Configuration
| Field | Byte Length | Description |
|---|---|---|
| TX Logical Antenna Number | 1 byte | |
| Read Power | 2 bytes | Transmission power of reading related operations, the unit is 0.01dbm, but now the real precision is 1dbm. |
| Write Power | 2 bytes | Transmission power of writing related operations, the unit is 0.01dbm, but now the real precision is 1dbm. |
Set the Power and Settling Time of antennas
Set the transmission power of the antenna ports
Format of Data Field
| Field | Byte Length | Description |
|---|---|---|
| Option | 1 byte | Always be 0x04 |
| TX Logical Antenna Power and Setting Time Configuration | M*7 bytes | M TX Logical Antenna Power and Setting Time Configurations |
TX Logical Antenna Power and Setting Time Configuration
| Field | Byte Length | Description |
|---|---|---|
| TX Logical Antenna Number | 1 byte | |
| Read Power | 2 bytes | Transmission power of reading related operations, the unit is 0.01dbm, but now the real precision is 1dbm. |
| Write Power | 2 bytes | Transmission power of writing related operations, the unit is 0.01dbm, but now the real precision is 1dbm. |
| Setting Time | 2 bytes | The settling time, in μs, to be used when this antenna is active. |
Example
Example 1
Set Antenna for Tag Access Operations(Option=0x00), set the physical antenna port 1 for Tag Access Operations.
Host to Reader
| FF | 03 | 91 | 00 | 01 | 01 | 62 87 |
|---|---|---|---|---|---|---|
| Header | Data Length | Command Code | Option | TX Logical Antenna Number | RX Logical Antenna Number | CRC |
Example 2
Set Antennas for Tag Inventory Operation(Option=0x02), set the physical antenna port 1 and 4 for Tag Access Operations.
Host to Reader
| FF | 05 | 91 | 02 | 01 | 01 | 04 | 04 | 2B C6 |
|---|---|---|---|---|---|---|---|---|
| Header | Data Length | Command Code | Option | TX Logical Antenna Number | RX Logical Antenna Number | TX Logical Antenna Number | RX Logical Antenna Number | CRC |
Example 3
Set the Power of Antennas(Option=0x03), set the power of physical antenna port 2 and 3.
Host to Reader
| FF | 0B | 91 | 03 | 02 | 03 E8 | 0B B8 | 03 | 03 E8 | 0B B8 | F2 F5 |
|---|---|---|---|---|---|---|---|---|---|---|
| Header | Data Length | Command Code | Option | TX Logical Antenna Number | Read Power | Write Power | TX Logical Antenna Number | Read Power | Write Power | CRC |
Example 4
Set the Power and Settling Time of antennas (Option=0x04), set the power and setting time of physical antenna port 1,2,3 and 4.
Host to Reader
| FF | 1D | 91 | 04 | 01 | 03 E8 | 0B B8 | 01 F4 | 03 | 03 E8 | 0B B8 |
|---|---|---|---|---|---|---|---|---|---|---|
| Header | Data Length | Command Code | Option | TX Logical Antenna Number | Read Power | Write Power | Setting Time | TX Logical Antenna Number | Read Power | Write Power |
| 01 F4 | 02 | 03 E8 | 0B B8 | 01 F4 | 04 | 03 E8 | 0B B8 | 01 F4 | 78 85 |
|---|---|---|---|---|---|---|---|---|---|
| Setting Time | TX Logical Antenna Number | Read Power | Write Power | Setting Time | TX Logical Antenna Number | Read Power | Write Power | Setting Time | CRC |
Remark
At present, the physical antenna port 1 is enabled by default when the reader is powered on. The default initial transmission power(read/write) of all antennas may not be the maximum power output value.
The values of Read Power and Write Power can be set differently. Each antenna can also have different read/ write power values. The location of the parameter groups of each logical antenna in the command does not need to be in a specific order.