ESP32-S3-Touch-AMOLED-1.75

ESP32-S3 development board with a 1.75-inch 466 × 466 QSPI AMOLED touch display

简体中文 · 🌐 Product Page · 📚 Product Documentation · 📦 Firmware Releases · 🚀 Getting Started · 🧩 ESP-IDF Examples · 🔧 Arduino Examples

This repository provides example software, reproducible release firmware, the source-maintained Brookesia application firmware, a complete factory recovery image, schematics, and bilingual user documentation for the Waveshare ESP32-S3-Touch-AMOLED-1.75.

The board combines an ESP32-S3R8 with a high-resolution round AMOLED display, two-point capacitive touch, motion sensing, power and battery management, a real-time clock, dual-microphone audio, speaker output, and microSD storage in a compact platform.

Check the official product page for the contents and options supplied with each variant. Examples that require GNSS do not apply to the standard or -B variant.

See Hardware Reference for the GPIO map, I2C addresses, audio and SD buses, expansion header, and shared-resource notes.

Choose the firmware form that matches the task:

1. Download the required *-combined.zip from the latest release.
2. Extract the archive and install esptool with python -m pip install esptool.
3. Connect the board with a USB data cable.
4. Run flash_combined.bat COMx on Windows or ./flash_combined.sh /dev/ttyACM0 on Linux.
5. Reset the board if it does not restart automatically.

Do not mix a release example, the factory image, or split binaries from different packages. The factory image has its own verified command and checksum in the Firmware Delivery Guide. A normal update does not require erasing flash.

The source-maintained factory application provides thirteen round-screen applications:

• SquareLine, Calculator, DrawPanel, and Crosshair.
• SpecAnalyzer and Recorder using the ES7210 dual-microphone input.
• MusicPlayer, Gallery, and VideoPlayer using the microSD card.
• Settings with live AXP2101 battery information, native Wi-Fi state, storage diagnostics, and safe eject.
• AIChats with optional text-history storage and Gravitysphere driven by the QMI8658 IMU.
• Button Test with direct PWR/EXIO4 and BOOT/GPIO0 level diagnostics.

The status bar follows live battery and Wi-Fi state. The media applications, generated fixture formats, FFmpeg commands, privacy notes, and SD-card layout are documented in the Media Production Guide.

Bundled Arduino libraries live under examples/arduino/libraries. Their upstream samples are dependencies, not first-party product firmware targets. See the complete Example Catalog.

The Build Examples workflow runs two discovery jobs and 20 build/package jobs for the current source tree. The historical v1.0.1 release predates 10_Touch_CST9217 and contains 19 firmware packages. See Continuous Integration for the matrix and release gate.

• Documentation Index
• Getting Started
• Hardware Reference
• Example Catalog
• Troubleshooting
• Firmware and Factory Recovery
• Firmware Delivery Guide
• Media Production Guide
• Brookesia Source Firmware
• Hardware Validation
• Firmware Component Guide
• Repository Structure
• Continuous Integration
• Components
• Release Tools
• Changelog
• Official Product Documentation
• Official Resources
• Official FAQ
• Official Technical Support

Contributions and reproducible issue reports are welcome. Include the board variant, example path, framework version, reproduction steps, expected and actual behavior, and the smallest relevant log excerpt. Remove Wi-Fi credentials, tokens, conversation content, local paths, serial numbers, MAC addresses, and other private or customer-specific data before publishing logs or screenshots.

• Contributing Guide / 贡献指南
• Support / 技术支持
• Security Policy / 安全策略
• Open an Issue

This repository is licensed under the Apache License 2.0. See LICENSE.