第二章 开发环境搭建：Visual Studio安装、运动控制卡SDK安装、第一个控制台程序
说实话，很多新手一上来就急着写代码，结果卡在环境搭建上半天动不了。我见过太多人，买了运动控制卡，SDK装不上，或者装上了不知道怎么用。这一章，咱们就把这些基础活儿干利索。
嗯，先说说我的习惯。我一般会把开发环境分成三块：编译器（Visual Studio）、硬件驱动（运动控制卡）、以及SDK开发包。这三样东西，缺一个你都跑不起来。
2.1 Visual Studio安装——别选错版本
Visual Studio版本很多，社区版、专业版、企业版。我个人建议用Visual Studio 2022 Community，免费，功能也够用。你想想看，咱们做运动控制，又不是搞大型分布式系统，社区版完全能扛住。
安装的时候，有几点要注意：
- 工作负载选择：一定要勾选「使用C++的桌面开发」。我遇到过有人只装了.NET，结果C++项目死活编译不过。
- 单个组件：建议把「Windows 10 SDK」和「Windows 11 SDK」都装上。有些运动控制卡的驱动依赖特定版本的SDK。
- 安装位置：别放C盘。我吃过这个亏，C盘满了，编译一次卡半天。
2.2 运动控制卡SDK安装——这一步最容易踩坑
运动控制卡的SDK，每家厂商的安装方式都不一样。但大体上，流程是类似的。我以雷赛、固高、或者研华这些常见品牌为例，说说通用步骤。
第一步：安装驱动
先把控制卡插到PCIe插槽上，开机。Windows一般会提示发现新硬件。这时候，别让它自动搜驱动，手动指定到厂商提供的驱动文件夹里。我曾经有一次偷懒，让Windows自己装，结果装了个通用驱动，控制卡根本认不出来。
第二步：安装SDK开发包
厂商一般会提供一个安装包，里面包含：
- 头文件（.h）
- 库文件（.lib、.dll）
- 示例代码
- 帮助文档
安装路径，我建议统一放在 C:\MotionSDK 或者 D:\MotionSDK 下。别散得到处都是，不然以后找起来头疼。
第三步：验证安装
打开设备管理器，看看有没有出现「运动控制卡」或者类似的设备。如果没有，说明驱动没装好。这时候，别急着重装，先换个PCIe插槽试试。我有个项目，换了插槽就好了，原因是主板某个插槽供电不足。
2.3 第一个控制台程序——让电机动起来
环境搭好了，咱们写个最简单的程序。目标：让电机转一圈。说白了，就是调用SDK里的一个函数，发一个脉冲指令。
打开Visual Studio，新建一个C++控制台应用。然后，配置项目属性：
| 配置项 | 设置值 |
|---|---|
| 附加包含目录 | C:\MotionSDK\include |
| 附加库目录 | C:\MotionSDK\lib |
| 附加依赖项 | MotionCtrl.lib（具体名字看厂商） |
配置好之后，写代码：
#include <iostream>
#include "MotionCtrl.h" // 厂商提供的头文件
int main()
{
// 1. 打开设备
int ret = MC_Open(0); // 0 表示第一个控制卡
if (ret != 0) {
std::cout << "打开设备失败，错误码：" << ret << std::endl;
return -1;
}
// 2. 设置轴参数
MC_SetAxisParam(0, 1, 1000); // 轴0，加速度1000
MC_SetAxisParam(0, 2, 500); // 轴0，减速度500
// 3. 发脉冲，让电机转10000个脉冲
ret = MC_Move(0, 10000);
if (ret != 0) {
std::cout << "运动指令失败" << std::endl;
} else {
std::cout << "电机开始运动！" << std::endl;
}
// 4. 等待运动完成
MC_WaitForDone(0, 10000); // 超时10秒
// 5. 关闭设备
MC_Close(0);
return 0;
}
这段代码，说白了就是：打开卡 → 设参数 → 发指令 → 等完成 → 关卡。所有运动控制程序，都逃不出这个框架。
- 打开设备时，返回值一定要检查。非0就是失败。
- 轴参数设置，加速度和减速度别设太大，不然电机会抖动。我一般从1000开始试。
- 等待运动完成，一定要加超时。不然电机卡住了，程序就死在那了。
2.4 常见问题与避坑
写第一个程序，肯定会遇到问题。我列几个常见的：
- 编译报错：找不到头文件——检查附加包含目录配了没。
- 链接报错：无法解析的外部符号——检查附加依赖项里的.lib文件名对不对。
- 运行时提示找不到DLL——把厂商的.dll文件复制到exe同目录下，或者放到系统路径里。
- 电机不动——先检查控制卡上的指示灯亮不亮。如果不亮，可能是没供电。
嗯，这一章就到这。环境搭好了，程序能跑了，后面的事情就好办了。下一章，咱们聊聊运动控制的核心——点位运动与速度规划。到时候，我会分享一些实际项目中调参的心得。