µracoli Arduino-Support-Package
Version foo
|
Arduino is a Microcontroller Development plattform that consists of a Java-IDE which supports various microcontroller boards. Most of the supported boards are equipped mit 8-bit-AVR microcontrollers.
Basically the Arduino-IDE provides a simple code editor and the firmware (denoted as "sketches") can be compiled and flashed with a button click. A serial terminal completes the IDE. This high level of abstration makes it very easy for none technicians and first-time users to start with embedded programming.
A sketch basically implements two functions setup()
and loop()
that are called from the main function of the core library. A simple API is provided, that is described at http://arduino.cc/en/Reference/HomePage.
µracoli provides a support package package for the Arduino-IDE with versions above 1.5.x.
The following boards are supported in the package:
The Arduino project did fork in 2014, see http://hackaday.com/2015/04/06/arduino-ide-forked/ for details. Since this time there are two versions of the IDE avaiable.
Select one of the forked IDEs
and install it on your computer according to the instructions for your OS (Linux, Windows, MAC-OS).
Download the UASP-zipfile uracoli-arduino-15x-
<version>.zip from http://uracoli.nongnu.org/download.html
With this method the package is installed centrally for all users. The UASP example sketches are located in "File / Examples / Radio"
"cd /opt/arduino-1.6.5/"
)"unzip uracoli-arduino-15x-<version>.zip"
)hardware
, examples
, doc
) the fell directly in the existing Arduino-IDE directories."./arduino"
)."Tools / Board"
the boards Radiofaro, Zigbit2400 and Zigbit900, the installation was successful.This method installs the UASP locally in the sketchbook folder of the current user. The UASP example sketches are located in "File / Sketchbook / Radio"
"/opt/arduino-1.6.5/arduino"
)"Files / Preferences"
)"Sketchbook location"
, e.g. "cd /home/axel/Arduino"
."unzip uracoli-arduino-15x-<version>.zip"
)hardware
, examples
, doc
) the fell directly in the existing Arduino-IDE directories."/opt/arduino-1.6.5/arduino"
) to load the UASP boards and examples into the IDE."Tools / Board"
the boards Radiofaro, Zigbit2400 and Zigbit900, the installation was successful.Restart the Arduino-IDE after unpacking uracoli-arduino-
<version>.zip and check if you see the new boards at the end of the list that opens if you click the menu entry "Tools/Board"
and select your radio board, e.g. "Radiofaro", "Zigbit 2400MHz", etc.
In the next step select the in the menu "Tools / Serial Port"
the serial port to which your radio board is connected.
Now open the HelloRadio
sketch. It can be found either in "File / Examples / Radio"
or "File / Sketchbook / Radio"
, depending on the installation option you did choose (see Installation).
Now select the menu entry "File / Upload"
. The sketch will compiled and flashed to the choosen radio board.
"compile verbose"
and "upload verbose"
in the dialogue that opens when clicking "File / Preferences"
and check in the lower window pane of the Arduino-IDE what goes wrong.The sketch "HelloRadio", that you have currently uploaded, sends a short frame every 500ms on channel 17 and reports the transmission also on its serial port. You can open a terminal with "Tools / SerialMonitor"
and you should see in the terminal window:
Each printed number shows, that a frame was successfully transmitted. If you see this output, that means that you are now "on air".
A good starting point for using the radio functions are the example sketches.
The regular Arduino core functions are documented at http://arduino.cc/en/Reference/HomePage.
The radio specific functions are described in section Arduino Radio Functions.
Beside several thirdparty CLI tools, e.g. Arscons, Inotool, since version 1.5 the Arduino IDE supports its own CLI, see https://github.com/arduino/Arduino/blob/ide-1.5.x/build/shared/manpage.adoc
–pref
build.path=<your_build_dir> to the command.If the Arduino Bootloader in your board is accidently erased, you can restore it with the following procedure.
In order to flash the bootloader, use a flash programmer and a programming tool of your choice (avrdude, atprogram, Atmel-Studio) and flash the file to the board.
The source code and a precompiled Intel-Hex file of the bootloader is located in the directory hardware/uracoli/avr/bootloaders/radiofaro
.
Check also if the fuses are set correctly:
The preferred flashing program is avrdude since it comes with the Arduino distribution.
If the bootloader is flashed correctly, it can be checked with
This package incorporates source code from different license models, which has an influence on the usae of the code in proprieatary projects and environments.
According to the file header, the bootloader is licensed under GNU General Public License version 2.0. See http://www.gnu.org/licenses/gpl-2.0.txt or file link:license_gpl_2v0.txt[].
The files copied from the original Arduino core are licensed under the GNU Lesser General Public License version 2.1. This code is linked to each sketch. See http://www.gnu.org/licensesUold-licenses/lgpl-2.1.txt or file link:license_lgpl_2v1.txt[].
The sources of the µracoli radio functions are licensed under the modified 3 clause BSD license. See file link:license_uracoli.txt[].