センサーを追加する

始める前に、次のものを手元にそろえてください。最後のステップで「デバイスを登録」を押すまでは何も保存されないため、途中でやめて後からやり直すこともできます。

• センサーとラベル：センサー本体または箱のラベルに、センサーを識別する16文字のコード「DevEUI」が記載されています。たいていは、DevEUIを含むQRコードも印刷されています。
• 参加キー（一部のセンサー）：CropWatchがお客様のアカウント用に準備していないセンサーでは、JoinEUI（16文字）とAppKey（32文字）も必要です。ラベルまたは箱に同梱の情報カードに記載されています。必要かどうかは画面に表示されます。
• 空きライセンス：センサー1台につき、ご自身のアカウントのライセンスを1件使います。画面上部の「利用可能なライセンス」に空きの件数が表示されます。
• ロケーションのマネージャー以上の権限：詳しくは「センサーを追加できる人」をご覧ください。
• 電波の届くゲートウェイ：センサーの計測データは、ゲートウェイを通ってCropWatchに届きます。設置場所の近くにゲートウェイがあり、電源が入ってオンラインになっていることを確認してください。設置方法は「屋内ゲートウェイの設置」で説明しています。

センサーを追加できるかどうかは、そのロケーションでの権限レベルで決まります。ロケーションの所有者、管理者、マネージャーは追加でき、ユーザーと閲覧のみは追加できません。各レベルでできることは「6つの権限レベル」、権限レベルの上げ方は「権限レベルを変更する」をご覧ください。

「デバイスを追加」ボタンは、権限レベルにかかわらず、ロケーションを開ける人全員に表示されます。マネージャー未満の人も画面は開けますが、DevEUIを入力した時点で赤い枠に「このロケーションにデバイスを追加する権限がありません」「デバイスの追加にはマネージャー以上の権限が必要です。ロケーションの所有者に権限の変更を依頼してください。」と表示され、「次へ」は押せないままです。

誰が追加するかによって、次の2点が決まります。

• 追加した人が所有者になります：センサーを追加した人が、そのセンサーの所有者です。
• ライセンスは追加する人のものを使います：ロケーションの所有者ではなく、センサーを追加する人のアカウントのライセンスを使います。ほかの人のロケーションにセンサーを追加するマネージャーは、自分のアカウントに空きライセンスが必要です。

最初のステップ「デバイスを識別する」では、センサーのDevEUIを入力します。方法は2つあります。

• 「QRコードを読み取る」：左側の大きなボタンを押すとカメラが起動し、センサー本体または箱のQRコードを読み取ります。スマートフォンでは最も手早い方法で、コードに参加キーが含まれていれば、それも自動で入力されます。
• 「DevEUI」欄：ラベルに記載されたコードを入力するか、貼り付けます。

どちらの方法でも、欄に有効な16文字がそろった時点で、CropWatchが自動でセンサーを確認します。押すボタンはありません。「デバイスモデル」欄と、必要な場合のキーの欄は、この確認が終わってから表示されます。

1. 「QRコードを読み取る」を押します。「デバイスのQRコードを読み取る」という画面が開きます。初めてのときは、CropWatchにカメラの使用を許可するかブラウザーが尋ねるので、許可してください。
2. QRコードが画面の四角い枠の中に入るように構えます。スマートフォンでは背面のカメラが使われます。映像の下には「デバイス本体または箱のQRコードにカメラを向けてください。」と表示されます。
3. コードを読み取ると画面は自動で閉じ、「DevEUI」欄に入力されます。確認もすぐに始まります。

CropWatchのラベルのほか、多くのLoRaWANセンサーメーカーが印刷しているQRコードを読み取れます。コードからDevEUIを取り出し、JoinEUIとAppKeyが含まれていればそれも入力します。CropWatchのラベルにはセンサーのモデルも記載されているため、モデルも自動で選ばれます。

画面の下には、ほかに2つのボタンがあります。

• 「写真を使う」：ライブ映像の代わりに、静止画を1枚読み取ります。スマートフォンではカメラが起動し、パソコンでは画像ファイルを選びます。静止画のほうが鮮明なので、小さいコードや傷んだコードがライブ映像で読み取れないときに試してください。
• 「DevEUIを入力する」：画面を閉じて、コードを手で入力します。

