CircuitPython Setup

CircuitPython Installation of DisplayIO SSD1305 Library

To use the SSD1305 OLED with your Adafruit CircuitPython board you'll need to install the Adafruit CircuitPython DisplayIO SSD1305 module on your board.

First make sure you are running the latest version 5.0 or later of Adafruit CircuitPython for your board.

Next you'll need to install the necessary libraries to use the hardware--carefully follow the steps to find and install these libraries from Adafruit's CircuitPython library bundle.  Our CircuitPython starter guide has a great page on how to install the library bundle.

If you choose, you can manually install the libraries individually on your board:

  • adafruit_displayio_ssd1305

Before continuing make sure your board's lib folder or root filesystem has the adafruit_displayio_ssd1305.mpy file copied over.

Next connect to the board's serial REPL so you are at the CircuitPython >>> prompt.

Code Example Additional Libraries

For the Code Example, you will need an additional library. We decided to make use of a library so the code didn't get overly complicated.

Go ahead and install this in the same manner as the driver library by copying the adafruit_display_text folder over to the lib folder on your CircuitPython device.

This guide was first published on Nov 04, 2015. It was last updated on Nov 04, 2015. This page (CircuitPython Setup) was last updated on Jan 25, 2020.