Difference between revisions of "Matrix - 2'8 SPI Key TFT/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
Line 107: Line 107:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
nanopi-status是一个简单的Qt程序，可用于显示系统的基本信息，效果如下：<br>
 
nanopi-status是一个简单的Qt程序，可用于显示系统的基本信息，效果如下：<br>
−
[[File:st7789s-status.png|frameless|600px|st7789s-status]]
+
[[File:st7789s-status.png|frameless|600px|st7789s-status]]<br>
 +
脚本run.sh会先加载tft屏的驱动模块然后运行Qt程序，驱动模块加载成功后会生成设备节点/dev/fb-st7789s，下列命令可以确定驱动模块是否成功加载：
 +
<syntaxhighlight lang="bash">
 +
lsmod
 +
Module                  Size  Used by
 +
fbtft_device          29235  0
 +
</syntaxhighlight>
 +
在确定tft驱动模块已加载的前提下，运行下列命令可以显示三原色：
 +
<syntaxhighlight lang="bash">
 +
cd matrix/demo/matrix-lcdtest
 +
make
 +
export LCDSET_FB_DEV=/dev/fb-st7789s
 +
./matrix-lcdtest
 +
</syntaxhighlight>
 +
三原色可以呈现出屏幕的最佳显示效果。
  
 
===在2.8寸屏上显示Debian桌面===
 
===在2.8寸屏上显示Debian桌面===

Revision as of 03:21, 7 March 2017

English

1 介绍

Matrix-2'8 SPI Key TFT.png
  • Matrix-2'8_SPI_Key_TFT模块是一款2.8英寸的TFT 触摸LCD，模块采用ST7789S驱动IC和XPT2046电阻式触摸IC，屏幕分辨率为320*240，采用SPI控制接口，模块还包含3个独立按键，可根据需要自定义功能。
  • 详细规格如下所示：
LCD尺寸 2.8寸
显示区域 57.6mm*43.2mm
驱动IC ST7789S
分辨率 320*240（RGB）
接口方式 SPI
工作电压 5V
背光电压 5V
触摸屏类型 电阻式，钢化玻璃触摸屏

模块上电默认打开背光，可通过置低LED_EN引脚关闭背光。如果需要关闭上电打开背光，只需要拿到电路板上的R12电阻，再通过置高LED_EN引脚打开背光；

2 特性

  • PCB尺寸（mm）：

Matrix-2'8 SPI Key TFT PCB.png

  • 引脚说明:
名称 描述 名称 描述
1 VDD_3.3V 2 VDD_5V
3 NC 4 VDD_5V
5 NC 6 GND
7 LCD_RESET 8 NC
9 GND 10 NC
11 LED_EN 12 NC
13 KEY_1 14 GND
15 KEY_2 16 KEY_3
17 VDD_3.3V 18 T_IRQ
19 SPI_MOSI 20 GND
21 SPI_MISO 22 LCD_D/C
23 SPI_CLK 24 LCD_CS
25 GND 26 T_CS


3 硬件连接

3.1 连接NanoPi M1

参考下图连接模块：
Matrix-2'8_SPI_Key_TFT_nanopi_m1

3.2 连接NanoPi M1 Plus

参考下图连接模块：
Matrix-2'8_SPI_Key_TFT_nanopi_m1_plus

3.3 连接NanoPi NEO

参考下图连接模块：
Matrix-2'8_SPI_Key_TFT_nanopi_neo

3.4 连接NanoPi NEO Air

参考下图连接模块：
Matrix-2'8_SPI_Key_TFT_nanopi_neo_air

3.5 连接NanoPi 2

参考下图连接模块：
Matrix-2'8_SPI_Key_TFT_nanopi2

3.6 连接NanoPi M2 / NanoPi 2 Fire

NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，这里仅以NanoPi M2为例。
参考下图连接模块：
Matrix-2'8_SPI_Key_TFT_nanopi_m2

4 编译运行测试程序

4.1 在Ubuntu-Core上运行Qt程序

由于Ubuntu-Core系统带有Qt环境，我们可以在该系统上运行一个简单且带图形界面的Qt程序。
启动开发板并运行Ubuntu-Core系统，进入系统后克隆Matrix代码仓库： 

$ apt-get update && apt-get install git
$ git clone https://github.com/friendlyarm/matrix.git

克隆完成后会得到一个名为matrix的目录。

编译并运行Qt测试程序： 

cd matrix/demo/nanopi-status
./build.sh
./run.sh /dev/fb-st7789s

nanopi-status是一个简单的Qt程序，可用于显示系统的基本信息，效果如下：
st7789s-status
脚本run.sh会先加载tft屏的驱动模块然后运行Qt程序，驱动模块加载成功后会生成设备节点/dev/fb-st7789s，下列命令可以确定驱动模块是否成功加载： 

lsmod
Module                  Size  Used by
fbtft_device           29235  0

在确定tft驱动模块已加载的前提下，运行下列命令可以显示三原色： 

cd matrix/demo/matrix-lcdtest
make
export LCDSET_FB_DEV=/dev/fb-st7789s
./matrix-lcdtest

三原色可以呈现出屏幕的最佳显示效果。

4.2 在2.8寸屏上显示Debian桌面

对于支持Debian系统的开发板，用户可以通过下列操作将Debian的桌面显示在2.8寸屏上。

启动开发板并运行Debian系统，进入系统后克隆Matrix代码仓库： 

$ apt-get update && apt-get install git
$ git clone https://github.com/friendlyarm/matrix.git

克隆完成后会得到一个名为matrix的目录。

对于H3系列的开发板，需要先修改X11的配置文件： 

$ vi /etc/X11/xorg.conf

将字样“/dev/fb0”修改为“/dev/fb-st7789s”。

执行下列命令在2.8寸屏上启动Debian桌面： 

$ cd matrix/demo/nanopi-status/
$ ./display-debian.sh /dev/fb-st7789s

用触摸笔在屏幕上点击4个点完成校准并进入Debian桌面，效果如下：
fbtft-debian

完成触摸校准后终端会有类似如下的打印信息： 

Section "InputClass" 
        Identifier      "calibration" 
        MatchProduct    "ADS7846 Touchscreen" 
        Option  "Calibration"   "196 3825 3887 358" 
        Option  "SwapAxes"      "0" 
EndSection

将上述内容手动保存在/usr/share/X11/xorg.conf.d/99-calibration.conf中，以后就再也无需进行校准了。

5 相关资料

Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=Matrix_-_2%278_SPI_Key_TFT/zh&oldid=9308"