Initialize git
This commit is contained in:
Kazimierz Ciołek
113
README.md
Normal file
113
README.md
Normal file
@@ -0,0 +1,113 @@
|
||||
# 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
|
||||
|
||||
Reference in New Issue
Block a user