SORACOM IoT レシピ：IoTで屋内の環境モニタリングをする

公開: 2020年12月、更新: 2021年7月

レシピ難易度：★★☆☆☆

Arduino UNO 互換マイコンとセンサー10種がセットになった「Grove Beginner Kit」と、Arduino UNOでLTE-M通信が可能となる拡張ボード「LTE-M Shield for Arduino」がワンパッケージになった「IoTスターターキット for Arduino」で、仕事環境や家庭内の温湿度・気圧などを計測する「屋内環境計」を作ります。

全体の構成

使用する SORACOM サービス

• データ通信サービス SORACOM Air
• データ収集・蓄積サービス SORACOM Harvest Data
• ダッシュボード作成・共有サービス SORACOM Lagoon

本レシピに連動した動画を公開しています

使用する SORACOM サービス

• データ通信サービス SORACOM Air
• データ収集・蓄積サービス SORACOM Harvest Data
• ダッシュボード作成・共有サービス SORACOM Lagoon

本レシピを行うのに必要な時間、概算費用

本レシピは以下の通りです。

• 必要な時間: 約90分
• 概算費用: 約11,200円

※ 概算費用: ハードウェアや SORACOM を始めとした各種サービスの概ねの費用 (送料などの付帯費用や無料枠適用は考慮しないものとしています)

このコンテンツの進め方

本コンテンツは現状のままで提供され、株式会社ソラコムは、誤りがないことの保証を含め、明示であると黙示であるとを問わず、本コンテンツの記載内容につき、いかなる種類の表明も保証も行いません。

掲載情報の閲覧及び利用により、利用者自身、もしくは第三者が被った損害に対して、直接的、間接的を問わず、株式会社ソラコムは責任を負いかねます。

本コンテンツを実践する中で用意された機器、利用されたサービスについてのご質問は、それぞれの機器やサービスの提供元にお問い合わせをお願いします。機器やサービスの仕様は、本コンテンツ作成当時のものです。

株式会社ソラコムが提供する機器・サービスについてのご質問はフォームで受け付けております。機器・サービスご利用前の導入相談は https://soracom.jp/contact/ に、機器・サービスご利用開始後のサポートは、SORACOMユーザーコンソール内のサポートサイトから「リクエストを送信」(要ログイン)にてお問い合わせください。

Copyright (c) 2023 SORACOM, INC.

準備

本レシピを行うためには以下のものをご用意ください。

ハードウェア

※ 金額はレシピ作成時となります。金額は税込み・送料別です。

ご購入について

ハードウェアは以下よりご購入いただけます。

• IoT スターターキット for Arduino

その他必要なもの

※ アカウント作成・維持の費用の料金です。

設置に利用したもの

本レシピで設置時に利用した部材です。必須ではありませんがご参考にお使いください。

LTE-M Shield for ArduinoにSIMを取り付ける

LTE-M Shield for Arduino(以下、 LTE-M Shield) の上部は外すことができます。その上部の部品の裏面にあるSIMスロットへSIMを挿入した後、元に戻します。最後にアンテナを取り付けて終了です。

注意点

• SIMの挿入方法は、「カチ」という音がするまで奥に挿入してください。また取り外しはSIMを押し込むと「カチ」という音がしてSIMが取り出しやすい位置に出てきます。
• 再度部品を取り付ける際、ピンの位置がずれないように気をつけてください。
• 静電気にはご注意ください。

ジャンパ・電源スイッチの確認

出荷時の状態によって LTE-M Shield for Arduino のジャンパピンの取付状態や電源スイッチの状態が異なるため、以下の状態になっていることを確認します。

まず、ジャンパが右のように取り付けられ、Arduino シールドのピンソケットと平行に2つのピンヘッダを短絡している状態にします。

次に、ジャンパの隣の電源スイッチが右のように押し込まれた状態にします。

Grove Beginner KitにLTE-M Shieldを取り付ける

Grove Beginner Kitの中央がArduino UNO互換マイコンボード(Seeeduino Lotus、以下、Seeeduino) となっており、ここにLTE-M Shieldを取り付けることができます。

注意点

• ピンの位置がずれないように気をつけてください。
• 押し込むのには多少強い力が必要となります。押し込んでいる最中にSeeeduinoがGrove Beginner Kitから切り離されないよう、気をつけてください。
• 静電気にはご注意ください。

SORACOM Harvest Data の設定をする

Grove Beginner Kit からのデータを蓄積する SORACOM Harvest Data の設定を行います。

SORACOM ユーザーコンソールの［Menu］>［SIM 管理］とクリックして SIM 管理画面を開きます。

