Adapting the code

So how do you get those displays working with the WeatherStation or the PlaneSpotter? The OLED library makes that really easy: you just have to change two lines of code. The include for the SH1106 driver has to be included and then the instantiation. Find the line

#include <SSD1306Wire.h>

and replace it with

#include <SH1106.h>

The next step is to replace the instantiation of the driver:

SSD1306Wire display(I2C_DISPLAY_ADDRESS, SDA_PIN, SDC_PIN);

and replace it with:

SH1106  display(I2C_DISPLAY_ADDRESS, SDA_PIN, SDC_PIN);

Done! Easy, wasn’t it? The OLED library supports other types of displays or communication protocols. You kind out more about them here:
https://github.com/squix78/esp8266-oled-ssd1306

Summary

With changing just a few lines you can get the WeatherStation and the PlaneSpotter working on the bigger 1.3″ screens. The cost a little bit more but depending on your casing they are worth the money. By the way: the pixel density (DPI) is actually worse with the 1.3″ displays since both types have the same resolution of 128×64 pixels. You can find the displays on AliExpress, eBay or on Banggood and support the Blog by following this link.

References

• https://github.com/squix78/esp8266-weather-station
• https://github.com/squix78/esp8266-oled-ssd1306
• 1.3″ OLED display on Banggood
• 0.96″ OLED display on Banggood
• WeatherStation Project Post
• PlaneSpotter Project Post

Fabrice’s video below compares the the two I2C implementations:

Other changes:

• The font format was refactored for better memory efficiency and the web based font generator (http://oleddisplay.squix.ch/) now lets you generate font files for the older library versions or the new ones
• The hardware protocol level implementations (SPI, I2C) have been separated from the low level graphical functions. This affects how you instantiate the display classes
• To be open for future support of similar displays the core classes were renamed to Oled* instead of SSD1306
• More graphical functions have been added, including drawing of circles, non-vertical lines and a progress bar
• In case you want to use the display for simple log output you can now use print(..) and println(..) and the library will take care of scrolling. See Fabrice’s video below:

For a full list of new features and how to upgrade your existing code please have a look at the comprehensive upgrade guide: https://github.com/squix78/esp8266-oled-ssd1306/blob/master/UPGRADE-3.0.md

Please note: this release will break with your code based on the older 2.0.0 version. In case you have created fonts you’ll have to re-generate them as well. This also affects the Weather Station library!

Many thanks again to Fabrice Weinberg and all other contributors to make this release possible!