waveshare ESP32-S3 1.28inch Display B

Waveshare ESP32-S3 Development Board with 1.28-inch Round LCD Display User Manual

Model: ESP32-S3 1.28inch Display B | Brand: Waveshare

1. Уводзіны

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.

Waveshare ESP32-S3 Development Board with 1.28-inch Round LCD Display and included screwdriver

Figure 1: Waveshare ESP32-S3 Development Board with 1.28-inch Round LCD Display and included screwdriver.

2. Асноўныя магчымасці

  • Працэсар: Equipped with an Xtensa 32-bit LX7 dual-core processor, operating at up to 240MHz.
  • Бесправаднае падключэнне: Supports 2.4GHz Wi-Fi (802.11 b/g/n) and Bluetooth 5 (BLE) with an onboard antenna.
  • Памяць: Built-in 512KB SRAM and 384KB ROM, with onboard 2MB PSRAM and an external 16MB Flash memory.
  • Дысплей: Features a 1.28-inch round IPS LCD panel with 240×240 resolution and 65K colors, driven by the GC9A01A display chip.
  • Укладанне: Adopts a CNC metal case with an Acrylic dull-polish bottom plate.
  • Датчыкі: Onboard QMI8658 6-axis IMU (3-axis accelerometer and 3-axis gyroscope) for motion detection.
  • Упраўленне харчаваннем: Onboard 3.7V lithium battery recharge/discharge header.
  • Падключэнне: Type-C connector for power and data, and GPIO headers for flexible pin function configuration.
  • Нізкая магутнасць: Supports flexible clock and module power supply settings for optimized power consumption.
Diagram highlighting key features of the Waveshare ESP32-S3 Development Board including Type-C port, CPU, CNC metal case, 1.28 inch LCD, 240x240 pixels, and 65K color.

Малюнак 2: Закончанаview of the Waveshare ESP32-S3 Development Board's main features.

Close-up of the Waveshare ESP32-S3 Development Board's CNC metal case and acrylic bottom plate.

Малюнак 3: падрабязна 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:

Diagram of the Waveshare ESP32-S3 Development Board with numbered components: 1. ESP32-S3R2, 2. W25Q128JVSIQ (16MB NOR-Flash), 3. QMI8658 (6-axis IMU), 4. ME6217C33M5G, 5. CH343P (USB to UART chip), 6. ETA6096 (battery recharge manager), 7. 1.27mm pitch headers, 8. BOOT button, 9. RESET button, 10. MX1.25 battery header, 11. USB Type-C connector, 12. 2.4GHz ceramic antenna.

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.
  • Кнопка ЗАГРУЗКІ: Press it before resetting to enter download mode.
  • Кнопка RESET.
  • 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.

Diagram showing the pinout of the Waveshare ESP32-S3 Development Board with labels for Power, Ground, GPIO, I2C, UART, and System Control pins.

Figure 5: GPIO Pinout for the Waveshare ESP32-S3 Development Board.

Key pin functions include:

  • BAT_ADC (GP1): Акумулятар Voltage Acquisition Pin (biased by resistors to 1/2 value of battery voltagе).
  • 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)

  1. Install Arduino IDE: Спампуйце і ўсталюйце Arduino IDE з афіцыйнага Arduino webсайт (www.arduino.cc/en/software).
  2. Install ESP32 Board Package:
    • Адкрыйце Arduino IDE, перайдзіце да File > Налады.
    • In the "Additional Boards Manager URLs" field, add: https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
    • Перайсці да Tools > Board > Boards Manager....
    • Пошук "esp32" and install the "esp32 by Espressif Systems" package.
  3. 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.
    • Перайсці да Sketch > Include Library > Manage Libraries....
    • Пошук 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 БОТУ button before resetting the device.

6. Эксплуатацыя прылады

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. Узаемадзеянне з дысплеем

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. Бесправадное падключэнне

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. Галасавое ўзаемадзеянне

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. Тэхнічныя характарыстыкі

АтрыбутКаштоўнасць
Назва мадэліESP32-S3-LCD-1.28
Нумар мадэлі таваруESP32-S3 1.28inch Display B
ПрацэсарXtensa 32-bit LX7 dual-core
Хуткасць працэсараДа 240 Мгц
Памер усталяванай аператыўнай памяці2 MB (PSRAM)
Ёмістасць памяці16 МБ (Flash)
Тып дысплеяRound IPS LCD
Памер дысплея1.28 inches (Φ32.4mm)
Дазвол дысплея240(H)RGB x 240(V)
дысплей ЧыпGC9A01A
Датчык IMUQMI8658 (16-bit Accelerometer & Gyroscope)
Бесправадная сувязь2.4GHz Wi-Fi (802.11 b/g/n), Bluetooth 5 (BLE)
ЗлучальнікТып-C
Памеры ўпакоўкі4.14 х 3.2 х 0.8 цалі
Вага прадмета1.27 унцыі
ВытворцаWaveshare
Diagram showing the outline dimensions of the Waveshare ESP32-S3 Development Board in millimeters.

Figure 6: Outline dimensions of the Waveshare ESP32-S3 Development Board.

8. Maintenance and Battery Usage

  • Плошча антэны: 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.
  • Зарадка акумулятара: 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.
  • Рэкамендаваны акумулятар: Connect a 3.7V single-cell lithium battery with a capacity of 500mAh or below. Refer to the schematic diagram for detailed connections.
  • Overcharge/Over-discharge Protection: 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. Выпраўленне непаладак

  • 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.
  • Праблемы з бесправадным падключэннем: If Wi-Fi or Bluetooth is not functioning correctly, check that the 2.4GHz ceramic antenna area is clear of obstructions.

10. Падтрымка і рэсурсы

For further assistance, detailed documentation, and community support, please refer to the official Waveshare resources:

  • Афіцыйны прадстаўнік Waveshare Webсайт: Наведайце www.waveshare.com for product pages, datasheets, and exampкод.
  • 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.

© 2026 Waveshare. All rights reserved. This manual is for informational purposes only.