ucGUI加载“完整”外部字库的方法(1)——从外扩NOR Flash中加载

时间:2023-02-04 12:29:36

 

CPU:LPC2478
NOR Flash:MX29LV640EB

typedef __packed struct {
    U8  XSize;
    U8  XDist;
    U8  BytesPerLine;
    const unsigned char GUI_UNI_PTR * pData;
} GUI_CHARINFO;


 

在我的平台下,外部NOR Flash的起始地址是0x80000000,其容量是8MB。我使用ucGUI提供的字库工具生成的4位抗锯齿字库大小为1.8M字节(此为经过计算后纯字库数据的大小)。考虑到字库内容的连续性,在NOR Flash中为字库存储分配一个固定的区域,在我的工程中将其配置为0x80600000,从该地址开始还有2M的存储空间。

程序中做如下定义(代码中的一些数字的意义后文解释):

#define  GUI_FONT_HWZS_NORFLASH_BASE  (0x80600000)
#define  GUI_FONT_HWZS_PROP_SIZE   (1008)
#define  GUI_FONT_HWZS_CHARINFO_SIZE  (48167)
#define  GUI_FONT_HWZS_DATA_SIZE   (1806048)

GUI_FONT_PROP  *GUI_Font_hwzs_22AA4_Prop    = (GUI_FONT_PROP  *)(GUI_FONT_HWZS_NORFLASH_BASE);
GUI_CHARINFO   *GUI_Font_hwzs_22AA4_CharInfo  = (GUI_CHARINFO  *)(GUI_FONT_HWZS_NORFLASH_BASE + GUI_FONT_HWZS_PROP_SIZE);
char    *GUI_Font_hwzs_22AA4_CharData  = (char    *)(GUI_FONT_HWZS_NORFLASH_BASE + GUI_FONT_HWZS_PROP_SIZE + GUI_FONT_HWZS_CHARINFO_SIZE);


GUI_FLASH const GUI_FONT GUI_Font_hwzs_22AA4 = 
{
 GUIPROP_AA4_DispChar  ,
 GUIPROP_AA4_GetCharDistX ,
 GUIPROP_AA4_GetFontInfo  ,
 GUIPROP_AA4_IsInFont  ,
   &GUI_ENC_APIList_SJIS        ,
    24 /* height of font  */    ,
    24 /* space of font y */    ,
    1 /* magnification x */     ,
    1 /* magnification y */     ,
    (void GUI_FLASH *)((GUI_FONT_PROP  *)(GUI_FONT_HWZS_NORFLASH_BASE))
};


 


借助Visual Studio 2008进行了字库二进制文件的生成。

注意:用ucGUI字库生成工具生成的字库中文字编码是UNICODE的,需要使用一个软件将其序号转换成GB2312的模式。我们使用KEIL软件的时候,在代码中写入中文,在编译时,会将其识别为GB2312编码而不是UNICODE编码。另外就是GB2312编码中汉字是连续的,而在UNICODE编码中,常用汉字可能并不连续。

ucGUI的字库文件可以分为几个部分:
1.定义字体。结构体类型:GUI_FONT。就是前文定义的结构体GUI_Font_hwzs_22AA4。
2.定义PROP。结构体类型:GUI_FONT_PROP。就是当前的字库文件中所有文字的分区。文字越分散,生成的PROP结构体个数就越多。这些结构体构成了一种单向链表。
3.定义CHARINFO。结构体类型:GUI_CHARINFO。这个结构体占用7个字节,但是在计算其size的时候,MDK应该会返回8,所以要修改该结构体的定义,加上__packed。
4.定义字库数组。char型数组。

ucGUI通过以上多级定义,可以比较快速地定位到文字所对应的数组。如果MCU的片内FLASH足够大,那么这些数据都会被链接到特定的地址上去。那么使用VS2008生成对应的字库文件,也要模拟字库数据在片内FALSH的存储方式,这里主要是GUI_FONT_PROP内容的准确性。

字体名GUI_Font_hwzs_22AA4要定义在代码中,文件中要补充PROP、CHARINFO和字库DATA。前文,我们定义了字库数据在NOR Flash中的起始地址,在此也要起到作用。

字库文件首先要保存第一个PROP结构体的内容,GUI_FONT_PROP的size是12。先看看生成的第一个PROP结构体的内容:

GUI_FLASH const GUI_FONT_PROP GUI_Font_hwzs_24AA4_Prop83 = {
   0x0020
  ,0x007E
  ,&GUI_Font_hwzs_24AA4_CharInfo[0]
  ,(GUI_FONT_PROP GUI_FLASH *)&GUI_Font_hwzs_24AA4_Prop82
};


 

我生成的这个字库文件*有84个分区,那么PROP区的大小就是84*12,就是GUI_FONT_HWZS_PROP_SIZE的定义。

PROP区之后就是CHARINFO区,这个数据区的大小也是可知的。生成的字库文本中有定义GUI_FLASH GUI_CHARINFO GUI_Font_hwzs_24AA4_CharInfo[6881]。GUI_CHARINFO的大小是7字节,注意是__packed之后的,否则sizeof(GUI_Font_hwzs_24AA4_CharInfo)得到的数值不正确。当然也可以用特殊的方式填充一个字节,不过那样操作的话,大概就破坏了原ucGUI的结构。6881*7就是GUI_FONT_HWZS_CHARINFO_SIZE的定义。

如此每个数据区的地址就确定了,在保存文件的时候,依次保存各个结构体、数组,所有涉及到指针的地方,都要计算出正确的地址来保存。该“地址”要根据GUI_FONT_HWZS_NORFLASH_BASE做适当的偏移。

该文件可以使用JLINK直接下载到片外的NOR FLASH中,也可以通过文件系统,从U盘、SD卡读出后写入NOR Flash。

在使用该字体之前,字体数据必须已经保存在NOR FLASH中了,否则使用该字体的时候,会因为ucGUI读取了错误的数据而进入死循环。

对该字体的使用没有其他特别的要求,跟使用内部ucGUI附带的其他字库的操作是一样的,只需要设置字体,就可以正确显示。