LTE-M Shield に取り付けた SIM) にチェックを付け、［操作］>［所属グループ変更］とクリックします。

SORACOM の便利な使い方: 複数の SIM を同時に扱う
チェックをつける対象を複数にすれば、一度の複数の SIM を対象に操作が可能です。

「新しい所属グループ」のプルダウンボックスをクリックした後、［新しいグループを作成…］をクリックします。

「グループ作成」のグループ名を入力して［グループ作成］をクリックします。

SIM 管理画面で割り当てたグループ名をクリックします。

［SORACOM Harvest Data 設定］をクリックして設定ができるように開きます。

「SORACOM Harvest Data 設定」で以下のように設定します。

その後［保存］をクリックしてください。
その後表示される「SORACOM Harvest Data が有効になっています」のダイアログでは［OK］をクリックしてください。

以上で「SORACOM Harvest Data」の設定が完了しました。

SORACOM Air を利用してセルラー通信をしてみる

LTE-M Shieldを使って SORACOM Air によるセルラー通信を行い、動作確認を行います。

セルラー通信ライブラリのインストール

3G 拡張ボードで利用できる通信ライブラリをインストールします。今回は TinyGSM というオープンソースライブラリを利用して、通信の確認を行います。

ライブラリマネージャからのインストール

Arduino IDE のメニューバーから [ツール]→[ライブラリを管理…]をクリックします。

※ 画面は macOS ですが、Windows も同様です。

検索ボックスに「TinyGSM」と入力し、「TinyGSM (by Volodymyr Shymanskyy)」を選択してインストールします。

バージョンに注意
TinyGSMのバージョンは 0.11.3 にて動作を検証しています。それ以前の一部バージョンではコンパイルエラーが発生する場合があります。

手動でライブラリをインストールしていた場合
手動で .ZIP形式のライブラリをインポートしていた場合、インポート後にArduino IDEのライブラリマネージャを利用してアップデートを実施すると「複数のライブラリが見つかりました」という旨のエラーが表示され、コンパイルエラーとなる場合があります。
上記のようなエラーが発生した場合は、Arduino のライブラリフォルダから「TinyGSM-master」フォルダを削除することで、ライブラリマネージャが管理するフォルダのみが残り、正常にコンパイルできるようになります。
（ライブラリフォルダは、Windowsの場合は「C:Users(ユーザ名)DocumentsArduinoLibraries」、Macの場合は「/Users/(ユーザ名)/Documents/Arduino/libraries」になります）

Uptime (起動してからの累積時間) をSORACOMに送信するスケッチを書き込む

Arduino IDE を起動し［ファイル］>［新規ファイル］を開くと void setup() { から始まる「空のスケッチ」が表示されます。

一度スケッチの内容を削除してから send_uptime_with_soracom.ino の内容で置き換えてください。

マイコンボードに書き込む

SeeeduinoとPCをUSB ケーブルで接続した後、Arduino IDE でボタンをクリックします。ボードへの書き込みが完了しました。と表示されたら正常終了です。

ファイルの保存ダイアログが表示されたら
ファイルを保存してください。ファイル名は任意ですが send_uptime_with_soracom というファイル名はどうでしょうか。
ファイルを保存しない (キャンセル) してもコンパイルとスケッチの転送はされます。

うまく動作しなかった場合

症状	考えられる原因	対策
症状	考えられる原因	対策
書き込みができなかった	SeeeduinoとPCの接続ができていない	SeeeduinoとPCとの接続を再確認してください。
	Arduino IDEの開発対象ボード定義が “Arduino UNO” になっていない	Arduino IDEは様々なボードの開発ができます。そのうちSeeeduinoは “Arduino UNO” として開発することになります。選択されているボード定義は Arduino IDE 編集画面の右下に表示されています。ここが Arduino UNO となっているか確認してください。
	Seeeduinoが認識されているシリアルポートポートが異なる	SeeeduinoとPCはシリアルポートで通信します。［ツール］-［シリアルポート］と進み、Seeeduinoが接続されているシリアルポートを選択してください。
waitForNetwork() より先に進まない	電力が不足している	USBケーブルを別のものに変えてみてください。
	SIM が取り付けられていない。(もしくは SORACOM IoT SIM ではない)	SORACOM 特定地域向け IoT SIM plan-D を取り付けてください。
	電波が圏外もしくは微弱である可能性がある	窓際等、通信条件が良い環境でお試しください。
	通信モジュールが正しくセットアップされていない	お手数ですが、ユーザードキュメント「よくあるお問い合わせ」記載の「スケッチ実行時に waitForNetwork() から先に進まない」セクションの内容を確認のうえ、設定を実施してください。この操作は一度だけ必要です。
	SIM が SORACOM に登録されていない※ SORACOM ユーザーコンソールで確認できます ( “登録されてない” 事が確認できます)	発注済みの SIM を登録する もしくは 通販サイトやイベント等で入手した SIM を登録する を行ってください。
	SIM の「状態」が “準備完了” となっている（ “使用中” でない）※ SORACOM ユーザーコンソールで確認できます	当該 SIM のチェックボックスをチェックしてから［操作］>［使用開始］をクリックして “使用中” に変更してください。
	TinyGSMがSORACOM IoT SIMに対応していないバージョンを使用している	ライブラリマネージャからインストールする場合はバージョン 0.11.3 以上を指定してください。

SORACOM Harvest Data でデータを確認する

デバイスからのデータを SORACOM Harvest Data で確認します。

SORACOM ユーザーコンソールの［Menu］>［SIM 管理］とクリックして SIM 管理画面を開きます。

M5Stack に取り付けた SIM) にチェックを付け、［操作］>［データを確認］とクリックします。

