{"id":18463,"date":"2018-03-12T11:40:22","date_gmt":"2018-03-12T10:40:22","guid":{"rendered":"http:\/\/www.recantha.co.uk\/blog\/?p=18463"},"modified":"2018-03-12T15:17:58","modified_gmt":"2018-03-12T14:17:58","slug":"working-with-an-ssd1306-0-96-oled-display-on-the-raspberry-pi","status":"publish","type":"post","link":"https:\/\/www.recantha.co.uk\/blog\/?p=18463","title":{"rendered":"Working with an SSD1306 0.96″ OLED display on the Raspberry Pi"},"content":{"rendered":"

\"\"<\/a><\/p>\n

I’m always on the lookout for cheap electronics on eBay and AliExpress. Following on from my previous tutorial on HD44780 screens, this time, I found a small OLED display.<\/em><\/p>\n

I bought one of these<\/a>\u00a0from eBay for less than \u00a35 plus postage. It is a 0.96″, 128×64 pixel OLED display<\/a>.<\/strong> These things are really tiny, but useful if you’re after something to display status information. They run from the I2C bus<\/a>, this one using address 0x3C. This means that all the other addresses are available for you to use to get I2C sensor readings from or to drive other displays. You can even change the address on these displays to allow you to use multiple of the same device.<\/p>\n

I did a quick Google to find out how to use it with the Raspberry Pi. I used some\u00a0<\/em>of the instructions on\u00a0this page<\/a>\u00a0but found them to be out of date, so I ended up doing things slightly differently.<\/p>\n

First of all, make sure your Pi has some essential packages. Most are pre-installed, but you’ll get updates this way:<\/p>\n

sudo apt-get install build-essential python-dev python-pip python-imaging python-smbus git<\/pre>\n
Then, grab the Adafruit library<\/a> from GitHub:<\/p>\n
git clone https:\/\/github.com\/adafruit\/Adafruit_Python_SSD1306<\/pre>\n
Install the library for python3:<\/p>\n
cd\u00a0Adafruit_Python_SSD1306\r\nsudo python3 setup.py install<\/pre>\n
Now take a look at the examples:<\/p>\n
cd examples\r\npython3 animate.py<\/pre>\n
In the examples, I changed the “disp =” statement to use the line with a 128×64 display running on I2C.<\/p>\n
The example scripts provided by Adafruit are:<\/p>\n
    \n
  • Animated text rolling across the screen.<\/li>\n
  • Representation of some buttons (which is weird because it’s not a touch screen!).<\/li>\n
  • A PPM image translated onto the screen.<\/li>\n
  • Some geometric shapes.<\/li>\n
  • Some stats from the Pi – the IP address, disk & memory usage and CPU load.<\/li>\n<\/ul>\n
    You can see how these scripts work in the video below. Pardon the shaky cam work, I’ve lost my little tripod!<\/em><\/p>\n