RTGUI 移植经验分享 v0.2.pdf

这篇文章的主要目的是浅谈RTGUI 的底层驱动移植@2016.6.5 。 本人软硬件环境： MCU：STM32F103ZET6 TFT LCD 芯片：ILI9341(像素：320x240) TFT LCD 接口：MCU 模式，16 位80 并口 编译器：KEIL v4.74 （使用scons 的朋友，完成等效操作即可） 题外话：RTGUI 源码更新到v0.8.0 之后，就悄悄地从江湖上隐退，有说是归田园居养老去了， 又有说是闭关修炼镀金去了...对于本菜鸟而言，倍感惋惜。有幸的是，在RT-Thread v2.1 正 式版的源码中，看到了RTGUI 的回归，只是这次将以GUI 引擎（GUI ENGINE）的方式存在， 用于底层的绘图操作（绘点、线、矩形、圆，图像等），强调的是绘图的效率；RTT v2.1 版 本的GUI 引擎中，同时也去掉了触摸屏支持、校准、大部分控件等方面的内容。 附图1 RTGUI 架构 一、将GUI ENGINE 添加到工程项目中： 1.下载到必威体育精装版的RTT 2.1 源码，将其解压，打开目录（..\rt-thread-2.1.0\components ）可以看 到GUI 文件夹，里面就是GUI ENGINE 的源码。 2.MDK 设置文件路径，MDK 新建GUI 目录，添加（..\rt-thread-2.1.0\components\gui\src ）目 录下的所有文件。 3.MDK 添加头文件路劲包含（..\rt-thread-2.1.0\components\gui\include ）： 附图2 RTGUI 环境的搭建 4.修改rtconfig.h 里面的配置，如下图所示： 附图3 GUI ENGINE 配置宏（可根据需要调整） 注意： 1、使用SCONS 的朋友需注意下，新GUI 引擎的开启宏不再是RT_USING_RTGUI，而是 RT_USING_GUIENGINE 2、开启汉字字库支持（即使能RTGUI_USING_FONTHZ 和RTGUI_USING_DFS_FILERW ）须有文 件系统的支持及制作好的汉字字库，否则就注释掉这两个宏 3、我在实际测试时发现，只要打开RTGUI_USING_MOUSE_CURSOR 光标支持，程序跑的时候就 会进入Bus fault，原因未知 4、是否开启图片支持，根据自己需要确定 接下来，就可以进行接口移植等方面的工作。 二、GUI ENGINE 的底层硬件初始化 附图4 rt_hw_lcd_init()函数体 该函数主要完成 LCD 的硬件初始化，这个初始化不仅仅是对LCD 进行初始化，同时也定义 了GUI ENGINE 需要的接口函数。 **************************结合附图4，函数流程说明*************************** 流程 1、构造设备结构体 lcd_device 给 rtt 进行设备注册，通过下图，我们可以看出整个结 构体的具体组成。 附图5 RTT 的设备结构体定义 根据附图5，LCD 设备的各接口函数实现如附图6 所示： 附图6 设备结构体函数实现（供参考） 备注：lcd_control()函数中: Info-bits_per_pixel 即像素深度（BPP），我这里为16 位，对应RGB565 info-pixel_formal 指定了像素格式，我这里使用的是RGB565P，而GUI ENGINE 还提供了 其他多种格式。 Info-width 和 info-height 分别制定液晶屏的宽高(我这里：width = 240，height = 320) 流程2、完成LCD 硬件的初始化，如端口的初始化，LCD 上电初始化序列，背光控制等； 流程 3、rt_hw_lcd_init()函数的关键点是里面的 user_data，也是需要我们进行手动移植 的地方。 附图7 user_data 关联的结构体 附图8 user_data 结构体函数实现（供参考） 备注： 1 附图8 中的LCD_WriteReg()、LCD_SetCursor()等函数是LCD 的基本操作函数，包括：写 寄存器指令、读寄存