6. Zumo Shield Arduino Libraries

Our Zumo Shield Libraries make it easy to get started writing Arduino sketches to control your Zumo. A link to download the library and installation instructions can be found on the libraries’ github page.

Once installed, we recommend you try out the example sketches for each library, which can be found under File > Examples > (name of the library), to get a better understanding of how to use the library functions. You can also find some more complex examples, not specific to any particular library, under File > Examples > ZumoExamples; Section 7 describes these examples in detail.

The Zumo Shield Libraries include the following:

ZumoMotors

The ZumoMotors library provides functions for PWM-based speed (and direction) control of the two motors on the Zumo with the onboard DRV8835 dual motor driver. On Arduinos with ATmega328P, ATmega168, and ATmega32U4 microcontrollers (which include the Leonardo, Uno, and most older Arduinos), the motor control functions use hardware PWM outputs from Timer1 to generate pulse width modulation at a 20 kHz frequency. (See Section 3 for more details about the motor driver and its connections.)

If you accidentally soldered a motor to the Zumo Shield backwards (opposite the orientation indicated in the assembly instructions), you can simply call flipLeftMotor(true) and/or flipRightMotor(true) to make the motors behave consistently with the directions in your code.

ZumoBuzzer

The ZumoBuzzer library provides functions that allow various sounds to be played on the buzzer of the Zumo Shield, from simple beeps to complex tunes. (See Section 3 for more details about the buzzer and Section 3.c for an explanation of the buzzer control jumper settings.)

The ZumoBuzzer library is fully compatible with the OrangutanBuzzer functions in the Pololu AVR C/C++ Library, so any melodies written for OrangutanBuzzer functions will also work with ZumoBuzzer functions.

Pushbutton

The Pushbutton library provides a set of functions that are useful for detecting and debouncing pushbutton presses. While the most obvious application of this library is to work with the Zumo Shield’s user pushbutton on digital pin 12, this library can be used as a general-purpose library for interfacing many types of buttons and switches to an Arduino, even without a Zumo Shield.

ZumoReflectanceSensorArray

This library provides a set of functions for reading reflectance values from a Zumo reflectance sensor array. See Section 2.c for more information on the Zumo reflectance sensor array.

This library depends on the QTRSensors library. The ZumoReflectanceSensorArray class is a subclass of QTRSensorsRC. The functions provided by QTRSensorsRC can also be used on the ZumoReflectanceSensorArray class, and are documented in the Arduino Library for the Pololu QTR Reflectance Sensors document.

QTRSensors

This library, which can also be found in the qtr-sensors-arduino repository, is a general library for interfacing with Pololu QTR reflectance sensors. Since the Zumo reflectance sensor array has the same interface as the QTR RC reflectance sensors, the ZumoReflectanceSensorArray library uses QTRSensors to read the sensor array.