waveshare 1.54inch OLED Display Module (SSD1309)

Waveshare 1.54-inch OLED Display Module User Manual

Model: 1.54inch OLED Display Module (SSD1309)

1. สินค้าหมดview

The Waveshare 1.54-inch OLED Display Module is a compact, high-contrast display solution featuring a 128 × 64 pixel resolution. It integrates the SSD1309 driver chip and supports both 4-wire SPI and I2C communication interfaces, offering broad compatibility with various microcontrollers and development boards such as Raspberry Pi, Arduino, STM32, ESP32, and Jetson Nano. This module is designed for embedded applications requiring a clear, efficient visual output.

Waveshare 1.54-inch OLED Display Module showing its features and specifications

ภาพที่ 1.1: จบแล้วview of the 1.54-inch OLED Display Module highlighting its features and specifications.

2. คุณสมบัติหลัก

  • ประเภทจอภาพ: 1.54-inch OLED with 128 × 64 pixel resolution.
  • ชิปไดร์เวอร์: Embedded SSD1309 for efficient display control.
  • อินเทอร์เฟซการสื่อสาร: Supports both 4-wire SPI and I2C for flexible integration.
  • เล่มที่tagความเข้ากันได้: ออนบอร์ดฉบับtage translator ensures compatibility with 3.3V and 5V MCUs.
  • ความเข้ากันได้ในวงกว้าง: Designed for use with Raspberry Pi, Arduino, STM32, ESP32, Jetson Nano, and similar platforms.
  • สีจอแสดงผล: Blue display color.
Waveshare 1.54-inch OLED Display Module with blue display

Image 2.1: The 1.54-inch OLED Display Module with its blue display.

3. ข้อมูลจำเพาะ

พารามิเตอร์ ค่า
ปฏิบัติการฉบับที่tage 3.3โวลต์/5โวลต์
แผงแสดงผล โอแอลอีดี
อินเทอร์เฟซการสื่อสาร 4-wire SPI / I2C
คนขับรถ SSD1309
ปณิธาน 128 × 64 พิกเซล
ขนาดพิกเซล 0.25 × 0.25 มม.
ขนาดจอแสดงผล 35.05 × 17.52 มม.
ขนาดโมดูล 43.00 × 37.50 มม.
ขนาดแพ็คเกจ 1.69 x 1.45 x 0.19 นิ้ว
น้ำหนักสินค้า 0.32 ออนซ์

4. คำอธิบายพินเอาต์

The module features a 7-pin header for power and communication. Understanding each pin's function is crucial for proper integration.

เข็มหมุด คำอธิบาย
วีซีซี Power Input (3.3V / 5V)
ก.ย.ด. พื้นเพาเวอร์
ดิน Data Input (MOSI for SPI, SDA for I2C)
ซีแอลเค Clock Signal Input (SCK for SPI, SCL for I2C)
CS Chip Select, low active (SPI only)
DC Data/Command selection (High for data, Low for command)
ร.ส.ท. รีเซ็ต ใช้งานน้อย
Control Interface of the 1.54-inch OLED Display Module showing pin labels

Image 4.1: Pinout diagram for the OLED Display Module.

5. การตั้งค่าและการเชื่อมต่อ

5.1 แนวทางการเชื่อมต่อทั่วไป

  • Ensure your microcontroller operates at 3.3V or 5V, compatible with the module's voltagอีนักแปล
  • Connect VCC to the power supply (3.3V or 5V) and GND to the ground of your microcontroller.
  • Choose either SPI or I2C communication mode based on your project requirements and microcontroller capabilities.
  • Refer to the specific wiring diagrams for your chosen development board.

5.2 Connecting with Raspberry Pi (SPI Interface)

To connect the OLED module to a Raspberry Pi using the SPI interface, follow the pin connections below. Ensure your Raspberry Pi's SPI interface is enabled.

  • วีซีซี → Raspberry Pi 3.3V/5V
  • ก.ย.ด. → Raspberry Pi GND
  • ดิน → Raspberry Pi MOSI (GPIO 10 / Pin 19)
  • ซีแอลเค → Raspberry Pi SCLK (GPIO 11 / Pin 23)
  • CS → Raspberry Pi CE0 (GPIO 8 / Pin 24)
  • DC → Raspberry Pi GPIO 25 (Pin 22)
  • ร.ส.ท. → Raspberry Pi GPIO 27 (Pin 13)
