1. Wprowadzenie
The Waveshare ESP32-S3-LCD-1.28 is a high-performance microcontroller development board designed for a wide range of applications. It integrates a 1.28-inch round LCD screen, a lithium battery charging chip, and a six-axis sensor (accelerometer and gyroscope). The board utilizes the ESP32-S3R2 system-on-chip (SoC), offering low-power Wi-Fi and BLE5.0 capabilities, along with external 16MB Flash and 2MB PSRAM. Its hardware encryption accelerators, Random Number Generator (RNG), Hash-based Message Authentication Code (HMAC), and Digital Signature module address modern IoT security requirements. Multiple low-power operating modes make it suitable for IoT, mobile devices, wearable electronics, and smart home applications.

Figure 1: Waveshare ESP32-S3 Development Board with 1.28-inch Round LCD Display and included screwdriver.
2. Główne cechy
- Edytor: Equipped with an Xtensa 32-bit LX7 dual-core processor, operating at up to 240MHz.
- Połączenie bezprzewodowe: Supports 2.4GHz Wi-Fi (802.11 b/g/n) and Bluetooth 5 (BLE) with an onboard antenna.
- Pamięć: Built-in 512KB SRAM and 384KB ROM, with onboard 2MB PSRAM and an external 16MB Flash memory.
- Wyświetlacz: Features a 1.28-inch round IPS LCD panel with 240×240 resolution and 65K colors, driven by the GC9A01A display chip.
- Załącznik: Adopts a CNC metal case with an Acrylic dull-polish bottom plate.
- Czujniki: Onboard QMI8658 6-axis IMU (3-axis accelerometer and 3-axis gyroscope) for motion detection.
- Zarządzanie energią: Onboard 3.7V lithium battery recharge/discharge header.
- Łączność: Type-C connector for power and data, and GPIO headers for flexible pin function configuration.
- Niska moc: Supports flexible clock and module power supply settings for optimized power consumption.

Rysunek 2: Koniecview of the Waveshare ESP32-S3 Development Board's main features.

Rysunek 3: Szczegółowy view of the CNC metal case and acrylic bottom plate.
3. Onboard Components
The development board integrates various components to provide comprehensive functionality. Refer to the diagram below for component identification:

Figure 4: Labeled components on the Waveshare ESP32-S3 Development Board.
- ESP32-S3R2: The SoC with Wi-Fi and Bluetooth, up to 240MHz operating frequency, with onboard 2MB PSRAM.
- W25Q128JVSIQ: 16MB pamięci NOR-Flash.
- QMI8658: 6-osiowy IMU obejmuje 3-osiowy żyroskop i 3-osiowy akcelerometr.
- ME6217C33M5G: 800mA output, low dropout, high rejection rate.
- CH343P: USB to UART chip.
- ETA6096: High-efficiency Lithium battery recharge manager.
- 1.27mm pitch headers: Adapting multiple GPIO pins.
- Przycisk BOOT: Press it before resetting to enter download mode.
- Przycisk reset.
- MX1.25 battery header: MX1.25 2P connector, for 3.7V Lithium battery, supports charging and discharging.
- Złącze USB typu C: For programming and log printing.
- 2.4GHz ceramic antenna.
4. Wyprowadzenia GPIO
The ESP32-S3 Development Board provides 30 multi-function GPIO pins, allowing for flexible development and integration with various peripherals. The pin functions can be configured as needed.

