变量

创建定义

在“主页 → 变量”打开管理窗口。点击“添加命名空间”，填写名称并保存；选中该命名空间后再次添加，可以建立多层目录。

选中命名空间，点击“添加变量”。类型支持数值、字符串和数值数组。数值可设置最小值、最大值、单位和枚举表；数组初值以逗号分隔，例如 1, 2, 3。名称使用字母、数字和下划线，首字符为字母或下划线。相同命名空间下的名称不能重复。

双击名称或点击“编辑”修改定义。名称、父节点、范围、初值或枚举无效时，“保存”不可用。测量运行时不能修改定义或删除变量。

变量窗口按命名空间显示工程变量。示例数据。

在面板中使用

新建面板并进入编辑器，添加控件，在属性中点击“绑定”，选择变量。首次绑定会带入数值范围、单位及枚举选项。数值变量可连接滑块、数值输入、进度条、LED 等；字符串和数组连接 Hex/Text 编辑器，路径选择连接字符串。

测量启动后才可写入。多个控件、多个窗口绑定同一变量时共享当前值。变量窗口中双击当前值可编辑；越界或类型错误不会改变变量，错误记录在控制台窗口中。系统变量只读。

记住值和重新启动

可写控件默认开启“记住值”。停止测量时，绑定变量的最后值写入工程，工程标记为已修改。保存 .blproj 后重新打开，下一次启动测量恢复该值。

关闭“记住值”的控件在每次启动时写入自己的初值或初始文本。同一变量同时绑定多个控件时，关闭“记住值”的控件优先；有多个这样的控件时，按面板和控件顺序采用第一个有效初值。

系统变量

Statistics.CAN 包含 BusLoad、BusLoadMax、BusLoadAvg、FrameFreq、Errors、TEC 和 REC；Statistics.LIN 包含 FrameFreq 和 Errors。测量运行时每约 0.5 秒刷新，停止后保留最后一次统计，下一次启动清零。

用户变量定义和记住的值保存在工程中。系统变量、运行时变化历史不保存。删除变量后，原面板绑定保留并显示缺失状态，可重新绑定。

示例和校验

docs/manual/examples/variables.blproj 提供两级命名空间、三种变量类型，以及共享数值变量的面板。示例 CAN 模块使用只听模式；打开后选择实际设备并启动测量。

离线检查使用 beinilink-cli project validate --file variables.blproj --output json。校验会报告非法名称、重复全名、父节点缺失或循环、数值范围、初值及枚举错误。