SPI-1.44TFT彩屏显示驱动库重点API分析

大家好我是 杰哥编程

最近在做项目时需要stm32f103控制TFT1.44彩屏，特来分享一下！
此前发过一篇spi原理和TFT彩屏控制原理，本篇不再做解释:跳转链接->->->->

欢迎关注我的Gitee仓库：https://gitee.com/wrj12138/embedSummary

TFT彩屏显示驱动库重点API分析

本次项目使用1个stm32f103c8t6单片机、一个TFT彩屏-1.44液晶屏

正文

main.c源码

这是一段用屏幕显示英文的main.c中的伪代码↓↓↓↓↓

#include <stdio.h>
#include "spi_tft144.h"
#include "spi_tft144_gui.h"#define MyLCD_Show(m,n,p)     LCD_ShowString(LCD_GetPos_X(F_SIZE,m),LCD_GetPos_Y(F_SIZE,n),p,F_SIZE,false)int main(void)
{LCD_Init();FRONT_COLOR=Color16_LIGHTGRAY;//画笔颜色MyLCD_Show(2,0,"hello init");//在第0行第2列开始显示英文字符 太阳能充电while (1){//update display 一秒采集和显示一次HAL_Delay(1000);FRONT_COLOR=Color16_RED;//字体颜色设置为红色MyLCD_Show(1,6,"hello loop");//显示}
}

从上面这段代码里可以看到关于屏显的变量和函数有如下几个：
FRONT_COLOR，LCD_Init(),LCD_GetPos_X(),LCD_GetPos_Y()，LCD_ShowString(),MyLCD_Show()。

LCD_Init()

其中lcd_init和驱动ic的硬件开发手册相关 不在本文介绍。

FRONT_COLOR

进入查看头文件可以知道是一个全局变量 用来定义画笔的颜色，循环中将其改为红色，可起到警示作用

LCD_GetPos_X()/LCD_GetPos_Y()

/****************************************************************************** @名字    :u16 LCD_GetPos_X(u8 charSize,u8 index)
通过屏幕宽度计算可容纳多少字符后，
定位出想写入第index个位置的字符在屏幕像素点中的实际像素点位置* @函数    :Display strings* @参数    :charSize:  字体大小 本工程默认16index:  用户预设置字符串的起始列坐标* @返回    :经计算后字符串的实际起始列坐标
******************************************************************************/
u16 LCD_GetPos_X(u8 charSize,u8 index)
{if(index<=lcddev.width/(charSize>>1))//(width=128 / charsize>>1=8)=16{return index*(charSize>>1);}return 0;
}

根据以上代码中的注释宏可以知道，
这是一个可以帮咱们算出咱们想写入中英文字符时，
假如我想写在第5个字符的位置
get_pos可以帮我们算出第五个字符在屏幕中实际像素点所在位置
然后他还把charSize 右移了1bit 是因为常用字符大小其实仅有全字的一半宽
说明我想写在第5个字符的位置，实际是在2.5字符的位置
理解的扣理解 不理解的扣眼珠子 同理于LCD_GetPos_Y
得到写入的实际像素点坐标后，
即可由LCD_ShowString函数通过算法开始写入字符

LCD_ShowString()

/****************************************************************************** @名字    :void Show_Str(u16 x, u16 y, u16 fc, u16 bc, u8 *str,u8 size,u8 mode)
显示一个字符串 显示的中英文取模必须在放到lcd_font.h中* @函数    :Display strings* @参数    :x:the bebinning x coordinate of the Chinese and English stringsy:the bebinning y coordinate of the Chinese and English stringsstr:the start address of the Chinese and English stringssize:the size of Chinese and English stringsmode:0-no overlying,1-overlying* @返回    :None
******************************************************************************/
void LCD_ShowString(u16 x, u16 y, const char *str,u8 charSize,bool overlap)
{u16 x0=x;char *srtPtr = (char *)str;if(charSize>32)//{charSize = 32;}while(*srtPtr!=0)//数据未结束{if((u8)(*srtPtr)<0x80){if(*srtPtr=='\r')//回车符号{y+=charSize;x=x0;if(*(srtPtr+1)=='\n')//换行符号{srtPtr++;}}else{LCD_ShowChar(x,y,*srtPtr,charSize,overlap);x+=charSize/2; //字符,为全字的一半}srtPtr++;}else//中文{LCD_ShowChinese(x,y,(u8 *)srtPtr,charSize,overlap);srtPtr+=2; x+=charSize;//下一个汉字偏移}}
}

根据以上代码中的注释宏可以知道， 这是个显示字符的函数
参数x y是起始像素点位置
str是要写入的字符串
charsize上面说过了
mode是否覆盖，可以看到LCD_ShowChar()使用了该参数 具体作用往下看

