• sales

    +86-0755-88291180

ESP32-C6-LCD-1.28 User Guide

Features

  • Powered by the ESP32-C6 high-performance 32-bit RISC-V processor, with a main frequency of up to 160MHz
  • Integrated WiFi 6, Bluetooth 5 and IEEE 802.15.4 (Zigbee 3.0 and Thread) wireless communication, with superior RF performance
  • Onboard 512KB HP Static RAM, 16KB LP Static RAM, 320KB ROM and external 16MB Flash memory
  • Utilizes a Type-C port, eliminating the hassle of plug orientation
  • Onboard 1.28inch capacitive LCD screen with 240 × 240 resolution, 65K colors, capable of displaying clear color images
  • CNC metal top case with optional frosted acrylic back plate
  • Onboard QMI8658 6-axis IMU (3-axis accelerometer and 3-axis gyroscope)
  • Onboard PCF85063 RTC chip for convenient RTC functionality implementation
  • Onboard 3.7V MX1.25 lithium battery charge/discharge interface
  • Onboard SH1.0 14PIN expansion header, breaking out 6 GPIOs, 1 UART, and 1 I2C
  • Onboard TF card slot for storage expansion and high-speed data transfer, enhancing flexibility

Onboard Resources


  1. ESP32-C6 Integrates a RISC-V single-core processor, up to 160MHz, supporting 2.4GHz Wi-Fi 6 and BLE 5
  2. 2.4GHz Ceramic Antenna
  3. TF Card Slot
  4. BOOT Button Press during reset to enter download mode
  5. RESET Button For system reset
  6. 16MB NOR Flash
  7. QMI8658 6-axis IMU integrating a 3-axis gyroscope and a 3-axis accelerometer
  8. MX1.25 Battery Connector MX1.25 2P connector for connecting a 3.7V lithium battery, supports charging and discharging
  9. ETA6096 High-efficiency lithium battery charging chip
  10. Charging Indicator When a system battery is connected, stays on during charging and turns off when fully charged; state is undefined when no system battery is connected
  11. USB Type-C Interface USB-to-serial for programming and serial logging
  12. PCF85063 RTC clock chip
  13. SH1.0 RTC Battery Interface Supports connecting a rechargeable RTC battery

Interface Introduction


Dimensions

ESP32-C6-LCD-1.28


ESP32-C6-LCD-1.28-B


Working with Arduino

This chapter includes the following sections. Please read as needed:

Arduino Getting Started

New to Arduino ESP32 development and looking for a quick start? We have prepared a comprehensive Getting Started Tutorial for you.

Note: This tutorial uses the ESP32-S3-Zero as a reference example, and all hardware code is based on its pinout. Before you start, we recommend checking the pinout of your development board to ensure the pin configuration is correct.

Setting Up the Development Environment

1. Installing and Configuring the Arduino IDE

INFO

For the ESP32-C6-LCD-1.28 development board, the Arduino IDE requires the installation of arduino-esp32 v3.2.1 or higher.

Please refer to the tutorial Install and Configure Arduino IDE to download and install the Arduino IDE and add ESP32 support.

2. Installing Libraries

  • When installing Arduino libraries, there are typically two methods: online installation and offline installation. If the library installation requires offline installation, you must use the provided library files.
  • For most libraries, users can easily search for and install them via the Arduino IDE's online Library Manager. However, some open-source or custom libraries are not synchronized to the Arduino Library Manager and therefore cannot be found through online search. In this case, users can only install these libraries manually via offline methods.
  • The example program package for the ESP32-C6-LCD-1.28 development board can be downloaded from here. The Arduino/libraries directory within the package already contains all the library files required for this tutorial.
Library/File NameDescriptionVersionInstallation Method
LVGLGraphics Libraryv8.4.0"Offline Installation"
Arduino_GFX_LibraryLow-level graphics drawing libraryv1.6.4"Offline/Online Installation"
VERSION COMPATIBILITY NOTE

There are strong dependencies between versions of LVGL and its driver libraries. For example, a driver written for LVGL v8 may not be compatible with LVGL v9. To ensure that the examples can be reproduced reliably, it is recommended to use the specific versions listed in the table above. Mixing different versions of libraries may lead to compilation failures or runtime errors.

3. Arduino Project Settings


Example

The Arduino examples are located in the examples/Arduino directory of the example package.

ExampleBasic Program DescriptionDependency Library
01_I2C_PCF85063Read RTC time and print it-
02_I2C_QMI8658Print the raw data from the IMU-
03_SD_CardLoad and display TF card information-
04_WIFI_APSet to AP mode, can obtain the MAC address of connected devices-
05_WIFI_STASet to STA mode to connect to Wi-Fi and obtain an IP address-
06_HelloWorld_GFXDisplay HelloWorld on the screenGFX_Library_for_Arduino
07_LVGL_DemoLVGL exampleLVGL

