正在加载正文…
Flux Purr
Flux Purr 是一个嵌入式设备单仓项目,包含 ESP32-S3 固件、React 控制台、`flux-purr` CLI 和 `flux-purr-devd` 本地守护进程。项目统一处理设备连接、状态查看、Wi-Fi 配置、固件更新、校准和热控运行。
Flux Purr 是一个嵌入式设备单仓项目,包含 ESP32-S3 固件、React 控制台、`flux-purr` CLI 和 `flux-purr-devd` 本地守护进程。项目统一处理设备连接、状态查看、Wi-Fi 配置、固件更新、校准和热控运行。
正在加载正文…
Flux Purr 为嵌入式设备提供一套完整的软件控制面。固件运行在 ESP32-S3 上,Web 控制台负责设备操作和状态展示,CLI 与 flux-purr-devd 负责本地设备访问和维护。
项目的重点是统一设备协议和操作路径。设备身份、能力、连接方式、运行状态和错误信息由同一套模型表达,因此 Web、CLI 和本地守护进程可以使用相同的设备语义。
系统分为三层:
flux-purr-devd 负责 USB/串口发现、独占 lease、有限 monitor 事件和 Wi-Fi 配置桥接;flux-purr CLI 通过 native IPC 使用这些能力。Web 控制台不直接承担所有本地设备操作。首次 Wi-Fi 配置、固件烧录和配对令牌重置必须使用 USB 路径;完成配置和配对后,设备才可以通过可信局域网 HTTP 进行日常控制。
控制台支持以下功能:
控制台会区分 live、mock、offline、degraded、pending 和 unsupported 状态。动作只有在设备能力和安全条件满足时才会开放。
硬件资料按“先看结构,再看电路”的顺序排列。模型预览用于确认外壳和装配件的相对关系;PDF 资料用于查看板卡布局与原理图。页面只放入已经从仓库硬件目录核对过的文件,原始文件仍可直接下载。
STEP 文件可在页面内旋转查看,也可以下载后在 FreeCAD、Fusion 360 或其他 CAD 工具中继续编辑。
正在准备预览内容,请稍候。
这些 PDF 对应仓库中的板卡导出物,适合在焊接、检查和复核电路时使用。
正在准备预览内容,请稍候。
热控与安全行为
固件使用 RTD 采样和 PID 控制加热输出,并根据 PD contract 判断当前电源条件。PD contract 未就绪、传感器故障或发生绝对过温时,加热输出保持关闭;控制台仍然可以显示状态和故障原因。
软件功率限制用于约束控制逻辑,不能替代硬件过流保护。当前硬件基线使用 ESP32-S3,具体电源链、PD 芯片和风扇电路以 docs/hardware/ 中的资料为准。
校准数据
校准分为三个阶段:采集样本、生成拟合建议、写入生效参数。
样本和拟合建议不会自动改变设备运行参数。只有将结果写入指定的 A/B 参数槽位并完成设备确认后,运行时才会使用新参数。设备身份不匹配、参数不完整或运行条件不满足时,流程会停在诊断状态。
固件维护
普通用户使用本地 .fluxpurr-fw bundle 更新固件,bundle 必须通过发布清单中的 SHA-256 校验。开发者可以使用指定串口和本地 ELF 执行 flash;该流程默认备份 EEPROM。recover 用于明确确认后的 MCU 内部 Flash 擦除,不会修改外部 EEPROM。
每次固件操作都要求明确的串口。CLI 不会自动扫描、选择或记忆物理设备。
仓库按“设备运行、设备访问、控制台、契约与验证”分层。先按任务定位所属层,再阅读对应规格和硬件资料,不需要从根目录逐项翻找。
firmware/ESP32-S3 固件:采样、热控、PD、风扇和 EEPROMtools/flux-purr-devd/CLI、守护进程、USB/串口和 native IPCweb/React 控制台、设备状态、校准、固件维护和 Demodocs/specs/功能规格、协议和验收条件docs/hardware/引脚、电源、加热、风扇和外壳资料fixtures/ · thermal-self-test-runs/模拟数据与热控自测记录| 要修改的内容 | 先看 | 再看 |
|---|---|---|
| 温度采样或加热逻辑 | firmware/ | docs/specs/、docs/hardware/ |
| USB、串口或局域网连接 | tools/flux-purr-devd/ | 协议规格、CLI 行为 |
| Web 控制台页面 | web/ | mock/live 状态和设备能力模型 |
| 校准流程 | firmware/、web/ | 校准规格、运行记录 |
| 硬件改版 | docs/hardware/ | firmware/ 的引脚和电源配置 |
| 回归验证 | fixtures/、thermal-self-test-runs/ | 对应功能规格 |
docs/specs/ 定义系统应该如何工作,firmware/、web/ 和 tools/ 分别实现设备、控制台和访问层;验证目录用于检查实现是否符合规格。
公共 Demo 只模拟设备状态和控制台交互,不执行真实烧录、凭据写入或配对重置。
相关入口