JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual

June 6, 2024
JOY-It

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual

1. 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.

2. INTERFACES

This display can be controlled by different interfaces. It is possible to switch between these interfaces by re-soldering resistors on the back of the display. The display is delivered in 6800 Parallel.

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual - Parallel &
SPI

The components marked in black (marked with X in the table) are Don’t Care components. This means that it does not matter, where these components are set.

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual - Parallel &
SPI

3. USE WITH ARDUINO

3.1. Connection
3.1.1 SPI

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual -
Connection

3.1.2 Parallel

3.1.2.1 4-bit

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual -
Parallel

3.1.2.2 8-bit

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual -
8-bit

3.2. Code example
3.2.1 SPI

For the SPI connection, you can use the library iwi_SPI_RS0010 from iwi1, which is published under the GNU General Public License v3.0 . You can download the library here. You can include the downloaded library in your Arduino IDE by selecting the .zip file under Sketch Include Library Add .ZIP Library… . Select there the downloaded library and restart your Arduino IDE to be able to use this library.

Copy the following code into your IDE to test your display. This will display three different images on your display. To run the code example, click on Upload. Make sure that Board and Port are selected correctly under Tools.

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual - Code
example

3.2.2 Parallel

The display has 6800 and 8080 parallel interfaces. Both interfaces can communicate with 4-bit as well as with 8-bit. For this purpose, we provide the OLED16x2-IST0010-Arduino-Library library. This has been published under the MIT- License.

You can download the library here. You can include the downloaded library in your Arduino IDE by selecting the .zip file under Sketch → Include Library → Add .ZIP Library… . Select there the downloaded library and restart your Arduino IDE to be able to use the library.

There you will find four examples (4-bit 6800, 4-bit 8080, 8-bit 6800, 8-bit 8080). You can find these under File Examples OLED16x2-IST0010-Arduino- Library. Make sure that Board and Port are selected correctly under Tools.

4. USE WITH RASPBERRY PI

4.1 Connection
4.1.1 4bit Parallel 6800

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual - 4bit Parallel
6800

4.1.2 SPI

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual -
SPI

4.2 Code example
4.2.1 4bit Parallel 6800

We use the library luma.oled for this communication type, which was published by rm-hull. It has been published under the MIT-License. However, you must first install the following program to be able to use this library.
sudo apt-get update

sudo apt-get install python3 python3-pip python3-pil libjpeg-dev

zlib1g-dev libfreetype6-dev liblcms2-dev libopenjp2-7 libtiff5 -y

Now, download the library with the following command.

sudo -H pip3 install –upgrade luma.oled

The luma.oled library is now fully functional. You can now create a new file with the following command. Copy the following code into it.

nano luma-ist0010.py

JOY-iT 1656369 OLED LCD Module 16X2 Instruction Manual -
Code
You can save the file with CTRL + O and exit the editor with CTRL + X. With the following command you can now execute the file.

python3 luma-ist0010.py

4.2.2 SPI

We use the library WS0010SoftwareSPI published under the MIT-License by Joy-IT, in combination with Bistring, published under the MIT-License by scott- griffiths, for this communication type. However, you must first install the following programs to be able to use these librarys.

sudo apt-get update

sudo apt-get install python3-pip python3-dev python3-rpi.gpio git -y

pip3 install –upgrade pip

sudo pip3 install bitstring

Now, download the library with the following command.

git clonehttps://github.com/joy-it/WS0010-Software-SPI.git

Next, go to the directory you just added by entering

cd WS0010-Software-SPI/

Now you can execute the file Test.py directly and view it on your OLED display by entering

python3 Test.py

To stop the code just press CTRL + C. If this is successful you can also edit the file as needed by typing

nano Test.py

You can save the file with CTRL + O and exit the editor with CTRL + X. With the following command you can now execute the edited file.

python3 Test.py

5. GENERAL INFORMATION

Our Information and Take-back Obligations according to the Electrical and Electronic Equipment Act (ElektroG)

Symbol on Electrical and Electronic Products:
This crossed-out bin means that electrical and electronic products do not belong into the household waste. You must hand over your old appliance to a registration place. Before you can hand over the old appliance, you must remove used batteries and replacement batteries which are not enclosed by the device.

Return Options:
As the end user, you can hand over your old appliance (which has essentially the same functions as the new one bought with us) free of charge for disposal with the purchase of a new device. Small devices, which do not have outer dimensions bigger than 25 cm can be handed in for disposal independently of the purchase of a new product in normal household quantities.

  1. Possibility of return at our company location during our opening hours
    Simac Electronics Handel GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn

  2. Possibility of return nearby
    We will send you a parcel stamp with which you can send us your old appliance free of charge. For this possibility, please contact us via e-mail at service @joy-it.net or via telephone.

Information about Package:
Please package your old appliance safe for transport. Should you not have suitable packaging material or you do not want to use your own material, you can contact us and we will send you an appropriate package.

6. SUPPORT

If any questions remained 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 98469 ­ 66 (10 – 17 o’clock)

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

Published: 09.04.2021

www.joy-it.net
SIMAC Electronics GmbH
Pascalstr. 8, 47506 Neukirchen-Vluyn

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals