CropWatch ナレッジベース
JA 日本語

リレーを操作する

リレーは、スマートフォンやパソコンからCropWatchでオン・オフできるスイッチです。このガイドでは、ダッシュボードでのリレーの表示、切り替え方と切り替わったことの確かめ方、時間指定のパルス、変化の履歴、操作できる人、そしてリレーを自動で切り替えるアラートルールについて説明します。

このページの内容

リレーとは

リレーボードには、リレー1とリレー2の2つの出力があります。それぞれがスイッチになっていて、離れた場所から操作したい機器をつなぎます。ポンプ、暖房機、換気扇、換気窓のモーターなどです。

CropWatchは、センサーと同じ電波ネットワークでリレーボードにコマンドを送り、ボードは切り替えたあとの状態を返します。リレーボードは常に受信待ちの状態なので、コマンドはたいてい数秒で届き、応答も返ってきます。コマンドがないときも、ボードは決まった間隔で自分の状態を報告します。

ダッシュボードとリレー履歴に表示されるのは、ボードが報告した状態です。ボタンを押すと要求が送られ、ボードの応答によって確認されます。

ダッシュボードでのリレーの表示

カード表示のダッシュボードの「第1ハウス」の列。「ハウス1 潅水リレー」のカードに緑の丸と「オン」、赤の丸と「オフ」が表示され、開いた詳細には「リレー1 オン」「リレー2 オフ」「最終受信 6m 34s」と「詳細」ボタンがある

1つ目の値がリレー1、2つ目がリレー2です。

1つ目の値がリレー1、2つ目がリレー2です。

リレーボードは、ほかのセンサーと同じようにダッシュボードに表示されます。カードには2つの値が並び、1つ目がリレー1、2つ目がリレー2です。それぞれ「オン」か「オフ」と表示され、前に色付きの丸が付きます(🟢 オン、🔴 オフ)。文字が必ず丸の隣にあるので、色に頼らなくても状態を読み取れます。

カードの「詳細」を開くと、「リレー1」「リレー2」という名前で2つのリレーが表示され、ボードが最後に報告してからの時間もわかります。表形式の表示では、「プライマリ」「セカンダリ」の列に「リレー1: 🟢 オン」「リレー2: 🔴 オフ」のように文字で表示されます。

ダッシュボードに表示されるのは、ボードの最新の報告です。応答待ちのコマンドは表示されないので、経過を見るにはリレーの画面を開いてください。

リレーの画面

リレーの画面の上部。期間のボタンと「電波強度」ボタンのある見出し、ONと表示され「オンにする」が押せないリレー 1のカード、OFFと表示され「オフにする」が押せないリレー 2のカード、閉じた「時間指定パルス制御」パネル、最終更新の日時

見出しの下に、2枚のリレーのカード、パルスのパネル、最新の報告の日時が並びます。

見出しの下に、2枚のリレーのカード、パルスのパネル、最新の報告の日時が並びます。

カードの「詳細」ボタン、またはロケーションのセンサー一覧からリレーを開きます。どのセンサーの画面にもある上部の見出し部分の下に、次のものが上から順に並びます。

  • 「リレー 1」「リレー 2」の2枚のカード:見出しは「現在の状態」で、スイッチの絵、「🟢 ON」「🔴 OFF」などのラベル、「オンにする」「オフにする」ボタンがあります。スイッチの絵は状態を示すだけで、押しても切り替わりません。
  • 「時間指定パルス制御」:押すと開くパネルで、リレーを指定した秒数だけオンにできます。
  • 「最終更新」:ボードが最後に報告した日時です。
  • 「リレー履歴」:選んだ期間の状態の変化とコマンドがすべて表示されます。

画面を開いている間、CropWatchは30秒ごとにボードの状態を取得します。同僚やアラートルールが切り替えた場合も、再読み込みせずに反映されます。

カードに「不明」と表示され、その下に「確認済みのリレーテレメトリーはまだありません。」とある場合、CropWatchにはそのリレーの状態の報告がまだありません。その場合も、操作できる権限があればボタンは使えるので、コマンドを送れます。

リレーをオン・オフする

ボードが応答した直後のリレーの画面。右上に緑のメッセージ「リレー 2 が ON と確認されました。」が出て、2枚のカードはどちらもONと表示されている

この緑のメッセージが、リレーが切り替わった確認です。

この緑のメッセージが、リレーが切り替わった確認です。
  1. リレーの画面を開きます。
  2. 切り替えたいリレーのカードで「オンにする」または「オフにする」を押します。今の状態と同じほうのボタンは強調表示され、押せなくなっています。すでにオンのリレーを、もう一度オンにすることはできません。
  3. コマンドを送っている間、ボタンに読み込み中の印が出ます。続いて「リレー 1 にコマンドを送信しました。デバイスからの確認を待っています。」と表示されます。
  4. そのまま待ちます。ボードはたいてい数秒で応答し、緑のメッセージ「リレー 1 が 🟢 ON と確認されました。」で確認できます。

この緑のメッセージが確認の印です。表示されるまでは、切り替えを要求しただけの段階です。

「よろしいですか?」の確認はありません。ボタンを押した瞬間にコマンドが送られるので、正しいリレーの画面の、正しいカードであることを先に確かめてください。

応答を待っている間の表示

応答を待っている間の2枚のリレーのカード。リレー 2のカードはすでにONと表示され、黄色の「確認待ち」ラベルと「コマンドを送信しました。デバイスからの確認を待っています。」という文が付いている。4つのボタンはすべて押せない

ボードが応答するまで、カードには要求した状態が表示され、ボタンはすべて灰色になります。

ボードが応答するまで、カードには要求した状態が表示され、ボタンはすべて灰色になります。

コマンドが送られるとすぐ、カードには要求した状態が表示され、黄色の「確認待ち」ラベルと「コマンドを送信しました。デバイスからの確認を待っています。」という文が付きます。その後の表示は、ボードの応答によって変わります。

応答を待っている間は、最長60秒、画面のリレーのボタンが2枚のカードともすべて押せなくなります。最初のコマンドの結果が出るか60秒たつまで、そのボードに次のコマンドは送れません。

ボタンを押したあとのリレーカードの表示
タイミング表示意味
すぐカードに「確認待ち」。CropWatchは5秒後、その後は4秒ごとにボードの応答を確認します。
20秒たっても応答がないとき「応答がないため、デバイスに現在の状態を報告するよう要求しました。」応答が途中で失われた可能性が高いため、CropWatchがボードにもう一度報告を求めます。
ボードが新しい状態で応答したとき緑のメッセージ「リレー 1 が 🟢 ON と確認されました。」が出て、黄色のラベルが消えます。リレーが切り替わりました。
60秒後、応答はあったが古い状態のままのとき黄色のメッセージ「コマンド送信後も、リレー 1 は 🔴 OFF と報告しています。」が出て、カードにはボードが報告した状態が表示されます。リレーは切り替わっていません。
60秒たっても応答がまったくないとき黄色のメッセージ「リレー 1 からまだ確認がありません。デバイスが次に報告した時点で更新されます。」が出て、ラベルが「未確認」に変わり、ボタンが再び使えるようになります。CropWatchは積極的に待つのをやめます。結果はボードの次の報告で決まります。

リレーが応答しないとき

「未確認」は、リレーが失敗したという意味ではありません。コマンドが届かなかったのか、実行されたうえで応答だけが失われたのか、この時点ではCropWatchにもわかりません。カードには要求した状態が「未確認」のラベル付きで表示されたままになり、「デバイスからまだ確認がありません。次回の報告時に自動で更新されます。」という文が出ます。次の報告が届くと、カードはボードが報告した状態に変わり、前の項目で説明した緑または黄色のメッセージが出ます。その間に画面を離れてもかまいません。結果はどちらにしてもリレー履歴に記録されます。

未確認のままのときや、「コマンド送信後も…と報告しています。」と出たときは、次の順に確認してください。

  1. リレーボードに電源が入っているか確認します。
  2. リレーの画面で「電波強度」を押し、最近ゲートウェイに受信されているか確認します。詳しくはアプリでゲートウェイを確認するをご覧ください。
  3. リレー履歴を見ます。結果が「切り替わらず」なら、ボードは応答したものの、古い状態のままです。
  4. もう一度だけコマンドを送ります。また失敗する場合はサポートにご連絡ください。

ボタンを何度も押すのは避けてください。押すたびに別のコマンドとして送られ、履歴にもすべて記録されます。

決まった時間だけオンにする

開いた「時間指定パルス制御」パネル。「パルス時間 (秒)」に300が入力されている。リレー 1がオンなので「リレー 1 をパルス」は押せず、「リレー 2 をパルス」は押せる

300秒は5分です。オンのリレーはパルスできません。

300秒は5分です。オンのリレーはパルスできません。

「時間指定パルス制御」を使うと、リレーを指定した秒数だけオンにし、その後はボードが自動でオフに戻します。たとえばポンプを5分間だけ動かしたいとき、あとで止めに戻る必要がありません。

  1. リレーの画面で「時間指定パルス制御」を押してパネルを開きます。
  2. 「パルス時間 (秒)」に長さを入力します。最初は60になっています。5分なら300です。
  3. 「リレー 1 をパルス」または「リレー 2 をパルス」を押します。

