Getting Started: How to work with kilobots
To operate with the kilobots, we recommend the use of the KiloGUI software.
The KiloGUI can be downloaded from GitHub here: https://github.com/acornejo/kilogui
A complete documentation about its functioning can be found on the kilobotics website: https://www.kilobotics.com/documentation
On Linux, run kilogui with sudo privileges.
Upload your first control software on a kilobot
Try to upload a test control software on kilobots following these steps:
- download the file: blank.hex
- run kiloGui
- select as Program file the file you just downloaded
- turn on the kilobot by adding the power jumper (see Figure), and place it under the IR communication cone of the OHC (see Figure).
- click on Bootload button (and the kilobot must switch on the blue LED immediately)
- when the blue LED is on, click on Upload and wait some seconds (the kilobot's LED should blink at high frequency)
- when the kilobot stops blinking, try to run the program on kilobot, by clicking the button Run
- the expected behaviour is the robot keeping blinking in alternate colours red and green. Have fun! :-)
Write your own control software
The API documentation of the firmware 2.0 functions is available here: https://www.kilobotics.com/docs/index.html
A good tutorial to learn how to program kilobots can be found here: https://www.kilobotics.com/labs
Compile your own control software
To compile the control software for the kilobot, use the kilolib that you can download from GitHub here: https://github.com/acornejo/kilolib
Needed dependencies are avr-libc, gcc-avr, avrdude:
- on Ubuntu:
sudo apt-get install avr-libc gcc-avr avrdude
- on Mac OSX:
brew tap larsimmisch/avr brew install avr-libc brew install avrdude --with-usb
in case the tap larsimmisch/avr does not work, you can try with this:
brew tap osx-cross/avr brew install avr-libc
Begin with a test by compiling the blank.c file, executing the command:
cd <path-to-the-kilolib-dir> make blank
You will find the compiled control software as a hex file in the directory build/
Then, edit the Makefile to compile your own code.