firmwareloop 0.1.4__tar.gz → 0.1.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. {firmwareloop-0.1.4/firmwareloop.egg-info → firmwareloop-0.1.6}/PKG-INFO +29 -5
  2. firmwareloop-0.1.4/PKG-INFO → firmwareloop-0.1.6/README.md +388 -392
  3. firmwareloop-0.1.4/README.md → firmwareloop-0.1.6/firmwareloop.egg-info/PKG-INFO +416 -364
  4. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/pyproject.toml +1 -1
  5. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/__init__.py +1 -1
  6. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/fw_mcp_server.py +160 -13
  7. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/ndtdbg_cli.py +7 -1
  8. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/setup-agent-mcp.ps1 +2 -2
  9. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/LICENSE +0 -0
  10. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/firmwareloop.egg-info/SOURCES.txt +0 -0
  11. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/firmwareloop.egg-info/dependency_links.txt +0 -0
  12. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/firmwareloop.egg-info/entry_points.txt +0 -0
  13. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/firmwareloop.egg-info/requires.txt +0 -0
  14. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/firmwareloop.egg-info/top_level.txt +0 -0
  15. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/setup.cfg +0 -0
  16. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/acceptance-scenario.ps1 +0 -0
  17. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/build.ps1 +0 -0
  18. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/can.ps1 +0 -0
  19. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/check-qoder-mcp.ps1 +0 -0
  20. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/common/build-backends.psm1 +0 -0
  21. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/common/fw.psm1 +0 -0
  22. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/common/uart_probe.py +0 -0
  23. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/doctor.ps1 +0 -0
  24. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/flash.ps1 +0 -0
  25. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/instrument_cli.py +0 -0
  26. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/lib/__init__.py +0 -0
  27. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/lib/instruments.py +0 -0
  28. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/lib/ndtdbg.py +0 -0
  29. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/logic_capture.ps1 +0 -0
  30. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/logic_decode.ps1 +0 -0
  31. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/ndtdbg_bridge.ps1 +0 -0
  32. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/reset.ps1 +0 -0
  33. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/sigrok_csv_to_fwloop.py +0 -0
  34. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/test-backends.ps1 +0 -0
  35. {firmwareloop-0.1.4 → firmwareloop-0.1.6}/tools/test.ps1 +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: firmwareloop
3
- Version: 0.1.4
3
+ Version: 0.1.6
4
4
  Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
5
5
  Author-email: WeilinZhang <19523330249@163.com>
6
6
  License: MIT
@@ -119,6 +119,27 @@ uv tool install agentic-hil
119
119
 
120
120
  ---
121
121
 
122
+ ### 可选:接入 NdtBox 调试盒(公司内部 USB→IIC 调试工具)
123
+
124
+ 如需用 Agent 直接操作 NdtBox(固件寄存器读写 / 数据采集 / 逻辑分析仪协议验证),安装后执行一次:
125
+
126
+ ```bash
127
+ # 1) 全局注册各 AI Agent(Antigravity / Claude Code / Qoder / CodeBuddy),并生成机器级配置模板
128
+ fwloop setup
129
+
130
+ # 2) 指向你的 NdtDebugTool 分发包【根目录】——命令自动定位其 lib/(含 USBIOX.DLL)并写入配置
131
+ fwloop ndtdebugtool "C:/Users/weilin.zhang/Desktop/zwl/NdtDebugTool-v1.0.19"
132
+ ```
133
+
134
+ > 完成以上两步后,Agent 侧即可直接调用 NdtBox 相关工具:
135
+ > `fw_ndtdbg_status`(版本/连通性/模组通断)、`fw_ndtdbg_measure`(数据轮询采集)、
136
+ > `fw_ndtdbg_read_reg` / `fw_ndtdbg_write_reg`(任意寄存器读写,写需 `write_allowed` + `confirm` 双门控)、
137
+ > `fw_ndtdbg_capture_seq`(寄存器序列 + Saleae 波形同窗口取证)。
138
+ > 前置硬件要求:NdtBox 已装 CH341 驱动;如需 Saleae 波形证据,另装 sigrok-cli 并配置
139
+ > `libusb-win32` 驱动(详见 `docs/` 交付说明)。测试时请退出 STDataCollection.exe 上位机(USB 独占)。
140
+
141
+ ---
142
+
122
143
  ### 第二步:全局注册到各大 AI Agent
