>[success] **技术支持说明** > 1.**客服**提供简单的技术支持，一般自主学习为主 > 2.可到官方问答社区中提问：[**去提问**](https://bbs.csdn.net/forums/zigbee) > 3.工程师**会尽快**解答社区问题，但他们是一线开发，【**难以保证**】解答时效，解答辛苦，感谢理解！ >[danger] 学习本节内容前，先检查您是否有屏幕是否为TFT屏幕，若无则可跳过本章节。 > 0.96英寸TFT屏幕的引脚数量为**8个**，引脚名称依次为GND、VCC、SCL、SDA、RES、DC、CS和BLK。若这与您的一致，那么您的是0.96英寸TFT屏幕 <br/> 前面章节讲解了如何使用OLED12864，但是OLED12864只能显示单一的颜色，无法显示彩色。本节课将要讲解TFT是一种LCD显示器，支持彩色显示。 <br/> ## **TFT显示器简介** TFT-LCD（Thin Film Transistor-Liquid Crystal Display），即薄膜晶体管液晶显示器，屏幕中的每一个像素点配备有有一个薄膜晶体管。 ### 可以使用16位的RGB值来配置这个晶体管的彩色。这个16位的RGB值中的左边5位表示Red，中间6位表示Green，右边的5位表示Blue，如下图所示。  ### 开发套件中的0.96英寸TFT显示屏的实物图如下图所示，其分辨率是64×128像素，即纵向有64个像素点、横向有128个像素点。  ### **通信协议** 与OLED12864类型，这个TFT显示屏也是支持SPI协议驱动的。如需了解SPI协议的相关知识，可参考OLED12864章节。 ### **字库与图库** 与OLED12864类似，为了让TFT屏幕能够正常地显示各种字符和图片，同样需要准备好字库和图库。 <br/> ## **TFT显示器 驱动 API** 为驱动TFT显示器，笔者设计了相应驱动API供读者学习和使用。 ### 与OLED12864类似，TFT显示器的驱动API可分为两个层次，分别是**上层的TFT显示API**和**下层的SPI驱动API**。其中的下层的SPI驱动API与OLED12864的一致，如需详细了解相关信息可参考OLED12864章节。 ### 驱动API还需要字库和图库文件配合工作。这3者在如图所示位置。  <br/> ### **TFT显示API** 在配置好显示屏引脚和字库文件后，调用TFT显示API即可在屏幕上显示指定的内容。打开TFT文件夹中的hal_tft.h文件，可以找到TFT显示API定义代码： ### ``` /** * @fn halTFTInit * * @brief 初始化TFT屏幕，使用TFT屏幕前必须先调用此函数 * * @param screenColor - 屏幕颜色的RGB值，用于指定屏幕的默认颜色 */ void halTFTInit(uint16 screenColor); /** * @fn halTFTSetScreen * * @brief 设定整个屏幕的颜色，具有清除屏幕显示内容的作用 * * @param screenColor - 屏幕颜色的RGB值 */ void halTFTSetScreen(uint16 screenColor); /** * @fn halTFTShowX16 * * @brief 在屏幕上显示高度为16像素的字符串，支持的字符格式：1. 8x16 ASCII码；2. 16x16 汉字 * * * @param x - 指定在横向从左边数起第x个像素开始显示图像，参数值范围：0 ~ 127 * @param y - 指定在纵向从上边数起的第y个像素开始显示图像，参数值范围：0 ~ 64 * @param fontColor - 字体颜色的RGB值 * @param backgroundColor - 背景颜色的RGB值 * @param str - 待显示的字符串 * * @warning 16x16汉字 的需要先在此文件中定义FONT_TABLE_CHINESE_16x16 */ void halTFTShowX16(uint16 x, uint16 y, uint16 fontColor, uint16 backgroundColor, const uint8 *str); /** * @fn halTFTShowPicture * * @brief Show Picture * * @param x - 指定在横向从左边数起第x个像素开始显示图像，参数值范围：0 ~ 127 * @param y - 指定在纵向从上边数起的第y个像素开始显示图像，参数值范围：0 ~ 64 * @param picWidth - 图片的宽度，参数值范围：1~128 * @param picHeight - 图片的高度，参数值范围：1~64 * @param pic - 待显示的图片 */ void halTFTShowPicture(uint8 x, uint8 y, uint8 picWidth, uint8 picHeight, const uint8 *pic); ``` ### **halTFTShowX16 使用详解** TFT显示屏的分辨率为64x128像素，可以把其理解为**64行和128列**的二维表格。halTFTShowX16函数支持显示8x16的标准ASCII字符和16x16的汉字，其中的8x16是指占据8行的16列的字体、16x16是指占据16行和16列的字体。 ### **颜色的RGB值** 上述代码中提及到了RGB值，笔者预定义了一些RGB值作为参考，可以在在hal_tft.h文件中找打相关代码定义： ``` #define HAL_TFT_PIXEL_RED 0xF800 //!< Red. #define HAL_TFT_PIXEL_GREEN 0x07E0 //!< Green. #define HAL_TFT_PIXEL_BLUE 0x001F //!< Blue. #define HAL_TFT_PIXEL_BLACK 0x0000 //!< Black. #define HAL_TFT_PIXEL_WHITE 0xFFFF //!< White. #define HAL_TFT_PIXEL_YELLOW 0xFFE0 //!< Yellow. #define HAL_TFT_PIXEL_GRAY 0xEF7D //!< Gray. ``` <br/> ### **显示屏的引脚配置** 在调用上述显示API前，需要先进行显示屏引脚配置，即将显示器的引脚与CC2530的GPIO接口配置上。TFT显示器包含如下8个引脚： * GND * VCC * SCL * SDA * RES * DC * CS * BLK 虽然TFT显示器的引脚与OLED12864的略有不同，但是引脚配置却是相同的。它们两使用同一份配置代码，具体可参考OLED中的引脚配置说明。 <br/> ### **配置字库** 字库配置方式与OLED12864中使用的方式几乎相同，知识取模参数略有不同：使用**横向取模**，且不进行**字节倒序**。 <br/> ### **配置图库** 由于TFT显示器支持彩色显示，因此其图片取模的方式与OLED12864 的区别较大。在本课程配套的软件工具中找到可以找到“图片取模软件\\Image2Lcd 2.9”，运行软件，如图所示。  >[warning] 如您还没有下载本课程配套的软件工具，可以前往下载页下载：[前往](2316129) ### 导入图片后，按如下参数设置取模方式，点击保存后即可生成对应的图库。  <br/> ## **使用TFT显示API** 在配置好显示屏引脚、字库和图库文件后，调用TFT显示API即可在屏幕上显示内容。打开配套的工程，打开TFT12864文件夹中的main.c，可以看到使用TFT显示器的示例代码。 ### ``` #include "hal_TFT.h" #include "font_rgb_picture.h" #include "hal_delay.h" #define RED HAL_TFT_PIXEL_RED #define GREEN HAL_TFT_PIXEL_GREEN #define BLUE HAL_TFT_PIXEL_BLUE #define YELLOW HAL_TFT_PIXEL_YELLOW #define WHITE HAL_TFT_PIXEL_WHITE #define BLACK HAL_TFT_PIXEL_BLACK void main(void) { setSystemClk32MHZ();//初始化系统时钟频率 halTFTInit(HAL_TFT_PIXEL_WHITE);//初始化TFT屏幕，并指定默认颜色为白色 delayMs(SYSCLK_32MHZ, 500);//延后0.5ms在接着执行下面的代码 while(1) { /* Test1 - 变换屏幕颜色 */ halTFTSetScreen(RED); delayMs(SYSCLK_32MHZ, 500); halTFTSetScreen(GREEN); delayMs(SYSCLK_32MHZ, 500); halTFTSetScreen(BLUE); delayMs(SYSCLK_32MHZ, 500); halTFTSetScreen(YELLOW); delayMs(SYSCLK_32MHZ, 500); halTFTSetScreen(WHITE); delayMs(SYSCLK_32MHZ, 1000); /* Test2 - 显示 8x16 ASCII字符 and 16x16 汉字 */ halTFTShowX16(0, 0, BLACK, WHITE, "今天: 2018/1/31"); halTFTShowX16(0, 16, RED, WHITE, "气温(T & H):"); halTFTShowX16(0, 32, BLUE, WHITE, "Temperature: 25"); halTFTShowX16(0, 48, BLUE, WHITE, "Humidity: 30%"); /* 注意：对于汉字，必须先取字模后存放到汉字字库文件font_chinese_v_16x16.h中*/ delayMs(SYSCLK_32MHZ, 4000);延后4ms halTFTSetScreen(WHITE);//设备屏幕颜色为白色 /* Test3 - 在坐标（40像素, 12像素）处显示分辨率为40x40像素的图片 */ halTFTShowPicture(40,12, 40, 40, Picture_40x40_WeiXinIco); /*注意：对于图片，系需要先取模后存放在字库文件font_v_picture.h中*/ delayMs(SYSCLK_32MHZ, 4000);//延迟 } } ``` <br/> ## **调试仿真** >[danger] 在学习本节课前，需要先掌握基本的程序下载及仿真操作，参考：[程序下载及仿真](2482302) * 按如图所示，把屏幕插入到开发板中   ### * 如果使用的是ZigBee标准板，需按如图所示设置拨码开关  ### * 打开本课程配套工程代码，编译并下载到开发板中，可以看到屏幕循环的显示相应的内容！ <br/> <br/> ## **项目定制** * 如需项目定制开发，可扫码添加项目经理好友（注明“**项目定制**”） * 定制范围：**NB-IoT**、**CATn（4G）**、**WiFi**、**ZigBee**、**BLE Mesh**以及**STM32**、**嵌入式Linux**等IoT技术方案 * 善学坊官网：[www.sxf-iot.com](https://www.sxf-iot.com/)  * 非项目定制**勿扰**，此处**非**技术支持