• 每个示例都有自己的一组参数，请参阅文件夹中的 .h 文件
• lr1121_config 为配置文件 ，可以在其中设置参数，其中包括：
  • 数据包类型（PACKET_TYPE）
  • 射频频率（RF_FREQ_IN_HZ）
  • 输出功率（TX_OUTPUT_POWER_DBM）
  • 不同调制的数据包和调制参数

lr1121_cad

• 该芯片在 LoRa 中执行 CAD 操作。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA （在文件 ../../examples/lr1121_cad/lr1121_config.h 中）以使用此示例代码。
• 在 CAD 测试中，有三种退出模式可供定义，以适应不同的用例。对于 LR11XX_RADIO_CAD_EXIT_MODE_STANDBYRC 模式，一旦完成，无论信道上是否存在活动，芯片都会返回到 STBY_RC 模式。对于 LR11XX_RADIO_CAD_EXIT_MODE_RX 模式，如果检测到活动，芯片将保持 RX 状态，直到检测到数据包或计时器达到 CAD_TIMEOUT_MS 定义的超时时间。对于 LR11XX_RADIO_CAD_EXIT_MODE_TX 模式，如果未检测到任何活动，芯片将转至 tx 模式。此模式实际上是 tx 模式的替代模式，因此在将芯片设置为 LR11XX_RADIO_CAD_EXIT_MODE_TX 模式之前，应预加载用于传输的有效载荷数据。
• 可以在 lr1121_cad.h 头文件中更新几个参数：
  • CAD_SYMBOL_NUM：定义用于 CAD 检测的符号数量
  • CAD_DETECT_PEAK：定义 LoRa 调制解调器在尝试关联符号时的灵敏度
  • CAD_DETECT_MIN：最小峰值，用于滤除几乎没有信号或噪声的情况。
  • CAD_EXIT_MODE：定义 CAD 操作后要执行的操作
  • CAD_TIMEOUT_MS：仅当 CAD 使用 CAD_EXIT_MODE = LR11XX_RADIO_CAD_EXIT_MODE_RX 或 LR11XX_RADIO_CAD_EXIT_MODE_TX 执行时使用
  • USER_PROVIDED_CAD_PARAMETERS：设置为 true，将使用用户提供的 CAD 参数
  • DELAY_MS_BEFORE_CAD：CAD 检测之间的延迟

lr1121_firmware_update

• 此示例用于更新LR1121的固件，升级成最新版，或者刷入LoRaWan固件，使其兼容LoRaWan的使用
• 可以在 lr1121_firmware_update.h 头文件中解除注释相应的固件头文件，编译烧录后，主控将对LR1121进行固件更新，每次只能选择一个固件。
• 不同开发平台使用的注释方式不同，以下面的例程使用说明为准

lr1121_lr_fhss

• 应用程序将自动配置设备以在 LR-FHSS 中传输数据包。
• 频率可以在 ../../examples/lr1121_lr_fhss/lr1121_config.h 头文件中更新
• 可以在 lr1121_lr_fhss.h 头文件中更新几个参数：
  • TX_TO_TX_DELAY_IN_MS：两个传输数据包之间的时间延迟
  • LR_FHSS_BANDWIDTH：带宽
  • LR_FHSS_CODING_RATE：编码率
  • LR_FHSS_ENABLE_HOPPING：启用或禁用频率跳跃
  • LR_FHSS_GRID：跳频网格
  • LR_FHSS_HEADER_COUNT：头块数量
  • LR_FHSS_MODULATION_TYPE：调制类型

lr1121_per