Wiring diagram for connecting the OLED module to a Raspberry Pi via SPI

Image 5.1: SPI connection diagram for Raspberry Pi.

5.3 Connecting with Arduino Board (SPI Interface)

For Arduino boards, connect the OLED module using the SPI interface as follows:

  • วีซีซี → Arduino 5V
  • ก.ย.ด. → Arduino GND
  • ดิน → Arduino MOSI (Pin 11 for Uno/Nano, Pin 51 for Mega)
  • ซีแอลเค → Arduino SCK (Pin 13 for Uno/Nano, Pin 52 for Mega)
  • CS → Arduino Digital Pin (e.g., Pin 10)
  • DC → Arduino Digital Pin (e.g., Pin 9)
  • ร.ส.ท. → Arduino Digital Pin (e.g., Pin 8)
Wiring diagram for connecting the OLED module to an Arduino board via SPI

Image 5.2: SPI connection diagram for Arduino.

6. คู่มือการใช้งาน

After successful physical connection, the module requires software configuration to display content. Waveshare provides example code and libraries for various platforms.

6.1 การตั้งค่าซอฟต์แวร์

  1. ติดตั้งไลบรารี: Download and install the appropriate SSD1309 OLED display library for your chosen development environment (e.g., Adafruit SSD1306 library for Arduino, or specific Waveshare libraries for Raspberry Pi/Python).
  2. Configure Pins: In your code, define the GPIO pins connected to the OLED module's CS, DC, and RST pins according to your wiring.
  3. เริ่มต้นการแสดงผล: Use the library functions to initialize the SSD1309 driver. This typically involves setting the display resolution and communication protocol (SPI or I2C).
  4. แสดงเนื้อหา: Utilize the library's drawing functions to display text, graphics, or images on the OLED screen. Remember to call a display update function (e.g., display.display()) to push changes to the screen.

6.2 การเลือกโหมดการสื่อสาร

The module supports both SPI and I2C. The default mode is typically SPI. If you intend to use I2C, you may need to adjust onboard jumpers or solder pads, if available, and ensure your software is configured for I2C communication (SDA for DIN, SCL for CLK, and CS/DC/RST might be tied to specific states or not used depending on the library).

7. การบำรุงรักษา

  • การจัดการ: Handle the module by its edges to avoid touching the display surface or electronic components.
  • การทำความสะอาด: If necessary, gently clean the display surface with a soft, lint-free cloth. Avoid abrasive materials or harsh chemicals.
  • พื้นที่จัดเก็บ: Store the module in a dry, anti-static environment, away from direct sunlight and extreme temperatures.
  • แหล่งจ่ายไฟ: ตรวจสอบให้แน่ใจเสมอว่าแรงดันไฟฟ้าของแหล่งจ่ายไฟถูกต้องtage is within the specified 3.3V-5V range to prevent damage.

8 การแก้ไขปัญหา

  • จอแสดงผลไม่สว่างขึ้น:
    • Check power connections (VCC, GND) and ensure correct voltage.
    • Verify all communication pins (DIN, CLK, CS, DC, RST) are correctly wired.
    • Confirm that the display initialization code is running without errors.
    • Ensure the correct communication protocol (SPI/I2C) is selected in both hardware and software.
  • Garbled or Incorrect Display:
    • Check for loose connections or incorrect pin assignments in your code.
    • Ensure the correct display resolution (128x64) is set in the software library.
    • Verify that the correct SSD1309 driver is being used by the library.
  • ไม่มีการสื่อสาร:
    • Double-check all wiring, especially for DIN, CLK, CS, DC, and RST.
    • Ensure the communication interface (SPI or I2C) is enabled on your microcontroller.
    • Test with known working example code provided by Waveshare or the library developer.

9. ขนาดโดยรวม

The physical dimensions of the module are important for integration into custom enclosures or projects.

Diagram showing the outline dimensions of the 1.54-inch OLED Display Module in millimeters

Image 9.1: Outline dimensions of the module (Unit: mm).

10. Online Resources and Support

For detailed development resources, example code, and further technical documentation, please visit the official Waveshare online tutorial page:

Waveshare 1.54inch OLED Module Online Tutorial

