The Mini Arm is a miniature version of the Desktop-Arm project, a portable 6DOF 3D-printed open-source robot arm. This cool device runs on a 5V 2A DC adapter and features:
- Runs on Raspberry Pico microcontroller with python code using CircuitPython
- Has an IK solver to handle joint state calculation on the microcontroller itself!
- All 3D printable components (aside from nuts & bolts)
- Total parts cost <= $60
- Weighs less than 1lb (0.3kg to be exact)
These install instructions were tailored using a Windows 10 OS. There are also setup instructions for Ubuntu and the Raspberry Pi too.
This GitHub repository contains Installation and Quick Start instructions for the Mni Arm project. Here is a description of the repository structure:
miniarm_ros
- Contains ROS packages for the Mini Armpico
- Contains CircuitPython firmware and code for the Mini Arm using a Raspberry Pico microcontrollertests
- Python test scripts for the packageXboxClient
- Teleop script to run on a PC with a connected Xbox controller
- It is recommended to use a virtual environment to manage dependencies. To create a new virtual environment with anaconda, use the following command:
conda create -n miniarm python=3.10 conda activate miniarm
- Download the repository using git:
git clone https://github.com/Jshulgach/Mini-Arm.git cd Mini-Arm
- To install dependencies, use the provided requirements file:
pip install -r requirements.txt
-
Building the arm
- The full list of parts needed to assemble the arm can be found in the B.O.M.
- Files for 3D printing can be found on HowToMechatronics with assembly instructions
-
Electrical wiring
When the arm first turns on, the LED will change to green to indicate successful connection to the network. A blue light indicates a successful connection to the server with a client. Open the xbox-client.py
file and set COMM_TYPE
to the same type set for Mini Arm in the settings.toml
file. Plug in a controller, open a terminal in the directory containing the xbox-client.py
file, then run the python file:
python xbox-client.py
Robot control cana also be done through the Unity version of the "AJ" GUI v1 (Link coming soon), or an SSH terminal to the robot. FOR TCP/IP, quickest way using a python terminal:
The Mini Arm can be visualized in RViz2 using the included ROS2 packages. Refer to the build instructions for more information.
Feel free to reach out to me in case of any issues.
If you find this repo useful in any way please do star ⭐️ it so that others can reap it's benefits as well!
This project is inspired from the work done by:
Copyright 2022-2023 Jonathan Shulgach
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one at https://mozilla.org/MPL/2.0/.