Specifications​

Mechanical Switch Specifications​

LCD Interface Description​

SPI Control Interface Description​

Key Dimensions​

Key Module Dimensions​

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

• ESP-IDF Getting Started
• Setting Up Development Environment
• Example

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.

• Section 1: Environment Setup
• Section 2: Running Examples
• Section 3: Creating a Project
• Section 4: Using Components
• Section 5: Debugging
• Section 6: FreeRTOS
• Section 7: Peripherals
• Section 8: Wi-Fi Programming
• Section 9: BLE Programming

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 Development Environment​

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 choose your desired version from the filter bar.

   
   

   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  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.

Hardware Connection​

Example​

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

01_WoodenFish​

Example Description​

• This example demonstrates how to drive the 0.85inch ScreenKey Module with an ESP32‑S3 development board. It implements a color‑cycle test and button function test, while also providing image display capability based on the LVGL graphics library. The dynamic "wooden fish" knock effect can be triggered by single‑click, double‑click, or long‑press actions.

Hardware Connection​

• Connect the screen to the development board using a GH1.25 9PIN cable
• Connect the development board to the computer

Code Analysis​

• app_main():
  • Initializes the display, button, and LVGL graphics library, then implements the color‑cycle test and the "wooden fish" knock effect, laying the runtime foundation for subsequent graphical interactive applications.

Operation Result​

• LCD Color Cycle Test:

  
  

• LVGL "Wooden Fish" effect:

02_phototest​

Example Description​

• This example demonstrates how to drive the 0.85inch ScreenKey Module with an ESP32‑S3 development board, implementing image switching on button press.

Hardware Connection​

• Connect the screen to the development board using a GH1.25 9PIN cable
• Connect the development board to the computer

Code Analysis​

• app_main():

  • Initializes the display, button, and LVGL graphics library, implementing image switching on button press.

Operation Result​

• LCD Color Cycle Test:

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

• Arduino Getting Started
• Setting Up Development Environment
• Example

Arduino Getting Started​

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

• Section 0: Getting to Know ESP32
• Section 1: Installing and Configuring Arduino IDE
• Section 2: Arduino Basics
• Section 3: Digital Output/Input
• Section 4: Analog Input
• Section 5: Pulse Width Modulation (PWM)
• Section 6: Serial Communication (UART)
• Section 7: I2C Communication
• Section 8: SPI Communication
• Section 9: Wi-Fi Basics
• Section 10: Web Server
• Section 11: Bluetooth
• Section 12: LVGL GUI Development
• Section 13: Comprehensive Project

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 Development Environment​

1. Installing and Configuring Arduino IDE​

Please refer to the tutorial Installing and Configuring 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: Install Online and Install Offline. If the library installation requires Install Offline, you must use the provided library file.
• 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.

Installation Steps:

1. Download the example package.

   INFO

   The path to the Arduino libraries folder is typically: c:\Users\<username>\Documents\Arduino\libraries.

   You can also locate it in the Arduino IDE by going to File > Preferences and checking the "Sketchbook location". The libraries folder is the libraries subfolder within this path.

2. For other installation methods, please refer to: Arduino Library Management Tutorial.

Board Installation Instructions for 0.85inch ScreenKey Module

Hardware Connection​

Example​

The Arduino_Uno_test demo is located in the Arduino-uno directory of the example package.

01_Arduino_Uno_test​

Example Description​

• This example implements automatic screen self-test on power‑up. The button can be used to cycle through 7 display effects (solid colors, images, Chinese/English text, graphic drawing), demonstrating the LCD display and button interaction functions.

Hardware Connection​

• Connect the screen to the development board using a GH1.25 9PIN cable
• Connect the development board to the computer

Code Analysis​

• setup():

  • Initializes hardware, LCD, and canvas; performs a startup display self‑test; initializes the button.

• loop():

  • Main system loop, continuously calls the button detection function.

• CheckKeyPress():

  • Debounced button detection; cycles through 7 LCD display modes according to the number of button presses.

Operation Result​

• Automatic screen self‑test on power‑up; pressing the button cycles through 7 display effects (solid colors, images, Chinese/English text, graphic drawing), demonstrating LCD display and button interaction.

  
  

1. Hardware Resources​

• Schematic
• LCD Manual

2. Example​

• 0.85inch ScreenKey Module Demo (Github )

3. Software​

• Chinese Character Conversion Software
• mage2Lcd Image Bitmap Conversion Software
• Flash_download_tool

4. Other Resource Links​

• LVGL Online Image Converter
• LVGL Online Font Converter
• ESP32 Arduino Core's documentation
• arduino-esp32
• ESP-IDF

Support

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

Email: services01@spotpear.com