heltec-aaron-lee / heltec0.96oled

Fixed Adafruit library for heltec's 0.96" OLEDs

How to use OLED model in Arduino

Demo with Arduino UNO

0.96 inch use SSD1306 driver chip, it's include I2C or SPI interface, and internal charge-pump.

Step 1: Connect OLED display to Arduino:

• VCC --> 3.3v or 5v
• GND --> GND
• SCL --> A5
• SDA --> A4

Step 2: Install this library

• Copy "Adafruit_SSD1306" and "Adafruit_GFX" this two folder into "X:\Documents\Arduino\libraries".

• In order to reduce the pin number, we use a hardware RESET system. Before init OLED device, delay more than 10ms is must needed.

• The standard library form Adafruit or u8glib may not very suitable for our OLED devices. Make sure you are using our provided libraries(we changed the I2C address and #define SSD1306_128_64 in Adafruit_SSD1306.h). If those files already in you libraries, replace it.

Step 3: Run demo in file "Adafruit_SSD1306\examples" and download into Arduino

Now, if without anyproblem, the OLED will run.

Issue/Bug report template

Before reporting an issue, make sure you've searched for similar one that was already created. Click here.

Summary of common problems

Can't light up the OLED display?

• Please check the follow issue:
• Check the connection between OLED and Arduino;
• Make sure you are using out provided libraries;
• The default I2C/IIC address of the display should be 0x3C. We printed in model is 0x78 or 0x7A, but for AVR or MSP430 series (Arduino based on AVR), the IIC/I2C buffer is 7-bits, so, we should right shift 1-bit while using in Arduino or MSP430.(0x3c = 0X78 >> 1)
• Check the VCC and GND pins is right be connected, never connect VCC to GND and GND to VCC, it will broke model less than a second.
• Wipe the tin Solder part with alcohol.

The dot matrix is 128*32?

We never produced any 0.96 or 1.3 inch with 128*32 dot matrix. Open "Adafruit_SSD1306.h" and make sure the "#define SSD1306_128_64" is available. Like this:

Lack some lines

It caused by glass broken. The glass of OLED is very fragile, please be careful while using it. This problem outside the maintenance.

heltec0.96oled's Issues

invalid zip file

Arduino will not install library

Arduino: 1.8.8 (Windows 10), Board: "Heltec_WIFI_LoRa_32, 80MHz, 115200"

Specified folder/zip file does not contain a valid library

tried other board definition

Arduino: 1.8.8 (Windows 10), Board: "Heltec_WIFI_Kit_32, 80MHz, 115200"

Specified folder/zip file does not contain a valid library

How to upload and draw bitmaps

Hi,
I'm using heltec 0.96" oled with wifi lora board. I'm trying to open an image on it using the Adafruit software.
I noticed that the Heltec logo has 128x53 and has horizontal representation, but it seems its has the columns mixed up.
Is there a datasheet or tutorial to explain how to use your display?

How to connect spi version

incomptiable with wireless stick?

When you try to run the example for the wireless stick lite it gets a warning about pgmspace.h and delay.h not being found. So I disabled those two include as per some suggestions I found off line.

//#include <avr/pgmspace.h> //#include <util/delay.h>

After that I get errors about srandom and random returning "no matching function for call to 'random()'" Any suggestions to get the heltec screens to work on heltec devices would be helpful.

heltec0.96OLED library incompatible with HTIT-E8266 hardware

Hi,
it seems that this library is incompatible with HTIT-E8266 hardware from heltec, I tried using regular ESP8266 tool chain and also installed heltec tool chain. (https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/blob/master/README.md)

• Build for Arduino Uni works fine using this library works ok
• Build for ESP using Adafruit SSD1306 library works ok
• if I try to build for ESP/Wifi_Kit_8 I receive following errors: (removed paths for better readability)

`Build options changed, rebuilding all

./Adafruit_SSD1306.cpp: In member function 'void Adafruit_SSD1306::begin(uint8_t, uint8_t)':
./Adafruit_SSD1306.cpp:160:17: error: cannot convert 'volatile uint32_t* {aka volatile unsigned int*}' to 'volatile uint8_t* {aka volatile unsigned char*}' in assignment
clkport = portOutputRegister(digitalPinToPort(sclk));
^
./Adafruit_SSD1306.cpp:162:17: error: cannot convert 'volatile uint32_t* {aka volatile unsigned int*}' to 'volatile uint8_t* {aka volatile unsigned char*}' in assignment
mosiport = portOutputRegister(digitalPinToPort(sid));
^
./Adafruit_SSD1306.cpp:164:17: error: cannot convert 'volatile uint32_t* {aka volatile unsigned int*}' to 'volatile uint8_t* {aka volatile unsigned char*}' in assignment
csport = portOutputRegister(digitalPinToPort(cs));
^
./Adafruit_SSD1306_heltec/Adafruit_SSD1306.cpp:166:17: error: cannot convert 'volatile uint32_t* {aka volatile unsigned int*}' to 'volatile uint8_t* {aka volatile unsigned char*}' in assignment
dcport = portOutputRegister(digitalPinToPort(dc));
^
./Adafruit_SSD1306.cpp: In member function 'void Adafruit_SSD1306::display()':
./Adafruit_SSD1306.cpp:423:26: error: 'TWBR' was not declared in this scope
uint8_t twbrbackup = TWBR;
^
exit status 1
Error compiling for board WIFI_Kit_8.`