docs: clarify HWPOD L1 UART operations

This commit is contained in:
pikastech
2026-07-21 11:14:31 +02:00
parent b789f9f187
commit 3ac868527c
2 changed files with 14 additions and 1 deletions
+9 -1
View File
@@ -44,7 +44,9 @@ description: >-
- 受控 CLI 缺失时先实现 CLI,不把手工部署当临时完成态。
- 调查可只读访问现场;发生以下变更时加载对应 skill:
- 安装、注册、更新、停止旧运行器或修改 MDTODO 来源:`$unidesk-daddev`
- 部署/发布:同时加载 `$unidesk-cicd`
- L2/L3 部署发布:同时加载 `$unidesk-cicd`
- L1 native API、worker、Web 和 Windows desktop node 的启动、恢复与回归不加载、
不依赖 `$unidesk-cicd` 或 Kubernetes
- YAML 变更:同时加载 `$unidesk-ymalops`
- 远端操作走 `$unidesk-trans`。普通 `trans` 保持短连接;图形进程不得作为透传子进程长挂。
- Python 节点可用性:
@@ -118,6 +120,12 @@ POWERSHELL
- 解析目标交互用户的 Windows `python.exe`
- 安装文件并应用 YAML 声明的登录自启动策略;
- nodeId、地址、工作区和重连/更新设置不得硬编码进生成的辅助代码。
- Windows UART backend 由 HWPOD spec 的 YAML 字段选择:
- `serial-monitor` 是默认 backend
- 目标机已有 `pyserial` 且 serial-monitor server 不可用时,可对该 spec 显式声明
`backend: pyserial`,不得改成全局隐式回退;
- compiler 必须把同一 backend 对称传入 `open``read``write``close` 四类 plan
- `pyserial` 节点在四步操作之间持有同一串口连接,回归结束必须执行 `close`
- 证明节点状态:
- 单一执行权威;
- 预期版本/nodeId 和注册;
+5
View File
@@ -135,6 +135,11 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`,以及已收编的 `cloud-wo
- 真实 Windows workspace、Keil build 和硬件操作必须通过 API host 上的 L1
native API 路由到目标 HWPOD-NODE
- L0 workspace 和 bounded build 使用当前 host 的 disposable fixture 验证。
- HWPOD Windows UART backend
- backend 由 owning HWPOD spec 的 YAML 字段选择,默认使用 `serial-monitor`
- 单个目标节点可显式选择 `pyserial`,禁止在代码中增加全局自动回退;
- compiler 必须将 backend 对称写入 `open``read``write``close` 四类 node plan
- `pyserial` 节点在操作序列间持有同一连接,回归无论成功或失败都以 `close` 收尾。
- HWPOD runtime spec 的持久化边界:
- L0、L1 和 L2 development 共用 owning YAML 声明的 development host PostgreSQL
- L3 production 使用 production owning YAML 声明的 host PostgreSQL