接口工程示例与工程结构

入门模板

接口工程模板可通过“文件 → 打开”读取。打开后先另存到自己的测试目录，再选择实际设备。模板不包含数据库、日志、节点仿真或自动周期任务；CAN/LIN/UART 示例行使用手动触发。它们是配置示例，不是硬件验证结果。

模板	接口配置	开始测试
can-classic.blproj	CAN 500 kbit/s，经典，正常模式	手动发送 0x555 的 8 字节帧
can-fd.blproj	CAN 500 kbit/s，FD 配置 2 Mbit/s	手动发送 CANFD 8 字节帧，当前该行无 BRS
can-monitor.blproj	CAN 500 kbit/s，只听	对端发送，观察 RX；该节点不提供 ACK
lin-master.blproj	LIN 19200，主节点	手动发送 3C，或请求 3D 的 8 字节响应
lin-slave.blproj	LIN 19200，从节点，空响应表	先监听，再自行添加需响应的 ID
uart.blproj	UART 115200	UART Trace 或 UART 发送 AA 55 01
uart2can.blproj	Uart2CAN 115200	UART Trace 选择 Uart2CAN 通道
uart2lin.blproj	Uart2LIN 19200	UART Trace 选择 Uart2LIN 通道
python.blproj	Python 115200，8N1	在 Python 窗口查询 machine.version()

LIN 主节点模板的 REQUEST 没有对端响应时会超时，这是请求测试的结果，不代表帧头未发出。CAN 模板发送前需要正确速率及可提供 ACK 的对端。

联合工程

建立 CAN + LIN + UART 工程时，添加三个模块并分别配置。给 Logger 选择总线来源，另加一个 UART Logger，保存工程。启动后先检查是否为“3/3”，再分别测试单帧；确认无误后启用必要周期任务。

接收监控工程应关闭节点仿真及回放，CAN 需要只听时选择只听模式，LIN 从节点保持响应表为空。配置“监控”不应同时遗留主动发送任务。

.blproj 保存内容

工程包含设备 PID、硬件模块参数、CAN/LIN/UART 调度行、LIN 响应、数据库路径、日志配置、节点仿真配置、图表信号、用户变量、面板布局与绑定、回放配置和窗口布局。工程不包含完整历史 Trace、DBC/LDF 文件正文、日志文件或 Python 编辑区代码。

分享工程时准备“工程 + 数据库 + 脚本 + 所需回放文件”，在目标电脑重新选择路径。日志输出文件夹应改到本机可写位置。

AI 修改与离线校验

.blproj 是 JSON，可由 AI 修改。先保留原文件，修改后用 CLI 检查：

beinilink-cli project validate --file .\Demo.blproj --output json
beinilink-cli project validate --file .\Demo.blproj --check-files
beinilink-cli project schema --output json
beinilink-cli help project validate

校验不连接设备，也不修改工程。错误包含字段位置；退出码 0 表示通过（可能有警告），2 表示输入无效。检查字段类型、参数范围、接口互斥、调度槽位和数据长度；--check-files 额外检查数据库与回放输入文件是否存在。相对路径按程序工作目录解析，不是工程文件所在目录。

通过校验后仍需在软件中检查配置。校验不确认硬件连通、数据库信号/节点是否存在、输出文件夹权限或窗口布局内部结构。