https://github.com/fbiego/esp32-lvgl-watchface
The ESP32 LVGL Watchfaces project enables the display of pre-built binary watchfaces on ESP32 microcontrollers using LVGL. Through a Kotlin script, it converts binary watchface files into LVGL-compatible code, simplifying the process.
https://github.com/fbiego/esp32-lvgl-watchface
Last synced: 2 months ago
JSON representation
The ESP32 LVGL Watchfaces project enables the display of pre-built binary watchfaces on ESP32 microcontrollers using LVGL. Through a Kotlin script, it converts binary watchface files into LVGL-compatible code, simplifying the process.
- Host: GitHub
- URL: https://github.com/fbiego/esp32-lvgl-watchface
- Owner: fbiego
- License: mit
- Created: 2024-03-31T14:55:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-13T11:52:56.000Z (9 months ago)
- Last Synced: 2025-03-25T09:47:40.911Z (3 months ago)
- Language: C
- Size: 7.58 MB
- Stars: 31
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP32 LVGL Watchfaces
This project renders pre-built binary watchfaces on ESP32 using LVGL. A Kotlin script is used to transform the binary watchfaces into LVGL code, which is then compiled for the ESP32 display.
## ZSWatch
Create wathfaces for [`ZSWatch`](https://github.com/jakkra/ZSWatch)
- https://github.com/Kampi/esp32-lvgl-watchface
## Video
[`Watchfaces demo`](https://youtu.be/lvRsTp9v6_k)
## Watchfaces
Watchfaces can be obtained from [watch-face-wearfit](https://github.com/fbiego/watch-face-wearfit) or [Chronos Dials](https://chronos.ke/dials). Since this project uses a 240x240 screen, watchfaces of the same resolution are recommended.
#### Preview
| | | |
| -- | -- | -- |
|  |  |  |
|  |  |  |
|  |  |  |
|  |  |  |
## Usage
The Kotlin script [`bin2lvgl.kt`](src/faces/bin2lvgl.kt) has been compiled into `bin2lvgl.jar`.
You can also recompile it with `kotlinc bin2lvgl.kt -include-runtime -d bin2lvgl.jar`.
To convert the watchface, simply run `java -jar bin2lvgl.jar watchface.bin Name`, and LVGL code will be generated into a folder.
On Windows, just drag and drop the bin file to [`convert.bat`](src/faces/convert.bat)
In the `main.cpp`, include the `watchface.h` file.
By default the watchface is not enabled. You need to uncomment the ENABLE_FACE definition
You will need to implement a callback for registering the watchface and events:
```
void onFaceEvent(lv_event_t *e){
}
void registerWatchface_cb(const char *name, const lv_img_dsc_t *preview, lv_obj_t **watchface)
{
// name -> name of the watchface, this is the second parameter passed when converting the watchface to LVGL code
// preview -> the preview image of the watchface
// watchface -> pointer to the root object of the watchface
}
```
After initializing LVGL, initialize the watchface:
```
init_face_watchface(registerWatchface_cb); // need to pass the callback function
lv_disp_load_scr(face_watchface); // load the watchface root object to display it
```
In the loop, use the functions to update the watchface:
```
update_time_watchface(sec, min, hr, md, am, dy, mt, yr, wk);
update_weather_watchface(temp, ic);
update_status_watchface(bat, con);
update_activity_watchface(2735, 357, 345);
update_health_watchface(76, 97);
update_all_watchface(/*..all params */);
update_check_watchface(home, /*..all params */); // this check if the home object and the root object of the watchface are similar
// this is useful if your have multiple watchfaces, only the active one will be updated
```
This project implements using multiple watchfaces using a `face_selector` object. Note that the number of watchfaces you can compile is limited by the target ESP32 flash size.
You will also need a `ui_home` object for multiple watchfaces. Set the active watchface to this object
This project only demonstrates watchfaces that are functional to display time by leveraging the [`ChronosESP32 library`](https://github.com/fbiego/chronos-esp32).
For other advanced features such as notifications and control, check out the [`esp32-c3-mini`](https://github.com/fbiego/esp32-c3-mini) and [`dt78-esp32-firmware`](https://github.com/fbiego/dt78-esp32-firmware) projects.
