motionlcm 安装部署与实战指南：从环境搭建到项目集成

2.1 安装系统基础依赖#

        打开终端，执行以下命令安装编译工具、依赖库（适用于 Ubuntu 20.04/22.04）：

1
# 更新apt源
2

3
sudo apt update && sudo apt upgrade -y
4

5
# 安装编译工具（gcc/g++/make）、CMake、依赖库
6

7
sudo apt install -y build-essential cmake git libglib2.0-dev libzmq3-dev python3-dev python3-pip

• build-essential：包含 gcc、g++、make 等编译工具，是源码编译的基础；

• libglib2.0-dev：LCM 依赖的 glib 库（用于事件循环、数据处理）；

• libzmq3-dev：ZeroMQ 库（LCM 的通信底层依赖，支持跨节点通信）。

2.2 源码编译安装 LCM#

• 克隆 LCM 官方仓库推荐从 GitHub 获取最新稳定版：

1
# 克隆仓库到本地（可自定义路径，此处为用户目录）
2

3
git clone https://github.com/lcm-proj/lcm.git ~/lcm_source
4

5
cd ~/lcm_source
6

7
# 可选：切换到稳定版本（如v1.5.0，避免开发分支不稳定）
8

9
git checkout v1.5.0

• 创建编译目录并生成 Makefile：

1
# 新建build目录（避免污染源码）
2

3
mkdir build && cd build
4

5
# CMake配置：指定安装路径为/usr/local（系统默认库路径，便于后续调用）
6

7
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local \
8

9
-DCMAKE_BUILD_TYPE=Release # Release模式：优化编译，适合生产环境

• 若 CMake 执行报错 “Could NOT find GLib” 或 “Could NOT find ZeroMQ”，需重新执行 2.1 步骤确认依赖安装完整，或手动指定依赖路径。
• 编译与安装：

1
# 多线程编译（-j$(nproc)：根据CPU核心数自动分配线程，加快速度）
2

3
make -j$(nproc)
4

5
# 安装到/usr/local（需sudo权限，系统级安装）
6

7
sudo make install

• 验证 LCM 安装成功：

执行lcm-spy命令（LCM 自带的消息监听工具），若出现如下界面，说明 LCM 安装成功：

1
LCM Spy (press 'h' for help)
2

3
No messages received yet...

• 若提示 “command not found”，执行source /etc/profile刷新环境变量（Ubuntu 默认将 /usr/local/bin 加入 PATH，刷新后即可识别 lcm 命令）。

3.1 方式 1：作为项目子模块获取#

        若你在开发某个包含 motionlcm 的项目（如自动驾驶决策模块），motionlcm 可能以 Git 子模块形式存在于项目中，需执行以下命令拉取：

1
# 进入项目根目录
2

3
cd ~/your_project（如autonomous_driving）
4

5
# 初始化并更新子模块（包含motionlcm）
6

7
git submodule update --init --recursive
8

9
# 进入motionlcm目录（子模块路径通常为third_party/motionlcm或src/motionlcm，以项目实际结构为准）
10

11
cd third_party/motionlcm

3.2 方式 2：单独仓库克隆#

        若 motionlcm 有独立开源仓库（如项目文档提供链接），直接克隆即可：

1
# 替换为实际motionlcm仓库地址（示例地址仅为演示）
2

3
git clone git@github.com:xxx/motionlcm.git ~/motionlcm_source
4

5
cd ~/motionlcm_source

关键提醒：查看 README.md！#

        进入 motionlcm 目录后，优先阅读 README.md，文档中会标注：

• 特殊依赖（如 Eigen 线性代数库、特定机器人 SDK）；

• 编译参数（如是否启用 Python 绑定、指定通信端口）；

• 测试用例位置（后续验证部署需用到）。

4.1 安装 motionlcm 特殊依赖（以常见需求为例）#

        多数 motionlcm 项目依赖 Eigen（用于运动学矩阵计算），若 README.md 提及，执行以下命令安装：

1
sudo apt install -y libeigen3-dev # Eigen 3.3.x版本，适配多数项目

• 若依赖其他库（如 ROS 相关包、自定义运动控制库），需根据 README.md 补充安装（示例：sudo apt install ros-noetic-robot-state-publisher，ROS 版本需与项目匹配）。

4.2 CMake 编译与安装#

1. 创建编译目录并配置：

1
# 进入motionlcm源码目录
2

3
cd ~/motionlcm_source
4

5
# 新建build目录
6

7
mkdir build && cd build
8

9
# CMake配置：关联LCM，指定安装路径（此处为/usr/local，与LCM同路径，便于后续调用）
10

