Examples > Robot

This sketch shows you basic movement with the Robot. When the sketch starts, press the buttons ont he control board to indicate the direction you want the robot to move. After you've keyed in your sequence (up to 20 steps at a time), press the middle button to record the steps to memory. Put your robot on the floor for it to follow the directions you programmed.

Hardware Required

  • Arduino Robot


  1. Upload the example, unplug USB and turn on power

  2. Place the robot on the floor, in a clear space, so it can move around.

  3. After the starting images on the screen, the robot will ask you to add commands.

  4. Press the buttons according to how you want the robot to move; the commands will be stored and executed later.

  5. Left makes the robot turn left for 90 degrees, right makes it turn right. Up makes the robot go forward for 1 second, down makes it go backwards for 1 second.

  6. After you're done with the commands, press the middle button. The robot will start executing the commands in order. At most, the robot will remember 20 commands. If you fill them all, the robot will start executing before you press the middle button

  7. After running the sequence, the robot will return to the 3rd step. Adjust your commands and do it again!

Try it out

LottieLemon logo 780

Program the movements on the D-pad

LottieLemon logo 2 780

Repeat the movement sequence


First, explain the code line by line

/* Robot Logo

 This sketch demonstrates basic movement of the Robot.

 When the sketch starts, press the on-board buttons to tell

 the robot how to move. Pressing the middle button will

 save the pattern, and the robot will follow accordingly.

 You can record up to 20 commands. The robot will move for

 one second per command.

 This example uses images on an SD card. It looks for

 files named "lg0.bmp" and "lg1.bmp" and draws them on the



 * Arduino Robot

 created 1 May 2013

 by X. Yang

 modified 12 May 2013

 by D. Cuartielles

 This example is in the public domain


#include <ArduinoRobot.h> // include the robot library
#include <Wire.h>

int commands[20];  //  array for storing commands

void setup() {

  // initialize the Robot, SD card, and display




  // draw "lg0.bmp" and "lg1.bmp" on the screen


void loop() {

  Robot.drawBMP("intro.bmp", 0, 0);  //display background image

  iniCommands(); // remove commands from the array

  addCommands(); // add commands to the array

  delay(1000); // wait for a second

  executeCommands(); // follow orders

  Robot.stroke(0, 0, 0);

  Robot.text("Done!", 5, 103); // write some text to the display

  delay(1500); // wait for a moment

// empty the commands array
void iniCommands() {

  for (int i = 0; i < 20; i++) {

    commands[i] = -1;


// add commands to the array
void addCommands() {

  Robot.stroke(0, 0, 0);

  // display text on the screen

  Robot.text("1. Press buttons to\n add commands.\n\n 2. Middle to finish.", 5, 5);

  // read the buttons' state

  for (int i = 0; i < 20;) { //max 20 commands

    int key = Robot.keyboardRead();

    if (key == BUTTON_MIDDLE) { //finish input


    } else if (key == BUTTON_NONE) { //if no button is pressed



    commands[i] = key; // save the button to the array

    PrintCommandI(i, 46); // print the command on the screen




// run through the array and move the robot
void executeCommands() {

  // print status to the screen

  Robot.text("Excuting...", 5, 70);

  // read through the array and move accordingly

  for (int i = 0; i < 20; i++) {

    switch (commands[i]) {

      case BUTTON_LEFT:



      case BUTTON_RIGHT:



      case BUTTON_UP:

        Robot.motorsWrite(255, 255);


      case BUTTON_DOWN:

        Robot.motorsWrite(-255, -255);


      case BUTTON_NONE:



    // print the current command to the screen

    Robot.stroke(255, 0, 0);

    PrintCommandI(i, 86);


    // stop moving for a second




// convert the button press to a single character
char keyToChar(int key) {

  switch (key) {

    case BUTTON_LEFT:

      return '<';

    case BUTTON_RIGHT:

      return '>';

    case BUTTON_UP:

      return '^';

    case BUTTON_DOWN:

      return 'v';


// display a command
void PrintCommandI(int i, int originY) {

  Robot.text(keyToChar(commands[i]), i % 14 * 8 + 5, i / 14 * 10 + originY);

See Also: