未列出端口

现象

您点击端口选择器中的Refresh，但列表中没有您的设备。可能会显示其他端口，也可能一个都没有。

Beam Bench会向操作系统请求可用串口。操作系统只能列出它能看到的端口，这需要正常工作的驱动进程和已连接的设备。如果此处缺少该端口，操作系统也看不到它。

看似显而易见，但值得检查。插接设备、开机，然后点击Refresh。

某些USB电缆（尤其是充电器套装中的短线）只能供电，不能传输数据。换用一根确认可用的USB数据线。

对于大多数二极管激光器和小型CO2激光器，USB串口芯片是CH340或CP210x。Windows默认不附带该驱动进程。

打开Device Manager。
如果看到带有警告标志的“USB Serial”或“Unknown device”，则需要安装驱动进程。
下载CH340驱动进程（搜索“CH340 driver Windows”）或CP210x驱动进程（Silicon Labs CP210x VCP driver），然后安装。
安装后，拔出并重新插接设备。此时端口应会显示。

该端口可能存在，但对您的用户不可见。将自己添加到 dialout 组：

sudo usermod -aG dialout $USER

注销并重新登录。此时端口应会显示。

当筛选器隐藏了部分端口时，设备设置的连接选项卡中会显示 Show all ports 复选框。试试看。

某些macOS版本会提示允许访问串口。检查System Settings → Privacy & Security中是否有Beam Bench的提示，然后允许访问。

如果Beam Bench看不到该端口，但操作系统能看到，这是Beam Bench的错误，请提交报告。

macOS / Linux：

ls /dev/cu.* /dev/tty.* /dev/ttyUSB* /dev/ttyACM*

如果操作系统也看不到该端口，问题出在电缆、驱动进程或硬件上，而不是Beam Bench。