Skip to content

Commit d71f28c

Browse files
committed
优化
1 parent 3799cdd commit d71f28c

File tree

13 files changed

+116
-8
lines changed

13 files changed

+116
-8
lines changed

2-ProductFeature/2.1_320_M5_product/2.1.4-ElectricalCharacteristicParameter.md

+8-3
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@
77
Figure 1 Front view of a base
88

99
#### 1.1 Type C :Type C interface is used to connect and communicate with the PC, available for developers.
10+
> This interface is only used for updating pico firmware, not as a general programming communication interface.
1011
1112
#### 1.2 Screen :Screen is used to display the communication status of myCobot and calibrate the robot move to starting point with a 2-inch IPS screen.
1213

@@ -28,11 +29,12 @@ Figure 3 Right side of the base
2829

2930
Built-in I/O power supply, voltage 24V, single output maximum 0.2A. External power supply is not supported.
3031

31-
It should be noted that the output signal is in PNP form, and the input signal is in NPN form. The following is the external wiring diagram:
32+
It should be noted that the output signal is in PNP form, and the input signal is in NPN form. The following is the external wiring diagram:
3233

33-
<img src="../../resources/8-FilesDownload/2-serialproduct/opt.jpg " width="800" height="auto" />
3434

35-
<img src="../../resources/8-FilesDownload/2-serialproduct/NPN接线图.png " width="800" height="auto" />
35+
![alt text](../../resources/8-FilesDownload/2-serialproduct/opt.png)
36+
37+
![alt text](../../resources/8-FilesDownload/2-serialproduct/NPN接线图.png)
3638

3739
#### 1.7 Power DC input interface : It uses KPPX-4P R7BFDC power socket. The 24V 9.2A DC power adapter provided by the manufacturer can also be used to power myCobot320.
3840

@@ -192,6 +194,9 @@ Figure 5 Side view of the end of the robot arm
192194

193195
#### 2.1 End-tool IO interface: This is a tool I/O diagram, and the myCobot 320 robot provides one input and two outputs.
194196

197+
> Accessory and Atom end tool interface use does not support hot swapping.
198+
199+
195200
<img src="../../resources/8-FilesDownload/2-serialproduct/IO.png " width="800" height="auto" />
196201

197202
Built-in I/O power supply, voltage 24V, single output maximum 0.2A. External power supply is not supported.

3-UserNotes/320_M5/3.1.1-SafetyInstruction/1-SafetyInstruction.md

+89
Original file line numberDiff line numberDiff line change
@@ -75,5 +75,94 @@ https://www.elephantrobotics.com
7575
- Cost of using a security function at a low level.
7676
- Lo-fi does not conform to the use of robot performance parameters.
7777

