单片机与物联网 / 系统课时

实现串口监控协议

实现串口监控协议

本课为综合项目增加可调试、可扩展的串口监控通道。完成后,设备能够解析带校验的命令帧,返回实时数据和配置,安全修改参数,按需周期上报,并对格式、校验和命令错误给出稳定响应。

学习目标

  • 设计包含帧边界、序号、命令、参数和校验值的文本协议。
  • 分离接收组帧、命令执行、响应编码和周期上报。
  • 为格式错误、校验失败和非法命令定义机器可读的响应。

帧结构与数据路径

本课使用 @payload*CS 作为最小文本帧。@ 是帧头,* 结束负载,CS 是两位十六进制异或校验。UART 传输时可在末尾追加 CRLF,接收器在获得完整行后再提交解析,校验范围只覆盖 payload。

串口协议接收、命令分发与周期上报流程

负载 作用
1,GET,STATUS 查询当前测量值
2,SET,HIGH,32.5 修改上限阈值
3,GET,CONFIG 查询当前配置
4,STREAM,ON 开启周期上报

首字段是请求序号,响应应原样返回,使上位机能够匹配请求和结果。周期数据不对应某次请求,本课使用序号 0 和类型 DATA 区分。

解析与错误处理

接收中断只负责把字节放入环形缓冲区,不执行字符串解析、Flash 写入或长时间格式化。通信任务取得完整帧后,依次检查帧头、分隔符、长度和校验值,全部通过后才拆分字段并执行命令。

FORMAT 表示帧边界或字段结构错误,CHECKSUM 表示传输内容损坏,VALUE 表示数值无法完整解析,RANGE 表示数值违反业务边界,COMMAND 表示命令不受支持。损坏帧不能产生参数修改等副作用。

完整可运行示例

下面的 C11 程序构造并解析固定命令序列,覆盖状态查询、参数修改、配置查询、实时上报和校验错误。它不依赖串口硬件,可先验证协议规则,再把输入源替换为 UART 接收缓冲区。

c
#include <ctype.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define CAPACITY 128

typedef struct {
    float value;
    float low;
    float high;
    int streamOn;
} Device;

/* 校验范围固定为 @ 与 * 之间的 payload,收发两端必须一致。 */
static unsigned char checksum(const char *payload) {
    unsigned char value = 0U;
    while (*payload != '\0') value ^= (unsigned char)*payload++;
    return value;
}

static void make_frame(const char *payload, char frame[CAPACITY]) {
    (void)snprintf(frame, CAPACITY, "@%s*%02X", payload, checksum(payload));
}

static int hex_digit(char ch) {
    if (ch >= '0' && ch <= '9') return ch - '0';
    ch = (char)toupper((unsigned char)ch);
    return ch >= 'A' && ch <= 'F' ? ch - 'A' + 10 : -1;
}

/* 先验证边界与校验值,再把 payload 交给命令分发层。 */
static int parse_frame(const char *frame, char payload[CAPACITY]) {
    const char *star = strrchr(frame, '*');
    if (frame[0] != '@' || star == NULL || star[3] != '\0') return 0;
    int high = hex_digit(star[1]);
    int low = hex_digit(star[2]);
    size_t length = (size_t)(star - frame - 1);
    if (high < 0 || low < 0 || length == 0U || length >= CAPACITY) return 0;
    memcpy(payload, frame + 1, length);
    payload[length] = '\0';
    return checksum(payload) == (unsigned char)((high << 4) | low) ? 1 : -1;
}

static void send_payload(const char *payload) {
    char frame[CAPACITY];
    make_frame(payload, frame);
    printf("TX %s\n", frame);
}

