B4R Library rAdafruitSSD1306 - OLED displays

This is a wrapper for this open source project: https://github.com/adafruit/Adafruit_SSD1306

It depends on rAdafruitGFX library: https://www.b4x.com/android/forum/threads/radafruitgfx.68904/

It allows drawing graphics and text on supported monochrome OLED modules.

I've tested it with an I2C module. You need to pass the I2C address (default is 0x3c) and an available pin (4) in the example.

The GFX field from the SSD object is used for the drawings.

ssd.GFX.DrawCircle(px, py, radius, ssd.BLACK, True)

The drawings will only appear on the module after you call ssd.Display.

There are two examples attached.
The first is a bouncing ball:


The second one, which runs on ESP8266, implements a clock:

 

[Mostez]

Hi Erel,
Would you please give short example how to initialize OLED in SPI mode, specially I don't have CS pin on OLED module

Thanks

 

[Mostez]

Hi,
following your example, I tried to compile code listed, but I got this error message:

#AutoFlushLogs: True
#CheckArrayBounds: True
'set the stack buffer size!
#StackBufferSize: 600

Sub Process_Globals
    Private ssd As AdafruitSSD1305
    Private resPIN As Pin
    Private dcPIN As Pin
    Private csPIN As Pin
End Sub

Private Sub AppStart
    csPIN.Initialize(5, csPIN.MODE_INPUT)
    resPIN.Initialize(6, resPIN.MODE_INPUT)
    dcPIN.Initialize(7, dcPIN.MODE_INPUT)
   
   
    ssd.InitializeHSPI(dcPIN.PinNumber,resPIN.PinNumber,csPIN.PinNumber )
    ssd.ClearDisplay   
    ssd.GFX.SetCursor(0, 0)
    ssd.GFX.ConfigureText(1, ssd.WHITE, False)
    ssd.GFX.DrawText("Hello World")
    ssd.Display
   
End Sub

B4R version: 1.20
Parsing code. (0.00s)
Compiling code. (0.01s)
Building project (0.02s)
Compiling & deploying Ino project (Arduino Leonardo - COM26) Error

Adafruit_SSD1306.cpp:33:18: fatal error: Wire.h: No such file or directory
#include <Wire.h>
^
compilation terminated.
Error compiling.

 

[Mostez]

upgraded Java VM and re-installed Arduino IDE, no compiling errors, changed appstart, but still have blank OLED

Private Sub AppStart
    csPIN.Initialize(5, csPIN.MODE_OUTPUT)
    resPIN.Initialize(6, resPIN.MODE_OUTPUT)
    dcPIN.Initialize(7, dcPIN.MODE_OUTPUT)
  
  
    ssd.InitializeHSPI(dcPIN.PinNumber,resPIN.PinNumber,csPIN.PinNumber )
    ssd.ClearDisplay  
    ssd.GFX.SetCursor(0, 0)
    ssd.GFX.ConfigureText(1, ssd.WHITE, False)
    ssd.GFX.DrawText("Hello World")
    ssd.Display
 
End Sub

 

[Erel]

You should download and run the native examples and see whether they work with your module: https://github.com/adafruit/Adafruit_SSD1306

 

[Mostez]

ok, I will try it

 

[Mostez]

I tried this example and worked OK, i made connection as follows:

#define OLED_MOSI 0 'connected to OLED SDA
#define OLED_CLK 1 'connected to OLED SCL
#define OLED_DC 2 'connected to OLED DC
#define OLED_CS 3 'not connected, dont have CS pin
#define OLED_RESET 4 'connected to OLED RST

 

[Mostez]

well, I made some changes to OLED board to change board intrface to IIC, according to this article, it worked very well with bouncing ball example and I wrote 'hello world'. but unfortunately, it worked only when uploading B4R for first time, when re-power Arduino i get blank screen. ps OLED DC pin is connectedto GND

 

[Erel]

Does it work after you reconnect the board?

 

[Mostez]

No, it works only when I upload the code from B4R, if I disconnect USB cable and re-connect it again, it does not work.

 

[Mostez]

got it
RES pin is connected to internally pull-up pin i.e. pin 7, this pin should be initialized in pull-up mode before calling OLED initialize statement. I think it could be possible also to connect RES pin to hard wired 10K pull-up resistor then no need to add pin initialization line.

rs.Initialize(7,rs.MODE_INPUT_PULLUP)
ssd.InitializeI2C(7, 0x3c)

 

[jarda]

Hi,
following your example, I tried to compile code listed, but I got this error message:

In file included from sketch\B4RDefines.h:27:0,
from sketch\AsyncStreams.cpp:1:
rAdafruitSSD1306.h:11: error: 'B4RAdafruitGFX' does not name a type
B4RAdafruitGFX gfx;
^
rAdafruitSSD1306.h:15: error: 'B4RAdafruitGFX' does not name a type
B4RAdafruitGFX* GFX;
^
exit status 1
'B4RAdafruitGFX' does not name a type

 

[Erel]

Have you added a reference to rAdafruitGFX library?

 

[jarda]

Hi

Yes

otherwise not go compile..

Jarek

 

[jarda]

Hi

New Install and compile Ok..

I have this problem.

My HW (ESP Wroom) has otherwise SCL on IO14 and SDA on IO2 pins (not 4, 5) I2C mode.

Can it change?

Jarek

 

[Erel]

The pin numbers are not important. You just need to connect it to the correct pins.

You can use this Arduino IDE project to find the I2C address: http://playground.arduino.cc/Main/I2cScanner

 

[jarda]

Hi

sorry. it's not true...


....

find the I2C address: http://playground.arduino.cc/Main/I2cScanner

appl from : http://playground.arduino.cc/Main/I2cScanner


for(address = 1; address < 127; address++ )

returned

Scanning...
No I2C devices found

Scanning...
No I2C devices found

Scanning...
No I2C devices found

Scanning...
No I2C devices found

Scanning...
No I2C devices found
...........


In Adafruit_SSD1306.CPP is

/*********************************************************************
This is a library for our Monochrome OLEDs based on SSD1306 drivers

Pick one up today in the adafruit shop!
------> http://www.adafruit.com/category/63_98

These displays use SPI to communicate, 4 or 5 pins are required to
interface

Adafruit invests time and resources providing this open source code,
please support Adafruit and open-source hardware by purchasing
products from Adafruit!

Written by Limor Fried/Ladyada for Adafruit Industries.
BSD license, check license.txt for more information
All text above, and the splash screen below must be included in any redistribution


Jarek

 

[Erel]

You need to first find out why the I2C scanner didn't find the connected module.

 

[monki]

Hello,
in the arduino libary there are the functions start scroll left, right, etc
how can I use in B4R?

monki

 

[Erel]

I've updated the library and it now supports scrolling. There was a typo in the previous version. The type name was AdafruitSSD1305 instead of AdafruitSSD1306. This was fixed.

You will need to update your existing projects.