78+
---
79+
80+
## **Robot Motion Control Guide and Usage Restrictions**
81+
82+
### **Basic Usage Guidelines**
83+
84+
**myCobot 320 Usage Guidelines**
85+
86+
- **Payload Capacity:** Please note that the myCobot 320 has a rated payload of 1 kilogram. To ensure the normal operation of the robotic arm, avoid exceeding the rated payload to prevent potential damage.
87+
- **Power Supply:** For stable power supply to the robotic arm, use only the original matching power adapter. Do not replace or modify the power supply for safety reasons.
88+
- **Disassembly and Maintenance:** When disassembling or performing maintenance on the robotic arm, strictly follow the guidance provided by the official after-sales support. Unauthorized modifications, such as connecting sensors, welding, or short-circuiting IO pins, are not recommended.
89+
- **Operating Environment:** To ensure the normal functioning of the robotic arm, place it in a dry and temperature-appropriate environment. Avoid exposing the robotic arm to damp or high-temperature conditions.
90+
- **Joint Limitations:** The robotic arm is equipped with joint limit functions. Avoid moving the robotic arm beyond its movable range to prevent potential damage or safety issues.
91+
- **Fixation and Prevention of Falls:** Before operating the robotic arm, ensure it is securely fixed. During operation, be cautious to prevent falls or interference from unexpected situations.
92+
- **Firmware Flashing:** Choose firmware carefully and only use firmware provided by the official source. Using unofficial firmware may lead to unnecessary issues.
93+
94+
**Note:** For your safety and the well-being of the robotic arm, it is recommended to adhere to the above usage guidelines. Any actions, such as overloading or modifying the robotic arm, that result in damage and are not guided by official after-sales support will not be covered by the robotic arm's warranty. If you have further questions, feel free to contact our official after-sales support.
95+
96+
### **Robot Motion Control Instructions**
97+
98+
myCobot 320
99+
**Joint Limitations are as Follows:**
100+
101+
| **Joints** | **Range**(°) |
102+
| ---------- | ------------ |
103+
| J1 | ±165° |
104+
| J2 | ±165° |
105+
| J3 | ±165° |
106+
| J4 | ±165° |
107+
| J5 | ±165° |
108+
| J6 | ±175° |
109+
110+
The range of Cartesian space (coordinates) is as follows:
111+
112+
| axis | **Cartesian Space Range**(mm) |
113+
| -------- | ----------------------------- |
114+
| x | -350~350 |
115+
| y | -350~350 |
116+
| z | -41~524 |
117+
| rx\ry\rz | +179° |
118+
119+
**Note: The above data is for reference only. During the actual operation of the robotic arm, certain positions or orientations may lead to self-interference due to the inherent structure of the robotic arm. For instance, at a specific position, while individual joints may not exceed their limits, it could result in a collision between the J2 and J3 joints of the robotic arm.**
120+
121+
### Robot Motion Control Tips:
122+
123+
**myCobot ##Motion Control Suggestions:**
124+
125+
- **Before controlling the robotic arm's motion, ensure you know the specific angles/coordinates of the target position. Exercise caution while controlling the robotic arm's motion.**
126+
- **During the debugging phase, try to avoid running the robotic arm at high speeds to prevent potential harm to yourself and the robotic arm. It is recommended to use lower motion speeds.**
127+
- **To prevent self-interference (collisions between the robotic arm's own joints), ensure that the robotic arm does not collide during its motion.**
128+
129+
**Note:** We recommend following the above motion control suggestions to minimize potential risks. Please be aware that if damage to the robotic arm is caused by personal use issues, warranty services will no longer apply. If you have any questions or need support, feel free to contact our official after-sales support. We will be happy to assist you in ensuring the safe operation of the robotic arm.
130+
131+
### How to Properly Perform Robot Motion Control
132+
133+
When unsure about the target position's angles/coordinates, you can use the following method:
134+
135+
Use a Python script to obtain:
136+
137+
```python
138+
# Importing the Official Python API
139+
from pymycobot.mycobot import MyCobot
140+
# Importing the Time Module
141+
import time
142+
143+
# Setting up Serial Connection, Serial Port, Baud Rate
144+
# Raspberry Pi Version
145+
mc = MyCobot('/dev/ttyAMA0', 1000000)
146+
# M5 version, specific serial port number needs to be checked in Device Manager
147+
mc = MyCobot('COM0', 1000000)
148+
# Set a slight waiting time, 0.5 seconds
149+
time.sleep(0.5)
150+
# Release all joints of the robotic arm, please support the robotic arm by hand
151+
mc.release_all_servos()
152+
# Set waiting time, can be adjusted as needed; at this point, the robotic arm can be moved to the target position
153+
time.sleep(5)
154+
# Power on the robotic arm and fix it in the target position
155+
mc.power_on()
156+
# Read the coordinate information and angle information of the current position and output to the console
157+
print('Coordinates:', mc.get_coords())
158+
print('Angles:', mc.get_angles())
159+
```
160+
161+
Obtained using [myBlockly](https://chat.openai.com/c/www.baidu.com):
162+
163+
By utilizing the rapid movement feature in myBlockly, you can explore the motion range of the robotic arm, confirming the operational workspace of the robotic arm.
164+
165+
![myblockly](../../../resources/3-UserNotes/3.1-SafetyInstructions/myBlockly.png)
166+
78167
----
79168
[← Previous Page](../../320_M5/REMADE.md) | [Next Page →](../3.1.2-TransportandStorage/1-TransportandStorage.md)

4-FirstInstallAndUse/4.2-M5/4.2.3-StartRobot.md

+4
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,10 @@ The use case diagram is shown in the following figure: (Please carefully align i
5757
<img src="../../resources/4-FirstInstallAndUse/connect/急停安装3.jpg" width="500" />
5858
<br/>
5959

60+
> ① When using the robot arm, turn the emergency stop knob clockwise to keep the emergency stop switch released;
61+
> ② In case of abnormal movement of the arm, please press the emergency stop switch in time, and hold the arm steady to place the fall.
62+
> ③ When resuming the use of the arm after the emergency situation has ended, turn the emergency stop knob clockwise to release the emergency stop switch and re-power the arm.
63+
6064
**Step 4:**<br>
6165
<img src="../../resources/4-FirstInstallAndUse/connect/电源安装1.jpg" width="500" />
6266
<br/>

5-BasicApplication/5.1-SystemUsageInstructions/320m5/4.2.2.1-micro_controller.md

+7
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@
33
| <img src="../../../resources/3-UserNotes/3.1-SafetyInstructions/danger.png" alt="img-1" width="100" height=“100” /> | This operation has been performed before the default robot is delivered. You do not need to repeat the operation. Incorrect use of this function may cause damage to the robot. If your robot works without abnormal conditions, **please do not use it**. Thank you for your cooperation. |
44
|------------------------|-------------------|
55

6+
> **Before performing a zero calibration, allow the machine to return to zero and check for any deviation in the zero attitude. If there is, then perform zero calibration; if not, zero calibration is not required.**
7+
> You can use pythonAPI to make the joints reach the zero position: ```send_angles(degrees, speed)```, where degrees is a floating-point list with [0,0,0,0,0,0,0,0] representing the zero position of the six joints, and speed is the speed at which the joints are moving, which takes the values of 0 to 100.
8+
69

710
<img src="../../../resources/5-BasicApplication/5.4/5.4.5/校准1.jpg" alt="img-1" width="400" height=“auto” /><br>
811

@@ -51,6 +54,10 @@ In this chapter, we will teach you how to calibrate the robot arm and to test an
5154

5255
<img src="../../../resources/5-BasicApplication/5.4/5.4.5/校准4.jpg" alt="img-1" width="400" height=“auto” /><br>
5356

57+
> **Calibration results**
58+
59+
<img src="../../../resources/5-BasicApplication/5.4/5.4.5/校准结果.png" alt="img-1" width="400" height=“auto” /><br>
60+
5461
**Step 5:** Press **EXIT** to stop calibration and then press **B** to test the zero positions of all joints.
5562

5663
> The joints will rotate positively and negatively by 15-30 degrees and return to the zero position.

5-BasicApplication/5.2-ApplicationUse/5.2.1-myblockly/320m5/3-interface_description.md

+3
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,9 @@ First connect `myCobot 320 M5` to our computer through `USB data cable`,
3737

3838
And then we select the initialization model as `myCobot 320`, the port connected to my computer is `COM8`, and the baud rate is `115200`
3939

40+
> The com port number is not fixed, you need to choose according to the actual port number of the individual PC connection
41+
> How to choose the corresponding port number: by unplugging the usb cable on the side of the M5stack to see if there is any change in the corresponding port number to choose, unplugged in both cases there is a change in the com port is the machine's communication serial port.
42+
4043
![](../../../../resources/5-BasicApplication/5.2.1/m5/img/interface/2.png)
4144

4245

5-BasicApplication/5.2-ApplicationUse/5.2.1-myblockly/320m5/README.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@
66

77
**myBlockly** is similar in function/design to MIT's children's programming language Scratch.
88

9-
When using **myBlockly**, users can build code logic by dragging modules. The process is like building blocks.
9+
When using myBlockly, users can build code logic by dragging modules. The process is like building blocks.
1010

11-
From the user's perspective, **myBlockly** is a simple and easy-to-use visual tool for generating code. From a developer's perspective, **myBlockly** is a text box that contains the code entered by the user.
11+
From the user's perspective, myBlockly is a simple and easy-to-use visual tool for generating code. From a developer's perspective, myBlockly is a text box that contains the code entered by the user.
1212

13-
The process of generating code into the text box is the process of the user dragging it in **myBlockly**.
13+
The process of generating code into the text box is the process of the user dragging it in myBlockly.
1414

1515
## The operating systems supported by myBlockly are as follows:
1616

5-BasicApplication/5.2-ApplicationUse/5.2.2-mystudio/320m5/3-flash_firmwares.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Burn and update firmware
22

3-
**[myStudio Video tutorial](https://www.bilibili.com/video/BV1Qr4y1N7B5/)**
4-
53

4+
> Customers get the machine does not need to be burned in non-essential cases, the factory has already been burned, only a few cases need to be burned.
5+
> For example: minirobot corresponding to the need to burn the scene of the LCD screen does not light up, burn the Arduino program needs to be switched to python program control, Atom firmware corresponding to the need to burn the scene of the joints can not be locked, Atom lights do not light up and so on.
66
77
## Burn Atom firmware
88

Loading
Loading
Loading
Loading
-22.5 KB
Binary file not shown.
Loading

0 commit comments

Comments
 (0)