博主看完源码后 决定还是在这解释吧 后面就不解释了
现在可能看不懂 所以大家看到后面记得回过来这理解下是什么意思
如果覆盖就是 要写入的点位 字符编码如果为空/即当前bit为0
则用预设好的全局变量背景颜色BACK_COLOR写到该像素点上

函数实现详解：
字符最大知能32号字体
遍历字符串如果是常用字符（即ascii码小于0x80的字符）
有回车就显示在下一行
LCD_ShowChinese显示中文 同理 我们只讲LCD_ShowChar
然后我们来看看它内部如何实现显示常用字符的 即LCD_ShowChar(0,0,‘!’,12,0)

LCD_ShowChar(0,0,‘!’,12,0)

/****************************************************************************** @名字    :void LCD_ShowChar(u16 x,u16 y,u16 fc, u16 bc, u8 num,u8 size,u8 mode)* @函数    :Display a single English character* @参数    :x:the bebinning x coordinate of the Character display positiony:the bebinning y coordinate of the Character display positionnum:the ascii code of display character(0~94)size:the size of display charactermode:0-no overlying,1-overlying* @返回    :None
******************************************************************************/
void LCD_ShowChar(u16 x,u16 y, u8 charCode,u8 charSize,bool overlap)
{u8 *matrixPtr;if(x>(lcddev.width-charSize/2)||y>(lcddev.height-charSize)) return; charCode=charCode-' ';//得到偏移后的值LCD_SetWindows(x,y,x+charSize/2-1,y+charSize-1);//设置单个文字显示窗口switch(charSize){#ifdef FONT_ASCII_12case 12:matrixPtr=(u8 *)asc2_1206;break;#endif#ifdef FONT_ASCII_16case 16:matrixPtr=(u8 *)asc2_1608;break;#endifdefault:break;}matrixPtr += charCode*My_Font_GetCodeSize_ASCII(charSize);LCD_DrawMatrixCode(x,y,charSize/2,charSize,matrixPtr,overlap);LCD_SetWindows(0,0,lcddev.width-1,lcddev.height-1);//恢复窗口为全屏
}

这里我们用LCD_ShowChar(0,0,‘!’,12,0)这些参数进行举例 下面解释会用到
1 前面我们说了LCD_GetPos_X()帮助我们算了一下 128pix宽的屏幕能放下几个字符
所以不难懂 LCD_ShowChar函数第一步就帮我们判断
现在写入的像素点位置是否超出了屏幕最大宽高像素
否则直接不写 忽略掉
(所以这是有优化空间的，用户是否需要因为显示文字过长 把字符放到下一行)
2 LCD_SetWindows() 是驱动ic自带的功能
可以设置即将被操作的目标矩形窗口的4个点的坐标位置
点进去看函数实现就是一些寄存器操作
不做详细分析 知道原理就行 人家ic自带的功能 咱们用就是了
3 前面说到取模 这时候来了 取模的数组列表放在了固定的头文件内
这时候我们根据charSize拿出模型库数组列表
case 12:matrixPtr=(u8 *)asc2_1206;break;
4 根据我们的字符ascii码
找到模型库数组列表中对应的指针matrixPtr位置
matrixPtr += charCode*My_Font_GetCodeSize_ASCII(charSize)
5 LCD_DrawMatrixCode() 开始写像素点
这个函数里覆盖正式起到作用 记得往上翻到前面的解释看一看
写的过程不好说 但是我可以举例一下 如写入一个感叹号’!’

0x00,0x00,0x00,0x10,0x10,0x10,0x10,0x10,0x10,0x10,0x00,0x00,0x10,0x10,0x00,0x00,/*"!",1*/

16个byte 8bit 16x8=128个像素点 正好对上咱们对常用字符字号16的半字大小的像素点数 如下图：

·-··-··-··-··-··-··-··-·
·-··-··-··-··-··-··-··-·
·-··-··-··-··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··-··-··-··-··-·
·-··-··-··-··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··#··-··-··-··-·
·-··-··-··-··-··-··-··-·
·-··-··-··-··-··-··-··-·  

一次写8个bit进去 多了 下次写 我们的字符大小8x16 所以刚刚好每次能写1个byte进去
LCD_DrawMatrixCode()函数的实现再往底层细究就是寄存器操作
同理不在本文章中解释

MyLCD_Show()

宏 对上面3个api的合并封装

差点忘记放源码了 放我gitee仓库了

我的tft spi驱动库gitee链接->->->->跳转：https://gitee.com/wrj12138/embedSummary/tree/master/SolarTrackingSystem

看代码是真累啊 。。。 本次分享到此为止，如有问题欢迎各位指出！！！

库了
我的tft spi驱动库gitee链接->->->->跳转：https://gitee.com/wrj12138/embedSummary/tree/master/SolarTrackingSystem

看代码是真累啊 。。。 本次分享到此为止，如有问题欢迎各位指出！！！