1. Introduction
This manual provides detailed instructions for the Wishiot ESP32 2.8-inch Display Module (Model ESP32-2432S028R). This module integrates a 2.8-inch 240*320 LCD TFT touch screen with an ESP32 development board, offering WiFi and Bluetooth capabilities. It is designed for various IoT applications, smart devices, and educational projects, compatible with Arduino development environments.

2. Key Features
- Low-power dual-core 32-bit CPU (up to 240MHz, 600 DMIPS).
- Built-in 520 KB SRAM.
- Support for various interfaces: UART, SPI, I2C, PWM, ADC, DAC.
- Compatibility with OV2640 and OV7670 cameras, including built-in flash.
- WiFi image upload and TF card support (up to 4GB).
- Multiple sleep modes for power efficiency.
- Embedded Lwip and FreeRTOS operating systems.
- Supports STA/AP/STA+AP working modes.
- Smart Config/AirKiss one-click network configuration.
- Designed for secondary development, compatible with Arduino.
3. Package Contents
Verify that all items are present in your package:
- ESP32 2.8-inch Display Module
- Micro-USB Cable
- Stylus
- Jumper Wires (may vary by bundle)
- Protective Plastic Box (for the board)

4. Hardware Overview
Familiarize yourself with the components and interfaces of the ESP32 2.8-inch Display Module.

- ESP-32: The main microcontroller unit, providing WiFi and Bluetooth connectivity.
- RGB LED: Programmable multi-color LED for status indication.
- Extended IO: General Purpose Input/Output pins for connecting external sensors and actuators.
- Temperature and humidity interface: Dedicated pins for connecting compatible sensors.
- TF: MicroSD card slot for data storage (up to 4GB).
- Micro-USB: For power supply and data communication (programming).
- 4P 1.25 Power supply base: Alternative power input.
- Speak: Audio output interface.
- RESET: Button to reset the ESP32 module.
- BOOT: Button used for entering bootloader mode for flashing firmware.