• 将用于执行 LoRa 和 FSK 调制解调器的 PER 测试。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA 或 LR11XX_RADIO_PKT_TYPE_GFSK （在文件 ../../examples/lr1121_per/lr1121_config.h 中），以启用测试中的每个调制解调器。
• 在 PER 测试中，设备可以设置为 TX 设备或 RX 设备。此外，还有宏用于控制编译。要将设备设置为 RX 设备，宏 ( RECEIVER ) 必须设置为 1；要将设备设置为 TX 设备，则将其设置为 0。如果设置为 RX 设备模式，此应用程序将自动启动 PER 测试接收，以接收 NB_FRAME 倍数的数据包。如果设置为 TX 设备，启动后它将无限发送数据包。
• 有效载荷的第一个字节保留用于滚动计数器，该计数器将用于在 PER 统计中检测完全丢失的数据包。将计数器保留在第一个字节中可以实现最小有效载荷大小。接收方将检查有效载荷的其余部分，以确保接收到的数据包不是不需要的。per_msg 是一个用于保存此部分有效载荷内容的 per_msg 。如果 PAYLOAD_LENGTH （在 ../../examples/lr1121_per/lr1121_config.h 中定义）小于 1，则不会进行有效载荷检查，因为有效载荷中只有计数器。
• 可以在 lr1121_per.h 头文件中更新几个参数：
  • RECEIVER：设置成 RX 或 TX 设备
  • RX_TIMEOUT_VALUE：接收超时值
  • TX_TO_TX_DELAY_IN_MS：两个传输数据包之间的时间延迟
  • NB_FRAME：将对数据包的数量进行每秒错误率（PER）测试

lr1121_ping_pong

• 将设备设置为乒乓模式。
• 示例代码将用于执行 LoRa 和 FSK 调制解调器测试。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA 或 LR11XX_RADIO_PKT_TYPE_GFSK （在文件 ../../examples/lr1121_ping_pong/lr1121_config.h 中），以启用测试中的每个调制解调器。
• 该应用程序可让设备在乒乓测试中工作在主设备或从设备模式。设备启动时会假设自己是主设备，并交替发送“PING”数据包和接收“PONG”数据包。当收到“PING”数据包时，设备会切换到从设备模式，然后发送“PONG”数据包并等待接收“PING”数据包。在从设备模式下，如果设备收到“非 PING”数据包，则会重置为主设备模式并重新开始之前的流程。
• 可以在 lr1121_ping_pong.h 头文件中更新几个参数：
  • RX_TIMEOUT_VALUE：接收超时值

lr1121_read

• 将设备设置成接收模式。
• 示例代码将用于执行 LoRa 和 FSK 调制解调器测试。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA 或 LR11XX_RADIO_PKT_TYPE_GFSK （在文件 ../../examples/lr1121_read/lr1121_config.h 中），以启用测试中的每个调制解调器。
• 一直读取信息，可与另一台设备搭配 lr1121_write 进行测试

lr1121_sigfox

• 此示例代码说明了符合 Sigfox 标准的上行链路的发送。
• 当前有一个预定义的物理有效载荷（对应于“0x01”应用程序有效载荷）。
• 要发送另一个有效载荷，可以更新 lr1121_sigfox.* 中的 sample0 数组和 SIGFOX_PAYLOAD_LENGTH 宏。
• 可以在 lr1121_sigfox.h 头文件中更新几个参数：
  • TX_TO_TX_DELAY_IN_MS：两个传输数据包之间的时间延迟

lr1121_spectral_scan

