Pi-FieldとEnOceanを使って電源レスの温度測定システム

# EnOceanとPi-FieldとSORACOM Airを使って電源不要の温度測定システム

こんにちは、木内です。この記事では、「Raspberry Pi」＋「Pi-field(ラズパイ屋外稼働キット)」＋「SORACOM Air」＋「EnOcean」の組み合わせで電源レスの温度測定デモシステムを構築する方法について解説しています。

---
## 1.はじめに
メカトラックス社様からRaspberry Piのための屋外稼働キットである[「Pi-field」](https://mechatrax.com/products/pi-field/)をお借りすることができましたので、「EnOcean」と「Pi-field」と「SORACOM Air」を組み合わせが電源レスの温度計測システムを構築しました。

エネルギーハーベストにより蓄積した微細な電力を使っって通信を行うEnOcean搭載のセンサーデバイスからの情報をソーラーパネル搭載のPi-fieldで動作しているRaspberry Piで受信し、SORACOM Airを使用して、SORACOMが提供するSORACOM Harvestサービスにデータを転送します。EnOceanセンサー（STM-431J）および「Pi-field」は、それぞれ光発電により動作可能ですので、完全な電源レス環境を構築することができます。「slee-Pi」を使用してRaspberry Piを間欠動作させることにより省電力で動作させます。今回構築するデモシステムの大まかなシステム構成は次の通りです。

<div align="center">
<img src=http://f.cl.ly/items/2L2k3s2c0j2k0i203q3B/SystemBlock.jpg width=100%>
</div>

このデモシステムを構築するために必要な機材を以下に一覧にしましたのでご参考にしてください。

- [ラズベリーパイ屋外稼働キット 「Pi-field」](https://mechatrax.com/products/pi-field/)
（Pi-fieldには[「slee-Pi」](https://mechatrax.com/products/slee-pi/)、[「3GPi」](https://mechatrax.com/products/3gpi/)、[Raspberry Pi3](https://www.raspberrypi.org/products/raspberry-pi-3-model-b/)が含まれています。）

- [EnOcean 温度センサー STM-431J](http://micro.rohm.com/jp/techweb_iot/knowledge/iot04/s-iot04/02-s-iot04/2768)
- [EnOcean 受信USBドングル USB400J](http://micro.rohm.com/jp/techweb_iot/knowledge/iot04/s-iot04/02-s-iot04/3069)
- EnOcean プログラミングボード EOP350
(EOP350の単体販売は今はなくなってしまったようです。EOP350はEnOcean開発キット「EDK 400J」(http://micro.rohm.com/jp/techweb_iot/knowledge/iot04/s-iot04/02-s-iot04/3582)に含まれています。)

- [SORACOM Air for セルラー](https://amzn.to/2K5xSH4) 

- [Raspberry Pi用USB-Serial(TTLレベル）変換ケーブル](https://amzn.to/2I9e6dn)

- 開発ホスト：Windows10 PC（必須です）
　　　　　　UbuntuなどのLinux PC（無くても可）


---
## 2.メカトラックス社Pi-Fieldについて
このデモシステムで使用する[メカトラックス社](https://mechatrax.com/)社様から[ラズベリーパイ屋外稼働キット「Pi-field」](https://mechatrax.com/products/pi-field/)を紹介します。pi-fieldを取り付けている黒いシャーシは今回のデモ用に取り付けたもので、キットには含まれません。

<div align="center">
<img src=http://f.cl.ly/items/1d0t1Z120W1H1p340y2a/pifield_chassis03.jpg width=80%>
</div>

Pi-fieldは電源やネットワーク環境がない屋外でもRaspberry Piを使用した環境モニタリングが可能となる屋外稼働キットになります。ソーラーパネル、防水ボックス、鉛蓄電池、太陽電池充放電コントローラと、メカトラックス社の3G通信モジュール（3GPi）、電源管理・死活監視モジュール（slee-Pi）、Raspberry Piが含まれたキットになっています。防水ボックスを開くと次のようになっています。

<div align="center">
<img src=http://f.cl.ly/items/1v15332A0P1y1k1F0c1Y/pifield_inside01_withText.jpg width=80%>
</div>

Pi-fieldは、鉛蓄電池が含まれているため約18Kgぐらいの重量があり、縦置きする必要があります。背面のアルミフレームを使用して屋外に設置できるようになっています。しかし、筆者の環境では適当な外部に取り付ける場所が準備できなかったため、ホームセンターで入手したL型フレームを使ってシャーシを作りました。このL型フレームは本来は棚を作るフレームで、キャスタ（車輪）込みで2,500円ぐらいで作ることができました。

<div align="center">
<img src=http://f.cl.ly/items/2W1V0a0p0X101Z3C3r3J/pifield_chassis02.jpg width=50%>
</div>

Pi-fieldに含まれているメカトラックス社のRaspberry Pi用の拡張ボードについても触れておきます、

#### [ラズベリーパイ用電源管理/死活監視モジュール「slee-Pi」](https://mechatrax.com/products/slee-pi/)
Raspberry Pi専用に開発された電源管理・死活監視モジュールであり、搭載されたRTC内蔵マイコンにより時間管理を行い、Raspberry Piの間欠動作やウォッチドック（死活監視）などが可能です。Raspberry Pi向けのライブラリがオープンソースで提供されています。


<div align="center">
<img src=https://cl.ly/2F3Q0y282V2p/download/Image%202018-05-09%20at%2011.19.54%20AM.png width=50%>
</div>

#### [ラズベリーパイ用3G通信モジュール「3GPi」](https://mechatrax.com/products/3gpi/)
Raspberry Pi専用に開発された3G通信（携帯電話通信）モジュールであり、対応したSIMカードを使用して3G回線によりインターネット接続が可能になります。Raspberry Pi向けのライブラリや設定ファイルが提供されていますので、Raspberry Piを簡単にインターネットへ接続させることができます。

<div align="center">
<img src=https://cl.ly/411m2r040a3A/download/Image%202018-05-09%20at%2011.21.57%20AM.png width=50%>
</div>


---
## 3.EnOceanとは
EnOceanは、太陽光や照明光、機械の発する振動、熱などのエネルギーを採取し、電力を得るエネルギーハーベストを利用した無線通信技術です。例えばスイッチを押す力を電気に変えたり、光発電パネルで起こした電気をコンデンサーに蓄積し、この電力で各種センサーのデータを送信するといった使い方ができます。
EnOceanの最も大きな特徴は、バッテリ不要で動作する無線通信になります。日本国内向けには928MHz帯の周波数帯を使用しており、通信到達距離は使用周波数や周辺環境に応じて30m〜300mとなっています。今回のデモシステムで使用したモジュールやデバイスを簡単に紹介します。

### [USB受送信モジュール「USB-400J」](http://micro.rohm.com/jp/techweb_iot/knowledge/iot04/s-iot04/02-s-iot04/3069)
USB 400Jは、USB接続によりEnOceanを使用した無線機器と受送信が可能なUSBドングルです。EnOceanで使用されているEnOcean Equipment Profile（EEP）の全メッセージフォーマットをサポートしており、Raspberry PiやPCからはUSB-Serialとして認識され、EnOceanの無線信号のテレグラムデータの送受信が可能になっています。

<div align="center">
<img src=http://f.cl.ly/items/3B0l0y1a2Y3m3i1K0P2N/[ccbdf935078a5ab1787a523d1b7c96cb]_EnOcean_USB400J.png width=50%>
</div>

### [温度センサーモジュール「STM-431J」](http://micro.rohm.com/jp/techweb_iot/knowledge/iot04/s-iot04/02-s-iot04/2768)
今回のデモ構築に使用したSTM-431Jというデバイスは、光発電（ソーラーパネル）の搭載により、屋内の微弱な光でも発電して蓄電キャパシタに電気を蓄え、電池レスで動作可能な温度センサ無線モジュールです。マイコンを内蔵していますのでコンフィグレーションの変更や独自のファームウェアの搭載が可能です。

<div align="center">
<img src=http://f.cl.ly/items/2w342m3b0H3o212x233w/enocean_sensor03.jpg width=50%>
</div>


### EnOcean プログラミングボード「EOD350」
STM-431Jや他のモジュールのコンフィグレーションの変更や独自のファームウェアの書き換えを行うためのプログラミングモードになります。今回のデモシステムではSTM-431Jのコンフィグレーションを変更するために使用します。EOD350ボードは、現在は単体での販売はされていないようで、[EnOcean開発キット：EDK 400J](http://micro.rohm.com/jp/techweb_iot/knowledge/iot04/s-iot04/02-s-iot04/3582)に含まれています。


<div align="center">
<img src=http://f.cl.ly/items/3O1c2Z1x1P0p1D1h0S2V/Image%202018-05-09%20at%2012.16.35%20PM.png width=50%>
</div>

---
## 4.SORACOM SIMのアカウント登録
このデモシステムで収集したデータをSORACOM Airを利用して、3G/LTEによりSORACOM Harvestにデータを蓄積させます。そのために、SORACOM AirのSIMを調達して、アカウント登録する必要があります。SORACOM Air for セルラー（SIM）は、[アマゾン](https://amzn.to/2jJY3I8)や[SORACOMコンソール](https://console.soracom.io/)から購入が可能です。今回はアマゾンから購入しました。


<div align="center">
<img src=http://f.cl.ly/items/0V0N362j3G0r3v042q1L/[ac3d541ed87aa90589a827d9362d8699]_SoracomAirSim01.png width=50%>
</div>

SORACOM AirのSIMを使用するためにSORACOMのアカウントの設定を行います。[SORACOMのサイト:https://console.soracom.io](https://console.soracom.io)にアクセスします。

<div align="center">
<img src=http://f.cl.ly/items/2k2s2E0s0H3Q0x3S1B0a/[c250a48e01065745f576bbd50848d719]_soracom_reg01.png width=80%>
</div>

「アカウント作成」をクリックするとSORACOMオペレータ登録画面が表示されます。ここで使用するSIMは日本国内用のSIMなので、「カバレッジタイプJapan」を選択します。

<div align="center">
<img src=http://f.cl.ly/items/3l1t3l0L2v1K2F3M3V2h/[2aba25f01faf6314d7d5a7aef82e17d1]_soracom_reg02.png width=80%>
</div>

<div align="center">
<img src= width=50%>
</div>


氏名、メールアドレス、パスワードなど必要な情報を入力し、SORACOM利用規約を確認の上「アカウントを作成」をクリックします。

<div align="center">
<img src=http://f.cl.ly/items/0C0s3J2R1s093s1j3O1e/[b5ad3ad682e838cee7bb7d997224f1f5]_soracom_reg03.png width=80%>
</div>


登録するSIMカードのIMSIコード（15桁）とパスコード（５桁）を入力します。名前はSIMカードにつける任意の名称です。ここでは「46Lab-SIM01」という名前で登録しました。「登録」をクリックするとSIMが登録されます。

<div align="center">
<img src=http://f.cl.ly/items/1m0a0y1o0t2a250K0S45/soracom_reg04.png width=50%>
</div>

SIMカードにIMSIコードとパスワードが記載されています。
<div align="center">
<img src=http://f.cl.ly/items/3t1442331u2v0b351r2c/[e12b3500fe7a407814e11c6cbfdce4ad]_SoracomAirSim02.png width=50%>
</div>


SIMの登録が完了するとSORACOM コンソール画面で確認ができます。

<div align="center">
<img src=http://f.cl.ly/items/0O3J2c0g1u0h2T18063j/[bca943804c0378e449f5de4c164bc9b2]_soracom_reg06.png width=80%>
</div>

以上でSORACOM Airのアカウント作成、およびSIMの登録は終了です。

---
## 5.Raspberry Pi3起動イメージ作成

### Raspbianイメージのダウンロード
今回構築する環境では、GUIなどは使用しませんので、GUI環境などが含まれていないRaspbian Stretch Liteを使用します。[Raspbianのサイト](https://www.raspberrypi.org/downloads/raspbian/)
からイメージファルをダウンロードします。


<div align="center">
<img src=http://f.cl.ly/items/3c2Q0g2b0e0T1q0H2I20/[9903bad2766d784dee062dbcf5a514d1]_Rasbpian.png width=80%>
</div>



_※注）　「Pi-field」には、メカトラックス社のSDカードが付属していますので、そのまま使用することも可能です。この付属SDカードには、Raspianに、 「3GPi」ユーティリティ、「slee-Pi」ユーティリティが追加されたイメージが書き込まれています。付属SDカードをそのまま使用する場合は、この記事の「5.Raspberry Pi3起動イメージ作成」、「７.slee-Piの設定」、「８.3GPiの設定」のステップは必要ありません。_

### イメージのSDカードへの書き込み
ダウンロードしたイメージファイルをmicroSDカードに書き込みます。Windows10、Linuxそれぞれの環境を使用したSDカードへのイメージ書き込み方法を説明します。

---
#### Windows10環境の場合：
etcher.ioを使用してイメージファイルをSDカードの書き込みます。[etcher.io](https://etcher.io/)のサイトにアクセスして書き込みソフトウエアをダウンロードします。ここでは「Etcher for Windows x64 (64-bit) (Portable)」を選択しててダウンロードします。

<div align="center">
<img src=http://f.cl.ly/items/1X0s0Y203a102f400J1K/etcher01.png width=80%>
</div>


Etcher-Potable-1.4.3-x64.exeを実行すると、次のようにEtcherが起動されます。

<div align="center">
<img src=http://f.cl.ly/items/2S2n1z0X1v271h2t3v3w/etcher02.png width=80%>
</div>

「Select image」をクリックして、先ほどダウンロードした2018-XX-XX-raspbian-stretch-lite.imgを選択します。USB経由のSDドライブにmicroSDカードを挿入すると、自動的に認識します。「Flash!」ボタンをクリックするとmicroSDへのイメージの書き込みが行われます。Etcher．ioは本当に簡単にイメージ書き込みができるツールです。

<div align="center">
<img src=http://f.cl.ly/items/1r1H2E3u2V2I2V0d2Y2Y/etcher03.png width=80%>
</div>
----
#### Linux環境の場合：
ダウンロードしたイメージファイルを次のように解凍します。

```sh:
$ unzip 2018-xx-xx-raspbian-stretch-lite.zip
```

LinuxホストPCにSDカードを挿入し、次のコマンドを実行します。`of=/dev/sde` の部分は、それぞれの環境により異なりますので注意してください。

```sh:
$ dd if=2018-03-13-raspbian-stretch-lite.img of=/dev/sde bs=1M
```

### シリアルコンソールのための設定
今回の環境では、Raspberry PiにHDMIモニターやUSBキーボードを使用しないため、USB-Serial(TTL）変換ケーブルを使用してシリアルコンソールを使用します。Raspberry Pi3の場合、シリアルコンソールを使用するためにコンフィグレーションの変更が必要です。Raspberry Pi3では、今まで使えていたUARTのピンをBluetoothが使用していますので、UARTのための変更が必要になります。イメージが書き込まれたmicroSDカードの設定ファイルを直接、Windows10やLinuxホストで変更します。

イメージが書き込まれたmicroSDカードを一度抜いて、再度、Windows10 PC（あるいはLinux PC)に挿入してマウントします。イメージが正常に書き込まれているmicroSDカードは、/bootパーティションがFATフォーマットになっていますので、Windows10、Linuxのどちらでも自動的に認識してマウントされるはずです。

マウントされたSDカードの`/boot/config.txt`というファイルをテキストエディタなどで変更します。この`config.txt`ファイルは、改行がLF（Unix系改行）になっていますので、Windows系の標準のエディタでは一行で表示されてしまい上手く編集ができませんのでご注意ください。[sakura editor](http://sakura-editor.sourceforge.net/)など改行をLFに変更できるようなエディタを使用してください。

/boot/config.txtの最後の行に以下の行を追加して、ファイルを保存してください。

```sh:/boot/config.txt
# 最後の行に追加します。
dtoverlay=pi3-miniuart-bt
```
microSDカードのアンマウントしてPCから取り出し、Raspberry Pi3に挿入します。

### Raspberry Pi3起動
Raspberry Pi3を起動する前に、USB-Serialケーブルと有線のネットワークケーブルを接続します。USB-Serialが接続されているPCには、USB-Serialケーブルのためのデバイスドライバのインストールが必要な場合もあります。USB-Serialケーブルの設定に従ってあらかじめドライバーなどをWindows10やLinuxPCにインストールしておいてください。PC側は、TeraTermやminicomといった通信ターミナルソフトウエアを使用して、ボーレート：115200で接続します。

<div align="center">
<img src=http://f.cl.ly/items/0M0n1f3Y3T273U0l3k3T/raspberrypi_boot.jpg width=80%>
</div>

---
## ６.Raspbianの設定
Raspberry Pi3でRaspbianが起動しましたので、追加ソフトのインストールや各種設定を行います。インターネットから追加のソフトウエアなどのダウンロードを行いますので、有線Ethernetを接続して、作業を行います。

### Raspbianのアップデート
まずは次のコマンドでRaspbianを最新の状態にアップデートします。

```sh:
$ sudo apt-get update 
$ sudo apt-get upgrade
```

### SSHの設定
シリアルコンソールで操作はできますが、sshによりログインできた方が作業はしやすいので、sshdを有効にします。この作業は任意です。
コンソールから次のコマンドを実行してsshを有効にします。

```sh:
$ sudo raspi-config
```

これで他のホストからssh でログインできるはずです。

他のホストからsshでログインする場合は次のようなコマンドで行います（Linuxの場合）。

```sh:
$ ssh -l pi <ipaddress>
```

#####　SSHの補足
“Read from socket failed: Connection reset by peer”などとでてsshでの接続ができない場合、次のような手順でsshが使えるようになります。
　　(1) raspi-config で SSH をオフ
　　(2) sudo rm /etc/ssh/ssh_host_* && sudo dpkg-reconfigure openssh-server
　　(3) sudo touch /boot/ssh
　　(4) raspi-config で SSH をオン
これでできるようになるはず。


### Timezone変更
次に、Raspberry Piのtimezoneの設定を行います。
コンソールから次のコマンドを実行してtimezoneを変更します。

```sh:
$ sudo raspi-config
```

raspi-configの以下のところにtimezoneの設定がありますので、「Asia ---- Tokyo」を選択します。
　　4.Localisation Options  ---- I2 Change Timezone
　　　　Asia ---- Tokyo


### 不必要なサービスの無効化
今回使用しているRaspbian Stretch Liteは、GUIなどが含まれてませんので、フルセットのRaspberianより起動されているサービスは少ないのですが、このデモシステムで明らかに使用しないいくつかのサービスを無効化します。

```sh:
$ sudo systemctl disable Bluetooth
$ sudo systemctl disable hciuart
$ sudo systemctl disable triggerhappy
$ sudo systemctl disable apt-daily.timer
```
---
## ７.「slee-Pi」の設定
次にslee-Piの設定を行います。slee-Piで使用するライブラリやユーティリティは、メカトラックス社のgithubで公開されています。次の手順で、slee-Pi関連のソフトウエアをRaspberry Piにインストールします。インストールは外部のサイトよりファイルをダウンロードしますので、Raspberry Piを有線のEthernetや無線LAN環境に接続しておく必要があります。ここでは有線のEthernetケーブルをRaspberry Piに接続してインストールを行っています。

メカトラックス社のレポジトリなどの情報を追加します。

```sh:
$ sudo bash -c 'echo "deb http://mechatrax.github.io/raspbian/ stretch main contrib non-free" > /etc/apt/sources.list.d/mechatrax.list'
$ wget http://mechatrax.github.io/raspbian/pool/main/m/mechatrax-archive-keyring/mechatrax-archive-keyring_2016.12.19.1_all.deb
$ sudo dpkg -i mechatrax-archive-keyring_2016.12.19.1_all.deb
```

次にslee-Piに関連するパッケージをインストールします。

```sh:
$ sudo apt-get update
$ sudo apt-get install sleepi2-firmware sleepi2-utils sleepi2-monitor
```

slee-Piに関連するパッケージのインストール時に、/boot/config.txtにDevice TreeのOverlayを有効にする記述が追加されます。このDevice Tree Overlayを有効にするために、slee-Piに関連するパッケージをインストール後に次のようなコマンドでRaspberry Pi3を再起動します。

```sh
$ sudo shutdown -r now
```

Raspberry Piが再起動されたら、再度ログインして、次のコマンドを実行してシステム時刻をリアルタイムクロックに反映します。

```sh:
$ sudo hwclock -w
```

sleep-Piの動作をテストしてみます。次のコマンドを使用して一定時間後に起動させます。

```sh:
$ sudo sleepi2alarm -set “+5min”
$ sudo poweroff
```

５分後にraspberry Piが起動されてばsleep-Piのセットアップは終了です。

---
## ８.「3GPi」の設定
3GPi向けのユーティリティと設定ファイルをインストールします。すでに、slee-Piのセットアップ時にメカトラックス社のレポジトリを追加してあるので、次のコマンドでインストールすることができます。

```sh:
$ sudo apt-get install 3gpi-utils
$ sudo apt-get install 3gpi-network-manager
```

次に、3GPIでSORACOM Airが使えるようにAPNを設定します。

```sh:
$ sudo nmcli con add type gsm ifname "*" con-name SORACOM apn soracom.io user sora password sora
```

SORACOM Air SIMを3GPiに挿入して、再起動すると自動的にSORACOMに接続されます。SORACOMコンソールにログインすると登録されているSIMがオンライン表示になることが確認できます。

<div align="center">
<img src=http://f.cl.ly/items/0n0R1p0W310C16212a0y/[3f5cf50653dea4d2ade6b2f3fa887bee]_soracom_online01.png width=80%>
</div>

---
## ９.EnOcean USB400Jの設定
EnOceanの受送信モジュールであるUSB400Jは、Raspberry Piに接続するとUSB-Serialとして認識され、デバイスファイルとして`/dev/ttyUSBXXX`といった名称が割り当てられます。このシステムでは「3GPi」などもUSB-Serialを使用していますので、デバイス名を固定化しておく必要があります。

udevによるデバイスファイル名の固定化は、`/etc/udeb/rules.d/xxxxxx.rules`で行います。まず、今回使用するUSB400JのベンダーIDとプロダクトIDを調べます。

USB400Jを挿入していない状態で、Raspberry Piのコンソールで`lsusb`を実行します。

```sh:
$ lsusb
Bus 001 Device 004: ID 05c6:9000 Qualcomm, Inc. SIMCom SIM5218 modem
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp. SMSC9512/9514 Fast Ethernet Adapter
Bus 001 Device 002: ID 0424:9514 Standard Microsystems Corp. SMC9514 Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
```

次にUSB400Jを挿入して、`lsusb`を実行します。

```sh:
$ lsusb
Bus 001 Device 004: ID 05c6:9000 Qualcomm, Inc. SIMCom SIM5218 modem
Bus 001 Device 006: ID 0403:6001 Future Technology Devices International, Ltd FT232 USB-Serial (UART) IC
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp. SMSC9512/9514 Fast Ethernet Adapter
Bus 001 Device 002: ID 0424:9514 Standard Microsystems Corp. SMC9514 Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
```

USB400Jの挿入前後で変わった
`Bus 001 Device 006: ID 0403:6001 Future Technology Devices International, Ltd FT232 USB-Serial (UART) IC`
がUSB400Jの情報になります。

`ID 0403:6001`の内、ベンダーIDが`0403`、プロダクトIDが`6001`になります。この情報を元に、`/etc/udev/rules.d/99-local.rules`に下記の設定を追加します。デフォルトでは`/etc/udev/rules.d/99-local.rules`というファイルはありませんので、viエディタなどで新規に次のように作成します。

```sh:
$ sudo vi /etc/udev/rules.d/99-local.rules`
```

<br>

```sh:/etc/udev/rules.d/99-local.rules
# For EnOcean USB400J
KERNEL=="ttyUSB*",  ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", SYMLINK+="ttyUSB400J"
```

ここでのシンボリックリンク名:ttyUSB400Jは任意の名前です。

USB400Jを外して、挿入し直します。`/dev/ttyUSB400J`が認識した`/dev/ttyUSBXX`にシンボリックリンクしていることが確認できます。

```sh:
$ ls -al /dev/ttyUSB400J
lrwxrwxrwx 1 root root 7 Apr 20 10:16 /dev/ttyUSB400J -> ttyUSB4
```

---
## １０.EnOcean STM-431Jの設定
EnOceanの温度センサーモジュール：STM-431Jのコンフィグレーションを変更します。STM-431Jのデフォルトの設定では、蓄積されている電力量などによりランダムに温度データを送信しているようです。これだと一定時間後のデータ測定が困難なので、一定時間ごとに温度データを送信するようにコンフィグレーションの変更を行います。コンフィグレーションの変更には、EnOceanプログラムボード：EOP350とEnOcean開発者向けのツールが必要になります。

[EnOceanのサイト:https://www.enocean.com/jp/download/](https://www.enocean.com/jp/download/)から次の２つのツールをダウンロードしてインストールします。サポートしているホスト環境はWindowsだけです。

- EnOcean Dolphin V4 Suite
- EnOcean DoplhinView Basic 

EnOceanプログラムボードEOP350にSTM-431J(温度センサーモジュール）を取り付け、USBケーブルでWindows環境に接続します。

<div align="center">
<img src=http://f.cl.ly/items/3I0R2T1C2D3H1j0i452L/enocean_eco200_01.jpg width=50%>
</div>

Dolphin V4 Suiteに含まれているDolphine V4 Module Configuratorを起動します。EOP350が接続されているポートとコンフィグレーションを行うSTM-431Jを選択します。

<div align="center">
<img src=http://f.cl.ly/items/231J3A143j192X1p023H/[bc358a80b86481fc4dcb5de8e03c3c17]_DoplinConfig01.png width=80%>
</div>

Dolphin V4 Module Configuratorの上段にある「Read configuration from flash」をクリックして、現在のSTM-431Jに書き込まれているパラメータを読み込みます。

変更するパラメータは次の３箇所になります。

- Cyclec wake-up
- Redundant retransmission(cyclic wake-up): Min
- Redundant retransmission(cyclic wake-up): Max

「Cyclec wake-up」はSTM-431Jがウェイクアップされる周期を秒数で指定します。デフォルト値は65535となっておりハードウェアの設定となっています。これを60秒に指定します。
「Redundant retransmission(cyclic wake-up) Min/Max」は、Wake-up何回に１度データを送信するかを設定するパラメータになります。MinとMaxで指定した間のランダム回数ごとに送信するといった設定を行います。これをMax/Min共に「１」と設定することで、Wake-up毎に毎回データを送信するようにします。

<div align="center">
<img src=http://f.cl.ly/items/1T0N1Z3b2a1t103N3j1E/[8ba9944df7362d518884ce9188f0f0e1]_DolphinConfig02.png width=80%>
</div>

STM-431Jは、小さな蓄電キャパシタ（電池）を内蔵していますので、昼間にソーラーパネルで発電した電力を蓄えることができ、光発電ができない夜間も動作することが可能です。しかし、この蓄電キャパシタは非常に小さな電力しか蓄えられませんので、どれぐらいの周期でWake-upさせて、どれぐらいの頻度でデータ送信するかが重要になります。STM-431Jのマニュアル（[ここからダウンロードできます](http://www.rohm.co.jp/web/japan/enocean?_ga=2.61245228.1262401628.1525829795-1228372362.1525829795#gateway)）にWake-up周期とデータ送信の頻度の関係についてのデータが提供されています。

<div align="center">
<img src=http://f.cl.ly/items/10150f2a0p2a1o3d3M0H/Image%202018-05-10%20at%201.45.34%20AM.png width=80%>
</div>

「STM 431J User Manual | v2.0 | Nov 2017」 www.enocean.comより抜粋

60秒毎にWake-upし、毎回データ送信をする設定にしたSTM-431Jを室内に置いた状態で実際に試したところ、24時間稼働できていることを確認できました。

EnOcean STM-431Jが実際にどのようなデータを送信しているかについては、DolphinView Basicツールを使って確認することができます。USB400JをWindowsホストに挿入し、DolphineView Basicツールを起動します。USB400Jが挿入されているポートを指定すると、EnOceanのデータをモニタリングすることができます。

<div align="center">
<img src=http://f.cl.ly/items/081F251W2T3i0N3M2J05/DolphineViewBasic01.png width=80%>
</div>

---
## １１.SORACOM Harvest設定

SORACOM Harvestは、SORACOMプラットフォームが提供するデータ収集・蓄積サービスです。SORACOM Harvestを利用することで別途サーバーやストレージを準備することなくデータの収集と保存、データの可視化を行うことができます

SORACOM Harvestを使用するには、SORACOMコンソールから設定します。SORACOM Harvestの設定は、SIMのグループ毎に行います。SIMに対してグループを設定し、そのグループに対してSORACOM Harvestを有効化します。


指定するSIMを選択して、「操作」→「所属グループ変更」　を選択します。

<div align="center">
<img src=http://f.cl.ly/items/1g0d3i3K0U390w2z1e1l/[d2ebb60dab0a3f51c1ea8ed6658c2201]_soracom_harvest01.png width=80%>
</div>

「新しい所属グループ」をクリックして、「新しいグループを作成….」を選択します。

<div align="center">
<img src=http://f.cl.ly/items/1e0b3Z2H3o131N2U3N0Z/[91fea9e4836422f9898119eddb1feb1d]_soracom_harvest02.png width=50%>
</div>

グループ名入力のウィンドウが表示されますので、任意のグループ名を入力して「グループ作成」をクリックします。ここではHarvest01というグループ名を作りました。

SIMの一覧から今作成した「Harvest01」というグループ名をクリックするとグループ毎の設定が表示されます。この中の「SORACOM Harvest設定」をクリックします。SORACOM Harvest のスイッチを「ON」にして「保存」をクリックします。以上でSORACOM Harvestの有効化は終了です。

SORACOM Harvestにデータを送信するにはHTTPあるいはTCP/UDPによって行います。HTTPでデータを送信する場合は、Raspberry Piのコンソールから次のようなコマンドで行うことができます。実際にSORACOM Harvestにデータ送信する場合、有線のEthernet接続や、WiFi接続などは切ってください。SORACOM Harvestは、登録されているSORACOM Air SIM経由のデータしか受け付けません。有線のEthernet接続を行なっている場合、Defalt Gatewayの設定によっては、Ethernet経由で送信してしまいますので、データを受け取ってくれません。

```sh:
$ curl -v -X POST -H 'content-type:application/json' -d '{"temperature01":25}' http://harvest.soracom.io
$ curl -v -X POST -H 'content-type:application/json' -d '{"temperature01":21,"temperature02":18}' http://harvest.soracom.io
```


---
## １２. SORACOM Harvestへの送信プログム
いよいよ実際にEnOceanの温度センサーから受け取ったデータをSORACOM Harvestへ送信するプログラムを作成します。プログラムはpythonで作りました。このプログラムに依存するpythont追加パッケージをインストールします。Raspberry Piのコンソールから次のコマンドでインストールを行います。

```sh:
$ sudo apt-get install python-serial
$ sudo apt-get install python-requests
```

_※注）`$ sudo pip install serial` これだとpython で`/dev/ttyUSBXXX`がオープンできなかった。原因はまだ調べていません。_


実際のプログラムは次のようになっています。このプログラム作成にあたり「[PythonでEnOceanの電文を読み取る](http://hanzomemo.blogspot.jp/2015/12/pythonenocean.html)」を参考にさせていただきました。


```python:
import requests
import json
import serial
from sys import exit
from datetime import datetime

PORT = '/dev/ttyUSB400J'              # USB400Jが接続されているデバイス名
URL = 'http://harvest.soracom.io/'    # SORACOM HarvestのURL
SENSORID1 = '04:01:53:e1'             # １つ目のSTM-431JのID
SENSORID2 = '04:00:6f:e5'             # ２つ目のSTM-431JのID

# この関数でSORACOM HarvestにHTTPによりデータを送信しています。
def sendData(strings, temp_data):
		headers = {'content-type': 'application/json'}
		payload = {strings:temp_data}
		print payload
		req = requests.post(URL, data=json.dumps(payload), headers=headers)

# この関数はシリアルポートから１バイトづつデータを読み込み、EnOceanのテレグラムを解析しています。
# テレグラムを解析後、デバイスIDが一致した場合だけSORACOM Harvestにデータを送っています。
def EnoceanSensor(s_port):
	sensor1_rdy = False
	sensor2_rdy = False
	cnt = 0
	dataLen = 0
	optLen = 0
	telegraph,headList,dataList,optList = [],[],[],[]
	ready = True

	while True:
		if sensor1_rdy and sensor2_rdy:
			break

                # 1byteつづシリアルポートからデータを読み込みます。
		s_data = s_port.read().encode('hex') # read 1byte

                 # Sync-Byteの0x55をからテレグラムデータの開始を認識します。
		if s_data == '55' and ready: # Telegram start
			# valuable reset
			cnt = 0
			dataLen = 0
			optLen = 0
			ready = False
			telegraph,headList,dataList,optList = [],[],[],[]

		cnt += 1
		telegraph.append(s_data)

                # テレグラムデータを解析しています。
		if 2 <= cnt <= 5: # header
			headList.append(s_data)
		if cnt == 5: # header end, get data length
			dataLen = int(headList[1],16)
			optLen  = int(headList[2],16)
		if 7 <= cnt <= (6+dataLen): # data
			dataList.append(s_data)
		if (7+dataLen) <= cnt <= (6+dataLen+optLen): # optional data
			optList.append(s_data)
		if cnt == (6+dataLen+optLen+1): # Telegram end
			ready = True
			sensorId = ':'.join(dataList[1:5]) # Sensor ID
			timestamp = datetime.now().strftime('%Y-%m-%d %H:%M:%S')

			# デバッグ用にデータを表示させています。
			print "========"
			print timestamp
			print 'telegraph...:', ':'.join(telegraph)
			print 'head...', ':'.join(headList)
			print 'data...', ':'.join(dataList), '(length=%d)' % dataLen
			print 'opt ...', ':'.join(optList),  '(length=%d)' % optLen
			print 'sensorID...', sensorId


			# Temp sensor1 センサーIDが一致したらデータ送信します。
			if sensorId == SENSORID1 and sensor1_rdy == False:
				val = int(dataList[7],16)
				sensor1_temp = round((255.0-val)/255.0*40.0, 2)
				sendData('temperature01', sensor1_temp)
				sensor1_rdy = True

			# Temp sensor2　　センサーIDが一致したらデータ送信します。
			elif sensorId == SENSORID2 and sensor2_rdy == False:
				val = int(dataList[7],16)
				sensor2_temp = round((255.0-val)/255.0*40.0, 2)
				sendData('temperature02', sensor2_temp)
				sensor2_rdy = True

			# Other sensors, ignore ID
			else:
				continue

# main関数です。シリアルポートを開いて上記のEnoceanSensor関数を実行しているだけです。
if __name__ == '__main__':
		# Open serial port
		try:
				s_port = serial.Serial(PORT, 57600)
				print('open serial port: %s' % PORT)
		except:
				print('cannot open serial port: %s' % PORT)
				exit(1)

		EnoceanSensor(s_port)

print "Done!"
```


STM-431J温度センサーモジュールを２個使用しています。プログラムの中でそれぞれのIDを定義していますが、これらのIDはEnOceanデバイス毎にあらかじめ設定されているIDになります。

```python:
SENSORID1 = '04:01:53:e1'
SENSORID2 = '04:00:6f:e5'
```

この関数で、温度データと文字列をJSON形式に変更し、HTTPプロトコルでSORACOM Harvestに送信しています。

```python:
import requests
import json

#......一部省略.....
def sendData(strings, temp_data):
		headers = {'content-type': 'application/json'}
		payload = {strings:temp_data}
		print payload
		req = requests.post(URL, data=json.dumps(payload), headers=headers)
```


---
## １３.自動実行、定周期起動
このシステムは「slee-Pi」を搭載していますので、この機能を利用してRaspberry Piを間欠動作させます。作成したPythonのプログラムの自動実行とslee-Piとcronサービスを使用した間欠動作の設定を行います。

### プログラムの自動起動
Linux（Raspbian）が起動した時に自動的にプログラムを実行する方法は色々ありますが、ここではsystemdによるサービス起動方法を利用して、作成したプログラムを起動毎に実行させます。次のようなファイルを新規に作成します。

```sh:/etc/systemd/system/enocean.service
#  File:/etc/systemd/system/enocean.service
[Unit]
Description=EnOceanTempuratureSensor
After=syslog.target

[Service]
Type=simple
WorkingDirectory=/home/pi
ExecStart=/usr/bin/python /home/pi/enocean-soracom.py 
TimeoutStopSec=5
#StandardOutput=null
StandardOutput=/home/pi/enocean.log

[Install]
WantedBy = multi-user.target
```

次のコマンドで設定したサービスを起動することができます。

```sh:
$ sudo systemctl start enocean
```

動作確認ができたので、自動起動するように設定します。

```sh:
$ sudo systemctl enable enocean
```

自動起動をやめるときは次のコマンドで設定します。

```sh:
$ sudo systemctl disable enocean
```

自動起動については「[Raspberry Piでプログラムを自動起動する5種類の方法を比較・解説](http://hendigi.karaage.xyz/2016/11/auto-boot/)』を参考にさせていただきました。

### 定周期起動
一定周期でのRaspberry Piの起動（間欠動作）は、slee-Piの機能とcronサービスを利用します。一定周期毎にcronによりRaspberry Piをシャットダウンさせます。シャットダウンさせる寸前にslee-Piにアラームを設定し、再起動させます。

Raspberry Piでcronを使用する場合、パッケージの追加が必要です。cronではエラー処理でメール送信を行うためpostfixをあらかじめインストールする必要があります。

```sh:
$ sudo apt-get install postfix
```

インストール時にConfigrationメニューが出ますが、ここでは実際にメール送信は行わないのでLocal onlyを選択します。

次に、cronが実行するシェルスクリプトを作成します。このシェルスクリプトでは、slee-Piに10分後のアラーム（再起動をセット）の設定を行い、シャットダウンさせるだけになります。このシェルスクリプト はrootユーザで実行させます。次のようなコマンドでシェルスクリプト を作成します。

```sh:
$ sudo su
$ cd
$ vi sleepi2pon.sh
```

```sh:/root/sleepi2poff.sh
# !/bin/sh
/usr/sbin/sleepi2alarm –set “+10m”
/sbin/poweroff
```

次にcronの設定を行います。cronで毎時05、20、35、50に作成したシャットダウンスクリプトを実行させます。slee-Piで10分後に再起動させるので、およそ毎時0、15、30、45分に再起動されます。

次のコマンドでcronの設定を行います。

```sh:
$ sudo crontab -u root -e
```

次のように起動させる時間と起動するプログラムを設定します。

```sh:
# m h  dom mon dow   command
05,20,35,50 * * * * /bin/sh /root/sleepi2poff.sh
```

これで毎時、5分、20分、35分、50分にsleepi2poff.shスクリプトが実行されます。

---
## １４.稼働
これで電源レス温度測定システムが構築できましたので、実際に運用してみます。「Pi-field」はソーラ発電を行う必要がありますので、自宅マンションの庭に設置しました（家族には邪魔扱いされましたが....）。

<div align="center">
<img src=http://f.cl.ly/items/0F1T3G2F2p3y1x1X1S3T/pifield_outside01.png width=70%>
</div>

温度センサーモジュール:STM-431Jが２個ありますしたので、屋外のマンションの壁と室内にそれぞれ両目テープで貼り付けました。

<div align="center">
<img src=http://f.cl.ly/items/1r38203T3Z1W28341a0G/enocean_sensor02.jpg width=50%>
<img src=http://f.cl.ly/items/0v0Y1k0a351y1f2y3O3N/enocean_sensor01.jpg width=50%>
</div>

設置後、「Pi-field」の電源を投入し１週間ほど運用させました。収集されたEnOceanの温度センサーデータは、SORACOMコンソールから確認することができます。
SORACOM コンソールでSIMを選択します。「操作」－＞「データを確認」を選択します。

<div align="center">
<img src=http://f.cl.ly/items/0r3k1K3Y1y3m1o420Y0P/[917c5cf09161a5c383de5f6e29ac895c]_soracom_harvest_result01.png width=80%>
</div>

SORACOM Harvestで収集したデータをグラフ化して表示することができます。


<div align="center">
<img src=http://f.cl.ly/items/3m021M053j1G3W463k1E/[937be0883410662fe68b56647578b128]_soracom_harvest_result02.png width=100%>
</div>

今回は温度センサーを２箇所に設置したデータとなっています。赤色のグラフ（temperature01）が屋外に設置したセンサーデータ、青色のグラフ（temperature02）が屋内に設置したセンサーデータになります。設置した自宅はマンションですので、屋内の温度変化が少ないことがわかります。屋外のデータで30℃を超えている時間帯がありますね。実際の気温はそこまで上がってはいなかったので、直射日光がセンサーに当たってしまったのかもしれません。

---
## １５.終わりに
盛りだくさんの内容となってしまいましたが、「Raspberry Pi」＋「Pi-fiels(ラズパイ屋外稼働キット)」＋「SORACOM Air」＋「EnOcean」を組み合わせたシステムの構築の雰囲気がわかってもらえたかと思います。エネルギーハーベストは、これから色々と応用がききそうな分野です。新しいアイデアが生まれてきそうです。

---
## 参考記事

- [ラズパイを10分間隔で起動して3G経由でツイートさせてみた - Qiita](https://qiita.com/MechaTrax/items/54a3985319e8a36006e2)
- [ラズパイ+ 3GPIシールドで遠隔地からECHONET Liteエアコンを操作する - Qiita](https://qiita.com/sgrowd/items/c302a09518ff4884adb5)
- [SORACOM Airと太陽光パネルで完全スタンドアローンな計測システム（前編） - Qiita](https://qiita.com/MechaTrax/items/7624cde463f4f66ae5d6)
- [SORACOM Airと太陽光パネルで完全スタンドアローンな計測システム（後編） - Qiita](https://qiita.com/MechaTrax/items/afe21f2373a8389d9333)
- [3GPIを 用いたAzure IoT Hub への環境データの送信 - Qiita](https://qiita.com/TomoSoft/items/29b3cf8e5bb873623a9b)
- [slee-Piを使った間欠動作（タイマー動作）と死活監視 - Qiita](https://qiita.com/syasuda/items/dd1564896e75b03b2b7d)
- [メカトラックス社 3GPi 3G通信モジュール - github](https://github.com/mechatrax/3gpi)
- [メカトラックス社 slee-Pi 電源管理/死活監視モジュール - github](https://github.com/mechatrax/slee-pi2)
- [SORACOM Harvest でデバイスのデータをクラウドで収集・取得・可視化する - SORACOM](https://dev.soracom.io/jp/start/harvest/)
- [SORACOMアカウントの作成 - SORACOM](https://dev.soracom.io/jp/start/console/#account)