3.5inch Capacitive Touch LCD
来自Waveshare Wiki
| |||||||||||||||||||||||||
| |||||||||||||||||||||||||
说明
产品参数
(请保证供电电压和逻辑电压一致,否则会导致无法正常工作)
名称 | 参数 |
---|---|
供电电压 | 3.3V/5V |
屏幕类型 | IPS |
通信接口 | Display:SPI |
Touch:I2C | |
控制芯片 | Display:ST7796S |
Touch:FT6336U | |
分辨率 | 320(H) x 480(V) |
显示尺寸 | 49.56(H) x 74.04(V) mm |
像素间距 | 0.051 x 0.153 mm |
产品尺寸 | 61.00(H) x 92.44(V) mm |
接口说明
GH1.25-15PIN接口
序号 | 引脚 | 功能 |
---|---|---|
1 | VCC | 输入电源5V/3.3V, 请保证供电电压和逻辑电压一致,否则会导致无法正常工作。 |
2 | 3V3 | 输入电源3.3V |
3 | GND | 电源地 |
4 | MISO | SPI主机输入从机输出引脚(本设备为从设备) |
5 | MOSI | SPI主机输出从机输入引脚(本设备为从设备) |
6 | SCLK | SPI时钟引脚 |
7 | SD_CS | SD片选引脚,低电平有效 |
8 | LCD_CS | LCD片选引脚,低电平有效 |
9 | LCD_DC | LCD数据和命令控制切换引脚,高电平为数据,低电平为命令 |
10 | LCD_RST | LCD复位引脚,低电平有效 |
11 | LCD_BL | LCD背光引脚,使用PWM调节占空比进行控制 |
12 | TP_SDA | Touchpad I2C数据引脚 |
13 | TP_SCL | Touchpad I2C时钟引脚 |
14 | TP_INT | Touchpad中断引脚,有手指触摸时,触发中断 |
15 | TP_RST | Touchpad复位引脚,低电平有效 |
FPC0.5-18PIN接口
序号 | 引脚 | 功能 |
---|---|---|
1 | VCC | 输入电源5V/3.3V, 请保证供电电压和逻辑电压一致,否则会导致无法正常工作。 |
2 | LCD_BL | LCD 背光引脚,使用PWM调节占空比进行控制 |
3 | GND | 电源地 |
4 | SLCK | SPI时钟引脚 |
5 | MOSI | SPI主机输出从机输入引脚(本设备为从设备) |
6 | MISO | SPI主机输入从机输出引脚(本设备为从设备) |
7 | LCD_DC | LCD 数据和命令控制切换引脚,高电平为数据,低电平为命令 |
8 | LCD_RST | LCD 复位引脚,低电平有效 |
9 | LCD_CS | LCD 片选引脚,低电平有效 |
10 | SD_CS | SD 片选引脚,低电平有效 |
11 | NC | 悬空,内部无连接 |
12 | TP_RST | Touchpad 复位引脚,低电平有效 |
13 | TP_SCL | Touchpad I2C时钟引脚 |
14 | TP_SDA | Touchpad I2C数据引脚 |
15 | TP_INT | Touchpad 中断引脚,有手指触摸时,触发中断 |
16 | NC | 悬空,内部无连接 |
17 | NC | 悬空,内部无连接 |
18 | NC | 悬空,内部无连接 |
ESP32 S3使用教程
硬件连接(GH1.25-15PIN接口)
序号 | LCD引脚 | ESP32 S3 |
---|---|---|
1 | VCC | NC |
2 | 3V3 | 3V3 |
3 | GND | GND |
4 | MISO | 42 |
5 | MOSI | 2 |
6 | SCLK | 1 |
7 | SD_CS | 38 |
8 | LCD_CS | 39 |
9 | LCD_DC | 41 |
10 | LCD_RST | 40 |
11 | LCD_BL | 6 |
12 | TP_SDA | 15 |
13 | TP_SCL | 7 |
14 | TP_INT | 17 |
15 | TP_RST | 16 |
Arduino环境
环境搭建
- 下载Arduino IDE并安装。
- 安装完成后打开 Arduino IDE。
- 进入开发板管理器,搜索 esp32 ,在下方的 esp32 by Espressif Systems 中选择 3.0.2 版本并点击安装。(若不能正常安装可使用手机热点尝试)
- 安装完成重启 Arduino IDE 即可使用。
若安装失败
- 安装 3.0.2 版本失败
- 下载资源文件
链接: https://pan.baidu.com/s/1ppl7ZU2NSTY_TfFzs1pDWA 提取码: 0755
- 从资源管理器按路径 “c:\Users\Waveshare\AppData\Local\Arduino15\staging\packages” 进入(其中 Waveshare 为计算机用户名,需要开启显示隐藏文件)
- 将上方下载的文件解压至 packages 文件夹下
- 重新执行安装操作
- 安装完成重启 Arduino IDE 即可使用
示例程序
- 下载示例程序。
- 打开示例程序,3.5inch_Capacitive_Touch.ino。
- 进入 File -> Preferences。
- 保存当前项目文件夹地址,以便后续切换项目时恢复。
- 将项目文件夹地址设置为 3.5inch_Capacitive_Touch.ino 文件的上一级目录,并勾选 "Show files inside Sketches" 选项。
- 配置开发板信息。
- 将TF卡插入电脑,并格式化为FAT格式后再插入设备的TF卡槽(如果没有TF卡可忽略此步骤)。
- 编译并烧录示例程序。
- 成功烧录后,可以对屏幕进行触摸操作。
- 断电并将TF卡插入电脑,可以看到TF卡有HELLO.TXT文件。(如果没有TF卡可忽略此步骤)
ESP-IDF环境
环境搭建
以下开发系统默认为Windows,推荐使用VSCode插件进行开发。
- 打开VSCode官网的下载页面,选择对应系统和系统位数进行下载。
- 运行安装包后,其余均可以默认安装,但这里为了后续的体验建议,建议在此处勾选框中的1、2、3项
- 第一二项开启后,可以直接通过鼠标右键文件或者目录打开VSCode,可以提高后续的使用体验。
- 第三项开启后,选择打开方式时,可以直接选择VSCode。
- 打开VSCode,使用快捷键 Shift+Ctrl+X ,进入插件管理器。
- 在搜索栏中,输入 Espressif IDF ,选择对应的插件点击 install即可。
- 使用快捷键 F1 ,输入:
esp-idf: configure esp-idf extension
- 选择express(此教程针对第一次安装的用户,故只讲述初次的通用安装教程)
- 选择下载服务器,我们推荐国内用户使用Espressif作为你的下载服务器。
- 选择想要现在的ESP-IDF版本,我们选择V5.1.1。
- 下面两个分别为ESP-IDF容器安装地址和ESP-IDF所需的工具安装地址。
- 注意:如果之前有安装过ESP-IDF,或者失败过的,请务必彻底删除文件或者创建全新的无中文路径。
- 配置完成后,点击 install 进行下载。
- 进入下载页面,其会自动安装对应工具与环境,稍等片刻即可。
- 安装完成后,会进入以下界面,说明安装完成。
示例程序
- 下载示例程序
- 打开vscode,并打开3.5inch_Capacitive_Touch_LCD/ESP32_S3/esp-idf/test文件夹
- 按下快捷键F1,并输入
ESP-IDF:ADD vscode Configuration Folder
- 选择端口号,并进行编译上传程序
Arduino UNO使用教程
硬件连接(GH1.25-15PIN接口)
序号 | LCD引脚 | Arduino UNO |
---|---|---|
1 | VCC | 5V |
2 | 3V3 | NC |
3 | GND | GND |
4 | MISO | 12 |
5 | MOSI | 11 |
6 | SCLK | 13 |
7 | SD_CS | 10 |
8 | LCD_CS | 9 |
9 | LCD_DC | 8 |
10 | LCD_RST | 7 |
11 | LCD_BL | 6 |
12 | TP_SDA | SDA |
13 | TP_SCL | SCL |
14 | TP_INT | 3 |
15 | TP_RST | 2 |
Arduino环境
示例程序
- 解压并打开lcd_touch_example.ino。
- 进入 File -> Preferences。
- 保存当前项目文件夹地址,以便后续切换项目时恢复。
- 将项目文件夹地址设置为 lcd_touch_example.ino 文件的上一级目录,并勾选 "Show files inside Sketches" 选项。
- 选择设备与端口,编译并烧录程序。
Raspberry Pi Pico使用教程
硬件连接(GH1.25-15PIN接口)
序号 | LCD引脚 | Raspberry Pi Pico |
---|---|---|
1 | VCC | NC |
2 | 3V3 | 3V3 |
3 | GND | GND |
4 | MISO | 12 |
5 | MOSI | 11 |
6 | SCLK | 10 |
7 | SD_CS | NC |
8 | LCD_CS | 9 |
9 | LCD_DC | 14 |
10 | LCD_RST | 13 |
11 | LCD_BL | 5 |
12 | TP_SDA | 20 |
13 | TP_SCL | 21 |
14 | TP_INT | 17 |
15 | TP_RST | 3 |
Python环境
环境搭建
- 安装Thonny(Thonny安装包)
- 按住Raspberry Pi Pico的“BOOTSEL”键,然后上电,上电后松开
- 电脑会出现一个新的盘符,将固件(Raspberry Pi Pico固件)解压,并将固件(后缀为uf2)拷贝至该磁盘(拷贝成功磁盘会自动消失)
- 打开Thonny,点击右下方的“Python x.x.x”,选择“Configure interpreter”
- 在弹出窗口中选择“解释器”->解释器选择“MicroPython(Raspbeery Pi Pico)”->端口选择“自动探测端口”
- 点击暂停,Shell窗口出现“MicroPython v1.20.0-50-g786013d46 on 2023-05-04; Raspberry Pi Pico with RP2040 Type "help()" for more information.”即为连接成功
- 在下方输入1+1并回车,输出2表示连接成功
示例程序
- 解压示例程序。
- 按快捷键Ctrl+O 或 File->Open ,打开3.5inch_Capacitive_Touch_LCD/RaspberryPi_Pico/Pico/lcd_touch_example.py。
- 点击运行。
Raspberry Pi使用教程
硬件连接(GH1.25-15PIN接口)
序号 | LCD引脚 | Raspberry Pi(BCM) |
---|---|---|
1 | VCC | NC |
2 | 3V3 | 3V3 |
3 | GND | GND |
4 | MISO | NC |
5 | MOSI | 10 |
6 | SCLK | 11 |
7 | SD_CS | NC |
8 | LCD_CS | 8 |
9 | LCD_DC | 25 |
10 | LCD_RST | 27 |
11 | LCD_BL | 18 |
12 | TP_SDA | 2 |
13 | TP_SCL | 3 |
14 | TP_INT | 4 |
15 | TP_RST | 17 |
开启SPI和I2C接口
- 打开 Raspberry Pi的终端,并输入以下指令
sudo raspi-config
- Interfacing Options -> SPI -> Yes,开启SPI接口
- 继续进入配置界面:
sudo raspi-config
- Interfacing Options -> I2C -> Yes,开启I2C接口
- 重启Raspberry Pi
sudo reboot
- 查看SPI是否开启成功
ls /dev/spi*
- 查看I2C是否开启成功
ls /dev/i2c*
C环境
安装WiringPi库
- 下载WiringPi源码
git clone https://github.com/WiringPi/WiringPi
- 编译并安装
cd WiringPi ./build
- 查看版本号,出现版本号则说明安装成功
gpio -v
示例程序
- 下载示例程序
cd wget https://www.waveshare.net/w/upload/0/07/3.5inch_Capacitive_Touch_LCD_RaspberryPi.zip
- 解压并进入3.5inch_Capacitive_Touch_LCD/C 文件夹
unzip 3.5inch_Capacitive_Touch_LCD_RaspberryPi.zip -d ./3.5inch_Capacitive_Touch_LCD cd 3.5inch_Capacitive_Touch_LCD/C
- 清除编译文件
sudo make clean
- 编译程序
sudo make
- 运行程序
sudo ./main
Python环境
示例程序
- 下载示例程序
cd wget https://www.waveshare.net/w/upload/0/07/3.5inch_Capacitive_Touch_LCD_RaspberryPi.zip
- 解压并进入3.5inch_Capacitive_Touch_LCD/Python 文件夹
unzip 3.5inch_Capacitive_Touch_LCD_RaspberryPi.zip -d ./3.5inch_Capacitive_Touch_LCD cd 3.5inch_Capacitive_Touch_LCD/Python
- 运行示例程序
python3 lcd_touch_example.py