表示された画面でLine Chart を選択し［自動更新］を ON にします。

この表示された画面が SORACOM Harvest Data の画面となります。

自動更新とは？
画面を再読み込みしなくとも新しいデータが自動的に表示されるようにする機能です。5秒毎に新しいデータを表示するようになります。この機能が OFF の場合は、表示する期間を指定して［検索］をクリックすることで期間内のデータを表示できます。

しばらくすると、以下のように uptime が表示され始めます。

以上で動作確認は終了です。

USBケーブルをPCから抜き、いったんSeeeduinoの電源をOFFにしてください。

屋内環境計スケッチを書き込む

ここからは屋内環境計のスケッチを書き込むためのライブラリのインストールと実際の書き込みを行います。

“U8g2” をインストールする

ライブラリマネージャの一覧から U8g2 (by oliver) を選んで［インストール］をクリックします。バージョンはインストール時における最新バージョンを選んでください。

インストールが終了したら［閉じる］をクリックします。

“U8g2” を簡単に探し出す方法
検索用のテキストボックスへ u8g2 と入力すると素早く見つけることができます。

“Grove Temperature and Humidity Sensor” をインストールする

ライブラリマネージャの一覧から Grove Temperature and Humidity Sensor (by Seeed Studio) を選んで［インストール］をクリックします。バージョンはインストール時における最新バージョンを選んでください。

インストールが終了したら［閉じる］をクリックします。

“Grove Temperature and Humidity Sensor” を簡単に探し出す方法
検索用のテキストボックスへ grove dht11 と入力すると素早く見つけることができます。

“Grove – Barometer Sensor BMP280” をインストールする

ライブラリマネージャの一覧から Grove – Barometer Sensor BMP280 (by Seeed Studio) を選んで［インストール］をクリックします。バージョンはインストール時における最新バージョンを選んでください。

インストールが終了したら［閉じる］をクリックします。

“Grove – Barometer Sensor BMP280” を簡単に探し出す方法
検索用のテキストボックスへ grove bmp280 と入力すると素早く見つけることができます。

スケッチを書き込む

