New release! We've added documentation for the Mechaduino 0.2 hardware and fixed a couple small bugs. Here are some preliminary instructions on how to get your Mechaduino up and running. For more details, see the Mechaduino Manual above!
Bootloader:
You will need to make sure your Mechaduino has the latest Arduino Zero bootloader. If you got your Mechaduino from Tropical Labs, it will already have this! Otherwise you will need an Atmel-ICE or similar SWD programmer...
Firmware:
Compile the Mechaduino firmware in the Arduino IDE and upload to your Mechaduino. (Mechaduino will appear as an Arduino Zero (Native USB Port).)
Libraries required:
- ArduinoUniqueID 1.1.0
- FlashStorage 1.0.0
New firmware is in the default "master" branch. Older versions are available here.
Calibration Routine:
The first thing you will need to do is run the encoder calibration routine.
With the Mechaduino connected to your computer, open a serial monitor (115200 baud) in the Arduino IDE. You will need to provide V+ to the Mechaduino to power the motor drivers (needed to calibrate). A menu should appear explaining the basic commands (you can call the menu up at any time by typing 'm'). Type "s" and press enter a couple times to verify that everything is working. The Mechaduino should step like a stepper. It is currently in open loop mode. press "d" and the stepping direction will change.
Now, make sure nothing will touch the Mechaduino shaft during calibration. Type "c" to start the calibration routine. The Mechaduino will now step through all full steps to calibrate the encoder. When the routine is done, the calibrated values will be written to the flash memory.
Basic Commands:
As long as you have "serialCheck();" in your main loop, you can use the following built in commands to control the mechaduino from a serial monitor:
s - step (steps one full step in open loop mode)
d - dir (changes step direction in open loop mode)
p - print angle [step count] , [assumed angle] , [encoder reading]
c - calibration routine
e - check encoder diagnostics
q - parameter query (prints current PID values and cal table)
x - position mode
v - velocity mode
t - torque mode
y - enable control loop (enter closed loop mode)
n - disable control loop (go back to open loop mode)
r - enter new setpoint (new setpoint for control loop)
j - step response
k - edit controller gains*
g - generate sine commutation table
m - print main menu
...see serialCheck() in Utils for more details
License
All Mechaduino related materials are released under the Creative Commons Attribution Share-Alike 4.0 License