1. Utangulizi
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. Sifa Muhimu
- Kichakataji: Equipped with an Xtensa 32-bit LX7 dual-core processor, operating at up to 240MHz.
- Uunganisho wa wireless: Supports 2.4GHz Wi-Fi (802.11 b/g/n) and Bluetooth 5 (BLE) with an onboard antenna.
- Kumbukumbu: Built-in 512KB SRAM and 384KB ROM, with onboard 2MB PSRAM and an external 16MB Flash memory.
- Onyesha: Features a 1.28-inch round IPS LCD panel with 240×240 resolution and 65K colors, driven by the GC9A01A display chip.
- Uzio: 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.
- Usimamizi wa Nguvu: Onboard 3.7V lithium battery recharge/discharge header.
- Muunganisho: Type-C connector for power and data, and GPIO headers for flexible pin function configuration.
- Nguvu ya Chini: Supports flexible clock and module power supply settings for optimized power consumption.

Kielelezo 2: Zaidiview of the Waveshare ESP32-S3 Development Board's main features.

Kielelezo 3: Kina 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.
- Kitufe cha KUWASHA: Press it before resetting to enter download mode.
- WEKA UPYA kitufe.
- MX1.25 battery header: MX1.25 2P connector, for 3.7V Lithium battery, supports charging and discharging.
- USB Type-C connector: 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.
Key pin functions include:
- BAT_ADC (GP1): Betri Voltage Acquisition Pin (biased by resistors to 1/2 value of battery voltage).
- 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)
- Sakinisha Arduino IDE: Pakua na usakinishe IDE ya Arduino kutoka kwa Arduino rasmi webtovuti (www.arduino.cc/en/software).
- Install ESP32 Board Package:
- Fungua IDE ya Arduino, nenda kwa File > Mapendeleo.
- In the "Additional Boards Manager URLs" field, add:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - Nenda kwa Tools > Board > Boards Manager....
- Tafuta "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.
- Nenda kwa Mchoro > Jumuisha Maktaba > Dhibiti Maktaba....
- Tafuta and install the necessary libraries (e.g., TFT_eSPI, LVGL, etc.) as per Waveshare's instructions.
5.2. Vidokezo Muhimu vya Kuweka
- 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 BUTI button before resetting the device.
6. Kuendesha Kifaa
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. Muunganisho wa Waya
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. Mwingiliano wa Sauti
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. Maelezo ya kiufundi
| Sifa | Thamani |
|---|---|
| Jina la Mfano | ESP32-S3-LCD-1.28 |
| Nambari ya Mfano wa Kipengee | ESP32-S3 1.28inch Display B |
| Kichakataji | Xtensa 32-bit LX7 dual-core |
| Kasi ya CPU | Hadi 240 MHz |
| Kumbukumbu ya RAM Ukubwa Imewekwa | 2 MB (PSRAM) |
| Uwezo wa Kuhifadhi Kumbukumbu | 16 MB (Mweko) |
| Aina ya Kuonyesha | Round IPS LCD |
| Ukubwa wa Kuonyesha | 1.28 inches (Φ32.4mm) |
| Azimio la Onyesho | 240(H)RGB x 240(V) |
| Onyesha Chip | GC9A01A |
| Sensorer ya IMU | QMI8658 (16-bit Accelerometer & Gyroscope) |
| Bila waya | 2.4GHz Wi-Fi (802.11 b/g/n), Bluetooth 5 (BLE) |
| Kiunganishi | Aina-C |
| Vipimo vya Kifurushi | Inchi 4.14 x 3.2 x 0.8 |
| Uzito wa Kipengee | 1.27 wakia |
| Mtengenezaji | Waveshare |

Figure 6: Outline dimensions of the Waveshare ESP32-S3 Development Board.
8. Maintenance and Battery Usage
- Eneo la Antena: 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.
- Kuchaji Betri: 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.
- Betri Iliyopendekezwa: Connect a 3.7V single-cell lithium battery with a capacity of 500mAh or below. Refer to the schematic diagram for detailed connections.
- Ulinzi wa Kuchaji Zaidi/Kutokwa na Kinga: 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. Utatuzi wa shida
- 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. Msaada na Rasilimali
For further assistance, detailed documentation, and community support, please refer to the official Waveshare resources:
- Rasmi ya Waveshare Webtovuti: Tembelea www.waveshare.com for product pages, datasheets, and exampnambari.
- Waveshare Amazon Store: Explore other Waveshare products and resources at their Amazon store: Waveshare Store.
- SDK and Documentation: Waveshare provides comprehensive SDKs and open-source documentation tutorials to help developers integrate the board into their applications.