Figure 5: GPIO Pinout for the Waveshare ESP32-S3 Development Board.
Funkcje kluczyka obejmują:
- BAT_ADC (GP1): Pojemność bateriitage Acquisition Pin (biased by resistors to 1/2 value of battery voltagmi).
- IMU_SDA (GP6), IMU_SCL (GP7): I2C communication for the QMI8658 IMU.
- LCD_DC (GP8), LCD_CS (GP9), LCD_CLK (GP10), LCD_DIN (GP11), LCD_RST (GP12), LCD_BL (GP40): Pins for controlling the 1.28-inch LCD display.
- IMU_INT1 (GP47), IMU_INT2 (GP48): Interrupt pins for the QMI8658 IMU.
- RXD (GPIO44), TXD (GPIO43): UART communication pins.
- Various other GPIO pins (GP0-GP5, GP13-GP19, GP21, GP33-GP36, GP39, GP41, GP42, GP45, GP46) for general purpose input/output.
5. Setup and Development Environment
To begin development with the Waveshare ESP32-S3-LCD-1.28, you will typically need to set up a development environment. The Arduino IDE is a common choice for its ease of use and extensive library support.
5.1. Software Installation (Arduino IDE)
- Zainstaluj Arduino IDE: Pobierz i zainstaluj Arduino IDE z oficjalnego Arduino webStrona (www.arduino.cc/en/software).
- Install ESP32 Board Package:
- Otwórz Arduino IDE, przejdź do File > Preferencje.
- In the "Additional Boards Manager URLs" field, add:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - Idź do Narzędzia > Tablica > Menedżer tablic....
- Szukaj "esp32" and install the "esp32 by Espressif Systems" package.
- Install Required Libraries:
- The Waveshare documentation typically provides specific versions of libraries like TFT_eSPI and LVGL. It is recommended to use the versions specified in the official Waveshare documentation to ensure compatibility.
- Idź do Sketch > Include Library > Manage Libraries....
- Szukaj and install the necessary libraries (e.g., TFT_eSPI, LVGL, etc.) as per Waveshare's instructions.
5.2. Important Notes for Setup
- Arduino IDE Version: Some users have reported issues with the latest versions of the ESP32 board management software and libraries. If you encounter problems, try using the specific versions recommended in the Waveshare documentation (e.g., version 2.0.12 for the ESP32 board).
- Library Compatibility: Verify that all required libraries (e.g., TFT_eSPI, LVGL) are installed and are compatible with your chosen ESP32 board package version.
- Entering Download Mode: To flash new code, press the URUCHOMIĆ button before resetting the device.
6. Obsługa urządzenia
The ESP32-S3 Development Board offers various operational modes and interactive features, primarily through its 1.28-inch round LCD display and integrated wireless capabilities.
6.1. Display Interaction
The 1.28-inch round IPS LCD display provides a vibrant visual interface. Depending on the firmware loaded, it can support touch functionality for interactive control. Users can navigate menus, adjust settings, and view data directly on the screen.
Video 1: Demonstration of the Waveshare ESP32-S3 Development Board's display and touch functionality. Note: This video may feature a 1.85-inch display, which is a similar but larger model than the 1.28-inch display of this product.
6.2. Łączność bezprzewodowa
The board's integrated 2.4GHz Wi-Fi and Bluetooth 5 (BLE) enable stable and efficient wireless communication. This allows for:
- Connecting to local networks for IoT applications.
- Bluetooth communication with other devices.
- Streaming audio (if a speaker is connected) via protocols like DLNA.
6.3. Interakcja głosowa
With an onboard microphone and audio decoding chip, the device can support voice interaction. This includes offline voice commands for controlling device functions (e.g., turning off backlight) and potential integration with AI models for more advanced applications.
Video 2: Demonstration of voice control and music playback features. Note: This video may feature a 1.85-inch display, which is a similar but larger model than the 1.28-inch display of this product.
7. Specyfikacje techniczne
| Atrybut | Wartość |
|---|---|
| Nazwa modelu | ESP32-S3-LCD-1.28 |
| Numer modelu przedmiotu | ESP32-S3 1.28inch Display B |
| Edytor | Xtensa 32-bit LX7 dwurdzeniowy |
| Prędkość procesora | Do 240 MHz |
| Rozmiar zainstalowanej pamięci RAM | 2 MB (PSRAM) |
| Pojemność pamięci masowej | 16MB (Flash) |
| Typ wyświetlacza | Round IPS LCD |
| Rozmiar wyświetlacza | 1.28 inches (Φ32.4mm) |
| Rozdzielczość wyświetlacza | 240(wys.)RGB x 240(pion.) |
| Wyświetl Chip | GC9A01A |
| Czujnik IMU | QMI8658 (16-bit Accelerometer & Gyroscope) |
| Bezprzewodowy | 2.4GHz Wi-Fi (802.11 b/g/n), Bluetooth 5 (BLE) |
| Złącze | Typ C |
| Wymiary opakowania | 4.14 x 3.2 x 0.8 cala |
| Waga przedmiotu | 1.27 uncji |
| Producent | Udostępnianie fal |

Figure 6: Outline dimensions of the Waveshare ESP32-S3 Development Board.
8. Maintenance and Battery Usage
- Powierzchnia anteny: When using the development board, ensure that the ceramic antenna area is not covered by PCB boards, metal, or plastic components to maintain optimal wireless performance.
- Ładowanie akumulatora: The board is equipped with an efficient charging and discharging management chip (ETA6096). The charging current is factory-set to 1A. Users can adjust the charging current by replacing the R15 resistor.
- Zalecany akumulator: Connect a 3.7V single-cell lithium battery with a capacity of 500mAh or below. Refer to the schematic diagram for detailed connections.
- Zabezpieczenie przed przeładowaniem/nadmiernym rozładowaniem: To prevent overcharging and over-discharging, stop discharging the battery when it reaches a fully charged 4.2V and stop charging when it discharges to 3.7V.
- Lithium Polymer and Lithium-ion Batteries: These batteries are very sensitive and can cause fire, personal injury, or property damage if not handled properly. Always store them in a safe place, away from flammable materials and out of reach of children.
9. Rozwiązywanie Problemów
- Flashing Issues: If you encounter difficulties flashing new code to the device, ensure you are using the correct version of the ESP32 board package in the Arduino IDE. Some users have found success with specific older versions (e.g., 2.0.12) rather than the latest.
- Library Conflicts: Verify that all required libraries (e.g., TFT_eSPI, LVGL) are installed and are compatible with your chosen ESP32 board package version. Refer to Waveshare's official documentation for recommended library versions.
- GPIO Pin Access: The 1.27mm pitch pin headers may require specific adapter boards for easy access. Ensure proper soldering and secure connections if using custom solutions. Note that adding adapter boards might prevent the back plate from being reattached without modification.
- Wireless Connectivity Problems: If Wi-Fi or Bluetooth is not functioning correctly, check that the 2.4GHz ceramic antenna area is clear of obstructions.
10. Wsparcie i zasoby
Aby uzyskać dalszą pomoc, szczegółową dokumentację i wsparcie społeczności, zapoznaj się z oficjalnymi zasobami Waveshare:
- Oficjalny Waveshare Webstrona: Odwiedzać www.waveshare.com for product pages, datasheets, and exampkod.
- Waveshare Amazon Store: Explore other Waveshare products and resources at their Amazon store: Sklep Waveshare.
- SDK and Documentation: Waveshare provides comprehensive SDKs and open-source documentation tutorials to help developers integrate the board into their applications.





