ダッシュボードに戻る Aqlys logo

セットアップとトラブルシュート

最新の 6 桁シークレットナンバー方式に合わせた手順です。

1. 新規デバイスの紐付け(6桁コード)

  1. サインイン後、ヘッダー左上のグループ切替で追加先のグループを選択します。
  2. デバイス一覧ページの「デバイス登録」ボタンから デバイスの紐付け ページを開きます。
  3. ESP32 を起動し、OLED に 6 桁のシークレットナンバーが表示されるのを待ちます。表示されない場合は BOOT を 3 秒長押しして Wi-Fi ポータルを開き、家庭の Wi-Fi を設定すると新しい番号が表示されます。
  4. 表示された 6 桁を入力します。既存デバイスなら「再接続」表示、新規なら名前入力欄が出ます。
  5. 「デバイスを紐付ける / 再接続」を押すと、デバイスが自動で ingest secret を取得し、数十秒以内に `/ingest/logs` への送信を再開します。

6 桁コードの有効期間はおよそ 10 分です。切れたら BOOT 長押しで再取得してください(コードは毎回新しく出ます)。

2. Wi-Fi 再設定とグループ変更のコツ

  • Wi-Fi を変えたいときは BOOT を 3 秒長押し → 「ESP32_SETUP」などのポータルに接続 → 新しい Wi-Fi を保存すると自動再起動し、新しい 6 桁コードが表示されます。
  • 別グループに移すときも、上記で取得したコードを 紐付けページ に入力すれば再接続できます(既存デバイスは自動で判別されます)。
  • デバイス名を変えたい場合は、デバイス設定ページで編集するか、一度削除して新規登録してください。

3. データ確認のポイント

  • グループ未選択だとデバイスやグラフは表示されません。ヘッダーのグループ切替から選択してください。
  • ダッシュボード/センサー詳細では直近 24 時間のログとリアルタイム更新を確認できます。表示が止まったら「再読み込み」を押してください。
  • 閾値はデバイス設定ページの「センサー設定」で変更できます。閾値を超えているとゲージに警告色が出ます。
  • デバイス設定ページの「ESP32 再接続」で、OLED に出た 6 桁コードを入力して個別に再接続することもできます。

4. よくあるハマりと対処

  • コード入力で弾かれる: 6 桁のみになっているか、10 分以上経過していないか確認。切れていたら BOOT 長押しで再取得。
  • ポータルが開かない: スマホをセットアップ用 SSID に接続し、ブラウザで再読み込み。自動で出ない場合は `192.168.4.1` を直接開く。
  • ログが届かない/止まる: Wi-Fi が安定しているか、API_HOST などを正しく書き込んでいるか確認。紐付け直後は反映まで数十秒かかります。
  • グラフが空のまま: グループ選択・センサー選択を見直し、「再読み込み」を押してキャッシュを更新してください。