時間とボタンには、次の決まりがあります。

  • 15秒から4294967秒までの整数:上限は約49日です。それ以外の値を入れると「15 秒から 4294967 秒までの整数を入力してください。」と表示され、パルスのボタンは2つとも押せません。
  • リレーがオフであること:リレーがONと表示されている間、そのリレーのパルスボタンは押せません。先にオフにしてください。
  • 2つのリレーの状態がわかっていること:どちらかのリレーの状態の報告がまだないと、「Timed relay pulse requires a confirmed current state for both relays」と表示されて送れません。ボードの次の報告を待ってから、もう一度お試しください。
  • もう一方のリレーはそのまま:リレー1をパルスしても、リレー2は変わりません。

応答の待ち方は通常のコマンドと同じですが、パルスが終わった時点で待つのをやめます。そのため短いパルスでは、時間が来ると黄色のラベルが緑のメッセージなしで消えることがあります。ボードはパルスが終わった数秒後に報告するので、結果はそのあとリレー履歴に表示されます。

リレー履歴

新しい順に並んだ「リレー履歴」カード。「デバイスが状態の変化を報告」の行、佐藤 葵が要求して確認済みになった「リレー 2 → ON」のコマンド、それより前の「リレー 1 → ON」のコマンド、田中 健が要求した「リレー 2 → OFF」のコマンド、「応答あり」の「状態の報告を要求」の行

コマンドには送った人と応答の結果が表示されます。ボード自身の報告は「デバイスが状態の変化を報告」と表示されます。

コマンドには送った人と応答の結果が表示されます。ボード自身の報告は「デバイスが状態の変化を報告」と表示されます。

「リレー履歴」カードには、リレーに起きたことが新しい順に、秒単位の時刻とともに並びます。期間は画面上部のボタンで選びます。「今日のみ」(画面を開いたときに選ばれています)、「直近 24 時間」「直近 48 時間」「直近 72 時間」です。さかのぼれるのは最長72時間です。

「イベント」列には3種類の行があります。

  • 「デバイスが状態の変化を報告」:ボードが、リレーの状態が変わったことを報告しました。「リレー 1」「リレー 2」の列には変化後の両方の状態が表示され、変わったほうのリレーのラベルは塗りつぶしで表示されます。
  • 「リレー 1 → 🟢 ON」:リレーの画面から送られたコマンドです。パルスの場合は「リレー 1 → 🟢 ON(300 秒間)」と表示されます。その下に「要求者: 」と送った人の名前が表示されます。対象のリレーの列にはボードが応答で報告した状態、もう一方の列には横線が表示されます。
  • 「状態の報告を要求」:応答が遅れたため、CropWatchがボードに報告を求めました。コマンドの応答を待っている間に自動で記録されます。

「この期間にリレーの状態変化やコマンドはありません。」は、選んだ期間に何も起きなかったという意味です。さらにさかのぼるには、長い期間を選んでください。履歴を取得できなかったときは、赤いメッセージ「選択した期間のリレー履歴を読み込めませんでした。」が表示されます。

アラートルールが送ったコマンドは、コマンドとしては表示されません。ルールがリレーを切り替えると、履歴にはボードの報告が「デバイスが状態の変化を報告」として、名前なしで表示されます。

「結果」列(コマンドと状態の報告の要求)
結果意味
確認済みボードが、要求どおりの状態を報告しました。
応答ありボードが状態の報告の要求に応えました。
切り替わらずコマンドのあとにボードが報告しましたが、古い状態のままでした。
未確認結果を決める報告がありませんでした。ボードが応答しなかった、パルスが報告のないまま終わった、新しいコマンドに置き換えられた、のいずれかです。
確認待ちまだ待ち時間の中です。たいていは送信から1分以内です。

リレーを操作できる人

できることは、そのリレーボードに対する権限レベルで決まります。各レベルの説明は6つの権限レベルをご覧ください。

  • 所有者、管理者、マネージャー:リレーの画面のすべてを見られ、すべてのボタンを使えます。
  • ユーザー、閲覧のみ:同じ状態と履歴を見られますが、ボタンと時間の入力欄は押せず、「リレーコマンドをキューするにはマネージャー以上の権限が必要です。」と表示されます。
  • 無効:リレーボード自体が見えません。

CropWatchはコマンドが届くたびに権限を確認し直します。画面を開いている間に誰かがお客様の権限を下げた場合、ボタンを押すと「You do not have permission to control this relay」と表示され、何も送られません。

リレーを切り替えるアラートルール

アラートルールでは、人に知らせるだけでなく、または知らせる代わりに、リレーを切り替えることもできます。たとえば気温が30 °Cを超えたら換気扇を回す、といった使い方です。ルールの「4. アラートアクション」カードで「アクションタイプ」を「LoRaWAN」にします。ルールのほかの部分の設定はアラートルールの作成のとおりです。

