View source for Matrix - 2'8 SPI Key TFT/zh

[[Matrix - 2'8 SPI Key TFT|English]]

==介绍==
[[File:Matrix-2'8_SPI_Key_TFT.png|thumb|正面]]
[[File:Matrix-2'8_SPI_Key_TFT2.png|thumb|背面]]
*Matrix-2'8_SPI_Key_TFT模块是一款2.8英寸的TFT 触摸LCD，模块采用ST7789S驱动IC和XPT2046电阻式触摸IC，屏幕分辨率为240*320，采用SPI控制接口，模块还包含3个独立按键，可根据需要自定义功能。
*详细规格如下所示：
{| class="wikitable"
|-
|LCD尺寸||2.8寸
|-
|显示区域||57.6mm*43.2mm
|-
|驱动IC||ST7789S
|-
|分辨率||240*320（RGB）
|-
|接口方式||SPI
|-
|工作电压||5V
|-
|背光电压||5V
|-
|触摸屏类型||电阻式，钢化玻璃触摸屏
|-
|}
模块上电默认打开背光，可通过置低LED_EN引脚关闭背光。如果需要关闭上电打开背光，只需要拿到电路板上的R12电阻，再通过置高LED_EN引脚打开背光；

==特性==
* PCB尺寸（mm）：
[[File:Matrix-2'8_SPI_Key_TFT_PCB.png|frameless|400px|]]

* 引脚说明:
Matrix-2'8_SPI_Key_TFT目前已经推出过2个版本，引脚定义如下:
{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''Matrix-2'8_SPI_Key_TFT-1706'''
|-
|Pin# || Name      ||Pin# || Name
|-
|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   || T_CS
|-
|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   || NC
|- 
|}

{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" colspan="4"| '''Matrix-2'8_SPI_Key_TFT-1512'''
|-
|Pin# || Name      ||Pin# || Name
|-
|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
|- 
|}

<span style="color:#ff0000"> <br> Matrix-2'8_SPI_Key_TFT-1706将触摸芯片的使能引脚T_CS从Pin26修改为Pin12，这样修改之后NEO/NEO2/NEO-Plus2等引脚是24Pin兼容的开发板就能正常使用触摸芯片了。 <br></span>

==支持该配件的开发板型号和软件版本==
{| class="wikitable"
|-
|序号 ||CPU型号|| 开发板型号 || 软件版本
|-
|1    ||H3||NanoPi NEO/NEO Air/NEO Core/M1/M1 Plus|| 全志原厂Linux-3.4内核和开源社区Linux-4.x主线内核
|-
|2    ||H5||NanoPi NEO2/NEO Plus2/NEO Core2 || 开源社区Linux-4.x主线内核
|-
|3    ||S5P4418||NanoPi2/NanoPi M2/NanoPi2 Fire    || 三星原厂Linux-3.4内核
|-
|}

==硬件连接==
===H3系列===
连接NanoPi M1:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_m1.jpg|frameless|500px|Matrix-2'8_SPI_Key_TFT_nanopi_m1]]<br>

连接NanoPi M1 Plus:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_m1_plus.jpg|frameless|500px|Matrix-2'8_SPI_Key_TFT_nanopi_m1_plus]]<br>

连接NanoPi NEO:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_neo.jpg|frameless|500px|Matrix-2'8_SPI_Key_TFT_nanopi_neo]]<br>

连接NanoPi NEO Air:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_neo_air.jpg|frameless|500px|Matrix-2'8_SPI_Key_TFT_nanopi_neo_air]]<br>

连接NanoPi NEO Core:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_neo_core.jpg|frameless|500px|Matrix-2'8_SPI_Key_TFT_nanopi_neo_core]]<br>

===H5系列===
连接NanoPi NEO2 :<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_neo2.jpg|frameless|600px|Matrix-2'8_SPI_Key_TFT_nanopi_neo2]]<br>

连接NanoPi NEO Plus2:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_neo2-plus.jpg|frameless|600px|Matrix-2'8_SPI_Key_TFT_nanopi_neo-plus2]]<br>

连接NanoPi NEO Core2:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_neo_core2.jpg|frameless|500px|Matrix-2'8_SPI_Key_TFT_nanopi_neo_core2]]<br>

===S5P4418系列===
连接NanoPi2:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi2.jpg|frameless|600px|Matrix-2'8_SPI_Key_TFT_nanopi2]]<br>

连接NanoPi M2 / NanoPi2 Fire:<br>
[[File:Matrix-2'8_SPI_Key_TFT_nanopi_m2.jpg|frameless|600px|Matrix-2'8_SPI_Key_TFT_nanopi_m2]]<br>
NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，这里仅以NanoPi M2为例。<br>

==使用默认使能Matrix-2'8_SPI_Key_TFT的ROM==
::{| class="wikitable"
|-
|Board Type||CPU Model||Download Link to Image File||Image File
|-
|NanoPi NEO|| H3 || [http://dl.friendlyarm.com/nanopineo Download]|| official-ROMs/nanopi-neo_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
|NanoPi NEO Air|| H3 ||[http://dl.friendlyarm.com/nanopineoair Download] || official-ROMs/nanopi-neo-air_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
|NanoPi M1|| H3 ||[http://dl.friendlyarm.com/nanopim1 Download] || official-ROMs/nanopi-m1_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
|NanoPi NEO Core|| H3 ||[http://dl.friendlyarm.com/nanopineocore Download] || official-ROMs/nanopi-neo-core_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
<!--
|NanoPi M1 Plus|| H3 ||[http://dl.friendlyarm.com/nanopim1plus Download] || official-ROMs/nanopi-m1-plus_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
|NanoPi NEO2|| H5 ||[http://dl.friendlyarm.com/nanopineo2 Download] || official-ROMs/nanopi-neo2_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
|NanoPi NEO Plus2|| H5 ||[http://dl.friendlyarm.com/nanopineoplus2 Download] || official-ROMs/nanopi-neo-plus2_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
|NanoPi NEO Core2|| H5 ||[http://dl.friendlyarm.com/nanopineocore2 Download] || official-ROMs/nanopi-neo-core2_ubuntu-tft_4.x.y_YYYYMMDD.img.zip
|-
-->
|}

==手动使能Matrix-2'8_SPI_Key_TFT==
===H3/H5配合Linux-4.x主线内核===
注意：以下测试方法适用于测试Matrix-2'8_SPI_Key_TFT-1706版本的硬件，对于Matrix-2'8_SPI_Key_TFT-1512（丝印T28-02 1512）硬件，请按照本章节末尾的说明自行修改软件，将触摸芯片的使能引脚设置为Pin26。<br><br>

当使用的开发板为H3或者H5系列时，假设使用的ROM是基于Linux-4.x主线内核的Ubuntu-Core with Qt-Embedded系统，那么首先需要通过npi-config工具来使能Matrix-2'8_SPI_Key_TFT。启动系统，在root用户下执行下列命令运行npi-config:
<syntaxhighlight lang="bash">
$ npi-config
</syntaxhighlight>
然后依次进入下列菜单项:<br>
[[File:tft-1.png|frameless|1000px|tft-1]]<br>
进入SPI菜单:<br>
[[File:tft-2.png|frameless|1000px|tft-2]]<br>
选择是否使能SPI0:<br>
[[File:tft-3.png|frameless|1000px|tft-3]]<br>
选择enable SPI0后，再选择SPI0上连接的设备为Matrix-2'8_SPI_Key_TFT:<br>
[[File:tft-4.png|frameless|1000px|tft-4]]<br>
最后返回主菜单，选择<Finish>，然后根据提示重启系统。重新启动系统后，执行下列命令检查Matrix-2'8_SPI_Key_TFT的显示芯片和触摸芯片是否被使能:
<syntaxhighlight lang="bash">
$ ls /dev/fb-st7789s 
/dev/fb-st7789s
</syntaxhighlight>
/dev/fb-st7789s就是显示芯片的framebuffer设备节点。
<syntaxhighlight lang="bash">
$ ls /dev/input/ts-ads7846 
/dev/input/ts-ads7846
</syntaxhighlight>
/dev/input/ts-ads7846就是触摸芯片的设备节点。
第一次进入系统时会进行触摸校准，根据屏幕的提示点击5个点完成校准即可。<br>
[[File:tslib.png|frameless|1000px|tft-tslib]]<br>
注意:在Linux4.x主线内核中，默认支持的是使用Pin12作为触摸芯片的使能引脚的Matrix-2'8_SPI_Key_TFT-1706版本。<br>
通过npi-config使能Matrix-2'8_SPI_Key_TFT后，系统会将默认的登录显示设备设置为Matrix-2'8_SPI_Key_TFT。如果你想开机运行Qt-demo程序，可以在npi-config中进行如下配置，进入Boot Options菜单:<br>
[[File:tft-qt-demo-1.png|frameless|1000px|tft-qt-demo-1]]<br>
进入Autologin菜单:<br>
[[File:tft-qt-demo-2.png|frameless|1000px|tft-qt-demo-2]]<br>
进去Qt/Embedded菜单:<br>
[[File:tft-qt-demo-3.png|frameless|1000px|tft-qt-demo-3]]<br>
使能Qt/E Demo:<br>
[[File:tft-qt-demo-4.png|frameless|1000px|tft-qt-demo-4]]<br>
最后返回主菜单，选择<Finish>，然后根据提示重启系统。重新启动系统后，屏幕上会自动运行Qt/E demo，效果如下:<br>
[[File:qt-demo-status.png|frameless|600px|qt-demo-status]]<br>

对于使用Matrix-2'8_SPI_Key_TFT-1512（丝印T28-02 1512）+ NanoPi M1/NanoPi M1 Plus的用户，需要自行修改内核代码选择使用Pin26作为触摸使能引脚才能正常使用触摸功能。<br>
假设你已经参考H3 主线内核的维基[[Mainline U-boot & Linux]]成功克隆并编译了Linux内核，则还需要修改下列代码:
修改下列代码:
$ vi linux/arch/arm/boot/dts/sun8i-h3-nanopi
<syntaxhighlight lang="bash">、
    ...
    spi0_cs_pins: spi0_cs_pins {
        pins = "PC3", "PA6";
        function = "gpio_out";
    };
    ...
&spi0 {
    ...
    cs-gpios = <&pio 2 3 GPIO_ACTIVE_HIGH>, <&pio 0 6 GPIO_ACTIVE_HIGH>;
    ...
</syntaxhighlight>
其中<&pio 0 6 GPIO_ACTIVE_HIGH>表示使用GPIOA6(Pin12)作为触摸使能引脚，将其修改为GPIOA17(Pin26):
<syntaxhighlight lang="bash">
    ...
    spi0_cs_pins: spi0_cs_pins {
        pins = "PC3", "PA17";
        function = "gpio_out";
    };
    ...
&spi0 {
    ...
    cs-gpios = <&pio 2 3 GPIO_ACTIVE_HIGH>, <&pio 0 17 GPIO_ACTIVE_HIGH>;
    ...
</syntaxhighlight>
然后重新编译内核，拷贝arch/arm/boot/dts/目录下的sun8i-h3-nanopi-m1.dtb/sun8i-h3-nanopi-m1-plus.dtb到TF卡boot分区下，重新启动板子即可。

{{S5Pxx18-SPI-2.8TFT/zh}}

==相关资料==
*[Schematic]([http://wiki.friendlyarm.com/wiki/images/1/1c/SCHEMATIC1_W28-02.pdf Matrix - 2'8 SPI Key TFT-Schematic.pdf])