Escornabot-lib

An Escornabot Arduino library created for Luci.

This library contains all the core functions and data required to program an Escornabot ROBOT. One of the programs is the fully fledged standard firmware for the robot itself.

Simple example

#include <Escornabot-lib.h>
Escornabot luci;  // create the Escornabot object


void setup() {
	luci.init();  // initialization
	luci.beep(EB_BEEP_DEFAULT, 100);
	luci.showColor(20, 0, 50);  // purple
	delay(1000);
}

void loop() {
	// advance
	luci.showKeyColor(EB_KP_KEY_FW);  // blue
	luci.beep(EB_BEEP_FORWARD, 100);
	luci.move(10.0);

	// turn
	luci.showKeyColor(EB_KP_KEY_TR);  // green
	luci.beep(EB_BEEP_TURNRIGHT, 100);
	luci.turn(90);
}

Installation

1. Download and install the Arduino IDE 1.6 (or newer)
2. Open the Library Manager from the menu Tools → Manage Libraries...
3. Search the Escornabot-lib library using the input field
4. Select the one from ROBOteach, pick the last version from the dropdown combobox and click Install

You can try now some of the examples from the menu File → Examples → Escornabot-lib.

Escornabot

Escornabot is an educational open-source and open-hardware ROBOT, created in Galicia in 2014 and evolving since then.

From a functional perspective, it is a device composed of:

• An Arduino, typically a Nano (the brains)
• Two 28BYJ-48 5V stepper motors with its driver[s] (the movement)
• A 5V passive buzzer (the sound)
• A LED, or LEDs, or a NeoPixel now (the light)
• A 5 keys analog keypad (the input)
• An energy source, batteries or powerBank (the power)
• A chasis with two wheels, normally 3D printed (the shape)

arranged in a particular physical configuration that allows it to move and turn in a surface, do sound and light, and accept user input, to perform different tasks (typically used as a programmable buttoned floor robot).

Documentation

This library source code is documented using Doxygen format, although no documention has been generated yet.

Meanwhile, in the examples folder, besides the firmware itself, there are several programs that may be useful to understand how it works.

LICENSE

This work is licensed under the GNU General Public License v3.0. All media and data files that are not source code are licensed under the Creative Commons Attribution 4.0 BY-SA license.

More information about licenses in Opensource licenses and Creative Commons licenses.