デバイス稼働時間を SORACOM Harvest へ送信する

ステップ 1: SORACOM プラットフォーム側の各種設定を行う

Github で公開されている vshymanskyy/TinyGSM から TinyGSM ライブラリを ZIP ファイルでダウンロードします。
ダウンロードした ZIP ファイルの名前を TinyGSM-master.zip から TinyGSM.zip に変更します。
Arduino IDE を起動し、スケッチ → ライブラリをインクルード → .ZIP 形式のライブラリをインストール… から手順 2 でファイル名を変更した ZIP ファイル(TinyGSM.zip)を選択します。
Arduino IDE のスケッチ → ライブラリをインクルードに TinyGSM が表示されていることを確認します。

以下の操作は、電源に接続されていない状態で行ってください。電源が入った状態で行うと予期しない挙動を引き起こしたり、ボードが故障する場合があります。

LTE-M Shield for Arduino のジャンパピンが下図のように Arduino のピンヘッダに対して水平にセットされていることを確認します。

Correct Jumper

下図のようにジャンパピンが外れていたり、逆向き（垂直方向）に設定されている場合は嵌め直します。

Invalid Jumper

また、電源スイッチを下図のように押下された状態（電源 ON ）にします。

Switch ON

もし上の写真のようになっておらず、下図のように OFF になっている場合はスイッチを押下して ON にしてください。

Switch OFF

モデムに対して AT コマンドを送信できるサンプルスケッチ serialbridge_lte-m_shield_for_arduino.ino を Arduino IDE のウィンドウに貼り付けて保存します。
Arduino 本体と USB ケーブルで接続し、ウィンドウの丸印に → アイコン (マイコンボードに書き込む) をクリックします。
Arduino IDE のウィンドウ下部に「ボードへの書き込みが完了しました。」と表示されたら書き込みが正常に完了しています。
Arduino IDE のツール → シリアルモニタを開き、ボーレートを 9600 bps に設定します。
>> Waiting for your AT command と表示されたら、シリアルモニタのウィンドウに以下の 4 つの AT コマンドを 1 行ずつ貼り付けて送信ボタンをクリック、あるいは Enter キーを押してコマンドを送信します。
```
AT+CGDCONT=1,"IP","soracom.io","0.0.0.0",0,0,0,0
AT+QCFG="nwscanmode",0,0
AT+QCFG="iotopmode",0,0
AT+QCFG="nwscanseq",00,1
```
下図のように、すべてのコマンドに OK と返答があれば完了です。

TinyGSM のライブラリは上記手順(ZIP 形式)でインストールしてください。Arduino IDE の [スケッチ] > [ライブラリをインクルード] > [ライブラリを管理…] から TinyGSM をインストールするとスケッチが正常に動作しない可能性があります。(2020/12/09 時点)
TinyGSM のライブラリが既にインストールされている場合は、Arduino IDE の libraries フォルダ内の TinyGSM フォルダを削除した後、上記手順で再度インストールしてください。

このサンプルスケッチは Grove Beginner Kit for Arduino の代わりに Arduino UNO R3 をご利用いただいた場合でも動作します。

以上で SORACOM Harvest 上で下図のように稼働時間が表示されるようになります。

また Arduino IDE のシリアルモニタでシリアルポートを開くと、下図のように IoT スターターキット for Arduino からの出力を見ることができます。

シリアルモニタに表示される出力が文字化けする場合は、シリアルモニタとスケッチのボーレートが一致していない可能性があります。下図の赤枠がスケッチ側のボーレート (CONSOLE.begin(115200); の数値) と一致していることを確認してください。

Blink onboard LED Seeediuno

スケッチ例は 60 秒に 1 回の送信となっています。送信間隔を変更する場合はスケッチ内の #define INTERVAL_MS (60000) にミリ秒で指定してください。