This resource provides examples for Raspberry Pi, Arduino, STM32, ESP32, and Jetson Nano, which are essential for getting started with your module.

เอกสารที่เกี่ยวข้อง - 1.54inch OLED Display Module (SSD1309)

พรีview คู่มือผู้ใช้และคู่มือทางเทคนิคสำหรับ Waveshare 2.13inch e-Paper HAT (B)
คู่มือฉบับสมบูรณ์สำหรับ Waveshare 2.13inch e-Paper HAT (B) ครอบคลุมการเชื่อมต่อฮาร์ดแวร์ การตั้งค่าซอฟต์แวร์ หลักการเขียนโปรแกรม และการแก้ไขปัญหาสำหรับ Raspberry Pi, Arduino, Jetson Nano และ STM32
พรีview คู่มือผู้ใช้โมดูล OLED ขนาด 0.91 นิ้ว - Waveshare
คู่มือการใช้งานสำหรับโมดูล OLED ขนาด 0.91 นิ้ว (128x32 พิกเซล) ของ Waveshare พร้อมคอนโทรลเลอร์ SSD1306 ครอบคลุมมากกว่า...viewรวมถึงคุณสมบัติ แผนผังขา การสื่อสาร I2C และโค้ดสาธิตสำหรับ STM32, Raspberry Pi (BCM2835, WiringPi, Python) และ Arduino
พรีview คู่มือการใช้งานโมดูล e-Paper ขนาด 2.66 นิ้วของ Waveshare
คู่มือผู้ใช้ฉบับสมบูรณ์สำหรับโมดูล e-Paper ขนาด 2.66 นิ้วของ Waveshare ซึ่งให้รายละเอียดเกี่ยวกับคุณสมบัติ ข้อมูลจำเพาะ การกำหนดเวลา SPI โปรโตคอลการทำงาน ข้อควรระวัง และคู่มือการรวมเข้ากับแพลตฟอร์ม Raspberry Pi, Jetson Nano, STM32 และ Arduino รวมถึงคำอธิบาย API และคำถามที่พบบ่อย
พรีview คู่มือการใช้งานและคำแนะนำสำหรับ Waveshare 7.5-inch E-Paper HAT
คู่มือผู้ใช้ฉบับนี้ให้ข้อมูลโดยละเอียดเกี่ยวกับ Waveshare 7.5-inch E-Paper HAT (V1/V2) ซึ่งเป็นโมดูลแสดงผลความละเอียด 800x480 พิกเซล ที่ใช้เทคโนโลยี Microencapsulated Electrophoretic Display ครอบคลุมถึงการเชื่อมต่อฮาร์ดแวร์ การสื่อสาร SPI หลักการทำงาน และการบูรณาการกับ Raspberry Pi, Arduino, Jetson Nano, Sunrise X3 Pi, STM32, ESP32 และ ESP8266 นอกจากนี้ยังรวมถึงข้อควรระวังที่สำคัญ แหล่งข้อมูล และคำถามที่พบบ่อย เพื่อการใช้งานอย่างมีประสิทธิภาพสูงสุด
พรีview โมดูลกล้องถ่ายภาพความร้อน MLX90640-D110 - ข้อมูลจำเพาะ ข้อมูลจำเพาะ และคู่มือ
ข้อมูลจำเพาะทางเทคนิค คุณสมบัติ และคู่มือการใช้งานโดยละเอียดสำหรับโมดูลกล้องถ่ายภาพความร้อนอินฟราเรด Waveshare MLX90640-D110 32x24 ประกอบด้วยรายละเอียดอินเทอร์เฟซ I2C การเชื่อมต่อฮาร์ดแวร์สำหรับ Raspberry Pi, STM32, ESP32 และคำถามที่พบบ่อย
พรีview คู่มือผู้ใช้จอ OLED ขนาด 0.96 นิ้ว - Waveshare
คู่มือการใช้งานฉบับสมบูรณ์สำหรับโมดูลจอแสดงผล OLED ขนาด 0.96 นิ้ว (SSD1306) ของ Waveshare ครอบคลุมอินเทอร์เฟซ SPI/I2C การตั้งค่าฮาร์ดแวร์/ซอฟต์แวร์ และพารามิเตอร์สำคัญสำหรับโครงการฝังตัว