pololu / a-star

Pololu A-Star software and drivers
Other
57 stars 27 forks source link

Pololu A-Star Software and Drivers

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.

Arduino IDE integration

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).

  1. In the Arduino IDE, open the File menu (Windows/Linux) or the Arduino menu (macOS) and select "Preferences".

  2. 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.

  3. Click the "OK" button to close the Preferences dialog.

  4. In the Tools > Board menu, select "Boards Manager..." (at the top of the menu).

  5. In the Boards Manager dialog, search for "Pololu A-Star Boards".

  6. 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.

Manual installation

To manually add A-Star and robot support to the Arduino IDE, follow these steps.

  1. Download the latest release archive from GitHub and decompress it.

  2. Rename the directory "a-star-xxxx" (which includes this README, platform.txt, boards.txt, and other files) to "avr".

  3. Locate your Arduino sketchbook directory. You can view your sketchbook location by opening the File menu and selecting Preferences in the Arduino IDE.

  4. Inside the Arduino sketchbook folder, add a folder named "hardware" if it does not already exist.

  5. Inside the "hardware" folder, add a folder named "pololu" if it does not already exist.

  6. Move the "avr" folder into the "pololu" folder.

  7. Restart the Arduino IDE.

  8. 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

ATmega328PB support in the Arduino IDE

Here are some details about what Arduino features work when programming the A-Star 328PB in the Arduino IDE:

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);

Bootloader

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".

Drivers

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".

udev rules

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.

Library support

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:

Version history