5. Setup Instructions
5.1. Initial Power-Up
- Connect the Micro-USB cable to the Micro-USB port on the module.
- Connect the other end of the USB cable to a 5V power source (e.g., computer USB port, USB wall adapter).
- The display should light up, and a default demonstration program may start running.
5.2. Development Environment Setup (for Arduino IDE)
To program the ESP32 module using the Arduino IDE, follow these steps:
- Install Arduino IDE: Download and install the latest version of the Arduino IDE from the official Arduino website.
- Add ESP32 Board Manager URL:
- Go to File > Preferences.
- In the "Additional Boards Manager URLs" field, add:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - Click OK.
- Install ESP32 Boards:
- Go to Tools > Board > Boards Manager.
- Search for "ESP32" and install the "esp32 by Espressif Systems" package.
- Select Board: Go to Tools > Board and select the appropriate ESP32 board (e.g., "ESP32 Dev Module" or "ESP32 Wrover Module").
- Install Libraries: Depending on your project, you may need to install specific libraries for the display (ILI9341 driver), touch screen, WiFi, and Bluetooth. Use the Library Manager (Sketch > Include Library > Manage Libraries) to search and install necessary libraries.
5.3. Connecting Peripherals
Refer to the Hardware Overview (Figure 3) for pin locations when connecting external components.
- TF Card: Insert a MicroSD card into the TF card slot for data logging or storing display assets.
- External Sensors/Actuators: Connect to the Extended IO pins as per your project requirements. Ensure proper voltage levels and current limits.
- Temperature and Humidity Sensor: Connect compatible sensors to the dedicated interface.
- Speaker: Connect a small speaker to the 'Speak' interface for audio output.
6. Operation
6.1. Uploading Code
- Connect the module to your computer via Micro-USB.
- In the Arduino IDE, select the correct board (Tools > Board) and COM port (Tools > Port).
- Write or open your Arduino sketch.
- Click the "Upload" button (right arrow icon) to compile and upload the code to the ESP32 module.
- If uploading fails, try holding down the BOOT button while pressing and releasing the RESET button, then release BOOT. This puts the ESP32 into flashing mode.
6.2. Using the Touch Screen
The module features a resistive touch screen. Use the provided stylus or a similar blunt object for interaction. Avoid using sharp objects to prevent damage.
6.3. WiFi and Bluetooth Functionality
The ESP32's integrated WiFi and Bluetooth capabilities can be utilized through appropriate libraries in your code. Refer to ESP32 documentation and examples for network configuration (STA/AP modes) and Bluetooth communication (BLE/BR/EDR).
7. Maintenance
- Cleaning: Use a soft, dry cloth to clean the display and module. Avoid abrasive cleaners or solvents.
- Storage: Store the module in its protective plastic box in a dry, cool environment, away from direct sunlight and extreme temperatures.
- Firmware Updates: Regularly check for updates to the ESP32 Arduino core and relevant libraries to ensure optimal performance and access to new features.
8. Troubleshooting
| Problem | Possible Cause | Solution |
|---|---|---|
| Module does not power on. | No power, faulty USB cable, or incorrect voltage. | Ensure USB cable is securely connected. Try a different USB cable or power source. Verify power source is 5V. |
| Code upload fails. | Incorrect board/port selection, driver issues, or module not in flashing mode. | Select the correct ESP32 board and COM port in Arduino IDE. Install necessary USB drivers. Try manually putting the ESP32 into flashing mode (hold BOOT, press/release RESET, then release BOOT). |
| Display shows nothing or incorrect output. | Incorrect display library, wiring issues, or software error. | Ensure the correct display library (e.g., for ILI9341) is installed and configured in your code. Double-check any external wiring. Review your code for display initialization errors. |
| Touch screen unresponsive. | Incorrect touch screen library, calibration issues, or physical damage. | Verify the touch screen library is correctly implemented. Perform touch screen calibration if supported by your library. Inspect for physical damage. |
| WiFi/Bluetooth not working. | Incorrect library usage, antenna issues, or environmental interference. | Ensure WiFi/Bluetooth libraries are correctly used and initialized. Check for strong signal. Avoid placing the module near sources of interference. |
9. Technical Specifications
| Feature | Detail |
|---|---|
| CPU | Low-power dual-core 32-bit, up to 240MHz, 600 DMIPS |
| SRAM | 520 KB (internal) |
| SPI Flash | Default 32Mbit |
| Working Voltage | 4.75-5.25V |
| Display Size | 2.8 inch |
| Resolution | 240*320 TFT LCD |
| Display Driver | ILI9341 |
| Wireless Connectivity | Wi-Fi 802.11b/g/n/e/i, Bluetooth 4.2 BR/EDR & BLE |
| Supported Interfaces | UART, SPI, I2C, PWM, ADC, DAC |
| TF Card Support | Up to 4GB |
| IO Ports | 9 |
| Antenna | Onboard PCB antenna, 2dBi gain |
| Image Output Formats | JPEG (OV2640 only), BMP, GRAYSCALE |
| Security | WPA/WPA2/WPA2-Enterprise/WPS |
| Working Temperature | -20 ℃ to 70 ℃ |
| Storage Environment | -40 ℃ to 125 ℃, <90%RH |
10. User Tips
- Jumper Wires: For connecting external components, consider purchasing a set of jumper wires with connectors separately, as they may not be included in all bundles.
- Protective Packaging: The module is typically shipped in a protective plastic box. Keep this box for safe storage when the module is not in use.
- Community Support: The ESP32 ecosystem has a large and active community. Utilize online forums, documentation, and example projects for assistance with development and troubleshooting.
11. Warranty and Support
For technical support, documentation, and community resources related to the ESP32 platform, please refer to the official Espressif Systems documentation and the Arduino ESP32 community forums.
For product-specific inquiries or issues, please contact the seller directly through the platform where the purchase was made. Keep your purchase records handy for any warranty claims.