Version: 5.1.0
Release date: 2022-08-31
www.pololu.com
These files are the software and drivers for the Pololu A-Star 32U4 and A-Star 328PB boards, along with Pololu's ATmega32U4-based robots (Zumo 32U4, Balboa 32U4, and Romi 32U4 Control Board).
For more information about A-Star boards and robots, see their user's guides:
These files are available on GitHub.
These files can be used to add A-Star and robot support to the Arduino IDE. Entries for Pololu A-Star Boards will appear in the Boards menu when you do this.
For most people, we recommend setting up A-Star support in the Arduino IDE by installing our boards package through the Boards Manager. (These instructions can also be found in the user's guide for each controller).
In the Arduino IDE, open the File menu (Windows/Linux) or the Arduino menu (macOS) and select "Preferences".
In the Preferences dialog, find the "Additional Boards Manager URLs" text box. Copy and paste the following URL into this box:
https://files.pololu.com/arduino/package_pololu_index.json
If there are already other URLs in the box, you can either add this one separated by a comma or click the button next to the box to open an input dialog where you can add the URL on a new line.
Click the "OK" button to close the Preferences dialog.
In the Tools > Board menu, select "Boards Manager..." (at the top of the menu).
In the Boards Manager dialog, search for "Pololu A-Star Boards".
Select the "Pololu A-Star Boards" entry in the list, and click the "Install" button.
For additional information, including instructions for uploading a sketch and troubleshooting, refer to the user's guide for your controller.
To manually add A-Star and robot support to the Arduino IDE, follow these steps.
Download the latest release archive from GitHub and decompress it.
Rename the directory "a-star-xxxx" (which includes this README, platform.txt, boards.txt, and other files) to "avr".
Locate your Arduino sketchbook directory. You can view your sketchbook location by opening the File menu and selecting Preferences in the Arduino IDE.
Inside the Arduino sketchbook folder, add a folder named "hardware" if it does not already exist.
Inside the "hardware" folder, add a folder named "pololu" if it does not already exist.
Move the "avr" folder into the "pololu" folder.
Restart the Arduino IDE.
In the Boards menu, you should now see entries for the Pololu A-Star boards.
If you do not see these entries in the "Boards" menu, make sure that the final path to this README looks like this (where "Arduino" is your sketchbook directory):
Arduino/hardware/pololu/avr/README.md
Here are some details about what Arduino features work when programming the A-Star 328PB in the Arduino IDE:
Serial and Serial1 objects both work, providing access to UART0 and
UART1, respectively.pinMode(), digitalRead(), and digitalWrite() should work on every I/O
pin.analogRead() should work on every analog pin (A0 through A7).analogWrite() should work on every pin with PWM.The ATmega328PB has two new pins, PE0 and PE1, that have no equivalent on the
ATmega328P. These pins do not yet have official pin numbers in the Arduino
environment, so if you need to use their pin numbers in your code, we recommend
using the constants SDA1 (for PE0) and SCL1 (for PE1) that are defined in
our header files. For example:
digitalWrite(SDA1, HIGH);The "bootloader" directory contains the source code and compiled files for the A-Star and Zumo bootloaders. The A-Star 32U4 boards and ATmega32U4-based robots use "caterina", while the A-Star 328PB boards use "optiboot".
The "drivers" directory contains the A-Star 32U4 drivers for Microsoft Windows. To install the drivers, right-click on "a-star.inf" and select "Install".
The "udev-rules" directory contains a file named "a-star.rules" for Linux users. If you copy this file to /etc/udev/rules.d/, it will tell ModemManager to not try to access the virtual serial ports of the A-Star 32U4 and ATmega32U4-based robots. This is necessary on some systems in order to program these devices.
If you are programming an A-Star 32U4 or ATmega32U4-based robot with the Arduino environment, you might also want to install the applicable Arduino libraries, which are available in separate repositories: