3.5inch RPi LCD (C)

来自Waveshare Wiki
跳转至: 导航搜索

说明

3.5inch-RPi-LCD-C
{{{name2}}}
{{{name3}}}
功能简介
特性 3.5寸树莓派电阻屏 提供驱动
分辨率 480x320
适用范围 兼容任何版本的树莓派
' 无特性,不解释
' 无特性,不解释
接口 RPi I/Os

视频

产品特点

  • 硬件分辨率为480x320
  • 电阻式触摸控制
  • 兼容并可直接插入任何版本的树莓派
  • 支持125MHz高速SPI信号传输,显示清晰稳定
  • 提供驱动(支持Raspbian\Ubuntu\Kali和Retropie系统)
  • 支持FBCP软件驱动,可设置软件分辨率和双屏显示
  • 和你的树莓派一样大
  • 沉金工艺,精雕细琢

快速入门

硬件连接

连接GPIO接口,Raspberry Pi引出了40个GPIO管脚,而屏幕引出了26个管脚,连接时注意对应屏幕管脚和树莓派管脚。

您可以通过两种方法使用该LCD:方法一,给Raspbian/Ubuntu Mate/Kali和Retropie系统安装驱动。方法二,使用预装驱动的镜像。

方法一,安装驱动

请在树莓派官网下载bullseye 32bit版本的镜像。为了方便使用,这里提供Raspbian镜像

1) 将镜像文件下载到电脑上,并解压得到.img文件。

2) 将TF卡连接到电脑,打开Win32DiskImager.exe软件,选择第1步准备的.img文件,点击write烧写镜像。烧写完成后,安全弹出TF卡。

3) 将TF卡接入到树莓派上,并启动树莓派,登录树莓派的终端(可以将树莓派接到HDMI显示器或用ssh远程登录)。

4) 先通过网络下载相关驱动代码,在执行相应的安装命令,在整个过程中确保可以正常联网

git clone https://github.com/waveshare/LCD-show.git
cd LCD-show/
sudo ./LCD35C-show