Arduino IDE を起動し［ファイル］>［新規ファイル］を開くと void setup() { から始まる「空のスケッチ」が表示されます。

一度スケッチの内容を削除してから send_multiple_sensor_data_with_soracom.ino の内容で置き換えてください。

マイコンボードに書き込む

SeeeduinoとPCをUSB ケーブルで接続した後、Arduino IDE でボタンをクリックします。ボードへの書き込みが完了しました。と表示されたら正常終了です。

ファイルの保存ダイアログが表示されたら
ファイルを保存してください。ファイル名は任意ですが send_multiple_sensor_data_with_soracom というファイル名はどうでしょうか。
ファイルを保存しない (キャンセル) してもコンパイルとスケッチの転送はされます。

設置してみる

実際に設置してみましょう。

電源はPCからも取ることができますが、USB 型 AC アダプタをつかって供給することも可能です。

SORACOM Harvest Data では以下のように確認できます。(動作確認に使用した uptime が表示されている場合がありますが、正常です)

以上でデータ送信の確認は終了です。

SORACOM Lagoon でダッシュボードを作成する (有効化まで)

SORACOM Harvest Data に蓄積されたデータを SORACOM Lagoon で活用していきます。

SORACOM Lagoon 用語解説

ここで SORACOM Lagoon で使われる用語を解説します。

SORACOM ユーザーコンソールの［Menu］>［データ収集・蓄積・可視化］>［SORACOM Lagoon］とクリックします。

［SORACOM Lagoon の利用を開始する］をクリックします。

プランのうち［Free］を選択したあと［続行する］をクリックします。

SORACOM Lagoon ユーザーの初期ユーザーに設定するパスワードを入力した後、［利用開始］をクリックします。

SORACOM Lagoon ユーザーの初期ユーザの ID は？
ID は SORACOM ユーザコンソールにログインしたときのメールアドレスが使われることになります。そのため、ここではパスワードのみ設定することになります。SORACOM ユーザコンソールへのログインとは異なるパスワードを設定する事を強くお勧めします。

利用開始がクリックできない場合は？
パスワードの条件が不足しています。全てに✔がつくようにパスワードを設定してください。

SORACOM Lagoon の有効化に成功すると、以下のように SORACOM Lagoon コンソールへのリンクと、Lagoon ユーザーの一覧が管理できるようになります。

この画面を SORACOM Lagoon 管理画面と呼びます。

SORACOM Lagoon 管理画面は、SORACOM Lagoon が有効化されている間は ［Menu］>［データ収集・蓄積・可視化］>［SORACOM Lagoon］で表示する事ができます。

SORACOM Lagoon でダッシュボードを作成する (SORACOM Lagoon へのログインまで)

SORACOM Lagoon 管理画面を表示したあと、［SORACOM Lagoon3 コンソール］をクリックします。

※ SORACOM Lagoon 管理画面は ［Menu］>［データ収集・蓄積・可視化］>［SORACOM Lagoon］で表示する事ができます。

Lagoon 3 で SORACOM のデータを取り扱うために、Lagoon 3 の利用を開始すると、オペレーターごとに Lagoon 3 専用の SAM ユーザーが作成されます。ただし、標準では、この SAM ユーザーには「Harvest Files にファイルをアップロードする権限」が付与されていません。そのため、Soracom X/Y Image で Harvest Files に画像をアップロードできません。
本レシピでは必要ありませんが、Harvest Files に画像をアップロードする機能を利用するには、ユーザーコンソールのSORACOM Lagoon画面で、[アクセスを許可] をクリックして、必要な権限を付与してください。

SORACOM Lagoon へログインします。

メールアドレス (SORACOM ユーザコンソールへログインする際のメールアドレス) と、SORACOM Lagoon 初期ユーザ作成時に利用したパスワードでログインします。

ログインに成功すると、以下のような画面が表示されます。これが SORACOM Lagoon ログイン直後の画面です。ここから「ダッシュボード」や「パネル」を作成していきます。

背景を白くしたい
SORACOM Lagoon の標準では背景が黒となっています。これは設定で変更が可能です。右下のアイコンにカーソルを合わせて表示される［Preferences］をクリックします。

設定画面に “UI Theme” を “Light” に変更して［Save］すると、背景が白くなります。

SORACOM Lagoon でダッシュボードを作成する (ダッシュボードのインポートまで)

あらかじめ設定が済んでいるテンプレートを使ってダッシュボードを作成します。

ダッシュボードアイコンにカーソルを乗せると表示される「Dashboards」メニューから［Manage］をクリックします。

［Import］をクリックします。

［Or paste JSON］のテキストボックスへ、以下のテキストを入力(貼り付け)ます。

貼り付けるテキストは lagoon_template_for_ambient_monitor_using_arduino.json です。(約600行ほどあるため、リンク先から定義を入手してください)

※lagoon_template_for_ambient_monitor_using_arduino.json の基となっている Gist (コード共有サイト) の URL はこちらです。

貼り付けたら［Load］をクリックします。

Load をクリックすると “Unexpected end of JSON input” と表示される
テキストが上手く入力できていない場合はと表示されます。

貼り付けたテキストを見直すようにしてください。

以下の画面に遷移します。Harvestで「Harvest」を選択し「import」をクリックします。

「Access denied to this dashboard」と表示されることがあります

[Folder] で「General」を選択して [Import] をクリックすると、「Access denied to this dashboard」と表示されますが、動作に影響はありません。

以下のように表示されていれば成功です。

SORACOM Lagoon でダッシュボードを作成する (パネルの編集からダッシュボードの保存まで)

“温湿度” >［Edit］をクリックします。

“メトリック” タブで読み込むデータを設定します

“メトリック” タブが表示されている（もしくは “メトリック” タブを選択した後）、以下の設定を行います。

選んだ時点で、データが表示されます。(下の図は “A metric” と表示されている部分の選択の様子です。 “B metric” についても同様に選択するようにしてください。

プルダウンに “Arduino/LTE-M Shield” が無い？
左から2番目のプルダウンについては、参考画像上では “Arduino/LTE-M Shield” と表示されていますが、これはSORACOM ユーザーコンソール上で SIM に名前を付けているからです。名前がついていない場合は SIM の IMSI (回線識別用の15桁の番号) が表示されます。

データが表示されていない？
データを蓄積し始めてから間もない場合、グラフの右端に「少しだけ」表示されている場合があります。これは、パネルの表示時間の標準が「過去1時間分」を表示するようになっているからです。

右上の「時間」ボタンで表示範囲を設定可能です。まずは「過去15分間」くらいが良いでしょう。

それでもデータが表示されていない場合は、いったん SORACOM Harvest Data データの蓄積具合を確認するようにしてください。

画面左上の[Go back]ボタンをクリックします。

残りのパネルにおいても同様の設定を行います。

ここまでの作業で「温湿度」のデータ表示を行いました。残りの「気圧」「光量 / 音量」「データ履歴」についても、温湿度の作業と同様にメトリックタブでLTE-M Shieldのデータを表示する設定を行ってください。

全ての設定が終了すると、以下の様な表示となります。

画面右上のをクリックすることでこれまでの作業を保存できます。

［Save］で保存します。

以上で全ての設定が終了です。

あとかたづけと注意事項

本レシピでは費用がかかるサービスを利用しています。
本項をよく読み、必要な操作や解除作業を行うようにして、想定外の費用が掛からないようにしてください。

費用について

ここで記載している金額は全て税込み、送料別となります。

SORACOM プラットフォームの利用料金

無料利用枠について
SORACOM サービスでは一部サービスにおいて無料枠が設定されています。たとえば SORACOM Air for セルラーであればアカウント毎で30円/月の通信分や、SORACOM Harvest Data であれば31日分の書込みリクエストなどです。料金詳細に「無料利用枠」として掲載されていますので、ご確認ください。

グループ解除

SORACOM Harvest Data 等、「機能が有効になっているグループに所属している SIM × 費用」となっているサービスにおいては、「機能を OFF にする」することで費用の発生を抑えることができます。またもう1つの方法として「グループに所属している SIM の数を減らす(= 解除する)」事でも費用を抑える事ができます。

グループ解除の方法はグループからの解除 (JP)をご覧ください。

SORACOM Harvest Data のデータ削除（任意）

SORACOM Harvest Data は基本的にはデータ保管料は無料※です。そのため、保存しておいても害はありませんが、デモ等で利用する際にはデータを綺麗にしておく必要が出てくるため、データ削除について解説します。

※発生から40日を超えたデータは削除されます。40日以上データを保管したい場合はデータ保持期間延長オプション利用料金をご利用ください。

SORACOM Harvest Data 画面 (［操作］>［データを確認］) のデータテーブルで、削除したいデータのチェックボックスを付けた後に［削除］をクリックします。表示されたダイアログで改めて［削除］をクリックすると、削除されます。
※ 複数のデータにチェックをつければ一括で削除可能です。

データの復元はできませんのでご注意ください。

SORACOM Lagoon の解約

SORACOM Lagoon はオンラインで解約が可能です。 Free プランであれば有効化しておいても費用は発生しませんが、長期に渡って利用しない場合には解約も選択いただけます。

解約の方法はSORACOM Lagoon の解約(JP)をご覧ください。

次のステップ

本レシピでは、IoT スターターキット for Arduino による「屋内環境計」を作りました。この後の発展形について解説します。

アラート機能の設定

SORACOM Lagoon は可視化を行うダッシュボードの作成だけでなく、値に応じたアラートを作ることも可能です。アラートのアイディアは以下の通りです。

• 湿度の乾燥を感知してお知らせ
• 光量の減少に応じた「電灯付けましょう」アラート
• 気圧の低下を検知したアラート

スマートフォンからの閲覧（データの共有）

SORACOM Lagoonはスマートフォンやタブレットからの表示に対応しています。外出先や他の方との情報共有に利用可能です。スマートフォンで見た時の様子がこちらです。

Maker および Pro プランなら、閲覧専用ユーザーを作ることができます
SORACOM Lagoonの上位プラン「Maker」もしくは「Pro」であれば、閲覧専用ユーザーを作成できます。これにより、情報共有の範囲や運用の柔軟性を高めることが可能です。詳しくはSORACOM Lagoon のご利用料金をご覧ください。

気象データの公開範囲には注意が必要です
温湿度や気圧といった現象全般を「気象」と言いますが、気象に関しては日本では気象業務法に準拠する必要があります。特に気をつけたいのが気象データの公開範囲です。気象庁のよくある質問にも記載されているとおり、気象データの公開については同ページや同法を確認ください。

商品ページへ戻る