RuView 宽频 802.11ax CSI 数据接入基于 FeitCSI/AX210 的子载波无关管线架构ADR-292 实践指南【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView本文以 docs/adr/ADR-292-wideband-80211ax-csi-ingest.md 为骨架结合其在wifi-densepose-matcrate 中的 Rust 实现展开。它讲清楚三件事为什么 RuView 需要宽频114 子载波CSI 接入路径、FeitCSI 二进制记录格式如何被安全解析、以及原生子载波维度如何端到端保留并显式映射到下游管线宽度。读完你不仅能看懂这套设计的取舍还能直接据此用文件回放或外部进程流式两种方式把 AX200/AX210 的宽频数据喂进 RuView 管线。背景从 802.11n 时代的 ≤114 子载波到 802.11ax/11bf 的 160 MHz 宽频RuView 的 CSI 接入层位于 v2/crates/wifi-densepose-mat/src/integration/hardware_adapter.rs作为一层“防腐层”Anti-Corruption Layer统一把不同硬件的 CSI 转译为领域类型CsiReadings。在该决策之前它支持的三类硬件全部属于 802.11n 世代接入路径底层典型子载波数带宽上限ESP32 串行流ESP-CSI 固件ESP32依固件配置HT20 档约 56 量级20/40 MHzIntel 5300Linux CSI Tooliwlwifi netlink connector3020/40 MHzAtheros/Nexmonath9k/ath10k/ath11k 补丁驱动debugfs CSI 缓冲56 / 114 / 23440 MHzath11k 除外而 2026 年的研究扫描表明该领域的重心已经迁移到通过 PicoScenes核心闭源与 FeitCSI开源、GPL驱动 Intel AX200/AX210 网卡可拿到最高160 MHz 带宽 / 1992 个子载波、含 6 GHz 频段的 802.11ax CSI。这既是当前研究级档位的基线也是 2026 年起 802.11bf 芯片将产出的数据形态。RuView 的wifi-densepose-hardwarecrate 已经在协议层建模 802.11bf 会话类型见 v2/crates/wifi-densepose-hardware/src/ieee80211bf/types.rs但没有任何 ingest 路径能把宽频 CSI 真正送进管线——114 子载波的帧在既有落地上没有可用的通道。这带来三重后果正是 ADR-292 要解决的无法基于“当下可得的最好信号”做开发无法把 ESP32 档位的结果与宽频理论上限做横向对比面对 802.11bf 硅片时没有经过验证的 114 子载波帧的接入管道。方案权衡为什么选 FeitCSI 而非 PicoScenes 或裸 pcapADR-292 在决策前对三条技术路线做了明确权衡结论值得在接入类方案评审时复用PicoScenes.csi格式 —— 拒绝暂缓。该格式产自闭源核心版本化且复杂在没有持续维护的规范文档时自行解析等于拿“静默损坏”做赌注。裸 pcap radiotap 解析 —— 拒绝。这会在设备端重复 FeitCSI 已完成的解包工作还把包捕获依赖拉进管线。FeitCSI 文件/流 ingest —— 采纳。理由有四点FeitCSI 开源其头部布局可对照源码审计目标硬件明确为 AX200/AX210覆盖 20–160 MHz、含 6 GHz每帧输出一条紧凑的二进制记录。需要特别强调的是许可证策略FeitCSI 是 GPL 项目RuView只解析其输出格式永不链接、永不将其纳入编译产物——它始终作为外部工具使用。这一边界由代码注释明确声明见 feitcsi.rs 头部文档保证 MIT workspace 不受 GPL 污染。决策落地一feitcsi记录解析器解析器整体位于 v2/crates/wifi-densepose-mat/src/integration/feitcsi.rs并在 mod.rs 统一导出。二进制记录布局272 字节定长头 CSI 负载每条记录是packed 的 272 字节头 csiDataSize字节裸 CSI。头部布局依据 FeitCSI 源码master 2026-08-10的include/Csi.hRawHeaderData结构与Csi::save()逐字段核对要点是FeitCSI 运行于小端 x86 主机并直接倾倒原生结构体内存因此所有字段一律小端序。具体字段如下偏移大小字段说明04csiDataSizeu32头部之后 CSI 负载的字节数44reservedspace484ftmClocku32128timestampu64设备时间戳微秒2026reservedspace20461numRxu8接收天线数471numTxu8发射流数484reservedspace48524numSubCarriersu32564reservedspace54604rssi1u32天线 A RSSI644rssi2u32天线 B RSSI686srcMac源 MAC 地址7418reservedspace75924rateNflagu32iwlwifi rate flags96176reservedspace9644 × u32负载为交错的小端i16I/Q 对遍历顺序是for rx { for tx { for subcarrier { i16 real, i16 imag } } }即每个复数样本占 4 字节且恒等式成立csiDataSize numRx * numTx * numSubCarriers * 4rate flags从rateNflag解码调制类型与带宽rateNflag采用 FeitCSI 内置的 iwlwifi rate/flags 编码lib/include/rs.h解析器用位掩码提取两个子字段调制类型bits 8..11RATE_MCS_MOD_TYPE0CCK1legacy OFDM2HT3VHT4HE5EHT信道宽度bits 11..14RATE_MCS_CHAN_WIDTH020 MHz14028031604320。对应到 Rust 侧是FeitCsiModType与FeitCsiBandwidth两个枚举后者的mhz()返回物理带宽、to_bandwidth()映射到适配层Bandwidth枚举。320 MHzEHT被本版本解析器显式拒绝。“响亮地失败”没有魔数时的结构性版本校验该格式最大的坑是盘上格式没有任何魔数或版本字段——它本质就是 iwlwifi 通知头的裸内存。因此 ADR-292 要求的“版本检查”必须是结构性的且严格的体现在 validate_header 的校验顺序上维度字段为 0 → [FeitCsiError::ZeroDimension]维度超过硬上限 → [FeitCsiError::CapExceeded]声明的csiDataSize与维度乘积不符 → [FeitCsiError::DimensionMismatch]rateNflag落在既有编码之外未知调制类型或 320 MHz→ [FeitCsiError::UnsupportedFormat]拒绝猜测而不是误解析。所有输入都被当作不可信数据每次读取都做长度检查任何分配发生前先做边界约束畸形输入一律产出结构化错误绝不 panic。错误类型在 mod.rs 中被映射到AdapterErrorUnsupportedFormat→UnsupportedAdapter、I/O 错误透传、其余归类为DataFormat。有界分配对抗损坏长度字段宽度字段若被损坏可能诱发无界分配因此解析器设置了硬上限常量HEADER_LEN 272MAX_SUBCARRIERS 4096802.11ax 160 MHz HE 实际是 1992保留 4096 头寸以容纳未来 802.11bf 截断 CIR 形态MAX_ANTENNAS 8AX210 实际是 2x28 已很宽裕BYTES_PER_SAMPLE 4MAX_RECORD_BYTES HEADER_LEN 8 * 8 * 4096 * 4约 1 MiB 272同时作为流模式缓冲上界。由于 8×8×4096×4 ≈ 1 MiB 的乘积上限维度乘法在usize上不会溢出。校验在任何依据不可信字段定尺寸的分配之前完成。单次遍历解码与零分配转换decode_csi 用chunks_exact(4)把负载切成精确的 4 字节块逐样本i16::from_le_bytes后转f64构造Complex64由于调用方已对payload.len()做过校验collect只会发生一次有界分配转换循环本身零分配。解析入口 parse_record 返回(FeitCsiRecord, usize)含消费字节数支持调用方顺序遍历多记录捕获文件头部原地读取、负载直接从输入切片转换CSI 字节只被遍历一次。文件回放与流式读取两个读取器ADR-292 要求两条读取路径都能成立FeitCsiFileReader打开录制好的捕获文件做确定性顺序回放FeitCsiStreamReader对任意Read源文件、FIFO、管道包装逐条读取。两者的核心是内部共用的read_one_record_with_scratch它持有调用方拥有的可复用 scratch 缓冲长跑回放/流循环整条流只做一次有界原始字节分配外加每条记录一份VecComplex64输出而不是逐记录分配。中途 EOF 被归为Truncated而非干净的Ok(None)——干净的流结束只发生在两条记录之间读到 0 字节时。决策落地二适配器层的DeviceType::FeitCsi在 hardware_adapter.rs 中DeviceType枚举新增FeitCsi变体注释明确说明其两种语义录制捕获的文件回放或外部 FeitCSI 进程写入的路径/管道crate 内不做任何提权操作。配套类型包括FeitCsiModeFileReplay确定性回放/Stream外部进程持续写入的路径/管道FeitCsiSettingspath、mode、band2.4/5/6 GHz、channel、loop_playback、pipeline_subcarriers。由于 FeitCSI 头部只携带带宽经 rate flags不携带信道与频段——这两者属于捕获配置的职权范围——所以由调用方在 settings 中给定并盖进帧元数据。两个构造入口封装了最常见的两种用法use wifi_densepose_mat::integration::{ HardwareAdapter, HardwareConfig, }; // 1) 确定性文件回放同一输入文件 ⇒ 同一帧序列 let config HardwareConfig::feitcsi_replay(/path/to/capture.dat); // 2) 流式接入读取外部 FeitCSI 进程持续写入的路径/管道 let config HardwareConfig::feitcsi_stream(/path/to/feitcsi.pipe); let mut adapter HardwareAdapter::with_config(config); adapter.initialize().await?; let mut stream adapter.start_csi_stream().await?; // 逐帧消费 CsiReadings...内部实现细节值得注意初始化不做提权操作initialize_feitcsiFileReplay 只校验文件存在Stream 模式下若路径尚未创建只告警不失败避免约束外部进程的启动顺序——NIC 配置完全由 FeitCSI 自己的工具负责最小权限原则。文件回放推进字节偏移状态机记录replay_offset每条记录通过spawn_blocking在阻塞线程池中seek read_one_record读毕更新偏移配置loop_playback则在读到 EOF 后回到文件头。流模式持有一个跨读取存活的文件句柄FIFO 无法逐记录重开首次读取时惰性打开若流循环中途被 shutdown孤儿任务自行结束、句柄在下一次读取时重开。帧转译按天线对展开时间戳确定化FeitCsiRecord::to_readings完成“记录 →CsiReadings”的转译每个 (rx, tx) 天线对生成一条 [SensorCsiReading]sensor_id形如feitcsi_rx{rx}_tx{tx}把复数样本逐点转成幅度c.norm()与相位c.im.atan2(c.re)盘上 u32 的 RSSI 按二进制补码解释为 dBm捕获文件把负 dBm 存在原始寄存器字段中帧级 RSSI 取rssi1/rssi2中较大者noise_floor固定为 -92.0源 MAC 格式化为AA:BB:CC:DD:EE:FF写入tx_mac时间戳由记录自身设备时钟微秒推导绝不使用墙上时钟——这是文件回放可复现的根本保证。决策落地三子载波无关的管线管道宽带元数据成为一等公民转译出的CsiMetadata携带device_type: DeviceType::FeitCsi、channel、bandwidth、num_subcarriers并新增可选的wideband: WidebandMeta字段定义见 hardware_adapter.rspub struct WidebandMeta { /// 帧捕获所在的射频频段 pub band: WifiBand, // Band2_4GHz | Band5GHz | Band6GHz /// 信道带宽MHz20–160 pub bandwidth_mhz: u16, /// 捕获的原生子载波数真实频谱分辨率 pub native_subcarriers: usize, /// 原生→管线换算记录帧仍处于原生宽度时为 None pub mapping: OptionSubcarrierMapping, }带宽20–160 MHz与频段2.4/5/6 GHz自此成为帧元数据的一等字段WifiBand枚举覆盖 6 GHz 频段802.11ax / Wi-Fi 6E 及以后。显式重采样唯一被允许的原生→管线换算Ingest 层携带原生子载波维度端到端穿过管线再经由既有的插值/抽取级显式换算到管线宽度——换算入口是 resample_readings_to_pipelinepub fn resample_readings_to_pipeline( readings: CsiReadings, pipeline_subcarriers: usize, // 例如 56 ) - ResultCsiReadings, AdapterError其底层复用wifi-densepose-signal的HardwareNormalizerADR-027 引入的 Catmull-Rom 三次插值重采样器默认规范宽度 56、可用with_canonical_subcarriers定制对每条 reading 的幅度与相位分别resample_to_canonical并把换算记录进元数据SubcarrierMapping { native: 1992, // 真实频谱分辨率永不丢失 pipeline: 56, method: catmull-rom-cubic, }这样下游消费者始终知道一帧的真实频谱分辨率与换算方式——即便该帧原本没有宽带元数据例如从既有窄带路径流入转换时也会补造WidebandMeta保住来源信息。而在适配器读帧路径read_feitcsi_csi中FeitCsiSettings::pipeline_subcarriers为Some(n)且n ! 原生宽度时自动触发该换算None则保持原生宽度原样输出。后果与边界条件ADR-292 的 Consequences 定义了这套落地的长期契约RuView 获得一条研究级宽频开发路径以及未来 802.11bf 上报的可测试 ingest 形态——截断 CIR 是同一套管道的自然延伸当前 4096 子载波上限即为 802.11bf 预留了头寸对照wifi-densepose-hardware的 802.11bf 模型其单帧最大上报子载波数MAX_REPORT_SUBCARRIERS 484也能被宽频管线完整承载。GPL FeitCSI 只作外部工具、永不链接仅解析其输出格式MIT workspace 无许可证污染。解析器追踪外部项目格式版本漂移时响亮失败而非误解析。ESP32 仍是部署级传感器档位宽频是开发/验证级档位。宽频捕获的精度声明必须打上捕获硬件标签——CLAUDE.md 要求的真实硬件验证在真实 AX210 上完成之前任何捕获路径的硬件级声明都不成立。验证合成夹具、确定性回放与解析吞吐基准与 ADR-292 “Validation” 一节逐条对应仓库给出了两层证据1. 单元测试cargo test -p wifi-densepose-mat按照仓库政策FeitCSI 捕获夹具一律在代码中生成、绝不把二进制文件提交进仓库——合成模块synth::record_bytes让 CSI 样本成为样本索引的纯函数保证往返可核对、回放可复现。测试覆盖 feitcsi.rs 测试模块测试验证点test_parse_valid_he_shapes20/80/160 MHzHE 242/996/1992 tone合法记录正确解析维度、带宽、调制类型、样本往返一致天线对切片宽度正确test_truncated_buffer头部/负载截断、空缓冲均产出结构化Truncated不 panictest_dimension_mismatchcsiDataSize与维度不符差 4 字节被拒test_unsupported_format_fails_loudly320 MHz 宽度值 4与越界调制类型值 7被UnsupportedFormat拒绝test_allocation_cap_enforcementnum_subcarriers100_000超上限、num_rx9超上限、零维度均在分配前被拒test_stream_reader_multi_record/test_stream_reader_mid_record_eof多记录顺序读取 干净 EOF流中段 EOF 报Truncatedtest_replay_determinism同一捕获两次独立读取产出逐字节一致的记录序列与转译结果含时间戳test_native_to_pipeline_mapping_recorded1992 → 56 显式换算后映射被记录原生宽度在元数据中保留原帧不被改动test_to_readings_antenna_pairs2x2 记录展开为 4 条原生宽度 readingMAC 格式化正确DeviceType::FeitCsi与带宽正确2. 解析吞吐基准cargo bench -p wifi-densepose-mat基准注册在 Cargo.toml 的[[bench]]段feitcsi_benchharness false实现见 benches/feitcsi_bench.rsfeitcsi_parse组以 Criterion 的Throughput::Bytes计量三种宽频形态的单条解析吞吐he20_242sc、he80_996sc、头条he160_1992scAX210 真实交付的 160 MHz / 1992 子载波帧2x1 MIMOfeitcsi_stream组计量 16 条 1992 子载波记录的流读取吞吐直接锻炼FeitCsiStreamReader的可复用 scratch 缓冲整条流只做一次原始字节分配。所有夹具均为确定性合成字节无墙上时钟或随机性进入被解析字节。实操小结如何把宽频数据接入 RuView按最小可复现路径归纳成四步捕获在 crate 之外完成用 FeitCSI 自己的工具在 AX200/AX210 上于 20–160 MHz含 6 GHz 频段可选采集 CSI产物是一连串 272 字节头 负载的紧凑二进制记录。接入录制文件用HardwareConfig::feitcsi_replay(path)外部进程实时落盘/写管道用HardwareConfig::feitcsi_stream(path)配合FeitCsiSettings给出捕获时真实使用的band与channel。想直接对齐窄带管线宽度就设pipeline_subcarriers: Some(n)。消费经HardwareAdapter::initialize().await与start_csi_stream().await逐帧得到CsiReadings每帧metadata.wideband里能看到真实的native_subcarriers、bandwidth_mhz、band与换算记录mapping。验证与免责开发期可用合成夹具与cargo test/cargo bench校验解析与吞吐任何针对真实宽频捕获的精度结论须先完成真实 AX210 硅片验证并按 CLAUDE.md 要求标注捕获硬件。延伸阅读决策原文docs/adr/ADR-292-wideband-80211ax-csi-ingest.md解析器实现与全部测试v2/crates/wifi-densepose-mat/src/integration/feitcsi.rs适配器、DeviceType::FeitCsi与帧元数据定义v2/crates/wifi-densepose-mat/src/integration/hardware_adapter.rs接入层导出面v2/crates/wifi-densepose-mat/src/integration/mod.rs重采样底层HardwareNormalizerv2/crates/wifi-densepose-signal/src/hardware_norm.rs802.11bf 协议层模型宽频接入的未来形态参照v2/crates/wifi-densepose-hardware/src/ieee80211bf/types.rs基准注册与依赖v2/crates/wifi-densepose-mat/Cargo.toml【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RuView 宽频 802.11ax CSI 数据接入：基于 FeitCSI/AX210 的子载波无关管线架构（ADR-292 实践指南）
RuView 宽频 802.11ax CSI 数据接入基于 FeitCSI/AX210 的子载波无关管线架构ADR-292 实践指南【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView本文以 docs/adr/ADR-292-wideband-80211ax-csi-ingest.md 为骨架结合其在wifi-densepose-matcrate 中的 Rust 实现展开。它讲清楚三件事为什么 RuView 需要宽频114 子载波CSI 接入路径、FeitCSI 二进制记录格式如何被安全解析、以及原生子载波维度如何端到端保留并显式映射到下游管线宽度。读完你不仅能看懂这套设计的取舍还能直接据此用文件回放或外部进程流式两种方式把 AX200/AX210 的宽频数据喂进 RuView 管线。背景从 802.11n 时代的 ≤114 子载波到 802.11ax/11bf 的 160 MHz 宽频RuView 的 CSI 接入层位于 v2/crates/wifi-densepose-mat/src/integration/hardware_adapter.rs作为一层“防腐层”Anti-Corruption Layer统一把不同硬件的 CSI 转译为领域类型CsiReadings。在该决策之前它支持的三类硬件全部属于 802.11n 世代接入路径底层典型子载波数带宽上限ESP32 串行流ESP-CSI 固件ESP32依固件配置HT20 档约 56 量级20/40 MHzIntel 5300Linux CSI Tooliwlwifi netlink connector3020/40 MHzAtheros/Nexmonath9k/ath10k/ath11k 补丁驱动debugfs CSI 缓冲56 / 114 / 23440 MHzath11k 除外而 2026 年的研究扫描表明该领域的重心已经迁移到通过 PicoScenes核心闭源与 FeitCSI开源、GPL驱动 Intel AX200/AX210 网卡可拿到最高160 MHz 带宽 / 1992 个子载波、含 6 GHz 频段的 802.11ax CSI。这既是当前研究级档位的基线也是 2026 年起 802.11bf 芯片将产出的数据形态。RuView 的wifi-densepose-hardwarecrate 已经在协议层建模 802.11bf 会话类型见 v2/crates/wifi-densepose-hardware/src/ieee80211bf/types.rs但没有任何 ingest 路径能把宽频 CSI 真正送进管线——114 子载波的帧在既有落地上没有可用的通道。这带来三重后果正是 ADR-292 要解决的无法基于“当下可得的最好信号”做开发无法把 ESP32 档位的结果与宽频理论上限做横向对比面对 802.11bf 硅片时没有经过验证的 114 子载波帧的接入管道。方案权衡为什么选 FeitCSI 而非 PicoScenes 或裸 pcapADR-292 在决策前对三条技术路线做了明确权衡结论值得在接入类方案评审时复用PicoScenes.csi格式 —— 拒绝暂缓。该格式产自闭源核心版本化且复杂在没有持续维护的规范文档时自行解析等于拿“静默损坏”做赌注。裸 pcap radiotap 解析 —— 拒绝。这会在设备端重复 FeitCSI 已完成的解包工作还把包捕获依赖拉进管线。FeitCSI 文件/流 ingest —— 采纳。理由有四点FeitCSI 开源其头部布局可对照源码审计目标硬件明确为 AX200/AX210覆盖 20–160 MHz、含 6 GHz每帧输出一条紧凑的二进制记录。需要特别强调的是许可证策略FeitCSI 是 GPL 项目RuView只解析其输出格式永不链接、永不将其纳入编译产物——它始终作为外部工具使用。这一边界由代码注释明确声明见 feitcsi.rs 头部文档保证 MIT workspace 不受 GPL 污染。决策落地一feitcsi记录解析器解析器整体位于 v2/crates/wifi-densepose-mat/src/integration/feitcsi.rs并在 mod.rs 统一导出。二进制记录布局272 字节定长头 CSI 负载每条记录是packed 的 272 字节头 csiDataSize字节裸 CSI。头部布局依据 FeitCSI 源码master 2026-08-10的include/Csi.hRawHeaderData结构与Csi::save()逐字段核对要点是FeitCSI 运行于小端 x86 主机并直接倾倒原生结构体内存因此所有字段一律小端序。具体字段如下偏移大小字段说明04csiDataSizeu32头部之后 CSI 负载的字节数44reservedspace484ftmClocku32128timestampu64设备时间戳微秒2026reservedspace20461numRxu8接收天线数471numTxu8发射流数484reservedspace48524numSubCarriersu32564reservedspace54604rssi1u32天线 A RSSI644rssi2u32天线 B RSSI686srcMac源 MAC 地址7418reservedspace75924rateNflagu32iwlwifi rate flags96176reservedspace9644 × u32负载为交错的小端i16I/Q 对遍历顺序是for rx { for tx { for subcarrier { i16 real, i16 imag } } }即每个复数样本占 4 字节且恒等式成立csiDataSize numRx * numTx * numSubCarriers * 4rate flags从rateNflag解码调制类型与带宽rateNflag采用 FeitCSI 内置的 iwlwifi rate/flags 编码lib/include/rs.h解析器用位掩码提取两个子字段调制类型bits 8..11RATE_MCS_MOD_TYPE0CCK1legacy OFDM2HT3VHT4HE5EHT信道宽度bits 11..14RATE_MCS_CHAN_WIDTH020 MHz14028031604320。对应到 Rust 侧是FeitCsiModType与FeitCsiBandwidth两个枚举后者的mhz()返回物理带宽、to_bandwidth()映射到适配层Bandwidth枚举。320 MHzEHT被本版本解析器显式拒绝。“响亮地失败”没有魔数时的结构性版本校验该格式最大的坑是盘上格式没有任何魔数或版本字段——它本质就是 iwlwifi 通知头的裸内存。因此 ADR-292 要求的“版本检查”必须是结构性的且严格的体现在 validate_header 的校验顺序上维度字段为 0 → [FeitCsiError::ZeroDimension]维度超过硬上限 → [FeitCsiError::CapExceeded]声明的csiDataSize与维度乘积不符 → [FeitCsiError::DimensionMismatch]rateNflag落在既有编码之外未知调制类型或 320 MHz→ [FeitCsiError::UnsupportedFormat]拒绝猜测而不是误解析。所有输入都被当作不可信数据每次读取都做长度检查任何分配发生前先做边界约束畸形输入一律产出结构化错误绝不 panic。错误类型在 mod.rs 中被映射到AdapterErrorUnsupportedFormat→UnsupportedAdapter、I/O 错误透传、其余归类为DataFormat。有界分配对抗损坏长度字段宽度字段若被损坏可能诱发无界分配因此解析器设置了硬上限常量HEADER_LEN 272MAX_SUBCARRIERS 4096802.11ax 160 MHz HE 实际是 1992保留 4096 头寸以容纳未来 802.11bf 截断 CIR 形态MAX_ANTENNAS 8AX210 实际是 2x28 已很宽裕BYTES_PER_SAMPLE 4MAX_RECORD_BYTES HEADER_LEN 8 * 8 * 4096 * 4约 1 MiB 272同时作为流模式缓冲上界。由于 8×8×4096×4 ≈ 1 MiB 的乘积上限维度乘法在usize上不会溢出。校验在任何依据不可信字段定尺寸的分配之前完成。单次遍历解码与零分配转换decode_csi 用chunks_exact(4)把负载切成精确的 4 字节块逐样本i16::from_le_bytes后转f64构造Complex64由于调用方已对payload.len()做过校验collect只会发生一次有界分配转换循环本身零分配。解析入口 parse_record 返回(FeitCsiRecord, usize)含消费字节数支持调用方顺序遍历多记录捕获文件头部原地读取、负载直接从输入切片转换CSI 字节只被遍历一次。文件回放与流式读取两个读取器ADR-292 要求两条读取路径都能成立FeitCsiFileReader打开录制好的捕获文件做确定性顺序回放FeitCsiStreamReader对任意Read源文件、FIFO、管道包装逐条读取。两者的核心是内部共用的read_one_record_with_scratch它持有调用方拥有的可复用 scratch 缓冲长跑回放/流循环整条流只做一次有界原始字节分配外加每条记录一份VecComplex64输出而不是逐记录分配。中途 EOF 被归为Truncated而非干净的Ok(None)——干净的流结束只发生在两条记录之间读到 0 字节时。决策落地二适配器层的DeviceType::FeitCsi在 hardware_adapter.rs 中DeviceType枚举新增FeitCsi变体注释明确说明其两种语义录制捕获的文件回放或外部 FeitCSI 进程写入的路径/管道crate 内不做任何提权操作。配套类型包括FeitCsiModeFileReplay确定性回放/Stream外部进程持续写入的路径/管道FeitCsiSettingspath、mode、band2.4/5/6 GHz、channel、loop_playback、pipeline_subcarriers。由于 FeitCSI 头部只携带带宽经 rate flags不携带信道与频段——这两者属于捕获配置的职权范围——所以由调用方在 settings 中给定并盖进帧元数据。两个构造入口封装了最常见的两种用法use wifi_densepose_mat::integration::{ HardwareAdapter, HardwareConfig, }; // 1) 确定性文件回放同一输入文件 ⇒ 同一帧序列 let config HardwareConfig::feitcsi_replay(/path/to/capture.dat); // 2) 流式接入读取外部 FeitCSI 进程持续写入的路径/管道 let config HardwareConfig::feitcsi_stream(/path/to/feitcsi.pipe); let mut adapter HardwareAdapter::with_config(config); adapter.initialize().await?; let mut stream adapter.start_csi_stream().await?; // 逐帧消费 CsiReadings...内部实现细节值得注意初始化不做提权操作initialize_feitcsiFileReplay 只校验文件存在Stream 模式下若路径尚未创建只告警不失败避免约束外部进程的启动顺序——NIC 配置完全由 FeitCSI 自己的工具负责最小权限原则。文件回放推进字节偏移状态机记录replay_offset每条记录通过spawn_blocking在阻塞线程池中seek read_one_record读毕更新偏移配置loop_playback则在读到 EOF 后回到文件头。流模式持有一个跨读取存活的文件句柄FIFO 无法逐记录重开首次读取时惰性打开若流循环中途被 shutdown孤儿任务自行结束、句柄在下一次读取时重开。帧转译按天线对展开时间戳确定化FeitCsiRecord::to_readings完成“记录 →CsiReadings”的转译每个 (rx, tx) 天线对生成一条 [SensorCsiReading]sensor_id形如feitcsi_rx{rx}_tx{tx}把复数样本逐点转成幅度c.norm()与相位c.im.atan2(c.re)盘上 u32 的 RSSI 按二进制补码解释为 dBm捕获文件把负 dBm 存在原始寄存器字段中帧级 RSSI 取rssi1/rssi2中较大者noise_floor固定为 -92.0源 MAC 格式化为AA:BB:CC:DD:EE:FF写入tx_mac时间戳由记录自身设备时钟微秒推导绝不使用墙上时钟——这是文件回放可复现的根本保证。决策落地三子载波无关的管线管道宽带元数据成为一等公民转译出的CsiMetadata携带device_type: DeviceType::FeitCsi、channel、bandwidth、num_subcarriers并新增可选的wideband: WidebandMeta字段定义见 hardware_adapter.rspub struct WidebandMeta { /// 帧捕获所在的射频频段 pub band: WifiBand, // Band2_4GHz | Band5GHz | Band6GHz /// 信道带宽MHz20–160 pub bandwidth_mhz: u16, /// 捕获的原生子载波数真实频谱分辨率 pub native_subcarriers: usize, /// 原生→管线换算记录帧仍处于原生宽度时为 None pub mapping: OptionSubcarrierMapping, }带宽20–160 MHz与频段2.4/5/6 GHz自此成为帧元数据的一等字段WifiBand枚举覆盖 6 GHz 频段802.11ax / Wi-Fi 6E 及以后。显式重采样唯一被允许的原生→管线换算Ingest 层携带原生子载波维度端到端穿过管线再经由既有的插值/抽取级显式换算到管线宽度——换算入口是 resample_readings_to_pipelinepub fn resample_readings_to_pipeline( readings: CsiReadings, pipeline_subcarriers: usize, // 例如 56 ) - ResultCsiReadings, AdapterError其底层复用wifi-densepose-signal的HardwareNormalizerADR-027 引入的 Catmull-Rom 三次插值重采样器默认规范宽度 56、可用with_canonical_subcarriers定制对每条 reading 的幅度与相位分别resample_to_canonical并把换算记录进元数据SubcarrierMapping { native: 1992, // 真实频谱分辨率永不丢失 pipeline: 56, method: catmull-rom-cubic, }这样下游消费者始终知道一帧的真实频谱分辨率与换算方式——即便该帧原本没有宽带元数据例如从既有窄带路径流入转换时也会补造WidebandMeta保住来源信息。而在适配器读帧路径read_feitcsi_csi中FeitCsiSettings::pipeline_subcarriers为Some(n)且n ! 原生宽度时自动触发该换算None则保持原生宽度原样输出。后果与边界条件ADR-292 的 Consequences 定义了这套落地的长期契约RuView 获得一条研究级宽频开发路径以及未来 802.11bf 上报的可测试 ingest 形态——截断 CIR 是同一套管道的自然延伸当前 4096 子载波上限即为 802.11bf 预留了头寸对照wifi-densepose-hardware的 802.11bf 模型其单帧最大上报子载波数MAX_REPORT_SUBCARRIERS 484也能被宽频管线完整承载。GPL FeitCSI 只作外部工具、永不链接仅解析其输出格式MIT workspace 无许可证污染。解析器追踪外部项目格式版本漂移时响亮失败而非误解析。ESP32 仍是部署级传感器档位宽频是开发/验证级档位。宽频捕获的精度声明必须打上捕获硬件标签——CLAUDE.md 要求的真实硬件验证在真实 AX210 上完成之前任何捕获路径的硬件级声明都不成立。验证合成夹具、确定性回放与解析吞吐基准与 ADR-292 “Validation” 一节逐条对应仓库给出了两层证据1. 单元测试cargo test -p wifi-densepose-mat按照仓库政策FeitCSI 捕获夹具一律在代码中生成、绝不把二进制文件提交进仓库——合成模块synth::record_bytes让 CSI 样本成为样本索引的纯函数保证往返可核对、回放可复现。测试覆盖 feitcsi.rs 测试模块测试验证点test_parse_valid_he_shapes20/80/160 MHzHE 242/996/1992 tone合法记录正确解析维度、带宽、调制类型、样本往返一致天线对切片宽度正确test_truncated_buffer头部/负载截断、空缓冲均产出结构化Truncated不 panictest_dimension_mismatchcsiDataSize与维度不符差 4 字节被拒test_unsupported_format_fails_loudly320 MHz 宽度值 4与越界调制类型值 7被UnsupportedFormat拒绝test_allocation_cap_enforcementnum_subcarriers100_000超上限、num_rx9超上限、零维度均在分配前被拒test_stream_reader_multi_record/test_stream_reader_mid_record_eof多记录顺序读取 干净 EOF流中段 EOF 报Truncatedtest_replay_determinism同一捕获两次独立读取产出逐字节一致的记录序列与转译结果含时间戳test_native_to_pipeline_mapping_recorded1992 → 56 显式换算后映射被记录原生宽度在元数据中保留原帧不被改动test_to_readings_antenna_pairs2x2 记录展开为 4 条原生宽度 readingMAC 格式化正确DeviceType::FeitCsi与带宽正确2. 解析吞吐基准cargo bench -p wifi-densepose-mat基准注册在 Cargo.toml 的[[bench]]段feitcsi_benchharness false实现见 benches/feitcsi_bench.rsfeitcsi_parse组以 Criterion 的Throughput::Bytes计量三种宽频形态的单条解析吞吐he20_242sc、he80_996sc、头条he160_1992scAX210 真实交付的 160 MHz / 1992 子载波帧2x1 MIMOfeitcsi_stream组计量 16 条 1992 子载波记录的流读取吞吐直接锻炼FeitCsiStreamReader的可复用 scratch 缓冲整条流只做一次原始字节分配。所有夹具均为确定性合成字节无墙上时钟或随机性进入被解析字节。实操小结如何把宽频数据接入 RuView按最小可复现路径归纳成四步捕获在 crate 之外完成用 FeitCSI 自己的工具在 AX200/AX210 上于 20–160 MHz含 6 GHz 频段可选采集 CSI产物是一连串 272 字节头 负载的紧凑二进制记录。接入录制文件用HardwareConfig::feitcsi_replay(path)外部进程实时落盘/写管道用HardwareConfig::feitcsi_stream(path)配合FeitCsiSettings给出捕获时真实使用的band与channel。想直接对齐窄带管线宽度就设pipeline_subcarriers: Some(n)。消费经HardwareAdapter::initialize().await与start_csi_stream().await逐帧得到CsiReadings每帧metadata.wideband里能看到真实的native_subcarriers、bandwidth_mhz、band与换算记录mapping。验证与免责开发期可用合成夹具与cargo test/cargo bench校验解析与吞吐任何针对真实宽频捕获的精度结论须先完成真实 AX210 硅片验证并按 CLAUDE.md 要求标注捕获硬件。延伸阅读决策原文docs/adr/ADR-292-wideband-80211ax-csi-ingest.md解析器实现与全部测试v2/crates/wifi-densepose-mat/src/integration/feitcsi.rs适配器、DeviceType::FeitCsi与帧元数据定义v2/crates/wifi-densepose-mat/src/integration/hardware_adapter.rs接入层导出面v2/crates/wifi-densepose-mat/src/integration/mod.rs重采样底层HardwareNormalizerv2/crates/wifi-densepose-signal/src/hardware_norm.rs802.11bf 协议层模型宽频接入的未来形态参照v2/crates/wifi-densepose-hardware/src/ieee80211bf/types.rs基准注册与依赖v2/crates/wifi-densepose-mat/Cargo.toml【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考