24. RF Master.¶
RF master是蓝牙SIG标准化接收机和发射机HCI命令以及附加的自定义测试HCI命令的实现。
用户可以通过在带式菜单的“布局”选项卡下选择RF主站来访问RF主站,该选项卡将RF主站装入带日志。或者,用户可以在色带的“工具”选项卡下选择RF主刀具。图103.介绍大多数设备系列常见的RF主UI。有些家庭支持额外的RF主命令,将在不同的小节中呈现。
打开RF主站时,仅包含RF主相关按钮的功能区添加额外选项卡。目前RF主选项卡包含重启
and the释放UART.
buttons. When the ‘Release UART’ button is clicked the allocated UART port used for communication is freed and can be used from other tools such asTerminal Scripting
RF主测试以树状结构分布,用户只能展开当前使用的测试,并折叠其余的测试。用户可以使用按钮在选项卡顶部找到。为了运行RF主测试,用户应首先下载合适的RF主固件,具体取决于所选芯片。用户可以通过UART或JTAG下载固件。连接多个设备并在“设置文件部分”对话框中先前选择了不同的通信接口时,将要求用户选择要用于固件下载的COM端口或JTAG序列号。RF主测试通过UART运行,因此如果在Settings文件选择窗口和RF主件固件下载中选择了JTAG,则将要求用户选择将用于测试的COM端口。
24.1. 通用射频主测试¶
以下RF主测试对于大多数设备族是常见的:
- le tx / rx
- 未调制发送/接收
- 连续发送
- xtal.
- 睡觉
Note
附录Ashows how to produce binary firmware for each chip family.
24.1.1。le tx / rx¶
LE收发工具发送蓝牙LE测试命令。测试需要两个实例,一个用作发射器,另一个用作接收器。
24.1.1.1。发射机¶
用户首先选择分组的频率,有效载荷类型及其长度以字节为单位。然后在测试模式下,用户具有以下选项:
1.连续发送:选择此模式时,蓝牙SIG标准化HCI_LE_Transmitter_Test命令是发送的。在此测试中,DUT以固定间隔发送测试参考报文,直到蓝牙SIG标准化HCI_LE_Test_End执行命令。在能够运行新的LE TX测试命令之前,用户必须先停止连续数据包传输。
Note
#pactets tx.option is not supported for DA1469x family devices.
2.#pactets tx.:此模式还基于蓝牙SIG标准化HCI_LE_Transmitter_Test命令,差异是用户可以指定要在测试时发送的数据包数。可以在一个测试中发送的最大数据包数为65535(两个字节)。按下启动按钮时,DUT以固定间隔生成指定数量的测试参考报文。
Start Button:启动选定的LE变送器测试。请注意,在测试完成(已发送指定数量的数据包)或用户按下停止按钮之前,启动处于禁用状态,因为无法启动第二个LE发送器测试,而另一个LE发送器测试已在运行。
停止按钮:Sends the Bluetooth SIG standardizedHCI_LE_Test_End命令。在传输完成之前,可用于停止连续传输或通过基层数据包的传输。请注意,如果具有指定数量的数据包的传输完成,则会自动禁用“停止”按钮。
日志输出示例:
蓝色的消息,标有====> [日期] Tx <===描述主机发送到目标的命令。绿色的消息,标有====> [日期] Rx <===描述目标的回应。在图106.we can see that the command with opcode 0xFC90(DA1468x家庭)发送,固件响应一个事件,该事件的参数中包含操作码0xFC90。当包传输完成时,一条信息消息通知用户完成,固件发送事件代码为0x0E的事件,其参数中也包含操作码0xFC90。发送LE Tx命令后未从目标接收到事件,表示存在问题。建议用户按下水平工具栏上的重置按钮,如果问题仍然存在,请将固件再次下载到目标。
24.1.1.2。接收者¶
用户选择测试需要频率,如果测试需要额外的RF统计信息。在此测试中,蓝牙SIG标准化hci_le_receiver_test.执行测试。在测试期间,DUT在固定间隔处接收测试参考报文,直到按下停止按钮。按下停止按钮时收到测试结果。用户可以在日志上看到已成功接收的数据包数。如果已请求额外的统计数据,则用户还可以在日志上看到已通过同步错误收到的数据包数以及已通过CRC错误接收的数据包数。
Start Button:启动所选的LE接收器测试。如果在TRASMITTER侧已经选择了具有特定数量的数据包的测试,则用户应首先启动接收器测试以接收数据包。
停止按钮:Sends the Bluetooth SIG standardizedHCI_LE_Test_End命令。测试结果显示在日志上。
日志输出示例:
在图108.,第一对Tx和Rx消息在按下启动按钮时生成,第二对消息在按下停止按钮时生成。当主机发送操作码为0xFC81的命令时(DA1468x家庭)为了用额外的RF stats信息开始接收,固件响应一个事件,其参数中也包含0xFC81。当操作码为0xFC82的命令(DA1468x家庭)是为了发送停止接待,firmwa吗re responds with an event packet, which contains info about the number of packets that have been received correctly, the number of packets that have been received with SYNC error and the number of packets that have been received with CRC error. We observe that 14247 packets have been received by the LE Receiver and that 96 packets have been received with CRC error. Not receiving an event from the target after sending a LE Rx command, indicates a problem. User is advised to press the Reset button from the horizontal toolbar and, if the problem persists, to download the firmware again to the target.
24.1.2. 未调制发送/接收¶
此工具用于执行未调制的TX / RX测试。模式可以是tx或rx。选择TX模式并按下启动按钮时,启动未调制的TX测试。选择RX模式并按下启动按钮时,启动未调制的RX测试。当预测停止按钮时,未调制的RX或TX测试停止。为了查看该测试的结果,频谱分析仪必须连接到目标。
示例日志输出:
当未调制传输开始时,主机发送一个操作码为0xFC83的命令(DA1468x家庭)和模式0x54和目标与事件响应(图110.)。
当未调制的接收开始时,主机向OPCode 0xFC83和模式0x52和目标响应事件的命令(图111.)。
When the unmodulated transmission or reception stops, host sends a command with opcode 0xFC83 and mode 0x4f and target responds with an event (图112.)。
在发送未调制的Tx、Rx或stop命令后,没有从目标接收到事件,表示存在问题。建议用户按下水平工具栏上的重置按钮,如果问题仍然存在,请将固件再次下载到目标。
24.1.3。连续发送¶
该工具用于在连续流中启用具有指定有效载荷数据的调制载波。按下启动按钮时,连续传输调制信号,直到按下停止按钮。为了查看该测试的结果,频谱分析仪必须连接到目标。
示例日志输出:
当连续调制传输开始时,主机将使用Opcode 0xFC84发送命令(DA1468x家庭)目标和目标响应(图114.)。
When the continuous modulated transmission stops, host sends a command with opcode 0xFC85(DA1468x家庭)目标和目标响应(图115.)。
在发送连续的Tx启动或停止命令后,没有从目标接收到事件,表示存在问题。建议用户按下水平工具栏上的重置按钮,如果问题仍然存在,请将固件再次下载到目标。
24.1.4。xtal.¶
此工具中包含的一组命令用于配置XTAL修剪寄存器。
After user press the write button which sends a写命令,a读立即调用命令以更新值字段。
24.1.4.1. XTAL输出¶
此命令用于启用或禁用XTAL16M / XTAL32M(DA1469x family)GPIO P0_5上的输出。UART不应使用P0_5,或者与设备的通信将丢失。此命令还启用或禁用:
- xtal.32K output on GPIO P0_6
- RC16M output on P0_7
- rc32k在p1_0上输出
发送启用或禁用命令后,固件响应事件消息。没有接收事件消息,表示有问题的状态。建议用户从水平工具栏中按“重置”按钮,如果问题仍然存在,请将固件再次下载到目标。
24.1.4。2. XTAL Trimming¶
使用包含在XTAL修剪部分中的一组命令,用户可以读取和写入XTAL16M / XTAL32M的值(DA1469x family)register. This is a decimal value and it is written to the device register and not stored in Flash. When the Write button is pressed, first the write command is called and then the read command, in order to read again the trim value and verify its change.
示例日志输出:
用户正在发送一个XTAL read命令,固件会响应一个包含trim值的事件(图117.)。固件用事件响应读写命令。发送命令后没有接收事件,表示有问题的状态。
24.1.5。睡觉¶
Note
睡觉DA1468X系列设备不支持测试。
This tool contains a set of commands that put the target to sleep for specified number of minutes and seconds.
支持3种不同的睡眠模式:
- 无:活动模式
- 延长睡眠模式
- Deep Sleep Mode
分和秒是0到255之间的整数。如果分和秒都设置为零,那么设备将永远休眠。
示例日志输出:
Known limitations:
- 当设备从扩展睡眠模式唤醒时,UART通信将丢失。
- 设备不会从深度睡眠模式唤醒。
24.2。DA1469X系列RF主测试¶
This section presents extra tests that are supported only for DA1469x family devices and somne tests that are common for all families but their support is different for DA1469x family. The DA1469x family specific tests are organized as follows:
- 连续TX / RX
- xtal.
- OTP.
- Registers
- 其他
- TX电源配置
- rf校准
24.2。1. Continuous Tx/Rx¶
This tool enables a modulated carrier with specified payload data in a continuous stream. Two Toolbox instances can be used, one acting as the transmitter and the other acting as the receiver.
24.2.1.1。发射机¶
发送器用于开始测试DUT以固定间隔生成测试参考分组的测试。
PHY可以设定为1 Mbps或2 Mbps。间隔可以设置为0次启动a调制\u无限\u非包装\u测试or to a value greater or equal to 150 us to start a调制\u无限\u包\u测试
示例日志输出:
24.2。1.2. Receiver¶
接收器用于开始以固定间隔接收测试参考分组的测试。
在接收机端,应选择与发射机相同的频率、数据包长度和物理层选项。以下可用于间隔、窗口大小和第一个窗口大小选项:
间隔: can be either 0 or >=150 usec
Window Size:接受1-8171 USEC范围内的值
第一个窗口大小:计算在625 usec插槽中,应该是非零
示例日志输出:
24.2.2. XTAL公司¶
The set of XTAL commands is used to configure the XTAL32M trimming register. The user can enable/disable the XTAL32M output on GPIO P1_2, change the trim value or run calibration tests.
示例日志输出:
24.2.3。OTP.¶
The OTP panel allows the user to write/read the OTP memory. The user can enter the word offset and the number of words to read from the OTP and press the读按钮从OTP内存读取。用户可以通过双击来设置OTP Word内容Value (Hex)列并通过按写按钮。
Note that if the OTP word is already written and the user tries to write a different value, the resulting word value is unpredicted, since only 0 bits can turn to 1 in OTP. The maximum number of words that can been read or written at once is 60. The maximum word offset can be 1023, with which the user can read 1 word from OTP address 0x10080FFC, which is the last OTP memory word address. In case the combination of word offset and number of words to read exceeds the OTP memory size, the command will return the follwoing error:Error: Unsupported feature or parameter value (0x11).
示例日志输出:
24.2.4. 寄存器¶
寄存器面板可用于读取和写入寄存器地址。用户可以选择寄存器大小(32或16位长),然后设置寄存器的地址。值以十六进制输入,对于16位寄存器最多可以是0xFFFF,对于32位寄存器最多可以是0xFFFFFF。请注意,有些寄存器地址是只读的,因此如果用户尝试写入这样的地址,则寄存器值不会更改。
示例日志输出:
24.2.5。其他¶
此面板包含各种RF主命令,无法在任何其他DA1469x家庭特定RF主面板下进行分组。可以通过杂项面板执行Follwoing操作/测试:
- 固件版本: Get the Bluetooth controller version and the PLT FW version.
- 阅读ADC:从模拟输入读取值(电池电压)。
- 自定义动作: Echo back the custom action
- Uart环路:回显收到的消息
- GPIO配置:读/写GPIO PIN状态
- 传感器动作: Perform sensor test
示例日志输出:
24.2.6. Tx电源配置¶
此面板包含一组用于设置传输(Tx)功率的命令。提供两种模式:在测试模式下配置Tx电源和在正常模式下配置Tx电源。
TX功率配置在测试模式下
- 功率级:要设置的电源电平,接受0 - 15范围内的值
- Coarse attenuation:接受0-255(1字节大小)范围内的值。当所选功率电平等于1时,粗衰减可以仅为0,1或2。
- FEM精细衰减:接受0 - 6范围内的值
示例日志输出:
正常模式下的Tx电源配置
用户必须指定应应用输入功率电平的功率电平和空运类型。应选择至少一个空气操作类型。执行未选择Air操作类型的命令将返回错误。
示例日志输出:
24.2.7. 射频校准¶
该面板用于校准RF。用户可以选择其中一个校准类型并按校准button to start the RF calibration. The button获取结果返回日志中的校准结果。
示例日志输出: