90cc9a7d99
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动, 现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。 驱动与后端: - 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数, 用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走 net_drop_conn_locked,绝不 net_close 监听 fd。 - net_socket 增 5 个 owner-only 接口(net_accept_locked、 net_drop_conn_locked、net_pending_bytes、net_send_try、 net_mono_now_ms)。 - iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环 里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。 - Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。 内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到 skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化), RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。 台架修复(只在真硬件暴露): - SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标, 首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104 连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。 - Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd, 后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。 验证: - Keil 全量重建 0 error 0 warning,uvprojx 零抖动。 - 模拟器真实 TCP 13/13、transport 10/10。 - netmcu 后端单测 13/13(新增 N12)。 - 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到 59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、 UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。 - 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、 coding-standard 对 vendor 与外部 ABI 名字的排除口径。
136 lines
6.2 KiB
Python
136 lines
6.2 KiB
Python
#!/usr/bin/env python
|
||
# -*- coding: utf-8 -*-
|
||
"""门禁钩子的统一启动器:替钩子找到该用的解释器,再原样转交脚本。
|
||
|
||
被提交的 .pre-commit-config.yaml 只写 `entry: scripts/gate_python.py <脚本> [参数...]`,
|
||
不出现任何机器相关的解释器路径——换机、换克隆目录、换 PATH 首位都不必改配置。
|
||
|
||
解释器按下面的顺序找,第一个可用的胜出:
|
||
1. $DTU_GATE_PYTHON 显式覆盖(临时切版本、排查「到底跑在谁身上」)
|
||
2. <仓库>/.venv/Scripts/python.exe 约定的仓库内环境(requirements.txt 装在这里)
|
||
3. <仓库>/.gate/python/python.exe 便携解释器(可选,本仓当前未提供)
|
||
4. PATH 上的 python 最后兜底
|
||
|
||
约定纪律(改动前先读 docs/环境与部署/本地工具路径环境变量方案.md §5.1):
|
||
- 纯标准库、单文件、不 import 仓库内任何模块——它运行在「解释器还不知道是谁」的时刻;
|
||
- 解析出的解释器用环境变量 DTU_GATE_PYTHON 传给子进程,脚本内部再调 Python 时能与钩子保持一致,
|
||
否则「门禁用的版本」和「生成器用的版本」会分叉。
|
||
|
||
退出码:0 表示被调脚本自己退出为 0;启动器自身失败一律 2(与 pre-commit「环境不可用」口径一致,
|
||
见 docs/草稿约定:2 = 配置/环境问题,1 = 检查结论不通过)。
|
||
|
||
为什么用 subprocess 转交而不是 os.execve(2026-11-18 实测定案,改动前请先看这段):
|
||
本机(Windows + 本仓 worktree)上 os.execve/os.execv 对 .venv 里的解释器**静默不启动子进程**,
|
||
只把一条 `can't open file '<路径被重复拼接>'` 打到 stderr 然后**退出码仍是 0**;pre-commit 因此把
|
||
「根本没跑」记成 Passed —— 即整仓所有经本启动器的钩子都是假绿。实测三种形态:
|
||
os.execve(venv python) -> 路径二次拼接 + Errno 2 或 0xC0000005(访问违例)
|
||
os.execv (venv python) -> 同样路径二次拼接,退出码 0(最坏:静默放弃)
|
||
subprocess.run(venv python) -> 正常,退出码可透传
|
||
机理:.venv/Scripts/python.exe 是 venv 的 redirector(会按 pyvenv.cfg 重新定位真实解释器并改写 argv);
|
||
在 execv 家族下它的 argv[0]/脚本路径解析会叠加当前工作目录,于是形成
|
||
`<工作目录>/<绝对路径>` 的重复拼接。改用 subprocess 后 redirector 拿到的是标准 CreateProcess 参数,
|
||
不再发生拼接。
|
||
因此本文件**禁止**改回 os.execv/os.execve;任何启动器失败都必须以非零码退出(不能 0 = 通过)。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import os
|
||
import subprocess
|
||
import sys
|
||
|
||
LAUNCHER_NAME = "gate_python.py"
|
||
|
||
|
||
def repo_root() -> str:
|
||
"""启动器所在仓库根(本文件位于 <仓库>/scripts/ 下)。"""
|
||
return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||
|
||
|
||
def candidates(root: str) -> list[tuple[str, str]]:
|
||
"""返回 [(说明, 解释器路径)],顺序即优先级。"""
|
||
items: list[tuple[str, str]] = []
|
||
override = os.environ.get("DTU_GATE_PYTHON")
|
||
if override:
|
||
items.append(("$DTU_GATE_PYTHON", override))
|
||
items.append(("仓库 .venv", os.path.join(root, ".venv", "Scripts", "python.exe")))
|
||
items.append(("便携解释器 .gate", os.path.join(root, ".gate", "python", "python.exe")))
|
||
path_python = path_lookup("python")
|
||
if path_python:
|
||
items.append(("PATH", path_python))
|
||
return items
|
||
|
||
|
||
def path_lookup(name: str) -> str:
|
||
"""按 Windows 语义在 PATH 里找可执行文件(含 PATHEXT 展开)。"""
|
||
exts = os.environ.get("PATHEXT", ".COM;.EXE;.BAT;.CMD").split(os.pathsep)
|
||
for directory in os.environ.get("PATH", "").split(os.pathsep):
|
||
if not directory:
|
||
continue
|
||
for ext in [""] + exts:
|
||
candidate = os.path.join(directory, name + ext.lower())
|
||
if os.path.isfile(candidate):
|
||
return candidate
|
||
return ""
|
||
|
||
|
||
def pick(root: str) -> tuple[str, str] | None:
|
||
for label, exe in candidates(root):
|
||
if exe and os.path.isfile(exe):
|
||
return label, exe
|
||
return None
|
||
|
||
|
||
def fail(message: str, root: str) -> int:
|
||
print(f"[gate_python] {message}", file=sys.stderr)
|
||
print("[gate_python] 解释器候选检查结果:", file=sys.stderr)
|
||
for label, exe in candidates(root):
|
||
state = "可用" if exe and os.path.isfile(exe) else "不存在"
|
||
print(f" {label:<16} {exe or '<未设置>'} [{state}]", file=sys.stderr)
|
||
print(
|
||
"[gate_python] 修复:按下面任一方式让第 2 个候选就位——\n"
|
||
" python -m venv .venv && .venv/Scripts/python.exe -m pip install -r requirements.txt\n"
|
||
" 或临时指定:set DTU_GATE_PYTHON=<某个装了依赖的 python.exe>\n"
|
||
" 详细规程 → docs/环境与部署/本地工具路径环境变量方案.md §5",
|
||
file=sys.stderr,
|
||
)
|
||
return 2
|
||
|
||
|
||
def main(argv: list[str]) -> int:
|
||
root = repo_root()
|
||
if len(argv) < 2:
|
||
return fail("缺少目标脚本参数(用法:gate_python.py <脚本> [参数...])", root)
|
||
|
||
target = argv[1]
|
||
if not os.path.isabs(target):
|
||
target = os.path.join(root, target)
|
||
if not os.path.isfile(target):
|
||
return fail(f"目标脚本不存在:{argv[1]}", root)
|
||
|
||
chosen = pick(root)
|
||
if chosen is None:
|
||
return fail("找不到可用的解释器", root)
|
||
label, exe = chosen
|
||
|
||
if os.environ.get("DTU_GATE_VERBOSE"):
|
||
print(f"[gate_python] {label} -> {exe}", file=sys.stderr)
|
||
|
||
env = dict(os.environ)
|
||
env["DTU_GATE_PYTHON"] = exe
|
||
child_argv = [exe, target, *argv[2:]]
|
||
|
||
# 用 subprocess 而非 os.execve 转交:理由见文件头「为什么用 subprocess 转交」。
|
||
# 关键纪律:子进程的退出码必须原样透传;启动器自身任何异常都必须落到 2,
|
||
# 绝不允许以 0 退出——0 在 pre-commit 眼里就是「检查通过」。
|
||
try:
|
||
completed = subprocess.run(child_argv, env=env)
|
||
except OSError as exc:
|
||
print(f"[gate_python] 启动子解释器失败:{exc}", file=sys.stderr)
|
||
return 2
|
||
return completed.returncode
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main(sys.argv))
|