DevEUIは16文字で、使われるのは数字の0〜9と英字のA〜Fだけです。ほとんどのラベルでは「DevEUI」「EUI」「Device EUI」の横に記載されています。

• 区切りは気にしなくてかまいません：スペース、コロン、ハイフンは無視されるため、「00 13 7A 10 00 04 41 DF」「00:13:7A:10:00:04:41:DF」「00137A10000441DF」はどれも同じセンサーです。
• 大文字・小文字も区別しません：小文字は大文字として読み取られます。
• 貼り付けもできます：メールや表計算ソフトからコピーして、欄に貼り付けられます。

入力中に問題があると、欄の下に表示されます。

• 使えない文字がある：「使用できるのは0〜9とA〜Fのみです。「O」は使用できません。」のように、どの文字かが表示されます。よくある原因は、数字の0の代わりに英字のOを、数字の1の代わりに英字のIやlを入力していることです。
• 「16文字中17文字です。ラベルをもう一度確認してください。」：文字が多すぎます。余分な文字を入力した時点ですぐに表示されます。
• 文字が足りない：何も表示されず、確認も始まりません。16文字目の入力を待っている状態です。DevEUIは2文字ずつ8組なので、ラベルと組の数を見比べてください。

確認中は、回転する印とともに「デバイスを確認しています…」と表示されます。続いて、次のいずれかが表示されます。

• 「デバイスモデル」欄が表示される：このセンサーは追加できます。モデルを確かめ、求められたらキーを入力して「次へ」を押します。
• 「このデバイスはすでに追加されています」：このDevEUIのセンサーはすでにCropWatchにあり、あなたはそれを見ることができます。メッセージにはセンサー名とロケーションが表示されます。「（センサー名）を開く」を押してそのセンサーを開き、名前や場所を変えたい場合は、追加し直さずにその設定画面で変更してください。ほかの人が追加して共有したセンサーでも、この表示になります。
• 「このデバイスは別のアカウントに登録されています」：別のCropWatchアカウントがこのDevEUIを使っているか、CropWatchがこのセンサーを別のお客様に供給しています。まずDevEUIを確かめてください。正しければ、以前の所有者にそのアカウントからの削除を依頼するか、「サポートに問い合わせる」を押して注文番号をお知らせください。
• 「このロケーションにデバイスを追加する権限がありません」：このロケーションでの権限レベルがマネージャー未満です。ロケーションの所有者か管理者に、権限を上げてもらってください。
• 「このDevEUIを確認できませんでした。接続を確認して、もう一度お試しください。」：確認の問い合わせがCropWatchに届きませんでした。スマートフォンの電波やWi-Fiを確かめて「再試行」を押してください。
• 「システム側の問題により、このDevEUIを確認できませんでした。…」：CropWatch側の問題です。少し待ってから「再試行」を押すか、表示された参照番号を添えてサポートにお問い合わせください。
• 「短時間に試行が多すぎます。しばらく待ってから、もう一度お試しください。」：アカウントごとの1時間あたりの確認回数の上限に達しました。最長で1時間ほどお待ちください。

確認が通ると「デバイスモデル」欄が表示されます。モデルによって、CropWatchがセンサーをネットワークにどう登録し、データをどう読み取るかが決まります。手元のセンサーと必ず一致させてください。

モデルは自動で選ばれることがよくあります。欄の下の一行で、どこから選ばれたかがわかります。

• 「CropWatchのラベルから読み取りました。」：CropWatchのラベルのQRコードにモデルが記載されていました。
• 「DevEUIから判別しました。異なる場合は変更してください。」：CropWatchが供給したセンサーであれば、記録にあるモデルです。それ以外の場合は、DevEUIの先頭が同じほかのセンサーから推測したモデルなので、確かめてください。
• 「ラベルのデバイス種別「…」はまだ登録されていません。モデルを選択してください。」：CropWatchのラベルに、アプリがまだ認識できないモデルのコードが記載されています。モデルを自分で選んでください。
• 何も表示されない：モデルを自分で選んでください。

このセンサーに合いそうなモデルが一覧の先頭に並びます。このロケーションのネットワークリージョンで登録できないモデルはグレー表示になり、選べません。欄の下には、次のメッセージが表示されることがあります。

