BMx280 - 環境センサー

I2Cバスを利用した気圧・温度・湿度（BME280のみ）センサーです。
本センサーはTWELITE PALシリーズでは使用されていません。利用例は以下を参照ください。
https://github.com/monowireless/ActEx_Sns_BME280_SHT30​
​
処理の流れ
1.Wire.begin(): バスの初期化
2..setup(): センサーの初期化
3..begin(): センサーの動作開始
4.時間待ち数ms
5..available()がtrueになる
6..get_press(), .get_temp(), .get_humid(): 値の読み出し
​
動作に必要な手続き
Wireバス
setup()メソッド呼び出し前にWire.begin()によりWireが動作状態にしておきます。
​
スリープ復帰時の手続き
スリープ直前もWireバスが動作状態にしておきます（スリープ復帰後自動でWireを回復します）。
​
コード例
1
#include <TWELITE>
2
#include <SNS_BME280>
3
​
4
SNS_BME280 sns_bme280; // オブジェクトの宣言
Copied!
#include <SNS_SHT3X>とSNS_SHT3Xクラスオブジェクトの宣言が必要です。
​
初期化
1
void setup() {
2
    Wire.begin();
3
    sns_bme280.setup();
4
}
Copied!
​
センサー値の取得開始
1
void loop() {
2
​
3
  if(eState == E_STATE::INIT) {
4
    sns_bme280.begin();
5
    eState = E_STATE::CAPTURE;
6
  }
7
​
8
}
Copied!
センサー値の取得開始には.begin()を呼び出します。完了まで数msかかります。
※ 上記 loop()内は状態変数eStateにより処理が分岐する設計とします。（参考）
​
センサー値の取得待ち
1
void loop() {
2
​
3
  if(eState == E_STATE::CAPTURE) {
4
    if (sns_bme280.available()) {
5
      // センサー値読み出し可能
6
    }
7
  }
8
​
9
}
Copied!
センサー値が準備できたかどうかは.available()により判定できます。
​
センサー値の読み出し
1
void loop() {
2
​
3
  if(eState == E_STATE::CAPTURE) {
4
    if (sns_bme280.available()) {
5
      Serial << crlf << "BMx280:"
6
            << " P=" << int(sns_bme280.get_press()) << "hP";
7
            << " T=" << sns_bme280.get_temp() << 'C'
8
						<< " H=" << sns_bme280.get_humid() << '%';
9
    }
10
  }
11
​
12
}
Copied!
センサー値が準備出来次第、値を読み出すことが出来ます。
​
.get_temp(), get_humid()は浮動小数点演算が含まれます。100倍整数値を取得することもできます。
1
auto temp = div100(sns_bme280.get_temp_cent());
2
auto humd = div100(sns_bme280.get_humid_per_dmil);
3
​
4
Serial << crlf << "BMx280:"
5
  << " P=" << int(sns_bme280.get_press()) << "hP";
6
  << format(" T=%c%d.%02d", temp.neg ? '-' : ' ', temp.quo, temp.rem)
7
  << format(" T=%c%d.%02d", humd.neg ? '-' : ' ', humd.quo, humd.rem);
Copied!
ここではdiv100()を用いて100倍値を整数部と小数部に分解しています。
​
メソッド
get_press()
1
int16_t get_press()
Copied!
気圧を読み出します。単位はヘクトパスカル(hectopascal )で、通常は1000前後の値を示します。
​
get_temp(), get_temp_cent()
1
double get_temp()
2
int16_t get_temp_cent()
Copied!
温度を読み出す。get_temp()は℃で、get_temp_cent()は℃の100倍の値を整数値で返します。
エラー時は-32760～-32768の値が返ります。
​
get_humid(), get_humid_per_dmil()
1
double get_humid()
2
int16_t get_humid_per_dmil()
Copied!
湿度を読み出す。get_humid()は%で、get_humid_per_dmil()は%の100倍の値を整数値で返します。
エラー時は-32760～-32768の値が返ります。
​
共通メソッド
setup()
1
void setup(uint32_t arg1 = 0UL) 
Copied!
センサー用のメモリ領域の確保や初期化を行います。
arg1のLSBから8bitには、I2Cアドレスを格納することが出来ます。指定しない場合は0としておきます。
1
#include <SNS_BME280>
2
SNS_BME280 sns_bme280;
3
bool b_found_bme280 = false;
4
​
5
void setup() {
6
  ...
7
  sns_bme280.setup();
8
	if (!sns_bme280.probe()) {
9
			delayMicroseconds(100); // device needs small time for further I2C comm.
10
			sns_bme280.setup(0x77); // alternative ID
11
			if (sns_bme280.probe()) b_found_bme280 = true;
12
	} else {
13
			b_found_bme280 = true;
14
	}
15
	...
Copied!
上記のコードではまずデフォルトのI2C IDでデバイスが応答するかを試し、応答が無ければ 0x77で試みます。
​
begin(), end()
1
void begin()
2
void end()
Copied!
センサーの取得を開始します。センサーの値を読み出すまで数ms必要でavailable()がtrueになるまで待つ必要があります。
end()には対応しません。
​
process_ev()
1
void process_ev(uint32_t arg1, uint32_t arg2 = 0)
Copied!
待ち時間処理のセンサーの場合はarg1にE_EVENT_TICK_TIMERまたはE_EVENT_START_UPを与え時間の経過を知らせます。このメソッド呼出し後に、必要な時間が経過していればavailable()がtrueになり、センサー値の読み出しが可能になります。
​
available()
1
bool available()
Copied!
センサーが読み出し条件を満足したときにtrueを返します。
​
probe()
1
bool probe()
Copied!
センサーが接続されているときにtrueを返します。
​
sns_stat()
1
uint32_t sns_stat()
Copied!
センサーデバイスの諸情報が格納されます。
下位8bitにはBME280/BMP280のチップモデルが格納されます。0x60ならBME280, 0x58ならBMP280となります。
​
sns_opt()
1
uint32_t& sns_opt()
Copied!
setup(uint32_t arg1)で渡した値が格納されています。
下位8bitには指定したI2Cデバイスのアドレスが格納されます。
​
​
​