Datasheet

CircuitPython

Adafruit CircuitPython Module Install

To use the PCA9685 with your Adafruit CircuitPython board you'll need to install

the Adafruit_CircuitPython_PCA9685 module on your board. Remember this module is for Adafruit CircuitPython

firmware and not MicroPython.org firmware!

First make sure you are running the latest version of Adafruit CircuitPython for your board. Next you'll need to install

the necessary libraries to use the hardware--read below and carefully follow the referenced steps to find and install

these libraries from Adafruit's CircuitPython library bundle with a version 20180110 or newer.

Bundle Install

For express boards that have extra flash storage, like the Feather/Metro M0 express and Circuit Playground express,

you can easily install the necessary libraries with Adafruit's CircuitPython bundle. This is an all-in-one package that

includes the necessary libraries to use the PCA9685 with CircuitPython. To install the bundle follow the steps in your

board's guide, like these steps for the Feather M0 express board.

Remember for non-express boards like the Trinket M0, Gemma M0, and Feather/Metro M0 basic you'll need to

manually install the necessary libraries from the bundle:

adafruit_pca9685

adafruit_bus_device

adafruit_register

adafruit_motor

If your board supports USB mass storage, like the M0-based boards, then simply drag the files to the board's file

system. Note on boards without external SPI flash, like a Feather M0 or Trinket/Gemma M0, you might run into

issues on Mac OSX with hidden files taking up too much space when drag and drop copying, see this page for a

workaround.

If your board doesn't support USB mass storage, like the ESP8266, then use a tool like ampy to copy the file to the

board. You can use the latest version of ampy and its new directory copy command to easily move module directories

to the board.

Before continuing make sure your board's lib folder or root filesystem has the adafruit_pca9685, adafruit_bus_device,

adafruit_register and adafruit_motor folders/modules copied over.

This guide is for version 3.0.0 of the PCA9685 library. Make sure to use a bundle from 20180110 or later.