Repository navigation
Releases: Kent-Liu/meshtastic-firmware-zhtw
Release list
v2.7.26-zhtw.5
An update to v2.7.26-zhtw.4. The Bopomofo input method picks much better
candidates, the first touch-screen board is supported, and the _zhtw builds now
start on the radio settings the Taiwanese mesh actually runs on. Twelve boards and
fourteen environments, still built on upstream Meshtastic v2.7.26.54e0d8d.
Input method
Candidates are ordered by how common the word is. Typing initials only — ㄋㄏ
for 你好, ㄒㄒ for 謝謝, ㄉㄐ for 大家 — now puts the word you meant at the front
of the list instead of pages down it. The same ordering applies to the words offered
after you pick a character, so carrying on from 中 offers 中國 and 中文 rather than
whatever happened to be filed first.
New boards
Crowpanel Advance 3.5 (elecrow-adv-35-tft_zhtw) — Bopomofo typed on the touch
screen. Tested on hardware. The candidate row expands into a full grid when the
list is longer than it can show. See
touch_input_guide_zhtw.md.
Crowpanel Advance 4.3 / 5.0 / 7.0 (elecrow-adv1-43-50-70-tft_zhtw) — Chinese
display only; the keyboard stays the stock English one. Not yet tested on hardware.
Radio defaults
The _zhtw builds now default to region TW, the MediumFast preset and frequency
slot 1, which is what the Taiwanese community uses. Defaults are only written to a
device that has no settings of its own, so this reaches a fully erased ESP32 and
nothing else: existing nodes, and nRF52 boards updated by dropping a .uf2, keep the
configuration they already have. A node set this way cannot hear one left on the stock
LongFast preset, and all of it stays editable in the app.
Flashing script
zhtw-flash-scripts.zip is attached to this release. It wraps the two esptool
commands the walkthrough describes: it finds the firmware files sitting next to it,
asks which one to flash, and warns before erasing. zhtw-flash.sh for macOS and
Linux; zhtw-flash.cmd plus zhtw-flash.ps1 for Windows, where you double-click the
.cmd.
Known limitations
- The words offered after you pick a character appear on the on-screen keyboard and
the touch keyboard, but not on the Cardputer Adv or the CardKB. Typing on those two
is otherwise unchanged. - Crowpanel Advance 4.3 / 5.0 / 7.0 renders Chinese but has no Bopomofo keyboard.
Tested
- Crowpanel Advance 3.5: confirmed on hardware.
- GAT562 Family: the input method changes confirmed on hardware.
- Crowpanel Advance 4.3 / 5.0 / 7.0, Heltec V4, Heltec V4 R8, Wio
Tracker L1 E-Ink, and the two Pro-micro DIY Bopomofo builds: not tested — I do not
have this hardware. A report back would be much appreciated. - Everything else is unchanged from
v2.7.26-zhtw.4apart from the input method and
the radio defaults above.
Guides
- keyboard_input_guide_zhtw.md — physical keyboard boards
- touch_input_guide_zhtw.md — touch screen boards
Files
| File | Board | md5 |
|---|---|---|
firmware-gat562_family_zhtw-2.7.26-1951b52.uf2 |
GAT562 Family | 6667ce9cb02d150e19d188b7cf70caad |
firmware-wio_tracker_L1_zhtw-2.7.26-1951b52.uf2 |
Seeed Wio Tracker L1 / L1 Lite / L1 Pro | 6fcb43c1c5913b47ef7927792e56a93c |
firmware-wio_tracker_L1_eink_zhtw-2.7.26-1951b52.uf2 |
Seeed Wio Tracker L1 E-Ink | 4ebbbe04f5371058d94c22dfabfafa34 |
firmware-heltec_v3_zhtw-2.7.26-1951b52.factory.bin |
Heltec LoRa32 V3 | 9dfbcf8cd0ff60594a18357462c9d459 |
firmware-heltec_wireless_paper_zhtw-2.7.26-1951b52.factory.bin |
Heltec Wireless Paper (V1.1 and later) | 21cc3d56fcdb6209606a3f4f3553f882 |
firmware-heltec_mesh_node_t114_zhtw-2.7.26-1951b52.uf2 |
Heltec Mesh Node T114 | 18dc09fc790e699f774f7996ffacf31d |
firmware-heltec_v4_zhtw-2.7.26-1951b52.factory.bin |
Heltec V4 (OLED) | 4bfbdc3d8d02d5d008ff896d4aed00a5 |
firmware-heltec_v4_r8_oled_zhtw-2.7.26-1951b52.factory.bin |
Heltec V4 R8 (OLED) | ba25920bbf16347b00bf8e73fe5e5f73 |
firmware-cardputer_adv_zhtw-2.7.26-1951b52.factory.bin |
M5Stack Cardputer Adv | ff8e4fd3150a5df7ba46861cd137cf0a |
firmware-elecrow_adv_35_tft_zhtw-2.7.26-1951b52.factory.bin |
Crowpanel Advance 3.5 TFT | f6dc83f30e7185af3ff6cde4d0e16250 |
firmware-elecrow_adv1_43_50_70_tft_zhtw-2.7.26-1951b52.factory.bin |
Crowpanel Advance 4.3 / 5.0 / 7.0 TFT — display only (untested) | 26caeb19da8eb3a5c17302c715f455e7 |
firmware-nrf52_promicro_diy_tcxo_zhtw-2.7.26-1951b52.uf2 |
NRF52 Pro-micro DIY — display only | c9e22509489d7a4b4b1d95693a3d375e |
firmware-nrf52_promicro_diy_tcxo_ime_zhtw-2.7.26-1951b52.uf2 |
NRF52 Pro-micro DIY — Bopomofo, on-screen keyboard (untested) | e2dd96d6197ced07ead8a9e79a8c1e71 |
firmware-nrf52_promicro_diy_tcxo_kb_zhtw-2.7.26-1951b52.uf2 |
NRF52 Pro-micro DIY — Bopomofo, I2C keyboard (M5Stack CardKB) (untested) | 74aa49abb9f0d3a39fa30cd7629ea7d6 |
zhtw-flash-scripts.zip |
Flashing helper scripts (Windows / macOS / Linux) | 2a64ed8170afff8e88a41ba8a4f4dcf7 |
.uf2: double-tap reset and copy the file onto the bootloader drive.
.factory.bin: a full image written at offset 0, overwriting stored settings.
For ESP32 boards, flash with esptool, not the flasher.meshtastic.org web
tool — its "upload your own firmware" path mishandles these images and can leave
the device unable to boot. Walkthrough, including where to get esptool without
installing Python:
flashing_esp32_zhtw.md.
No warranty
These builds come with no warranty of any kind, express or implied. Flashing
firmware can leave a device unusable, and a mesh radio running unverified firmware
may behave in ways you do not expect. Use them at your own risk. This is a
pre-release.
Licence
GPL-3.0, as upstream. The glyph tables hold rasterised bitmaps rather than font
files; terms for every font and dictionary in the chain are in licenses/.
Not affiliated with or endorsed by the Meshtastic project. Meshtastic(R) is a
registered trademark of Meshtastic LLC.
繁體中文說明
v2.7.26-zhtw.4 的更新版。這一版注音選字準了很多，新增第一款觸控機種，_zhtw
韌體的無線電出廠預設也換成台灣社群實際在用的設定。機種十二款、環境十四個，一樣
基於上游 Meshtastic v2.7.26.54e0d8d。
輸入法
候選字改以詞頻排序。 只打聲母——ㄋㄏ 打「你好」、ㄒㄒ 打「謝謝」、ㄉㄐ
打「大家」——想打的詞現在會排在最前面，不必往後翻好幾頁。選完一個字之後接著推薦的
詞也照同一套排序，所以選了「中」會出現「中國」「中文」這類常用的詞。
新增機種
Crowpanel Advance 3.5 吋（elecrow-adv-35-tft_zhtw）——觸控螢幕鍵盤打注音。
已實機測試。 候選字太多時可以展開成整面的候選面板。操作方式見
touch_input_guide_zhtw.md。
Crowpanel Advance 4.3／5.0／7.0 吋（elecrow-adv1-43-50-70-tft_zhtw）——
只有中文顯示，鍵盤仍是原廠的英文鍵盤。尚未實機測試。
無線電出廠預設
_zhtw 韌體的預設值改為區域 TW、MediumFast、頻率槽 1，這是台灣社群常用的設定。
預設值只會寫進「還沒有任何設定」的裝置，所以只有全部清除後重新燒錄的 ESP32 才會
套用；既有節點，以及用 .uf2 更新的 nRF52 機種，都維持原本的設定。這樣設定的節點
聽不到還停在原廠 LongFast 的機器，這些之後都還能在 App 裡自行更改。
燒錄腳本
這一版起附上 zhtw-flash-scripts.zip。 它就是把說明裡那兩道 esptool 指令包
起來：自動找出放在旁邊的韌體檔、問你要燒哪一支，清除裝置之前會先確認。macOS 與
Linux 用 zhtw-flash.sh；Windows 用 zhtw-flash.cmd 加 zhtw-flash.ps1，直接
雙擊 .cmd 即可。
已知限制
- 選完一個字之後推薦的詞，只有螢幕鍵盤與觸控鍵盤機種會出現，Cardputer Adv 與
CardKB 沒有。那兩台的其他輸入操作沒有改變。 - Crowpanel Advance 4.3／5.0／7.0 顯示得出中文，但沒有注音鍵盤。
測試狀況
- Crowpanel Advance 3.5：已實機確認。
- GAT562 Family：輸入法的改動已實機確認。
- Crowpanel Advance 4.3／5.0／7.0、Heltec V4、Heltec V4 R8、
Wio Tracker L1 E-Ink，以及兩款 Pro-micro DIY 注音版本：尚未實機測試，我手邊
沒有這些硬體，還請有設備的朋友幫忙回報。 - 其餘機種除了上面的輸入法與無線電預設之外，與
v2.7.26-zhtw.4相同。
操作說明
- keyboard_input_guide_zhtw.md——實體鍵盤機種
- touch_input_guide_zhtw.md——觸控機種
免責
本韌體不提供任何形式的保證。刷機有機會讓裝置無法開機，跑著未經驗證韌體的無線電
節點也可能出現非預期行為。請自行承擔使用風險。 本版為 pre-release。
ESP32 機種請用 esptool 燒錄，不要用 flasher.meshtastic.org 網頁版——
它的「上傳自訂韌體」無法正確處理這些映像檔，可能讓裝置無法開機。操作步驟見
flashing_esp32_zhtw.md。
本專案與 Meshtastic 官方無隸屬關係，亦未經其背書。Meshtastic(R) 為 Meshtastic LLC
的註冊商標。
v2.7.26-zhtw.4
An update to v2.7.26-zhtw.3. Adds five new boards, bringing the total to ten
boards and twelve environments, still built on upstream Meshtastic
v2.7.26.54e0d8d. No changes to the input method itself in this release.
New boards
Heltec Wireless Paper (heltec-wireless-paper_zhtw, V1.1 and later) —
E-Ink, display only. Tested on hardware: Chinese text, emoji, and refresh
all normal.
Heltec Mesh Node T114 (heltec-mesh-node-t114_zhtw) — ST7789 TFT, display
only. Tested on hardware: Chinese text and emoji both normal.
Heltec V4 and Heltec V4 R8 (heltec-v4_zhtw, heltec-v4-r8-oled_zhtw)
— OLED, display only. Not yet tested on hardware.
Seeed Wio Tracker L1 E-Ink (seeed_wio_tracker_L1_eink_zhtw) — E-Ink,
Bopomofo on the on-screen keyboard (joystick navigation, same as the Wio
Tracker L1 OLED build). Not yet tested on hardware.
Known limitations
- The Wireless Paper has a single button and no way to scroll a long message;
you only ever see the start of it. This is an existing upstream limitation
on all E-Ink boards, not something this release introduces. - The Wio Tracker L1 E-Ink build has about 37 KB (4.6%) of its app partition
free, the tightest margin here after the two Pro-micro DIY Bopomofo builds. - The T114 and Wio Tracker L1 E-Ink builds ship a trimmed set of external I2C
sensor drivers (BMP280/BME280, AHT20, SHT31, INA219/INA260, MAX17048, and a
few others) rather than the full upstream list, to make room for the glyph
table.
Tested
- Heltec Wireless Paper, Heltec Mesh Node T114: confirmed on hardware,
see above. - Heltec V4, Heltec V4 R8, Wio Tracker L1 E-Ink: not yet tested —
if you have one of these boards, a report back would be much appreciated. - Everything else — GAT562 Family, Wio Tracker L1 (OLED), Heltec V3, Cardputer
Adv, the three NRF52 Pro-micro DIY builds — is unchanged from
v2.7.26-zhtw.3; see that release for their test status.
Files
| File | Board | md5 |
|---|---|---|
firmware-gat562_family_zhtw-2.7.26-3262776.uf2 |
GAT562 Family | 13cf58591c1486ae3b0a30fa1ee70631 |
firmware-wio_tracker_L1_zhtw-2.7.26-3262776.uf2 |
Seeed Wio Tracker L1 / L1 Lite / L1 Pro | a3ef9ac4bb51982f070aff977734410a |
firmware-wio_tracker_L1_eink_zhtw-2.7.26-3262776.uf2 |
Seeed Wio Tracker L1 E-Ink | 11b1f63dc466f5d07fe4fc9c2b3105b4 |
firmware-heltec_v3_zhtw-2.7.26-3262776.factory.bin |
Heltec LoRa32 V3 | 2c7d35178c3b687e651a37ab24e653b1 |
firmware-heltec_wireless_paper_zhtw-2.7.26-3262776.factory.bin |
Heltec Wireless Paper (V1.1 and later) | 23e70770db85e18b1d916d5be4dd19ed |
firmware-heltec_mesh_node_t114_zhtw-2.7.26-3262776.uf2 |
Heltec Mesh Node T114 | 75749121f42428f564c36bda522dc1d4 |
firmware-heltec_v4_zhtw-2.7.26-3262776.factory.bin |
Heltec V4 (OLED) | 5b4733db61d69bc2e7b0ab73824b887c |
firmware-heltec_v4_r8_oled_zhtw-2.7.26-3262776.factory.bin |
Heltec V4 R8 (OLED) | 2401039713170c153e0d97a815758ed4 |
firmware-cardputer_adv_zhtw-2.7.26-3262776.factory.bin |
M5Stack Cardputer Adv | e3ed1bd922388f38c9b2ee8396ee11bc |
firmware-nrf52_promicro_diy_tcxo_zhtw-2.7.26-3262776.uf2 |
NRF52 Pro-micro DIY — display only | 7f00d7db409df8e0cba9f6ab9aae075a |
firmware-nrf52_promicro_diy_tcxo_ime_zhtw-2.7.26-3262776.uf2 |
NRF52 Pro-micro DIY — Bopomofo, on-screen keyboard (untested) | 47a6110fc7b0f7c0864727503389e626 |
firmware-nrf52_promicro_diy_tcxo_kb_zhtw-2.7.26-3262776.uf2 |
NRF52 Pro-micro DIY — Bopomofo, I2C keyboard (M5Stack CardKB) (untested) | 6e3057dc7f4844e5e4f0b1c7a38cab7d |
.uf2: double-tap reset and copy the file onto the bootloader drive.
.factory.bin: a full image written at offset 0, overwriting stored settings.
For ESP32 boards, flash with esptool, not the flasher.meshtastic.org web
tool — its "upload your own firmware" path mishandles these images and can
leave the device unable to boot. Walkthrough, including where to get
esptool without installing Python:
flashing_esp32_zhtw.md.
No warranty
These builds come with no warranty of any kind, express or implied.
Flashing firmware can leave a device unusable, and a mesh radio running
unverified firmware may behave in ways you do not expect. Use them at your
own risk. This is a pre-release.
Licence
GPL-3.0, as upstream. The glyph tables hold rasterised bitmaps rather than
font files; terms for every font and dictionary in the chain are in
licenses/.
Not affiliated with or endorsed by the Meshtastic project. Meshtastic(R) is a
registered trademark of Meshtastic LLC.
繁體中文說明
v2.7.26-zhtw.3 的更新版，新增五款機種，機種數變成十款、環境變成十二個，一樣
基於上游 Meshtastic v2.7.26.54e0d8d。這一版輸入法本身沒有異動。
新增機種
Heltec Wireless Paper（heltec-wireless-paper_zhtw，V1.1 及以後）——E-Ink，
純顯示。已實機測試：中文顯示、emoji、刷新都正常。
Heltec Mesh Node T114（heltec-mesh-node-t114_zhtw）——ST7789 TFT，純顯示。
已實機測試：中文與 emoji 顯示都正常。
Heltec V4 與 Heltec V4 R8（heltec-v4_zhtw、heltec-v4-r8-oled_zhtw）
——OLED，純顯示。尚未實機測試。
Seeed Wio Tracker L1 E-Ink（seeed_wio_tracker_L1_eink_zhtw）——E-Ink，
螢幕鍵盤走搖桿注音輸入（導覽方式與 Wio Tracker L1 OLED 版相同）。尚未實機測試。
已知限制
- Wireless Paper 只有一顆按鍵，長訊息沒辦法捲動，只看得到開頭。這是上游對所有
E-Ink 機種的既有限制，不是這版新增的問題。 - Wio Tracker L1 E-Ink 只剩約 4.6% 餘裕，是這裡除了兩款 Pro-micro DIY 注音版本外
最緊的一台。 - T114 與 Wio Tracker L1 E-Ink 的外接 I2C 感測器驅動經過精選（BMP280/BME280、
AHT20、SHT31、INA219/INA260、MAX17048 等），不是上游的完整清單，用來換字型的空間。
測試狀況
- Heltec Wireless Paper、Heltec Mesh Node T114：已實機確認，如上。
- Heltec V4、Heltec V4 R8、Wio Tracker L1 E-Ink：尚未實機測試，
還請有這些設備的朋友幫忙回報。 - 其餘機種——GAT562 Family、Wio Tracker L1（OLED）、Heltec V3、Cardputer Adv、
三款 NRF52 Pro-micro DIY——與v2.7.26-zhtw.3相同，測試狀況請見該版說明。
免責
本韌體不提供任何形式的保證。刷機有機會讓裝置無法開機，跑著未經驗證韌體的無線電
節點也可能出現非預期行為。請自行承擔使用風險。 本版為 pre-release。
** ESP32 板子請用 esptool 燒錄，不要用 flasher.meshtastic.org 網頁版**——
它的「上傳自訂韌體」無法正確處理這些映像檔，可能讓裝置無法開機。操作步驟見
flashing_esp32_zhtw.md。
本專案與 Meshtastic 官方無隸屬關係，亦未經其背書。Meshtastic(R) 為 Meshtastic LLC
的註冊商標。
v2.7.26-zhtw.3
An update to v2.7.26-zhtw.2. Same five boards and seven environments, still built
on upstream Meshtastic v2.7.26.54e0d8d. This release refines the Bopomofo input
method: two keyboard layouts on the physical-keyboard boards, input settings that
are remembered, and better candidate ordering.
New
Both Bopomofo layouts, switchable while typing — Dàqiān and Eten ET41. Ctrl+B on
the Cardputer, fn+b on a CardKB. Physical-keyboard boards only. The key does
nothing in English mode.
The last input mode and layout are remembered. Both are written to
/prefs/ime.dat when the keyboard closes and restored next time, including across a
reboot. Boards with an on-screen keyboard remember the Chinese/English mode too.
The mode indicator is now visible, at the top right of the title bar, as
EN / TW/大千 / TW/倚天.
An operating guide for the physical-keyboard boards: layout diagrams, tones,
candidate selection, changing the recipient with Tab — keyboard_input_guide_zhtw.md.
Fixed
Better candidate ordering. Common single characters and words are easier to reach.
Pressing ESC on the input screen crashed the node. The keyboard object could be
freed twice. This is a pre-existing upstream issue, unrelated to Chinese support; it
affects any board that reaches the text input screen and has a way to cancel.
Tested
- Cardputer Adv: layout switching, the mode indicator, persistence, ESC, and
single characters — all confirmed on hardware. - GAT562 Family: candidate order, the 60-second idle timeout, general operation
and Chinese/English persistence — all confirmed on hardware. - Wio Tracker L1, Heltec V3: not retested. Their only changes are the candidate
order and the ESC fix; Heltec is display-only and takes just the ESC fix. - NRF52 Pro-micro DIY (
_ime_zhtw,_kb_zhtw): still untested — I don't have
this hardware myself. If you do, a report back would be much appreciated.
Files
| File | Board | md5 |
|---|---|---|
firmware-gat562_family_zhtw-2.7.26-c798ce4.uf2 |
GAT562 Family | b92c085d11d71a99037d843427579a59 |
firmware-wio_tracker_L1_zhtw-2.7.26-c798ce4.uf2 |
Seeed Wio Tracker L1 / L1 Lite / L1 Pro | c6f93999c8778a5b416d4660932d6d20 |
firmware-heltec_v3_zhtw-2.7.26-c798ce4.factory.bin |
Heltec LoRa32 V3 | 69c799e7f51e0d9894cbe7c1caa0a005 |
firmware-cardputer_adv_zhtw-2.7.26-c798ce4.factory.bin |
M5Stack Cardputer Adv | d7238c42ac8b59d5a4365e6470456e49 |
firmware-nrf52_promicro_diy_tcxo_zhtw-2.7.26-c798ce4.uf2 |
NRF52 Pro-micro DIY — display only | cb30cc6aae3030d151022b0ec0d2d020 |
firmware-nrf52_promicro_diy_tcxo_ime_zhtw-2.7.26-c798ce4.uf2 |
NRF52 Pro-micro DIY — Bopomofo, on-screen keyboard (untested) | 1c269086362b2582cbabc57f43678cff |
firmware-nrf52_promicro_diy_tcxo_kb_zhtw-2.7.26-c798ce4.uf2 |
NRF52 Pro-micro DIY — Bopomofo, I2C keyboard (M5Stack CardKB) (untested) | a668a51575e640863f5c7972443e3c50 |
.uf2: double-tap reset and copy the file onto the bootloader drive.
.factory.bin: a full image written at offset 0, overwriting stored settings.
For the two ESP32 boards, flash with esptool, not the flasher.meshtastic.org web
tool — its "upload your own firmware" path mishandles these images and can leave
the device unable to boot. Walkthrough, including where to get esptool without
installing Python: flashing_esp32_zhtw.md.
No warranty
These builds come with no warranty of any kind, express or implied. Flashing
firmware can leave a device unusable, and a mesh radio running unverified firmware
may behave in ways you do not expect. Use them at your own risk. This is a
pre-release.
Known limitations
- The Cardputer image trades the OTA slot for a 6 MB app partition to fit the full
dictionary. That board cannot be updated over the air. - Wio Tracker L1 leaves about 47 KB of its app partition free; the two NRF52
Pro-micro DIY Bopomofo builds about 3.3%, the thinnest margin here. - All nRF52840 targets are built with
DEBUG_MUTE, so there is no serial log.
Board list, wiring notes for the Pro-micro DIY, and font/dictionary sizes are
unchanged from v2.7.26-zhtw.2.
Licence
GPL-3.0, as upstream. The glyph tables hold rasterised bitmaps rather than font
files; terms for every font and dictionary in the chain are in licenses/.
Not affiliated with or endorsed by the Meshtastic project. Meshtastic(R) is a
registered trademark of Meshtastic LLC.
繁體中文說明
v2.7.26-zhtw.2 的更新版，機種與環境不變（五款機種、七個環境），一樣基於上游
Meshtastic v2.7.26.54e0d8d。這一版的重點都在注音輸入法的優化：Cardputer 支援大千與倚天的鍵盤配置優化、
設定會記住最後使用繁體中文 or 英文的輸入法，以及優化了選字邏輯。
新增
大千與倚天兩套配列，打字中隨時切換。Cardputer 按 Ctrl+B，CardKB 按 fn+b。
只有實體鍵盤機種提供支援，英文模式下這個鍵不作用。
最後輸入中英模式與注音鍵盤模式會被記住。關閉輸入畫面時寫進 /prefs/ime.dat，下次開啟沿用，
重開機也還在。螢幕鍵盤機種同樣會記住中英模式。
模式指示現在真的看得到了，畫在標題列右上端，顯示 EN / TW/大千 / TW/倚天。
新增實體鍵盤機種的操作說明：注音鍵盤配置圖、聲調、選字、用 Tab 更換收件對象——
keyboard_input_guide_zhtw.md。
修正
優化選字邏輯。更容易的選常用單字與詞彙。
輸入畫面按 ESC 會讓節點當掉。鍵盤物件有重複釋放的問題。這是上游的
程式碼既有的問題，與中文支援無關，任何進得了輸入畫面又有取消鍵的機種都會遇到。
測試狀況
- Cardputer Adv：倚天/大千切換、模式指示、設定記憶、ESC、單字都已實機確認。
- GAT562 Family：候選順序、閒置 60 秒自動收起、一般操作、中英模式記憶都已實機確認。
- Wio Tracker L1、Heltec V3：未重新測試。這兩台只被候選排序與 ESC 修正影響，
Heltec 是純顯示，只有 ESC 那一項。 - NRF52 Pro-micro DIY（
_ime_zhtw、_kb_zhtw）：仍未實機測試，我手邊沒有這組硬體。還請有設備的朋友幫忙回報。
檔案
.uf2 的刷法是雙擊 reset，把檔案複製到出現的 bootloader 磁碟機。
.factory.bin 是完整映像檔，寫入 offset 0，會覆蓋包含既有設定在內的整個 flash。
兩支 ESP32 板子請用 esptool 燒錄，不要用 flasher.meshtastic.org 網頁版——
它的「上傳自訂韌體」無法正確處理這些映像檔，可能讓裝置無法開機。操作步驟與免安裝
Python 的 esptool 下載位置見
flashing_esp32_zhtw.md。
免責
本韌體不提供任何形式的保證。刷機有機會讓裝置無法開機，跑著未經驗證韌體的無線電
節點也可能出現非預期行為。請自行承擔使用風險。 本版為 pre-release。
已知限制
- Cardputer 為了塞下完整詞庫，用 6 MB app 分區換掉 OTA 槽，這塊板子無法 OTA 更新。
- Wio Tracker L1 只剩約 47 KB 餘裕；兩款 NRF52 Pro-micro DIY 注音版本只剩約 3.3%，是這裡最緊的。
- 所有 nRF52840 機種都帶
DEBUG_MUTE，沒有 serial log。
機種清單、Pro-micro DIY 的接線說明、字型與字典規模都與
v2.7.26-zhtw.2
相同。
本專案與 Meshtastic 官方無隸屬關係，亦未經其背書。Meshtastic(R) 為 Meshtastic LLC
的註冊商標。
v2.7.26-zhtw.2
Traditional Chinese display and Bopomofo input, built on upstream Meshtastic
v2.7.26.54e0d8d. Seven environments across five boards, each sitting next to its
stock counterpart; no stock environment is modified.
No warranty
These builds come with no warranty of any kind, express or implied. Flashing
firmware can leave a device unusable, and a mesh radio running unverified firmware
may behave in ways you do not expect. Use them at your own risk.
This is a pre-release. What has and has not been checked:
- Every environment here compiles, and so does the stock environment next to it,
from a clean checkout in CI. - The glyph tables and dictionary were verified against the generator output, and
the embedded fonts were confirmed to carry all 37 Bopomofo symbols and the four
tone marks. - GAT562 Family, Wio Tracker L1, Heltec V3 and Cardputer Adv: unchanged from the
previous pre-release apart from the version string. Hardware testing from that
pre-release stands. - Cardputer Adv also gained the
fn+ctoggle described below, for an
externally attached CardKB — that combination has not been tested on hardware;
the built-in keyboard is untouched and still toggles on Ctrl+Space. - NRF52 Pro-micro DIY, display-only (
_zhtw) and I2C-keyboard (_kb_zhtw):
tested on hardware by the contributor — Traditional Chinese rendering, and
Bopomofo input on an M5Stack CardKB including thefn+ctoggle. - NRF52 Pro-micro DIY, on-screen keyboard (
_ime_zhtw): not tested on hardware.
It drives the Bopomofo IME from a 4-way switch or trackball on four pins this
board leaves free; nobody who worked on it has that hardware fitted, so
navigation and the 500 ms long-press to select are unverified. If you have
that wiring, please try it and report back before relying on it.
Files
| File | Board | md5 |
|---|---|---|
firmware-gat562_family_zhtw-2.7.26-02b8725.uf2 |
GAT562 Family | 773c67dba76eb3a223429510d91e217c |
firmware-wio_tracker_L1_zhtw-2.7.26-02b8725.uf2 |
Seeed Wio Tracker L1 / L1 Lite / L1 Pro | fc3a1978333d2461e8dde28cf4e4ada2 |
firmware-heltec_v3_zhtw-2.7.26-02b8725.factory.bin |
Heltec LoRa32 V3 | ddcd8062920f1632b1fff24484660526 |
firmware-cardputer_adv_zhtw-2.7.26-02b8725.factory.bin |
M5Stack Cardputer Adv | 7e673ddf9f64e38075f7c4249ff9991e |
firmware-nrf52_promicro_diy_tcxo_zhtw-2.7.26-02b8725.uf2 |
NRF52 Pro-micro DIY — display only | 273b28a6e4beb40a2bee3b32d0f84106 |
firmware-nrf52_promicro_diy_tcxo_ime_zhtw-2.7.26-02b8725.uf2 |
NRF52 Pro-micro DIY — Bopomofo, on-screen keyboard (untested, see above) | dba6cb2c2549f734591b9154ff9f1f2b |
firmware-nrf52_promicro_diy_tcxo_kb_zhtw-2.7.26-02b8725.uf2 |
NRF52 Pro-micro DIY — Bopomofo, I2C keyboard (M5Stack CardKB) | 6e496d00695b497082d9f90e7623d2bf |
The .uf2 files are flashed by copying them onto the bootloader drive that appears
after a double tap on reset. The .factory.bin files are full images, written at
offset 0, and they overwrite the whole flash including any stored settings.
For the two ESP32 boards (Heltec V3, Cardputer Adv), please flash with esptool
rather than the flasher.meshtastic.org web tool — its "upload your own firmware"
path does not handle this release correctly and can leave the device unable to
boot. See flashing_esp32_zhtw.md for a short walkthrough,
including where to get esptool without installing Python.
The NRF52 Pro-micro DIY is a build-it-yourself board: it expects a 128x64 I2C
SSD1306 wired to the header, and the _ime_zhtw env additionally needs a 4-way
switch or trackball on the four free pins (P1.01, P1.02, P1.06, P1.07). Bring a new
node up on the stock nrf52_promicro_diy_tcxo env first, then flash a _zhtw one
once the hardware is known good. Wiring details are in the variant's own readme.md
in the source tree.
What is in them
| Environment | Board | Input | Flash |
|---|---|---|---|
gat562_family_zhtw |
GAT562 Family (nRF52840) | Bopomofo, on-screen keyboard | 664,996 / 815,104 |
seeed_wio_tracker_L1_zhtw |
Wio Tracker L1 / Lite / Pro | Bopomofo, on-screen keyboard | 767,416 / 815,104 |
heltec-v3_zhtw |
Heltec LoRa32 V3 | display only | 2,194,000 |
m5stack-cardputer-adv_zhtw |
M5Stack Cardputer Adv | Bopomofo, physical keyboard | 3,046,416 |
nrf52_promicro_diy_tcxo_zhtw |
NRF52 Pro-micro DIY | display only | 750,344 / 815,104 |
nrf52_promicro_diy_tcxo_ime_zhtw |
NRF52 Pro-micro DIY | Bopomofo, on-screen keyboard (needs 4-way nav hardware) | 787,520 / 815,104 |
nrf52_promicro_diy_tcxo_kb_zhtw |
NRF52 Pro-micro DIY | Bopomofo, I2C keyboard (fn+c toggles Chinese/English) |
786,760 / 815,104 |
About 5,100 glyphs, and a Bopomofo dictionary in two sizes: a single-character table
for the nRF52840 boards, whose 815,104 byte app partition cannot hold more, and the
full multi-character trie for the ESP32 ones.
Known limitations
- The Cardputer image uses a partition table with a 6 MB app slot in place of the OTA
slot, because the full dictionary is roughly 2.5 MB of rodata. That board cannot
be updated over the air with this firmware. - The Wio Tracker L1 build leaves about 47 KB of the app partition free. Adding much
of anything to it will overflow. - The two NRF52 Pro-micro DIY Bopomofo builds (
_ime_zhtw,_kb_zhtw) leave only
about 3.4-3.5% of the app partition free — the thinnest margin of any board here.
They exclude eight feature modules to fit the dictionary: ATAK, range test,
neighbor info, the serial bridge, detection-sensor, accelerometer, magnetometer
and multi-channel power telemetry. - All nRF52840 targets are built with
DEBUG_MUTE, so there is no serial log. The
font and, on the Bopomofo builds, the dictionary need the room it buys back.
Licence
The firmware is GPL-3.0, as upstream. The glyph tables hold rasterised bitmaps rather
than font files; terms for every font and dictionary in the chain are in licenses/.
Not affiliated with or endorsed by the Meshtastic project. Meshtastic(R) is a
registered trademark of Meshtastic LLC.
Thanks
The NRF52 Pro-micro DIY support in this release was contributed by
mesh-taiwan (#1).
繁體中文說明
基於上游 Meshtastic v2.7.26.54e0d8d，替五款機種、七個環境加上繁體中文顯示與注音
輸入法。每一個都是獨立的 env，與原廠 env 並存，原廠 env 一律不動。
本韌體不提供任何形式的保證。刷機有機會讓裝置無法開機，跑著未經驗證韌體的無線電
節點也可能出現非預期行為。請自行承擔使用風險。
這是 pre-release。驗過與沒驗過的部分：
- 七個 env 與各自對應的原廠 env 都在 CI 上從乾淨環境編得過。
- 字型與字典比對過生成器產出，37 個注音符號與四個聲調符號都在。
- GAT562 Family、Wio Tracker L1、Heltec V3、Cardputer Adv：跟上一版 pre-release
相比，除了版本字串以外沒有變動。 - Cardputer Adv 另外多了下面提到的
fn+c切換鍵，是為了外接 CardKB 準備的
——這個組合尚待實機測試；內建鍵盤完全沒動，還是跟以前一樣用 Ctrl+Space 切換。 - NRF52 Pro-micro DIY 純顯示（
_zhtw）與 I2C 鍵盤（_kb_zhtw）：由貢獻者
實機測過，包含中文顯示、M5Stack CardKB 上的注音輸入與fn+c中英切換。 - NRF52 Pro-micro DIY 螢幕鍵盤（
_ime_zhtw）：沒有實機測試過。 這個環境要靠焊在
四個空腳位上的 4 向鍵或軌跡球操作，參與開發的人手邊都沒有這組硬體，導覽方式與
長按 500ms 選字都還沒驗證過。如果你有這樣的硬體設備，請幫忙測試後回報結果喔。
.uf2 檔案的刷機方式是雙擊 reset 鍵、電腦上會出現一個 bootloader 磁碟機，把檔案
複製進去即可。.factory.bin 檔案是完整映像檔，寫入 offset 0，會覆蓋整個 flash
（包含所有已儲存的設定）。
兩支 ESP32 板子（Heltec V3、Cardputer Adv）請改用 esptool 燒錄，不要用
flasher.meshtastic.org 網頁版——它的「上傳自訂韌體」那條路徑無法正確處理這份
release，可能導致裝置無法開機。簡易操作步驟（含免安裝 Python 的 esptool 下載
位置）請見 flashing_esp32_zhtw.md。
NRF52 Pro-micro DIY 是需要自己組裝的板子：需要接一顆 128x64 I2C SSD1306 到
排針上，_ime_zhtw 環境還需要在四個空腳位（P1.01、P1.02、P1.06、P1.07）上接 4
向鍵或軌跡球。建議先用原廠的 nrf52_promicro_diy_tcxo 環境把新節點的硬體確認正常，再刷 _zhtw
版。詳細接線請看原始碼裡該 variant 自己的 readme.md。
字型約收錄 5,100 個字形；注音字典依機種分兩種規模：nRF52840 系列受限於
815,104 位元組的 app 分區，只能收單字表；ESP32 系列則收完整多字詞的 trie 詞庫。
已知限制：Cardputer 為了塞下完整詞庫改用 6 MB app 分區、犧牲 OTA 槽，這塊板子刷了
之後無法 OTA 更新；Wio Tracker L1 只剩約 47 KB 餘裕；兩款 NRF52 Pro-micro DIY 的
注音版本（_ime_zhtw、_kb_zhtw）餘裕只剩約 3.4-3.5%，是這次所有機種裡最緊的，
代價是排除了八個功能模組：ATAK、range test、neighbor info、序列埠橋接、偵測感測器、
加速度計、磁力計、多通道電源量測；所有 nRF52840 機種都帶 DEBUG_MUTE，沒有 serial
log，字型（與注音版本的字典）就是靠省下的這塊空間才塞得下。
本專案與 Meshtastic 官方無隸屬關係，亦未經其背書。Meshtastic(R) 為 Meshtastic LLC
的註冊商標。
致謝
這次的 NRF52 Pro-micro DIY 支援由社群成員
mesh-taiwan 貢獻
（PR #1）。
v2.7.26-zhtw.1
Traditional Chinese display and Bopomofo input, built on upstream Meshtastic
v2.7.26.54e0d8d. Four boards, each as a separate environment that sits next to the
stock one; no stock environment is modified.
No warranty
These builds come with no warranty of any kind, express or implied. Flashing
firmware can leave a device unusable, and a mesh radio running unverified firmware
may behave in ways you do not expect. Use them at your own risk.
This is a pre-release. What has and has not been checked:
- Every environment here compiles, and so does the stock environment next to it,
from a clean checkout in CI. - The glyph tables and dictionary were verified against the generator output, and
the embedded fonts were confirmed to carry all 37 Bopomofo symbols and the four
tone marks. - The equivalent builds on the previous upstream base (
v2.7.23) were tested on
hardware: display, message wrapping and Bopomofo input all behaved. - These binaries were tested on hardware. An earlier build of this release put
the keyboard over the candidate row on 128x64 panels; that is fixed here and
confirmed on the device. - Whether an emoji in a node name intrudes on the neighbouring row of the node list
has now been checked on hardware too: it does not happen.
Files
| File | Board | md5 |
|---|---|---|
firmware-gat562_family_zhtw-2.7.26-f35eb6023.uf2 |
GAT562 Family | 4029826a912ddb3902fd204bc79d47eb |
firmware-wio_tracker_L1_zhtw-2.7.26-f35eb6023.uf2 |
Seeed Wio Tracker L1 / L1 Lite / L1 Pro | 0fadef74c22b238b80222c7911a4f89c |
firmware-heltec_v3_zhtw-2.7.26-f35eb6023.factory.bin |
Heltec LoRa32 V3 | 5d8879e8eb643aebd0540cc33f2f4fb7 |
firmware-cardputer_adv_zhtw-2.7.26-f35eb6023.factory.bin |
M5Stack Cardputer Adv | 293f820aabba14d2b8b637bd24ef04a1 |
The .uf2 files are flashed by copying them onto the bootloader drive that appears
after a double tap on reset. The .factory.bin files are full images, written at
offset 0, and they overwrite the whole flash including any stored settings.
For the two ESP32 boards (Heltec V3, Cardputer Adv), please flash with esptool
rather than the flasher.meshtastic.org web tool — its "upload your own firmware"
path does not handle this release correctly and can leave the device unable to
boot. See flashing_esp32_zhtw.md for a short walkthrough,
including where to get esptool without installing Python.
What is in them
| Environment | Board | Input | Flash |
|---|---|---|---|
gat562_family_zhtw |
GAT562 Family (nRF52840) | Bopomofo, on-screen keyboard | 664,996 / 815,104 |
seeed_wio_tracker_L1_zhtw |
Wio Tracker L1 / Lite / Pro | Bopomofo, on-screen keyboard | 767,416 / 815,104 |
heltec-v3_zhtw |
Heltec LoRa32 V3 | display only | 2,194,000 |
m5stack-cardputer-adv_zhtw |
M5Stack Cardputer Adv | Bopomofo, physical keyboard | 3,046,352 |
About 5,100 glyphs, and a Bopomofo dictionary in two sizes: a single-character table
for the nRF52840 boards, whose 815,104 byte app partition cannot hold more, and the
full multi-character trie for the ESP32 ones.
Known limitations
- The Cardputer image uses a partition table with a 6 MB app slot in place of the OTA
slot, because the full dictionary is roughly 2.5 MB of rodata. That board cannot
be updated over the air with this firmware. - The Wio Tracker L1 build leaves about 47 KB of the app partition free. Adding much
of anything to it will overflow. - Both nRF52840 targets are built with
DEBUG_MUTE, so there is no serial log. The
font and dictionary need the room it buys back.
Licence
The firmware is GPL-3.0, as upstream. The glyph tables hold rasterised bitmaps rather
than font files; terms for every font and dictionary in the chain are in licenses/.
Not affiliated with or endorsed by the Meshtastic project. Meshtastic(R) is a
registered trademark of Meshtastic LLC.
繁體中文說明
基於上游 Meshtastic v2.7.26.54e0d8d，替四款機種加上繁體中文顯示與注音輸入法。
每一款都是獨立的 env，與原廠 env 並存，原廠 env 一律不動。
本韌體不提供任何形式的保證。刷機有機會讓裝置無法開機，跑著未經驗證韌體的無線電
節點也可能出現非預期行為。請自行承擔使用風險。
這是 pre-release。驗過與沒驗過的部分：
- 四個 env 與各自對應的原廠 env 都在 CI 上從乾淨環境編得過。
- 字型與字典比對過生成器產出，37 個注音符號與四個聲調符號都在。
- 上一個上游版本（
v2.7.23）的等價韌體做過實機測試，顯示、換行與注音輸入都正常。 - 這幾支韌體本身做過實機測試。 這一版較早的建置在 128x64 螢幕上會讓鍵盤蓋到
候選字列，該問題已修正並在機器上確認。 - 節點名稱裡的 emoji 會不會侵入節點列表的相鄰行，這一項現在也在機器上確認過了：
不會發生。
.uf2 檔案的刷機方式是雙擊 reset 鍵、電腦上會出現一個 bootloader 磁碟機，把檔案
複製進去即可。.factory.bin 檔案是完整映像檔，寫入 offset 0，會覆蓋整個 flash
（包含所有已儲存的設定）。
兩支 ESP32 板子（Heltec V3、Cardputer Adv）請改用 esptool 燒錄，不要用
flasher.meshtastic.org 網頁版——它的「上傳自訂韌體」那條路徑無法正確處理這份
release，可能導致裝置無法開機。簡易操作步驟（含免安裝 Python 的 esptool 下載
位置）請見 flashing_esp32_zhtw.md。
字型約收錄 5,100 個字形；注音字典依機種分兩種規模：nRF52840 系列受限於
815,104 位元組的 app 分區，只能收單字表；ESP32 系列則收完整多字詞的 trie 詞庫。
已知限制：Cardputer 為了塞下完整詞庫改用 6 MB app 分區、犧牲 OTA 槽，這塊板子刷了
之後無法 OTA 更新；Wio Tracker L1 只剩約 47 KB 餘裕；兩款 nRF52840 都帶 DEBUG_MUTE，
沒有 serial log，字型與字典就是靠省下的這塊空間才塞得下。
本專案與 Meshtastic 官方無隸屬關係，亦未經其背書。Meshtastic(R) 為 Meshtastic LLC
的註冊商標。