アクションでは、次の項目を指定します。

  • 「デバイス」:切り替えるリレーボードです。一覧にはお客様がアクセスできるすべてのセンサーが名前とDevEUIで並ぶので、リレーボードを名前で選んでください。
  • 「アクション」:「リレー1を5秒間ON」「リレー2を5秒間ON」「両方のリレーを5秒間ON」(秒数は下の欄の値になります)、または「リレー1を常時ON」「リレー1を常時OFF」「リレー2を常時ON」「リレー2を常時OFF」です。
  • 「ON時間 (秒)」:時間指定のアクションのときだけ表示され、1から86400(24時間)まで指定できます。

チェックボックス「ルールがリセットされた時にリレーの状態を元に戻す」は、常時ON・常時OFFの4つのアクションのときだけ選べます。チェックを入れておくと、ルールがリセットされたときに、CropWatchは2つのリレーを両方ともオフにするコマンドを1つ送ります。それぞれのリレーを元の状態に戻すわけではありません。

  • 「リレー1を常時ON」の場合、リセット時にリレー1がオフになり、リレー2もオンだったならオフになります。
  • 常時OFFのアクションの場合、リセット時にリレーがオンに戻ることはなく、2つのリレーが両方ともオフになります。

同じボードのもう一方のリレーに、止めてはいけない機器をつないでいる場合は、チェックを入れないでください。

ルールが送った時間指定のONが動いている間、CropWatchはそのボードにほかのルールのコマンドを送りません。時間が終わり、さらに数秒たつまで待ちます。

表示されるメッセージと対処

次のメッセージの一部はCropWatchのサーバーから届くもので、アプリの言語設定にかかわらず英語で表示されます。

「Device is missing a valid TTI device id」について:センサーの追加の案内に沿って登録したリレーボードには、電波ネットワーク上の名前が自動で設定されます。それ以外のボードは、サポートに設定を依頼してください。

リレーの画面に表示されるメッセージ
メッセージ意味対処
リレーコマンドをキューするにはマネージャー以上の権限が必要です。このリレーボードに対する権限がマネージャー未満です。ロケーションの管理者に権限を上げてもらってください。
You do not have permission to control this relay同じく権限不足で、コマンドが届いた時点で判明したものです。ロケーションの管理者に権限を上げてもらってください。
A relay command is already in progress for device(後ろにDevEUI)ほかの人が同じ瞬間にこのボードへコマンドを送りました。数秒待ってカードを確認してから、もう一度送るか判断してください。
Timed relay pulse requires the target relay to currently be offCropWatchの最新の報告では、そのリレーはオンです。先にオフにするか、次の報告を待ってください。
Timed relay pulse requires a confirmed current state for both relaysどちらかのリレーの状態の報告がありません。ボードの次の報告を待ってください。
Device is missing a valid TTI device id電波ネットワーク上でボードを呼び出すための名前が登録されておらず、CropWatchから何も送れません。サポートにご連絡ください。アプリからは直せません。
TTI relay request failed電波ネットワークがコマンドを受け付けませんでした。1分ほどおいて再度お試しください。続く場合はサポートにご連絡ください。
現在リレーを更新できません。接続が切れたなどの理由で、コマンドを送れませんでした。インターネット接続を確認して、もう一度お試しください。
選択した期間のリレー履歴を読み込めませんでした。履歴を取得できませんでした。期間のボタンをもう一度押すか、画面を再読み込みしてください。

よくある質問

  • 「オンにする」を押しましたが、何も起きていないようです。カードを見てください。「確認待ち」なら、CropWatchがボードの応答を待っています。1分ほどお待ちください。
  • ボタンがすべて灰色です。コマンドの応答を待っている(最長60秒)か、権限がマネージャー未満です。権限が原因なら、ボタンの下にその旨が表示されます。
  • リレーはオフのはずなのに「オンにする」が押せません。CropWatchの最新の報告ではオンになっています。ボードの次の報告を待つか、リレー履歴で最後の変化を確認してください。
  • オンにしたのに、ダッシュボードはオフのままです。ダッシュボードはボードの報告に従って表示します。リレーの画面を開き、コマンドが確認されたかを見てください。
  • 誰がこのリレーを切り替えましたか?リレー履歴では、リレーの画面から送られたコマンドの下に「要求者: 」と名前が表示されます。アラートルールによる変化は「デバイスが状態の変化を報告」と表示されます。
  • パルスに10秒を指定できません。パルスは最短15秒です。
  • 先週の操作を確認できますか?この画面ではできません。リレー履歴でさかのぼれるのは最長72時間です。