mirror of
https://github.com/nopnop2002/esp-idf-ssd1306.git
synced 2024-10-03 18:18:47 -04:00
139 lines
4.5 KiB
Markdown
139 lines
4.5 KiB
Markdown
# esp-idf-ssd1306
|
|
SSD1306/SH1106 driver for esp-idf
|
|
|
|
I used [this](https://github.com/yanbe/ssd1306-esp-idf-i2c) repository as a reference.
|
|
I used [this](https://github.com/dhepper/font8x8) font file.
|
|
|
|
# Software requirements
|
|
esp-idf v4.4 or later.
|
|
This is because this version supports ESP32-C3.
|
|
|
|
# Installation for ESP32
|
|
|
|
```
|
|
git clone https://github.com/nopnop2002/esp-idf-ssd1306
|
|
cd esp-idf-ssd1306/
|
|
idf.py set-target esp32
|
|
idf.py menuconfig
|
|
idf.py flash
|
|
```
|
|
|
|
# Installation for ESP32-S2
|
|
|
|
```
|
|
git clone https://github.com/nopnop2002/esp-idf-ssd1306
|
|
cd esp-idf-ssd1306/
|
|
idf.py set-target esp32s2
|
|
idf.py menuconfig
|
|
idf.py flash
|
|
```
|
|
|
|
# Installation for ESP32-C3
|
|
|
|
```
|
|
git clone https://github.com/nopnop2002/esp-idf-ssd1306
|
|
cd esp-idf-ssd1306/
|
|
idf.py set-target esp32c3
|
|
idf.py menuconfig
|
|
idf.py flash
|
|
```
|
|
|
|
__Note__
|
|
For some reason, there are development boards that cannot use GPIO06, GPIO08, GPIO09, GPIO19 for SPI clock pins.
|
|
According to the ESP32C3 specifications, these pins can also be used as SPI clocks.
|
|
I used a raw ESP-C3-13 to verify that these pins could be used as SPI clocks.
|
|
|
|
# Configuration
|
|
You have to set this config value with menuconfig.
|
|
- CONFIG_INTERFACE
|
|
- CONFIG_PANEL
|
|
- CONFIG_OFFSETX
|
|
- CONFIG_FLIP
|
|
- CONFIG_SDA_GPIO
|
|
- CONFIG_SCL_GPIO
|
|
- CONFIG_RESET_GPIO
|
|
- CONFIG_MOSI_GPIO
|
|
- CONFIG_SCLK_GPIO
|
|
- CONFIG_CS_GPIO
|
|
- CONFIG_DC_GPIO
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Generic SSD1306 128x32 i2c
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Generic SSD1306 128x64 i2c
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Generic SH1106 128x64 i2c
|
|
__Hardware scroll Not support__
|
|
Left:1.3 inch SH1106
|
|
Right:0.96 inch SSD1306
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# 128x64 TTGO
|
|
Unlike other ESP32 development boards, the RTC_CLOCK crystal on this board uses a 26MHz one.
|
|
You need to change the RTC CLOCK frequency to 26MHz using menuconfig.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# 128x64 ESP-WROOM-32
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Generic SSD1306 128x32 SPI
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Generic SSD1306 128x64 SPI
|
|
D0 is SCLK.
|
|
D1 is MOSI.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Generic SH1106 128x64 SPI
|
|
__Hardware scroll Not support__
|
|
Left:1.3 inch SH1106
|
|
Right:0.96 inch SSD1306
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
# Flip upside down
|
|
|
|
|
|
|
|
|
|
|