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.
  • 권tage 호환성: 온보드 볼륨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.3V / 5V
디스플레이 패널 OLED
통신 인터페이스 4-wire SPI / I2C
운전사 SSD1309
해결 128 × 64 픽셀
픽셀 크기 0.25×0.25mm
디스플레이 크기 35.05×17.52mm
모듈 크기 43.00×37.50mm
패키지 크기 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 데이터/명령 선택 (데이터는 높게, 명령은 낮게 설정)
뉴스 재설정, 낮은 활성
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. 유지관리

  • 손질: 디스플레이 표면이나 전자 부품에 손이 닿지 않도록 모듈의 가장자리를 잡고 다루십시오.
  • 청소: 필요한 경우, 부드럽고 보풀 없는 천으로 디스플레이 표면을 살살 닦아주세요. 연마성 재질이나 강한 화학 약품은 사용하지 마십시오.
  • 저장: 모듈을 직사광선과 극한 온도 변화를 피해 건조하고 정전기 방지 환경에 보관하십시오.
  • 전원 공급 장치: 항상 전원 공급 장치의 볼륨을 확인하십시오.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.
  • 깨지거나 잘못된 표시:
    • 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.13인치 e-Paper HAT(B) 사용 설명서 및 기술 가이드
Raspberry Pi, Arduino, Jetson Nano 및 STM32에 대한 하드웨어 연결, 소프트웨어 설정, 프로그래밍 원리 및 문제 해결을 다루는 Waveshare 2.13인치 e-Paper HAT(B)에 대한 포괄적인 가이드입니다.
사전view 0.91인치 OLED 모듈 사용자 설명서 - 웨이브쉐어
Waveshare 0.91인치 OLED 모듈(128x32 픽셀) 및 SSD1306 컨트롤러 사용 설명서.viewSTM32, 라즈베리 파이(BCM2835, WiringPi, Python) 및 아두이노용 기능, 핀 배치, I2C 통신 및 데모 코드.
사전view Waveshare 2.66인치 e-Paper 모듈 사용 설명서
Waveshare 2.66인치 e-Paper 모듈에 대한 종합적인 사용자 가이드입니다. 이 가이드에는 기능, 사양, SPI 타이밍, 작동 프로토콜, 주의 사항, Raspberry Pi, Jetson Nano, STM32 및 Arduino 플랫폼과의 통합 가이드(API 설명 및 FAQ 포함)가 자세히 설명되어 있습니다.
사전view Waveshare 7.5인치 E-Paper HAT 사용 설명서 및 가이드
이 포괄적인 사용자 설명서는 마이크로캡슐화 전기영동 디스플레이(Microencapsulated Electrophoretic Display) 기술을 활용한 800x480 해상도 디스플레이 모듈인 Waveshare 7.5인치 E-Paper HAT(V1/V2)에 대한 자세한 정보를 제공합니다. 하드웨어 연결, SPI 통신, 작동 원리, 그리고 Raspberry Pi, Arduino, Jetson Nano, Sunrise X3 Pi, STM32, ESP32, ESP8266과의 통합에 대한 내용을 다룹니다. 최적의 사용을 위한 필수 주의 사항, 자료, FAQ가 포함되어 있습니다.
사전view MLX90640-D110 열화상 카메라 모듈 - 데이터시트, 사양 및 가이드
Waveshare MLX90640-D110 32x24 IR 열화상 카메라 모듈의 자세한 기술 사양, 기능 및 사용 설명서입니다. I2C 인터페이스 세부 정보, Raspberry Pi, STM32, ESP32 하드웨어 연결 및 FAQ가 포함되어 있습니다.
사전view 0.96인치 OLED 사용자 설명서 - 웨이브쉐어
Waveshare 0.96인치 OLED 디스플레이 모듈(SSD1306)에 대한 종합적인 사용자 설명서입니다. SPI/I2C 인터페이스, 하드웨어/소프트웨어 설정, 임베디드 프로젝트에 필요한 주요 매개변수 등을 다룹니다.