“1.44inch LCD HAT”的版本间的差异
Waveshare-admin(讨论 | 贡献) 小 (替换文字 - 「 {|style="width:auto" | {|class="at-c" style="table-layout:fixed;border-radius:100px;width:100%;border:2px solid #{{{bordercolor}}}" |- |class="bg-Joinus roundy-100 hide" style="table-layout:fixed;border-radius:100px;padding:10px;width:1) |
|||
(未显示7个用户的77个中间版本) | |||
第1行: | 第1行: | ||
+ | <div class="wiki-pages blue-color"> | ||
+ | <!--<div class="tabberlive newwsnav" id="wsnavbar"> | ||
+ | <ul class="tabbernav"> | ||
+ | <li class="nav-link">[[#myintro|说明]]</li> | ||
+ | <li class="nav-link">[[#myresources|资料]]</li> | ||
+ | <li class="nav-link">[[#myfaq|FAQ]]</li> | ||
+ | <li class="nav-link">[[#mysupport|售后]]</li> | ||
+ | </ul> | ||
+ | </div>--> | ||
<div class="tabber"> | <div class="tabber"> | ||
− | |||
− | |||
{{外围模块|colorscheme=blue | {{外围模块|colorscheme=blue | ||
|name = 1.44inch LCD HAT | |name = 1.44inch LCD HAT | ||
− | |img=[[File:1.44inch-LCD-HAT-intro.jpg|360px |alt=1.44inch-LCD-HAT|link= | + | |img=[[File:1.44inch-LCD-HAT-intro.jpg|360px |alt=1.44inch-LCD-HAT|link=https://{{SERVERNAME}}/shop/1.44inch-LCD-HAT.htm | 1.44inch LCD HAT]] |
|category1=LCD | |category1=LCD | ||
|category2=显示屏 | |category2=显示屏 | ||
第13行: | 第20行: | ||
|feature-value2=128×128 | |feature-value2=128×128 | ||
| interface1 =SPI | | interface1 =SPI | ||
− | | Product1 = | + | | Product1 = {{LCD_HAT}} |
+ | | Product2 = {{LCD_Module}} | ||
}} | }} | ||
+ | |||
+ | <div class="tabbertab" title="说明" id="myintro"> | ||
+ | =说明= | ||
+ | =产品概述= | ||
+ | '''提供树莓派程序驱动、FBTFT移植教程''' | ||
+ | ==产品参数== | ||
+ | *工作电压: 3.3V | ||
+ | *通信接口: SPI | ||
+ | *屏幕类型: TFT | ||
+ | *控制芯片: ST7735S | ||
+ | *分辨率: 128*128 (Pixel) | ||
+ | *显示尺寸: 25.5*26.5(mm) | ||
+ | *像素大小: 0.20(W)*0.20(H)(MM) | ||
+ | *产品尺寸 65*30.2(mm) | ||
+ | |||
+ | ==功能引脚== | ||
+ | {|border=1; style="width:700px;" align="center" | ||
+ | |-style="background:#0000ff; color:white;" align="center" | ||
+ | |功能引脚||树莓派接口(BCM)||描述 | ||
+ | |-align="center" | ||
+ | |KEY1||P21||按键1GPIO | ||
+ | |-align="center" | ||
+ | |KEY2||P20||按键2GPIO | ||
+ | |-align="center" | ||
+ | |KEY3||P16||按键3GPIO | ||
+ | |-align="center" | ||
+ | |摇杆UP||P6||摇杆上 | ||
+ | |-align="center" | ||
+ | |摇杆Down||P19||摇杆下 | ||
+ | |-align="center" | ||
+ | |摇杆Left||P5||摇杆左 | ||
+ | |-align="center" | ||
+ | |摇杆Right||P26||摇杆右 | ||
+ | |-align="center" | ||
+ | |摇杆Press||P13||摇杆按下 | ||
+ | |-align="center" | ||
+ | |SCLK||P11/SCLK||SPI时钟线 | ||
+ | |-align="center" | ||
+ | |MOSI||P10/MOSI||SPI数据线 | ||
+ | |-align="center" | ||
+ | |DC||P25||数据/命令选择 | ||
+ | |-align="center" | ||
+ | |CS||P8/CE0||片选 | ||
+ | |-align="center" | ||
+ | |RST||P27||复位 | ||
+ | |-align="center" | ||
+ | |BL||P24||背光 | ||
+ | |} | ||
+ | |||
+ | ==LCD 及其控制器== | ||
+ | ST7735S是一款132*162像素的LCD控制器,而本产品为128*128像素的LCD,因此在显示上做了一些处理:水平方向从第二个像素点开始显示,这样就可以保证显示的时候LCD中RAM对应的位置与实际位置是一致的。<br /> | ||
+ | 该LCD支持12位,16位以及18位每像素的输入颜色格式,即RGB444,RGB565,RGB666三种颜色格式,本例程使用RGB565的颜色格式,这也是常用的RGB格式<br /> | ||
+ | LCD使用四线SPI通信接口,这样可以大大的节省GPIO口,同时通信是速度也会比较快<br /> | ||
+ | |||
+ | ==通信协议== | ||
+ | [[file:0.96inch_lcd_module_spi.png|900px]]<br /> | ||
+ | 注:与传统的SPI协议不同的地方是:由于是只需要显示,故而将从机发往主机的数据线进行了隐藏,该表格详见Datasheet Page 66。<br /> | ||
+ | RESX为复位,模块上电时拉低,通常情况下置1;<br /> | ||
+ | CSX为从机片选, 仅当CS为低电平时,芯片才会被使能。<br /> | ||
+ | D/CX为芯片的数据/命令控制引脚,当DC = 0时写命令,当DC = 1时写数据。<br /> | ||
+ | SDA为传输的数据,即RGB数据。<br /> | ||
+ | SCL为SPI通信时钟。<br /> | ||
+ | 对于SPI通信而言,数据是有传输时序的,即时钟相位(CPHA)与时钟极性(CPOL)的组合:<br /> | ||
+ | CPHA的高低决定串行同步时钟是在第一时钟跳变沿还是第二个时钟跳变沿数据被采集,当CPHA = 0,在第一个跳变沿进行数据采集;<br /> | ||
+ | CPOL的高低决定串行同步时钟的空闲状态电平,CPOL = 0,为低电平。<br /> | ||
+ | 从图中可以看出,当SCLK第一个下降沿时开始传输数据,一个时钟周期传输8bit数据,使用SPI0,按位传输,高位在前,低位在后。<br /> | ||
+ | |||
+ | =树莓派= | ||
+ | 提供C语言与python例程 | ||
+ | {{RPI_open_spi}} | ||
+ | |||
+ | ==安装库== | ||
+ | {{RPI_C_lib}} | ||
+ | ===python=== | ||
+ | <pre> | ||
+ | sudo apt-get update | ||
+ | sudo apt-get install ttf-wqy-zenhei | ||
+ | sudo apt-get install python3-pip | ||
+ | sudo pip3 install spidev | ||
+ | </pre> | ||
+ | |||
+ | ==下载例程== | ||
+ | 在树莓派终端运行:<br /> | ||
+ | <pre> | ||
+ | sudo apt-get install p7zip-full -y | ||
+ | wget http://www.waveshare.net/w/upload/f/fa/1.44inch-LCD-HAT-Code.7z | ||
+ | 7z x 1.44inch-LCD-HAT-Code.7z | ||
+ | sudo chmod 777 -R 1.44inch-LCD-HAT-Code | ||
+ | cd 1.44inch-LCD-HAT-Code/RaspberryPi/ | ||
+ | </pre> | ||
+ | |||
+ | ==运行测试程序== | ||
+ | *C语言 | ||
+ | <pre> | ||
+ | cd c | ||
+ | make clean | ||
+ | make | ||
+ | sudo ./main | ||
+ | </pre> | ||
+ | *对于树莓派4B及raspbian_lite-2019-06-20系统之后需要设置如下,按键才能正常输入<br /> | ||
+ | <pre> | ||
+ | sudo nano /boot/config.txt | ||
+ | #添加如下: | ||
+ | gpio=6,19,5,26,13,21,20,16=pu | ||
+ | </pre> | ||
+ | *python | ||
+ | <pre> | ||
+ | cd python | ||
+ | sudo python main.py | ||
+ | sudo python key_demo.py | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | {{Fbcp}} | ||
+ | ==模拟鼠标== | ||
+ | 模块上面板子一个摇杆和三个按键,我们可以用来控制树莓派的鼠标<br /> | ||
+ | *安装库并下载并运行例程 | ||
+ | <pre> | ||
+ | #python2 | ||
+ | sudo apt-get install python-xlib | ||
+ | sudo pip install PyMouse | ||
+ | wget http://www.waveshare.net/w/upload/d/d3/Mouse.7z | ||
+ | 7z x Mouse.7z | ||
+ | sudo python mouse.py | ||
+ | #python3 | ||
+ | sudo apt-get install python3-xlib | ||
+ | sudo pip3 install PyMouse | ||
+ | sudo pip3 install unix | ||
+ | sudo pip3 install PyUserInput | ||
+ | wget http://www.waveshare.net/w/upload/d/d3/Mouse.7z | ||
+ | 7z x Mouse.7z | ||
+ | sudo python3 mouse.py | ||
+ | </pre> | ||
+ | {|style="color:red" | ||
+ | | | ||
+ | *注意:mouse.py需要的图形化界面下运行,SSH登录命令行无法使用,可以直接跳过这一步骤,通过开机自启动运行程序。 | ||
+ | |} | ||
+ | *对于树莓派4B及raspbian_lite-2019-06-20系统之后需要设置如下,按键才能正常输入<br /> | ||
+ | <pre> | ||
+ | sudo nano /boot/config.txt | ||
+ | #添加如下: | ||
+ | gpio=6,19,5,26,13,21,20,16=pu | ||
+ | </pre> | ||
+ | '''使用摇杆上下左右,就可以看到鼠标在动了。''' | ||
+ | *配置成开机自启 | ||
+ | 注意不要加到/etc/rc.local中,因为rc.local在系统还没有进入桌面之前会执行,而PyMouse模块在命令行界面运行的话会报错没有鼠标这个事件,所以我们需要执行如下:<br /> | ||
+ | <pre> | ||
+ | cd .config/ | ||
+ | mkdir autostart | ||
+ | cd autostart/ | ||
+ | sudo nano local.desktop | ||
+ | </pre> | ||
+ | 加入如下(添加对应的即可,不用全部添加进去): | ||
+ | <pre> | ||
+ | #python2 | ||
+ | [Desktop Entry] | ||
+ | Type=Application | ||
+ | Exec=python /home/pi/mouse.py | ||
+ | #python3 | ||
+ | [Desktop Entry] | ||
+ | Type=Application | ||
+ | Exec=python3 /home/pi/mouse.py | ||
+ | </pre> | ||
+ | 然后重新启动树莓派,即可使用按键控制鼠标了。<br /> | ||
+ | <pre> | ||
+ | sudo reboot | ||
+ | </pre> | ||
+ | |||
+ | ==其他== | ||
+ | 有兴趣弄游戏机的小伙伴们可以参考下面这两个链接,这里不再详细讲解。<br /> | ||
+ | https://www.sudomod.com/forum/viewtopic.php?f=11&t=5371&start=10<br /> | ||
+ | https://pi0cket.com/guides/tiny-software-for-tinypi/#more-99<br /> | ||
+ | </div> | ||
+ | |||
+ | <div class="tabbertab" title="资料" id="myresources"> | ||
+ | |||
+ | <h1>资料</h1> | ||
+ | |||
===文档=== | ===文档=== | ||
− | *[ | + | *[https://{{SERVERNAME}}/w/upload/6/6f/1.44inch-LCD-HAT-Schematic.pdf 原理图]<br> |
− | |||
− | |||
===程序=== | ===程序=== | ||
− | *[ | + | *[https://{{SERVERNAME}}/w/upload/f/fa/1.44inch-LCD-HAT-Code.7z 树莓派程序]<br> |
+ | *[https://{{SERVERNAME}}/w/upload/4/4e/1.44inch-LCD-HAT-All-Code.7z 示例程序]<br> | ||
===软件=== | ===软件=== | ||
{{OLED_Software}} | {{OLED_Software}} | ||
===数据手册=== | ===数据手册=== | ||
− | *[ | + | *[https://{{SERVERNAME}}/w/upload/e/e2/ST7735S_V1.1_20111121.pdf ST7735S 手册] |
+ | |||
+ | |||
+ | </div> | ||
+ | <div class="tabbertab" title="FAQ" id="myfaq"> | ||
+ | |||
+ | <h1>FAQ</h1> | ||
+ | <br /> | ||
+ | {{FAQ|按键使用不了?| | ||
+ | 对于树莓派系统镜像(2019-06-20-raspbian-buster)而言,需要在/boot/config.txt加入:| | ||
+ | <nowiki>gpio=6,19,5,26,13,21,20,16=pu</nowiki> | ||
+ | |||}} | ||
+ | |||
+ | {{FAQ|为什么开启了FBTFT没有spidev0.0?| | ||
+ | 开启了fbtft,重启之后会占用掉spidev0.0,此时如果需要运行示例程序,需要把/etc/modules中的开启fb对应的语句屏蔽掉。 | ||
+ | |||}} | ||
+ | </div> | ||
− | < | + | <div class="tabbertab" title="售后" id="mysupport"> |
− | < | + | =售后= |
+ | <br />{{Service20}}</div> | ||
</div> | </div> | ||
− | |||
− |
2023年12月20日 (三) 15:03的最新版本
| ||||||||||||||||||||||||
| ||||||||||||||||||||||||
说明
产品概述
提供树莓派程序驱动、FBTFT移植教程
产品参数
- 工作电压: 3.3V
- 通信接口: SPI
- 屏幕类型: TFT
- 控制芯片: ST7735S
- 分辨率: 128*128 (Pixel)
- 显示尺寸: 25.5*26.5(mm)
- 像素大小: 0.20(W)*0.20(H)(MM)
- 产品尺寸 65*30.2(mm)
功能引脚
功能引脚 | 树莓派接口(BCM) | 描述 |
KEY1 | P21 | 按键1GPIO |
KEY2 | P20 | 按键2GPIO |
KEY3 | P16 | 按键3GPIO |
摇杆UP | P6 | 摇杆上 |
摇杆Down | P19 | 摇杆下 |
摇杆Left | P5 | 摇杆左 |
摇杆Right | P26 | 摇杆右 |
摇杆Press | P13 | 摇杆按下 |
SCLK | P11/SCLK | SPI时钟线 |
MOSI | P10/MOSI | SPI数据线 |
DC | P25 | 数据/命令选择 |
CS | P8/CE0 | 片选 |
RST | P27 | 复位 |
BL | P24 | 背光 |
LCD 及其控制器
ST7735S是一款132*162像素的LCD控制器,而本产品为128*128像素的LCD,因此在显示上做了一些处理:水平方向从第二个像素点开始显示,这样就可以保证显示的时候LCD中RAM对应的位置与实际位置是一致的。
该LCD支持12位,16位以及18位每像素的输入颜色格式,即RGB444,RGB565,RGB666三种颜色格式,本例程使用RGB565的颜色格式,这也是常用的RGB格式
LCD使用四线SPI通信接口,这样可以大大的节省GPIO口,同时通信是速度也会比较快
通信协议
注:与传统的SPI协议不同的地方是:由于是只需要显示,故而将从机发往主机的数据线进行了隐藏,该表格详见Datasheet Page 66。
RESX为复位,模块上电时拉低,通常情况下置1;
CSX为从机片选, 仅当CS为低电平时,芯片才会被使能。
D/CX为芯片的数据/命令控制引脚,当DC = 0时写命令,当DC = 1时写数据。
SDA为传输的数据,即RGB数据。
SCL为SPI通信时钟。
对于SPI通信而言,数据是有传输时序的,即时钟相位(CPHA)与时钟极性(CPOL)的组合:
CPHA的高低决定串行同步时钟是在第一时钟跳变沿还是第二个时钟跳变沿数据被采集,当CPHA = 0,在第一个跳变沿进行数据采集;
CPOL的高低决定串行同步时钟的空闲状态电平,CPOL = 0,为低电平。
从图中可以看出,当SCLK第一个下降沿时开始传输数据,一个时钟周期传输8bit数据,使用SPI0,按位传输,高位在前,低位在后。
树莓派
提供C语言与python例程
树莓派使用教程
开启SPI接口
- 打开树莓派终端,输入以下指令进入配置界面
sudo raspi-config 选择Interfacing Options -> SPI -> Yes 开启SPI接口
sudo reboot
请确保SPI没有被其他的设备占用,你可以在/boot/config.txt中间检查
安装库
如果使用bookworm系统,只能使用lgpio库,bcm2835跟wiringPi无法安装与使用
BCM2835
#打开树莓派终端,并运行以下指令 wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz tar zxvf bcm2835-1.71.tar.gz cd bcm2835-1.71/ sudo ./configure && sudo make && sudo make check && sudo make install # 更多的可以参考官网:http://www.airspayce.com/mikem/bcm2835/
wiringPi
#打开树莓派终端,并运行以下指令 cd sudo apt-get install wiringpi #对于树莓派2019年5月之后的系统(早于之前的可不用执行),可能需要进行升级: wget https://project-downloads.drogon.net/wiringpi-latest.deb sudo dpkg -i wiringpi-latest.deb gpio -v # 运行gpio -v会出现2.52版本,如果没有出现说明安装出错 #Bullseye分支系统使用如下命令: git clone https://github.com/WiringPi/WiringPi cd WiringPi ./build gpio -v # 运行gpio -v会出现2.70版本,如果没有出现说明安装出错
lgpio
#打开树莓派终端,并运行以下指令 wget https://github.com/joan2937/lg/archive/master.zip unzip master.zip cd lg-master sudo make install # 更多的可以参考官网:https://github.com/gpiozero/lg
python
sudo apt-get update sudo apt-get install ttf-wqy-zenhei sudo apt-get install python3-pip sudo pip3 install spidev
下载例程
在树莓派终端运行:
sudo apt-get install p7zip-full -y wget http://www.waveshare.net/w/upload/f/fa/1.44inch-LCD-HAT-Code.7z 7z x 1.44inch-LCD-HAT-Code.7z sudo chmod 777 -R 1.44inch-LCD-HAT-Code cd 1.44inch-LCD-HAT-Code/RaspberryPi/
运行测试程序
- C语言
cd c make clean make sudo ./main
- 对于树莓派4B及raspbian_lite-2019-06-20系统之后需要设置如下,按键才能正常输入
sudo nano /boot/config.txt #添加如下: gpio=6,19,5,26,13,21,20,16=pu
- python
cd python sudo python main.py sudo python key_demo.py
FBCP移植
Framebuffer 是用一个视频输出设备从包含完整的帧数据的一个内存缓冲区中来驱动一个视频显示设备。简单的来说,就是使用一个内存区来存储显示内容,改变内存的数据就可以改变显示的内容。
在 github 上有一个开源工程:fbcp-ili9341,该工程相比其他类fbcp工程,利用了局部刷新和DMA实现高达60fps的速度
编译与运行
sudo apt-get install cmake -y cd ~ wget https://www.waveshare.net/w/upload/1/18/Waveshare_fbcp.zip unzip Waveshare_fbcp.zip cd Waveshare_fbcp mkdir build cd build #以1.44inch_LCD_HAT为例 cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH44_LCD_HAT=ON -DBACKLIGHT_CONTROL=ON -DSTATISTICS=0 .. #以1.3inch_LCD_HAT为例 cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH3_LCD_HAT=ON -DBACKLIGHT_CONTROL=ON -DSTATISTICS=0 .. make -j sudo ./fbcp
设置开机自启动
sudo cp ~/waveshare_fbcp/build/fbcp /usr/local/bin/fbcp sudo nano /etc/rc.local
在 exit 0 前面添加 fbcp&。注意一定要添加"&" 后台运行,否则可能会出现系统不能启动的情况。
设置用户界面显示尺寸
在/boot/config.txt 文件中设置用户界面显示尺寸。
sudo nano /boot/config.txt
添加
hdmi_force_hotplug=1 hdmi_cvt=300 300 60 1 0 0 0 hdmi_group=2 hdmi_mode=87 display_rotate=0
这里是设置系统界面分辨率,最后显示的效果是按照比例缩放显示在1.3inch LCD上。这里设置分辨率应稍大于LCD的分辨率,过高会导致字体显示模糊。
重启设备即可
sudo reboot
模拟鼠标
模块上面板子一个摇杆和三个按键,我们可以用来控制树莓派的鼠标
- 安装库并下载并运行例程
#python2 sudo apt-get install python-xlib sudo pip install PyMouse wget http://www.waveshare.net/w/upload/d/d3/Mouse.7z 7z x Mouse.7z sudo python mouse.py #python3 sudo apt-get install python3-xlib sudo pip3 install PyMouse sudo pip3 install unix sudo pip3 install PyUserInput wget http://www.waveshare.net/w/upload/d/d3/Mouse.7z 7z x Mouse.7z sudo python3 mouse.py
|
- 对于树莓派4B及raspbian_lite-2019-06-20系统之后需要设置如下,按键才能正常输入
sudo nano /boot/config.txt #添加如下: gpio=6,19,5,26,13,21,20,16=pu
使用摇杆上下左右,就可以看到鼠标在动了。
- 配置成开机自启
注意不要加到/etc/rc.local中,因为rc.local在系统还没有进入桌面之前会执行,而PyMouse模块在命令行界面运行的话会报错没有鼠标这个事件,所以我们需要执行如下:
cd .config/ mkdir autostart cd autostart/ sudo nano local.desktop
加入如下(添加对应的即可,不用全部添加进去):
#python2 [Desktop Entry] Type=Application Exec=python /home/pi/mouse.py #python3 [Desktop Entry] Type=Application Exec=python3 /home/pi/mouse.py
然后重新启动树莓派,即可使用按键控制鼠标了。
sudo reboot
其他
有兴趣弄游戏机的小伙伴们可以参考下面这两个链接,这里不再详细讲解。
https://www.sudomod.com/forum/viewtopic.php?f=11&t=5371&start=10
https://pi0cket.com/guides/tiny-software-for-tinypi/#more-99
FAQ
gpio=6,19,5,26,13,21,20,16=pu
开启了fbtft,重启之后会占用掉spidev0.0,此时如果需要运行示例程序,需要把/etc/modules中的开启fb对应的语句屏蔽掉。