正确映射模拟器数据与显示输出

把完整链路写出来

将流程分成五步：数据源 → 收到的数值 → 含义换算 → 输出规则 → 实体或屏幕结果。为每一步写出可观察的内容。这样才能区分错误已经存在于原始数据，还是直到格式化显示才出现。

从一个清楚可见的功能开始，在模拟器中建立可重复场景，不要同时改变多个控制器和运行状态。本地 LED 测试证明输出硬件工作，而一个看似合理的原始值并不能证明整体映射正确。逐层比较才能把两部分证据连接起来。

区分输入、状态和事件

输入用于请求动作，遥测用于报告模拟器实际提供的信息。因此，指示灯应尽可能跟随已确认状态，而不只是跟随最后一次按键请求。指令在当前情境中可能没有效果，也可能具有不同含义。

状态会持续到发生改变或失去有效性。事件表示一次发生的动作。数值还需要单位和范围。不能把它们当作同一种内容处理：持续为真的状态不应在每个数据包到达时触发一次新按键，一次性事件也不应未经规则就变成永久点亮。

为每项功能保留完整映射表

设计时自拟字段名可以帮助思考，但必须明确它不是实际 API 标识。不要因为名称相似，就复制 DCS 标识、BMS 位掩码或其他模拟器变量。同名内容的含义可能随飞机、适配器和版本变化。

使用结果可核对的概念示例

假设已确认的数据源输出米每秒，而仪表需要千米每小时，则 km/h = m/s × 3.6。测试输入 25 m/s 应得到 90 km/h，0 m/s 应得到 0 km/h。这只是自行设计的计算示例，并不宣称某个 Cockpit Suite 字段采用该单位。

如果图形刻度将 0–180 km/h 映射到 0–100%，那么 90 / 180 × 100 = 50%。分别检查最小、中间和最大值。对超出范围的输入，明确选择标记异常、限制输出或改变量程。指针被限制在端点，不应悄悄掩盖无效输入。

尽量只在最终显示时舍入。重复换算或丢失符号，在少数数值下也可能看起来合理，因此只测一个正常工作值并不充分。遥测章节可以帮助你在选择公式前先确认来源。

自行编写 Arduino 固件时，还要注意数据类型：map() 使用整数运算，会截去小数部分，而且不会自动把结果限制在目标范围内。请核对所用函数的这些行为；这不是对 Cockpit Suite 内部实现的描述。

明确条件与阈值

警告可能同时依赖测量值和已确认运行状态。先用普通语言写规则：“数值达到条件，且相关系统处于激活状态时，开启指示灯。”还应先确认数据源是否已经提供完整警告状态，自己重算不一定更准确。

一个纯概念示例是：数值上升到 80 时点亮，下降到 78 以下时熄灭。两个阈值形成迟滞，避免临界点附近反复切换。这不是任何实际车辆或警告系统的阈值。还要定义初始状态，以及恰好等于边界值时的行为。延迟与平滑不能在不知情的情况下吞掉重要变化。

把零、缺失和过期分开

零可能是有效数值；数据缺失则意味着无法可靠判断。最后一次有效值也可能已经过期。分别定义启动、暂停、断线与恢复时的表现。中性提示或明确无效状态，往往比看似实时的数字更容易理解。

如果有时间戳，应选择适合当前应用的时效标准。统一超时值不能适用于全部数据源。记录暂停期间是否继续更新，以及这些数据的含义是否保持不变。重连时不能意外重放旧按键，而显示状态应根据当前信息重新建立。

选择正确模拟器与配置组合

共同软件减少重复工作，但不能替代匹配的数据源。Cockpit Suite 已有 Falcon BMS 与 DCS F-16C 可用集成；War Thunder、ETS2 和 ATS 为 Beta，LS25 正在开发。MSFS 与 X-Plane 没有可用适配器。其他项目示例不能作为 Cockpit Suite 增加支持范围的证据。

按模拟器、车辆或飞机以及用途命名配置。把映射移到另一模型之前，先重新核对。外观相似的驾驶舱可能提供不同数据。清楚分开的配置与可追溯来源，可以让多个模拟器共用软件，同时保持各自含义准确。

比较预期值与实际值

1. 用固定图案本地测试输出，并明确标识目标。
2. 观察未经换算的已确认原始值，对照文档核查含义。
3. 把可控的最小、中间、最大及无效输入送入自己的换算过程。
4. 分别及组合检查条件，包括精确边界与变化方向。
5. 在模拟器中受控改变同一功能，对照原始值、计算结果与输出。
6. 检查启动、暂停、断线、恢复和配置切换，保存预期/实际结果及版本。

这些是检查计划，不是已经完成硬件实测的声明。某阶段失败时，先检查它自身的输入输出，不要同时修改固件、公式与模拟器配置。

从典型现象追查原因

固定倍数偏差可能来自单位或缩放错误。整体平移可能与偏移量有关。灯光逻辑相反时，应分别核查状态含义与电气输出极性。阈值抖动需要检查数据、规则和预期反应。显示冻结时应先检查更新情况，而不是提高亮度。

当来源有依据、公式可解释，而且计划中的正常与异常场景都得到清楚状态，第一项映射才算完成。论坛求助时请提供原始值、预期结果、实际输出与版本。我们尽量在当天提供帮助。欧洲和国际社区分享的可核对示例，能清楚展示哪些功能已经可用，以及这个年轻项目可以如何共同向前推进。

继续检查下一层