• 该应用程序通过将设备设置为 Rx continuous 模式并定期逐个频率通道读取瞬时 RSSI 来实现频谱扫描操作。对于每个通道，使用 GetRssiInst 函数对 RSSI 值进行 NB_SCAN 次采样。然后，芯片切换到下一个通道以重复相同过程。每个频率通道都有一个统计数据，以直方图的形式显示。在终端屏幕上，直方图显示为跟随相应频率值的数字数组。所有这些统计数据构成了电磁环境热图。在每个直方图统计数据中，每个数字代表直方图列的高度，数组的顺序表示 RSSI 值的范围从 0dBm 到 -128dBm。数组的长度取决于 RSSI 级别的比例 RSSI_SCALE 。X 轴表示背景电磁噪声级别，而 Y 轴表示结果位于级别槽中的可能性。
• 举个例子。假设我们在终端中看到一行“INFO: 2400.000 MHz: 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 16 76 8 0 0 0 0 0”。我们可以算出这个数组的长度是 33，所以是 RSSI_SCALE = (RSSI_TOP_LEVEL-RSSI_BOTTOM_LEVEL)/(33-1) = (0-(-128))/32 = 4dBm 。这相当于下面的直方图。

   0   0   0   0 ... 0   16  76  8   0   0   0   0   0
 ^
 |                            _
 |                           | |
 |                           | |
 |                           | |
 |                           | |
 |                        _  | |
 |                       | | | |  _
 | _____________._._.____| |_| |_| |__________________
 +-------------- ... -------------------------------------->
  /0dBm   /-8dBm ... /-96dBm /-104dBm/-112dBm/-120dBm/-128dBm

• 示例代码将用于在 LoRa 和 FSK 调制解调器测试下进行测试，但如果带宽相同，则应该没有区别。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA 或 LR11XX_RADIO_PKT_TYPE_GFSK （在文件 ../../examples/lr1121_spectral_scan/lr1121_config.h 中），以启用测试中的每个调制解调器。
• 可以在 ../../examples/lr1121_spectral_scan/lr1121_config.h 头文件中更新几个参数：
  • PACKET_TYPE：设置将使用的调制解调器
  • LORA_BANDWIDTH：LoRa 数据包的带宽
  • FSK_BANDWIDTH：GFSK 数据包的带宽
• 可以在 lr1121_spectral_scan.h 头文件中更新几个参数：
  • FREQ_START_HZ：进行扫描的第一个信道频率
  • NB_CHAN：需要扫描的通道数
  • NB_SCAN：每次频率扫描的扫描点数
  • PACE_S：线程中两次扫描之间的间隔秒数
  • WIDTH_CHAN_HZ：每个通道之间的宽度
  • RSSI_TOP_LEVEL_DBM：最高 RSSI 值，默认：0dBm
  • RSSI_BOTTOM_LEVEL_DBM：最低 RSSI 值，默认值：-128dBm
  • RSSI_SCALE：频谱扫描显示的 RSSI 标度

lr1121_spetrum_display

• 该应用程序通过将设备设置为 Rx continuous 模式并定期逐个读取各个频道的瞬时 RSSI 来实现频谱显示操作。覆盖所有正在扫描频道的频谱将绘制在终端屏幕上。从 FREQ_START_HZ 定义的起始频道频率开始，将使用 GetRssiInst 函数为每个频道获取 1 个 RSSI 级别的采样点。收集所有频道 RSSI 值后，将在终端屏幕上绘制一条频谱曲线。该曲线将每 PACE_S 秒刷新一次，重复之前的步骤。
• 以下是终端屏幕上显示的曲线示例。曲线底部表示扫描频段内天线周围的本底噪声。峰值表示哪些频道有射频活动。X 轴下方显示的频率框表示正在扫描的频段。Y 轴表示 RSSI 级别。

   ^
   0|
  -4|
  -8|
 -12|
 -16|
    .
    .
    .
 -76|
 -80|                          _
 -84|                    _    | |
 -88|                  _| |   | |
 -92|_                |   |   | |              _
 -96| |               |   |   | |             | |              _
-100| |               |   |   | |             | |             |
-104| |            _  |   |_._| |_     _     _| |             |
-108| |_._._._._._| |_|           |_._| |_._|   |_._._._._._._|
-112|
-116|
-120|
-124|
-128|
/dBmx------------------------------------------------------------>
    2400 --> 2406 MHz

