押题三：串口综合控制终端

插入位置：在 command()函数开头、现有 REPORT判断之前加入：

if (strcmp(command, "PING") == 0) {
    if (arguments != nullptr && *arguments != '\0') {
        app.emit("ERR USAGE PING");
    } else {
        app.emit("OK PONG");
    }
    return true;
}

再把 printHelp()中的提示改成包含 PING，否则功能存在但 HELP 看不到。

1. 在文件顶部 #include <cstring>下一行加入：

#include <cstdlib>

2. 在 command()返回 false之前加入：

if (strcmp(command, "RATE") == 0) {
    char *end = nullptr;
    const long value = arguments == nullptr
        ? -1 : strtol(arguments, &end, 10);
    while (end != nullptr && (*end == ' ' || *end == '\t')) ++end;
    const bool valid_number = arguments != nullptr &&
        end != arguments && end != nullptr && *end == '\0';

    if (!valid_number || value < 100 || value > 60000) {
        app.emit("ERR USAGE RATE <100..60000>");
    } else {
        app.config().report_ms = static_cast<uint32_t>(value);
        app.emit("OK RATE_MS=%ld", value);
    }
    return true;
}

需要掉电保存时，设置后再发送 SAVE。不要在每次命令中自动写 NVS，频繁写入会降低 Flash 寿命。

假设上位机要求固定字段：REPORT,毫伏,触摸,按键,模式。

替换范围：完整替换 emitReport()。

void emitReport(contest::ContestApp &app) {
    app.emit("REPORT,%lu,%lu,%u,%u",
             static_cast<unsigned long>(app.adcMillivolts()),
             static_cast<unsigned long>(app.touchRaw()),
             app.buttonPressed() ? 1U : 0U,
             app.config().mode);
}

字段顺序必须按任务书：上位机按逗号拆分时，多一个空格、少一个字段或顺序不同都可能扣分。

1. 在全局变量区加入：

uint8_t last_reported_mode = 255;

2. 在 beginTask()末尾加入：

last_reported_mode = 255;

3. 把 tick()末尾原来的周期判断替换为：

if (app.config().mode != last_reported_mode) {
    last_reported_mode = app.config().mode;
    emitReport(app);
}

这种写法不会在 ADC 值变化时上报；如果题目要求“任何字段变化都上报”，还需要分别保存并比较上一次 ADC、Touch 和按键值。