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

Sub-1G: CAD

重要

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

1 功能概述

cad演示了Sub-1G的检测空中信号功能。此功能可以检测空中的Chirp信号，并使用拉高电平的方式通知系统。

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\cad

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

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

4 演示说明

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

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

因为CAD例程是一个RX例程，所以需要一个TX端做配合进行测试，这里我们可以复用trx_sample这个例程。将一块儿开发板配置成发送设备，就可以用key2键发送数据了。每次发送就可以在CAD测试端看到如下日志：

[00:01:36.017,000] <dbg> sub1g.sub_oneg_main_thread: Chirp signal is detected

[00:01:36.033,000] <dbg> sub1g.sub_oneg_irq_handler: Rx done

注意事项

开发板默认没有焊接R1电阻，也就是P55脚与CAD的中断脚（GPIO11）没有连接，需要再R1焊接一个0欧姆的电阻。

检测信号的时候，我们一般会先计算此时的配置下一个chirp信号持续的时间，然后连续等待3个chirp以上的时间如果CAD中断脚还是高电平的话就说明空中是有chirp的，反之可能是误触发。

5 开发者说明

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

    CONFIG_SUB_ONEG=y
CONFIG_NEWLIB_LIBC=y

  2. Sub-1G初始化

    cfg.cad_en = 1;   //使能CAD功能
/**
 * @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. 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);

  4. 获取当前一个chirp持续的时间

    /**
 * @brief Start receive mode.
 *
 * @param bw      BW value.
 * @param sf      SF value.
 *
 * @retval time
 */
uint32_t get_chirp_time(uint8_t bw, uint8_t sf);

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

6 RAM/Flash资源使用情况

Memory region         Used Size  Region Size  %age Used
FLASH:      47724 B       256 KB     18.21%
SRAM:       12024 B        64 KB     18.35%