Loading repository data…
Loading repository data…
AlexGustafsson / repository
A cross-platform low-level interface and high-level API for the Dobot Magician robotic arm written in Python 3
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
# Clone the repository
git clone https://github.com/AlexGustafsson/dobot-python
# Enter the directory
cd dobot-python
# Run an example program
python3 lib/test.py
Low-level interface
interface = Interface('/dev/tty.usbserial-0001')
if interface.connected():
print('Connected')
else:
print('Not connected')
device_name = interface.get_device_name()
print('Hello, my name is {}'.format(device_name))
pose = interface.get_pose()
print('I am currently in the following pose:', pose)
print('I can move slow')
interface.set_jog_joint_params(100, 50)
interface.set_point_to_point_command(2, 100, 50, 20, 0)
print('And I can move fast')
interface.set_joint_parameters(2000, 500)
interface.set_jog_command(1, 1)
print('I even have a laser!')
interface.set_end_effector_laser(True, True)
High-level abstraction
bot = Bot('/dev/tty.usbserial-0001')
if bot.connected():
print('Connected')
else:
print('Not connected')
bot.move_to(50, 50, 50, 0.5)
bot.slide_to(-50, 10, 20, 0.5)
The Dobot Magician seems like a fantastic robot arm. But my experience regarding its software and how to get it to work, or even access it, on different platforms have been one of the worst experiences I've had with a product.
Their Python SDK seems to be built around wrappers of various DLLs or dynamically linked libraries which lack any source. It can therefore not be considered especially open source or cross-platform.
The download server has been terrible, dropping downloads a few seconds in or reducing download speeds to a few KB/s. To make matters worse, their web site was hacked and redirected to a phishing website at the time of writing.
Once I was able to access their Magician Studio for macOS - it was all in Chinese without any real option to change language. I have been unable to try the Windows version due to the aforementioned issues with their website.
I was, however, able to access an API reference for their serial communication protocol which contained a lot of typos, duplicates, faulty numbers. But it was concise - so I decided to implement the protocol myself.
Previous art is https://github.com/luismesas/pydobot which implements a small subset of the protocol.
This library is currently actively being developed. It targets the Dobot Magician Communication Protocol v1.1.5 which is the latest version. It implements the entire protocol as a low-level interface.
As often as possible, the names for functions, parameters etc. follow those documented in the communication protocol.
There is also a high-level abstraction which is meant for simple use.
For now, refer to the source code as well as the example programs.
ls /dev/ | grep -i usb in Terminaltty.SLAB_USBtoUART or tty.usbserial.0001 as portAny contribution is welcome. If you're not able to code it yourself, perhaps someone else is - so post an issue if there's anything on your mind.
Clone the repository:
git clone https://github.com/AlexGustafsson/dobot-python && cd dobot-python
Although the project is very capable, it is not built with production in mind. Therefore there might be complications when trying to use the bot for large-scale projects meant for the public. The library was created to easily use the Dobot Magician and as such it might not promote best practices nor be performant.