# Ra-11_modem-e

**Repository Path**: Ai-Thinker-Open/ra-11_modem-e

## Basic Information

- **Project Name**: Ra-11_modem-e
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-18
- **Last Updated**: 2026-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![English](https://img.shields.io/badge/English-README-green)](README.md)

# LR1121 Modem-E 应用示例

## 项目介绍

本仓库提供在 NUCLEO-L476RG 与 LR1121 Shield 上运行的 LoRa Basics Modem-E v2.1.0 示例，包括 LoRaWAN Class A、OTAA/ABP 认证、Class B、组播和 FUOTA。默认构建目标为 `lorawan`。

## 硬件与环境

- NUCLEO-L476RG 开发板和 LR1121 Shield（支持带或不带 TCXO 的版本）
- ARM GNU Toolchain；原项目记录的开发版本为 10.2.1 20201103
- Make、ST-LINK/STM32CubeProgrammer 和 921600-8-N-1 串口终端

TCXO 参数在 `Inc/boards/board-config.h` 中配置。LoRaWAN 凭据位于 `Inc/apps/lorawan_commissioning/lorawan_commissioning.h`；部署前必须替换示例值，禁止提交生产密钥。

## 快速开始与构建

```bash
cd gcc
make clean
make APP=lorawan
```

支持的 `APP` 为 `lorawan`、`certification-otaa`、`certification-abp`、`class_b`、`multicast` 和 `fuota`。可通过 `EXTRAFLAGS` 设置区域或 TCXO，例如：

```bash
make APP=lorawan EXTRAFLAGS='-DLORAWAN_REGION_USED=MODEM_E_LORAWAN_REGION_AS923_GRP1'
```

ELF、BIN、HEX 和 MAP 生成在 `gcc/build`。使用 ST-LINK 烧录后，通过 921600 波特率串口查看复位、入网、上行和下行事件。

## 验证

```text
python tools/validate_repository.py
```

在安装 ARM GNU 工具链的 WSL/Linux 中执行隔离式干净构建：

```bash
bash tools/build_lorawan.sh
```

## 技术文档

- [代码入口](docs/CODE_ENTRY.zh.md)
- [架构说明](docs/ARCHITECTURE.zh.md)
- [验证与复现](docs/VALIDATION.zh.md)

## 问题排查与贡献

- 找不到 `arm-none-eabi-gcc` 时，请安装兼容 Cortex-M4 硬浮点输出的 ARM GNU Toolchain 并加入 `PATH`。
- 切换 `APP` 或 `EXTRAFLAGS` 前运行 `make clean`，因为应用共用 `gcc/build` 和目标文件名。
- 拉取请求应记录应用、命令、工具链、警告/错误、产物哈希和硬件结果。构建成功不能证明入网、射频、FUOTA 或认证行为。

## 许可证提示

仓库没有统一的根许可证。`Src/radio/modem_e` 下的驱动使用 Clear BSD License，STM32/CMSIS 等组件保留各自声明；再分发前应逐项检查。