01_I2C_PCF85063

Example Description

  • This example demonstrates how the ESP32-C6-LCD-1.28 reads the time and date from the PCF85063 RTC and prints them to the terminal.

Expected Behavior

  • After compiling and uploading the program, open the serial monitor to see the printed RTC time, as shown below:


02_I2C_QMI8658

Example Description

  • This example uses the I2C protocol to initialize the QMI8658 chip, then reads the corresponding attitude data and prints it to the terminal.

Expected Behavior

  • Open the serial monitor to view the raw data output from the IMU (Euler angles require conversion), as shown in the figure below:


03_SD_Card

Example Description

  • This example drives the TF card via the SPI interface, mounts it, and prints the TF card information to the terminal.

Expected Behavior

  • Open the serial monitor to see the SD Size output, which is the actual capacity of the TF card, as shown below:


04_WIFI_AP

Example Description

  • This example can set the development board as a hotspot, allowing phones or other devices in STA mode to connect to the development board.

Expected Behavior

  • After flashing the program, open the Serial Terminal. If a device successfully connects to the hotspot, the MAC address of that device will be output, as shown:


05_WIFI_STA

Example Description

  • This example configures the development board as a STA device to connect to a router, thereby accessing the system network.

Expected Behavior

  • After flashing the program, open the Serial Terminal. If the device successfully connects to the router, the obtained IP address will be output, as shown in the figure:


06_HelloWorld_GFX

Example Description

  • Implement some basic GUI interface on the screen by porting the Arduino_GFX_Library.

Expected Behavior

  • After flashing the program, you can see various "Hello World" formats displayed on the screen, as shown in the figure:


07_LVGL_Demo

Example Description

  • This example ports LVGL V8 and runs an LVGL example program.

Expected Behavior

  • After the program is flashed, the device operation result is as follows:



ESP-IDF

This chapter includes the following sections. Please read as needed:

ESP-IDF Getting Started

New to ESP32 ESP-IDF development and looking to get started quickly? We have prepared a general Getting Started Tutorial for you.

Please Note: This tutorial uses the ESP32-S3-Zero as a teaching example, and all hardware code is based on its pinout. Before you start, it is recommended that you check the pinout of your development board to ensure the pin configuration is correct.

Setting Up the Development Environment

INFO

For the ESP32-C6-LCD-1.28 development board, ESP-IDF version V5.5.2 or above is required.

NOTE

The following guide uses Windows as an example, demonstrating development using VS Code + the ESP-IDF extension. macOS and Linux users should refer to the official documentation.

VERSION SELECTION

The screenshots in this section use ESP-IDF V5.5.2 as an example. When installing, please select the ESP-IDF version that matches your board's example.

Install the ESP-IDF Development Environment

  1. Download the installation manager from the ESP-IDF Installation Manager page. This is Espressif's latest cross-platform installer. The following steps demonstrate how to use its offline installation feature.

    Click the Offline Installer tab on the page, then select Windows as the operating system and the ESP-IDF version you need (the version shown in the screenshot is for reference only — choose the version that fits your actual needs).


    After confirming your selection, click the download button. The browser will automatically download two files: the ESP-IDF Offline Package (.zst) and the ESP-IDF Installer (.exe).


    Please wait for both files to finish downloading.

  2. Once the download is complete, double-click to run the ESP-IDF Installer (eim-gui-windows-x64.exe).

    The installer will automatically detect if the offline package exists in the same directory. Click Install from archive.


    Next, select the installation path. We recommend using the default path. If you need to customize it, ensure the path does not contain Chinese characters or spaces. Click Start installation to proceed.


  3. When you see the following screen, the ESP-IDF installation is successful.


  4. We recommend installing the drivers as well. Click Finish installation, then select Install driver.


Install Visual Studio Code and the ESP-IDF Extension

  1. Download and install Visual Studio Code.

  2. During installation, it is recommended to check Add "Open with Code" action to Windows Explorer file context menu to facilitate opening project folders quickly.

  3. In VS Code, click the Extensions icon Extensions Icon in the Activity Bar on the side (or use the shortcut Ctrl + Shift + X) to open the Extensions view.

  4. Enter ESP-IDF in the search box, locate the ESP-IDF extension, and click Install.


  5. For ESP-IDF extension versions ≥ 2.0, the extension will automatically detect and recognize the ESP-IDF environment installed in the previous steps, requiring no manual configuration.

Example