• 「デバイスモデルを選択してください。」：モデルを選ばずに「次へ」を押しました。
• 「このモデルは、このロケーションのネットワークリージョンではまだセットアップできません。追加をご希望の場合はサポートにお問い合わせください。」：このモデルには、このリージョン用のネットワーク設定がまだありません。サポートが追加するまで、ここでは登録できません。

2つ目のステップ「名前と設置場所」では、センサーの名前と置き場所を決めます。必須なのは名前だけです。

• 「デバイス名」：ダッシュボードやアラートでチームが目にする名前です。現場に立ったときにどれのことかわかる名前、たとえば「第2ハウス 北側」にしましょう。120文字まで入力できます。空欄のまま「次へ」を押すと「デバイス名を入力してください。」と表示されます。名前は後から変更できます。詳しくは「デバイス名」をご覧ください。
• 「グループ（任意）」：自由に付けられるラベルです。このロケーションですでに使われているグループが、欄の下にボタンとして最大8個表示されます。押すとそのグループが入力されるため、ほかのセンサーと表記がそろいます。グループの働きは「グループ」で説明しています。
• 「設置日（任意）」：センサーを設置した日です。今日より後の日付は選べません。日付は確認のステップに表示されますが、セットアップ後はアプリのどこにも表示されません。

その下の枠には、地図上でのセンサーの位置が表示されます。

• 「位置: ロケーションと同じ」：後ろにロケーションの座標が表示されます。センサー自体の位置は設定されません。センサーがロケーションの場所にあるなら、このままでかまいません。
• 「このロケーションにはまだ座標が設定されていません。デバイスの位置を個別に設定できます。」：ロケーション自体に、まだ地図上の位置がありません。
• 「正確な位置を設定」：「緯度」と「経度」の欄が開き、最初はロケーションの座標が入っています。センサーの位置を、35.6812、139.7671のような十進数の度で入力してください。小数点にはカンマ（35,6812など）も使えます。位置を設定したセンサーは、ロケーションの地図に専用のピンで表示されます（地図は、ロケーション自体に位置が設定されている場合にだけ表示されます）。
• 「ロケーションの位置を使用」：欄を閉じて、ロケーションの位置に戻します。

「-90〜90の緯度を入力してください（例: 35.6812）。」や、経度の同様のメッセージは、数値が範囲外か、単純な十進数になっていないことを示します。度分秒（35°40′52″など）は使えないため、先に十進数に換算してください。下の「戻る」を押すと、入力した内容を残したままステップ1に戻ります。

ステップ2の一番下に、センサーが使うライセンスが表示されます。

• 「利用可能な3件のライセンスのうち1件を使用します。」：空きライセンスの1件目が自動で選ばれています。操作は不要です。
• 「変更」：空きライセンスが2件以上あるときに表示されます。押すと「ライセンス」の一覧が開き、空きライセンスが「ライセンス #4」のように番号で並びます。どれを選んでもセンサーの動作は変わりません。ライセンスを番号で管理している場合に使ってください。
• 「すべてのライセンスが使用中です」：「デバイスごとに1件のライセンスが必要です。請求設定でライセンスを追加してから、もう一度お試しください。」と表示され、「次へ」は押せません。「ライセンスを追加」を押すと「請求とサブスクリプション」画面が開きます。CropWatchから直接請求されているアカウントでは、その画面にその旨が表示されるので、ライセンスの追加はCropWatchにご依頼ください。

見出しが「（センサー名）を登録しています」に変わり、「通常は数秒で完了します。このページを開いたままにしてください。」と表示されます。処理の内容は次の一覧で示されます。

1. 「DevEUIが使用可能であることを確認」：すぐにチェックが付きます。ステップ1で済んでいる確認です。
2. 「ネットワークに登録」：CropWatchが利用しているLoRaWANネットワークサーバー「The Things Industries」に、ロケーションのネットワークリージョンでセンサーを登録します。この登録があるので、センサーが参加しようとしたときにネットワークが受け入れ、計測データをCropWatchに渡せます。データが届くしくみは「LoRaWANとは？」で説明しています。
3. 「（ロケーション名）に追加」：センサーがロケーションに保存されます。
4. 「ライセンスを割り当て」：空きライセンスの1件がセンサーに割り当てられます。

一覧は、処理が終わった時点でまとめて更新されます。横の説明にある「いずれかの処理が失敗した場合、何も保存されず、ライセンスも使用されません。」のとおり、ネットワークへの登録やライセンスの割り当てに失敗した場合は、途中まで行った処理をCropWatchが取り消し、ライセンスも空きのまま残ります。

