joy-it SBC-OLED01 0.96 Inch OLED Display Instruction Manual

: July 11, 2024
: JOY-It

Table of Contents

joy-it SBC-OLED01 0.96 Inch OLED Display
Specifications
GENERAL INFORMATION
USAGE WITH ARDUINO
USAGE WITH RASPBERRY PI
Code example
OTHER INFORMATION
SUPPORT
FAQ
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

joy-it SBC-OLED01 0.96 Inch OLED Display

joy-it-SBC-OLED01-0-96-Inch-OLED-Display-prodcut

Specifications

Display: OLED 128×64
Model: SBC-OLED01

GENERAL INFORMATION

Dear customer,
Thank you for purchasing our product. In the following, we will show you which things should be noted during the use.
Should you encounter any unexpected problems, do not hesitate to contact us.

I2C ADRESSE

On the backside of the OLED display is a resistor, with which you can set the I2C address of the display to 0x3D. In the delivery state, the display is accessible via the I2C address 0x3C.
To do change the address, re-solder the resistor marked in the figure.

USAGE WITH ARDUINO

Connection
The SBC-OLED01 has a logic level of 3.3V. Therefore, when using an Arduino Uno, a voltage translator must be used, otherwise it may cause damage to the display. In our example, we use the COM-KY051VT.

joy-it-SBC-OLED01-0-96-Inch-OLED-Display-fig-2

Code example

Before you can transfer the code example to your Arduino using your Arduino IDE, you must first install the additional libraries Adafruit GFX Library (released under the BSD License) and Adafruit_SSD1306 (released under the BSD License) from Adafruit.
These libraries allow you to use the display as easily and quickly as pos-sible. You can search for and install them under Sketch → Include Library → Manage Libraries….
You can download our code examples here. You can upload the code to your Arduino using the Upload button. Make sure that you have selected Port and Board correctly under Tools.

USAGE WITH RASPBERRY PI

Connection

joy-it-SBC-OLED01-0-96-Inch-OLED-Display-fig-3

Installation
First, enable I2C on your Raspberry Pi. To do this, enter the following command into your console.

sudo raspi-config

joy-it-SBC-OLED01-0-96-Inch-OLED-Display-fig-4

Now activate I2C under 3 Interface Options → P5 I2C.
Now, enter the following commands to install the necessary libraries.
Now create the necessary virtual environment for the project with the following commands:
For the display, we use the Adafruit CircuitPython SSD1306 library from Adafruit, which is released under the MIT-License. You can install it with the following command.

Code example

You can download our sample code with the following command.
https://www.joy-it.net/files/files/Produkte/SBC-OLED01/SBC- OLED01_Codeexample_RaspberryPi.zip

Unzip the file with the following command

You can now execute the code with the following command. Please note that the directory may differ.

INFO: This guide was written under Raspberry Pi OS Bookworm for the Raspberry Pi 4 and 5. It has not been checked with other/newer operating systems or hardware.

OTHER INFORMATION

Our information and take-back obligations according to the Electrical and Electronic Equipment Act (ElektroG)

Symbol on electrical and electronic equipment
This crossed-out dustbin means that electrical and electronic appliances do not belong in the household waste. You must return the old appliances to a collection point.
Before handing over waste batteries and accumulators that are not en-closed by waste equipment must be separated from it.

Return options
As an end user, you can return your old device (which essentially fulfills the same function as the new device purchased from us) free of charge for disposal when you purchase a new device.
Small appliances with no external dimensions greater than 25 cm can be disposed of in normal household quantities independently of the purchase of a new appliance.
Possibility of return at our company location during opening hours: SIMAC Electronics GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn, Germany.

Possibility of return in your area
We will send you a parcel stamp with which you can return the device to us free of charge. Please contact us by email at Service@joy-it.net or by telephone.

Information on packaging
If you do not have suitable packaging material or do not wish to use your own, please contact us and we will send you suitable packaging.

SUPPORT

If any questions remain open or problems may arise after your purchase, we are available by e-mail, telephone, and ticket support system to answer these.

E-Mail: service@joy-it.net
Ticket-system: http://support.joy-it.net
Telephone: +49 (0)2845 9360-50 (Mo-Do: 09:00 – 17:00 CET,
Fri: 09:00 – 14:30 CET)

For further information visit our website:www.joy-it.net

Published: 2024.03.22
www.joy-it.net

SIMAC Electronics GmbH Pascalstr. 8, 47506 Neukirchen-Vluyn

FAQ

Q: How can I change the I2C address of the OLED display?
- A: To change the I2C address, locate the resistor on the back of the display and re-sold it as per the instructions provided in the manual.
Q: Where can I find the necessary libraries for using the OLED display with Arduino?
- A: You can download the Adafruit GFX Library and Adafruit_SSD1306 Library from Adafruit’s website or directly install them through your Arduino IDE by navigating to Sketch -> Include Library -> Manage Libraries…
Q: How do I enable I2C on my Raspberry Pi for using the OLED display?
- A: To enable I2C on Raspberry Pi, use the command ‘sudo raspi-config’ in the console, then navigate to Interface Options -> P5 I2C and activate it.