1. Introduktion
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. Nøglefunktioner
- Processor: Equipped with an Xtensa 32-bit LX7 dual-core processor, operating at up to 240MHz.
- Trådløs forbindelse: Supports 2.4GHz Wi-Fi (802.11 b/g/n) and Bluetooth 5 (BLE) with an onboard antenna.
- Hukommelse: Built-in 512KB SRAM and 384KB ROM, with onboard 2MB PSRAM and an external 16MB Flash memory.
- Vise: Features a 1.28-inch round IPS LCD panel with 240×240 resolution and 65K colors, driven by the GC9A01A display chip.
- Indkapsling: Adopts a CNC metal case with an Acrylic dull-polish bottom plate.
- Sensorer: Onboard QMI8658 6-axis IMU (3-axis accelerometer and 3-axis gyroscope) for motion detection.
- Strømstyring: Onboard 3.7V lithium battery recharge/discharge header.
- Forbindelse: Type-C connector for power and data, and GPIO headers for flexible pin function configuration.
- Lav effekt: Supports flexible clock and module power supply settings for optimized power consumption.

Figur 2: Overview of the Waveshare ESP32-S3 Development Board's main features.

Figur 3: Detaljeret 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 NOR-Flash.
- QMI8658: 6-axis IMU includes a 3-axis gyroscope and a 3-axis accelerometer.
- 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.
- BOOT-knap: Press it before resetting to enter download mode.
- Genstarts knap.
- MX1.25 battery header: MX1.25 2P connector, for 3.7V Lithium battery, supports charging and discharging.
- USB Type-C-stik: For programming and log printing.
- 2.4GHz ceramic antenna.
4. GPIO Pinout
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.
Nøglefunktioner omfatter:
- BAT_ADC (GP1): Batteri Voltage Acquisition Pin (biased by resistors to 1/2 value of battery voltagog).
- 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. Softwareinstallation (Arduino IDE)
- Installer Arduino IDE: Download og installer Arduino IDE fra den officielle Arduino webwebsted (www.arduino.cc/en/software).
- Install ESP32 Board Package:
- Åbn Arduino IDE, gå til File > Præferencer.
- In the "Additional Boards Manager URLs" field, add:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - Gå til Værktøjer > Tavle > Tavleadministrator....
- Søg efter "esp32" og installer pakken "esp32 by Espressif Systems".
- 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.
- Gå til Sketch > Inkluder bibliotek > Administrer biblioteker....
- Søg efter 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).
- Bibliotekskompatibilitet: Verify that all required libraries (e.g., TFT_eSPI, LVGL) are installed and are compatible with your chosen ESP32 board package version.
- Aktivering af downloadtilstand: To flash new code, press the STØVLE button before resetting the device.
6. Betjening af enheden
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. Displayinteraktion
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. Trådløs forbindelse
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. Stemmeinteraktion
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. Tekniske specifikationer
| Attribut | Værdi |
|---|---|
| Modelnavn | ESP32-S3-LCD-1.28 |
| Varemodelnummer | ESP32-S3 1.28inch Display B |
| Processor | Xtensa 32-bit LX7 dual-core |
| CPU hastighed | Op til 240 MHz |
| Installeret RAM-hukommelsesstørrelse | 2 MB (PSRAM) |
| Hukommelseslagringskapacitet | 16 MB (Flash) |
| Display Type | Round IPS LCD |
| Skærmstørrelse | 1.28 inches (Φ32.4mm) |
| Skærmopløsning | 240(H)RGB x 240(V) |
| Display Chip | GC9A01A |
| IMU sensor | QMI8658 (16-bit Accelerometer & Gyroscope) |
| Trådløs | 2.4GHz Wi-Fi (802.11 b/g/n), Bluetooth 5 (BLE) |
| Stik | Type-C |
| Pakkedimensioner | 4.14 x 3.2 x 0.8 tommer |
| Varens vægt | 1.27 ounce |
| Fabrikant | Waveshare |

Figure 6: Outline dimensions of the Waveshare ESP32-S3 Development Board.
8. Maintenance and Battery Usage
- Antenneområde: 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.
- Batteriopladning: 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.
- Anbefalet batteri: Connect a 3.7V single-cell lithium battery with a capacity of 500mAh or below. Refer to the schematic diagram for detailed connections.
- Beskyttelse mod overopladning/overafladning: 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. Fejlfinding
- 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.
- Problemer med trådløs forbindelse: If Wi-Fi or Bluetooth is not functioning correctly, check that the 2.4GHz ceramic antenna area is clear of obstructions.
10. Support og ressourcer
For further assistance, detailed documentation, and community support, please refer to the official Waveshare resources:
- Waveshare Official Webwebsted: Besøg www.waveshare.com for product pages, datasheets, and exampkoden.
- Waveshare Amazon Store: Explore other Waveshare products and resources at their Amazon store: Waveshare-butik.
- SDK and Documentation: Waveshare provides comprehensive SDKs and open-source documentation tutorials to help developers integrate the board into their applications.





