トワイライト（TWELITE）のEEPROMを使い方

こんにちは、ENGかぴです。

ZigBeeモジュールであるトワイライト（TWELITE）はEEPROMを搭載しているため電源が切れてもデータを保持できます。クラスオブジェクトであるEEPROMを使用することで簡単にEEPEOMの書き込みと読み込みができます。

EEPROMに関するAPIを使用してEEPROMへの書き込みを行いリセット後にEEPROMから読み出した値を確認してEEPROMの動作確認を行いました。

トワイライトを太陽光パネルで動作させたことやMWSTAGEの環境でソフト開発して無線通信したことなどについてまとめています。

トワイライト（TWELITE）のソフト開発と無線通信でできること

EEPROMを使用する
動作確認
1. 動作確認用の回路
2. 動作結果
ソースコード全体
関連リンク

EEPROMを使用する

TWELITEの内蔵EEPROMに対して読み書きを行うライブラリについては下記リンクに詳細が説明されています。

モノワイヤレス社HPーMWX Library EEPROM

内蔵EEPROMは256バイトごとにブロックが分かれているため0x000～0xEFFまでの3840バイトが使用可能となります。メーカのHPによると先頭から256バイトまではインタラクティブモードで使用される可能性があるため0x00～0x100までは使用しない方が良いでしょう。

使用する関数

#define EEP_ADRS_START 0x300
#define EEP_ADRS_START_CHK 0x380 //チェック用のアドレス

//EEPROM.write(EEP_ADRS_START, btncnt[0]);
EEPROM.update(EEP_ADRS_START, btncnt[0]); //btncnt[0]の値を書き込む
EEPROM.update(EEP_ADRS_START_CHK, btncnt[0]);

mst = EEPROM.read(EEP_ADRS_START); //EEPROMの値を読み込み

EEPROMに書き込む際に使用する関数はwrite()とupdate()ですがudtateを使用することで同じ値であれば書き込みをしないためEEPROMの不要な書き込みを防ぐことができます。

EEPROMは書き込み回数に限りがあるため基本的にはupdateを使用した方が良いでしょう。

EEPROMに保存した値の読み込みは対象のアドレスを指定してread()関数をコールします。読み込んだEEPROMの値が戻り値として返されるため変数に格納します。

PR：わからないを放置せず、あなたにあったスキルを身に着けるコツを教えるテックジム　「書けるが先で、理解が後」を体験しよう！

ヘルパーオブジェクトを使用する

EEPROMの読み書きが簡単に実装できるようにstream_helperオブジェクトが実装されています。

auto&& strm = EEPROM.get_stream_helper();
strm.seek(EEP_ADRS_START);
strm >> btncnt[0]; //EEPROMの読み込み

strm.seek(EEP_ADRS_START);
strm << btncnt[0]; //EEPROMへの書き込み

ヘルパーオブジェクトはサイズの違う整数型やformatで変換した値の読み書きが簡単にできます。１バイトずつ書き込む場合はupdate()関数を使用し、１バイト以上の値を書き込む場合はヘルパーオブジェクトを使用するなど用途に応じて使い分けることができます。

EEPROMデータの読み出しとチェック

void InitEepSetting(void){
    uint8_t i;
    uint8_t mst[sizeof(inittbl)];
    uint8_t chk[sizeof(inittbl)];
    bool boo = true;

    for( i =0; i < sizeof(inittbl);i++){
        mst[i] = EEPROM.read(EEP_ADRS_START + i);
        chk[i] = EEPROM.read(EEP_ADRS_START_CHK + i);

        if(mst[i] != chk[i]){ //値が一致するか
            btncnt[i] = inittbl[i]; //初期化テーブルの値を使用
            boo = false;
        }
        else{
            btncnt[i] = mst[i]; //EEPROMの値を使用
        }
    }
}

上の例ではbtncntにEEPROMの値もしくは初期化テーブルの値を展開して使用する例を示しています。EEPROMの値は初期化時に展開して使用します。

EEP_ADRS_STARTとEEP_ADRS_START_CHKのアドレスに書き込んだEEPROMデータを読み込み、値が一致するかの確認を行います。

読み込んだ値が一致する場合はEEPROMが健全であると判断してEEPROMから読み出した値を採用します。一致しなかった場合はEEPROMの値を使用せずに初期化テーブルの値を使用します。