机器人端部署
程序运行在机器人 Orin 上,适合生产环境与实时性要求高的应用。
PC端部署
程序运行在 PC 上,支持 Ubuntu、WSL2、VMWare 开发调试环境。
Docker部署
SDK 与运行依赖放在容器内,适合需要隔离环境的场景。
PC端部署 - WSL2
适用场景: 开发调试,快速迭代
特点: 开发便捷,支持局域网远程控制
1. 物理连接
PC 通过以太网转接板与机器人相连。转接板用于把标准 RJ45 网线接口转换为机器人专用的以太网接口,使用步骤如下:
1.1 将网线一端插入转接板的 RJ45 接口,另一端连接到 PC 网口
1.2 将转接板的另一端插入机器人背部对应的以太网接口

连接完成后整体走线如下图所示:

2. 配置网络
2.1 配置PC网口IP
- IP地址:
192.168.1.99(或同网段其他地址) - 子网掩码:
255.255.255.0
使用WSL2时,需要在Windows系统的当前用户目录下创建.wslconfig文件,并新增networkingMode=Mirrored,示例:

IP在Windows系统进行设置

验证配置:
ifconfig
预期输出
显示 inet 192.168.1.99

防火墙提醒
如果测试SDK接口失败,请在 管理员 PowerShell 执行:
Set-NetFirewallProfile -Profile Domain,Private,Public -Enabled False
联调完成后建议立即恢复:
Set-NetFirewallProfile -Profile Domain,Private,Public -Enabled True
2.2 一键配置PC、XCU、HPU端IP
前提条件
PC、XCU、HPU 三者需能互相 ping 通
在SDK目录下执行 configure_embosa_ip.sh 脚本,配置PC端的IP(以 PC: 192.168.1.99、XCU: 192.168.1.66、HPU: 192.168.1.88 为例):
./configure_embosa_ip.sh
脚本启动后依次提示输入以下信息:
请输入配置的 PC IP: 192.168.1.99 # 必填
请输入配置的 XCU IP [默认 192.168.1.66]: # 直接回车使用默认值
请输入配置的 HPU IP [默认 192.168.1.88]: # 直接回车使用默认值
脚本将自动完成 PC、XCU、HPU 三端的 embosa IP 配置并重启各端 launcher。
3. 在PC上安装SDK
进入到SDK目录下执行安装脚本
cd GalbotSDK
./install.sh
4. 编译程序
在PC上编译(x86_64)
cd examples/cpp/
mkdir -p build
cd build
cmake ../ -DCMAKE_TOOLCHAIN_FILE=../cmake/linux-x86_64-gcc940.cmake
make
5. 运行程序
5.1 配置环境变量
路径说明
/opt/galbot/为默认安装路径,可根据自己的安装路径进行修改
source /opt/galbot/galbot_sdk/linux-x86_64-gcc940/setup.sh
环境变量持久化
echo 'source /opt/galbot/galbot_sdk/linux-x86_64-gcc940/setup.sh' >> ~/.bashrc
source ~/.bashrc
5.2 运行C++程序
cd /userdata # 或程序所在目录
./your_app
5.3 运行Python程序
python your_app.py
python相关库安装
在运行python example时依赖一些库,所以请先运行下面的脚本保证相关库已安装:
cd GalbotSDK
./install_python_deps.sh