STM32 串口 SDK#

用独立 C99 解码器接收 Neo MAVLink 2 位姿,再按自己的 STM32 工程接入 UART。

获取与接线#

在 统一 SDK 接入 下载并解压。SDK/stm32/neo_mavlink.c/h 无 HAL 依赖、无堆分配; SDK/stm32/examples/neo_uart.c/h 是 Cube HAL 适配,不是特定芯片的完整可烧录工程。

只读 UART 接线#

Neo 扩展端子

STM32 / 电源连接

U13-3 · UART_TX

STM32 UART_RX,3.3 V TTL

U13-4 · UART_RX

只读示例不需要连接;双向时接 STM32 UART_TX

U13-5 · GND

STM32 GND 与独立电源负极共地

U13-6 · 供电端

按对应硬件版本供电,不接 GPIO 或 3.3 V 信号端

U13-1 / U13-2

本例不接

完整引脚图与电源注意事项见 串口接线;不得接 RS-232 或 5 V 信号。 在设备网页核对波特率(默认 921600)、8N1、无流控,退出飞控搜索并启动 VIO。 默认发送 system_id=1、component_id=197;修改过身份时同步 NEO_SYSTEM_ID / NEO_COMPONENT_ID。

加入 CubeMX / HAL 工程#

  1. 添加 neo_mavlink.c/h 和 examples/neo_uart.c/h 到源文件及头文件搜索路径。

  2. 配置 UART AF 引脚、时钟、NVIC 与匹配波特率;main.h 提供 HAL UART 类型和 CMSIS 屏障。

  3. UART 初始化后调用 neo_uart_start(&huartX),检查 HAL_OK。

  4. 主循环频繁调用 neo_uart_poll();neo_uart_latest(&sample) 返回 1 才使用当前结果。

  5. 已有 HAL_UART_RxCpltCallback / HAL_UART_ErrorCallback 时合并分支,不能重复定义回调。

neo_odometry_t sample;
if (neo_uart_start(&huart2) != HAL_OK) Error_Handler();
while (1) {
    neo_uart_poll();
    if (neo_uart_latest(&sample)) {
        consume_odometry(&sample);
    }
}

huart2 和 consume_odometry 是接收端工程示意,需替换成自己的 UART 句柄和业务函数, 不是 Neo 板端串口配置接口。中断只入队;不要在回调中打印或阻塞。 1 KiB 环形缓冲在持续满速输入下约 11 ms 填满,正式工程推荐 DMA+IDLE,继续复用 neo_mavlink_feed。

解码 API#

直接来自 SDK/stm32/neo_mavlink.h#
#ifndef NEO_MAVLINK_H
#define NEO_MAVLINK_H
#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
    uint64_t time_usec;
    float position[3];
    float quaternion_wxyz[4];
    float linear_velocity[3];
    float angular_velocity[3];
    uint8_t system_id;
    uint8_t component_id;
    uint8_t frame_id;
    uint8_t child_frame_id;
    uint8_t reset_counter;
    uint8_t estimator_type;
    int8_t quality;
} neo_odometry_t;

typedef struct {
    uint8_t bytes[280];
    uint16_t used;
    uint16_t expected;
} neo_mavlink_parser_t;

void neo_mavlink_reset(neo_mavlink_parser_t *parser);
int neo_mavlink_feed(neo_mavlink_parser_t *parser, uint8_t byte, neo_odometry_t *output);

#ifdef __cplusplus
}
#endif
#endif

独立使用时先 neo_mavlink_reset(&parser),对每字节调用 neo_mavlink_feed(&parser, byte, &sample)。 返回 1 代表本条有效 ODOMETRY;返回 0 不交付新位姿,不把心跳当定位结果。 HAL 示例默认筛选来源身份,独立解析器的调用者需自己筛选。

字段与安全边界#

  • 只接受无签名 MAVLink 2 ODOMETRY,ID 331、CRC extra 91、payload 230–233 字节;不支持签名认证,CRC 也不是安全认证。

  • 位置 m、速度 m/s、角速度 rad/s、时间 us,四元数为 w/x/y/z;frame_id / child_frame_id 解释安装补偿后的实际帧,不重复补偿。

  • 校验有限数、四元数和质量;quality=0 表示未知,quality=-1 不作为 HAL 有效结果。

  • 半包 20 ms 无字节清除;溢出/硬件错误清空并重启接收;250 ms 没有新里程计则失效。

  • latest 可能返回同一条结果,应用用 time_usec 去重;时间倒退或 reset_counter 变化需重置上层融合。

  • 不对外提供 covariance;不发送飞控配置、起飞、解锁或控制命令,不提供闭环安全保证。

主机已联测现有生产 MAVLink 编码器、HAL 桩、缓冲和 SDK 解码器;真实 STM32 型号、 供电、引脚、时钟与中断仍需实测,不把主机回归当作烧录验收。

电脑串口接收见 通过串口获取 VIO 位姿;飞控接入见 接入飞控。