设备设置
连接、机器配置文档、GRBL设置、控制器信息、设备发现和配置文档管理。用于设置机器的对话框。
设备设置对话框（在应用中标题为 设备 ）用于连接机器、管理机器配置文档、查看实时GRBL设置，以及检查设备发现候选项。
这是首次设置Beam Bench时最常用的对话框，之后很少使用。
打开方式
- 激光控制 → 管理机器配置文档...
- 也可通过激光控制中的设备行访问。
该对话框以可移动、可调整大小的窗口打开，包含 六个选项卡：
- 连接：端口、波特率、配置文档、连接/断开连接
- 机器：快速编辑活动配置文档的机器级设置
- GRBL设置：控制器中的实时
$值，以及“应用到活动配置文件” - 控制器信息：只读的控制器标识信息
- 发现：扫描串行设备，并检查提供给后端的TCP/USB候选项
- 配置文档：完整的机器配置文档编辑器
底部始终显示 关闭 按钮。
连接选项卡
握手控制项。连接后大多数字段会被禁用。
| 字段 | 类型 | 说明 |
|---|---|---|
| 端口 | 选择框 | 列出可用串行端口。占位文本：未找到激光端口 或 选择端口 。 |
| 刷新端口（↻） | 按钮 | 重新扫描可用端口。 |
| 显示所有端口（隐藏[N]个） | 复选框 | 仅当端口因名称筛选而被隐藏时显示。 |
| 波特率 | 选择框 | 9600 / 19200 / 38400 / 57600 / 115200 / 230400。 |
| 配置文档 | 选择框 | 选择用于此连接的机器配置文档。 |
| 连接/断开连接 | 按钮 | 根据状态切换。未选择端口时禁用。 |
状态指示器（彩色圆点+标签）显示当前会话状态：
| 标签 | 颜色 | 含义 |
|---|---|---|
| 已断开 | 灰色 | 未连接。 |
| 正在连接.../正在打开.../等待中.../正在验证... | 黄色 | 正在进行握手。 |
| 就绪 | 绿色 | 已连接且空闲。 |
| 运行中 | 青色 | 作业正在运行。 |
| 已暂停 | 琥珀色 | 作业已暂停。 |
| ALARM | 红色 | 机器处于报警状态。 |
| 错误 | 红色 | 通信失败。 |
机器选项卡
用于快速编辑 活动 配置文档的字段。在此处编辑会将配置文档标记为已修改。切换选项卡或关闭前请保存。
| 字段 | 类型 | 范围 |
|---|---|---|
| 工作台宽度 | 数字 | 标签和值遵循 显示单位；配置文档以mm存储。 |
| 工作台高度 | 数字 | 标签和值遵循 显示单位；配置文档以mm存储。 |
| 最大速度 | 数字 | 标签和值遵循 显示单位 和所选速度时间单位；配置文档以mm/min存储。 |
| 最大功率(%) | 数字 | 仅限制手动 点射 按钮，不限制图层功率或计划作业输出。 |
| 回零 | 开关 | |
| 原点 | 选择框 | 左下 或 左上 |
| 作业检查清单 | 开关 | |
| 连续框选 | 开关 | |
| 激光开启框选 | 开关 | |
| 启用点射按钮 | 开关 | 默认隐藏。在移动面板中启用按住点射测试按钮。 |
| 点射功率 (%) | 数字 | 0.1-100，启用点射按钮后显示。默认值1.0表示1%。 |
| 连接点脉冲宽度 (ms) | 数字 | 0–10000；为兼容性而存储，目前生产规划器或G-code生成器不会使用。 |
| CNC机器 | 开关 |
相机元数据部分
- 已选相机：活动相机标识符的文本字段。
- 校准：显示 已保存 或 无；已保存时显示 清除 。
- 对齐：显示 已保存 或 无；已保存时显示 清除 。
输出策略部分
- 恒定功率(M3)：开关
- 每个G1都发送S：开关
- 最大 S 值：数字，最小值为1
- 使用G0进行过扫描：开关
校准部分
- 启用点宽校正：开关。启用后，在当前 显示单位 下显示 点宽；配置文档以mm存储。
- 启用扫描偏移：开关。启用后显示 扫描偏移表 和 添加条目 按钮。 速度 遵循 显示单位 和所选速度时间单位，同时以mm/min存储；偏移 遵循 显示单位，同时以mm存储。
底部按钮：保存 。
如果在有未保存更改时切换选项卡或关闭，会显示 是否在关闭前保存机器配置文档更改？，选项为 继续编辑/放弃/保存并关闭 。
GRBL设置选项卡
查看机器的 $ 设置。
- 每个设置占一行，按键排序（
$0、$1、$2……）。 - 点击值可进行行内编辑。点击 确定 保存，点击 取消 还原。系统会验证数字输入。
标题面板说明：将实时GRBL值应用到活动配置文件：$30 → 最大 S 值，$110/$111 → 最大速度。 应用到活动配置文件 按钮会将这些值复制到活动配置文档。没有活动配置文档或没有可解析的值时，该按钮禁用。
状态包括：获取过程中显示 正在加载GRBL设置...；失败时以红色显示错误；为空时显示 没有可用的GRBL设置 。
控制器信息选项卡
显示控制器提供的只读键值对，按键排序。当你需要准确了解所使用的固件版本时非常有用。
发现选项卡
自动检测串行机器并检查发现候选项。
- 刷新：重新读取当前状态。
- 扫描：开始新的设备发现扫描。
- 取消：仅在扫描过程中显示。
摘要行显示 串行[N]·TCP[N]·USB[N] 。在正常桌面流程中，扫描 主要检查串行端口。TCP和USB数据包候选项会在集成或后端调用提供这些候选项时显示。
每张发现的设备卡片显示：名称、控制器系列/型号/传输方式、状态文本、适用时以黄色显示的不支持原因说明、置信度百分比，以及两个按钮：
- 创建引导配置文档：根据此设备创建新的机器配置文档。
- 连接：使用默认配置文档匹配进行连接。
空状态：尚无发现候选项。点击“扫描”搜索设备。
配置文档选项卡
完整的配置文档编辑器。分为两列：左侧为配置文档列表，右侧为表单。
左列
- 按名称显示每个配置文档。活动配置文档标记为 （活动） 。
- 底部有 新建 按钮。
右列（选中配置文档时）
| 字段 | 类型/说明 |
|---|---|
| 名称 | 文本 |
| 宽度 | 数字；标签和值遵循 显示单位，以mm存储 |
| 高度 | 数字；标签和值遵循 显示单位，以mm存储 |
| 最大速度 | 数字；标签和值遵循 显示单位 和所选速度时间单位，以mm/min存储 |
| 最大功率% | 数字；仅限制手动 点射 按钮，不限制图层功率或计划作业输出 |
| 回零 | 开关 |
| 波特率 | 选择框9600–230400 |
| 固件 | 文本 |
| 原点 | 左下 或 左上 |
| 启用点射按钮 | 开关 |
| 点射功率 (%) | 数字，启用点射按钮后显示 |
| 备注 | 文本 |
机器预设面板（将已知良好的预设应用到配置文档）显示在备注下方。
其下方是 相机元数据 、展开的 输出策略 和 校准 部分（与机器选项卡中的控件相同，但包含额外的输出策略字段）：
- 辅助气体命令：
M7/M8/自定义 - 辅助气体开启G-code：文本
- 辅助气体关闭G-code：文本
- 辅助气体延迟(ms)：数字，最小值为0，步长为50
- 起始 G-code：文本
- 结束 G-code：文本
- 帮助文本：页眉/页脚命令应用于整个作业。对于按图层控制，请使用切割入口辅助气体。
- 流式传输：缓冲 或 同步 。选择同步时会显示琥珀色警告：同步流式传输速度慢得多，适用于诊断。
右下角操作按钮：
- 保存：提交编辑内容。
- 删除（红色），编辑活动配置文档时禁用。
- 设为活动（绿色），已经是活动配置文档时禁用。
如果在当前编辑内容已修改时点击其他配置文档（或点击 新建 ），会显示 放弃未保存的机器配置文档更改？，选项为 继续编辑/放弃 。
需要了解的行为
- 连接后所有连接字段都会禁用；更改端口、波特率或配置文档前请先断开连接。
- 点击背景会视为点击关闭。有未保存更改时，会显示保存更改提示。
- 机器选项卡编辑的是活动配置文档。要编辑其他配置文档，请切换到配置文档选项卡。
- GRBL设置编辑会写入 机器，保存后持久化到控制器的EEPROM中。 应用到活动配置文件 会单独将有效的
$30复制到 最大 S 值，并将$110/$111中的较低有效速率复制到 最大速度 。