Wio Extension - RTC を MicroPython から使う


この記事はSORACOM Advent Calendar 2019の15日目の記事です。SORACOM Meetup #0 in 札幌のLTでの Wio Extension - RTC ネタを元に、最新版の MicroPython API ベースに解説します。

Wio Extention - RTC について

WioLTEには1つ大きな欠点があって、LTEモデムが電気を食いすぎるため、バッテリーからの電源供給では長期間の測定が行えないことです。

これを回避するため、2019年6月に SORACOM からWio Extension – RTC セット
(以下、WioRTC と略記)が購入できるようになりましたので、さっそく入手して使ってみました。ざっくり言うと電源を自動で ON/OFF してくれるタイマーなようなもので、これで測定していない時間帯には電源を OFF にしておくことによりバッテリーを長持ちさせようとするものです。

@ciniml さんが WioTTE に MicroPython を移植してくれてからというもの、WioLTE では MicroPython ばかり使っているので、WioRTC も MicroPython から利用したいと思いました。ということで、Aruduino用の公式サンプルスケッチなどを参考に MicroPython 用スクリプトを作成してみました。

MicroPython での WioRTC の使い方

MicroPython スクリプトは以下の github に置きました。セットアップ方法は README.md を参照してください。

https://github.com/MinoruInachi/wiortc-mpy-sample

WioLTE と WioRTC は I2C でやりとりするため、違いの I2C ポートをつなぎます。WioRTCにはI2Cポートが2つありますが、どちらにつないでもかまいません。もう1つのほうは、WioLTE で塞がってしまった I2C ポートの代わりに使えます。

WioRTC で実際にタイマー制御を行っているのは NXP PCF8523というチップになります。ドキュメントをながめるといろいろな機能があるのですが、今回扱うのはカウントダウンタイマーだけにしておきます。

以下、簡単に作成した MicroPython API の使い方を説明します。

WioRTC の初期化

まず、WioRTC インスタンスを作成して始動させます。

from wiortc import WioRTC  # WioRTCクラスをインポート
from machine import I2C  # I2Cクラスをインポート

i2c = I2C('I2C')  # I2Cポートのインスタンスを作成
rtc = WioRTC(i2c)  # I2Cポートを指定して WioRTC インスタンスを作成
rtc.begin()  # WioRTC の始動

カウントダウン時間の設定

カウントダウン時間は以下のように秒数で与えます。

rtc.set_wakeup_period(300)  # カウントダウン時間として300秒(5分)を指定

内部的にカウントダウン時間は8ビット符号なし整数(0-255)で与えます。これでは例にありような300秒を指定することはできません。そのため、タイマーにはカウントを1秒単位、1分単位、1時間単位にするモードが用意されています。set_wakeup_period() メソッド内では指定した秒数によって自動的にこの3つのモードが切り替わるようにしています。

電源断

カウントダウン時間の設定が終わったら電源を切ります。

rtc.shutdown()  ## WioRTCからの電源供給を止める

カウントダウン時間が経過すると、WioRTC が電源供給を再会し、WioLTE のスクリプトが再実行されます。

API利用法のまとめ

WioRTC の API の利用法をまとめると、以下のようなイメージになります。

# wiortc インポート
from wiortc import WioRTC
from machine import I2C

# WioRTC オブジェクト作成・始動
i2c = I2C('I2C')
rtc = WioRTC(i2c)
rtc.begin()

# この間に何らかの WioLTE の処理

# 何秒後に電源を入れるか設定して電源断
rtc.set_wakeup_period(30)
rtc.shutdown()

EEPROM について

WioRTC には PCF8523 の機能と関係なく、4KBのEEPROM(不揮発性メモリ)が載っています。これがある理由は、おそらく電源遮断中も残しておきたい情報を保存しておくためと思われますが、当然ながら書き込み回数には制限があるはずなので、頻繁に利用するわけにもいかないでしょう。

いちおうこの EEPROM を読み書きする API も用意しています。

EEPROM から値を読み込むには以下のようにします。

val = bytearray(1)  # 長さ1のバイト配列を作成
rtc.eeprom_read(0, val)  # EEPROMのアドレス0の値をvalに格納

逆にEEPROM に値を書き込むには以下のようにします。

rtc.eeprom_write(0, val)  # EEPROMのアドレス0にバイト配列val内容を書き込む

おわりに

WioRTC を利用するようになってから、数週間レベルの測定は手持ちのモバイルバッテリー(2A供給可能、5000mAh)で出来るようになりました。これで、いつでもどこでもセンサーで測定して SORACOM Harvest にあげるといったことが可能になりました。さらには MicroPython からも利用できるようにすることで、プロトタイピングが実に簡単に出来るようになりました。

この環境を使って心拍数を測定して SORACOM Hervest にデータをあげる例についてはSORACOM のAdvent Calendar 2019 ふたつめの方のほうに書きました。