how to set stuff up
This page details software and hardware setup. This will take a few steps, but then you'll be set up to use your ArbotiX:
Arduino is an open-source electronics prototyping platform based on flexible, easy-to-use hardware and software. -- arduino.cc
The ArbotiX software is based on Arduino. The first thing we need to do is to install the Arduino software:
The rest of this document assumes familiarity with the Arduino environment. See the Arduino documents for details on using the Arduino IDE.
To use the ArbotiX with the Arduino IDE we need to add some files to our Arduino sketchbook folder.
Most users will want to download the latest ArbotiX/PyPose release from the front page, extract the zip file, and copy the contents of the arbotix folder into the sketchbook. This includes the hardware folder, libraries folder and a number of example sketches.
Alternatively you can checkout the absolute latest, bleeding edge source from our SVN repository, and then locate the files correctly as described above.
Please see the downloadable ArbotiX manual for instructions and guidance in connecting external devices and power to the board. Although all boards ship with the pypose sketch already installed, we recommend always upgrading to the newest version, in case changes have been made since your board was produced.
See the RX-Bridge page for details on setting up an RX Bridge.
Upload PyPose Sketch
Now, let's test our Arduino installation and programmer. Before PyPose can interact with our robot, we need to download a program (or a sketch as the Arduino environment calls them) onto the ArbotiX. The "pypose" sketch provides a pass through from the ArbotiX to the Bioloid bus, by speaking the correct protocol with PyPose.
Open the Arduino IDE, from File -> Open select the PyPose sketch. From the Tools -> Board menu, select ArbotiX board to make sure all went well above. Connect your board via either the ISP or FTDI cable, select the correct port, and Upload it. While we ship each board with a version of pypose installed, it may not be the latest. Please Note: An FTDI cable should not be connected at the same time as an XBEE radio is in the board. Always remove the XBEE radio before connecting an FTDI cable
Any time you load your own code onto the board, it will overwrite the pypose sketch, so you'll have to upload it before using pypose again.
If you want to use an In-System Programmer (ISP), the usage has changed in Arduino 1.0. You now use File->Upload using Programmer and no longer have to manually edit files! The Arduino environment now includes a number of supported programmers, but we have added one for the Pololu Serial ISP which shows up as AVRISP mkII (serial).
With a bootloader on the ArbotiX, you can do wireless uploading. The ArbotiX bootloader runs at a 38400 baud rate, so your XBEE radios need to be set to 38400 for wireless downloading. You'll also have to manually push the RESET button. A tutorial on getting around the reset button push is here: http://www.ladyada.net/make/xbee/arduino.html
Note: wireless uploading is dangerous, if you experience RF-interference something may go wrong. We do not recommend doing this unless you have an ISP to restore the bootloader, and also have enough experience to know how to restore the bootloader.
PyPose is a pose and capture program, written in Python using wxPython. We of course will have to install Python, wxPython, PySerial to access serial ports, and then PyPose itself.
If using Ubuntu, you can install items 1-3 of the above with: sudo apt-get install python python-serial python-wxgtk2.8.
Connect with PyPose
Congratulations, your ArbotiX and PyPose are setup! Now you can go to the PyPose documentation page to start interacting with your robot.