重启后即可使用(为了方便使用,可以调整屏幕显示方向,参见#设置显示方向)。

注意1:执行apt-get upgrade会导致LCD无法正常工作。此时需要编辑SD卡中的 config.txt 文件,并删除这一句:dtoverlay=ads7846。

注意2:在Raspbian-lite下,需要执行sudo ./LCD35C-show lite命令,以安装驱动。

对于Bullseye 64bit系统和Bookworm系统,需要手动配置,方法如下: 3.5inch RPi LCD (C) 手动配置

方法二,使用预装驱动的镜像

这里提供预装驱动的镜像,解压并把镜像写入到TF卡中(打开Win32DiskImager.exe软件,选择.img文件,点击「write」烧写镜像)。然后把卡插入树莓派就可以使用了。

系统名称 版本 支持的树莓派版本 默认帐号\密码 下载地址
Debian 2024-03-15-raspios-bookworm-armhf.img 树莓派5代 \ 树莓派4代 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Debian 2024-03-15-raspios-bookworm-armhf-lite.img 树莓派4代 \ 树莓派3代 \ 树莓派2代 \ 树莓派0代 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Debian 2024-07-04-raspios-bookworm-arm64-lite.img 任何版本的树莓派 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Raspbian 2020-08-20-raspios-buster-armhf-full 任何版本的树莓派 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Ubuntu ubuntu-mate-16.04.2 树莓派3代 \ 树莓派2代 user: pi \ password: 123 百度云盘 提取码:7igp
Kali 2018.4-rpi3-nexmon 树莓派3代B+ \ 树莓派3代 \ 树莓派2代 user: root \ password: toor 百度云盘 提取码:9piw

设置显示方向

安装完触摸驱动后,可以通过运行以下命令修改屏幕旋转方向。

cd LCD-show/
#X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。
sudo ./LCD35C-show X

在Raspbian-lite下的旋转命令如下:

cd LCD-show/
#X可选0、90、180和270。分别表示LCD旋转0度、90度、180度和270度。
sudo ./LCD35C-show lite X

安装校准软件进行校准

  • 本LCD可以通过xinput-calibrator程序进行校准。
  • 运行以下命令,进行安装:
sudo apt-get install xinput-calibrator
  • 点击任务栏的Menu键,选择Preferences -> Calibrate Touchscreen。
  • 按显示提示进行触摸校准。
  • 如果要保存这些触摸值,需要在以下路径新建一个99-calibration.conf文件(如果已存在则不需要新建)
   /etc/X11/xorg.conf.d/99-calibration.conf
  • 将触摸参数(不同LCD,下图数据可能不同)保存至99-calibration.conf,即可

5inch HDMI LCD FAQ1.jpg

使用GPIO控制背光亮度

使用0R电阻或焊锡连接该焊盘。

3.5inch-RPi-LCD-C-Manual-01.jpg

在树莓派终端执行以下命令即可控制背光亮度:

gpio -g pwm 18 1024
gpio -g mode 18 pwm (占用管脚为PWM管脚)
gpio pwmc 1000
gpio -g pwm 18 X (控制亮度,X取值在0~1024之间)

安装虚拟键盘

1. 执行以下命令安装相应软件

sudo apt-get update
sudo apt-get install matchbox-keyboard
sudo nano /usr/bin/toggle-matchbox-keyboard.sh

2. 复制以下内容到toggle-matchbox-keyboard.sh,保存退出

#!/bin/bash
#This script toggle the virtual keyboard
PID=`pidof matchbox-keyboard`
if [ ! -e $PID ]; then
killall matchbox-keyboard
else
matchbox-keyboard &
fi

3. 执行以下命令

sudo chmod +x /usr/bin/toggle-matchbox-keyboard.sh
sudo mkdir /usr/local/share/applications
sudo nano /usr/local/share/applications/toggle-matchbox-keyboard.desktop

4. 复制以下内容到toggle-matchbox-keyboard.desktop,保存退出

[Desktop Entry]
Name=Toggle Matchbox Keyboard
Comment=Toggle Matchbox Keyboard`
Exec=toggle-matchbox-keyboard.sh
Type=Application
Icon=matchbox-keyboard.png
Categories=Panel;Utility;MB
X-MB-INPUT-MECHANSIM=True

5. 执行以下命令,注意该步骤必须使用"pi"用户权限,如果使用管理员权限,将找不到该文件

sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel

6. 找到类似以下命令(不同版本的图标可能有一定差异)

Plugin {
type = launchbar
Config {
Button {
id=lxde-screenlock.desktop
}
Button {
id=lxde-logout.desktop
}
}

7. 加入以下代码以新增一个Button项,如下图

Button {
id=/usr/local/share/applications/toggle-matchbox-keyboard.desktop
}

RPILCD-INSTALL-KEYBOARD01.png

8. 执行以下命令重启系统,正常可以看到左上角多了一个虚拟键盘的图标

sudo reboot

接口定义

以下标识为“NC”的引脚表示LCD没有占用该引脚,用户可用于其它应用。

引脚号 标识 描述
1 3.3V 电源正(3.3V电源输入)
2 5V 电源正(5V电源输入)
3 NC NC
4 5V 电源正(5V电源输入)
5 NC NC
6 GND 电源地
7 NC NC
8 NC NC
9 GND 电源地
10 NC NC
11 TP_IRQ 触摸面板中断,检测到触摸面板有按下则为低电平
12 NC NC
13 NC NC
14 GND 电源地
15 NC NC
16 NC NC
17 3.3V 电源正(3.3V电源输入)
18 LCD_RS 指令/数据 寄存器选择
19 LCD_SI / TP_SI LCD显示 / 触摸面板的SPI数据输入
20 GND 电源地
21 TP_SO 触摸面板的SPI数据输出
22 RST 复位
23 LCD_SCK / TP_SCK LCD显示 / 触摸面板的SPI时钟信号
24 LCD_CS LCD片选信号,低电平选择LCD
25 GND 电源地
26 TP_CS 触摸面板片选信号,低电平选择触摸面板

资料


开发资料

树莓派驱动

通过Github获取驱动程序:

git clone https://github.com/waveshare/LCD-show.git

树莓派镜像

系统名称 版本 支持的树莓派版本 默认帐号\密码 下载地址
Debian 2024-03-15-raspios-bookworm-armhf.img 树莓派5代 \ 树莓派4代 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Debian 2024-03-15-raspios-bookworm-armhf-lite.img 树莓派4代 \ 树莓派3代 \ 树莓派2代 \ 树莓派0代 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Debian 2024-07-04-raspios-bookworm-arm64-lite.img 任何版本的树莓派 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Raspbian 2020-08-20-raspios-buster-armhf-full 任何版本的树莓派 user: pi \ password: raspberry 百度云盘 提取码:wxdz
Ubuntu ubuntu-mate-16.04.2 树莓派3代 \ 树莓派2代 user: pi \ password: 123 百度云盘 提取码:7igp
Kali 2018.4-rpi3-nexmon 树莓派3代B+ \ 树莓派3代 \ 树莓派2代 user: root \ password: toor 百度云盘 提取码:9piw

LCD显示区域

3.5inch RPi LCD (C)显示区域

3D图纸

软件

树莓派相关教程

树莓派入门教程(新)
树莓派入门教程
树莓派OpenCV教程
树莓派littleGL系列教程
树莓派QT教程
树莓派OpenWrt教程

FAQ


  • 该LCD必须安装驱动才能正常使用。具体请查看用户手册相关介绍。


  • 由于树莓派镜像和版本经常更新,如遇到无法正常使用LCD的情况,请下载我们提供的最新版本镜像或到树莓派官网下载最新的镜像并安装我们提供的最新驱动进行使用。
  • 确定硬件连接无误且接触良好。
  • 确定TF卡烧写正常。
    树莓派正常启动时PWR灯常亮,ACT灯闪烁。如果发现两灯都常亮则可能是TF卡烧写镜像不成功或TF卡与树莓派接触不良。

推荐使用5V 2.5A电源适配器对树莓派进行供电。 如使用PC机的USB接口对树莓派供电,可能由于供电不足导致树莓派无法正常启动。




售后


联系人:吴工
EMAIL:3005496359@qq.com
电话:0755-83043099
QQ:3005496359
微信:扫下方二维码添加
Wxy.png

说明:进行售后服务前,请准备好客户信息(定货单位、定货人等),以供验证