11
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local \
12

13
-DLCM_INCLUDE_DIR=/usr/local/include \ # LCM头文件路径（若默认可省略）
14

15
-DLCM_LIBRARY=/usr/local/lib/liblcm.so # LCM库文件路径（若默认可省略）

• 若 CMake 报错 “Could NOT find motionlcm dependencies”，需检查：

1. LCM 是否安装成功（lcm-spy可正常启动）；
2. 特殊依赖是否安装；
3. 手动指定依赖路径。
4. 编译与安装：

1
# 多线程编译
2

3
make -j$(nproc)
4

5
# 安装到/usr/local（系统级，后续项目可直接调用）
6

7
sudo make install

• 若安装到自定义路径，将CMAKE_INSTALL_PREFIX改为对应路径，且无需 sudo（示例：-DCMAKE_INSTALL_PREFIX=~/motionlcm_install）。

5.1 编辑.bashrc 文件#

1
# 打开终端配置文件（Ubuntu默认使用bash，若为zsh则编辑~/.zshrc）
2

3
nano ~/.bashrc

5.2 添加环境变量#

        在文件末尾添加以下内容（替换为你的自定义安装路径）：

1
# motionlcm环境变量配置
2

3
export MOTIONLCM_INCLUDE_DIR=~/motionlcm_install/include # 头文件路径
4

5
export MOTIONLCM_LIB_DIR=~/motionlcm_install/lib # 库文件路径
6

7
# 动态库路径：让系统加载motionlcm的.so库
8

9
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MOTIONLCM_LIB_DIR
10

11
# 可选：Python绑定路径（若motionlcm支持Python调用）
12

13
export PYTHONPATH=$PYTHONPATH:$MOTIONLCM_LIB_DIR/python3.8/site-packages

5.3 生效环境变量#

1
# 刷新.bashrc，让配置立即生效
2

3
source ~/.bashrc
4

5
# 验证：查看环境变量是否正确设置
6

7
echo $MOTIONLCM_INCLUDE_DIR # 输出应为你的自定义路径

6.1 运行 motionlcm 自带测试用例#

        多数 motionlcm 项目会提供测试程序（位于test/或examples/目录），执行步骤如下：

1. 进入 motionlcm 编译后的build目录：

1
cd ~/motionlcm_source/build

1. 若有test目录，进入并执行测试程序：

1
cd test
2

3
./motionlcm_test # 测试程序名称以实际为准，可能为test_motionlcm、motionlcm_example等

• 若输出 “Test passed!” 或无报错，且能正常打印运动指令 / 状态数据，说明 motionlcm 功能正常；

• 若报错 “libmotionlcm.so: cannot open shared object file”，需重新执行 5.3 步骤刷新LD_LIBRARY_PATH。

问题 1：CMake 找不到 LCM/motionlcm#

• 原因：安装路径未加入 CMake 搜索范围，或环境变量未配置；

• 解决：

1. 确认 LCM/motionlcm 安装路径；
2. CMake 配置时手动指定路径（参考步骤 4.2.1、6.2.1 的-DLCM_INCLUDE_DIR、MOTIONLCM_INCLUDE_DIR参数）；
3. 刷新环境变量（source ~/.bashrc）。

问题 2：运行程序时提示 “undefined reference to motionlcm::xxx”#

• 原因：项目未链接 motionlcm 库，或链接顺序错误；

• 解决：

1. 在target_link_libraries中确认添加${MOTIONLCM_LIBRARY}；
2. 确保 motionlcm 库在依赖它的代码之后链接（如target_link_libraries(your_main ${MOTIONLCM_LIBRARY} lcm)，而非反过来）。

问题 3：LCM 消息监听不到 motionlcm 发送的数据#

• 原因：LCM 通信配置错误（如网络端口、主题名称不匹配）；

• 解决：

1. 确认发送端与接收端的 LCM 主题名称一致（如均为 “ROBOT_MOTION_CMD”）；
2. 若跨设备通信，设置 LCM 网络环境变量（export LCM_DEFAULT_URL=udp://239.255.76.67:7667，两端需相同）；
3. 用lcm-spy在接收端监听主题，排查是否为发送端问题。

问题 4：motionlcm 源码编译报错 “C++11 required”#

• 原因：motionlcm 依赖 C++11 及以上标准，CMake 未配置；

• 解决：在 motionlcm 的CMakeLists.txt中添加：

1
set(CMAKE_CXX_STANDARD 11)
2

3
set(CMAKE_CXX_STANDARD_REQUIRED ON)