# esp32s3watch

**Repository Path**: SeekTruthing/esp32s3watch

## Basic Information

- **Project Name**: esp32s3watch
- **Description**: use esp32s3 to develop a smart watch
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-12-14
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[中文版本](README_CN.md)

# ESP32-S3 Smart Watch

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![ESP-IDF Version](https://img.shields.io/badge/ESP--IDF-release%2Fv5.4.2-green.svg)](https://github.com/espressif/esp-idf)

## Overview

This project is an open-source smart watch developed using the ESP32-S3 microcontroller. It utilizes the ESP-IDF framework (release/v5.4.2) and is based on the LCSC-boards LCKFB-SZPI-ESP32-S3-VA development board (available from [LCSC](https://www.lcsc.com/) or [SZLCSC](https://www.szlcsc.com/)). The graphical user interface (GUI) is implemented with LVGL for smooth rendering and interaction.

The architecture emphasizes modularity and scalability:
- Employs the ESP event loop with a publisher/subscriber model for decoupling components. Publishers don't need to know about subscribers, and vice versa.
- Uses a single LVGL task to ensure thread-safety of LVGL APIs, handling UI requests via a message queue.

## Features

- **WiFi Management**: Supports enabling/disabling, scanning, and connecting to networks. After obtaining an IP address, it automatically sends an SNTP request to synchronize time with the local RTC. Concurrently, it fetches weather data via HTTPS (China region only) and updates the UI.
- **BLE HID Device**: Implements the standard HID protocol through BLE GATT. Displays the pairing PIN code on the screen; after encrypted connection, enables volume up/down, song skipping, and play/pause control.
- **SD Card File Browser**: Reads and uses LVGL list widgets to display SD card contents. Supports directory switching and BMP image viewing.
- **Camera Integration**: Drives the GC0308 camera to provide real-time preview on the SPI LCD. Supports taking photos (by pressing the BOOT0 button) and saving them in BMP format to a specified directory on the SD card.
- **Simple Calculator**: Uses a dual-stack approach (operator stack and operand stack) to handle basic arithmetic operations: +, -, *, /, and parentheses, supporting multi-level nested expressions such as "(1*((6+2)/4)-6)".
- **Settings Interface**: Configures system options such as weather API location, screen brightness adjustment, monitoring of internal RAM and PSRAM usage (if enabled), SD card information (mount status and capacity), configuration of automatic sleep time, and deletion of camera-saved pictures.
- **Calendar and Canvas**: Provides a basic calendar view and a simple drawing canvas.
- **Deep Sleep Mode**: Automatically enters deep sleep mode after a specified period of no touch events, retaining only the RTC power domain; the RTC clock continues running. Upon wake-up, the UI time is correct, eliminating the need for re-synchronization via SNTP.

## Limitations

- **SD Card Browsing**: If a directory contains too many files, not all contents will be listed completely, as LVGL widget memory allocation is limited by internal SRAM, potentially causing program crashes. Additionally, the SD card file browser only supports displaying BMP format images (compatible with 16/24/32-bit color depths). Decoded images are temporarily stored in PSRAM and released immediately after display, so there's no need to worry about RAM occupancy.
- **Resource Constraints**: Given the limited internal RAM capacity of the ESP32-S3, WiFi, BLE, and camera functions cannot be enabled simultaneously. The code includes a built-in enforcement mechanism to avoid potential conflicts.
- **LVGL Version**: This project uses LVGL version 8.3.11. If upgrading to LVGL 9 or higher, please handle any potential version compatibility issues yourself.
- **Component Dependencies**: All external component dependencies are declared in the `/main/idf_component.yml` file. These dependencies will be automatically downloaded from [https://components.espressif.com](https://components.espressif.com) when executing IDF commands. Do not modify arbitrarily to avoid compatibility issues.
- **Other Notes**: (Add additional points here if needed.)

## Demo Images

![Demo Image 1](asset/demo1.jpg)  
![Demo Image 2](asset/demo2.jpg)  
![Demo Image 3](asset/demo3.jpg)  
![Demo Image 4](asset/demo4.jpg)

## FAQ

1. **Can I use other ESP-IDF versions?**  
   Not recommended. Manual dependency resolution is required for different versions, and older ones have bugs. For example, IDF v5.2 has I2C interrupt issues leading to watchdog timeouts. Refer to the official documentation for version switching.

2. **The environment setup is too complicated. Can I just flash the program to my LCSC-boards LCKFB-SZPI-ESP32-S3-VA board to test it?**  
   Yes! Open the `/bin/flash_project_args` text file, which defines the download parameters, and enter them sequentially into the official flash download tool. refer to [flash arguement configure](asset/flash_download.png)
   
   [https://docs.espressif.com/projects/esp-test-tools/zh_CN/latest/esp32s3/production_stage/tools/flash_download_tool.html](https://docs.espressif.com/projects/esp-test-tools/zh_CN/latest/esp32s3/production_stage/tools/flash_download_tool.html)

## Resources

- **BLE HID Device Issue**: When using NimBLE stack, deinitializing BLE after init may cause crashes. Reference:  
  [https://github.com/espressif/esp-idf/issues/17493#issue-3353465850](https://github.com/espressif/esp-idf/issues/17493#issue-3353465850)
- **BLE HID References**:  
  [HID Usage Tables](https://usb.org/document-library/hid-usage-tables-16)  
  [Bluetooth Core Specification 5.0](https://www.bluetooth.com/specifications/specs/core-specification-5-0/)  
  [USB HID Device Class Definition](https://www.usb.org/document-library/device-class-definition-hid-111)
- **ESP-IDF Official Documentation**:  
  [ESP-IDF for ESP32-S3 (v5.4)](https://docs.espressif.com/projects/esp-idf/zh_CN/release-v5.4/esp32s3/index.html)  
  [Espressif Components Registry](https://components.espressif.com/)
- **Seniverse Weather API**:  
  [https://seniverse.yuque.com/hyper_data/api_v3](https://seniverse.yuque.com/hyper_data/api_v3)


## Installation

Please first ensure that you have installed the specified version of ESP-IDF and its accompanying tools. If not, please refer to the official tutorial.

1. Clone the repository:
   ```
   git clone [https://github.com/survivorhao/esp32s3watch.git](https://github.com/survivorhao/esp32s3watch.git)
   cd esp32s3watch
   ```

2. Set the target:
   ```
   idf.py set-target esp32s3
   ```

3. Configure: (The build system will automatically read the /sdkconfig.defaults file), you do not need to configure any further items
   ```
   idf.py menuconfig

   ```

4. Replace the file at `Local Project Path/managed_components/lvgl/lv_conf_remplate.h` with `Local Project Path/lv_conf.h` to configure LVGL related settings.
Modify the specified file according to `errorX.png` and `errorX_fix.png` located under the `/asset/` directory.

5. Build and flash:
   ```
   idf.py build
   idf.py -p /dev/ttyUSB0 flash monitor  \# Replace with your port
   ```

## Contributing

Contributions are welcome! Fork the repo, create a branch, and submit a pull request.
If you are interested in this project or encounter any problems, you can send an email directly to hao962112@gmail.com.
## License

MIT License - see [LICENSE](LICENSE) for details.