Environment Building
pymycobot is a Python package used for serial communication with myCobot. It supports Python2, Python3.5 and later versions.
Before using pymycobot, make sure to build a Python environment. Follow the steps below to install Python.
1 Download and Installation of Python
At present, Python has two versions: 2.x
and 3.x
. These two versions are incompatible with each other. This section takes the version 3.x
as an example due to its increasing popularity.
1.1 Installing Python
Notice: Before installation, check the operation system of PC. Press right button on the
My Computer
icon and then selectProperties
. Install the corresponding Python.
- Go to http://www.python.org/download/ to download Python.
- Click on
Downloads
, and then download begins. TickAdd Python 3.10 to PATH
. Click onInstall Now
, and then installation begins.
Download and installation complete.
1.2 Running Python
Open the command prompt window (Win+R, input cmd
and press Enter
). Type Python
.
Successful Installation:
This on-screen instruction means that Python is successfully installed. The prompt >>>
means Python interactive environment. If you input a Python code to get the execution result immediately.
Error Report:
If a wrong instruction is typed, for example "pythonn", the system may report an error.
Notice: Generally, the error results from lack of environment configuration. Refer to 1.3 Environment Configuration to solve problems.
1.3 Environment Variable Configuration
Windows follows the path set by a Path environment variable in search of python.exe . Otherwise, an error will be reported. If you fail to tick Add Python 3.9 to PATH
during installation, you need to manually add the path where python.exe is located into environment variable or download python again. Remember to tick Add Python 3.9 to PATH
.
Follow the steps below to add python into environment variable manually.
- Right click on
My Computer
icon -->Properties ->Advanced System Settings ->Environment Variables
- The environment variables include user variables and system variables. For user variables, users can utilize their own downloaded programs via
cmd
command. Write the absolute path of the target program into the user variables.
- After the configuration, open the command prompt window (Win+R; input
cmd
and pressEnter
), and typePython
.
2 Installation of PyCharm
PyCharm is a powerful python editor with the nature of cross-platform. Follow the steps below to download and install PyCharm.
Go to PyCharm to download PyCharm.
2.1 Download and Installation
Official website view:
It is recommended to install the free version.
- Click on
Next
:
- Select options according to your needs and then select
Next
:
- Tap
Install
:
- Installing:
Tap
Finish
2.2 Create a new project
- Click
+New Project
:
The
Interpreter
is used to interpret python programs. SelectAdd Interpreter
->New
to add base interpreter.Location
refers to the place where to save python file. Choose a file to put your programs.Click on
Create
and a sample appears:Right click on the selection that the red arrow points, and create a new python file.
Type name for the new file.
3 Preparations
Firmware burning. Firmware serves as a driver for systems to control robots.
- M5Stack version Make sure to burn
minirobot
for Basic at the bottom. And then chooseTransponder
function (to receive instructions from Basic), PressPress A
.Atom: OK
means connect successfully. Refer to MyStudio) for more information about firmware burning.
- M5Stack version Make sure to burn
pymycobot installation. Type
pip install pymycobot --upgrade --user
via terminal (Win+R)cmd
command.pip install pymycobot --upgrade --user
Source code installation. Open a terminal (Win+R, input
cmd
), and type the command below to install.git clone https://github.com/elephantrobotics/pymycobot.git <your-path> #Fill in your installation address in <your-path>, do not choose the current default path. cd <your-path>/pymycobot #Go to the pymycobot folder of the downloaded package. #Run one of the following commands according to your python version. # Install python2 setup.py install # or python3 setup.py install
Update pymycobot
pip install pymycobot --upgrade
4 Import of pymycobot
After the above preparations are completed, the control of the robotic arm begins with Python code. Here's an example of the myArm Controller 650 version.
- Import pymycobot library for MyArmC :
from pymycobot import MyArmC
Notice:
- If no red wavy line appears below the codes, pymycobot is successfully installed.
- if a red wavy line appears, got to the address https://github.com/elephantrobotics/pymycobot to download pymycobot manually and put it into python library.
5 Simple Demo
Create a new Python file, and type the following codes to set the color of RGB light panel.
Notice: The baud rates are different according to types of devices. Refer to calculator device manager to check the corresponding number.
- Codes for MyArmC:
# demo.py
from pymycobot import MyArmC
import time
# Initiate MyCobot
# Create object code here for windows version
myarmc = MyArmC("COM4", 115200)
i = 7
#loop 7 times
while i > 0:
myarmc.set_tool_led_color(0, 0, 255) # blue light on
time.sleep(2) # wait for 2 seconds
myarmc.set_tool_led_color(255, 0, 0) #red light on
time.sleep(2) # wait for 2 seconds
myarmc.set_tool_led_color(0, 255, 0) #green light on
time.sleep(2) # wait for 2 seconds
i -= 1
Run the example file:
python3 demo.py
The blue, red, and green lights on the top of the robot flash 7 times continuously at an interval of 2 seconds.