| 读写器通信协议开发者指南 |  |
设置天线端口
该命令使用逻辑天线编号的概念。读写器的逻辑天线编号与读取器上标有数字的物理天线端口号不同。逻辑天线分为用于接收的天线和用于发射的天线。用于接收的天线的逻辑天线编号称为RX Logical Antenna Number。用于发射的天线的逻辑天线编号称为TX Logical Antenna Number。
目前我公司的所有读写器产品都采用收发一体天线模式，即读写器的某个物理天线端口工作时，该端口既发射也接收信号。
设置天线端口命令有多种格式。我们将分别介绍每一种命令格式。
物理/逻辑天线编号码映射关系
现在除了SLR11xx系列读写器之外的所有读写器产品的TX逻辑天线编号和RX逻辑天线编号和物理天线端口编号完全一致。SLR11xx系列读写器的物理/逻辑天线编号的关系如下。
| 物理天线端口编号 | TX Logical Antenna Number | RX Logical Antenna Number |
|---|---|---|
| 1 | 1 | 1 |
| 2 | 3 | 3 |
| 3 | 2 | 2 |
| 4 | 4 | 4 |
命令属性
| Command Code | Bootloader 命令 | App Firmware 命令 |
|---|---|---|
| 0x91 | 否 | 是 |
Host to Reader
设置标签访问操作使用的天线
这种格式用于设置标签访问操作的天线，每种标签访问操作只能指定一个天线进行操作。
Data字段格式
| 字段 | 字节长度 | 描述 |
|---|---|---|
| Option | 1 | 总是0x00 |
| TX Logical Antenna Number | 1 | |
| RX Logical Antenna Number | 1 |
设置标签盘存使用的天线
标签盘存操作可以使用一个或多个天线。
Data字段格式
| 字段 | 字节长度 | 描述 |
|---|---|---|
| Option | 1 | 总是0x02 |
| TX,RX Logical Antenna Number pairs | M*2 | M个2字节TX，RXTX,RX Logical Antenna Number pairs，在设置多个逻辑天线后，标签盘存时切换天线的顺序与命令中的TX，RX逻辑天线编号对的顺序相同。 |
设置天线的功率
设置天线端口的发射功率
Data字段格式
| 字段 | 字节长度 | 描述 |
|---|---|---|
| Option | 1 | 总是 0x03 |
| TX Logical Antenna Power Configuration | M*5 | M 个TX Logical Antenna Power Configuration |
TX Logical Antenna Power Configuration
| 字段 | 字节长度 | 描述 |
|---|---|---|
| TX Logical Antenna Number | 1 | |
| Read Power | 2 | 读取相关操作的发射功率，单位为0.01dbm，目前实际精度为1dbm。 |
| Write Power | 2 | 写入相关操作的发射功率，单位为0.01dbm，目前实际精度为1dbm。 |
设置天线的功率和设置定时间
设置天线的功率和设置定时间（指天线切换后开始发射信号前等待的时间）
Data字段格式
| 字段 | 字节长度 | 描述 |
|---|---|---|
| Option | 1 | 总是0x04 |
| TX Logical Antenna Power and Setting Time Configuration | M*7 | M 个TX Logical Antenna Power and Setting Time Configuration |
TX Logical Antenna Power and Setting Time Configuration
| 字段 | 字节长度 | 描述 |
|---|---|---|
| TX Logical Antenna Number | 1 | |
| Read Power | 2 | 读取相关操作的发射功率，单位为0.01dbm，目前实际精度为1dbm。 |
| Write Power | 2 | 写入相关操作的发射功率，单位为0.01dbm，目前实际精度为1dbm。 |
| Setting Time | 2 bytes | 在天线切换时，用于配置天线所需的稳定时间，单位μs。 |
举例
例子1
设置天线端口1作为标签访问操作使用的天线（Option = 0x00）
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 |
例子2
设置物理天线端口1和4作为标签盘存使用的天线（Option = 0x02）
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 |
例子3
设置天线功率（Option = 0x03），设置物理天线端口2和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 |
例子4
设置天线的功率和Setting Time（Option = 0x04），设置物理天线端口1,2,3和4的功率和Setting Time。
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 |
备注
目前，当读写器上电时默认启用物理天线端口1。所有天线的默认初始功率（读/写）可能不是最大功率输出值。
读写器可以设置不相同的读取功率和写入功率值。每个天线也可以具有不同的读/写功率值。 命令中每个逻辑天线编号对的位置不需要按特定顺序。