You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+17-21Lines changed: 17 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,28 +1,26 @@
1
1
# LVGL project for ESP32
2
2
3
3
This is an ESP32 demo project showcasing LVGL v7 with support for several display controllers and touch controllers.
4
-
The demo application is the demo_widgets project from the [lv_examples](https://github.com/lvgl/lv_examples) repository.
4
+
The demo application is the `lv_demo_widgets` project from the [lv_examples](https://github.com/lvgl/lv_examples) repository.
5
5
6
-
Version of LVGL used: 7.9.
7
-
Version of lv_examples used: 7.9.
6
+
-Version of LVGL used: 7.9.
7
+
-Version of lv_examples used: 7.9.
8
8
9
-
Notes:
10
-
11
-
[Use LVGL in your ESP-IDF project](#Use-LVGL-in-your-ESP-IDF-project)
12
-
13
-
[Use lvgl_esp32_drivers in your project](#Use-lvgl_esp32_drivers-in-your-project)
14
-
15
-
[Platformio support](#Platformio-support)
9
+
#### Table of content
10
+
-[Get started](#get-started)
11
+
-[Use LVGL in your ESP-IDF project](#use-lvgl-in-your-esp-idf-project)
12
+
-[Use lvgl_esp32_drivers in your project](#use-lvgl_esp32_drivers-in-your-project)
13
+
-[Platformio support](#platformio-support)
16
14
17
15
Example demo for TFT displays:
18
16
19
-

17
+

20
18
21
19
Monochrome support:
22
20
23
-

21
+

24
22
25
-
# Display and touch controllers
23
+
##Display and touch controllers
26
24
27
25
The display and touch (indev) controllers are now into it's own repository, you can find it [here](https://github.com/lvgl/lvgl_esp32_drivers).
28
26
To report any issue or add new display or touch (indev) drivers you can do so in the `lvgl_esp32_drivers` repo.
@@ -36,13 +34,13 @@ To report any issue or add new display or touch (indev) drivers you can do so in
36
34
### Note
37
35
38
36
This project tries to be compatible with both the ESP-IDF v3.x and v4.0, but using v4.0 is recommended.
39
-
Instructions assume you are using the v4.x toolchain, otherwise use the make commands, eg instead of running `idf.py menuconfig`, run `make menuconfig`.
37
+
Instructions assume you are using the v4.x toolchain, otherwise use the make commands, e.g. instead of running `idf.py menuconfig`, run `make menuconfig`.
40
38
41
39
### Build and run the demo.
42
40
43
41
1. Clone this project by `git clone --recurse-submodules https://github.com/lvgl/lv_port_esp32.git`, this will pull this repo and its submodules.
44
42
45
-
2. Get into the `lv_port_esp32` directory created.
43
+
2. Get into the created `lv_port_esp32` directory.
46
44
47
45
3. Run `idf.py menuconfig`
48
46
@@ -54,26 +52,24 @@ Instructions assume you are using the v4.x toolchain, otherwise use the make com
54
52
55
53
7. Build the project with `idf.py build`
56
54
57
-
8. If the build don't throw any errors, flash the demo with `idf.py -p (YOUR SERIAL PORT) flash` (with make this is just `make flash` - in 3.x PORT is configured in `menuconfig`)
55
+
8. If the build don't throw any errors, flash the demo with `idf.py -p (YOUR SERIAL PORT) flash` (with `make` this is just `make flash` - in 3.x PORT is configured in `menuconfig`)
58
56
59
57
## Use LVGL in your ESP-IDF project
60
58
61
59
LVGL now includes a Kconfig file which is used to configure most of the LVGL configuration options via menuconfig, so it's not necessary to use a custom `lv_conf.h` file.
62
60
63
61
It is recommended to add LVGL as a submodule in your IDF project's git repo.
64
62
65
-
From your project root directory:
66
-
63
+
From your project's root directory:
67
64
1. Create a directory named `components` (if you don't have one already) with `mkdir -p components`.
68
65
2. Clone the lvgl repository inside the `components` directory with `git submodule add https://github.com/lvgl/lvgl.git components/lvgl`
69
66
3. Run `idf.py menuconfig`, go to `Component config` then `LVGL configuration` to configure LVGL.
70
67
71
68
## Use lvgl_esp32_drivers in your project
72
69
73
-
It is recommended to add lvgl_esp32_drivers as a submodule in your IDF project's git repo.
74
-
75
-
From your project root directory:
70
+
It is recommended to add [lvgl_esp32_drivers](https://github.com/lvgl/lvgl_esp32_drivers) as a submodule in your IDF project's git repo.
76
71
72
+
From your project's root directory:
77
73
1. Create a directory named `components` (if you don't have one already) with `mkdir -p components`.
78
74
2. Clone the lvgl_esp32_drivers repository inside the `components` directory with `git submodule add https://github.com/lvgl/lvgl_esp32_drivers.git components/lvgl_esp32_drivers`
79
75
3. Run `idf.py menuconfig`, go to `Component config` then `LVGL TFT configuration` and `LVGL TFT Display configuration` to configure lvgl_esp32_drivers.
0 commit comments