当前文档版本为 v0.9.0，您可以访问当前页面的 开发中 版本以获取最近可能的更新。

Sub-1G: PLHD

重要

此例程仅存在于特殊版本的SDK中，如有需要请联系Panchip。

1 功能概述

plhd演示了Sub-1G的接收提前中断功能。此功能会在收到配置的数据长度后就提前产生一个中断，不需要等到全部收完才产生中断。在一些应用中我们可以使用这个功能去做一些头部信息检查，来过滤掉一些非预期包，提高接收效率。

2 环境准备

  • PAN3730 EVB两块

  • Type-C USB线两条（用于供电和查看串口打印Log）

  • 硬件接线：

    • 使用USB线，将PC USB与EVB Type-C USB（USB->UART）相连

    • 使用杜邦线或者跳线帽将EVB上的:

      • TX0 与 P00相连

      • RX0 与 P01相连

  • PC软件: 串口调试助手（UartAssist）或终端工具（SecureCRT），波特率921600

  • 码表或者其他ANT接收设备，手机（nrf connect）

3 编译和烧录

例程位置：zephyr\samples_panchip\sub_1G\plhd

编译时Board选择pan3730_evb，Config选择prj.conf

使用 ZAL 工具可以对其进行编译、烧录、打开 VS Code 调试等操作。关于 ZAL 工具的详细介绍请参考：Zephyr APP Launcher 工具介绍。

4 演示说明

例程上电初始化会打印如下日志：

*** Booting Zephyr OS build zephyr-v2.7.0-999-gc2c0b41086a9  ***
[00:00:00.000,000] <dbg> sub1g.main: Sub-1G PLHD sample start!

因为PLHD例程是一个RX例程，所以需要一个TX端做配合进行测试，这里我们可以复用trx_sample这个例程。首先我们把trx_sample例程进行一点微调，因为提前中断功能需要设置确定从第几个字节开始检查，以及检查多少个字节的数据。而检查字节数有8字节和16字节可选，所以发送端必须发送超过8字节的数据才可以使用该功能。这里把light_command_send这个函数修改为如下内容：

uint8_t data[20];

if (device_attr.device_type != DEVICE_TYPE_SEND) {
    LOG_WRN("The current device is a receiving device and cannot send commands\n");
    return -1;
}

for(uint8_t i = 0; i < 20; i++){
    data[i] = i + 1;
}

return sub_oneg_send(&cfg, data, 20);

修改后，配置成发送设备，就可以用key2键发送数据了。每次发送就可以在RX端看到提前中断的日志：

[00:02:46.818,000] <dbg> sub1g.sub_oneg_main_thread: PLHD len: 8
[00:02:46.819,000] <dbg> sub1g: PLHD data: 
                                01 02 03 04 05 06 07 08                          |........         
[00:02:46.833,000] <dbg> sub1g.sub_oneg_main_thread: Data len: 20
[00:02:46.833,000] <dbg> sub1g: Data data: 
                                01 02 03 04 05 06 07 08  09 0a 0b 0c 0d 0e 0f 10 |........ ........
                                11 12 13 14                                      |....

5 开发者说明

  1. 启用ANT模块，需要在prj.conf文件中添加”CONFIG_SUB_ONEG=y”和”CONFIG_NEWLIB_LIBC=y”

    CONFIG_SUB_ONEG=y
CONFIG_NEWLIB_LIBC=y

  2. Sub-1G初始化

    /**
 * @brief Configure the sub-1G module.
 *
 * @param cfg Pointer to the sub-1G config struct.
 *
 * @retval 0 If successful.
 * @retval -errno Negative errno code on failure.
 */
int sub_oneg_configure(sub_oneg_cfg *cfg);

  3. 使能提前中断功能

    /**
 * @brief The phld function was enabled.
 *
 * @param start_address     Match the number of start bytes.
 * @param length            Matches the length of bytes. You can just choose 8 or 16 bytes.
 *								SUB_ONEG_PLHD_LEN8      8 bytes
 *								SUB_ONEG_PLHD_LEN16     16 bytes
 * @param on_off            Enable or disable this function.
 */
void sub_oneg_plhd_switch(uint8_t start_address, uint8_t length, uint8_t on_off);

  4. Sub-1G接收启动

    /**
 * @brief Start receive mode.
 *
 * @param cfg      Pointer to the sub-1G config struct.
 * @param mode     Set continue rx mode or single rx mode.
 *					CONTINUE_RX_MODE: After the rx is finished,
 *						it will not exit the rx mode and will remain in the rx mode.
 *					SINGLE_RX_MODE: When rx is finished, it exits rx mode
 * @param timeout  Set rx timeout(ms), 0 indicates no timeout until data is received.
 *
 * @retval 0 If successful.
 * @retval -errno Negative errno code on failure.
 */
int sub_oneg_receive_start(sub_oneg_cfg *cfg, sub_oneg_rx_mode_t mode, uint32_t timeout);

更多有关sub-1G的介绍请参考 Sub-1G使用指南文档。

6 RAM/Flash资源使用情况

Memory region         Used Size  Region Size  %age Used
FLASH:      48888 B       256 KB     18.65%
SRAM:       12320 B        64 KB     18.80%