返回首页

BLE peripheral_uart 学习笔记

概述

这是一个完整的 BLE UART 透传示例（Nordic UART Service, NUS）。手机或其他 BLE 设备可以通过 BLE 发送数据，MCU 再通过 UART 转发到外设（如 USB CDC）。

---

1. 系统架构

┌─────────────────┐      BLE       ┌─────────────────┐
│   手机/主机      │◄──────────────►│  nRF54L15       │
│                 │                 │                 │
│  Nordic UART   │                 │  BLE NUS       │
│  Service       │                 │  ↕ (内存)       │
│                 │                 │  ↕              │
│                 │                 │  UART (CDC)    │
└─────────────────┘                 └────────┬────────┘
                                           │
                                           ▼
                                    ┌─────────────────┐
                                    │   电脑终端      │
                                    │   (串口终端)    │
                                    └─────────────────┘

双向数据流：

• BLE → 手机发数据 → BLE NUS → UART → 电脑
• 电脑发数据 → UART → BLE NUS → BLE → 手机

---

2. BLE 初始化流程

2.1 启用 BLE 协议栈

err = bt_enable(NULL);
if (err) {
    error();
}

• 初始化 BLE 控制器和主机
• 参数 NULL 使用默认配置

2.2 配置广播

static const struct bt_data ad[] = {
    BT_DATA_BYTES(BT_DATA_FLAGS, (BT_LE_AD_GENERAL | BT_LE_AD_NO_BREDR)),
    BT_DATA(BT_DATA_NAME_COMPLETE, DEVICE_NAME, DEVICE_NAME_LEN),
};

static const struct bt_data sd[] = {
    BT_DATA_BYTES(BT_DATA_UUID128_ALL, BT_UUID_NUS_VAL),
};

• AD 数据：设备名称、广播 flags
• Scan Response (SD)：NUS 服务 UUID

2.3 启动广播

static void adv_work_handler(struct k_work *work)
{
    int err = bt_le_adv_start(BT_LE_ADV_CONN_FAST_2, ad, ARRAY_SIZE(ad), sd, ARRAY_SIZE(sd));
}

• BT_LE_ADV_CONN_FAST_2 - 快速广播模式（15ms 间隔，持续 30s）
• 可连接广播，允许从机接入

---

3. 连接管理

3.1 连接回调

static void connected(struct bt_conn *conn, uint8_t err)
{
    if (err) {
        LOG_ERR("Connection failed");
        return;
    }
    current_conn = bt_conn_ref(conn);  // 增加引用计数
    dk_set_led_on(CON_STATUS_LED);     // LED2 亮表示已连接
}

static void disconnected(struct bt_conn *conn, uint8_t reason)
{
    bt_conn_unref(current_conn);       // 释放引用
    current_conn = NULL;
    dk_set_led_off(CON_STATUS_LED);   // LED2 灭
    advertising_start();               // 重新广播
}

关键点：

• bt_conn_ref() - 增加连接引用，防止意外释放
• bt_conn_unref() - 减少引用，0 时释放内存
• 断开后自动重新广播

---

4. Nordic UART Service (NUS)

4.1 NUS 服务简介

NUS 是 Nordic 定义的私有 BLE 服务，提供两个特性：

• TX Characteristic：MCU → 手机（发送通知）
• RX Characteristic：手机 → MCU（写入数据）

4.2 NUS 初始化

static struct bt_nus_cb nus_cb = {
    .received = bt_receive_cb,  // 收到 BLE 数据时的回调
};

err = bt_nus_init(&nus_cb);

4.3 接收 BLE 数据

static void bt_receive_cb(struct bt_conn *conn, const uint8_t *const data, uint16_t len)
{
    // 通过 UART 发送出去
    for (uint16_t pos = 0; pos != len;) {
        struct uart_data_t *tx = k_malloc(sizeof(*tx));
        // ... 拷贝数据 ...
        err = uart_tx(uart, tx->data, tx->len, SYS_FOREVER_MS);
    }
}

---

5. 异步 UART API

5.1 与简单示例的区别

