Python 脚本与 REPL

运行位置

Python 窗口连接 BeiniLink MCU 上的 Python REPL，可运行简单的脚本，代码在设备上运行，不是电脑上的 Python。支持哪些 machine API 取决于当前固件。

启用 Python 模块后，本次工程启动只打开 Python，其他 CAN/LIN/UART 模块不同时启动。退出脚本测试后，先停止工程并禁用 Python，再启动协议模块。

第一段脚本

1. 添加 Python 模块，通常使用默认 115200、8 数据位、1 停止位、无校验。
2. 启动工程，打开 Python 窗口。
3. 输入以下代码，点击运行全部，查看控制台：

import machine
print("BeiniLink REPL")
machine.version()

可以选择一段代码后运行选中内容，也可在快捷命令区输入单行命令。右侧 API 分组可插入 GPIO、UART、CAN、LIN、UDS、文件和系统等示例命令。发送完成只表示命令已交给 REPL，结果和异常需查看控制台。

Python 窗口包含 machine 指令目录、代码编辑区和 REPL。图中控制台文字为演示内容。

脚本与工程保存

当前编辑区内容保存在本机应用存储，不内嵌到 .blproj。分享工程时应另外保存脚本文件。运行编辑区代码不会自动把它保存成设备 U 盘中的 main.py。

设备文件和启动脚本是独立机制。需要上电自动执行时，使用与固件匹配的文件及启动配置；先验证短脚本，再设置自动运行。不同固件的启动恢复策略可能不同。

脚本调试

先执行版本查询和简单输出，再加入硬件操作。硬件 API 的引脚名、资源占用和参数应以该版本固件的 API 文档为准。CAN/LIN 初始化会占用对应硬件，不能同时让另一个会话控制它。

控制台的清空操作只清除显示，不终止正在运行的脚本。持续循环或阻塞代码可能使 REPL 不响应；软件复位要求 MCU 和 USB 控制链路仍能处理命令，不能保证恢复死循环或缺失的 USB 设备。