Skip to content

Commit dbdea3f

Browse files
committed
added readme
1 parent de1dfa8 commit dbdea3f

File tree

4 files changed

+54
-4013
lines changed

4 files changed

+54
-4013
lines changed

README.md

+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# Demo Project: ESP-32 tm1637 driven LED library for the ESP-IDF
2+
3+
## Introduction
4+
5+
This is a demo project for a library to control LCD1602 / LCD 2004 display with 12c using the ESP-32 IDF toolchain [ESP-IDF](https://github.com/espressif/esp-idf).
6+
7+
Please note that this is actually a demo project. The library is in the components folder.
8+
9+
![Image](images/20240911_161136_scale2.jpg "icon")
10+
11+
## Features
12+
13+
* Display numbers
14+
* Scrolling text
15+
* Simplified interface
16+
* C++ Implementation
17+
18+
19+
## Software required
20+
21+
esp-idf v5.3 or later.
22+
23+
# Installation
24+
25+
26+
```Shell
27+
git clone https://github.com/cfrankb/esp32-lcd1602_2004-cpp
28+
cd esp32-lcd1602_2004-cpp/
29+
idf.py set-target {esp32/esp32s2/esp32s3/esp32c3}
30+
idf.py menuconfig
31+
idf.py flash
32+
```
33+
34+
## Suggested wiring for the LCD1602/2004 LCD display
35+
36+
| LCD1602/2004 | wirecolor | GPIO Pin |
37+
| -------- | --------- | ---------- |
38+
| SDA | blue | 21 |
39+
| SCL | green | 22 |
40+
| GRN | black | GRN |
41+
| VCC | red | 5v * |
42+
43+
* most models use 5v. There are some variants that operate on 3.3v. Check documentation before proceeding.
44+
45+
## Tested hardware
46+
47+
TBA
48+
49+
50+
## Source Code
51+
52+
The source is available from [GitHub cfrankb/esp32-tm1637plus-cpp](https://github.com/cfrankb/esp32-lcd1602_2004-cpp).
53+
54+

images/20240911_161136_scale2.jpg

290 KB
Loading

0 commit comments

Comments
 (0)