2023-12-19 16:12:24 +08:00
|
|
|
|
# zkdog
|
|
|
|
|
|
2023-12-20 12:44:39 +08:00
|
|
|
|
这里是基于宇树科技机器狗go1二次开发相关配置经验,以及一些问题的解决方案,包括python版本的机器狗的控制api的二次封装,方便大家快速开发。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Go1系统架构图(二开)
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
[Go1系统架构图 (yuque.com)](https://www.yuque.com/ironfatty/nly1un/fscioc)
|
|
|
|
|
|
|
|
|
|
主控板:MCU(192.168.123.10)
|
|
|
|
|
|
|
|
|
|
运动控制主板:RasPi 4B(192.168.123.161)
|
|
|
|
|
|
|
|
|
|
感知主板:Nano(头部、192.168.123.13)、Nano(机身、192.168.123.14)、Nano或NX(机身、192.168.123.15)
|
|
|
|
|
|
|
|
|
|
# 一、基础环境配置
|
|
|
|
|
|
|
|
|
|
如何进入各个板子?
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# 首先连接机器狗的wifi 密码 00000000
|
|
|
|
|
# 进入运动控制主板
|
|
|
|
|
ssh pi@192.168.12.1 # 密码 123
|
|
|
|
|
|
|
|
|
|
# 进入主控板之后,可以进入其他板子
|
|
|
|
|
ssh unitree@192.168.123.XX # 密码 123
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 1.网络环境配置
|
|
|
|
|
|
|
|
|
|
网络环境配置有两种解决办法,一种是采用官方给出的方案,采用内置无线网卡实现运动控制主板上网(弊端:其他板子无法上网)另一种则是采用有线上网的方式;这里推荐采用配置http代理的方式实现无侵入式实现所有板子上网的问题。[网络配置详情](docs/网络环境配置.md)。
|
|
|
|
|
|
|
|
|
|
## 2.开发环境配置
|
|
|
|
|
|
|
|
|
|
### 2.1 code-server配置
|
|
|
|
|
|
|
|
|
|
树莓派/nx 板子 arm64机器 版本不需要太高即可
|
|
|
|
|
|
|
|
|
|
code-server-3.9.3-linux-arm64.tar.gz
|
|
|
|
|
|
|
|
|
|
[https://github.com/coder/code-server/releases?page=4](https://github.com/coder/code-server/releases?page=4)
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# 安装
|
|
|
|
|
tar -zxvf code-server-3.9.3-linux-arm64.tar.gz
|
|
|
|
|
mv code-server-3.9.3-linux-arm64 code-server
|
|
|
|
|
|
|
|
|
|
# 第一次运行生成配置
|
|
|
|
|
cd code-server/bin
|
|
|
|
|
./code-server
|
|
|
|
|
# 编辑配置文件
|
|
|
|
|
vim ~/.config/code-server/config.yaml
|
|
|
|
|
|
|
|
|
|
#bind-addr: 0.0.0.0:8888
|
|
|
|
|
#auth: password
|
|
|
|
|
#password: 123456
|
|
|
|
|
#cert: false
|
|
|
|
|
|
|
|
|
|
# 软链接
|
|
|
|
|
sudo ln -s /home/unitree/alg/code-server/bin/code-server /usr/bin/code-server
|
|
|
|
|
|
|
|
|
|
# 配置启动文件
|
|
|
|
|
vim code-start.sh
|
|
|
|
|
|
2023-12-20 13:37:35 +08:00
|
|
|
|
#! /bin/sh
|
|
|
|
|
su unitree -c 'export PASSWORD="123"; nohup code-server --host 0.0.0.0 --port 8888 --auth password > /home/unitree/alg/code-server.log 2>&1 &'
|
2023-12-20 12:44:39 +08:00
|
|
|
|
|
|
|
|
|
# 修改权限code-start.sh
|
|
|
|
|
sudo chmod +x code-start.sh
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
配置code-srever开机自启
|
|
|
|
|
|
|
|
|
|
rc.local脚本是一个ubuntu开机后会自动执行的脚本,我们可以在该脚本内添加命令行指令。该脚本位于/etc/路径下,需要root权限才能修改。
|
|
|
|
|
|
|
|
|
|
该脚本具体格式如下:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
sudo vim /etc/rc.local
|
|
|
|
|
#!/bin/sh -e
|
|
|
|
|
#
|
|
|
|
|
# rc.local
|
|
|
|
|
#
|
|
|
|
|
# This script is executed at the end of each multiuser runlevel.
|
|
|
|
|
# Make sure that the script will "exit 0" on success or any other
|
|
|
|
|
# value on error.
|
|
|
|
|
#
|
|
|
|
|
# In order to enable or disable this script just change the execution
|
|
|
|
|
# bits.
|
|
|
|
|
#
|
|
|
|
|
# By default this script does nothing.
|
|
|
|
|
|
|
|
|
|
sh /home/unitree/alg/code-start.sh
|
|
|
|
|
|
|
|
|
|
exit 0
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
注意: 一定要将命令添加在 exit 0之前
|
|
|
|
|
|
|
|
|
|
### 2.2 主控板nginx 新增配置(切记不要修改内部配置)
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
sudo vim /etc/nginx/sites-available/default
|
|
|
|
|
|
|
|
|
|
location /codeServer {
|
|
|
|
|
proxy_pass ~~http://127.0.0.1:8080/~~ 修改为配置的 code-server 地址;
|
|
|
|
|
proxy_set_header Host $host;
|
|
|
|
|
proxy_set_header Upgrade $http_upgrade;
|
|
|
|
|
proxy_set_header Connection upgrade;
|
|
|
|
|
proxy_set_header Accept-Encoding gzip;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# 重启nginx服务,
|
|
|
|
|
sudo nginx -t && sudo nginx -s reload
|
|
|
|
|
|
|
|
|
|
# 启动之后,我们看一下 Nginx 是否处于运行状态。
|
|
|
|
|
sudo service nginx status
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
配置完成后可通过192.168.12.1/codeServer访问code-server 服务, 如果配置不生效,请检测http代理是否规避掉 需要nginx代理的ip
|
|
|
|
|
|
|
|
|
|
### 2.3 python 环境配置 (建议不要直接在内部python环境安装第三方包,防止冲突)
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# 安装python3.6
|
|
|
|
|
# 下载python3.6.4
|
|
|
|
|
|
|
|
|
|
wget https://www.python.org/ftp/python/3.6.4/Python-3.6.4.tgz
|
|
|
|
|
|
|
|
|
|
# 解压
|
|
|
|
|
tar -zxvf Python-3.6.4.tgz
|
|
|
|
|
|
|
|
|
|
# 创建目录
|
|
|
|
|
sudo mkdir /home/unitree/python3.6
|
|
|
|
|
|
|
|
|
|
#编译安装(在解压出来的目录下执行)
|
|
|
|
|
#建议make和make install 分两步
|
|
|
|
|
|
|
|
|
|
sudo ./configure --prefix=/home/unitree/python3.6
|
|
|
|
|
|
|
|
|
|
sudo make
|
|
|
|
|
sudo make install
|
|
|
|
|
|
|
|
|
|
#添加软链接
|
|
|
|
|
sudo ln -s /home/unitree/python3.6/bin/python3.6 /usr/bin/python36
|
|
|
|
|
|
|
|
|
|
ls -al # 查看软链接
|
|
|
|
|
|
|
|
|
|
# 如果新装的python中含有pip 同上可添加软链接的形式, 否则后期pip使用可以按如下方式
|
|
|
|
|
# python36 -m pip list
|
|
|
|
|
python36 -m pip install XXX
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# 二、ZKMetaApi 使用
|
|
|
|
|
|
2023-12-26 10:21:53 +08:00
|
|
|
|
## 1. 编译unitree_legged_sdk
|
|
|
|
|
[unitree_legged_sdk](https://github.com/unitreerobotics/unitree_legged_sdk)
|
|
|
|
|
``` shell
|
|
|
|
|
git clone https://github.com/unitreerobotics/unitree_legged_sdk.git
|
|
|
|
|
cd unitree_legged_sdk
|
|
|
|
|
mkdir build && cd build
|
|
|
|
|
cmake .. && make
|
|
|
|
|
# 如果需要使用python sdk
|
|
|
|
|
cmake -DPYTHON_BUILD=TRUE .. && make
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 2. 使用python sdk
|
|
|
|
|
### 2.1 arm架构
|
|
|
|
|
机器狗所使用的处理器架构为arm
|
|
|
|
|
将example_py下的.py文件中```sys.path.append('../lib/python/amd64')```改为```sys.path.append('../lib/python/arm64')```
|
|
|
|
|
### 2.2 amd架构
|
|
|
|
|
PC端调试不需要更改example_py下的.py文件
|
2023-12-20 12:44:39 +08:00
|
|
|
|
|
2023-12-20 13:37:35 +08:00
|
|
|
|
# Tips
|
2023-12-20 12:44:39 +08:00
|
|
|
|
|
2023-12-26 10:21:53 +08:00
|
|
|
|
## [unitree_legged_sdk编译问题](docs/unitree_legged_sdk编译问题.md)
|
2023-12-20 13:37:35 +08:00
|
|
|
|
## [code-server安装插件证书问题](docs/code-server安装插件证书问题.md)
|