対象ユーザー: ブランド側のプロダクトマネージャー、学校のIT管理者、組込みWi-Fiファームウェア担当者で、読み上げペンにどのWi-Fiプロビジョニング経路を備えるか、各経路のセキュリティ上のトレードオフ、そして保護者や6歳の子どもが16文字のWPA2パスフレーズをボタン1つのデバイスに入力しようとする際に起こる避けられない障害をファームウェアがどう処理するかを決める必要がある方。
L5、T2、Y6の各読み上げペンには、BLE無線に加えて802.11 b/g/n無線が搭載されています。Wi-Fi無線は、教室内のテレメトリ取得、コンテンツ更新、そして教師のタブレットを介さずにペンへ次の24時間分のOID書籍を直接ダウンロードする新しい「辞書同期」機能に使用されます。ただし、いずれの用途も、ぺンが学校Wi-FiのSSIDとPSKを認識するまでは機能しません。本記事ではこのプロビジョニング課題を解決します。
読み上げペンはボタン1〜2個のみでキーボードを備えておらず、T2/Y6には1.5インチのOLEDが搭載されています（L5にはOLEDがなく、3色LEDのみ）。エンドユーザーは8歳の生徒か、80歳の祖父母のいずれかです。プロビジョニングフローはワンプッシュ・1分以内で完了し、802.1X＋PEAPを利用する学校Wi-Fiにも対応できる必要があります。2023年以降に出荷した47,000台以上において、Wi-Fiプロビジョニングはデプロイ開始から1〜3か月間で最多のサポートチケット原因となっています。学校ITチームによるSSID標準化と、ペン側でのワンタイム登録運用が定着すると、件数は急激に減少します。
本記事では、弊社が出荷している3つのプロビジョニング経路 — SoftAP、BLE補助型Smart Config、QRコードベースのアウトオブバンド — を比較し、それぞれの使い分けと、ユーザーが誤操作を行った際のファームウェアのリカバリーフローを解説します。
1. 当社カタログの3モデル
| 型番 | Wi-Fi 無線モジュール | プロビジョニング経路 | OLED |
|---|---|---|---|
| L5 | ESP32-WROVER-B (b/g/n) | SoftAP + BLE 補助方式 | なし（LEDのみ） |
| T2 | RTL8720DN (b/g/n) | SoftAP + Smart Config + BLE | あり（1.5インチ） |
| Y6 | RTL8720DN (b/g/n) | SoftAP + Smart Config + BLE + QR | あり（1.5インチ） |
L5は学校向けペンでLEDインジケーターのみを搭載しており、QRコードは表示できません。T2とY6はOLED搭載のプレミアムペンで、画面にQRコードを生成し、ユーザーのスマートフォンで読み取ることが可能です。
2. SoftAPモード
SoftAPモードでは、ペンがWi-Fiアクセスポイントとして動作します。ユーザーはスマートフォンのWi-FiをペンのSSID（例：「SRP-L5-Setup-9F4D」）に接続し、192.168.4.1のキャプティブポータルを開いて、ウェブフォームから学校Wi-Fiの認証情報を入力します。ペンは認証情報を保存し、SoftAPを切断して学校Wi-Fiへ接続し、アプリペアリング用にBLEを再有効化します。
| 手順 | 処理時間 | 備考 |
|---|---|---|
| ユーザーがボタンを5秒長押し | 5秒 | SoftAPモードへ移行 |
| ペンがSSIDをブロードキャスト | 1秒 | SSID = "SRP-L5-Setup-XXXX" |
| スマートフォンがSoftAPに接続 | 3〜8秒 | 手動でWi-Fi設定を実施 |
| キャプティブポータルが起動 | 1秒 | ほとんどのスマートフォンで自動リダイレクト |
| ユーザーがSSIDとPSKを入力 | 20〜60秒 | 802.1X設定を含む |
| スマートフォンが送信 | 1秒 | POST to /save |
| ペンがNVへ保存 | 200ミリ秒 | NV書き込み1回 |
| ペンがSoftAPを切断 | 200ミリ秒 | |
| ペンが学校Wi-Fiへ接続 | 1.2〜4.8秒 | DHCP + 802.1X 認証 |
| 合計 | 28〜75秒 | 中央値 42 秒 |
L5におけるプロビジョニング時間の中央値は42秒です。95パーセンタイルは78秒、99パーセンタイルは130秒（PSKを3回入力ミスするユーザーによる影響）です。
3. キャプティブポータルのUX
キャプティブポータルは、ペン内蔵のHTTPサーバーが提供する12KBのHTMLページです。以下の内容が含まれます：
- 近隣のSSIDのドロップダウン（ボタンを5秒長押し中にスキャン）。
- 隠しネットワーク用の自由入力SSID。
- 表示/非表示を切り替え可能なPSK入力。
- セキュリティモードセレクター（WPA2-Personal、WPA2-Enterprise、WPA3-Personal、Open）。
- WPA2-Enterprise用のユーザー名/パスワード入力。
- 「テストして保存」ボタン。
ポータルは、工場プロビジョニング時にペンごとに生成される自己署名証明書によりHTTPSで保護されています。証明書はデバイスごとに一意で、キャプティブポータルにピン留めされています。接続がローカル限定であるため、キャプティブポータルではHSTSをまだ有効にしていません。
4. Smart Configモード（T2/Y6）
Smart ConfigはEspressifのESP-Touchプロトコルで、もともとはESP8266/ESP32向けに設計されましたが、現在は他のベンダーにも移植されています。Wi-Fi管理フレームのLength-Varying Encodingを使用して、電話からペンにSSIDとPSKをブロードキャストします。ペンの無線がこれらのフレームをスニッフィングし、認証情報を再構築します。
| ステップ | 時間 | 備考 |
|---|---|---|
| ユーザーがアプリを開く | 2秒 | アプリに「Provision Pen」が表示される |
| ユーザーがアプリにSSID+PSKを入力 | 15〜30秒 | SoftAPと同じUXだが電話上で実施 |
| アプリがESP-Touchにエンコード | 1秒 | 電話からUDPブロードキャスト |
| ペンがスニッフィングしてデコード | 3〜10秒 | ペンがSmart Configモード |
| ペンが学校のWi-Fiに接続 | 1.2〜4.8秒 | DHCP + 802.1X |
| 合計 | 22〜48秒 | 中央値 32 秒 |
Smart Configの利点は、ユーザーが電話のWi-Fiネットワークを切り替える必要がないことです。ユーザーは学校のWi-Fiに留まったまま、認証情報を一度アプリに入力すれば、ペンがエンコードされたブロードキャストを待ち受けます。欠点は、一部の802.11ac/axエンタープライズAPがブロードキャストフレームをブロックするため、学校のWi-Fiがそれらを許可している必要があることです。
47,000台以上の実績で、Smart Configは家庭向けWi-Fiで96%、エンタープライズWi-Fiで78%の成功率です。エンタープライズでの22%の失敗率はほぼすべて、802.11k/v/rモードでブロードキャストフレームを無効化しているAPが原因です。そうした環境にはSoftAPを推奨しています。
5. BLEアシストWiFiプロビジョニング
BLEアシストWiFiプロビジョニングは、(TC-059ですでに確立されている)BLEリンクを使用して、Wi-Fi認証情報をGATTキャラクタリスティック書き込みとして配信します。ペンはBLE経由で受信した認証情報を使用してWi-Fiネットワークに接続します。
| ステップ | 時間 | 備考 |
|---|---|---|
| ユーザーがアプリを開く | 2秒 | |
| ユーザーがBLE経由でペンをペアリング | 1.5秒 | Numeric Comparison (TC-059) |
| ユーザーがアプリにSSID+PSKを入力 | 15〜30秒 | |
| アプリがBLEキャラクタリスティックに認証情報を書き込み | 200ミリ秒 | 0x2A4Dまたはベンダー独自8E0C000B |
| ペンがWi-Fiに接続 | 1.2〜4.8秒 | |
| 合計 | 22〜38秒 | 中央値 28 秒 |
BLEアシストプロビジョニングはT2/Y6で最速の経路です。BLEリンクがAES-CCMで暗号化されているため(TC-059参照)、最もセキュアでもあります。欠点は、初回開封時にユーザーが常にペンとペアリング済みとは限らない点です。ユーザーマニュアルには「BLE初回設定ガイド」を同梱しています。
6. QRベースプロビジョニング（Y6のみ）
Y6は1.5インチOLEDを搭載しており、QRコードをレンダリングできます。プロビジョニングフローでは、ペン画面のQRコードをユーザーの電話がスキャンします。QRコードには、ペンの現在のプロビジョニング状態（SSID、信号強度、エラーコード）が含まれます。
| ステップ | 時間 | 備考 |
|---|---|---|
| ユーザーがボタンを5秒長押し | 5秒 | プロビジョニングモードに入ります |
| ペンがOLEDにQRを表示 | 200 ms | |
| スマホがQRをスキャン | 1～3秒 | |
| スマホがアプリに参加 | 1秒 | |
| アプリがSSIDとPSKを送信 | 5秒 | BLEまたはWi-Fi Direct経由 |
| ペンがWi-Fiに接続 | 1.2～4.8秒 | |
| 合計 | 13～24秒 | 中央値 18 秒 |
QR方式のプロビジョニングは最も速く、最もアクセスしやすい方式です。OLEDがBOMに1.80ドル追加するため、当社はY6のみに搭載しています。
7. プロビジョニング状態遷移図
ペンのファームウェアは次の状態遷移を実装しています。
IDLE -> [5s button hold]-> SCAN -> SOFTAP_ACTIVE | SMART_CONFIG_ACTIVE | BLE_WAIT | QR_ACTIVE SCAN -> [SSIDs found]-> SELECT_MODE SOFTAP_ACTIVE -> [credentials received]-> JOIN_WIFI SMART_CONFIG_ACTIVE -> [ESP-Touch decoded]-> JOIN_WIFI BLE_WAIT -> [BLE credentials written]-> JOIN_WIFI QR_ACTIVE -> [QR scanned]-> JOIN_WIFI JOIN_WIFI -> [DHCP success]-> CONNECTED JOIN_WIFI -> [timeout 30 s]-> RECOVERY RECOVERY -> [3 retries]-> FAIL FAIL -> [reset]-> IDLE
各状態には30秒のタイムアウトが設定されています。ペンはすべての遷移をQAテレメトリバッファ（TC-077）に記録します。ペンがFAILに戻った場合、ユーザーはボタンを5秒長押しして再試行する必要があります。
## 8. 802.1Xエンタープライズプロビジョニング
学校への導入では、Wi-Fiは通常WPA2-Enterprise（PEAPまたはEAP-TLS）が使用されます。ペンは両方に対応しています。
| EAP方式 | ユーザー名形式 | 証明書 | 利用シーン |
|---|---|---|---|
| PEAP-MSCHAPv2 | username@realm | なし | ほとんどのK-12学校 |
| EAP-TLS | N/A（証明書認証） | 端末ごと | 高セキュリティ環境 |
| EAP-TTLS | username@realm | 任意 | 大学 |
| EAP-FAST | username@realm | PAC | Cisco環境 |
ペンのTLSスタックは、ファームウェア全体と同じmbedTLS 3.4.0ライブラリを使用しています。端末ごとのクライアント証明書は、工場または学校のIT管理者がブランド管理アプリを通じてプロビジョニングします。証明書はセキュアエレメント（TC-100）に保存され、書き出しはできません。
## 9. 実際に確認されたプロビジョニングの障害モード
47,000台以上の実績に基づき、障害モード上位10件は以下のとおりです。
| 障害 | プロビジョニングチケットの割合 | 対策 |
|---|---|---|
| PSKの入力ミス | 32% | 「PSKを表示」トグルを追加し、エラーメッセージを表示 |
| 5 GHzネットワーク | 18% | ペンは2.4 GHzのみ対応のため、アプリでユーザーに注意喚起 |
| 隐藏SSID | 12% | キャプティブポータルに隐藏SSID入力欄を追加 |
| APがブロードキャストをブロック | 9% | 自動的にSoftAPモードに切り替え |
| 802.1Xのパスワード誤り | 8% | ユーザー名／パスワードのエラーメッセージを追加 |
| DHCPタイムアウト | 7% | DHCPタイムアウトを延長し、APのMACを記録 |
| キャプティブポータルのSSL警告 | 6% | 自己署名証明書をユーザーマニュアルに記載 |
| スマホがペンSSIDに接続してもポータルが表示されない | 4% | キャプティブポータルに手動URLのヒントを表示 |
| APがPMFを要求 | 3% | ファームウェア4.2.0で802.11w PMFに対応 |
| ペンのファームウェアが古い | 1% | プロビジョニング時にファームウェアバージョンを確認 |
2026年のファームウェアで最大の改善点は「PSKを表示」トグルの追加です。これだけでもプロビジョニング関連チケットが24%削減されました。
## 10. ブランド別プロビジョニングカスタマイズ
ODMのお客様は以下を要望できます。
1. カスタムSSIDプレフィックス（デフォルト：「SRP-<model>-Setup-XXXX」）。
2. カスタムキャプティブポータルブランディング（ロゴ、色、言語）。
3. カスタムプロビジョニングタイムアウト（デフォルト：30秒）。
4. プロビジョニング後に表示するカスタムステータスURL。
カスタマイズはブランドマニフェストを読み込むPythonスクリプトによってビルド工程で適用されます。MOQは3,000台です。
## 11. セキュリティに関する考慮事項
| 経路 | MITMリスク | 認証情報漏洩リスク | 備考 |
|---|---|---|---|
| SoftAP | 低（ローカルのみ） | 低（HTTPS） | 自己署名証明書 |
| Smart Config | 中（ブロードキャスト） | 中（傍受可能） | 信頼できるWi-Fiでのみ使用 |
| BLEアシスト | 低（AES-CCM） | 低 | 最適な経路 |
| QRコード | 低 | 低 | スマホがQRを読み取り、ブロードキャストなし |
厳格なセキュリティポリシーが必要な導入（防衛、医療など）では、BLEアシストのみを推奨します。家庭向けには、どの経路でも問題ありません。
15.2 対応ルーターおよびキャプティブポータル一覧
プロビジョニングフローは、以下の機器で当社回帰テストスイートに合格しています。お使いの学区がこの一覧にない機器を使用されている場合は、5日間のラボ検証をご依頼ください。通常は72時間以内に、1機種あたり480ドルの固定料金と1ページの受入レポートで対応いたします。
| ベンダー | ルーター / ゲートウェイ | WPA2-Personal | WPA2-Enterprise (802.1X) | キャプティブポータル | 検証済みモデル |
|---|---|---|---|---|---|
| Cisco | ISR 1100、Meraki MR36 | 合格 | 合格 (PEAP、EAP-TLS) | 合格 | B1、L5、T2、Y6 |
| Aruba | Instant On AP22、AP-505 | 合格 | 合格 (EAP-TTLS) | 合格 | B2、Q6、Q8、T2 |
| Ruckus | R510、R650 | 合格 | 合格 (PEAP) | 合格 | K7、KF1、Q8、Y6 |
| Ubiquiti | UniFi U6-Lite、UDM-Pro | 合格 | 合格 (EAP-TLS) | 合格 | F8、L5、Q6 |
| TP-Link | EAP245、Omada OC200 | 合格 | 制限あり | 合格 | B1、P2 |
| MikroTik | hAP ax2、RB5009 | 合格 | 合格 (EAP-TTLS) | 合格 | K7、KF1 |
| Huawei | AirEngine 5760 | 合格 | 合格 (PEAP) | 合格 | L5、T2 |
| Xiaomi | AX3000T | 合格 | 非対応 | 合格 | B1、F8 |
| Netgear | WAX610 | 合格 | 合格 (EAP-TLS) | 合格 | Q6、Q8 |
15.3 購入者の意思決定ルール
購入者向けヒント： APモードはオンボーディング手順のフォールバックとして必ず提示してください。APモード（84%）とBLE補助（92%）の8%差は小さく見えますが、利用者1万人規模で換算すると初四半期で800件ものサポートチケットを減らせる計算になり、ストア評価の底上げとして明確に測定できる効果をもたらします。
15.4 Wi-Fi無線ブロックの認証フットプリント
これらの認証を担う2.4 GHz無線は、CE-RED（EN 300 328 v2.2.2、EN 301 489-1/-17）、FCC Part 15.247、UKCA-RER、RCM（AS/NZS 4268）、KC（KN 301 489-1/-17、MSIP）、MIC（日本、第38条の24）、ISED RSS-247の対象です。筐体、マグネット、inkはEN 71-1/-2/-3、ASTM F963-17、CPSIA、RoHS 2.0、REACH、PROP 65の対象です。GCC（SFDA、サウジアラビア）、ESMA（UAE MoIAT）、SNI（インドネシア）、NOM（メキシコ）、INMETRO（ブラジル）が市場アクセスを拡大します。各出荷には適合宣言書バンドルと、2つの生産拠点のQAトラベラーに対する個体単位のシリアルマッピングが付属します。
15.5 内部相互参照と読み取りパス
ブランド更新後に新しいキャプティブポータルのUI文字列をプッシュするためのOTAチャネルについては、Reading Pen OTA Firmware Update Mechanism を参照してください。密集した教室でのチャネル選定を左右する2.4 GHzとデュアルバンドのトレードオフについては、Reading Pen WiFi 2.4G vs Dual Band IoT を参照してください。子どもがAP間を行き来する際のローミング挙動については、Reading Pen WiFi Roaming and Reconnect を参照してください。プロビジョニング後に動作するLAN検出層については、Reading Pen mDNS and DNS-SD Service Discovery を参照してください。本プログラムのメーカー側については、Wholesale Reading Pens および Private Label Reading Pens.
を参照してください。CTA: 学区や小売チェーン向けにブランディングされたキャプティブポータルが必要ですか？ 見積もりを依頼するという言葉を添えてご連絡ください。4ページのブランディングブリーフ（ロゴ、パレット、ロケール、コピー）と、定額のファームウェア統合見積もりをご希望いただけます。在庫の中性ペンはMOQ 500で5日以内に発送、カスタムキャプティブポータルはMOQ 3,000でファームウェア統合に4週間を要します。```