3. 软件安装指南#

版本兼容性说明

适用版本：本文档适用于 V1.1.3 版本。

版本确认方法：参考【3.1.1 有线连接】登录香橙派后，执行以下命令：

docker ps

在输出信息中检查镜像版本，若显示为 1.1.3 ，即可按本文档继续操作。

旧版本用户：如果您当前使用的是 V1.1.3 以下版本，请先联系我们的技术支持团队获取升级方式。

上位机配置要求

3.1 连接香橙派#

物理连接

使用机器人抽屉里的网线，将上位机（您的电脑）与香橙派直接相连。
上位机网络配置

将电脑有线网卡切换为手动配置模式，并参照以下参数设置 IPv4：

配置项参数值说明

IP 地址 192.168.11.xxx xxx取值范围：1-254（需避开.200）

子网掩码 255.255.255.0
测试连通性
打开终端（Linux/macOS）或命令提示符/PowerShell（Windows），执行以下命令：
```
ping 192.168.11.200
```
若收到类似 64 bytes from 192.168.11.200 的回复，说明物理连接正常。

有线SSH登陆

ssh orangepi@192.168.11.200
#默认用户名：orangepi
#默认密码：airbot（输入时不会显示字符，输完直接按回车即可）

⚠️ 注意：首次使用需先通过有线方式完成 Wi-Fi 配置。

配置 Wi-Fi 网络 `

连接到 WiFi 网络

nmcli device wifi connect "您的网络名称" password "您的WiFi密码"

查看无线 IP 地址

连接成功后，执行以下任一命令查看无线网卡分配的 IP：
```
ifconfig
```
在命令输出中，请找到您的无线网卡（通常命名为 wlan0、wlP2p33s0 或类似的 wl* 接口），参考下图输出
测试连通性
```
ping <您的香橙派无线IP>
```
若收到类似 64 bytes from <您的香橙派无线IP> 的回复，说明物理连接正常。
无线 SSH 登录

获得无线 IP 后，即可拔掉网线，通过Wi-Fi远程连接：
```
ssh orangepi@<您的香橙派无线IP>
```

验证

无论采用有线还是无线方式，成功登录后，终端提示符将变为：

orangepi@orangepi:~$

这表示您已成功进入香橙派系统，可以开始后续的开发工作！

安装Anaconda，用于管理python环境

wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.sh

创建conda环境，推荐使用python3.12环境

conda create -y -n mmk2sdk python=3.12   # 安装一个纯净的conda环境 
conda activate mmk2sdk

安装python sdk

# 替换实际的whl包名称
pip install ./mmk2_sdk-*.whl -i https://pypi.tuna.tsinghua.edu.cn/simple

提示

安装过程中若遇到 No module named 'bidict' 报错，请执行以下命令安装缺失的依赖：

pip install bidict -i -i https://pypi.tuna.tsinghua.edu.cn/simple

命令行返回成功信息后，可通过以下命令验证 SDK 版本：

pip list | grep mmk2_sdk

配置项	参数值	说明
IP 地址	192.168.11.xxx	xxx取值范围：1-254（需避开.200）
子网掩码	255.255.255.0