北达斯港口

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

接触点

一个完整的端口跨越六个文件和一个前端 + 一个文档更新:dotnet/src/FlightJar.Decoder/ModeS/CommB.cs - 添加 IsBdsXX(payload) 验证器 + DecodeBdsXX(payload) 解码器 + BdsXXData 记录。扩展Candidates记录和Infer()以包含新寄存器。

第 2 步 — 移植验证器 + 解码器

pyModeS 在 56 位有效负载上作为具有 (payload >> (55 - i)) & mask 索引的 Python int 运行(从有效负载位 0 开始,MSB 优先)。 C# 端口保持相同的位索引,因此移植的算术与 Python 一对一地读取。在 CommB.cs 的 public static class CommB 中添加新方法。使用CommB.cs中已有的帮助器:

步骤 4 — 扩展状态 + 快照

对于每个解码字段:将可为空的属性添加到Aircraft(例如public int? WindshearLevel { get; set; })。将同名属性添加到SnapshotCommB。在ApplyCommB中,添加一个从DecodedMessage分配的case "X,Y":;不要触及其他寄存器中的字段

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@MrSuttonmann · GPL-3.0
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步 — 获取 pyModeS 参考

pyModeS 位于 GitHub 上的`junzis/pyModeS`(默认分支`main`)。 BDS解码器位于`src/pyModeS/decoder/bds/bdsXX.py`下,助手位于`_helpers.py`下。通过 GitHub API 获取`/tmp/pymodes/`(原始 CDN 有时 404 秒;内容 API 可靠):

02
第 2 步 — 移植验证器 + 解码器

pyModeS 在 56 位有效负载上作为具有 `(payload >> (55 - i)) & mask` 索引的 Python int 运行(从有效负载位 0 开始,MSB 优先)。 C# 端口保持相同的位索引,因此移植的算术与 Python 一对一地读取。将您的新方法添加到`CommB.cs`中的`public static class CommB`中。使用`CommB.cs`中已有的帮助器:

03
第 3 步 — 连接到推理

`CommB.Infer(payload)` 返回一条 `Candidates` 记录,每个启发式寄存器包含一个布尔值。仅当只有一个候选者验证时,`MessageDecoder.InferCommB(msg)`才返回解码的消息。这种单场比赛的规则是有意为之的:多场比赛的有效载荷是不明确的并被丢弃,而不是冒着解码字段污染飞机状态的风险

04
步骤 4 — 扩展状态 + 快照

对于每个解码字段:向 `Aircraft` 添加可为 null 的属性(例如 `public int? WindshearLevel { get; set; }`)。将同名属性添加到`SnapshotCommB`。在`ApplyCommB`中,添加一个从`DecodedMessage`分配的`case "X,Y":`;不要触及其他寄存器中的字段

05
第 5 步 — 扩展前端面板

增强模式S面板完全由快照中的`a.comm_b`驱动。在 `detail_panel.js` 中:在 `buildPopupContent` 中的 `.panel-met-grid` 内添加占位符图块标记 — 与现有图块 (`<div class="metric pop-met-xxx" hidden><div class="label">…</div><div class="val"></div></div>`) 的形状相同。

06
第 6 步 — 测试

`CommBTests.cs` 遵循两种模式;将两者用于新寄存器:验证器接受+拒绝:从 pyModeS 的`test_bds_commb.py`中选择一个黄金向量十六进制,断言`IsBdsXX`接受它,然后构造应被拒绝的合成有效负载(全零,超出范围的值,状态位/值位不一致)

07
第 7 步 — 添加集成测试

`dotnet/tests/FlightJar.Core.Tests/State/AircraftRegistryTests.cs` + `FakeDecoder.cs` 使用假六角键(`BD44`→预建`DecodedMessage`)来练习`ApplyCommB` + `BuildCommBSnapshot`,无需真正的线字节。添加一个`BDxx`装置和测试,证明新字段落在快照中并正确老化过去的`CommBMaxAge`。

08
第 8 步——剧作家抽烟(可选)

`tests/e2e/layout.spec.js`中的`detail panel renders Enhanced Mode S section when comm_b is present`测试注入了带有完整`comm_b`块的虚假快照。如果新寄存器添加了用户可见的图块,则扩展固定装置并断言新标签出现。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。