• 绘图功能需要 VT100 控制代码的支持。因此，为了正常运行此演示，需要一个支持 VT100 控制代码的终端（例如：MobaXterm）
• 示例代码将用于在 LoRa 和 FSK 调制解调器测试下进行测试，但如果带宽相同，则应该没有区别。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA 或 LR11XX_RADIO_PKT_TYPE_GFSK （在文件 ../../examples/lr1121_spetrum_display/lr1121_config.h 中），以启用测试中的每个调制解调器。
• 可以在 ../../examples/lr1121_spetrum_display/lr1121_config.h 头文件中更新几个参数：
  • PACKET_TYPE：设置将使用的调制解调器
  • LORA_BANDWIDTH：LoRa 数据包的带宽
  • FSK_BANDWIDTH：GFSK 数据包的带宽
• 可以在 lr1121_spectral_scan.h 头文件中更新几个参数：
  • FREQ_START_HZ：进行扫描的第一个信道频率
  • NB_CHAN：需要扫描的通道数
  • PACE_S：线程中两次扫描之间的间隔秒数
  • WIDTH_CHAN_HZ：每个通道之间的宽度
  • RSSI_TOP_LEVEL_DBM：最高 RSSI 值，默认：0dBm
  • RSSI_BOTTOM_LEVEL_DBM：最低 RSSI 值，默认值：-128dBm
  • RSSI_SCALE：频谱显示的 RSSI 尺度

lr1121_tx_cw

• 将设备设置为 Tx 连续波模式。
• 通用参数可以在 ../../examples/lr1121_tx_cw/lr1121_config.h 头文件中更新

lr1121_tx_infinite_preamble ===

• 将设备设置成传输无限前导码。
• 通用参数可以在 ../../examples/lr1121_tx_infinite_preamble/lr1121_config.h 头文件中更新

lr1121_write

• 将设备设置成发送模式。
• 示例代码将用于执行 LoRa 和 FSK 调制解调器测试。将宏 PACKET_TYPE 定义为 LR11XX_RADIO_PKT_TYPE_LORA 或 LR11XX_RADIO_PKT_TYPE_GFSK （在文件 ../../examples/lr1121_write/lr1121_config.h 中），以启用测试中的每个调制解调器。
• 周期性发送信息，可与另一台设备搭配 lr1121_read 进行测试

lr1121_LoRaWAN

• 此示例演示了如何在 LoRaWAN Class A 应用程序中定期发送上行链路，并通过按下按钮手动触发上行链路。
• 该应用程序自动向 LoRa 网络服务器提交加入请求。
• 一旦收到加入接受消息，就会定期发送上行链路。
• 按下 按钮 或者 将指定引脚接GND 会立即在端口 102 上发送上行链路。
• lr1121_LoRaWAN.h 中设置了一些常量，可以设置它们的值来定义应用程序的 LoRaWAN 配置。
  • PERIODICAL_UPLINK_DELAY_S：定期上行链路警报延迟（秒）
  • EXTI_BUTTON：按钮的引脚号
  • LORAWAN_APP_DATA_MAX_SIZE：用户应用程序数据缓冲区大小。
  • LORAWAN_REGION_USED：LoRaWAN 监管区域。
• LR1121 预配置了 ChipEUI/DevEUI 和 JoinEUI。如果 lorawan_comissioning.h 文件中的 USE_LR11XX_CREDENTIALS 设置为 true，应用程序将使用这些标识符。
• 或者，您可以在 Inc/apps/lorawan_commissioning/lorawan_commissioning.h 中提供自己的 EUI，方法是将 USE_LR11XX_CREDENTIALS 设置为 false，并更改 LORAWAN_DEVICE_EUI 、 LORAWAN_JOIN_EUI 、 LORAWAN_NWK_KEY 和 LORAWAN_APP_KEY 的值。
• 用户按键设定
  • ESP32：GPIO0
  • Pico：GP0
  • 树莓派：BCM26
  • STM32：PC13

通用参数介绍

• 通用参数存放在每个示例的lr1121_config.h，下面开始介绍每个参数的作用