小龙虾
f9cbcc396b
- 新增 `lastWorkerExecUs()`：获取最近一次 worker 任务执行耗时（µs）。 - 引入 `SpiProfile` 结构体：事务级详细剖析，记录 SPI 事务各阶段的时间戳。 - 实现 `lastProfile()`：诊断用，获取最近一次事务剖析快照。 - SPI 时钟配置提升至 13.3 MHz，改善性能。 - 修改前端 JavaScript 轮询逻辑：新增 uptime 检查，更好地处理 ESP32 重启状态。 - SPI 测速 HTML 的计时单位由毫秒改为微秒显示。 - 新建 `spi_ring_cache.h`：共享 SPI ring push 缓存工具。 - 新增 `http_util.h`：共享 HTTP 处理器工具，含 JSON 拼接与查询参数解析。 - 引入 `json_parse.h`：轻量级 JSON 解析器，针对扁平 JSON 对象设计。 - 新增 Windows 环境下的项目构建批处理脚本。 - 重构 CAN 反馈处理：从推送式改为请求驱动架构，降低内存占用、提升效率。
182 lines
8.6 KiB
C++
182 lines
8.6 KiB
C++
/**
|
||
* @file spi_speed_test.cpp
|
||
* @brief 【临时功能 SPI-SPEEDTEST】SPI 链路测速端点 GET /spi/speedtest
|
||
*
|
||
* 用 0xA1 APP PING（无副作用、GD32 在 onCsRelease ISR 内 µs 级应答）作探针，
|
||
* 经 SpiMaster::transact() 走与业务完全相同的 worker 串行路径，
|
||
* 测量事件驱动握手（ready 下降沿唤醒）下的真实 RTT 与等效吞吐。
|
||
*
|
||
* 用法:
|
||
* GET /spi/speedtest # 默认 200 帧 × 236B payload
|
||
* GET /spi/speedtest?frames=500&payload=0 # 500 帧空载（纯 RTT）
|
||
* 返回中文纯文本: 帧数/成功/失败、总耗时、往返延迟 平均/最快/最慢、等效吞吐
|
||
*
|
||
* ── 删除本临时功能的步骤（共 3 处挂接点，全部以 [SPI-SPEEDTEST] 标记）──
|
||
* 1. 删除本文件与 monitor/spi_speed_test.h
|
||
* 2. main/CMakeLists.txt 删除 "monitor/spi_speed_test.cpp" 一行
|
||
* 3. server/wifi_ota.cpp 删除 include 与 kHttpRoutes 中各一行
|
||
* （spi_master.cpp 中 0xA1 零盲等白名单为正式优化，保留不删）
|
||
*/
|
||
#include "spi_speed_test.h"
|
||
|
||
#include <string.h>
|
||
#include <stdio.h>
|
||
#include <stdlib.h>
|
||
|
||
#include "esp_timer.h"
|
||
#include "spi_master.h"
|
||
#include "http_handlers.h" /* http_set_cors_headers */
|
||
#include "server/http_util.h"
|
||
#include "monitor/debug_log.h"
|
||
|
||
namespace {
|
||
|
||
constexpr uint8_t kProbeType = 0xA1U; /* APP PING：无副作用探针 */
|
||
constexpr uint32_t kFramesDefault = 200U;
|
||
constexpr uint32_t kFramesMax = 2000U; /* ~3s 上限，避免占死 HTTP/worker */
|
||
constexpr size_t kPayloadDefault = 236U; /* 满帧：等效 0xD1 电机 OTA 数据节奏 */
|
||
constexpr size_t kPayloadMax = 236U; /* APP kTxBufSize=256 - V2_OVERHEAD */
|
||
constexpr uint32_t kFrameTimeoutMs = 500U;
|
||
|
||
} // namespace
|
||
|
||
esp_err_t spi_speedtest_handler(httpd_req_t *req)
|
||
{
|
||
uint32_t frames = http_query_u32(req, "frames", kFramesDefault);
|
||
if (frames < 1U) { frames = 1U; }
|
||
if (frames > kFramesMax) { frames = kFramesMax; }
|
||
size_t payload_len = (size_t)http_query_u32(req, "payload", (uint32_t)kPayloadDefault);
|
||
if (payload_len > kPayloadMax) { payload_len = kPayloadMax; }
|
||
|
||
/* 探针 payload：递增填充（CRC32 覆盖，顺带校验数据路径完整性） */
|
||
uint8_t probe[kPayloadMax];
|
||
for (size_t i = 0; i < payload_len; ++i) {
|
||
probe[i] = (uint8_t)i;
|
||
}
|
||
|
||
uint32_t n_ok = 0U;
|
||
uint32_t n_fail = 0U;
|
||
uint64_t rtt_sum_us = 0U;
|
||
uint64_t rtt_min_us = UINT64_MAX;
|
||
uint64_t rtt_max_us = 0U;
|
||
/* RTT 分布直方图（µs 计时，<2ms 区间细化为 0.5ms 粒度）：
|
||
* <0.5 / 0.5-1 / 1-1.5 / 1.5-2 / 2-3 / 3-5 / >=5 ms，
|
||
* 用于判断抖动形态（<2ms 内的尖峰/双峰 vs 离散 +1ms 碰撞） */
|
||
uint32_t histo[7] = {0U, 0U, 0U, 0U, 0U, 0U, 0U};
|
||
/* 事务耗时（worker 内执行段，SpiMaster::lastWorkerExecUs）与
|
||
* 调度/唤醒开销（RTT − 事务）拆解：事务慢=GD32 应答/SPI 时序；
|
||
* 调度慢=ESP32 任务抢占（WiFi/esp_timer 等）。 */
|
||
uint64_t w_sum_us = 0U, w_min_us = UINT64_MAX, w_max_us = 0U;
|
||
uint64_t s_sum_us = 0U, s_min_us = UINT64_MAX, s_max_us = 0U;
|
||
/* 5 段细分（SpiMaster::SpiProfile）：提交/调度、发送帧、等应答、读响应、唤醒 */
|
||
uint64_t seg_sum[5] = {0U, 0U, 0U, 0U, 0U};
|
||
uint64_t seg_max[5] = {0U, 0U, 0U, 0U, 0U};
|
||
|
||
DEBUG_INFO("SPI", "[SPEEDTEST] start frames=%u payload=%u",
|
||
(unsigned)frames, (unsigned)payload_len);
|
||
const int64_t t_start = esp_timer_get_time();
|
||
|
||
for (uint32_t i = 0U; i < frames; ++i) {
|
||
uint8_t resp_type = 0U;
|
||
uint8_t resp_payload[64];
|
||
size_t resp_len = 0U;
|
||
|
||
const int64_t t0 = esp_timer_get_time();
|
||
const esp_err_t ret = SpiMaster::instance().transact(
|
||
kProbeType, probe, payload_len,
|
||
&resp_type, resp_payload, sizeof(resp_payload), &resp_len,
|
||
kFrameTimeoutMs);
|
||
const int64_t t1 = esp_timer_get_time();
|
||
|
||
if (ret == ESP_OK && resp_type == 0x80U) {
|
||
const uint64_t rtt = (uint64_t)(t1 - t0);
|
||
++n_ok;
|
||
rtt_sum_us += rtt;
|
||
if (rtt < rtt_min_us) { rtt_min_us = rtt; }
|
||
if (rtt > rtt_max_us) { rtt_max_us = rtt; }
|
||
const uint64_t wus = SpiMaster::instance().lastWorkerExecUs();
|
||
const uint64_t sus = (rtt > wus) ? (rtt - wus) : 0U;
|
||
w_sum_us += wus;
|
||
if (wus < w_min_us) { w_min_us = wus; }
|
||
if (wus > w_max_us) { w_max_us = wus; }
|
||
s_sum_us += sus;
|
||
if (sus < s_min_us) { s_min_us = sus; }
|
||
if (sus > s_max_us) { s_max_us = sus; }
|
||
/* 5 段细分（防回绕钳 0） */
|
||
const SpiMaster::SpiProfile &pf = SpiMaster::instance().lastProfile();
|
||
const uint64_t seg[5] = {
|
||
(pf.t_w0 > pf.t_submit0) ? (pf.t_w0 - pf.t_submit0) : 0U,
|
||
(pf.t_send1 > pf.t_send0) ? (pf.t_send1 - pf.t_send0) : 0U,
|
||
(pf.t_wait1 > pf.t_wait0) ? (pf.t_wait1 - pf.t_wait0) : 0U,
|
||
(pf.t_read1 > pf.t_wait1) ? (pf.t_read1 - pf.t_wait1) : 0U,
|
||
(pf.t_submit1 > pf.t_w1) ? (pf.t_submit1 - pf.t_w1) : 0U,
|
||
};
|
||
for (int k = 0; k < 5; ++k) {
|
||
seg_sum[k] += seg[k];
|
||
if (seg[k] > seg_max[k]) { seg_max[k] = seg[k]; }
|
||
}
|
||
if (rtt < 500U) { ++histo[0]; }
|
||
else if (rtt < 1000U) { ++histo[1]; }
|
||
else if (rtt < 1500U) { ++histo[2]; }
|
||
else if (rtt < 2000U) { ++histo[3]; }
|
||
else if (rtt < 3000U) { ++histo[4]; }
|
||
else if (rtt < 5000U) { ++histo[5]; }
|
||
else { ++histo[6]; }
|
||
} else {
|
||
++n_fail;
|
||
}
|
||
}
|
||
|
||
const int64_t elapsed_us = esp_timer_get_time() - t_start;
|
||
const uint32_t elapsed_ms = (uint32_t)(elapsed_us / 1000);
|
||
const uint64_t rtt_avg_us = (n_ok > 0U) ? (rtt_sum_us / n_ok) : 0U;
|
||
/* 吞吐语义：payload 字节 / 完整"发送+应答"周期，等效 0xD1 单缓冲喂速上限 */
|
||
double tput_kbps = 0.0;
|
||
if (elapsed_us > 0 && n_ok > 0U) {
|
||
tput_kbps = ((double)n_ok * (double)payload_len) / ((double)elapsed_us / 1000000.0) / 1024.0;
|
||
}
|
||
if (rtt_min_us == UINT64_MAX) { rtt_min_us = 0U; }
|
||
if (w_min_us == UINT64_MAX) { w_min_us = 0U; }
|
||
if (s_min_us == UINT64_MAX) { s_min_us = 0U; }
|
||
|
||
DEBUG_INFO("SPI", "[SPEEDTEST] done ok=%u fail=%u avg=%uus tput=%.1fKB/s",
|
||
(unsigned)n_ok, (unsigned)n_fail, (unsigned)rtt_avg_us, tput_kbps);
|
||
|
||
char text[640];
|
||
const int len = snprintf(text, sizeof(text),
|
||
"SPI 测速结果\n"
|
||
"帧数: %u 成功: %u 失败: %u%s\n"
|
||
"载荷: %u B/帧 总耗时: %u ms\n"
|
||
"往返延迟: 平均 %llu µs 最快 %llu µs 最慢 %llu µs\n"
|
||
"SPI 事务: 平均 %llu µs 最快 %llu µs 最慢 %llu µs\n"
|
||
"调度开销: 平均 %llu µs 最快 %llu µs 最慢 %llu µs\n"
|
||
"单帧分段 平均: 提交/调度 %llu | 发送帧 %llu | 等应答 %llu | 读响应 %llu | 唤醒 %llu µs\n"
|
||
"单帧分段 最慢: 提交/调度 %llu | 发送帧 %llu | 等应答 %llu | 读响应 %llu | 唤醒 %llu µs\n"
|
||
"延迟分布: <0.5ms:%u 0.5-1ms:%u 1-1.5ms:%u 1.5-2ms:%u 2-3ms:%u 3-5ms:%u >=5ms:%u\n"
|
||
"等效吞吐: %.1f KB/s\n",
|
||
(unsigned)frames, (unsigned)n_ok, (unsigned)n_fail,
|
||
(n_fail > 0U) ? " <-- 存在失败帧, 链路异常!" : "",
|
||
(unsigned)payload_len, (unsigned)elapsed_ms,
|
||
(unsigned long long)rtt_avg_us, (unsigned long long)rtt_min_us,
|
||
(unsigned long long)rtt_max_us,
|
||
(unsigned long long)(w_sum_us / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)w_min_us, (unsigned long long)w_max_us,
|
||
(unsigned long long)(s_sum_us / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)s_min_us, (unsigned long long)s_max_us,
|
||
(unsigned long long)(seg_sum[0] / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)(seg_sum[1] / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)(seg_sum[2] / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)(seg_sum[3] / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)(seg_sum[4] / (n_ok > 0U ? n_ok : 1U)),
|
||
(unsigned long long)seg_max[0], (unsigned long long)seg_max[1],
|
||
(unsigned long long)seg_max[2], (unsigned long long)seg_max[3],
|
||
(unsigned long long)seg_max[4],
|
||
(unsigned)histo[0], (unsigned)histo[1], (unsigned)histo[2],
|
||
(unsigned)histo[3], (unsigned)histo[4],
|
||
(unsigned)histo[5], (unsigned)histo[6], tput_kbps);
|
||
|
||
http_set_cors_headers(req);
|
||
httpd_resp_set_type(req, "text/plain; charset=utf-8");
|
||
return httpd_resp_send(req, text, (len > 0) ? len : 0);
|
||
}
|