Inputs

Page: Setup -> Input

対応する入力デバイスの全一覧は対応する入力デバイスを参照してください。

センサー、ADC信号、あるいはコマンドの実行結果などの入力は、周囲の環境や離れた場所の状態を測定し、その測定値を時系列データベース（InfluxDB）に記録・保存します。このデータベースは、ダッシュボードウィジェットを動かしたり、機能を動作させたり、その他AoTの各部が正しく機能したりするために欠かせない測定値を供給する役割を担っています。入力を追加し、設定を行い、有効化することで、測定値がデータベースに継続的に記録され、AoT全体を通じてその測定値を利用できるようになります。

追加リストでデバイスを探す~

ページ上部のドロップダウンは、対応デバイスを何を測定するかによってグループ分けして表示します（土壌・養液、大気質、電力・エネルギー、気象・光、温度・湿度、動き・位置、システム・その他）。この中では、AoT独自のデバイスが常に先頭に表示されるようになっています。検索ボックスに文字を入力すると、そのたびに一覧が絞り込まれ、デバイス名・製造元名、モジュール名、インターフェース（I2C、UARTなど）に加えて、使用中の言語での測定名でも検索できます — つまり、測定値の翻訳後の名前で検索すれば、それを報告するすべてのセンサーが見つかるということです。

Open-Meteo気象入力~

内蔵の気象入力のほとんどはプロバイダーのアカウントと無料のAPIキーを必要とし、一部（KMA）は韓国のみを対象としています。Open-Meteoはどちらも不要です — 入力自体の座標オプションに緯度・経度を入力するだけで、キーなしで地球上どこでも動作します。

また、他の多くの無料気象ソースにはない値も報告します。すなわち、雲量を考慮してモデル化された日射量（W/m²）です。この入力がない場合、育苗場モードの日焼けロックは、雲を無視して常に安全側に誤る快晴時の推定値にフォールバックします。この入力を追加すると、ロックの判定はOpen-Meteoのモデル値に切り替わります — 平均的にはより正確になりますが、安全側にしか誤らないという保証はなくなります。

これらの値は、あなたの座標に対する予報モデルの1時間ごとの出力であり、現地で実測した値ではありません。無料プランは非商用利用に限られており（CC BY 4.0）、入力の設定で有料の APIキーを入力すると、Open-Meteoの商用エンドポイントに切り替わります。オプションの全一覧は対応する入力デバイスを参照してください。

Open-Meteoは、これとは別に2つの用途でもAoTに使われています — AIの知識ソースとして（地域を限定しない内蔵ソースを参照）、および地図上の気象レイヤーとして（GISレイヤー管理を参照）。この入力は3つ目の独立した経路であり、この3つの中で唯一、値を時系列データベースに通常の測定値として書き込みます。

MQTT入力: TLSとCA証明書~

MQTT入力は、TLS経由でブローカーに接続できます。「TLSを使用」をオンにし、「TLS CA証明書」を空のままにすると、システムのCAストアを信頼します。これは、公的に信頼された証明書（例: Let's Encrypt）を使うブローカーに必要な設定です。プライベート証明書や自己署名証明書を使うブローカーの場合は、そのCAファイルのパスを明示的に入力する必要があります — 入力しないと、証明書検証の段階で接続が拒否されます。ブローカーにローカルネットワークではなくインターネット経由で接続する場合は、常にTLSが必要です。

カスタム入力~

カスタム入力モジュールの構築のWikiページを参照してください。

AoTには、独自に作成したカスタム入力をAoTシステムの中で使用できるようにする、カスタム入力のインポートの仕組みが用意されています。カスタム入力は、[歯車アイコン] -> 構成 -> カスタム入力 ページからアップロードしてインポートできます。インポートが完了した後は、 Setup -> Input ページで通常の入力と同じように利用できるようになります。

動作するインプットモジュールをすでに開発済みの場合は、新しいGitHub Issueの作成またはプルリクエストの送付をぜひご検討ください。あなたが作成したモジュールが、内蔵セットに正式に取り込まれることもあります。

正しい形式の例を見るには、AoT/aot/inputs ディレクトリ内の内蔵モジュールを開いてください。

さらに、カスタム入力の例は AoT/aot/inputs/examples ディレクトリにあります。

内蔵セットには含まれていないカスタムモジュール専用の別のGitHubリポジトリは、 aot-inc/AoT-custom にあります。

入力コマンド~

入力コマンドは、Web UIから実行できる入力モジュール内の関数です。校正など、その入力に固有の作業に便利です。既定では、少なくとも1つのアクション「今すぐ測定値を取得」があり、これは次の周期が来る前に入力に測定値を取得させます。

Note

アクションは、その入力が有効な間のみ実行できます。

入力アクション~

各周期ごとに、入力は測定値を取得して時系列データベースに保存します。測定値の取得後、入力の機能を拡張するために1つ以上のアクションを実行できます。例えば、 MQTT発行アクションを使って、その測定値をMQTTサーバーに発行できます。

入力オプション~

入力オプションの詳細については、以下の表を参照してください。

設定	説明
有効化	センサーが正しく設定された後、有効化するとセンサーからの測定値の取得が始まります。有効化された条件付き機能も同時に動作を始めます。
無効化	無効化すると、センサーからの測定値の取得が停止します。関連する条件付き機能も動作を停止します。
保存	特定のセンサーについて、入力欄に入力された現在の設定を保存します。
削除	特定のセンサーを削除します。
今すぐ測定値を取得	入力に強制的に測定を行わせ、データベースに保存します。
上/下	特定のセンサーを表示順で上または下に移動します。
電源出力	センサーに電源を供給する出力を選択します。これにより、センサーが3回連続でエラーを返した場合に、電源を一度切って入れ直す電源サイクリングで問題を解決できます。リレーの代わりにトランジスタを使うこともできます。
位置	使用しているセンサーに応じて、シリアル番号、GPIOピン、I2Cアドレスなどを選択する必要があります。
I2Cバス	I2Cアドレスとの通信に使用するバスです。
周期（秒）	センサーの読み取りに成功しデータベースへの記録が終わった後、再度センサーを測定するまで待機する時間です。
測定単位	測定値を保存する単位を選択します（選択可能な測定値にのみ適用されます）。
事前出力	測定値を取得する前に出力を有効化する必要がある場合、有効化する出力番号を指定します。
事前出力の継続時間（秒）	センサー測定が行われる前に事前出力が動作する時間です。
測定中の事前出力	有効にすると、測定値の取得中も事前出力はオンのままになります。無効にすると、測定値を取得する直前に事前出力がオフになります。
コマンド	Linuxコマンド（ユーザー 'root' として実行）の戻り値が測定値になります。
コマンドの測定対象	Linuxコマンドで測定される条件（例: 温度、湿度など）です。
コマンドの単位	Linuxコマンドで測定される条件の単位です。

上記の表には一部のオプションのみを掲載しています。完全な一覧は原文のドキュメントを参照してください。