Developer Flashing Portal

Usher デバイスの公式ファームウェアROM、個別バイナリ、esptool コマンド、およびスマートフォン（USB OTG）からの有線書き込み・完全復旧ガイドです。

ALL

Full Factory ROM

Offset: 0x0000

ブートローダー、パーティション、ファームウェア本体、LittleFSファイルシステム（フォント/アセット）を全結合した完全初期化・復旧用ROMです。スマホ(USB OTG)やPCからアドレス 0x0 で1ファイル選ぶだけで完全復旧します。

// FLASH CONFIGURATION:
- Target Address: 0x0000 (0x0)
- Size: 16.0 MB (オールインワン)
- Recommended: Flash Mode DIO / Speed 80MHz / Compress ON

Download Full ROM (.bin / 0x0)

APP

Firmware App Only

Offset: 0x10000

USHER メインアプリケーション単体のバイナリです。無線BLE OTA更新、または既にブートローダーとファイルシステムが書き込まれている端末の通常アップデート用です。

// FIRMWARE NOTES (v0.2.68):
- Target Address: 0x10000
- Size: 約 1.6 MB
- Note: ブートローダーやLittleFSは上書きされません

Download App Binary (.bin / 0x10000)

// 01. INDIVIDUAL FLASH COMPONENTS

v0.2.68

特定のパーティションのみを個別に更新したい場合や、カスタムファームウェアと公式ファイルシステムを組み合わせて検証する場合は、以下のバイナリとオフセットアドレスを使用してください。

COMPONENT	FILE NAME	OFFSET	SIZE	ACTION
2nd Stage Bootloader ROMブート後に実行される起動コード	bootloader.bin	0x0000 (0x0)	約 21 KB	Download
Partition Table 16MB Flashメモリの構造マップ	partitions.bin	0x8000	3 KB	Download
Factory Application Usher メインプログラム本体	firmware.bin	0x10000	約 1.6 MB	Download
LittleFS Filesystem 東雲フォント・JSON設定・Luaスクリプト	littlefs.bin	0x450000	約 11.9 MB	Download

// ALL-IN-ONE MERGED FACTORY ROM

上記4つのバイナリを単一ファイルに統合した完全復旧用ROM（書き込みオフセット: 0x0000 / サイズ: 16.0 MB）

Download Full ROM (0x0)

// 02. CLI FLASHING COMMANDS (ESPTOOL)

PCから esptool.py を用いて有線書き込みを行う際の推奨コマンドです。

[A] Full ROM 一発書き込み (esptool)

esptool.py --chip esp32s3 -p COM3 -b 460800 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 80m --flash_size 16MB 0x0 firmware_128i80t_full_0.2.68.bin

[B] 個別バイナリ同時書き込み (esptool)

esptool.py --chip esp32s3 -p COM3 -b 460800 write_flash -z --flash_mode dio --flash_freq 80m --flash_size 16MB \
  0x0000 bootloader.bin \
  0x8000 partitions.bin \
  0x10000 firmware.bin \
  0x450000 littlefs.bin

// 03. SMARTPHONE USB OTG FLASHING GUIDE (ANDROID)

Android端末と「ESP32_Flash」等のアプリを USB OTG 接続して書き込む際の推奨設定とトラブルシューティングです。

// RECOMMENDED SETTINGS

Chip Family: ESP32-S3
Flash Mode: DIO (安定性重視)
Flash Speed: 80MHz (または 40MHz)
Flash Size: 16MB
Baud Rate: 460800 (エラー時は 115200)
圧縮 (Compression): 必ず ON

// FLASHING & TRANSFER TIPS

自動ブートローダー移行: USB接続時はesptoolやWeb SerialからのシリアルDTR/RTS制御により、自動的にブートローダーモードへ移行して安全に書き込みが実行されます。
書き込み中のスリープ防止: 通信切断を防ぐため、書き込み中は端末のスリープを無効化してください。

// 04. PARTITION TABLE SPECIFICATION (PARTITIONS.CSV)

Usher 公式ファームウェアの 16MB Flash パーティションレイアウト構成です。

# Name,   Type, SubType, Offset,  Size,     Flags
nvs,      data, nvs,     0x9000,  0x4000,
otadata,  data, ota,     0xd000,  0x2000,
phy_init, data, phy,     0xf000,  0x1000,
factory,  app,  factory, 0x10000, 0x220000,
ota_0,    app,  ota_0,   0x230000,0x220000,
littlefs, data, littlefs,0x450000,0xbb0000,