123
144
 
124
145
  按你日常使用的 Agent 执行对应的注册命令(全电脑仅需配置一次):
@@ -142,7 +163,10 @@ claude mcp add --scope user agentic-hil -- agentic-hil mcp-stdio
142
163
 
143
164
  不要依赖 `qoder.cmd --add-mcp`:它写到 `%APPDATA%\Qoder\User\mcp.json`,设置页看不到。
144
165
 
145
- 4. **Cursor / 其他 IDE**(在工程根目录的 `.mcp.json` 中并联配置):
166
+ 4. **CodeBuddy IDE**:
167
+ `fwloop setup` 会合并写入用户级配置 `~/.codebuddy/mcp.json`(`mcpServers` 形状与 Qoder 兼容,含官方 `description` 字段;既有条目与 `env` 自定义字段保留)。`~/.codebuddy` 目录不存在时自动跳过。
168
+
169
+ 5. **Cursor / 其他 IDE**(在工程根目录的 `.mcp.json` 中并联配置):
146
170
  ```json
147
171
  {
148
172
  "mcpServers": {
@@ -182,7 +206,7 @@ fwloop init
182
206
 
183
207
  | 命令 | 适用级别 | 核心作用 | 使用时机 |
184
208
  |---|---|---|---|
185
- | **`fwloop setup`** | **系统全局级** | 给各大 Agent(Antigravity / Claude Code / Qoder / Qoder CN)配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
209
+ | **`fwloop setup`** | **系统全局级** | 给各大 Agent(Antigravity / Claude Code / Qoder / Qoder CN / CodeBuddy)配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
186
210
  | **`fwloop init`** | **工程项目级** | 在当前单片机代码目录下生成 `AGENTS.md`、`GEMINI.md`、`CLAUDE.md` 与台架配置 | **每个新单片机项目跑 1 次** |
187
211
  | **`fwloop doctor`** | **环境诊断** | 检查编译器(Keil/GCC)、Python 环境、串口与探针连接健康度 | 随时排查环境时使用 |
188
212
  | **`fwloop update`** | **自动更新** | 一键自动拉取最新代码并热重载依赖 | 升级工具版本时使用 |
@@ -338,7 +362,7 @@ claude mcp remove --scope user agentic-hil
338
362
  ├── demo-firmware/ 示例固件(CMake;宿主编译模拟 MCU,闭环验证载体)
339
363
  ├── demo-make/ 示例固件(Make;构建测试载体)
340
364
  ├── docs/ DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
341
- ├── pyproject.toml 标准 Python 包配置与 CLI 入口声明 (v0.1.4)
365
+ ├── pyproject.toml 标准 Python 包配置与 CLI 入口声明 (v0.1.6)
342
366
  ├── .mcp.example.json 双层 MCP 配置模板(firmwareloop + agentic-hil)
343
367
  ├── AGENTS.md 通用智能体规范(Antigravity / Qoder / Cursor 等)
344
368
  ├── CLAUDE.md Claude Code CLI 指南
@@ -348,7 +372,7 @@ claude mcp remove --scope user agentic-hil
348
372
 
349
373
  ---
350
374
 
351
- ## 能力验证状态(v0.1.4)
375
+ ## 能力验证状态(v0.1.6)
352
376
 
353
377
  > 状态定义:`Implemented`(已实现)/ `Simulator Validated`(模拟验证)/
354
378
  > `Real Hardware Validated`(真机验证)/ `Experimental` / `Not Implemented`