README.md (3721B)
1 # Adafruit_SSD1306 [](https://github.com/adafruit/Adafruit_SSD1306/actions)[](http://adafruit.github.io/Adafruit_SSD1306/html/index.html) 2 3 This is a library for our Monochrome OLEDs based on SSD1306 drivers 4 5 Pick one up today in the adafruit shop! 6 ------> http://www.adafruit.com/category/63_98 7 8 These displays use I2C or SPI to communicate, 2 to 5 pins are required to interface. 9 10 Adafruit invests time and resources providing this open source code, 11 please support Adafruit and open-source hardware by purchasing 12 products from Adafruit! 13 14 Written by Limor Fried/Ladyada for Adafruit Industries, with contributions from the open source community. Scrolling code contributed by Michael Gregg. Dynamic buffer allocation based on work by Andrew Canaday. 15 BSD license, check license.txt for more information. All text above must be included in any redistribution 16 17 Preferred installation method is to use the Arduino IDE Library Manager. To download the source from Github instead, click "Clone or download" above, then "Download ZIP." After uncompressing, rename the resulting folder Adafruit_SSD1306. Check that the Adafruit_SSD1306 folder contains Adafruit_SSD1306.cpp and Adafruit_SSD1306.h. 18 19 You will also have to install the **Adafruit GFX library** which provides graphics primitves such as lines, circles, text, etc. This also can be found in the Arduino Library Manager, or you can get the source from https://github.com/adafruit/Adafruit-GFX-Library 20 21 ## Changes 22 Pull Request: 23 (September 2019) 24 * new #defines for SSD1306_BLACK, SSD1306_WHITE and SSD1306_INVERSE that match existing #define naming scheme and won't conflict with common color names 25 * old #defines for BLACK, WHITE and INVERSE kept for backwards compat (opt-out with #define NO_ADAFRUIT_SSD1306_COLOR_COMPATIBILITY) 26 27 Version 1.2 (November 2018) introduces some significant changes: 28 29 * Display dimensions are now specified in the constructor...you no longer need to edit the .h file for different screens (though old sketches can continue to work that way). 30 * SPI transactions are used and SPI bitrate can be specified (both require Arduino 1.6 or later). 31 * SPI and Wire (I2C) interfaces other than the defaults are supported. 32 33 <!-- START COMPATIBILITY TABLE --> 34 35 ## Compatibility 36 37 MCU |Tested Works|Doesn't Work|Not Tested|Notes 38 ------------|:----------:|:----------:|:--------:|----- 39 Atmega328 | X | | | 40 Atmega32u4 | X | | | 41 Atmega2560 | X | | | 42 ESP8266 | X | | | Change OLED_RESET to different pin if using default I2C pins D4/D5. 43 ESP32 | X | | | 44 ATSAM3X8E | X | | | 45 ATSAM21D | X | | | 46 Intel Curie | X | | | 47 WICED | X | | | No hardware SPI - bitbang only 48 ATtiny85 | | X | | 49 Particle | X | | | 50 51 * ATmega328 : Arduino UNO, Adafruit Pro Trinket, Adafruit Metro 328, Adafruit Metro Mini 52 * ATmega32u4 : Arduino Leonardo, Arduino Micro, Arduino Yun, Teensy 2.0, Adafruit Flora, Bluefruit Micro 53 * ATmega2560 : Arduino Mega 54 * ESP8266 : Adafruit Huzzah 55 * ATSAM3X8E : Arduino Due 56 * ATSAM21D : Arduino Zero, M0 Pro, Adafruit Metro Express, Feather M0 57 * ATtiny85 : Adafruit Gemma, Arduino Gemma, Adafruit Trinket 58 * Particle: Particle Argon 59 60 <!-- END COMPATIBILITY TABLE -->