前言
手上有一块吃灰已久的TTGO-esp32开发板,他长这样:
于是想拿出来用micropython点个屏玩玩,屏幕驱动IC型号是st7789,github查找了一番,发现外国友人已经适配好了驱动,英文字符显示也有了,链接:https://github.com/russhughes/st7789_mpy.git
,不过我们想要显示汉字那就得自己动手加上去了。这部分工作我已经适配好了,这里就不展开来讲了。
所有内容已经维护在gitee仓库了https://gitee.com/l_y_r/ttgo-chinese-character-display/tree/master
可以直接前往仓库下载体验。
下面详细说说如何显示汉字。
汉字库的制作
因为esp32存储太小我们自然不会把整个汉字库都放进去,最好是用到哪些汉字就把哪些字的点阵加进去,节省空间。我的汉字显示接口是采取unicode编码索引的,那么就要制作Unicode汉字库。因为我们是按需取字模,所以还是要自己手动制作字库。为了方便我写好了自动转换字库文件的py脚本(cnfont_from_bin.py)。
字库生成经过的步骤为 :
- unicode.bin文件生成,生成指定字体及大小unicode全部汉字bin文件作为后续取字模的源文件
- font.py 文件生成,使用
cnfont_from_bin.py
工具,将从上步的unicode.bin文件里按指定字生成出我们的py字库文件。 - 得到自己制作好的font.py文件后,就可以上传到板子里代码导入使用了。
上面简单叙述了字库制作的主要流程,
下面详细讲解:
生成py字库教程
-
先选好自已要制作的字体大小以及字型,比如要制作16*16宋体的字库,那么先用字库生成工具生成unicode全汉字的字库bin文件,比如我使用的一个字库工具下载链接
http://www.gaotongfont.cn/font-id-187.html
。当然我已经生成好了4种大小的子库bin文件放在了make_font_tool/font_bin
目录下。 -
使用
cnfont_from_bin.py
转换工具把我们需要转换的汉字生成py字库文件。
命令行使用例子:
cnfont_from_bin.py unicn_16x16.bin unicn_16x16.py -w 16 -s "你好啊"
其中第一个参数就是输入的bin字库文件,第二个参数是输出的py字库文件,-w传入字宽,-s传入要生成字库的汉字文本(重复的汉字只会在字库里生成一次点阵)
如下图:
-
生成的unicn_16x16.py文件就是需要的字库了,当然为了压缩该文件体积也可以使用mpy-cross工具把他编译成字节码bin文件。
st7789屏幕显示mod的API接口说明
st7789驱动模组来自于该仓库:https://github.com/russhughes/st7789_mpy.git
详细的使用说明也在该仓库的readme文档里了, 我在此模组基础上增加了一个显示汉字的接口:
text_ch(font, s, x, y[, fg, bg])
使用指定的位图字体将文本写入显示器,坐标为文本的左上角。 文本的前景色和背景色可以通过可选参数 fg 和 bg 设置,否则前景色默认为白色,背景色默认为黑色。用法与text()
接口一致,只是字符串只能为中文。
快速上手
所有内容已经维护在gitee仓库了https://gitee.com/l_y_r/ttgo-chinese-character-display/tree/master
可以直接前往仓库下载体验。
上传main.py 以及四种字库py文件到板端:
运行demo演示结果如图:
jpg图片显示