Sens'it から送信されたデータを バイナリパーサー の定義済みフォーマット @sensit で変換した場合は以下のような JSON 形式のデータを取得できます。
こちらの仕組みは SORACOM のユーザーコンソールでも販売している、 Sens'it V2 のデータフォーマットのみに対応しています。別モデルである Sens'it Discovery (V3) については FAQ「バイナリパーサー "@sensit.v3" で変換された値の意味を教えてください」を参照してください。
{
"mode": 1,
"modeText": "Temperature + Humidity",
"timeframe": 0,
"timeframeText": "10 mins",
"type": 0,
"typeText": "Regular, no alert",
"tempC": 25.125,
"tempCLowPrecision": 23,
"tempF": 77.225,
"tempFLowPrecision": 73.4,
"humidity": 56.5,
"reedSwitchState": 0,
"battery": 4.15,
"binaryParserEnabled": true,
"device": "21063F",
"time": "1559268922",
"seqNumber": "2567",
"data": "816d1171",
"lqi": "Good",
"countryCode": "392"
}
上記データの各項目の意味は以下のとおりです。
Sens'it から送信されたデータを元に変化された値
- "mode": データ取得モード種別
- "modeText": データ取得モードの名称
- 0: Button (ボタンモード・白)
- 1: Temperature + Humidity (温湿度モード・緑)
- 2: Light (照度モード・黄色)
- 3: Door (ドア開閉検知モード・水色)
- 4: Move (振動検知モード・紫)
- 5: Reed switch (マグネットモード・ピンク)
- "timeframe": データ送信間隔種別
- "timeframeText": データ送信間隔の説明文
- 0: 10 mins
- 1: 1 hour
- 2: 6 hours
- 3: 24 hours
- "type": データのメッセージ種別
- "typeText": 上記メッセージの説明文
- 0: Regular, no alert (定期送信)
- 1: Button call (ボタン 2 度押し)
- 2: Alert (振動モードなどの検知)
- 3: New mode (モード切替直後の送信)
- "tempC": 温度データ(摂氏)
- "tempCLowPrecision": 低精度の温度データ(摂氏)
- "tempF": 温度データ(華氏)
- "tempFLowPrecision": 低精度での温度データ(華氏)
- "humidity": 温湿度モードでの湿度(%)
温湿度モードでボタンを 2 度押したときには Button call としてデータが送信されますが、本製品の仕様により実際の湿度に関係なく "humidity" が固定値 (18) で送信されているため、バイナリバーサー "@sensit" では Button Call のときの湿度は出力せず、温度のみが出力されます。温湿度モード以外でも温度が記録されている場合がありますが、温度を取得したい場合は温湿度モードでご利用ください。
- "humidity": 温湿度モードでの湿度(%)
- "lux": 照度モードでの明るさ (ルクス)
- "reedSwitchState": マグネットモードのステータス
- 0: マグネットが離れている
- 1: マグネットが近づいている
マグネットモードではデータ送信中のステータス変化は無視されることに注意してください。
(当方の実測では最初のステータス変化から約 5 秒以内のステータス変化は無視されています)
- "numAlerts": センサが反応した回数
- "battery": バッテリーレベル (2.7 から 4.25 V)
- "binaryParserEnabled": バイナリパーサー機能により変換されたことを示すフラグ(値は "true")
Sigfox バックエンドから提供されるデータ
こちらは予告なく変更される可能性がございますのでご注意ください。
- "device": デバイス固有の ID
- "time": データ送信時刻(UNIXTIME)
- "seqNumber": データの通し番号
- "data": Sens'it からの送信データ(HEX 文字列)バイナリパーサー "@sensit" はこちらの文字列を変換しています。
- "lqi" : Link Quality Indicator (通信品質の指標) を Excellent, Good, Average, Limit の4レベルで表示します。各レベルの基準は Sigfox 社のドキュメント をご確認ください。
- "countryCode": 国コード (ISO 3166-1の3桁)。日本の場合は 392 となります。
- "operatorName": Sigfox オペレーター名