114 lines
5.2 KiB
Markdown
114 lines
5.2 KiB
Markdown
# esp32-c3-mini
|
||
A demo LVGL Watch project for ESP32 C3 mini 240*240 touch display development board. Can also be built natively to test the LVGL UI.
|
||
|
||
## Videos
|
||
- [`C3 UI on 466×466 AMOLED`](https://youtu.be/l3tHc5EIgos)
|
||
- [`LVGL 9 update, Navigation`](https://youtu.be/qGODX6ALO_U)
|
||
- [`ESP32 C3 mini LVGL`](https://youtu.be/u96OkjxC0Ro)
|
||
- [`ESP32 Watchfaces LVGL`](https://youtu.be/lvRsTp9v6_k)
|
||
- [`Waveshare ESP32 S3 (240x240 1.28” Round & 240x280 1.69” Rectangular)`](https://youtu.be/WXER_NX7LWI)
|
||
- [`Installing custom watchfaces`](https://youtu.be/qXx6tj7s6pQ)
|
||
|
||
|
||
|
||
https://github.com/user-attachments/assets/3cdc30e3-8383-4227-b88c-32bd1d464c70
|
||
|
||
|
||
|
||
## Screens Preview
|
||
|
||
|
||
|
||
|
||
|
||
## Screens
|
||
- Time (Time, Date, Day, Weather[Icon, Temp]) + Custom Watchfaces
|
||
- ~~Installable custom watchfaces from Chronos app~~ ToDo - LVGL 9
|
||
- Weather (City,Icon, Temp, Update time) (1 week forecast [Day, Icon, Temp]) (Hourly forecast [+wind, ])
|
||
- Notifications (Icon, Time, Text) (List [Icon, Text] - 10 notifications) (Incoming call)
|
||
- Settings (Brightness, Timeout, Battery, About)
|
||
- Control (Music Control, Find Phone, Bluetooth State) (Camera Capture)
|
||
- QR Codes, Contacts
|
||
- Games - Simon Says, Racing (Need to enable)
|
||
- Navigation (Get Google Maps Navigation instructions on ESP32)
|
||
- Create custom apps with LVGL [sample](src/apps/sample/)
|
||
|
||
## Building
|
||
|
||
Select your build environment in platformio.ini by uncommenting only one `default_envs`
|
||
|
||
When building for native check that you have configured SDL according to your platform. Follow the instructions here
|
||
https://github.com/lvgl/lv_platformio?tab=readme-ov-file#install-sdl-drivers
|
||
|
||
The SDL path might be different depending on your configuration and you will need to update [`platformio.ini`](platformio.ini) accordingly
|
||
|
||
### Prebuilt Native
|
||
|
||
The prebuilt native applications have been included in the [`test folder`](test/), however you might still require SDL installed before running them.
|
||
|
||
You can also find binary files for various boards.
|
||
|
||
## Supported Boards
|
||
|
||
|
||
|
||
|
||
- [Viewe SmartRing AMOLED 1.8 466x466](https://viewedisplay.com/product/esp32-1-8-inch-round-amoled-touch-display-arduino-lvgl-wifi-voice-assistant-ai-smart-displays/)
|
||
- [Viewe Touch Knob AMOLED 1.5 466x466](https://viewedisplay.com/product/esp32-1-5-inch-466x466-round-amoled-knob-display-touch-screen-arduino-lvgl/)
|
||
- [CrowPanel ESP32 Display-1.28(R) 240x240](https://www.elecrow.com/crowpanel-esp32-display-1-28-r-inch-240-240-round-ips-display-capacitive-touch-spi-screen.html)
|
||
- [M5 Stack Dial 240x240](https://docs.m5stack.com/en/core/M5Dial)
|
||
- [ESP32 C3 Mini 1.28 240x240](https://www.aliexpress.com/item/1005006451631422.html)
|
||
- [Waveshare S3 1.28 240x240](https://www.waveshare.com/product/esp32-s3-touch-lcd-1.28.htm)
|
||
- [Waveshare S3 1.69 240x280](https://www.waveshare.com/esp32-s3-touch-lcd-1.69.htm)
|
||
- [Waveshare RP2040 1.28 240x240](https://www.waveshare.com/rp2040-touch-lcd-1.28.htm)
|
||
- [Waveshare RP2040 1.69 240x280](https://www.waveshare.com/product/rp2040-touch-lcd-1.69.htm)
|
||
- [Waveshare S3 1.75 466x466](https://www.waveshare.com/product/esp32-s3-touch-amoled-1.75.htm)
|
||
- [Waveshare S3 2.06 410x502](https://www.waveshare.com/product/esp32-s3-touch-amoled-2.06.htm)
|
||
|
||
## Watchfaces
|
||
|
||
This project supports two types of watchfaces in addition to the default one:
|
||
|
||
#### 1. External Precompiled Binary Watchfaces
|
||
|
||
These watchfaces are binary files converted into LVGL code and compiled along with the main code. To add or remove these watchfaces, you need to recompile and flash the firmware.
|
||
|
||
- Check out the [`esp32-lvgl-watchface`](https://github.com/fbiego/esp32-lvgl-watchface) project for details on converting watchfaces from binary to LVGL code.
|
||
- You can add more watchfaces, but be mindful of the ESP32's flash size limitations. Prioritize compiling only your favorite watchfaces.
|
||
- Links to pre-built binary watchfaces are included. Enable them in `app_hal.h` according to your build platform.
|
||
|
||
#### 2. External Installable Binary Watchfaces
|
||
|
||
- [x] Custom watchfaces works on LVGL 8. [Checkout this branch](https://github.com/fbiego/esp32-c3-mini/tree/lvgl_8)
|
||
- [ ] Work in progress for LVGL 9
|
||
|
||
- Ensure there is sufficient storage space on the ESP32 flash. Using the FFAT partition is recommended.
|
||
|
||
> [!IMPORTANT]
|
||
> This feature is experimental and may not work 100% reliably.
|
||
> Ensure your partition is mounted successfully for proper functionality.
|
||
|
||
> [!WARNING]
|
||
> This has issues running on ESP32 C3 Mini due to smaller SRAM size
|
||
> Not ported to LVGL 9 yet. Work in progess
|
||
|
||
## Chronos App
|
||
This is needed for additional functions on esp32 hardware as listed below.
|
||
|
||
[<img src="chronos.png?raw=true" width=100 align=left>](https://chronos.ke/app?id=c3-mini)
|
||
<br><br><br><br>
|
||
|
||
[ChronosESP32 Website](https://chronos.ke/esp32)
|
||
|
||
|
||
### App functions (ESP32)
|
||
[ChronosESP32](https://github.com/fbiego/chronos-esp32) library handles communication with the Chronos app over BLE
|
||
- Sync time
|
||
- ~~Install additional watchfaces~~ LVGL 9 Work in progress
|
||
- Send notifications and call alerts
|
||
- Sync weather info
|
||
- Sync QR Links, & Contacts
|
||
- Music control, find phone & Camera
|
||
- Send Navigation instructions
|
||
|