fix(m5stack_unit_c6l): add USB CDC flags to repeater and room_server envs

.github/actions/setup-build-environment/action.yml

@@ -4,17 +4,17 @@ runs:
   steps:
 
     - name: Init Cache
-      uses: actions/cache@v5
+      uses: actions/cache@v4
       with:
         path: |
           ~/.cache/pip
           ~/.platformio/.cache
         key: ${{ runner.os }}-pio
 
     - name: Install Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.13'
+        python-version: '3.11'
 
     - name: Install PlatformIO
       shell: bash

.github/workflows/jp-release.yml

@@ -0,0 +1,174 @@
+name: Build JP Firmwares
+
+permissions:
+  contents: write
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'jp-v*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone Repo
+        uses: actions/checkout@v4
+
+      - name: Setup Build Environment
+        uses: ./.github/actions/setup-build-environment
+
+      - name: Build JP Firmwares
+        env:
+          FIRMWARE_VERSION: ${{ env.GIT_TAG_VERSION || 'dev' }}
+
+          PLATFORMIO_BUILD_FLAGS: >-
+            -w -DNDEBUG -DRADIOLIB_STATIC_ONLY=1 -DRADIOLIB_GODMODE=1
+            -D LORA_FREQ=920.800
+            -D LORA_BW=125.0
+            -D LORA_SF=10
+            -D LORA_CR=6
+            -D 'ALLOWED_REPEAT_FREQ_RANGE={921200,921200}'
+            -D ENABLE_ADVERT_ON_BOOT=1
+            -D ENABLE_PRIVATE_KEY_IMPORT=1
+            -D ENABLE_PRIVATE_KEY_EXPORT=1
+            -D RADIOLIB_EXCLUDE_CC1101=1
+            -D RADIOLIB_EXCLUDE_RF69=1
+            -D RADIOLIB_EXCLUDE_SX1231=1
+            -D RADIOLIB_EXCLUDE_SI443X=1
+            -D RADIOLIB_EXCLUDE_RFM2X=1
+            -D RADIOLIB_EXCLUDE_SX128X=1
+            -D RADIOLIB_EXCLUDE_AFSK=1
+            -D RADIOLIB_EXCLUDE_AX25=1
+            -D RADIOLIB_EXCLUDE_HELLSCHREIBER=1
+            -D RADIOLIB_EXCLUDE_MORSE=1
+            -D RADIOLIB_EXCLUDE_APRS=1
+            -D RADIOLIB_EXCLUDE_BELL=1
+            -D RADIOLIB_EXCLUDE_RTTY=1
+            -D RADIOLIB_EXCLUDE_SSTV=1
+
+        run: |
+          mkdir -p out_jp
+          # JP TX power制限
+          # Wio-SX1262搭載機（工事設計認証201-250230、証明出力10dBm）は10dBmに制限
+          sed -i 's/-D LORA_TX_POWER=22/-D LORA_TX_POWER=10/g' \
+            variants/xiao_nrf52/platformio.ini \
+            variants/xiao_s3_wio/platformio.ini \
+            variants/wio-tracker-l1/platformio.ini
+          # T1000-E: Seeed確認済み証明上限19mW(≈12.79dBm)のため12dBmに制限
+          sed -i 's/-D LORA_TX_POWER=22/-D LORA_TX_POWER=12/g' \
+            variants/t1000-e/platformio.ini
+          # それ以外はARIB STD-T108上限の13dBmのまま
+          sed -i 's/-D LORA_TX_POWER=22/-D LORA_TX_POWER=13/g' \
+            variants/rak_wismesh_tag/platformio.ini \
+            variants/lilygo_techo_lite/platformio.ini \
+            variants/heltec_t114/platformio.ini \
+            variants/m5stack_unit_c6l/platformio.ini \
+            variants/lilygo_tdeck/platformio.ini
+          bash build.sh build-firmware RAK_WisMesh_Tag_companion_radio_ble
+          bash build.sh build-firmware RAK_WisMesh_Tag_companion_radio_usb
+          bash build.sh build-firmware RAK_WisMesh_Tag_repeater
+          bash build.sh build-firmware RAK_WisMesh_Tag_room_server
+          bash build.sh build-firmware t1000e_companion_radio_ble
+          bash build.sh build-firmware t1000e_companion_radio_usb
+          bash build.sh build-firmware t1000e_repeater 
+          bash build.sh build-firmware t1000e_room_server
+          bash build.sh build-firmware LilyGo_T-Echo-Lite_companion_radio_ble
+          bash build.sh build-firmware LilyGo_T-Echo-Lite_repeater
+          bash build.sh build-firmware LilyGo_T-Echo-Lite_room_server
+          bash build.sh build-firmware Xiao_nrf52_companion_radio_ble
+          bash build.sh build-firmware Xiao_nrf52_companion_radio_usb
+          bash build.sh build-firmware Xiao_nrf52_repeater
+          bash build.sh build-firmware Xiao_nrf52_room_server
+          bash build.sh build-firmware Xiao_S3_WIO_companion_radio_ble
+          bash build.sh build-firmware Xiao_S3_WIO_companion_radio_usb
+          bash build.sh build-firmware Xiao_S3_WIO_repeater
+          bash build.sh build-firmware Xiao_S3_WIO_room_server
+          bash build.sh build-firmware Heltec_t114_without_display_companion_radio_ble
+          bash build.sh build-firmware Heltec_t114_without_display_companion_radio_usb
+          bash build.sh build-firmware Heltec_t114_without_display_repeater
+          bash build.sh build-firmware Heltec_t114_without_display_room_server
+          bash build.sh build-firmware Heltec_t114_companion_radio_ble
+          bash build.sh build-firmware Heltec_t114_companion_radio_usb
+          bash build.sh build-firmware Heltec_t114_repeater
+          bash build.sh build-firmware Heltec_t114_room_server
+          bash build.sh build-firmware WioTrackerL1_companion_radio_ble
+          bash build.sh build-firmware WioTrackerL1_companion_radio_usb
+          bash build.sh build-firmware WioTrackerL1_repeater
+          bash build.sh build-firmware WioTrackerL1_room_server
+          bash build.sh build-firmware M5Stack_Unit_C6L_companion_radio_ble
+          bash build.sh build-firmware M5Stack_Unit_C6L_companion_radio_usb
+          bash build.sh build-firmware M5Stack_Unit_C6L_repeater
+          bash build.sh build-firmware M5Stack_Unit_C6L_room_server
+          bash build.sh build-firmware LilyGo_TDeck_companion_radio_ble
+          bash build.sh build-firmware LilyGo_TDeck_companion_radio_usb
+          bash build.sh build-firmware LilyGo_TDeck_repeater
+
+      - name: Copy artifacts to out/
+        run: |
+          ls -la .pio/build/*/firmware.uf2 2>/dev/null || echo "no uf2 found"
+          mkdir -p out_jp
+          HASH=$(git rev-parse --short HEAD)
+          TAG=$(git describe --tags --exact-match 2>/dev/null || echo "dev")
+          for ENV in RAK_WisMesh_Tag_companion_radio_ble RAK_WisMesh_Tag_companion_radio_usb RAK_WisMesh_Tag_repeater RAK_WisMesh_Tag_room_server t1000e_companion_radio_ble t1000e_companion_radio_usb t1000e_repeater t1000e_room_server LilyGo_T-Echo-Lite_companion_radio_ble LilyGo_T-Echo-Lite_repeater LilyGo_T-Echo-Lite_room_server Xiao_nrf52_companion_radio_ble Xiao_nrf52_companion_radio_usb Xiao_nrf52_repeater Xiao_nrf52_room_server Heltec_t114_without_display_companion_radio_ble Heltec_t114_without_display_companion_radio_usb Heltec_t114_without_display_repeater Heltec_t114_without_display_room_server Heltec_t114_companion_radio_ble Heltec_t114_companion_radio_usb Heltec_t114_repeater Heltec_t114_room_server WioTrackerL1_companion_radio_ble WioTrackerL1_companion_radio_usb WioTrackerL1_repeater WioTrackerL1_room_server; do
+
+            NAME="${ENV}-${TAG}-${HASH}"
+            cp ".pio/build/${ENV}/firmware.uf2" "out_jp/${NAME}.uf2" 2>/dev/null || true
+            cp ".pio/build/${ENV}/firmware.zip" "out_jp/${NAME}_dfu.zip" 2>/dev/null || true
+          done
+           # ESP32系は.binと-merged.binをコピー
+          for ENV in Xiao_S3_WIO_companion_radio_ble Xiao_S3_WIO_companion_radio_usb Xiao_S3_WIO_repeater Xiao_S3_WIO_room_server M5Stack_Unit_C6L_companion_radio_ble M5Stack_Unit_C6L_companion_radio_usb M5Stack_Unit_C6L_repeater M5Stack_Unit_C6L_room_server LilyGo_TDeck_companion_radio_ble LilyGo_TDeck_companion_radio_usb LilyGo_TDeck_repeater; do
+            NAME="${ENV}-${TAG}-${HASH}"
+            cp ".pio/build/${ENV}/firmware.bin" "out_jp/${NAME}.bin" 2>/dev/null || true
+            cp ".pio/build/${ENV}/firmware-merged.bin" "out_jp/${NAME}-merged.bin" 2>/dev/null || true
+          done
+          ls -la out_jp/
+
+      - name: Upload Workflow Artifacts
+        uses: actions/upload-artifact@v4
+
+        with:
+          name: jp-firmwares
+          path: out_jp
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          name: JP Firmware ${{ env.GIT_TAG_VERSION }}
+          generate_release_notes: true
+          body: |
+            ## 日本向け MeshCore ファームウェア
+
+            ### 対応デバイス
+            | デバイス | ファイル | 書き込み方法 |
+            |---|---|---|
+            | WisMesh Tag | `RAK_WisMesh_Tag_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | T1000-E | `t1000e_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | T-Echo Lite | `LilyGo_T-Echo-Lite_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | XIAO nRF52840 | `Xiao_nrf52_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | Heltec T114 (ディスプレイなし) | `Heltec_t114_without_display_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | Heltec T114 (ディスプレイあり) | `Heltec_t114_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | Wio Tracker L1 Pro | `WioTrackerL1_companion_radio_ble-*.uf2` | UF2ドラッグ&ドロップ |
+            | M5Stack Unit C6L | `M5Stack_Unit_C6L_companion_radio_ble-*-merged.bin` | esptool書き込み |
+            | T-DECK | `LilyGo_TDeck_companion_radio_ble-*-merged.bin` | esptool書き込み |
+
+            > ⚠️ Wio Tracker L1 Pro / T-DECK はCIビルド確認のみです。動作報告歓迎します。M5Stack Unit C6Lは起動時クラッシュループの原因を特定・修正しました（実機はflash_mode=QIO非対応、配布バイナリのヘッダをDIOに変更）。実機での動作を確認済みです。
+
+            以上の表に載っていないデバイスや、リピーター、ルームサーバーもリリースしていますが、実験的です。
+
+            ### 日本での運用設定
+            フラッシュ後、スマホアプリで以下を確認してください：
+            - 周波数: `920.8 MHz`
+            - TX出力: `13 dBm以下`（XIAO nRF52840/XIAO ESP32S3+Wio-SX1262/Wio Tracker L1 Proは`10 dBm以下`、T1000-Eは`12 dBm以下`）
+            - BW: `125 kHz` / SF: `10` / CR: `4/6`
+
+            > ℹ️ Wio-SX1262搭載機（XIAO nRF52840/ESP32S3+Wio-SX1262、Wio Tracker L1 Pro）はモジュール単体で技適取得済み（工事設計認証201-250230、Seeed社確認済み・書面回答2026/7/20）。ただし証明出力は10dBmのみのため、本ビルドは当該機種のTX出力のデフォルトを10dBmに設定しています。アンテナは付属の低利得アンテナ（FPCまたはSpring）を使用してください。試験報告書に記載されている8dBiのダイポール型アンテナは、10dBm設定ではEIRP超過のため使用不可です。
+            >
+            > ℹ️ T1000-Eも工事設計認証を取得済み（217-252754、Seeed社確認済み・書面回答2026/7/22）。証明出力は19mW（≈12.79dBm）が上限のため、本ビルドは当該機種のTX出力のデフォルトを12dBmに設定しています。
+
+            ### 技適について
+            カスタムファームウェア書き込み後、Wio-SX1262搭載機（XIAO nRF52840/ESP32S3+Wio-SX1262、Wio Tracker L1 Pro）とT1000-Eは技適の範囲内（それぞれ送信出力・アンテナ構成の条件あり）、それ以外の機種は技適の対象外です。詳細は [README_JP.md](https://github.com/jirogit/MeshCore/blob/dev/README_JP.md) を参照してください。
+          draft: true
+          files: out_jp/*

PENDING_NOTES_JP.md

@@ -0,0 +1,9 @@
+# 次回リリース向けメモ（直接push分のみ）
+
+PRを経由した変更は自動生成（generate_release_notes）で拾われるため、ここに書く必要はない。
+jirogit/dev への直接push（fork限定ドキュメント等）だけをここに1行で書き足す。
+
+リリース時：この内容をドラフトリリース本文にコピーしてから、このファイルを空にする。
+
+---
+

QUICKSTART_JP.md

@@ -0,0 +1,119 @@
+# MeshCore JP クイックスタート
+
+このガイドは、メーカーに「ファームウェアを書き換えても技適の証明範囲内」と
+確認が取れている **4機種** に限定して、購入からコンパニオンアプリ接続までを
+最短で説明します。技適・電波法の詳しい話は [README_JP.md](./README_JP.md) を参照してください。
+
+**アンテナは、本体に最初からついているもの（付属アンテナ）を使います。**
+市販の高利得アンテナに交換すると、技適の証明範囲（送信出力の上限）を超えてしまう
+可能性があります。付属アンテナのままなら問題ありません。
+
+（アンテナを変更したい場合は、メーカーの技適証明書に記載された条件等を自分で確認する必要があります。クイックスタートでは「付属アンテナのみ」とします。）
+
+## 対応4機種
+
+| # | 機種 | 送信出力設定 |
+|---|------|------------|
+| 1 | Wio Tracker L1 Pro | 10dBm |
+| 2 | XIAO nRF52840 + Wio-SX1262 | 10dBm |
+| 3 | XIAO ESP32S3 + Wio-SX1262 | 10dBm |
+| 4 | T1000-E | 12dBm |
+
+## 手順
+
+### JP版ファームウェアを書き込む
+
+1. [jirogit/MeshCore Releases](https://github.com/jirogit/MeshCore/releases) から最新の `jp-v*` リリースを開く
+
+- NRF52系
+- WioTrackerL1_companion_radio_ble-*.uf2
+- t1000e_companion_radio_ble-*.uf2
+- Xiao_nrf52_companion_radio_ble-*.uf2
+
+- ESP32系
+- Xiao_S3_WIO_companion_radio_ble-*-merged.bin
+
+2. 機種ごとの書き込み手順:
+
+**Wio Tracker L1 Pro**
+- ファイル WioTrackerL1_companion_radio_ble-*.uf2 を、PCにダウンロードしておく。
+- USB CケーブルでPCと接続する。
+- USBポートのすぐ横の、本体側面のリセットボタンとスライド電源スイッチが有るのをしっかり確認する。
+- このリセットボタンを２回すばやく押す。
+- 電源スライドスイッチとUSBポートの間にある、オレンジ色のLEDが、約１秒毎にゆっくり点灯したり、消灯したりするのを確認する。
+- 「TRACKER L1」という名前のドライブがPCに表示されたら、ダウンロードしたファイル WioTrackerL1_companion_radio_ble-*.uf2 を、そこへコピーする。
+- コピーが完了すると、自動的に再起動する。インストール終了。
+
+**T1000-E**
+- ファイル t1000e_companion_radio_ble-*.uf2 を、PCにダウンロードしておく。
+- まず磁石ケーブルを分離する。
+- ボタンを押しながら磁石ケーブルを素早く、接続、分離、接続する。
+- 緑のLEDが点灯したままになるのを確認する。
+- ボタンから指を離す。
+- 「T1000-E」という名前のドライブがPCに表示されたら、ダウンロードしたファイル t1000e_companion_radio_ble-*.uf2 を、そこへコピーする。
+- コピーが完了すると、自動的に再起動する。インストール終了。
+
+**XIAO nRF52840+Wio-SX1262**
+- ファイル Xiao_nrf52_companion_radio_ble-*.uf2 を、PCにダウンロードしておく。
+- USB CケーブルでPCと接続する。
+- USBポートのすぐ横にある、「RST」とすぐ側に書いてある、とても小さな、まるでハンダ付けのような銀色部分の中央に、直径１ミリくらいの黒い点の有るリセットボタンが有るのをしっかり確認する。USBボートの反対側には「USR」と書いてあるユーザーボタンに見えそうな存在があるが、残念ながらこれはボタンではない。
+- このリセットボタンを２回すばやく押す。
+- 「XIAO-SENSE」という名前のドライブがPCに表示されたら、ダウンロードしたファイル Xiao_nrf52_companion_radio_ble-*.uf2 を、そこへコピーする。
+- コピーが完了すると、自動的に再起動する。インストール終了。
+
+**XIAO ESP32S3+Wio-SX1262**
+- ファイル Xiao_S3_WIO_companion_radio_ble-*-merged.bin を、PCにダウンロードしておく。
+- モジュールをしっかり観察して、１階と２階が端の部分にある黒い細長い四角い部分でつながっているのを確認する。
+- やさしくじわじわと、前後左右にほんの少しづつ動かして、１階と２階部分を分離する。
+- USB Cケーブルをモジュール側に接続する。PCとはまだ接続しない。
+- USBポートのすぐ横にある、とても小さな、まるでハンダ付けのような銀色部分の中央に、直径１ミリくらいの黒い点の有るボタンが存在するのをまずしっかり確認する。アンテナ側のボタンがUSRユーザーボタンで、アンテナの反対側に有るのがRSTリセットボタン。
+- このリセットボタンを爪で、５秒以上押し下げたままにする練習を、自信がつくまで繰り返す。
+- リセットボタンを押し下げたまま、USBコネクターを、PCのポートに差し込む。
+- Google Chrome系のウェブブラウザを使用して、[https://meshcore.io/flasher](https://meshcore.io/flasher) を開く。
+- ページの一番下の方に「Custom Firmware」というボタンがあるので、それをクリックする。
+- ダウンロードしたファイル Xiao_S3_WIO_companion_radio_ble-*-merged.bin を開く。
+- 「merged.bin」というファイルは設定ファイなどすべて消去してしまいますよというポップアップのOKボタンを押す。
+- さらに「Erase device」のチェックボックスがあるので、チェックを入れてオンにする。
+- 「Flash」ボタンを押す。
+- シリアルポートを選択するポップアップが出てくるので、「USB JTAG/serial debug unit (*) - Paired」という名前のシリアルポートを選択して、接続する。
+- コピーが完了すると、自動的に再起動する。インストール終了。
+
+
+### スマホアプリをスマホにインストールする
+
+- iPhoneならApp Store、AndroidならPlay Storeへ行ってMeshCoreをインストールする。
+
+### 接続する
+
+- アプリを起動すると、右上にConnectボタンがあるので押す。
+- Meshcore-ではじまるデバイスをクリックする
+- Wio Tracker L1 Pro だけはスクリーンがあるので、ランダムなBLEのPin番号が表示される。それ以外のデバイスのPin番号は123456.
+- ここで止まってしまうデバイスもあるが、スマホのBLEをオフにして１０秒待ち、またオンにする。
+
+### LoRa確認
+
+- 右上の歯車のようなシンボル「設定」をクリックする
+- Redio Settingをしっかり確認する
+
+920.8 MHz
+BW 125.0 kHz
+SF 10
+CR 6
+Transmit Power: T1000-eが12dBm それ以外のデバイスは10dBm
+
+### DMの送り方
+
+- 右上の歯車の左横にある、けん玉の頭、もしくはリボンのようなシンボルがあるのでクリックする。
+- Advert・Zero Hopをクリックする
+- 付近に同様な、スマホに接続したコンパニオンラジオチャットクライアントがあると、Contactsに、Advert広報したデバイスが追加される。
+- コンタクトの設定によっては、自動で追加されないので、その時は、一番右上、縦に３つの点が並んだシンボルをクリックする。
+- 表示されるメニューの中の「Discover Contacts」をクリックする
+- Addボタンを押してContactsに追加する。
+- 反対側のデバイスも、同じことをする。
+- 両側が反対側のデバイスをContactsに登録し終わった後にだけ、相手のContactをクリックしてDMが送れるようになる。相手のデバイスのコンタクトを持っていても、相手のデバイスが自分のデバイスを登録していない場合は、DMが送れない。
+
+---
+
+もっと詳しい技術的背景（技適の考え方、LBT仕様など）が知りたい方は
+[README_JP.md](./README_JP.md) をご覧ください。
+