如何把一个"能读出加速度"的传感器模块,变成一个"能产出标准数据集"的采集系统;
如何让训练数据和推理数据来自同一条数据通路,从根本上消除"训练时和部署时数据不一致"这一类最难排查的问题。
1.2 项目目标
本项目设定了以下具体目标:(1)高采样率三轴数据采集以400Hz速率连续采集X/Y/Z三轴加速度数据,单次采集窗口1秒共400个样本,保证能够覆盖机械振动的主要频段。(2)FIFO流式采集使用传感器内部FIFO配合Stream模式,避免MCU逐样本轮询导致的时序抖动和漏采。(3)标准化数据输出输出格式严格对齐NanoEdge AI Studio的int型数据集规范:行内空格分隔、组间换行、无表头,采集文件无需任何人工编辑即可直接导入。(4)大数据集连续采集单次按键触发连续采集200个信号(200组×1秒=200秒),总数据量约48万字节,满足NanoEdge AI Studio对每类样本量的要求。(5)训练-推理数据同源采集模块的环形缓冲区同时作为边缘推理的数据源,保证送入模型的数值与训练文件中的数值逐位一致。1.3 主要功能特性
2.2 三轴传感器 - LIS3DHTR
本系统选用ST LIS3DHTR作为三轴加速度传感器。这颗器件在可穿戴设备和工业振动监测中应用极其广泛,理由是它在低功耗和集成度之间取得了很好的平衡——内部集成了三轴MEMS加速度计、12位ADC和32深度的FIFO,片外只需一个I2C接口和几个去耦电容。LIS3DHTR主要参数:┌─────────────────────────────────────────────────────────────────────┐ │ 系统总体架构 │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ │ │ │ LIS3DHTR │ │ │ │ 三轴加速度计│ │ │ │ FIFO 深度32 │ │ │ │ 400Hz │ │ │ └──────┬──────┘ │ │ │ I2C1 (PB6=SCL, PB7=SDA) │ │ │ 一次事务弹出多个样本 │ │ ▼ │ │ ┌─────────────┐ │ │ │ 环形缓冲区 │ 800 样本 × 3轴 × 2字节 = 4.8 KB │ │ │ motion_ring │ 保留两个窗口的容量 │ │ └──────┬──────┘ │ │ │ │ │ ┌─────┴─────┐ │ │ │ │ │ │ ▼ ▼ │ │ ┌────────┐ ┌──────────────┐ │ │ │ 采集 │ │ 边缘推理 │ │ │ │ 格式化 │ │ 取最新窗口 │ │ │ │ 转CSV │ │ 送NanoEdge │ │ │ └───┬────┘ └──────────────┘ │ │ │ │ │ │ HAL_UART_Transmit_IT (非阻塞) │ │ ▼ │ │ ┌────────┐ │ │ │ USART2 │ ──► ST-LINK VCP ──► PC 串口工具 ──► 数据集文件 │ │ └────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘
核心设计思路:训练与推理数据同源
这个项目最核心的设计决策,是让采集输出和边缘推理共用同一个环形缓冲区。┌──────────────────┐ │ motion_ring │ ← 唯一的数据源 │ (800样本环形缓冲)│ └────────┬─────────┘ │ ┌──────────────┴──────────────┐ ▼ ▼ ┌──────────────────┐ ┌──────────────────┐ │ 训练数据路径 │ │ 推理数据路径 │ │ 格式化成CSV输出 │ │ 取出最新400样本 │ │ → PC → AI Studio │ │ → 送入NEAI模型 │ └──────────────────┘ └──────────────────┘为什么这么做?因为在边缘AI项目里,"训练时和部署时数据不一致"是最难排查的一类问题。表现是模型在PC上验证准确率很高,烧到板子上却乱跳。
驱动层接口设计
驱动对外暴露的接口保持了语义化,而不是寄存器操作的堆砌:主程序流程图
┌─────────────────────────────────────────────────────────────────┐ │ 程序开始 │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 系统初始化 │ │ - HAL_Init / SystemClock_Config (CSI→PLL→250MHz) │ │ - MX_GPIO_Init (IN1~IN4 电机输出, 全低) │ │ - MX_I2C1_Init (PB6=SCL, PB7=SDA) │ │ - BSP_LED_Init / BSP_PB_Init │ │ - BSP_COM_Init (USART2 115200) │ │ - actuator_drive_setup (线圈全断, 不发热) │ │ - Shell_Init / Shell_Start │ │ - HAL_TIM_Base_Start_IT (TIM6 1ms节拍) │ │ - motion_sense_start (探测LIS3DHTR, 启动FIFO) │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 进入主循环 │ │ │ │ ┌────────────────────────────────────────┐ │ │ │ actuator_drive_poll() │ │ │ │ 步进相序推进 (按实际时间累加) │ │ │ └────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────────────────────┐ │ │ │ Shell_Process() │ │ │ │ 输出队列 → USART2 │ │ │ └────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────────────────────┐ │ │ │ capture_poll() │ │ │ │ ┌──────────────────────────────────┐ │ │ │ │ │ 应用挂起的start/stop请求 │ │ │ │ │ └──────────────────────────────────┘ │ │ │ │ ┌──────────────────────────────────┐ │ │ │ │ │ motion_sense_poll() 排空FIFO │ │ │ │ │ └──────────────────────────────────┘ │ │ │ │ ┌──────────────────────────────────┐ │ │ │ │ │ 上次发送完成? 否→返回 │ │ │ │ │ │ motion_sense_read_window() │ │ │ │ │ │ 格式化400样本 → Transmit_IT │ │ │ │ │ └──────────────────────────────────┘ │ │ │ └────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────────────────────┐ │ │ │ LED 状态指示 + HAL_Delay(1) │ │ │ └────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘
采集模块的关键实现
格式化成行一行 = 一个信号 = 400个样本 × 3轴 = 1200个值。格式串直接对应NanoEdge AI Studio的规范:written = snprintf(&capture_line[pos], CAPTURE_LINE_MAX_CHARS - pos, "%d %d %d%c", (int)sample[0], (int)sample[1], (int)sample[2], (i == (CAPTURE_WINDOW_SAMPLES - 1U)) ? '\n' : ' ');格式串里的 %c 是关键:除最后一个样本用空格外,其余全部用换行。这一行代码同时定义了"组内分隔符"和"组间分隔符"——组内是空格,组间是换行。非阻塞发送
if (HAL_UART_Transmit_IT(&hcom_uart[COM1],
(uint8_t *)capture_line,
(uint16_t)pos) == HAL_OK)
{
capture_tx_busy = true;
}配套的完成回调:void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
if (huart->Instance == COM1_UART)
{
capture_on_tx_complete(); /* 清 busy 标志 */
}
}capture_tx_busy 标志保证同一时刻只有一行数据在网线上。串口命令行
系统同时运行着采集输出和串口命令行,两者共用USART2,这里有一个容易被忽略的陷阱。问题:命令行最初在USART2中断上下文里直接用阻塞式的 HAL_UART_Transmit() 发回显。采集数据时USART2正忙着发整行数据(Transmit_IT),此时中断里的回显会:阻塞在中断上下文里等待UART空闲 → SysTick和TIM6中断全部被拖住
写入正在发送的UART寄存器 → 把正在传输的那一行数据打断,采集数据损坏
数据格式与NanoEdge AI Studio适配
NanoEdge AI Studio导入数据集时,把每一行视为一个独立的信号缓冲区(signal/buffer),行内是按轴交错的数值。6.3 数值格式的选择
输出的是未经任何处理的原始12位计数,范围 -2048 ~ +2047。这个选择需要解释清楚。有些人会想"加速度值不是应该换算成g或者m/s²吗"。不换算的理由有三:可以看出来进行连续打印:

我要赚赏金
