Skip to content

Commit 0ad3128

Browse files
Merge pull request #17 from westonrobot/feature-unitree_troubleshooting_guide
Feature unitree troubleshooting guide
2 parents 79931b2 + 0b94ad9 commit 0ad3128

33 files changed

Lines changed: 646 additions & 53 deletions

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,13 @@ npm -v
4646
Set up the development repository and install dependencies.
4747

4848
```bash
49-
$ cd <this-repository>
50-
$ npm install
51-
$ npm run build
49+
cd <this-repository>
50+
npm install
51+
npm run build
5252
```
5353

5454
Then you can build and serve the documentation locally.
5555

5656
```bash
57-
$ npm run start
57+
npm run start
5858
```

robot/humanoid/g1.md

Lines changed: 27 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,34 +12,51 @@ The G1 is a humanoid robot that stands 130 cm tall and weighs 35 kg. It comes eq
1212

1313
## 2. Specifications
1414

15-
### 2.2 Electrical Interfaces
15+
### 2.1 Electrical Interfaces
1616

1717
![](../img/unitree/G1_electrical_interfaces.jpg)
1818

1919
![](../img/unitree/G1_electrical_interfaces_gpio.jpg)
2020

2121
> **Note**: There are many ways to operate NVIDIA GPIO, refer to this [link](https://docs.nvidia.com/jetson/archives/r35.2.1/DeveloperGuide/text/HR/JetsonModuleAdaptationAndBringUp/JetsonOrinNxSeries.html#identifying-the-gpio-number) for the definition.
2222
23-
### 2.3 On-board Computer
23+
### 2.2 On-board Computer
2424

25-
G1 Edu has 2 onboard computers:
25+
G1 Edu has 2 built-in computers:
2626

2727
- Operation & Control computing unit (Not accessible to public)
2828
- IP: 192.168.123.161
2929

3030
- User development computing unit
3131
- IP: 192.168.123.164
3232
- Username: unitree
33-
- Password: Unitree0408
33+
- Password: 123
3434

3535
## 3. Resources
3636

37-
### Basic Guides
37+
* **Training Slides**: [G1 Basic Training](https://tangrobot.sharepoint.com/:b:/s/Public-Outgoing/EYW7e2v3tL1DtCeW-HGdQo8BlBn-CkYQve05OhJDlS7xcA?e=5kJQpt)
38+
* **Unitree Support Page**: [Unitree](https://support.unitree.com/home/en/G1_developer)
39+
* **C++ SDK**: [unitree_sdk2](https://github.com/unitreerobotics/unitree_sdk2)
40+
* **Python SDK**: [unitree_sdk2_python](https://github.com/unitreerobotics/unitree_sdk2_python)
41+
* **ROS2 Package**: [unitree_ros2](https://github.com/unitreerobotics/unitree_ros2)
42+
* **G1 App, Robot Features, Tutorial Videos, Manuals**: [G1 Features](https://www.unitree.com/app/g1)
43+
* **Other Information**: [URDF/CAD](https://support.unitree.com/home/en/G1_developer/get_sdk)
44+
* **Tutorials Page**: [Guides](/tutorial/intro)
3845

39-
* G1 Manual: [Unitree](https://support.unitree.com/home/en/G1_developer)
40-
* Training Slides: [G1 Basic Training](https://tangrobot.sharepoint.com/:b:/s/Public-Outgoing/EYW7e2v3tL1DtCeW-HGdQo8BlBn-CkYQve05OhJDlS7xcA?e=5kJQpt)
46+
## 4. FAQ
4147

42-
### Development
48+
1. **Can the robot stand on its own?**
49+
A: From a lying position, the G1 can stand on its own. However, this mode is not recommended as it may damage the joints from excessive use and the robot may fall on smooth floors. It is recommended to have the robot stand from a seated or hanging position instead.
4350

44-
* SDK Support: [unitree_sdk2](https://github.com/unitreerobotics/unitree_sdk2)
45-
* ROS2 Support: [unitree_ros2](https://github.com/unitreerobotics/unitree_ros2)
51+
2. **Q: Does the robot support wireless development?**
52+
A: The robot's internal development PC can connect to WiFi networks for internet access (see [G1 Internet Access Guide](/tutorial/unitree/g1_internet_guide)), but it does not support wireless development.
53+
54+
3. **Q: Is the robot waterproof?**
55+
A: No, the G1 is not waterproof.
56+
57+
4. **Q: How often do I need to lubricate the joints?**
58+
A: If you encounter motor issues, stiffness or loosening of joints, please contact [Weston Robot Support Team](https://forms.office.com/pages/responsepage.aspx?id=NTNVCC0zFkWzGo_3Vcs_4KxdsbBJKHVIkFlOJLtAMMlUQkJZMU8wM1EyTkRUVUJCVzA2WVdQNzBSMCQlQCN0PWcu&route=shorturl).
59+
The *Serial Number (SN)* of the robot is located in the battery compartment. The SN (and the *Model*) can also be found in the app in `Device -> Robot Settings`.
60+
61+
5. **Q: What happens when the robot rolls over/falls and does not respond to remote control commands?**
62+
A: Check and screenshot the mobile app for any warnings or errors displayed. Power off the robot and carry the robot to a flat and levelled ground. Inspect the robot for any damages (e.g., loose/damaged wiring). Please contact [Weston Robot Support Team](https://forms.office.com/pages/responsepage.aspx?id=NTNVCC0zFkWzGo_3Vcs_4KxdsbBJKHVIkFlOJLtAMMlUQkJZMU8wM1EyTkRUVUJCVzA2WVdQNzBSMCQlQCN0PWcu&route=shorturl) if the robot is unable to be powered on or start up.
290 KB
Loading
167 KB
Loading
1.16 MB
Loading

robot/intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ You can find more detailed information about each robot model in the navigation
6969
<div className="col col--6">
7070
<div style={{ textAlign: 'center' }}>
7171
<img src={H1_2_IMG} alt="H1-2 robot" style={{ height: 200 }} />
72-
<p><a href="humanoid/h1-2">B2</a></p>
72+
<p><a href="humanoid/h1-2">H1-2</a></p>
7373
</div>
7474
</div>
7575
</div>

robot/quadruped/b2.md

Lines changed: 243 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,34 +3,263 @@ sidebar_position: 2
33
---
44

55
import B2_IMG from '../img/unitree/B2_robot.png';
6+
import B2_4PIN_IMG from '../img/unitree/B2_4_pin.png';
7+
import B2_10PIN_IMG from '../img/unitree/B2_10_pin.png';
68

79
# B2
810

911
## 1. Overview
1012

1113
<img src={B2_IMG} alt="B2 robot" style={{width: 350}} />
1214

13-
## 2. Resources
15+
The B2 is Unitree's industrial-grade quadruped robot designed for commercial and professional applications and weighs 60 kg with IP67 rating. Built with enhanced durability and weatherproofing capabilities, with its robust construction and intelligent sensing systems, the B2 excels in challenging environments where reliability and performance are critical, making it ideal for inspection, surveillance, and industrial automation tasks.
1416

15-
* **Manual**: [Unitree B2 Manual](https://support.unitree.com/home/en/B2_developer/About%20B2)
16-
* **Training Slides**: [B2 Customer Training](https://tangrobot.sharepoint.com/:p:/s/Public-Outgoing/Ef2w_exJ67hLi1Xqsv0VjosBtS1pz0ZjTdHZcyOrTAc-mA?e=XiMFoT)
17+
## 2. Specifications
18+
19+
### 2.1 Electrical Interfaces
20+
21+
![](../img/unitree/B2_electrical_interfaces.png)
22+
23+
#### User Interface Module Power Parameters
24+
25+
<table style={{textAlign: 'left'}}>
26+
<thead>
27+
<tr>
28+
<th style={{textAlign: 'left'}}>Interface</th>
29+
<th style={{textAlign: 'left'}}>Parameter</th>
30+
<th style={{textAlign: 'left'}}>Specification</th>
31+
</tr>
32+
</thead>
33+
<tbody>
34+
<tr>
35+
<td rowspan="2" style={{textAlign: 'left', verticalAlign: 'top'}}><strong>USB Interface (TYPE-C)</strong><br/><br/><em><strong>Note:</strong> This interface is powered from the PC processor in
36+
B2's abdomen and shares power with the TYPE-C interface
37+
of the B2 abdominal processor.</em></td>
38+
<td style={{textAlign: 'left'}}>1. Total USB output current</td>
39+
<td style={{textAlign: 'left'}}>3A</td>
40+
</tr>
41+
<tr>
42+
<td style={{textAlign: 'left'}}>2. Current limit per USB port</td>
43+
<td style={{textAlign: 'left'}}>1.5A</td>
44+
</tr>
45+
<tr>
46+
<td rowspan="4" style={{textAlign: 'left', verticalAlign: 'top'}}><strong>24V Power Interface (2+2PIN)</strong></td>
47+
<td style={{textAlign: 'left'}}>1. Total 24V output rating</td>
48+
<td style={{textAlign: 'left'}}>10A</td>
49+
</tr>
50+
<tr>
51+
<td style={{textAlign: 'left'}}>2. Total 24V output overload protection</td>
52+
<td style={{textAlign: 'left'}}>15A slow-blow fuse (one-time)</td>
53+
</tr>
54+
<tr>
55+
<td style={{textAlign: 'left'}}>3. Total 24V output overcurrent protection</td>
56+
<td style={{textAlign: 'left'}}>Trigger at 24A, reset at 16A (hiccup self-recovery)</td>
57+
</tr>
58+
<tr>
59+
<td style={{textAlign: 'left'}}>4. Current distribution per 24V interface</td>
60+
<td style={{textAlign: 'left'}}>None (internal wiring is parallel, sharing one power supply)</td>
61+
</tr>
62+
<tr>
63+
<td rowspan="5" style={{textAlign: 'left', verticalAlign: 'top'}}><strong>12V Network Interface (2+8PIN)</strong><br/><br/><em><strong>Note:</strong> This interface shares power with the B2 abdominal processor. The parameters listed below are the overall internal power parameters.</em></td>
64+
<td style={{textAlign: 'left'}}>1. Total 12V output rating</td>
65+
<td style={{textAlign: 'left'}}>10A</td>
66+
</tr>
67+
<tr>
68+
<td style={{textAlign: 'left'}}>2. Total 12V output overload protection</td>
69+
<td style={{textAlign: 'left'}}>15A slow-blow fuse (one-time)</td>
70+
</tr>
71+
<tr>
72+
<td style={{textAlign: 'left'}}>3. Total 12V output overcurrent protection</td>
73+
<td style={{textAlign: 'left'}}>Trigger at 24A, reset at 16A (hiccup self-recovery)</td>
74+
</tr>
75+
<tr>
76+
<td style={{textAlign: 'left'}}>4. Current distribution per 12V interface</td>
77+
<td style={{textAlign: 'left'}}>None (internal wiring is parallel, sharing one power supply)</td>
78+
</tr>
79+
</tbody>
80+
</table>
81+
82+
<div style={{textAlign: 'center'}}>
83+
<img src={B2_4PIN_IMG} alt="B2 4-Pin" style={{width: 350}} />
84+
</div>
85+
86+
#### (2+2) Power Line Interface
87+
88+
<table style={{textAlign: 'left'}}>
89+
<thead>
90+
<tr>
91+
<th style={{textAlign: 'left'}}>Pin</th>
92+
<th style={{textAlign: 'left'}}>Colour</th>
93+
<th style={{textAlign: 'left'}}>Specification</th>
94+
</tr>
95+
</thead>
96+
<tbody>
97+
<tr>
98+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>1</strong></td>
99+
<td style={{textAlign: 'left'}}>Black (14AWG)</td>
100+
<td style={{textAlign: 'left'}}>Power-</td>
101+
</tr>
102+
<tr>
103+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>2</strong></td>
104+
<td style={{textAlign: 'left'}}>Red (24AWG)</td>
105+
<td style={{textAlign: 'left'}}>485A-</td>
106+
</tr>
107+
<tr>
108+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>3</strong></td>
109+
<td style={{textAlign: 'left'}}>Black (24AWG)</td>
110+
<td style={{textAlign: 'left'}}>485B-</td>
111+
</tr>
112+
<tr>
113+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>4</strong></td>
114+
<td style={{textAlign: 'left'}}>Red (14AWG)</td>
115+
<td style={{textAlign: 'left'}}>Power+</td>
116+
</tr>
117+
</tbody>
118+
</table>
119+
120+
<div style={{textAlign: 'center'}}>
121+
<img src={B2_10PIN_IMG} alt="B2 10-Pin" style={{width: 350}} />
122+
</div>
123+
124+
#### (8+2) Signal Line Interface
125+
126+
<table style={{textAlign: 'left'}}>
127+
<thead>
128+
<tr>
129+
<th style={{textAlign: 'left'}}>Pin</th>
130+
<th style={{textAlign: 'left'}}>Colour</th>
131+
<th style={{textAlign: 'left'}}>Specification</th>
132+
<th style={{textAlign: 'left'}}>T568 Standard Ethernet Cable</th>
133+
</tr>
134+
</thead>
135+
<tbody>
136+
<tr>
137+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>1</strong></td>
138+
<td style={{textAlign: 'left'}}>Black</td>
139+
<td style={{textAlign: 'left'}}>Power-</td>
140+
<td style={{textAlign: 'left'}}>-</td>
141+
</tr>
142+
<tr>
143+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>2</strong></td>
144+
<td style={{textAlign: 'left'}}>Orange</td>
145+
<td style={{textAlign: 'left'}}>4N</td>
146+
<td style={{textAlign: 'left'}}>Brown</td>
147+
</tr>
148+
<tr>
149+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>3</strong></td>
150+
<td style={{textAlign: 'left'}}>Purple</td>
151+
<td style={{textAlign: 'left'}}>4P</td>
152+
<td style={{textAlign: 'left'}}>White Brown</td>
153+
</tr>
154+
<tr>
155+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>4</strong></td>
156+
<td style={{textAlign: 'left'}}>Brown</td>
157+
<td style={{textAlign: 'left'}}>1P</td>
158+
<td style={{textAlign: 'left'}}>White Orange</td>
159+
</tr>
160+
<tr>
161+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>5</strong></td>
162+
<td style={{textAlign: 'left'}}>Blue</td>
163+
<td style={{textAlign: 'left'}}>1N</td>
164+
<td style={{textAlign: 'left'}}>Orange</td>
165+
</tr>
166+
<tr>
167+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>6</strong></td>
168+
<td style={{textAlign: 'left'}}>White</td>
169+
<td style={{textAlign: 'left'}}>3N</td>
170+
<td style={{textAlign: 'left'}}>Blue</td>
171+
</tr>
172+
<tr>
173+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>7</strong></td>
174+
<td style={{textAlign: 'left'}}>Green</td>
175+
<td style={{textAlign: 'left'}}>3P</td>
176+
<td style={{textAlign: 'left'}}>White Blue</td>
177+
</tr>
178+
<tr>
179+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>8</strong></td>
180+
<td style={{textAlign: 'left'}}>Pink</td>
181+
<td style={{textAlign: 'left'}}>2N</td>
182+
<td style={{textAlign: 'left'}}>Green</td>
183+
</tr>
184+
<tr>
185+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>9</strong></td>
186+
<td style={{textAlign: 'left'}}>Grey</td>
187+
<td style={{textAlign: 'left'}}>2P</td>
188+
<td style={{textAlign: 'left'}}>White Green</td>
189+
</tr>
190+
<tr>
191+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>10</strong></td>
192+
<td style={{textAlign: 'left'}}>Red</td>
193+
<td style={{textAlign: 'left'}}>Power+(12V)</td>
194+
<td style={{textAlign: 'left'}}>-</td>
195+
</tr>
196+
<tr>
197+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>-</strong></td>
198+
<td style={{textAlign: 'left'}}>Deep Blue</td>
199+
<td style={{textAlign: 'left'}}>none</td>
200+
<td style={{textAlign: 'left'}}>-</td>
201+
</tr>
202+
<tr>
203+
<td style={{textAlign: 'left', verticalAlign: 'top'}}><strong>-</strong></td>
204+
<td style={{textAlign: 'left'}}>Yellow</td>
205+
<td style={{textAlign: 'left'}}>none</td>
206+
<td style={{textAlign: 'left'}}>-</td>
207+
</tr>
208+
</tbody>
209+
</table>
210+
211+
212+
### 2.2 On-board Computer
213+
214+
B2 has a maximum of 5 built-in computers:
215+
216+
- Operation & SLAM unit (Not accessible to public)
217+
- PC1 IP: 192.168.123.161
218+
- PC2 IP: 192.168.123.162
219+
220+
- User development computing units
221+
- PC3 IP: 192.168.123.163
222+
- PC4 IP: 192.168.123.164
223+
- PC5 IP: 192.168.123.165
224+
- Username: unitree
225+
- Password: Unitree0408
226+
> **Note**: PC3 uses an Intel i7 processor. PC4 & PC5 can be configured with either Intel i7 (x86) or Orin NX (ARM) processors. x86 computers have 512GB of storage while ARM computers have 2TB of storage. The PCs run Ubuntu 20.04 (newer models run Ubuntu 22.04).
227+
228+
## 3. Resources
229+
230+
* **Training Slides**: [B2 Training](https://tangrobot.sharepoint.com/:p:/s/Public-Outgoing/Ef2w_exJ67hLi1Xqsv0VjosBtS1pz0ZjTdHZcyOrTAc-mA?e=XiMFoT)
231+
* **Unitree Support Page**: [Unitree](https://support.unitree.com/home/en/B2_developer/About%20B2)
17232
* **C++ SDK**: [unitree_sdk2](https://github.com/unitreerobotics/unitree_sdk2)
233+
* **Python SDK**: [unitree_sdk2_python](https://github.com/unitreerobotics/unitree_sdk2_python)
18234
* **ROS2 Package**: [unitree_ros2](https://github.com/unitreerobotics/unitree_ros2)
235+
* **B2 App, Robot Features, Tutorial Videos, Manuals**: [B2 Features](https://www.unitree.com/app/b2)
19236
* **User Interface Module CAD**: [B2 User Interface Module STEP](https://tangrobot.sharepoint.com/:u:/s/ProductDevelopment/EaH5OYxj8glKjJ10s0Xm2ooBU7ncVzAkqjGGkULEB9O_jA?e=uJayCQ)
237+
* **Other Information**: [URDF/CAD](https://support.unitree.com/home/en/B2_developer/Obtain%20SDK)
238+
* **Tutorials Page**: [Diagnostic Guide](/tutorial/intro)
239+
240+
## 4. FAQ
241+
242+
1. **Can the ports on the side of the B2 be used?**
243+
A: Yes, the ports on the side of the B2 robot are accessible for use. However, we strongly recommend using the ports located on the User Interface Module whenever possible. While the B2 has an IP67 rating when properly sealed, using the side ports may require opening protective covers which could temporarily compromise the robot's waterproof capabilities during operation. Users should be familiar with the different ports and proper sealing procedures before using them.
244+
245+
2. **What is the default speed of the B2 in AI mode?**
246+
A: The default is Low speed. Double click L1 to switch to High Speed.
20247

21-
## 3. FAQ
248+
3. **Can the RealSense cameras on the B2 be used for secondary development?**
249+
A: No, the RealSense cameras on the B2 robot are currently not accessible for users to directly control or integrate into their own development projects. These cameras are primarily used by the manufacturer to power the robot's built-in perception features.
22250

23-
* **Can the ports on the side of the B2 be used?**
24-
- Yes, the ports on the side of the B2 robot are accessible for use. However, we strongly recommend using the ports located on the User Interface Module whenever possible. This is because using the side ports could compromise the robot's waterproof capabilities. Users are urged to be familiar of the different ports before using them.
251+
4. **Can the contact charger be used outdoors?**
252+
A: This contact charger is designed for indoor use. Avoid using it in wet or humid environments to prevent the risk of short circuits. Moisture can damage the charger and potentially pose a safety hazard.
25253

26-
* **What is the default speed of the B2 in AI mode?**
27-
- The default is Low speed. Double click L1 to switch to High Speed.
254+
5. **What does first foot control and second foot control represent?**
255+
A: First Foot control represents Normal mode, while Second Foot control represents AI mode. When switched on, the B2 is in AI mode (Second Foot control) by default.
28256

29-
* **Can the RealSense cameras on the B2 be used for secondary development?**
30-
- No, the RealSense cameras on the B2 robot are currently not accessible for users to directly control or integrate into their own development projects. These cameras are primarily used by the manufacturer to power the robot's built-in perception features.
257+
6. **Q: Does the robot support wireless development?**
258+
A: Currently, the robot does not support wireless connection to internal computers.
31259

32-
* **Can the contact charger be used outdoors?**
33-
- This contact charger is designed for indoor use. Avoid using it in wet or humid environments to prevent the risk of short circuits. Moisture can damage the charger and potentially pose a safety hazard.
260+
7. **Q: How often do I need to lubricate the joints?**
261+
A: If you encounter motor issues, stiffness or loosening of joints, please contact [Weston Robot Support Team](https://forms.office.com/pages/responsepage.aspx?id=NTNVCC0zFkWzGo_3Vcs_4KxdsbBJKHVIkFlOJLtAMMlUQkJZMU8wM1EyTkRUVUJCVzA2WVdQNzBSMCQlQCN0PWcu&route=shorturl).
262+
The *Serial Number (SN)* of the robot is located in the battery compartment. The SN (and the *Model*) can also be found in the app in `Device -> Robot Settings`.
34263

35-
* **What does first foot control and second foot control represent?**
36-
- First Foot control represents Normal mode, while Second Foot control represents AI mode. When switched on, the B2 is in AI mode (Second Foot control) by default.
264+
8. **Q: What happens when the robot rolls over/falls and does not respond to remote control commands?**
265+
A: If the `Recover From Fall` command does not work or it is unsafe to do so, check and screenshot the mobile app for any warnings or errors displayed. Power off the robot and carry the robot to a flat and levelled ground. Inspect the robot for any damages (e.g., loose/damaged wiring). Please contact [Weston Robot Support Team](https://forms.office.com/pages/responsepage.aspx?id=NTNVCC0zFkWzGo_3Vcs_4KxdsbBJKHVIkFlOJLtAMMlUQkJZMU8wM1EyTkRUVUJCVzA2WVdQNzBSMCQlQCN0PWcu&route=shorturl) if the robot is unable to be powered on or start up.

0 commit comments

Comments
 (0)