The ESP-IDF examples are located in the ESP-IDF directory of the example package.

ExampleBasic Program DescriptionDependency Library
01_FactoryFactory test program-
02_QMI8658Print the raw data from the IMU-
03_PCF85063Read RTC time and print it-
04_SD_CardLoad and display TF card information-
05_WIFI_APSet to AP mode to obtain the IP address of the access device-
06_WIFI_STASet to STA mode to connect to Wi-Fi and obtain an IP address-
07_LVGL_DemoLVGL exampleLVGL

01_Factory

Example Description

  • This example is a comprehensive example for the ESP32-C6-LCD-1.28, and it is also the factory default flashed example.

Expected Behavior

  • After compiling and uploading the program, the screen enters the display test interface and cycles through red, green, and blue colors.

  • Short press the BOOT button to switch between different screens and view various parameters.


02_QMI8658

Example Description

  • This example uses the I2C protocol to initialize the QMI8658 chip, then reads the corresponding attitude data and prints it to the terminal.

Expected Behavior

  • Open the serial monitor to view the raw data output from the IMU (Euler angles require conversion), as shown in the figure below:


03_PCF85063

Example Description

  • This example demonstrates how the ESP32-C6-LCD-1.28 reads the time and date from the PCF85063 RTC and prints them to the terminal.

Expected Behavior

  • After compiling and uploading the program, open the serial monitor to see the printed RTC time, as shown below:


04_SD_Card

Example Description

  • This example drives the TF card via the SPI interface, mounts it, and reads/writes data to a test.txt file.

Expected Behavior

  • Open the serial monitor to see the TF card read/write test process, as shown below:


05_WIFI_AP

Example Description

  • This example can set the development board as a hotspot, allowing phones or other devices in STA mode to connect to the development board.

Expected Behavior

  • After uploading the program, open the serial terminal. When a device successfully connects to the hotspot, the IP address of that device is printed, as shown:


06_WIFI_STA

Example Description

  • This example configures the development board as a STA device to connect to a router, thereby accessing the system network.

Expected Behavior

  • After uploading the program, open the serial terminal. When the device successfully connects to the hotspot, it prints the assigned IP address and Wi-Fi information, as shown:


07_LVGL_Demo

Example Description

  • This example ports LVGL V9 and runs an LVGL example program.

Expected Behavior

  • After the program is flashed, the device operation result is as follows:



Firmware Flashing and Erasing

This product provides test firmware that can be flashed directly to verify whether the onboard devices are functioning properly.

  • Firmware download: ESP32-C6-LCD-1.28 Example. The bin file is located in the firmware directory of the example package.
  • Flash address: 0x00

The following steps apply to the firmware provided on this page.

  • Download and extract Espressif's official Flash Download Tool (Download)

  • Run Flash Download Tool and select the options that match the development board's MCU and download interface. The screenshot below uses ESP32-S3 and USB as an example; use the options required by the product's hardware design.


  • Parameter settings

    • Select the COM port for the development board
    • Set BAUD to the maximum value, 1152000
    • Click the "..." button in the row, select the bin file provided by Waveshare, manually enter the flash address given at the top of this page in the field to its right, and select the leftmost checkbox in the row
    • Click START to begin flashing


  • Wait for flashing to complete (this may take some time; please be patient)

  • Press the reset button and verify the result



Resources

1. Hardware Resources

2. Technical Manuals

3. Example


Support

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Email: services01@spotpear.com

TAG: Core3566004000 Raspberry Pi Pico 2 RP2350B 7inch Capacitive TouchScreen 7 inch LCD Display Development Board 800×480 Milk V Duo Raspberry Pi 5 Audio Raspberry Pi Raspberry Pi 10.1 inch LCD HDM Display Capacitive TouchScreen 10.1EP-CAPLCD 1920x1200 For Jetson Nano/mini Computer PC Raspberry Pi 5 Case RP2040 1.5inch LCD Arduino IR Thermal Imaging Camera Raspberry Pi Compute Module 4 CM4 IO Board Dual Gigabit Ethernet Mini Router Board USB TO TTL Mini FT232 UART Communication Converter Original FT232RNL ESP32 S3 Development Board 4.3 inch LCD Capacitive Touch Screen 4.3inch Display 800×480 N16R8 Install Espressif IDF Plugin Tutorial User Guide ESP-NOW Control D-Robotics RDK X3 Module Core MD Module Horizon Sunrise Pi ARM Cortex-A53 5Tops Size Compatible With Raspberry Pi CM4 Size Pico-DALI2 Expansion Board For ESP32 C6 S3 DALI communication control multiple LED GC2083 STM32 programmer Raspberry Pi Camera Case Pi5