M
M
MWX Library
検索…
SHT3x - 温湿度センサー
I2Cバスを利用した温湿度センサーです。
本センサーはTWELITE PALシリーズでは使用されていません。利用例は以下を参照ください。 https://github.com/monowireless/ActEx_Sns_BME280_SHT30

処理の流れ

    1.
    Wire.begin(): バスの初期化
    2.
    .setup(): センサーの初期化
    3.
    .begin(): センサーの動作開始
    4.
    時間待ち数ms
    5.
    .available()trueになる
    6.
    .get_temp(), .get_humid(): 値の読み出し

動作に必要な手続き

Wireバス

setup()メソッド呼び出し前にWire.begin()によりWireが動作状態にしておきます。

スリープ復帰時の手続き

スリープ直前もWireバスが動作状態にしておきます(スリープ復帰後自動でWireを回復します)。

コード例

1
#include <TWELITE>
2
#include <SNS_SHT3X>
3
4
SNS_SHT3X sns_sht3x; // オブジェクトの宣言
Copied!
#include <SNS_SHT3X>SNS_SHT3Xクラスオブジェクトの宣言が必要です。

初期化

1
void setup() {
2
Wire.begin();
3
sns_sht3x.setup();
4
}
Copied!

センサー値の取得開始

1
void loop() {
2
3
if(eState == E_STATE::INIT) {
4
sns_sht3x.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_sht3x.available()) {
5
// センサー値読み出し可能
6
}
7
}
8
9
}
Copied!
センサー値が準備できたかどうかは.available()により判定できます。

センサー値の読み出し

1
void loop() {
2
3
if(eState == E_STATE::CAPTURE) {
4
if (sns_sht3x.available()) {
5
Serial << crlf << "SHT3X:"
6
<< " T=" << sns_sht3x.get_temp() << 'C'
7
<< " H=" << sns_sht3x.get_humid() << '%';
8
}
9
}
10
11
}
Copied!
センサー値が準備出来次第、値を読み出すことが出来ます。
.get_temp(), get_humid()は浮動小数点演算が含まれます。100倍整数値を取得することもできます。
1
auto temp = div100(sns_sht3x.get_temp_cent());
2
auto humd = div100(sns_sht3x.get_humid_per_dmil);
3
4
Serial << crlf << "SHT3X:"
5
<< format(" T=%c%d.%02d", temp.neg ? '-' : ' ', temp.quo, temp.rem)
6
<< format(" T=%c%d.%02d", humd.neg ? '-' : ' ', humd.quo, humd.rem);
Copied!
ここではdiv100()を用いて100倍値を整数部と小数部に分解しています。

メソッド

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_SHT3X>
2
SNS_SHT3X sns_sht3x;
3
bool b_found_sht3x = false;
4
5
void setup() {
6
sns_sht3x.setup();
7
if (!sns_sht3x.probe()) {
8
delayMicroseconds(100); // just in case, wait for devices to listen furthre I2C comm.
9
sns_sht3x.setup(0x45); // alternative ID
10
if (sns_sht3x.probe()) b_found_sht3x = true;
11
} else {
12
b_found_sht3x = true;
13
}
14
}
Copied!
上記の例では、まずデフォルトのI2C IDで初期化を試み、応答が無ければ0x45のアドレスでの初期化を試みています。

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!
待ち時間処理のセンサーの場合はarg1E_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!
センサーデバイスの諸情報が格納されます。
    本デバイスでは格納値は未定義です。

sns_opt()

1
uint32_t& sns_opt()
Copied!
setup(uint32_t arg1)で渡した値が格納されています。
    下位8bitには指定したI2Cデバイスのアドレスが格納されます。
最終更新 1yr ago