Adafruit OLED FeatherWing

Transcription

1 Adafruit OLED FeatherWing Created by lady ada Last updated on :52:24 AM UTC

2 Guide Contents Guide Contents Overview Pinouts Power Pins I2C Data Pins Optional Buttons Reset Button Assembly Prepare the header strip: Add the FeatherWing: And Solder! Arduino Code Install Adafruit SSD1306 Library Install Adafruit GFX Run Example Code Do more! FeatherOLED Library Downloading the Library Adafruit_FeatherOLED Base Class void init ( void ) void setbattery ( float vbat ) void setbatteryvisible ( bool enable ) void setbatteryicon ( bool enable ) void clearmsgarea ( void ) Adafruit_FeatherOLED_WiFi void setconnected ( bool conn ) void setconnectedvisible ( bool enable ) void setrssi ( int rssi ) void setrssivisible ( bool enable ) void setipaddress ( uint32_t addr ) void setipaddressvisible ( bool enable ) void refreshicons ( void ) Adafruit_FeatherOLED_WiFi Example CircuitPython Adafruit CircuitPython Module Install Bundle Install Usage I2C Initialization 128 x 64 size OLEDs (or changing the I2C address) Adding hardware reset pin SPI Initialization Drawing Download Schematics Adafruit Industries Page 2 of 36

3 Fabrication Print 35 Adafruit Industries Page 3 of 36