処理が途中で止まった場合は確認のステップに残り、一覧の上の枠に理由が表示されます。多くの枠の最後には「参照番号 CW-1A2B3C」のような短い番号が付いているので、サポートにお伝えください。キーの問題の場合は、代わりにステップ1に戻ります（「ネットワークキー」参照）。

ほとんどのセンサーは、電源を入れてから5分以内に最初のデータを送ります。「未受信」のままの場合は、次の順に確かめてください。

1. 電源：電池が正しい向きで入っていて、電源が入っているか確かめます。電池をいったん外して入れ直すと、センサーはネットワークへの参加をやり直します。
2. ゲートウェイ：センサーの近くのゲートウェイに電源が入り、オンラインになっているか確かめます（ゲートウェイの画面については「アプリでのゲートウェイ」をご覧ください）。しばらくセンサーをゲートウェイの近くに置き、そこでデータが届くなら、元の場所が遠すぎるか、電波が遮られています。電波の強さの見方は「RSSIとSNR」で説明しています。
3. モデル：モデルが違うと、センサーは間違ったネットワーク設定で登録され、それを直せるのはサポートだけです。モデルに自信がなかった場合は、サポートにお問い合わせください。
4. キー：JoinEUIとAppKeyを手で入力した場合、1文字違うだけでセンサーはネットワークに参加できず、登録の時点ではアプリもそれを見分けられません。DevEUIを添えてサポートにお問い合わせください。

• 「デバイスを追加」が見つからない：ダッシュボードではなく、ロケーションの画面にあります。メニューの「ロケーション」からロケーションを選び、画面上部のボタンを見てください。
• 最初のステップで「次へ」が押せない：確認が終わっていないか、確認で問題が見つかっています。DevEUIの下の表示を読んでください。16文字未満では確認は始まりません。
• 2つ目のステップで「次へ」が押せない：空きライセンスがありません。「ライセンスを選ぶ」をご覧ください。
• 空きライセンスがあるのに、すべて使用中と表示される：表示されるのはご自身のアカウントのライセンスだけで、ほかの人の空きライセンスは表示されません。ご自身のライセンスに空きがあるはずなら、ページを再読み込みしてください。CropWatchが請求の仕組みに接続できないときは、料金未払いのまま登録されないよう、空きライセンスを0件として表示します。
• 追加した覚えのないセンサーで「このデバイスはすでに追加されています」と出る：ほかの人が追加してあなたと共有したセンサーなので、すでにCropWatchにあります。「（センサー名）を開く」を押して開いてください。
• 「このデバイスは別のアカウントに登録されています」と出る：センサーが以前の所有者のアカウントに残っているか、CropWatchが別のお客様に供給したセンサーです。以前の所有者に削除を依頼するか、注文番号を添えてサポートにお問い合わせください。
• カメラは起動するが、コードを読み取らない：コードを四角い枠の中に入れ、手を止めて、近づけて、明るい場所で読み取ってください。それでも読み取れない場合は「写真を使う」を押してください。
• 「しばらくお待ちください」や「短時間に試行が多すぎます」と出る：1つのアカウントで1時間にできるのは、DevEUIの確認150回と、センサーの登録60台までです。最長で1時間ほどお待ちください。
• モデルを間違えた：センサーの設定画面にはモデルの欄がありません。DevEUIを添えてサポートにお問い合わせください。
• 名前やグループを間違えた：どちらもセンサーの設定画面で変更できます。「センサーの設定」をご覧ください。
• 別のロケーションに追加してしまった：センサーの設定画面から移動できますが、先に「ロケーションと、センサーを移動すると起きること」をお読みください。移動すると、センサーを見られる人が変わります。
• 続けて何台も追加したい：1台終わるごとに「別のデバイスを追加」を押してください。グループと設置日は次のセンサーに引き継がれます。
• 登録中にページを閉じてしまった：ロケーションを開いてください。センサーが表示されていれば登録は完了しています。表示されていなければ、もう一度追加してください。同じ名前と同じロケーションで追加すれば、どちらの場合も問題ありません。前回のセットアップが完了していればCropWatchがそのことを表示して2件目のライセンスは使われず、まだ処理中であれば「このデバイスはセットアップ中です」と表示されます。