Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alankrantas/micropython_GT30L24T3Y_big5_font
從 GT30L24T3Y/ER3303-1 字庫芯片讀取 BIG-5 漢字的簡易 MicroPython 驅動程式
https://github.com/alankrantas/micropython_GT30L24T3Y_big5_font
er3303-1 font gt30l24t3y spi
Last synced: 3 months ago
JSON representation
從 GT30L24T3Y/ER3303-1 字庫芯片讀取 BIG-5 漢字的簡易 MicroPython 驅動程式
- Host: GitHub
- URL: https://github.com/alankrantas/micropython_GT30L24T3Y_big5_font
- Owner: alankrantas
- License: gpl-3.0
- Created: 2021-08-12T17:21:49.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2021-08-20T18:38:51.000Z (about 3 years ago)
- Last Synced: 2024-04-22T12:33:50.238Z (7 months ago)
- Topics: er3303-1, font, gt30l24t3y, spi
- Language: Python
- Homepage:
- Size: 752 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-micropython - micropython_GT30L24T3Y_big5_font - MicroPython driver for reading BIG-5 Chinese characters from GT30L24T3Y / ER3303-1 SPI module. (Libraries / Display)
README
# 從 GT30L24T3Y/ER3303-1 SPI 字庫芯片讀取 BIG-5 漢字的簡易 MicroPython 驅動程式
GT30L24T3Y 又名 ER3303-1 是高通 (Genitop，不是那個 Qualcomm) 生產的[眾多字庫晶片](http://www.mitsutech.com.tw/vision_T/product_genitop0.htm)之一，如今還可以買到，但網路上找不到什麼操作範例，原始文件也寫得不是很清楚。花了一番功夫，總算搞懂是怎麼運作的了。
## 使用
把 [big5.py](https://github.com/alankrantas/micropython_Big5_GT30L24T3Y_ER3303-1/blob/main/big5.py) 內的 getBig5Font 函式拷貝到你的程式中即可。其呼叫參數如下：
```python
getBig5Font(spi, cs, font_code, font_size, raw=False, printout=False)
```
| 參數 | 意義 |
| --- | --- |
| spi | SPI 物件 (machine.SPI 或 machine.SoftSPI) |
| cs | CS 腳位物件 (machine.Pin) |
| font_code | BIG-5 字碼 (字串或數值, 如 'A140' 或 0xA140, 參閱[字碼表](http://web.tnu.edu.tw/me/study/moodle/tutor/vb6/tutor/r05/index.htm)) |
| font_size | BIG-5 字體大小 (12, 16 或 24) |
| raw | 設為 True 時直接傳回 bytes 陣列, 否則預設傳回 framebuf.FrameBuffer |
| printout | 設為 True 時會在 REPL 印出該字的文字圖檔 |
傳入不正確的 font_code 或 font_size 引數會使它拋出錯誤。SPI 物件的最高 baudrate 只能設為 40 MHz；儘管官方文件指出 GT30L24T3Y 通訊速度可達 80 MHz，但測試上無法這樣穩定運作。
預設下此函式會傳回 MicroPython 的 [FrameBuffer](https://docs.micropython.org/en/latest/library/framebuf.html) 物件，讓你能把它直接貼在某些顯示器模組上。據我所知 [SSD1306 OLED](https://github.com/stlehmann/micropython-ssd1306) 及 [PCD8544/Nokia 5110 LCD](https://github.com/mcauser/micropython-pcd8544) 的驅動程式都會使用 FrameBuffer。
如果你要使用純 bytes 陣列，[ER3303-1 手冊](https://github.com/alankrantas/micropython_GT30L24T3Y_big5_font/blob/main/ER3303-1_Datasheet.pdf)的 12-13 頁有說明字型資料是如何排列的。
## BIG-5 字體
GT30L24T3Y 支援 GB、BIG-5 和 Unicode 三種中文字，以及幾種 ASCII 英數字形。目前我只實作 BIG-5。MicroPython 本身已經提供 8x8 英數字體，BIG-5 本身也有數字和符號等等，所以 ASCII 的部分儘管查詢上更簡單，在此仍比較沒有使用的需要。
GT30L24T3Y 將漢字字庫的索引資料一併存在晶片中，所以查詢時其實要做兩次 SPI 讀寫，第一次是用某字在字碼表的排列順序去查它在晶片裡的 offset，第二次才是把字讀出來。問題就在於，這個已經有點歷史的晶片的 BIG-5 字碼和你在現代軟體得到的結果 (包括用正規 Python 的 ```codecs.encode()```) 會有出入，有很多後面的非中文字並不存在於晶片中，所以還是乖乖用舊的字碼表吧。
可用的 BIG-5 字體有 12x12、16x16 及 24x24 像素三種尺寸 (正確來說是 11x12，15x16 與 24x24)。有趣的是 Unicode 字庫似乎跟 BIG-5 是共用的，只不過是改成讓你用 Unicode 字碼來查詢而已，但我並不清楚此晶片使用的 Unicode 編碼順序 (用 ```ord()``` 取得的字碼跟晶片用的似乎不太一樣)。另外就文件的說法，24x24 字體只支援基本中文字，所以字碼不能超過 E1BC。
## 測試
我在圖中用的是 Raspberry Pi Pico 與 SSD1306，但這應該也適用於 ESP8266/ESP32。我用的 MicroPython 版本為 v1.16。
GT30L24T3Y 接線 (使用 SPI0 硬體腳位)：
| 腳位 | 接線 |
| --- | --- |
| GND | GND |
| 3.3-5V | 3.3V |
| CS | GPIO 17 |
| SI (MOSI) | GPIO 19 |
| SO (MISO) | GPIO 16 |
| SCK | GPIO 18 |
SSD1306 接線 (使用 I2C1 硬體腳位)：
| 腳位 | 接線 |
| --- | --- |
| VCC | 3.3V |
| GND | GND |
| SCL | GPIO 27 |
| SDA | GPIO 26 |
下面的範例會用不同大小印出一連串文字。你可以先在字碼表查詢你要使用的字，並建一個 Python 字典當對照表。不過由於 MicroPython 是基於 Python 3.4，走訪字典內容時不會照元素的存入順序印出，所以你仍得用另外的方式 (比如一個串列) 來走訪。
```python
# 前面貼上 getBig5Font() 函式
# 字碼對照表
data = {
'我': 'A7DA',
'要': 'AD6E',
'代': 'A54E',
'替': 'B4C0',
'月': 'A4EB',
'亮': 'AB47',
'懲': 'C367',
'罰': 'BB40',
'你': 'A741',
}
# 要顯示的文字
text = '我要代替月亮懲罰你'
from machine import Pin, I2C, SPI
from ssd1306 import SSD1306_I2C # https://github.com/stlehmann/micropython-ssd1306
spi = SPI(0, baudrate=40000000, sck=Pin(18), mosi=Pin(19), miso=Pin(16))
cs = Pin(17, Pin.OUT, value=1)
display = SSD1306_I2C(128, 64, I2C(1, scl=Pin(27), sda=Pin(26)))
display.fill(0)
pos = 0
for t in text:
display.blit(getBig5Font(spi, cs, data[t], font_size=12), pos, 0) # 印上文字
pos += 12
pos = 0
for t in text:
display.blit(getBig5Font(spi, cs, data[t], font_size=16), pos, 18)
pos += 16
pos = 0
for t in text:
display.blit(getBig5Font(spi, cs, data[t], font_size=24), pos, 40)
pos += 24
display.show() # 顯示文字
buf = getBig5Font(spi, cs, data['月'], font_size=24, raw=True, printout=True)
print(buf)
```
最後兩行會在主控台印出
```
------------------------
------------------------
------------------------
#-----------------------
-#----------------------
-##---------------------
--###-------------------
---####################-
-----#################--
----------#-----#----#--
----------#-----#----#--
----------#-----#----#--
----------#-----#----#--
----------#-----#----#--
--#-------#-----#----#--
--#-------#-----#----#--
###-------#-----#----#--
-######################-
--#####################-
---------------------#--
------------------------
------------------------
------------------------
------------------------
b'\x00\x00\x00\x00\x00\x00\x00\xfe\xfc\x84\x84\x84\x84\x84\x84\x84\x84\xfe\xfe\x04\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xff\xff \xff\xff\x00\x00\x00\x00\x00\x00\x00\x00\x80@`8\x1f\x07\x00\x00\x00\x00\x00 \xe0\x7f?\x00\x00\x00\x00\x00'
```