4 Overview A Feather board without ambition is a Feather board without FeatherWings! This is the FeatherWing OLED: it adds a 128x32 monochrome OLED plus 3 user buttons to any Feather main board. Using our Feather Stacking Headers ( or Feather Female Headers ( you can connect a FeatherWing on top of your Feather board and let the board take flight! Adafruit Industries Page 4 of 36

5 These displays are small, only about 1" diagonal, but very readable due to the high contrast of an OLED display. This screen is made of 128x32 individual white OLED pixels and because the display makes its own light, no backlight is required. This reduces the power required to run the OLED and is why the display has such high contrast; we really like this miniature display for its crispness! We also toss on a reset button and three mini tactile buttons called A B and C so you can add a mini user interface to your feather. Tested works with all of our Feather boards. The OLED uses only the two I2C pins on the Feather, and you can pretty much stack it with any other FeatherWing, even ones that use I2C since that is a shared bus. Adafruit Industries Page 5 of 36

6 Adafruit Industries Page 6 of 36

7 Pinouts The OLED FeatherWing plugs into any Feather and adds a cute little display. To make it as cross-platform compatible as possible, we use only I2C to control the display. This is not as fast as SPI but it uses only two pins, can share the I2C bus and is fine for the small 128x32 pixel OLED. Power Pins OLED displays do not have a backlight, and are fairly low power, this display will draw about 10mA when in use. The display uses 3V power and logic so we just connect to the 3V and GND pins from the feather, as indicated above. I2C Data Pins Adafruit Industries Page 7 of 36

8 The cute little OLED does all of the data transfer over the I2C pins, highlighed above SDA and SCL. No other pins are required. There are two 2.2K pullups to 3V on each. These pins can be shared with other I2C devices. The I2C address is 0x3C and cannot be changed Optional Buttons We had a little bit of space so we added three mini tactile buttons that you can use for user interface. We label them A B and C because each Feather has slightly different pin numbering schemes and we wanted to make it 'universal' If you're using ATmega328P, Atmega32u4, ATSAMD51 M4 or ATSAMD21 M0 Feather Button A is #9 (note this is also used for the battery voltage divider so if you want to use both make sure you disable the pullup when you analog read, then turn on the pullup for button reads) Button B is #6 Button C is #5 If you're using ESP8266: Adafruit Industries Page 8 of 36

9 Button A is #0 Button B is #16 Button C is #2 If you're using WICED/STM32 Feather Button A is #PA15 Button B is #PC7 Button C is #PC5 Button B has a 100K pullup on it so it will work with the ESP8266 (which does not have an internal pullup available on that pin). You will need to set up a pullup on all other pins for the buttons to work. Reset Button Sometimes its nice to be able to restart your program, so we also have a reset button. It is tied to the RST pin marked above. Adafruit Industries Page 9 of 36

10 Assembly Prepare the header strip: Cut the strip to length if necessary. It will be easier to solder if you insert it into a breadboard - long pins down Add the FeatherWing: Place the featherwing over the pins so that the short pins poke through the two rows of breakout pads Adafruit Industries Page 10 of 36

11 And Solder! Be sure to solder all pins for reliable electrical contact. (For tips on soldering, be sure to check out our Guide to Excellent Soldering ( Start by soldering the first row of header Now flip around and solder the other row completely Adafruit Industries Page 11 of 36

12 Adafruit Industries Page 12 of 36

13 You're done with the two header strips. Check your solder joints visually and continue onto the next steps OK You're done! You can now plug your FeatherWing into your Feather and get your OLED on! Adafruit Industries Page 13 of 36

14 Adafruit Industries Page 14 of 36

15 Arduino Code The OLED display we use is well supported and works for all Feathers, all you need is a little library support and you will be drawing in no time! Install Adafruit SSD1306 Library Start by installing the support library for the OLED display, you'll need it to talk to the OLED controller chip. We have the Adafruit SSD1306 library repository on GitHub ( if you're interested in looking at the code. Start by downloading the library. You can do that by visiting the github repo and manually downloading or, easier, just click this button to download the zip: Rename the uncompressed folder Adafruit_SSD1306 and check that the Adafruit_SSD1306 folder contains Adafruit_SSD1306.cpp and Adafruit_SSD1306.h Place the Adafruit_SSD1306 library folder your arduinosketchfolder/libraries/ folder. You may need to create the libraries subfolder if its your first library. Restart the IDE.We also have a great tutorial on Arduino library installation at: ( Install Adafruit GFX You will need to do the same for the Adafurit_GFX library available here ( Rename the uncompressed folder Adafruit_GFX and check that the Adafruit_GFX folder contains Adafruit_GFX.cpp and Adafruit_GFX.h Place the Adafruit_GFX library folder your arduinosketchfolder/libraries/ folder like you did with the SSD1306 library Adafruit Industries Page 15 of 36

16 Run Example Code We have a basic demo that works with all Feathers, so restart the IDE and compile/upload this sketch #include <SPI.h> #include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> Adafruit_SSD1306 display = Adafruit_SSD1306(); #if defined(esp8266) #define BUTTON_A 0 #define BUTTON_B 16 #define BUTTON_C 2 #define LED 0 #elif defined(esp32) #define BUTTON_A 15 #define BUTTON_B 32 #define BUTTON_C 14 #define LED 13 #elif defined(arduino_stm32f2_feather) #define BUTTON_A PA15 #define BUTTON_B PC7 #define BUTTON_C PC5 #define LED PB5 #elif defined(teensyduino) #define BUTTON_A 4 #define BUTTON_B 3 #define BUTTON_C 8 #define LED 13 #elif defined(arduino_feather52) #define BUTTON_A 31 #define BUTTON_B 30 #define BUTTON_C 27 #define LED 17 #else // 32u4, M0, M4, and 328p #define BUTTON_A 9 #define BUTTON_B 6 #define BUTTON_C 5 #define LED 13 #endif #if (SSD1306_LCDHEIGHT!= 32) #error("height incorrect, please fix Adafruit_SSD1306.h!"); #endif void setup() Serial.begin(9600); Serial.println("OLED FeatherWing test"); // by default, we'll generate the high voltage from the 3.3v line internally! (neat!) display.begin(ssd1306_switchcapvcc, 0x3C); // initialize with the I2C addr 0x3C (for the 128x32) // init done Serial.println("OLED begun"); // Show image buffer on the display hardware. // Since the buffer is intialized with an Adafruit splashscreen // internally, this will display the splashscreen. Adafruit Industries Page 16 of 36

17 // internally, this will display the splashscreen. display.display(); delay(1000); // Clear the buffer. display.cleardisplay(); display.display(); Serial.println("IO test"); pinmode(button_a, INPUT_PULLUP); pinmode(button_b, INPUT_PULLUP); pinmode(button_c, INPUT_PULLUP); // text display tests display.settextsize(1); display.settextcolor(white); display.setcursor(0,0); display.print("connecting to SSID\n'adafruit':"); display.print("connected!"); display.println("ip: "); display.println("sending val #0"); display.setcursor(0,0); display.display(); // actually display all of the above void loop() if (! digitalread(button_a)) display.print("a"); if (! digitalread(button_b)) display.print("b"); if (! digitalread(button_c)) display.print("c"); delay(10); yield(); display.display(); You should see the OLED display a splash screen then spit out some text. If you press the A B or C buttons it will also print those out Adafruit Industries Page 17 of 36

18 Do more! You can use any of the Adafruit GFX library commands to draw onto your OLED, that means that you get all sorts of shapes, fonts, lines, etc available. Check out GFX for all the underlying graphics support functions and how they work ( Dont forget you have to call display() after drawing to push the buffer out to the display! Adafruit Industries Page 18 of 36

19 FeatherOLED Library To make it easier to work with the OLED FeatherWing with specific Feather boards we've published an optional BETA library called Adafruit_FeatherOLED ( The library consists of a base class called Adafruit_FeatherOLED which breaks the 128x32 displays in four rows of eight pixels each, and you can extend the base class with your own OLED implementation to render custom icons, etc. The top and bottom eight pixels are reserved for status icons and data rendered by the helper class, and the middle 16 pixels can be used to display custom messages or data. Downloading the Library You can download the latest version of the library by clicking on the following link, and then unzipping this file in your Arduino/libraries folder as Arduino/libraries/Adafruit_FeatherOLED : Adafruit_FeatherOLED Base Class The Adafruit_FeatherOLED class exposes the following functions that will be available in every specialised instance of this library: void init ( void ) Initialises the OLED display, clearing it's contents and configuring the low level hardware. This function must be called before any other actions takes place with this library. void setbattery ( float vbat ) Sets the battery level in volts using a floating point value. For example:.setbattery(4.27f). void setbatteryvisible ( bool enable ) Enables or disables the battery display on the OLED. Setting ' true ' in this function will cause the battery icon to be visible, otherwise set it to ' false ' to disable the icon. void setbatteryicon ( bool enable ) Setting this to ' true ' will cause an icon to be displayed for the battery level. Setting this to ' false ' will cause the raw voltage level to be displayed as a text string. void clearmsgarea ( void ) Calling this function will clear the middle 128x16 pixels message area on the OLED display. Adafruit_FeatherOLED_WiFi Adafruit Industries Page 19 of 36

20 This sub-class is designed to display basic WiFi details like your IP address, connection status and the RSSI level for your connection. It can be used with boards like the Adafruit WICED Feather ( which includes a sample sketch ( for this class in the default example folder. void setconnected ( bool conn ) Sets the 'connected' status to either true or false, which will cause the appropriate icon to be updated on the bottom 8 pixel status bar. void setconnectedvisible ( bool enable ) Enables or disables the connected icon in the bottom 8 pixel status bar. Setting this to ' true ' enables the connected icon. void setrssi ( int rssi ) Sets the RSSI level for the connection, which is a value describing the relative signal strength in dbm between two connected wireless devices. This is a negative integer value where the smaller the number the better the signal strength (meaning -90dBm is much weaker than -65dBm). void setrssivisible ( bool enable ) Enables or disables the RSSI icon in the top 8 pixel status bar. Setting this to ' true ' enables the RSSI icon. void setipaddress ( uint32_t addr ) Sets the IP address for the device, which will be displayed in the bottom 8 pixel status bar of the OLED display. A single 32-bit integer is sent to this function, where each 8-bit component of the 4 byte IP address is seperated and printed out. void setipaddressvisible ( bool enable ) Enables or disables the IP address in the bottom 8 pixel status bar. Setting this to ' true ' enables the IP address. void refreshicons ( void ) Calling this function will redraw all of the status icons, and should be called if you have made any changes to the values using the helper functions like.setrssi,.setipaddress, etc. Adafruit_FeatherOLED_WiFi Example The following example shows how the WiFi helper class can be used with the Adafruit WICED Feather ( to display basic information about the connection as well as custom messages. It should give you the following output, and any connection errors will be displayed in the central message area: Adafruit Industries Page 20 of 36

21 This demo assumes you also have Adafruit_Sensor ( Adafruit_MQTT ( and Adafruit_IO ( libraries installed #include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> #include <Adafruit_FeatherOLED.h> #include <Adafruit_FeatherOLED_WiFi.h> #include <Adafruit_Sensor.h> #include <adafruit_feather.h> #include <adafruit_mqtt.h> #include <adafruit_aio.h> #define WLAN_SSID #define WLAN_PASS "SSID" "PASSWORD" #define VBAT_ENABLED 1 #define VBAT_PIN PA1 #define SENSOR_TSL2561_ENABLED 0 #if SENSOR_TSL2561_ENABLED #include <Adafruit_TSL2561_U.h> bool _tslfound = false; Adafruit_TSL2561_Unified tsl = Adafruit_TSL2561_Unified(TSL2561_ADDR_FLOAT, 12345); #endif #define AIO_ENABLED 0 #define AIO_USERNAME "...your AIO username (see #define AIO_KEY "...your AIO key..." #define FEED_VBAT #define FEED_TSL2561_LUX "vbat" "lux" AdafruitAIO AdafruitAIOFeedGauge<float> AdafruitAIOFeedGauge<float> aio(aio_username, AIO_KEY); feedvbat(&aio, FEED_VBAT); feedlux (&aio, FEED_TSL2561_LUX); Adafruit_FeatherOLED_WiFi oled = Adafruit_FeatherOLED_WiFi(); /**************************************************************************/ Connect to the Error code */ /**************************************************************************/ bool connectap() oled.refreshicons(); Adafruit Industries Page 21 of 36

22 oled.clearmsgarea(); oled.println("connecting to..."); oled.println(wlan_ssid); oled.display(); // Attempt to connect to the AP if ( Feather.connect(WLAN_SSID, WLAN_PASS) ) int8_t rssi = Feather.RSSI(); uint32_t ipaddress = Feather.localIP(); oled.setconnected(true); oled.setrssi(rssi); oled.setipaddress(ipaddress); oled.refreshicons(); oled.clearmsgarea(); else // Display the error message err_t err = Feather.errno(); oled.setconnected(false); oled.refreshicons(); oled.clearmsgarea(); oled.println("connection Error:"); switch (err) case ERROR_WWD_ACCESS_POINT_NOT_FOUND: // SSID wasn't found when scanning for APs oled.println("invalid SSID"); break; case ERROR_WWD_INVALID_KEY: // Invalid SSID passkey oled.println("invalid Password"); break; default: // The most likely cause of errors at this point is that // you are just out of the device/ap operating range oled.print(feather.errno()); oled.print(":"); oled.println(feather.errstr()); oled.refreshicons(); // Refresh icons in case the text ran over break; oled.display(); // Return false to indicate that we received an error (available in feather.errno) return false; return true; /**************************************************************************/ */ /**************************************************************************/ void updatevbat() int vbatadc = 0; // The raw ADC value off the voltage div float vbatfloat = 0.0F; // The ADC equivalent in millivolts Adafruit Industries Page 22 of 36

23 float vbatfloat = 0.0F; // The ADC equivalent in millivolts float vbatlsb = F; // mv per LSB // Read the analog in value: vbatadc = analogread(vbat_pin); vbatadc = analogread(vbat_pin); // Multiply the ADC by mv per LSB, and then // double the output to compensate for the // 10K+10K voltage divider vbatfloat = ((float)vbatadc * vbatlsb) * 2.0F; oled.setbattery(vbatfloat/1000); // Push VBAT out to MQTT if possible if (AIO_ENABLED && aio.connected()) feedvbat = vbatfloat/1000; /**************************************************************************/ The setup function runs once when the board comes out of reset */ /**************************************************************************/ void setup() // Wait for Serial Monitor // while(!serial) delay(1); // Setup the LED pin pinmode(board_led_pin, OUTPUT); // Setup the OLED display oled.init(); oled.cleardisplay(); // Initialize tsl sensor if enabled #if SENSOR_TSL2561_ENABLED if (tsl.begin()) _tslfound = true; tsl.enableautorange(true); tsl.setintegrationtime(tsl2561_integrationtime_13ms); /* fast but low resolution */ // tsl.setintegrationtime(tsl2561_integrationtime_101ms); /* medium resolution and speed */ // tsl.setintegrationtime(tsl2561_integrationtime_402ms); /* 16-bit data but slowest conversions */ #endif // Get a VBAT reading before refreshing if VBAT is available #if VBAT_ENABLED pinmode(vbat_pin, INPUT_ANALOG); oled.setbatteryicon(true); updatevbat(); #endif // Refresh the screen oled.refreshicons(); oled.clearmsgarea(); Adafruit Industries Page 23 of 36

24 // Try to connect to the AP if (!connectap() ) // Enter a while(1) loop here since any connection error // is handled in.connectap() above while(1); #if AIO_ENABLED // Attempt to connect to a Broker oled.clearmsgarea(); oled.println("io.adafruit.com"); oled.display(); // Connect to AIO server if ( aio.connect() ) oled.println("connected!"); oled.display(); else oled.print("failed! Error: "); oled.println(aio.errno(), HEX); oled.display(); delay(3000); // Follow feed if enabled if ( VBAT_ENABLED ) feedvbat.follow(aio_vbat_callback); // Follow feed if enabled if ( SENSOR_TSL2561_ENABLED ) feedlux.follow(aio_vbat_callback); #endif /**************************************************************************/ This loop function runs over and over again */ /**************************************************************************/ void loop() // Update the battery level if ( VBAT_ENABLED ) updatevbat(); if ( Feather.connected() ) // Update the RSSI value int8_t rssi = Feather.RSSI(); oled.setrssi(rssi); // Get a light sample and publish to MQTT if available #if SENSOR_TSL2561_ENABLED if (_tslfound) Adafruit Industries Page 24 of 36

25 oled.clearmsgarea(); sensors_event_t event; // Get a new data sample bool sensor_data = tsl.getevent(&event); if (sensor_data) if (AIO_ENABLED && aio.connected()) feedlux = event.light; oled.clearmsgarea(); oled.print("lux -> AIO: "); oled.println(event.light); oled.display(); else oled.clearmsgarea(); oled.println("sensor failed"); oled.display(); Serial.println("Sensor failed"); #endif else // The connection was lost... reset the status icons oled.setconnected(false); oled.setrssi(0); oled.setipaddress(0); oled.clearmsgarea(); oled.refreshicons(); togglepin(board_led_pin); delay(10000); /**************************************************************************/ AIO callback when there is new value with Feed VBAT */ /**************************************************************************/ void aio_vbat_callback(float value) // oled.println("aio VBAT: "); // oled.display(); /**************************************************************************/ AIO callback when there is new value with Feed LUX */ /**************************************************************************/ void aio_lux_callback(float value) // oled.println("aio LUX:"); Adafruit Industries Page 25 of 36

26 // oled.display(); Adafruit Industries Page 26 of 36

27 CircuitPython Adafruit CircuitPython Module Install To use the SSD1306 with your Adafruit CircuitPython board you'll need to install the Adafruit_CircuitPython_SSD1306 ( module on your board. First make sure you are running the latest version of Adafruit CircuitPython ( for your board. Bundle Install 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 introduction guide has a great page on how to install the library bundle ( for both express and non-express boards. Remember for non-express boards like the, you'll need to manually install the necessary libraries from the bundle: adafruit_ssd1306 adafruit_bus_device adafruit_register If your board supports USB mass storage, like the M0-based boards, then simply drag the files to the board's file system. 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. Furthermore, CircuitPython for smaller M0 boards like the Trinket and Gemma do not have the framebuf module built in to save flash space. So, please download and install the pure Python implementation of framebuf ( and copy it to lib folder of the board as well. You do not need to do this for Express CircuitPython boards (they have enough space for framebuf!) Before continuing make sure your board's lib folder or root filesystem has at least the adafruit_ssd1306, adafruit_bus_device, adafruit_register, and if necessary framebuf folders/modules copied over. Adafruit Industries Page 27 of 36

28 Usage The following section will show how to control the LED backpack from the board's Python prompt / REPL. You'll walk through how to control the LED display and learn how to use the CircuitPython module built for the display. Next connect to the board's serial REPL ( you are at the CircuitPython >>> prompt. I2C Initialization If your display is connected to the board using I2C (like if using a Feather and the FeatherWing OLED) you'll first need to initialize the I2C bus. First import the necessary modules: import board import busio as io Note if you're using the ESP8266 or other boards which do not support hardware I2C you need to import from the bitbangio module instead of busio: import board import bitbangio as io Now for either board run this command to create the I2C instance using the default SCL and SDA pins (which will be marked on the boards pins if using a Feather or similar Adafruit board): i2c = io.i2c(board.scl, board.sda) Adafruit Industries Page 28 of 36

29 After initializing the I2C interface for your firmware as described above you can create an instance of the SSD1306 I2C driver by running: import adafruit_ssd1306 oled = adafruit_ssd1306.ssd1306_i2c(128, 32, i2c) Note that the first two parameters to the SSD1306_I2C class initializer are the width and height of the display in pixels. Be sure to use the right values for the display you're using! 128 x 64 size OLEDs (or changing the I2C address) If you are using a 128x64 display, the I2C address is probably different ( 0x3d ), unless you've changed it by soldering some jumpers: oled = adafruit_ssd1306.ssd1306_i2c(128, 64, i2c, addr=0x3d) Adding hardware reset pin If you have a reset pin (which may be required if your OLED does not have an auto-reset chip like the FeatherWing) also pass in a reset pin like so: from digitalio import DigitalInOut reset_pin = DigitalInOut(board.D5) # any pin! oled = adafruit_ssd1306.ssd1306_i2c(128, 32, i2c, reset=reset_pin) At this point your I2C bus and display are initialized, skip down to the drawing section. SPI Initialization If your display is connected to the board using SPI you'll first need to initialize the SPI bus. Run the following commands: import adafruit_ssd1306 import board import busio from digitalio import DigitalInOut spi = busio.spi(board.clk, MOSI=board.MOSI, MISO=board.MISO) dc_pin = DigitalInOut(board.D5) # any pin! reset_pin = DigitalInOut(board.D6) # any pin! cs_pin = DigitalInOut(board.D9) # any pin! oled = adafruit_ssd1306.ssd1306_spi(128, 32, spi, dc_pin, reset_pin, cs_pin) Note the first two parameters to the SSD1306_SPI class initializer are the width and height of the display in pixels. Be sure to use the right values for the display you're using! The next parameters to the initializer are the pins connected to the display's DC, reset, and CS lines in that order. Adafruit Industries Page 29 of 36

30 Again make sure to use the right pin names as you have wired up to your board! Drawing The SSD1306 module currently supports a basic set of commands to draw on the display. You can set individual pixels, fill the screen, and write lines of text. There aren't yet more advanced functions like line drawing, etc. but check the module GitHub repository ( for future releases which might include more functions. To fill or clear the entire screen use the fill function. This function takes a parameter which specifies the color to fill with, either 0 for black or 1 for white. For example to fill the screen white: oled.fill(1) oled.show() Notice the fill function doesn't actually change the display. You must call show after making drawing commands to send the updated pixel data to the display! To clear the screen to black just call fill again but with the color 0: oled.fill(0) oled.show() Adafruit Industries Page 30 of 36

31 To set a pixel use the pixel function. This function takes the following parameters: Pixel X position Pixel Y position Pixel color (0 = black, 1 = white) For example to set the first pixel white: oled.pixel(0, 0, 1) oled.show() Adafruit Industries Page 31 of 36

32 Try setting other pixels white by changing the X and Y position. Remember you have to call show after setting pixels to see them appear! You can write a line of text with the text function. This function takes the following parameters: String of text Text X position Text Y position Optional text color (0 = black, 1 = white, the default) For example to clear the screen and then write two lines of text: oled.fill(0) oled.text('hello', 0, 0) oled.text('world', 0, 10) oled.show() Note that not all boards support built-in text rendering. In particular the non-express boards like Gemma and Trinket M0 don't have the memory to build in text drawing. You can however on those boards load a separate Python text drawing library to draw text. See the Drawing Text ( guide! Notice the second line of text starts at Y position 10, this moves it down the display 10 pixels so it's below the first line of text. The font used by the text function is 8 pixels tall so a size of 10 gives a bit of room between the lines. Finally you can invert the display colors with the invert function: oled.invert(true) Adafruit Industries Page 32 of 36

33 Note that the invert function doesn't need to have show called after it to see the change. To go back to a non-inverted display run: oled.invert(false) That's all there is to drawing on the SSD1306 OLED display with CircuitPython! The drawing functions are basic but provide building blocks for more advanced usage. For example you can display text with sensor readings or other state, or even program a simple game like pong! You can find more drawing functions for basic shapes and text by following these guides (which work with both CircuitPython and MicroPython): Drawing Shapes ( Adafruit Industries Page 33 of 36

34 Drawing Text ( Adafruit Industries Page 34 of 36

35 Download SSD1306 ( Datasheet OLED UG-2832HSWEG02 Datasheet ( PCB Files in EagleCAD format ( Fritzing object available in the Adafruit Fritzing Library ( Schematics Fabrication Print Dimensions in inches Adafruit Industries Page 35 of 36

36 Adafruit Industries Last Updated: :52:23 AM UTC Page 36 of 36