用途:开发与调试 MicroPython 固件及 Python 应用,涉及 mpremote、REPL、板级端口和冻结模块。
主要能力与要点:需阅读共享嵌入式约定,将源码/构建、设备与物理证据分开记录。记录确切的端口/板卡、MicroPython 修订版本,以及可用的 sys.implementation、sys.platform、os.uname()。宿主机 CPython 语法检查不等于 MicroPython 执行,Unix 端口测试不能证明 MCU 驱动行为。
使用方式:为 mpremote 使用锁定的 uv 环境;选择明确的串口设备或硬件串口标识;查看 mpremote --help,避免自动连接任意首个端口。命令可能进入 raw REPL、中断执行并执行软复位,在输出已连接时需注意。
调试:复现最小脚本与完整 traceback,且不含密钥;区分缺失/冻结模块、不支持的 CPython API、.mpy 兼容性、堆碎片与中断上下文分配。gc.mem_free() 与 gc.mem_alloc() 仅作观察,不保证连续分配成功。使用防回绕的 time.ticks_diff();ticks_ms() 不是无界整数时钟。中断代码须遵循端口特定的分配/异常约束。
限制:设备文件写入、固件擦除/烧录、替换 boot.py/main.py 及复位,均需选定目标与已授权设备状态;更改启动脚本前备份用户文件并保留恢复路径。Unix 端口构建/冒烟验证与板卡调试是不同产出。平台覆盖范围以实际测试组合为准,源码流程不代表所有目标均已测试。