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

ANT+: ANT BRADAR

重要

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

1 功能概述

ant_bradar演示了ANT+ bike radar profile在PAN1080 SoC上的使用方法,主要包括:

  • 雷达传感器的例程

2 环境准备

  • PAN1081 EVB一块

  • Type-C USB线一条(用于供电和查看串口打印Log)

  • 硬件接线:

    • 使用USB线,将PC USB与EVB Type-C USB(USB->UART)相连

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

      • TX0 与 P00相连

      • RX0 与 P01相连

  • PC软件: 串口调试助手(UartAssist)或终端工具(SecureCRT),波特率921600

  • 码表或者其他ANT接收设备

3 编译和烧录

例程位置:zephyr\samples_panchip\ant_plus\ant_bradar

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

4 演示说明

本例程中:

  1. 例程按照ANT+协议上报雷达数据。

  2. 例程自带的模拟器支持手动模式和自动模式改变发送数据

    手动和自动模式切换需要在sdk_config.h文件修改以下宏,1代表自动模式,0代表手动模式

    #define BRADAR_SIMULATOR_AUTO_UPDATE          1
    
    • 自动模式

      自动模式下雷达数据会自动变化并上报,此时观察码表或其他接收设备会看到雷达监测的目标在变化。

    • 手动模式

      手动模式需要按键控制数据的变化。

4.1 例程日志:

如果运行正常,日志会持续输出“TX success”

*** Booting Zephyr OS build zephyr-v2.7.0-528-ga1bfaee13973  ***
*** libprf-v1.1.0-fa77ba3 ***
*** libant-v1.0.0-5745a878 ***
ANT+ Bike Radar TX sample started.
TX success
TX success
TX success
TX success
......

5 开发者说明

  1. 启用ANT模块,需要在prj.conf文件中添加”CONFIG_USE_PANPLAT_ANT=y”和”CONFIG_ENABLE_PANCHIP_PRF=y”

    CONFIG_USE_PANPLAT_ANT=y
    CONFIG_ENABLE_PANCHIP_PRF=y
    
  2. 开启低功耗模式,需要在prj.conf文件中添加如下宏

    # LowPower
    CONFIG_PM=y
    # Running clock frequency
    CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC=32768
    CONFIG_SYS_CLOCK_TICKS_PER_SEC=32768
    # Clock Source is XTL
    CONFIG_BT_CTLR_SLEEP_CLOCK_SOURCE=1
    # Sleeping clock frequency
    CONFIG_BT_CTLR_SLEEP_CLOCK_HZ=32768
    # Enable DC/DC
    CONFIG_SOC_DCDC_PAN1080=y
    
  3. 开启日志,需要再prj_conf文件中添加如下宏

    # Disable Serial Uart & Log.
    CONFIG_SERIAL=y
    CONFIG_UART_INTERRUPT_DRIVEN=y
    CONFIG_CONSOLE=y
    CONFIG_UART_CONSOLE=y
    
  4. 初始化ANT

    • 通道配置

      ANT通信是基于通道的,所以配置通道是必不可少的步骤。下列是通道配置的参数

      ant_channel_config_t channel_cfg = {
      	.channel_num = BRADAR_CHANNEL_NUMBER,           // 通道号,默认为0
      	.channel_type = BRADAR_CHANNEL_TYPE,            // 通道类型,Master or slave
      	.ext_assign = 0,                                // 暂不支持,填0即可
      	.rf_frequency = BRADAR_RF_FREQ,                 // 通信频率,ANT+固定为2457
      	.transmission_type = BRADAR_TRANSMISSION_TYPE,  // 传输类型,按照协议规定设置
      	.device_type = BRADAR_DEVICE_TYPE,              // 设备类型,按照协议规定设置
      	.device_num = BRADAR_DEVICE_NUMBER,             // 设备编号 16bit,自定义
      	.channel_period = BRADAR_MSG_PERIOD,            // 通道周期,按照协议固定设置
      	.network_number = BRADAR_NETWORK_NUMBER         // 网络号,必须设置为0,不支持其他网络号
      };
      
    • 设置网络

      下列接口实现设置ANT+网络

      ant_plus_key_set(channel_cfg.channel_num);
      
    • 启动ANT

      下列接口实现启动ANT协议

      ant_stack_init(channel_cfg.channel_type);
      
  5. 初始化profile

    • 下列接口实现雷达传感器的初始化

    err_code = ant_bradar_sensor_init(&bradar_profile, &channel_cfg);
    
    • 下列接口实现打开雷达传感器

    err_code = ant_bradar_sensor_open(&bradar_profile);
    
    • 下列接口实现注册BRADAR的handler函数,handler函数需要处理ANT栈返回的一些消息,比如发送成功消息,发送失败消息,接收到数据的消息等等。

    ant_evt_handle_register(&evt);
    
  6. 初始化simulator

    SDK为BRADAR提供了一个simulator,以便于实例程序可以模拟实际数据进行测试。

    下列接口实现初始化bradar simulator。参数BRADAR_SIMULATOR_AUTO_UPDATE为1表示simulator自动改变发送数据,为0表示需要人工按键改变发送数据。

    ant_bradar_simulator_init(&bradar_profile, BRADAR_SIMULATOR_AUTO_UPDATE);
    
  7. 更新数据

    下列接口实现更新发送数据。实际使用根据需要可以实现自己的更新函数

    ant_bradar_update_simulator(&bradar_profile, 0);
    
  8. 发送数据

    下列接口实现推送发送数据的事件。实际使用中根据是否需要更新发送数据的情况调用

    ant_bradar_sensor_evt_handler(&ant_evt, &bradar_profile);
    

6 RAM/Flash资源使用情况

Memory region         Used Size  Region Size  %age Used
FLASH:       35632 B       256 KB     13.59%
SRAM:       12424 B        64 KB     18.96%