特性	echo_bot	peripheral_uart
API 类型	轮询 + 中断	异步回调 (Async API)
发送方式	uart_poll_out()	uart_tx() 带回调
接收方式	ISR 回调	uart_callback_set()
缓冲区	简单数组	动态分配 struct uart_data_t

5.2 回调类型

static void uart_cb(const struct device *dev, struct uart_event *evt, void *user_data)
{
    switch (evt->type) {
    case UART_TX_DONE:      // 发送完成
    case UART_RX_RDY:       // 接收就绪
    case UART_RX_DISABLED:  // 接收禁用
    case UART_RX_BUF_REQUEST:  // 需要更多缓冲区
    case UART_RX_BUF_RELEASED: // 缓冲区释放
    case UART_TX_ABORTED:   // 发送中止
    }
}

5.3 初始化

int uart_init(void)
{
    // 1. 分配 RX 缓冲区
    rx = k_malloc(sizeof(*rx));
    
    // 2. 设置回调
    err = uart_callback_set(uart, uart_cb, NULL);
    
    // 3. 启用接收
    err = uart_rx_enable(uart, rx->data, sizeof(rx->data), UART_WAIT_FOR_RX);
}

---

6. 双线程架构

6.1 线程定义

K_THREAD_DEFINE(ble_write_thread_id, STACKSIZE, ble_write_thread, NULL, NULL, NULL, PRIORITY, 0, 0);

• 栈大小：CONFIG_BT_NUS_THREAD_STACK_SIZE
• 优先级：7（较低优先级）

6.2 BLE 发送线程

void ble_write_thread(void)
{
    k_sem_take(&ble_init_ok, K_FOREVER);  // 等待 BLE 初始化完成
    
    for (;;) {
        // 从 RX FIFO 获取 UART 数据
        struct uart_data_t *buf = k_fifo_get(&fifo_uart_rx_data, K_FOREVER);
        
        // 发送到 BLE
        if (bt_nus_send(NULL, nus_data.data, nus_data.len)) {
            LOG_WRN("Failed to send data over BLE");
        }
    }
}

数据流：

UART 接收 → fifo_uart_rx_data → ble_write_thread → bt_nus_send() → BLE 发送

---

7. 关键配置 (prj.conf)

# UART 异步 API
CONFIG_UART_ASYNC_API=y
CONFIG_NRFX_UARTE=y

# BLE
CONFIG_BT=y
CONFIG_BT_PERIPHERAL=y
CONFIG_BT_DEVICE_NAME="Nordic_UART_Service"
CONFIG_BT_MAX_CONN=1

# NUS 服务
CONFIG_BT_NUS=y

# 存储配对信息
CONFIG_BT_SETTINGS=y

# LED 和按钮
CONFIG_DK_LIBRARY=y

---

8. GPIO 状态指示

LED	功能
LED1 (RUN_STATUS_LED)	系统运行指示，1秒闪烁
LED2 (CON_STATUS_LED)	BLE 连接状态，连接时亮

---

9. 关键问题总结

问题	答案
BLE 广播参数在哪？	bt_le_adv_start() 第一个参数
连接参数怎么改？	bt_le_adv_start() 及 CONFIG_BT_MAX_CONN
UART 波特率在哪设？	设备树 overlay 的 current-speed
如何开启配对加密？	CONFIG_BT_NUS_SECURITY_ENABLED=y
为什么用双线程？	分离 UART 和 BLE 处理，避免阻塞

---

10. 与 UART echo_bot 的对比

特性	echo_bot	peripheral_uart
复杂度	简单	复杂
通信方式	UART ↔ Terminal	BLE ↔ UART ↔ Terminal
API	轮询/中断	异步回调
线程数	1 (main)	2 (main + ble_write)
缓冲区	静态数组	动态分配
连接管理	无	完整连接/断开/重连

---

11. 学习心得

1. BLE 开发模式：广播 → 连接 → 服务发现 → 特征值读/写/通知
2. 异步 API 优势：非阻塞，更高效处理多任务
3. 内存管理：动态分配缓冲区，需要注意泄漏
4. 线程间通信：使用 FIFO 解耦，延迟工作

下一步：继续分析 SPI spi_flash 示例！

---

小白 🤖 2026-03-14