4. 上位机软件环境搭建
这一章我们聊聊上位机环境搭建。说白了，就是让你的电脑能跟振镜控制器「对上话」。我在现场遇到过不少情况——硬件接好了，线缆也检查了，就是打不了标。回头一查，驱动没装对，或者SDK版本不兼容。嗯，这些坑其实都可以提前避开。
操作系统 → 驱动 → SDK → 配置测试，四步走，一步都别跳。
4.1 操作系统要求
先讲操作系统。我个人习惯首选 Windows 10 专业版（64位），打标软件和驱动对Windows的兼容性最好。如果你用的是Windows 11，也可以，但要注意系统版本号不低于22H2，否则某些老款USB驱动会报签名错误。
Linux环境呢？能用，但不推荐给刚接触的新手。有些厂商的SDK只提供Windows版，Linux下得自己编译源码。我在客户现场见过Ubuntu 18.04配RTC5卡，折腾了三天才跑起来——实在没必要。如果你非要在Linux上搞，尽量选Ubuntu 18.04或20.04 LTS，内核5.4以上，提前装好libusb和cmake。
| 操作系统 | 版本要求 | 备注 |
|---|---|---|
| Windows 10 | Pro/Enterprise 64位，1909及以上 | 强烈推荐，驱动最全 |
| Windows 11 | 22H2及以上 | 注意驱动签名问题 |
| Ubuntu | 18.04 LTS / 20.04 LTS | 需手动编译部分驱动 |
| 其他Linux发行版 | 内核≥5.4 | 不优先支持，自行踩坑 |
4.2 驱动安装
驱动分为三大类：USB驱动、网口驱动、PCIe驱动。目前市面上主流振镜卡（比如RTC5、RTC6、×××）大多走USB或以太网口。
4.2.1 USB驱动
插入USB线后，设备管理器里通常会显示一个未知设备。这时候需要手动指定驱动路径。我一般这样做：
- 打开设备管理器，右键未知设备 → 更新驱动程序
- 选择「浏览我的电脑以查找驱动程序」
- 指向厂商提供的驱动文件夹（比如
C:\Drivers\RTC6_USB） - 如果提示未签名，重启电脑按F8进入「禁用驱动程序签名强制」模式
4.2.2 网口驱动
网口驱动通常就是标准的TCP/IP协议栈，不需要额外安装。但有一个坑：振镜控制器默认IP地址可能是192.168.0.100，你需要把电脑的IP改成同网段（比如192.168.0.50），才能Ping通。我曾经遇到过客户把子网掩码设成255.255.0.0，结果怎么也连不上。
4.2.3 PCIe驱动
老款PCIe卡需要安装厂商的专有驱动程序。安装时最好关掉杀毒软件，否则容易误报。驱动装完后去设备管理器看看，如果出现「××× Laser Control Card」且没有感叹号，说明成功了。
4.3 SDK下载与配置
SDK是控制振镜的核心库。不同厂商的SDK命名五花八门，但逻辑差不多：一个开发包，里面包含头文件、库文件、示例代码和文档。
4.3.1 下载SDK
去厂商官网找「下载中心」或「技术支持」页面。注意区分：64位和32位版本别搞混。我习惯下载最新稳定版，但别追太新的beta版——有一次我用了某个厂商的RC版SDK，结果API函数名都改了，示例代码编译不过，又退回旧版才解决。
4.3.2 配置环境变量
把SDK的bin目录添加到系统PATH，这样你写的程序运行时能找到DLL。具体操作：
- 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
- 编辑系统变量中的
Path，添加一行：C:\SDK\RTC6\bin\x64 - 注意放置顺序：尽量把厂商DLL路径放在前面，避免被其他同名DLL覆盖
4.3.3 配置开发环境
如果你用Visual Studio，需要在项目属性里设置附加包含目录和附加库目录。举个例子：
项目 → 属性 → VC++目录
包含目录：C:\SDK\RTC6\include
库目录：C:\SDK\RTC6\lib\x64
链接器 → 输入 → 附加依赖项：
RTC6dll.lib
winmm.lib4.3.4 测试连接
把示例代码里的Connect()函数跑一下。如果返回0，说明连上了。如果返回负数，查错误码表。我见过的常见错误：
- -1：USB未识别，重装驱动
- -2：IP地址不对，检查网络设置
- -3：SDK版本不匹配，换对应版本
好了，环境搭建的逻辑大概就是这些。下面用一张图把流程串起来：
到这里，环境搭建就搞定了。别急着往下走——先把驱动和SDK测通，后面的调试工作才会顺畅。说白了，这一步就像盖楼打地基，马虎不得。