System Configuration
Page: [管理者] -> 構成
構成メニューは、右上の「管理者」をクリックし、「構成」リンクを選択するとアクセスできます。 ここは、システム全体にわたるさまざまな設定を行うための領域です。
一般設定~
Page: [管理者] -> システム設定 -> 一般設定
| 設定 | 説明 |
|---|---|
| 言語 | Webユーザーインターフェースに表示する言語を設定します。 |
| HTTPS強制 | Webブラウザに SSL/HTTPS の使用を要求します。http:// へのリクエストは https:// にリダイレクトされます。 |
| 成功メッセージを非表示 | ページ上部に表示されるすべての成功アラートボックスを非表示にします。 |
| 情報メッセージを非表示 | ページ上部に表示されるすべての情報アラートボックスを非表示にします。 |
| 警告メッセージを非表示 | ページ上部に表示されるすべての警告アラートボックスを非表示にします。 |
| 統計収集を拒否する | 匿名の使用統計の送信を無効にします。この機能は開発に役立つため、可能であれば有効のままにしてください。 |
Webインターフェースのブランディングと配色をカスタマイズするには、下記のカスタムUIを参照してください。
カスタムUI~
Page: [管理者] -> システム設定 -> カスタムUI
このページでは、Webインターフェースのブランディングと配色パレットをカスタマイズできます — AoTに自社の名前やロゴを付けたり、単に配色を変えたりするのに便利です。ページ上部の ライブプレビューは、値を変更するたびにすべての色を表示します。保存をクリックするまでは、 他の画面には何も反映されません。
| 設定 | 説明 |
|---|---|
| ブランド表示 | ナビゲーションバーに表示する内容\: 既定のAoTブランディング、ホスト名、カスタムテキスト、またはアップロードした画像のいずれかです。 |
| タイトル表示 | ブラウザのタブタイトルに表示する内容\: ホスト名またはカスタムブランドテキストです。 |
| ブランドテキスト | ブランド表示またはタイトル表示でこれを使う設定にした場合に、ホスト名の代わりに使用されるカスタムテキストです。 |
| ブランド画像 | ブランド表示を「ブランド画像」に設定した場合に使用される、アップロード済みのロゴ(JPG、PNG、GIF、SVG、WebP)です。 |
| ブランド画像高さ | アップロードしたブランド画像の高さ(ピクセル)です。 |
| ファビコン表示 | 既定のAoTファビコンを使うか、アップロードしたカスタムアイコンを使うかを設定します。 |
| ファビコン画像 | ファビコン表示でこれを使う設定にした場合に使用される、アップロード済みのアイコンです。 |
ブランディングの下には、色がグループごとに整理されています: 「ブランドカラー」は常に 表示され、それ以外はタブとして切り替えます。それぞれの色には専用の16進数入力欄と カラーピッカーがあり、ライブプレビュー内の要素をクリックすると、その要素を制御する色に ジャンプします。
| 色グループ | 制御対象 |
|---|---|
| ブランドカラー | 強調アイコン、ドラッグハンドル、AIチャット要素などに使用されるプライマリ・セカンダリ・アクセントの色調です。 |
| テキストカラー | プライマリ・セカンダリのテキスト色に加え、塗りつぶしボタンやバッジ上のテキストに使用されるターシャリカラーです。 |
| 背景色 | カードとページの背景色です。 |
| 状態の色 | デバイスのオン/オフ/保留/警告の行の背景色、そしてアプリ全体で測定値のステータス・アラート・確認表示に使われる4つの意味付きカラー(成功・警告・危険・情報)です。それぞれに、淡い色調の背景/テキスト/境界線のバリエーションがあります。 |
| ボタンカラー | プライマリ・セカンダリボタンの背景色と、オン/オフ/一時停止/保留操作ボタンの色です。 |
| バッジカラー | AI(LLM)バッジ、MCPツールバッジ、アップグレード可能バッジの色です。 |
| 測定値の帯の色 | ゲージウィジェットやセンサー値ラベルで使用される5段階のしきい値の帯(非常に低いから非常に高いまで)の色です。 |
| チャートシリーズカラー | グラフ、PID、カレンダーウィジェットのシリーズに既定で割り当てられる6色の線色です。 |
テーマプリセットは、内蔵パレット(AoT Default、Ocean Blue、Warm Sunset、Minimal Gray、 Night Mode)または「プリセットを保存」で自分で保存したパレットに切り替えます。 「既定値にリセット」を押すと、AoT内蔵の配色に戻ります。
| 設定 | 説明 |
|---|---|
| カスタムCSS | 上記の色設定だけでは足りない変更のために、すべてのページに適用される追加のCSSです。 |
| カスタムレイアウト | ページレイアウトに挿入されるカスタムHTMLです。 |
時系列データベース設定~
Page: [管理者] -> システム設定 -> 一般設定
測定値は時系列データベースに保存されます。現在AoTで利用できる選択肢は、InfluxDB 1.xと InfluxDB 2.xです。InfluxDB 1.xは32ビット・64ビットどちらのOSでも動作しますが、2.xは 64ビットOSでのみ動作します。したがって、32ビットOSを使用している場合はInfluxDB 1.xを 使用する必要があります。AoTのインストール時に、InfluxDB 1.x、2.x、またはインストール しないことを選択できます。InfluxDBをインストールしない場合は、AoTが測定値を保存・取得 できるように、別途インストール先のアドレスと認証情報を指定する必要があります。
Dockerでインストールする場合、インストール後、InfluxDBのDockerコンテナに接続するために ホスト名を「aot_influxdb」に変更する必要があります。
| 設定 | 説明 |
|---|---|
| データベース | 使用するInfluxDBのバージョンを選択します。 |
| データ保持ポリシー | 保持ポリシーを選択します。既定値は、v1.xでは「autogen」、v2.xでは「infinite」です。 |
| ホスト名 | 時系列サーバーへの接続に使用するホスト名です。既定値は「localhost」です。 |
| ポート | 時系列データベースのポートです。既定値は8086です。 |
| データベース名 | AoTが保存・取得先とするデータベース名(v1.x)またはバケット名(v2.x)です。既定値は「aot_db」です。 |
| ユーザー名 | データベースにアクセスするためのユーザー名です(認証が必要な場合)。既定値は「aot」です。 |
| パスワード | データベースにアクセスするためのパスワードです(認証が必要な場合)。 |
ダッシュボード設定~
Page: [管理者] -> システム設定 -> 一般設定
| 設定 | 説明 |
|---|---|
| グリッドセルの高さ(px) | 各ウィジェットセルの高さをピクセル単位で設定します。 |
アップグレード設定~
Page: [管理者] -> システム設定 -> 一般設定
| 設定 | 説明 |
|---|---|
| インターネットテストIPアドレス | インターネット接続がアクティブかどうかをテストするために使用するIPアドレスです。 |
| インターネットテストポート | インターネット接続がアクティブかどうかをテストするために使用するポートです。 |
| インターネットテストタイムアウト | インターネット接続のテスト時に使用するタイムアウト時間です。 |
| 今すぐアップデートを確認 | 2日ごとに自動的にアップデートを確認し、Webインターフェースを通じて通知を表示します。新しいアップデートがある場合、構成(管理者)メニューとアップグレードメニューが赤色で表示されます。 |
エネルギー使用量設定~
Page: [管理者] -> システム設定 -> 一般設定
正確なエネルギー使用量の統計を計算するには、電気システムのいくつかの特性を知っておく 必要があります。これらの変数は、リレーを通じて電気デバイスを動作させる電気システムの 特性を表すものです。
Note
電流センサーを使用していない場合、エネルギー使用量を正確に計算するには、各出力に ついて正確な電流使用量を設定する必要があります(出力設定を参照)。
| 設定 | 説明 |
|---|---|
| 最大電流(A) | 一度に許容される最大電流を設定します。出力をオンにすることで、稼働中のデバイスの合計がこの値を超える場合、損傷を防ぐためにその出力をオンにできません。 |
| 電圧(V) | 出力を通じて切り替えられる交流(AC)電圧です。一般的には120または240です。 |
| kWhあたりのコスト | kWhあたりの電気料金を入力します。 |
| 通貨単位 | 電気料金に使用する通貨単位です。 |
| 検針日 | 電気メーターを確認する日(1~30日)です。電気料金の請求日と一致させてください。 |
| 使用量/コストレポートを生成 | エネルギー使用量レポートを生成するタイミングを定義します。現在は、出力の稼働時間に基づく計算方式のみに対応しています。 |
| レポート生成頻度 | 使用量/コストレポートを自動生成する頻度を設定します。 |
| レポート生成日 曜日/日付 | レポートを生成する曜日(毎日: 1~7、月曜日=1)または月の日付(1~28)を設定します。 |
| レポート生成時刻 時 | レポートを生成する時刻を0~23の範囲で設定します。 |
コントローラサンプリング周期設定~
Page: [管理者] -> システム設定 -> 一般設定
入力・出力・機能のそれぞれのコントローラーは、周期的に動作します。各コントローラーが 応答できる最速の速度は、そのコントローラーのサンプリング周期によって決まります。 コントローラーは、その周期の間、ループを一時停止します。例えば、出力コントローラーの サンプリング周期が1秒に設定されている場合、出力のオン/オフコマンドは最大1秒以内に 反応します。
| 設定 | 説明 |
|---|---|
| 最大電流 | 一度に許容される最大電流(A)を設定します。出力をオンにするコマンドが、現在オンになっているデバイスと合わせてこの値を超える場合、損傷を防ぐためにその出力はオンになりません。 |
| 電圧 | 出力を通じて切り替えられる交流(AC)電圧です。一般的には120または240です。 |
| kWhあたりのコスト | kWhあたりの電気料金を入力します。 |
| 通貨単位 | 電気料金の支払いに使用する通貨単位です。 |
| 検針日 | 電気メーターを確認する日(1~30日)です。電気料金の請求日と一致させてください。 |
| 使用量/コストレポートを生成 | エネルギー使用量レポートを生成するタイミングを定義します。現在は、出力の稼働時間に基づく計算方式のみに対応しています。 |
入力設定~
Page: [管理者] -> システム設定 -> カスタム入力
入力モジュールをAoTにインポートして使用できます。これらのモジュールは特定の形式に 従う必要があります。詳細はカスタム入力を参照してください。
| 設定 | 説明 |
|---|---|
| 入力モジュールをインポート | 入力モジュールのファイルを選択し、このボタンをクリックしてインポートを開始します。 |
出力設定~
Page: [管理者] -> システム設定 -> カスタム出力
出力モジュールをAoTにインポートして使用できます。これらのモジュールは特定の形式に 従う必要があります。詳細はカスタム出力を参照してください。
| 設定 | 説明 |
|---|---|
| 出力モジュールをインポート | 出力モジュールのファイルを選択し、このボタンをクリックしてインポートを開始します。 |
機能設定~
Page: [管理者] -> システム設定 -> カスタム機能
機能モジュールをAoTにインポートして使用できます。これらのモジュールは特定の形式に 従う必要があります。詳細はカスタム機能を参照してください。
| 設定 | 説明 |
|---|---|
| 機能モジュールをインポート | 機能モジュールのファイルを選択し、このボタンをクリックしてインポートを開始します。 |
アクション設定~
Page: [管理者] -> システム設定 -> カスタムアクション
アクションモジュールをAoTにインポートして使用できます。これらのモジュールは特定の形式 に従う必要があります。詳細はカスタムアクションを参照してください。
| 設定 | 説明 |
|---|---|
| アクションモジュールをインポート | アクションモジュールのファイルを選択し、このボタンをクリックしてインポートを開始します。 |
ウィジェット設定~
Page: [管理者] -> システム設定 -> カスタムウィジェット
ウィジェットモジュールをAoTにインポートして使用できます。これらのモジュールは特定の 形式に従う必要があります。詳細はカスタムウィジェットを参照してください。
| 設定 | 説明 |
|---|---|
| ウィジェットモジュールをインポート | ウィジェットモジュールのファイルを選択し、このボタンをクリックしてインポートを開始します。 |
測定設定~
Page: [管理者] -> システム設定 -> 測定値一覧
AoTの内蔵タイプや計算式を超えて機能を拡張するために、新しい測定・単位・変換を作成 できます。測定を作成する前に、まず単位を作成する必要があります。測定を作成する際に 単位を選択する必要があるためです。既存の測定に単位を追加で割り当てることもできます。 例: altitude はすでに存在していますが、fathom 単位を追加したい場合は、まず fathom 単位を作成し、その後 fathom を選択した状態で altitude の測定を作成 してください。
| 設定 | 説明 |
|---|---|
| 測定ID | 入力モジュールのmeasurements_dictで使用する測定のID(例: "length"、"width"、"speed") |
| 測定名 | 測定の一般名(例: "Length"、"Weight"、"Speed") |
| 測定単位一覧 | その測定に関連付けるすべての単位を選択します。 |
| 単位ID | 入力モジュールのmeasurements_dictで使用する単位のID(例: "K"、"g"、"m") |
| 単位名 | 単位の一般名(例: "Kilogram"、"Meter") |
| 単位の略称 | 単位の略称(例: "kg"、"m") |
| 変換元単位 | 変換の基準となる単位です |
| 変換先単位 | 変換先の単位です |
| 変換式 | ある単位を別の単位に変換するために使用する式です。小文字の "x" を含んでいる必要があり(例: "x/1000+20"、"250*(x/3)")、実際の測定値がそのxに置き換わります。 |
ユーザー設定~
Page: Manage -> システム管理 -> ユーザー
AoTのログインシステムを有効にするには、少なくとも1人の管理者ユーザーが必要です。 管理者ユーザーが存在しない場合、Webサーバーは管理者作成フォームにリダイレクトされます。 これは、AoTを初めて起動したときに表示される最初のページです。管理者ユーザーが作成 された後は、ユーザー設定ページで追加のユーザーを作成できます。
| 設定 | 説明 |
|---|---|
| ユーザー名 | 2文字から64文字の間でユーザー名を選択してください。大文字・小文字は区別されず、すべて小文字に変換されます。 |
| メール | そのアカウントに関連付けるメールアドレスです。 |
| パスワード/確認 | 文字・数字・記号のみを含む8文字以上のパスワードを選んでください。よく使われるパスワードは、この長さの条件を満たしていても拒否されます。[セキュリティ](Security.md#password-requirements)を参照してください。 |
| キーパッドコード | キーパッドでログインする際に使用する、4桁以上の数字コードです(任意)。 |
| 役割 | ユーザーの権限を設定するために使用する役割です。下記の4つの既定の役割の説明を参照してください。 |
| テーマ | Webユーザーインターフェースに適用されるテーマです。配色やデザイン要素などが含まれます。 |
役割~
役割は、各ユーザーの権限を定義します。ユーザーがAoTの特定の領域を閲覧または編集できる かどうかを決める、4つの既定の役割が用意されています。既定の役割に加えて、カスタムの 役割を作成することもできます。
| 役割 | Admin | Editor | Monitor | Guest |
|---|---|---|---|---|
| ユーザーを編集 | X | |||
| コントローラを編集 | X | X | ||
| 設定を編集 | X | X | ||
| 表示設定 | X | X | X | |
| カメラを表示 | X | X | X | |
| 統計を表示 | X | X | X | |
| ログを表示 | X | X | X |
コントローラを編集 権限は、条件付き機能、グラフ、LCD、メソッド、PID、出力、入力の 編集を保護します。
統計を表示 権限は、使用統計、システム情報、エネルギー使用量の各ページの閲覧を保護 します。
グループ~
Page: Manage -> システム管理 -> ユーザー -> グループ
役割とグループは、それぞれ異なる問いに答えるものです。役割は、ユーザーが何をでき るか(設定の編集、コントローラーの編集、統計の閲覧など — 上記の役割を参照) を決めます。グループは、ユーザーがどのダッシュボード・地図・施設・タブ(および、 それらのタブに配置された入力・出力・機能・コントローラー)を操作できるかを決めます。 この2つは組み合わさって機能します。何かを操作するには、その操作に対する役割の権限と、 その対象が付与されているグループへの所属の両方が必要です。
既定では、どのリソースもどのグループにも属していないため、グループが存在しなかった ときと動作は変わりません — 役割がその操作を許可しているユーザーであれば、誰でもそれを 実行できます。この状態は、特定のリソースにグループを付与した時点から変わります。 その時点以降は、付与されたグループのメンバー(および、役割で「すべてのグループに アクセス」が有効になっているユーザー)だけが、そのリソースを操作できるようになります。 それ以外のユーザーは直ちに操作権限を失うため、グループを付与する前に、現在そのリソース を誰が使っているかを確認してください。
グループが制限するのは、リソースの操作だけです — デバイスのオン・オフ、設定の変更、 削除、ダッシュボード/地図/施設/タブページを開くことなどです。閲覧は制限しません。 センサーの測定値、履歴、エクスポートしたデータは、そのグループに属しているかどうかに 関わらず、ログインしているすべてのユーザーに引き続き表示されます。
このページ(ユーザーの下にあるグループタブ)は、グループの作成とメンバーの選択のため だけのものです。リソースへのグループの付与は、このページでは行いません。
| 設定 | 説明 |
|---|---|
| グループ名 | グループの名前です。 |
| 説明 | そのグループが何のためのものかです。記入しておかないと、後でそのグループがまだ必要かどうか誰にも分からなくなります。 |
| メンバー | このグループに属するユーザーです。 |
グループは、このページからではなく、そのリソース自身の設定から付与します。以下のそれぞれ は、自身の設定ダイアログの中に「この___を操作できるグループ」というセクションを持って います。
| リソース | グループが割り当てられる場所 |
|---|---|
| タブ | そのタブ自身の設定です。これは、そのタブに配置されたすべての入力・出力・機能・条件付き機能・トリガー・PID・カスタムコントローラーにも及びます — デバイス自体が独自のグループ設定を持つわけではなく、常に自分が置かれているタブの設定に従います。あるユーザーにデバイスが見えない、または操作できないように見える場合は、そのデバイスが属するタブに付与されているグループを確認してください。 |
| ダッシュボード | そのダッシュボード自身の設定です。 |
| 地図 | その地図自身の設定です。 |
| 施設 | その施設自身の設定です。 |
1人のユーザーが複数のグループに属することができます。あるリソースについて、ユーザーが 属する複数のグループの結果が食い違う場合は、より広いアクセス権のほうが適用されます — そのリソースが付与されているグループのいずれか1つにでも属していれば、操作できます。
役割の画面では、役割に「すべてのグループにアクセス」を設定できます。この 役割を持つユーザーは、あらゆるグループ制限を回避し、付与の有無に関わらずすべての リソースを操作できます — 特定の領域ではなくシステム全体を管理する、少数のユーザーを 想定した設定です。既定で用意されている管理者役割は、既定でこの設定が有効になっています。
Raspberry Pi設定~
Page: [管理者] -> システム設定 -> Raspberry Pi
Raspberry Pi設定は、AoTが動作するLinuxシステムの一部を構成します。
PWM出力、およびPWM、RPM、DHT22、DHT11、HTU21Dの各入力を使用するには、pigpiodが必要です。
| 設定 | 説明 |
|---|---|
| 機能の有効化/無効化 | raspi-config コマンドを通じて、Web UIから有効化・無効化できるシステムインターフェースです。 |
| pigpiodサンプリングレート | pigpiodサービスが動作するサンプリングレートです。数値を小さくするとより高いPWM周波数を使えるようになりますが、Pi Zeroではプロセッサ負荷が大幅に増加する可能性があります。必要でなければ、pigpiodを完全に無効化することもできます(上記の注記を参照)。 |
アラート設定~
Page: [管理者] -> システム設定 -> アラート
アラート設定では、メール通知を送信するための認証情報を設定します。
| 設定 | 説明 |
|---|---|
| SMTPホスト | メール送信に使用するSMTPサーバーです。 |
| SMTPポート | SMTPサーバーとの通信に使用するポートです(SSLは465、TSLは587)。 |
| SSLを有効化 | SSLを有効にする場合はチェックし、TSLを有効にする場合はチェックを外します。 |
| SMTPユーザー | メール送信に使用するユーザー名です。名前のみ、またはメールアドレス全体のどちらでも入力できます。 |
| SMTPパスワード | そのユーザーのパスワードです。 |
| 差出人メール | 送信元メールアドレスとして設定する値です。この値は、実在するユーザーのメールアドレスである必要があります。 |
| 1時間あたりの最大メール送信数 | 1時間あたりに送信できるメールの最大数を設定します。1時間以内にこの数を超えるアラートが発生した場合、超過分のアラートは破棄されます。 |
| テストメールを送信 | テストメールを送信して、メール設定を確認します。 |
カメラ設定~
Page: [管理者] -> システム設定 -> カメラ
AoTは複数のカメラを同時に使用できます。それぞれのカメラは、カメラ設定で構成した後、 ソフトウェア全体で使用できるようになります。
Note
メーカー固有のハードウェアやソフトウェアの違いにより、一部のオプション(色調や ホワイトバランスなど)は特定のカメラでは使用できないことがあります。
| 設定 | 説明 |
|---|---|
| タイプ | カメラがRaspberry Piカメラか、USBカメラかを選択します。 |
| ライブラリ | カメラとの通信に使用するライブラリを選択します。Raspberry Piカメラはpicameraを使用し、USBカメラはfswebcamに設定する必要があります。 |
| デバイス | カメラを接続するデバイスを指定します。このオプションはfswebcamライブラリのみで使用されます。 |
| 出力 | 静止画の撮影中(タイムラプスを含む)に有効化される出力を設定します。 |
| 出力継続時間 | 画像を撮影する前に出力を有効化しておく時間を設定します。 |
| 画像を回転 | 画像を回転させる角度を設定します。 |
| … | 画像の幅、画像の高さ、明るさ、コントラスト、露出、ゲイン、色調、彩度、ホワイトバランス。これらのオプションは、その名称からわかる通りの機能です。すべてのカメラですべてのオプションが動作するとは限りません。 |
| 事前コマンド | 静止画を撮影する前に 'root' ユーザーとして実行するコマンドです。 |
| 事後コマンド | 静止画を撮影した後に 'root' ユーザーとして実行するコマンドです。 |
| 水平反転 | 画像を水平方向に反転(ミラーリング)します。 |
| 垂直反転 | 画像を垂直方向に反転(ミラーリング)します。 |
診断設定~
Page: [管理者] -> システム設定 -> 診断
互換性のない構成が原因で、システムに問題が発生することがあります。これは、システムの 一部(入力、出力など)の設定が誤っていること、データベースのアップグレードが正しく 処理されなかった更新、またはその他の予期しない問題によって起こり得ます。問題の原因を 特定したり、問題そのものを解決したりするために、診断を行う必要がある場合があります。 以下のオプションは、問題を緩和することを目的としています。例えば、Data -> Dashboard ページに、誤った構成のダッシュボード要素が原因でエラーが発生してアクセスできない場合、 すべてのダッシュボード要素を削除することが、アクセスを取り戻す最も手っ取り早い方法かも しれません。ただし、この場合、既存のすべてのダッシュボード要素を再度追加し直す必要が あることに注意してください。
| 設定 | 説明 |
|---|---|
| すべてのダッシュボードを削除 | Data -> Dashboard ページに保存されているすべてのダッシュボードを削除します。 |
| すべての入力を削除 | Setup -> Input ページのすべての入力を削除します。 |
| すべてのノートとタグを削除 | More -> Note ページのすべてのノートとタグを削除します。 |
| すべての出力を削除 | Setup -> Output ページのすべての出力を削除します。 |
| 設定データベースを削除 | aot.db 設定データベースを削除します(警告: これにより、すべての設定とユーザーが削除されます)。 |
| ファイルを削除: .dependency | .dependency ファイルを削除します。依存関係インストールページにアクセスできない場合に試してください。 |
| ファイルを削除: .upgrade | .upgrade ファイルを削除します。アップグレードページにアクセスできない場合や、アップグレードの実行に問題がある場合に試してください。 |
| InfluxDB 1.x データベースを再作成 | InfluxDB 1.x の測定データベースを削除してから再作成します。これにより、すべての測定データが削除されます! |
| InfluxDB 2.x データベースを再作成 | InfluxDB 2.x の測定データベースを削除してから再作成します。これにより、すべての測定データが削除されます! |
| メールカウンターをリセット | 1時間あたりのメールカウンターをリセットします。 |
| 依存関係をインストール | AoTシステム全体で必要なすべての依存関係をインストールするスクリプトを開始します。 |
| マスターへのアップグレードを設定 | config.py の FORCE_UPGRADE_MASTER を True に変更します。これは、ログインして config.py ファイルを手動で編集することなく、GitHubのmainブランチへアップグレードするようアップグレードシステムに指示する方法です。 |