/* 命令层只在完整校验通过后修改设备状态并生成响应。 */
static void handle(Device *device, const char *frame) {
    char payload[CAPACITY];
    char response[CAPACITY];
    printf("RX %s\n", frame);

    int parsed = parse_frame(frame, payload);
    if (parsed == -1) {
        send_payload("0,ERR,CHECKSUM");
        return;
    }
    if (parsed == 0) {
        send_payload("0,ERR,FORMAT");
        return;
    }

    char *seq = strtok(payload, ",");
    char *cmd = strtok(NULL, ",");
    char *arg1 = strtok(NULL, ",");
    char *arg2 = strtok(NULL, ",");
    if (seq == NULL || cmd == NULL || arg1 == NULL) {
        send_payload("0,ERR,FORMAT");
        return;
    }

    if (strcmp(cmd, "GET") == 0 && strcmp(arg1, "STATUS") == 0) {
        (void)snprintf(response, CAPACITY, "%s,OK,VALUE=%.1f", seq, device->value);
    } else if (strcmp(cmd, "GET") == 0 && strcmp(arg1, "CONFIG") == 0) {
        (void)snprintf(response, CAPACITY, "%s,OK,LOW=%.1f,HIGH=%.1f",
                       seq, device->low, device->high);
    } else if (strcmp(cmd, "STREAM") == 0 && strcmp(arg1, "ON") == 0) {
        device->streamOn = 1;
        (void)snprintf(response, CAPACITY, "%s,OK,STREAM=ON", seq);
    } else if (strcmp(cmd, "SET") == 0 && strcmp(arg1, "HIGH") == 0 && arg2 != NULL) {
        char *end = NULL;
        float highValue = strtof(arg2, &end);
        if (*arg2 == '\0' || *end != '\0') {
            (void)snprintf(response, CAPACITY, "%s,ERR,VALUE", seq);
        } else if (highValue <= device->low) {
            (void)snprintf(response, CAPACITY, "%s,ERR,RANGE", seq);
        } else {
            device->high = highValue;
            (void)snprintf(response, CAPACITY, "%s,OK,HIGH=%.1f", seq, highValue);
        }
    } else {
        (void)snprintf(response, CAPACITY, "%s,ERR,COMMAND", seq);
    }
    send_payload(response);
}

int main(void) {
    Device device = {24.6F, 20.0F, 30.0F, 0};
    /* 固定命令序列覆盖查询、修改、上报开启和校验失败。 */
    const char *commands[] = {
        "1,GET,STATUS",
        "2,SET,HIGH,32.5",
        "3,GET,CONFIG",
        "4,STREAM,ON"
    };

    for (size_t i = 0; i < 4U; ++i) {
        char frame[CAPACITY];
        make_frame(commands[i], frame);
        handle(&device, frame);
    }
    if (device.streamOn) send_payload("0,DATA,VALUE=24.6");
    handle(&device, "@5,GET,STATUS*00");
    return 0;
}

编译并运行:

bash
gcc -std=c11 -Wall -Wextra -pedantic serial_protocol_demo.c -o serial_protocol_demo
./serial_protocol_demo

预期输出:

text
RX @1,GET,STATUS*73
TX @1,OK,VALUE=24.6*5D
RX @2,SET,HIGH,32.5*48
TX @2,OK,HIGH=32.5*1F
RX @3,GET,CONFIG*6F
TX @3,OK,LOW=20.0,HIGH=32.5*47
RX @4,STREAM,ON*29
TX @4,OK,STREAM=ON*10
TX @0,DATA,VALUE=24.6*48
RX @5,GET,STATUS*00
TX @0,ERR,CHECKSUM*78

工程验收与练习

上板验收时,先核对波特率、8N1 和换行规则,再连续发送多帧验证边界恢复;开启周期上报后并发查询配置,确认发送队列不会把响应帧和数据帧交叉。参数修改成功后,应调用上一课的可靠存储接口提交新配置。

练习一:增加 STREAM,OFF 和 GET,VERSION,要求所有响应保留请求序号,未知参数返回 ERR,COMMAND。

练习二:把异或校验替换为 CRC16-CCITT,并增加最大帧长。验收条件是截断帧、超长帧和单字节翻转帧都不改变设备配置。

本课总结

  • 串口协议应先明确帧边界与校验范围,再定义业务命令。
  • 接收、解析、执行和发送分层可以避免中断阻塞与帧交错。
  • 请求序号和稳定错误码能显著提高上位机定位问题的效率。

下一课预告

下一阶段将把报警存储与串口监控合并到完整固件中,通过异常注入、长时间运行和断电重启验证数据一致性与故障恢复能力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现串口监控协议

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通