接口说明​

产品尺寸​

• 搭配树莓派使用教程
• 搭配树莓派 Pico 使用教程

搭配树莓派使用教程​

硬件连接​

示例使用​

开启 SPI 跟 I2C 接口​

1. 打开树莓派终端，输入以下指令进入配置界面

   sudo raspi-config
   
2. 选择 Interfacing Options -> SPI -> Yes 开启 SPI 接口
3. 选择 Interfacing Options -> I2C -> Yes 开启 I2C 接口
4. 请确保 SPI 没有被其他的设备占用，你可以在/boot/config.txt 中间检查

安装库​

git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v

Python​

python2​

sudo apt-get update
sudo apt-get install python-pip
sudo apt-get install python-pil
sudo apt-get install python-numpy
sudo pip install RPi.GPIO
sudo pip install smbus
sudo pip install spidev

python3​

sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install python3-pil
sudo apt-get install python3-numpy
sudo pip3 install RPi.GPIO
sudo pip3 install smbus
sudo pip3 install spidev

下载测试程序​

打开树莓派终端，执行：

sudo apt-get install unzip -y
cd ~
sudo wget https://www.waveshare.net/w/upload/9/9a/1.83inch_Touch_LCD_RPI.zip
sudo unzip ./1.83inch_Touch_LCD_RPI.zip
cd 1.83inch_Touch_LCD_RPI

运行测试程序​

C 语言​

cd ~
cd 1.83inch_Touch_LCD_RPI/c
sudo make clean
sudo make -j
sudo ./main

python​

cd ~
cd 1.83inch_Touch_LCD_RPI/python/example
sudo python 1inch83_LCD_test.py

运行效果​

• 屏幕正常点亮

搭配树莓派 Pico 使用教程​

硬件连接​

Windows 环境下​

1. 下载示例程序，解压后进入 1.83inch_Touch_LCD_Pico 的文件夹中。
2. 进入 1.83inch_Touch_LCD_Pico 后，使用 vs code 打开工程
3. 选择编译器
4. 开始编译
5. 编译完成
6. 将 build 中的 main.uf2 文件拷贝带 Pico 中，就会自动运行程序了

运行效果​

• 屏幕正常点亮

配置 ESP-IDF 开发环境​

安装 ESP-IDF 开发环境​

1. 前往 ESP-IDF Installation Manager 下载 ESP-IDF 安装管理器。这是乐鑫最新推出的跨平台安装工具，下文将演示如何使用其离线安装功能。

   在页面中点击 Offline Installer 标签，然后在筛选栏中选择 Windows 操作系统和你要安装的版本。

   
   

   确认选择无误后，点击下载按钮。浏览器将自动同时下载两个文件：一个是 ESP-IDF 离线整合包(.zst)，另一个是 ESP-IDF 安装器(.exe)。

   
   

   请耐心等待两个文件下载完成。

2. 下载完成后，双击运行 ESP-IDF 安装器(eim-gui-windows-x64.exe)。

   启动后，可在右上角将界面语言切换为中文。

   
   

   安装工具会自动检测同一目录下是否存在离线整合包。点击 从存档安装。

   
   

   接下来，选择安装路径。建议使用默认路径；若需自定义，请确保路径中不包含中文或空格。确认无误后，点击 开始安装。

   
   

3. 当看到如下界面时，表示 ESP-IDF 已安装成功。

   
   

4. 建议同时安装驱动程序。点击 完成安装，然后点击 安装驱动程序。

   
   

安装 Visual Studio Code 与 ESP-IDF 扩展​

1. 下载并安装 Visual Studio Code。

2. 安装时建议勾选 通过 Code 打开操作添加到 Windows 资源管理器文件上下文菜单,以便快速打开项目文件夹。

3. 在 VS Code 中,点击侧边活动栏中的  扩展图标(或使用快捷键 Ctrl + Shift + X)打开 扩展 视图。

4. 在搜索框中输入 ESP-IDF,找到 ESP-IDF 扩展并点击安装。

   
   

5. 当 ESP-IDF 扩展版本 ≥ 2.0 时,扩展会自动检测并识别上述步骤中安装的 ESP-IDF 环境,无需手动配置。

示例程序​

01_ESP32S3_test​

程序说明​

• 本示例演示了如何基于 ESP32-S3 开发板驱动 1.83inch Touch LCD Module 触控液晶模组，既实现了颜色循环测试与触摸功能测试，又预留了基于 LVGL 图形库的图片显示能力，支持通过左滑、右滑手势完成图片切换操作。

硬件连接​

• 通过 GH1.25 12PIN 杜邦线将屏幕和开发板连接
• 将开发板接入电脑

代码分析​

• image_slider_init()：

  • 基于 LVGL v9.3.0 图形库实现左滑、右滑手势识别及图片切换，为用户提供流畅的图片浏览体验。

• app_main()：

  • 完成显示屏、触摸屏与 LVGL 图形库的初始化，实现颜色循环测试与触摸基础功能验证，为后续图形交互应用奠定运行基础。

运行效果​

• LCD 颜色循环测试：

• LCD 触摸测试：

  
  

• LVGL 图片切换测试：

  
  

配置开发环境​

1. 安装和配置 Arduino IDE​

请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。

2. 安装库​

• 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。若库安装要求离线安装，则必须使用提供的库文件。
• 对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
• 可从 此链接 的 Arduino 目录中，下载 1.83inch_Touch_LCD_Module 开发板的示例程序包。包内的 Arduino-uno\libraries 目录已包含本教程所需的全部库文件。

安装步骤：

1. 下载 示例程序包。

2. 将其 Arduino-uno\libraries 目录下的所有文件夹（GFX_Library_for_Arduino）复制到 Arduino 的库文件夹中。

   信息

   Arduino 库文件夹的路径通常是：c:\Users\<用户名>\Documents\Arduino\libraries。

   也可以在 Arduino IDE 中通过 文件 > 首选项，查看“项目文件夹位置”来定位。库文件夹就是此路径下的 libraries 文件夹。

3. 其他安装方式请参考：Arduino 库管理教程。

1.83inch Touch LCD Module 所需开发板安装说明

示例程序​

Arduino-uno 示例程序位于 示例程序包 的 Arduino-uno 目录中。

01_Arduino_Uno_test​

程序说明​

• 本示例基于 GFX_Library_for_Arduino 驱动 ST7789 屏幕，实现文字显示、颜色循环测试及触摸测试功能。

硬件连接​

• 通过 GH1.25 12PIN 杜邦线将屏幕和开发板连接
• 将开发板接入电脑

代码分析​

• setup()：

  • 初始化串口、ST7789 显示屏（含背光）与 CST816D 触摸芯片；执行文字显示、颜色循环测试，验证显示基础功能。

• loop()：

  • 循环读取触摸坐标，串口打印并在触摸位置绘制红点，实现触摸可视化反馈（10ms 间隔保证实时性）。

• LCD_display_test()：

  • 屏幕依次填充红 / 绿 / 蓝 / 白四色（各 1 秒），验证显示屏色彩与全屏刷新功能。

运行效果​

• LCD 颜色循环测试：

• LCD 触摸测试：

  
  

硬件连接​

示例程序​

1. 点击此处下载程序，解压后，打开 1.83inch Touch LCD STM32/MDK-ARM 目录下的 LCD_demo.uvprojx，即可看到程序。
2. 打开 LCD_1inch83_test.c，可以看到程序说明介绍，重新编译下载即可。

运行效果​

• 屏幕正常点亮

技术支持

周一-周五（9:30-6:30）周六（9:30-5:30）

手机：13434470212

邮箱：services04@spotpear.cn

QQ：202004841