This is a C++ library for Arduino for controlling the ASURO robot. Tested with Arduino IDE v1.6.13 and 1.8 on macOS and Windows.
- Download the ZIP file and extract everything.
- Rename the folder
Asurino-Library-0.6.1(depending on the way you downloaded it from GitHub) to
- Move the
C:\Users\<username>\Documents\Arduino\libraries(Windows) or your
- Move the contents of
move to hardwareto
C:\Users\<username>\Documents\Arduino\hardware(Windows) or your
˜/Documents/Arduino/hardwarefolder (macOS). If the "hardware" folder does not exist, create it.
- Delete the empty
move to hardwarefolder.
When installed, the library should look like this (macOS example):
˜/Documents/Arduino/libraries/asuro (this library's folder) ˜/Documents/Arduino/libraries/asuro/src/Asuro.cpp (the library implementation file) ˜/Documents/Arduino/libraries/asuro/src/Asuro.h (the library description file) ˜/Documents/Arduino/libraries/asuro/keywords.txt (the syntax coloring file) ˜/Documents/Arduino/libraries/asuro/examples (the examples in the "open" menu) ˜/Documents/Arduino/libraries/asuro/readme.txt (this file) ˜/Documents/Arduino/hardware/asuro/avr/boards.txt (ASURO board definition) ˜/Documents/Arduino/hardware/asuro/avr/platform.txt (ASURO platform compile options)
Instead of adding the two hardware definition files to your installation, you can also
edit the original
boards.txt file (not recommended, as it will get overwritten when
installing new versions of the Arduino IDE):
- Close the Arduino IDE
- Windows: Open
C:\Program Files\Arduino\hardware\arduino\avr\boards.txtwith WordPad, for example
- macOS: Right-click on the Arduino programm in your Programs folder, select
Show Content, then open
- Add the following lines to the end of
asuro8.name=Asuro w/ ATmega8 asuro8.upload.protocol=stk500 asuro8.upload.maximum_size=7168 asuro8.upload.speed=2400 asuro8.upload.tool=arduino:avrdude asuro8.bootloader.low_fuses=0xdf asuro8.bootloader.high_fuses=0xca asuro8.bootloader.path=atmega8asuro asuro8.bootloader.unlock_bits=0x3F asuro8.bootloader.lock_bits=0x0F # asuro8.bootloader.file=ATmegaBOOT_8_asuro.hex asuro8.build.mcu=atmega8 asuro8.build.f_cpu=8000000L asuro8.build.board=AVR_ASURO8 asuro8.build.core=arduino:arduino asuro8.build.variant=arduino:standard
Building an ASURO Sketch
After the library is installed, you just have to start the Arduino application.
Asuro w/ ATmega8from the Arduino menu
To use this library in a sketch, go to the
Import Library menu and
Asuro. This will add a corresponding line to the top of your sketch:
To stop using this library, delete that line from your sketch. Please take a look at the
example sketches in the
Examples menu of the Arduino IDE.
Uploading the compiled sketch to ASURO directly from the Arduino IDE is not
supported. You have to select
Export compiled binary file and
Show sketch folder
Sketch menu. Upload this file with the ASURO Flash Tool (Windows)
or ASURO McFlash (macOS).
You'll find ASURO McFlash in the Mac App store.
After a successful build of this library, a new file named
Asuro.o will appear
Arduino-xxxx/hardware/libraries/Asuro. This file is the built/compiled library
If you choose to modify the code for this library (i.e.
then you must first 'unbuild' this library by deleting the
Asuro.o file. The
Asuro.o with your code will appear after the next press of
This library is based on a sketch for the ASURO by Jakob Remin. Version 0.3 of this library was developed by m_a_r_v_i_n and sternthaler.