5.f. OrangutanPushbuttons - Pushbutton Interface Library


This library allows you to easily interface with the three user pushbuttons on the 3pi robot, Orangutan SV-xx8, and Orangutan LV-168 by either polling for the state of specific buttons or by waiting for press/release events on specifiable buttons. The waitFor____() methods in this library automatically take care of button debouncing.

You do not need to initialize your OrangutanPushbuttons object before use. All initialization is performed automatically when needed.

All of the methods in this class are static; you should never have more than one instance of an OrangutanPushbuttons object in your sketch.

OrangutanPushbuttons Methods

Complete documentation of this library’s methods can be found in Section 9 of the Pololu AVR Library Command Reference.

Usage Examples

This library comes with an example sketch that you can load by going to File > Examples > OrangutanPushbuttons.

1. OrangutanPushbuttonExample

Demonstrates interfacing with the user pushbuttons. It will wait for you to push either the top button or the bottom button, at which point it will display on the LCD which button was pressed. It will also detect when that button is subsequently released and display that to the LCD.

#include <OrangutanLCD.h>
#include <OrangutanPushbuttons.h>

 * OrangutanPushbuttonExample: for the 3pi robot, Orangutan LV-168,
 *    and Orangutan SV-xx8
 * This example uses the OrangutanPushbuttons library to detect user input
 * from the pushbuttons, and it uses the OrangutanLCD library to display
 * feedback on the LCD.

OrangutanPushbuttons buttons;
OrangutanLCD lcd;

void setup()                    // run once, when the sketch starts

void loop()                     // run over and over again
  // wait for either the top or bottom buttons to be pressed
  // store the value of the pressed button in the variable 'button'
  unsigned char button = buttons.waitForPress(TOP_BUTTON | BOTTOM_BUTTON);
  if (button == TOP_BUTTON)     // display the button that was pressed
    lcd.print("top down");
    lcd.print("bot down");
  buttons.waitForRelease(button);  // wait for that button to be released
  lcd.print("released");      // display that the button was released

Related Products

Baby Orangutan B-328 + USB Programmer Combo
Baby Orangutan B-48 + USB Programmer Combo
Baby Orangutan B-168 + USB Programmer Combo
3pi Robot + USB Programmer + Cable Combo
Orangutan SV-168 Robot Controller
Orangutan SV-168 + USB Programmer Combo
Orangutan LV-168 + USB Programmer Combo
Orangutan SV-328 + USB Programmer Combo
Baby Orangutan B-328 + USB AVR Programmer Combo
Baby Orangutan B-48 + USB Programmer Combo
Orangutan LV-168 + USB Programmer Combo
Orangutan SV-328 + USB Programmer Combo
Orangutan SV-328 Robot Controller
Orangutan LV-168 Robot Controller
Baby Orangutan B-48 Robot Controller
Baby Orangutan B-328 Robot Controller
Pololu 3pi Robot
Log In
Pololu Robotics & Electronics
Shopping cart
(702) 262-6648
Same-day shipping, worldwide
Shop Blog Forum Support
My account Comments or questions? About Pololu Contact Ordering information Distributors