Skip to content

Releases

Improved Pico UF2 — ipfix3 payload, JIS + per-line IME build (2026-11-17)

Choose a tag to compare

@yyoossk yyoossk released this 16 Nov 19:42

Improved Pico UF2 — ipfix3 payload, JIS + per-line IME build

Prebuilt PicoSwitch UF2 firmware from yyoossk/CivSwitch, the fork of Gezine/CivSwitch. The UF2 types the CivSwitch loader into Civilization VII on a Switch 2 (firmware 23.0.1, game v1.0.0) through the in-game chat. Two things differ from a stock upstream build:

What's improved

1. ipfix3 payload (core.js)

The loader the UF2 types is the ipfix3 build instead of the stock core.js:

  • IP detection retries up to 8 times and then falls back to listening on 0.0.0.0 with a log line (IP detection failed - listening anyway), instead of waiting forever when the console's IP cannot be read.
  • The payload-accept loop logs sparingly, resets the network stack after repeated accept failures, and gives up cleanly instead of spinning.

2. Hardware-verified build configuration

  • Japanese consoles: JIS keyboard layout with per-line IME toggling (CIV7_IME_START=grave-each-line) — the combination verified on a real Japanese console. Upstream's build_all.sh cannot select the IME behaviour.
  • US layout: no IME handling, as before.
  • The fork adds PicoSwitch/build-uf2.sh so anyone can rebuild with --board, --layout, --ime, and --payload options (defaults are the verified JIS + IME configuration).

Files (in the attached zip)

File | For -- | -- civ7-pico2-jis-ime.uf2 | Pico 2, Japanese console civ7-pico1-jis-ime.uf2 | Pico 1, Japanese console civ7-pico2-us.uf2 | Pico 2, US-layout console civ7-pico1-us.uf2 | Pico 1, US-layout console

kaiHEN Installer に同梱され、実機で使われている UF2 と同じビルドです。

書き込み方

BOOTSEL を押しながら Pico を接続し、表示された USB ドライブに合う .uf2 をコピーしてください。シヴィライゼーション7 でマルチプレイヤーのワイヤレスロビーのチャットを開いて Pico を挿すと打ち込みが始まります (約24分)。画面に Awaiting payload at <本体IP>:9026 が出ればローダー起動完了です。

Improved Pico UF2 — ipfix3 payload, JIS + per-line IME build Prebuilt PicoSwitch UF2 firmware from [yyoossk/CivSwitch](https://github.com/yyoossk/CivSwitch), the fork of Gezine/CivSwitch. The UF2 types the CivSwitch loader into Civilization VII on a Switch 2 (firmware 23.0.1, game v1.0.0) through the in-game chat. Two things differ from a stock upstream build: What's improved 1. ipfix3 payload (core.js) The loader the UF2 types is the ipfix3 build instead of the stock core.js: IP detection retries up to 8 times and then falls back to listening on 0.0.0.0 with a log line (IP detection failed - listening anyway), instead of waiting forever when the console's IP cannot be read. The payload-accept loop logs sparingly, resets the network stack after repeated accept failures, and gives up cleanly instead of spinning. 2. Hardware-verified build configuration Japanese consoles: JIS keyboard layout with per-line IME toggling (CIV7_IME_START=grave-each-line) — the combination verified on a real Japanese console. Upstream's build_all.sh cannot select the IME behaviour. US layout: no IME handling, as before. The fork adds PicoSwitch/build-uf2.sh so anyone can rebuild with --board, --layout, --ime, and --payload options (defaults are the verified JIS + IME configuration). Files (in the attached zip) File For civ7-pico2-jis-ime.uf2 Pico 2, Japanese console civ7-pico1-jis-ime.uf2 Pico 1, Japanese console civ7-pico2-us.uf2 Pico 2, US-layout console civ7-pico1-us.uf2 Pico 1, US-layout console sha256: civ7-pico1-jis-ime.uf2 e44c9c23b7e17df6cde94a9f62b2d4c8f5c50ea91232bed25c42bc5da064d05a civ7-pico2-jis-ime.uf2 60bbffbaa447ed1f23d854e58b2f68eeb4a21f18c392ea0dc530449d1a3d6ba6 civ7-pico1-us.uf2 46bc5b77861e6c14080afedf7d91df6366566bf57ba537eced73e942644375aa civ7-pico2-us.uf2 9d5e2a173328a4842b467615de0607c36695be8302965c20d09a3cca64577c1a These are the same UF2 builds that ship with kaiHEN Installer and were used on real hardware. Flashing Hold BOOTSEL while connecting the Pico, then copy the matching .uf2 onto the USB drive that appears. In Civilization VII, open the multiplayer wireless lobby chat and connect the Pico; typing takes about 24 minutes and ends with Awaiting payload at :9026 on screen. Credits Original work: Gezine (CivSwitch / PicoSwitch), YotsuhaMeru (CivSwitch-JPN: JIS layout and IME support). Same license as upstream.

改良版 Pico UF2 — ipfix3 ペイロード + JIS・IME 毎行切替ビルド
Gezine/CivSwitch のフォーク yyoossk/CivSwitch でビルドした PicoSwitch UF2 です。Switch 2 (FW 23.0.1、シヴィライゼーション7 v1.0.0) のゲーム内チャットに CivSwitch ローダーを打ち込みます。標準の upstream ビルドとの違いは2点です。
改良点

  1. ペイロードが ipfix3 (core.js)
    UF2 が打ち込むローダーを、標準の core.js から ipfix3 に差し替えました。
    IP 検出は最大8回まで再試行し、読めない場合はログを出して 0.0.0.0 で待ち受けるため、IP が読めずに永久に止まることがありません (IP detection failed - listening anyway)
    ペイロード受付ループはログを抑え、受付失敗が続くとネットワークをリセットし、回転し続けずにきれいに打ち切ります
  2. 実機検証済みのビルド構成
    国内版本体向け: JIS 配列 + IME 毎行切替 (CIV7_IME_START=grave-each-line)。日本の本体で実機検証済みの組み合わせで、upstream の build_all.sh では IME の挙動を選べません
    US 配列: IME 切替なし (従来通り)
    フォークには PicoSwitch/build-uf2.sh を追加し、--board / --layout / --ime / --payload を指定して再ビルドできます (既定は検証済みの JIS+IME 構成)
    添付ファイル
    ファイル
    用途
    civ7-pico2-jis-ime.uf2
    Pico 2、日本版本体
    civ7-pico1-jis-ime.uf2
    Pico 1、日本版本体
    civ7-pico2-us.uf2
    Pico 2、US 配列の本体
    civ7-pico1-us.uf2
    Pico 1、US 配列の本体
    kaiHEN Installer に同梱され、実機で使われている UF2 と同じビルドです。
    書き込み方
    BOOTSEL を押しながら Pico を接続し、表示された USB ドライブに合う .uf2 をコピーしてください。シヴィライゼーション7 でマルチプレイヤーのワイヤレスロビーのチャットを開いて Pico を挿すと打ち込みが始まります (約24分)。画面に Awaiting payload at <本体IP>:9026 が出ればローダー起動完了です。