How zhangkeliang0627/easygps works
This project is an embedded firmware application for an ESP32S3‐based GPS tracking and smart assistant device. It integrates a wide range of hardware and software components including GPS, BLE, compass, IMU, display elements (with LVGL), SD card resources, and various peripheral drivers. The project structure is split into hardware design (PCB Gerber files and hardware README), firmware (source code, libraries, app modules, and hardware abstraction “ChappieCore”), and additional models and resource files for 3D printing and assets.
Main System Components
• Hardware Board – Represent the physical ESP32S3-based device (including onboard modules such as the GPS receiver, compass sensor [QMC5883L], IMU, BLE, SD card interface, potential display, etc.) as a central hardware component.
• Firmware – Divide this into at least two major layers:
– ChappieCore (hardware drivers and peripheral abstraction): This module contains drivers for BLE, buttons, buzzer, GPS, IMU, LVGL (GUI), etc.
– Application Layer (“App”): This includes high-level application logic such as page management, data processing, configuration, resource management, and UI pages (e.g., Compass, BLEKeyboard, Settings, SmartAssistant, LiveMap, etc.).
• External Libraries – Include key external libraries such as:
– ESP32-BLE-Combo (Bluetooth functionality)
– FastLED (LED control)
– NimBLE-Arduino (enhanced BLE support)
– TinyGPSPlus (GPS parsing)
– QMC5883LCompass (compass sensor interface)
• Resource and Data Files – The TF card structure (fonts, maps, system configuration JSON files) and the static assets that support the GUI and other functionalities.
Component Relationships and Data Flows
– Sensors (GPS, compass, IMU, buttons) send data to ChappieCore drivers.
– ChappieCore processes raw sensor data and provides an interface to the App layer.
– The application layer uses data from ChappieCore, performs higher-level data processing (for instance, data for BLE, map display, clock, and other UI pages), and then communicates to the LVGL-based GUI.
– Outbound communications (e.g., BLE/WiFi) interface with external mobile or web applications.
– The SD card (TF card) resources feed into the application (font, image, resource configuration retrieval, and backup).
Architectural Patterns and Design Principles
• Separation of Concerns – Note how the firmware is modularized: low-level hardware abstraction (in ChappieCore) is separate from high-level application logic (under App).
• Reuse of Open-Source Modules – The project builds on existing frameworks (X-TRACK, Chappie-Core) and integrates standard libraries for BLE, FastLED, GPS, etc.
• Resource and UI Management – There is a dedicated resource management module and UI page management in the App layer which clearly separates presentation from underlying hardware operations.