おくだけセンサーソリューション

コマンドインタフェース 説明書
第 1.04 版 2022 年 3 月１6 日発行

更新履歴

更新履歴
更新日

更新内容

2020.11.20

初版

2021.04.16

第 1.01 版

2021.04.19

第 1.02 版 COK001-LG でも振動計測モードが使えるような記述になっていたため修正、一部の章タイトルを修正

2022.03.01

第 1.03 版 FW3.0 での追加コマンド「親機選択ロジック」「外部温度センサ計測
モード」を追加。

2022.03.16

第 1.04 版 標準機 FW1.7 での低電圧検出関連のコマンドを追加。

get-clock/set-clock をロガーモード専用コマンドとして修正

2

はじめに

はじめに
この度は弊社のおくだけセンサーソリューションをご導入頂き、誠にありがとうございます。
本書は、おくだけセンサーの振動計測機能についての説明をするものです。
おくだけセンサーの取り扱いについては、おくだけセンサーソリューションの取扱説明書をご参照ください。
本書は必要なときにすぐ使えるように大切に保管してください。

 本取扱説明書の表記について


本取扱説明書は、おくだけセンサーソリューションの子機「SC-COK001」、おくだけセンサーソリュー
ションⅡEX1 の子機「SC-COK002」及び、おくだけセンサーロガー「SC-COK001-LG」よって差分がある箇所には、以下の機種マークを付けて記載しています。
SC-COK001
SC-COK001-LG
SC-COK002



本取扱説明書では、安全にお使いいただくために、守っていただきたい事項に次のマークを表示しています。

機能停止を招いたり、各種データを消してしまったりする可能性があることを示しています。十分に注意
してください。

関連する情報を記載しています。参考にお読みください。

本取扱説明書の画面イメージは開発中のものです。
実際の画面とは異なる場合があります。

 製品名について
本説明書では、「おくだけセンサー標準セット子機」及び「おくだけセンサーⅡEX1 セット子機」を「子機」と省略して記載しています。
本説明書の本文中においては、子機を「本製品」と表記しています。あらかじめご了承ください。

 商標について「Rooster」は、サン電子株式会社の登録商標です。

「おくだけセンサー」ロゴは、サン電子株式会社の登録商標です。

「Windows」「Excel」は、米国 Microsoft Corporation の米国およびその他の国における登録商標です。



その他、本取扱説明書に記載されている会社名、製品名は、各社の商標または登録商標です。



本文中の各社の商標または登録商標には、TM、®マークは表示しておりません。

3

目次

目次
更新履歴 ............................................................................................................................... 2
はじめに ................................................................................................................................ 3
1章

2章

コマンドラインインタフェースの使い方...................................................................................... 6
1-1

結線 ........................................................................................................................ 6

1-2

ソフトウェアの設定 ................................................................................................... 8

コマンドの仕様 ..................................................................................................................... 10
2-1

2-2

コマンド一覧 .......................................................................................................... 10
2-1-1

CLI モード・ロガーモード共通 .................................................................. 10

2-1-2

ロガーモードのみ .................................................................................... 11

2-1-3

コマンド説明で用いる表記 ...................................................................... 11

コマンドの説明 ....................................................................................................... 12
2-2-1

再起動 ................................................................................................... 122-2-2

電源を切る ............................................................................................. 12

2-2-3

時刻を設定............................................................................................. 13

2-2-4

時刻を取得............................................................................................. 14

2-2-5

ファームウェアのバージョンを取得 .......................................................... 14

2-2-6

動作ログを取得 ...................................................................................... 15

2-2-7

一般情報を取得 ..................................................................................... 16

2-2-8

動作モードを取得 ................................................................................... 17

2-2-9

ビルド番号の取得 ................................................................................... 18

2-2-10

電池電圧を取得 ..................................................................................... 18

2-2-11

オフライン時（自動ロガーモード）の記録間隔の設定 ................................ 19

2-2-12

オフライン時（自動ロガーモード）の記録間隔の取得 ................................ 19

2-2-13

加速度センサーの計測モード設定 .......................................................... 20

2-2-14

加速度センサーの計測モード取得 .......................................................... 21

2-2-15[振動計測]サンプリングレートの設定 ....................................................... 22

2-2-16[振動計測]サンプリングレートの取得 ....................................................... 23

2-2-17[振動計測]データ取得時間の設定........................................................... 24

2-2-18[振動計測]データ取得時間の取得........................................................... 25

2-2-19[振動計測]データ平均化対象の設定 ....................................................... 26

2-2-20[振動計測]データ平均化対象の取得 ....................................................... 27

2-2-21

加速度センサー0G オフセット補正値設定 ............................................... 28

2-2-22

加速度センサー0G オフセット補正値取得 ............................................... 29

2-2-23センサーデータの全取得 ........................................................................ 30

2-2-24

センサーデータの全消去 ........................................................................ 31

2-2-25

ロガー動作の設定 .................................................................................. 32

4

目次

3章

4章

2-2-26

ロガー動作の設定取得 ........................................................................... 33

2-2-27

記録済み件数の取得.............................................................................. 34

2-2-28空き領域で記録可能件数の取得 ............................................................ 35

2-2-29計測の開始 ............................................................................................ 36

2-2-30

計測の停止 ............................................................................................ 37

2-2-31

接続先選択ロジックの設定 ..................................................................... 38

2-2-32

接続先選択ロジックの取得 ..................................................................... 39

2-2-33

外部温度センサー計測モードの設定 ....................................................... 40

2-2-34

外部温度センサー計測モードの取得 ....................................................... 41

2-2-35

起動時の低電圧検出動作を設定 ............................................................ 42

2-2-36

起動時の低電圧検出動作を取得 ............................................................ 43

2-2-37

動作中の低電圧検出動作を設定 ............................................................ 44

2-2-38

動作中の低電圧検出動作を取得 ............................................................ 45

2-2-39

動作中に低電圧検出時の通知を試みる回数を設定 ................................ 46

2-2-40

動作中に低電圧検出時の通知を試みる回数を取得 ................................ 47

計測設定について ................................................................................................................ 48
3-1

設定文字列について .............................................................................................. 48

3-2

設定文字列の構造................................................................................................. 48

3-3

設定文字列の内容................................................................................................. 48
3-3-1

基本設定 ................................................................................................ 48

3-3-2

センサーの計測設定 .............................................................................. 49

計測ログフォーマットについて ............................................................................................... 52
4-1

センサーデータ出力文字列について ....................................................................... 52

4-2

データ出力のパターン ............................................................................................ 52

4-3

4-2-1

定期計測 ................................................................................................ 52

4-2-2

イベント検出 ........................................................................................... 52

出力文字の内容 .................................................................................................... 53
4-3-1

加速度センサー ...................................................................................... 53

4-3-2

照度センサー ......................................................................................... 54

4-3-3

温湿度センサー ...................................................................................... 55

4-3-4

磁気センサー ......................................................................................... 56

サポートのご案内 ............................................................................................................................. 57

5

1章 コマンドラインインタフェースの使い方

1章 コマンドラインインタフェースの使い方
この章では、コマンドラインインタフェースを扱うために使用するソフトウェアの設定ついて説明します。
コマンド操作を行うソフトウェアとして Tera Term を例に行ないますので、あらかじめインストールを行なってください。

1-1 結線

 通常モードの場合
1. PC と子機を USB ケーブルで接続します。

 USB ケーブルにつきましては、別途用意してください。
 使用できる USB ケーブルは、本製品側が micro USB Micro-B で PC 側はご使用の PC に合わせてください。

2. 子機の電源を入れ CLI モードに切り替えます。
 子機の電源ボタンを押して緑点灯したら、点灯中にもう一度電源ボタンを押し直します。

緑点灯したら、一旦離して再度押す

 LED が「緑」と「オレンジ」の交互点灯に変わることをご確認ください。
 切り替えができなかった場合は一旦電源を切り、再度電源を入れるところからやり直してください。

LED の表示内容については取扱説明書に記載がございます。

6

1章 コマンドラインインタフェースの使い方

 ロガーモード（ロガー）の場合
1. PC と子機を USB ケーブルで接続します。

 USB ケーブルにつきましては、別途用意してください。
 使用できる USB ケーブルは、本製品側が micro USB Micro-B で PC 側はご使用の PC に合わせてください。

2. 子機の電源を入れます。
 LED が「オレンジ」に 3 秒間点灯に変わることをご確認ください。

LED の表示内容については取扱説明書に記載がございます。

7

1章 コマンドラインインタフェースの使い方

1-2 ソフトウェアの設定
1. COM ポート番号を確認します。
 子機が接続されている COM ポート番号を確認します。
 デバイスマネージャーを起動し、ポート(COM と LPT グループ)に、『USB Serial Port』の名前の機器を探しカッ
コ内の番号を確認します。

この番号を確認

デバイスマネージャーは画面左下の Windows マークのうえで右クリックすると表示されるメニューから起動ができます。
2. Tera Term を起動します。
3. シリアルポートの設定を確認します。

 メニューバーから、「設定」-「シリアルポート」の順に選択します。
 ポートには先に確認した COM ポート番号を選択します。残りの設定は上記の画面の通りに設定します。

8

1章 コマンドラインインタフェースの使い方

4. 端末の設定を確認します。

 メニューバーから、「設定」-「端末の設定」の順に選択します。
 改行コードを、受信は「CR」に、送信は「CR+LF」にします。
 ローカルエコーにチェックを入れます。
 残りの設定は上記画面の通りにします。端末サイズは任意の設定でも問題ありません。

5. 子機へ接続します。

 シリアルを選択して、ポートには確認したポート番号を選択します。
 接続した後 ENTER キーを 1 回押すとコマンドが受付可能であることを示すプロンプト「okd_child_main>」が表示されます。

PC の子機と接続する USB ポートの差込口を変更すると、COM ポート番号が変わることがあります。
その場合は COM ポート番号の確認から行ってください。

9

2章 コマンドの仕様

2章 コマンドの仕様
この章では、CLI モードおよびロガーモードで使用できるコマンドについて説明します。

2-1 コマンド一覧
子機で使用できるコマンドは以下の通りです。

2-1-1

CLIモード・ロガーモード共通

以下のコマンドは CLI モード及びロガーモードで使用できます。
機能

コマンド

再起動をする。

reset

電源を切る。

shutdown

ファームウェアのバージョンを取得します。

get-fw-ver

動作ログを取得します。

get-log

一般情報を取得します。

get-childinfo

動作モードを取得します。

get-running-mode

機能

コマンド

ビルド番号を取得します。

get-build

電池電圧を取得します。

get-batt-volt

オフライン時(自動ロガーモード)の記録間隔を設定します。

set-offline-record-period

オフライン時(自動ロガーモード)の記録間隔を取得します。

get-offline-record-period

接続先の選択ロジックの設定をします。

set-connection-select-logic

接続先の選択ロジックの取得をします。

get-connection-select-logic

外部温度センサー計測モードを設定します。

set-extemp-mode

外部温度センサー計測モードを取得します。

get-extemp-mode

機能

コマンド

計測モードの設定をします。

set-acc-mode

計測モードの設定状態を取得します。

get-acc-mode

振動計測モード時のサンプリングレートを設定します。

set-acc-sample-rate

振動計測モード時のサンプリングレートの設定状態を取得します。

get-acc-sample-rate

振動計測モード時の計測時間の設定をします。

set-acc-sample-time

振動計測モード時の計測時間の設定状態を取得します。

get-acc-sample-time

振動計測モード時の平均化処理の設定をします。

set-acc-sample-ave

振動計測モード時の平均化処理の設定状態を取得します。

get-acc-sample-ave

0G オフセット補正値を設定します。

set-acc-offset

0G オフセット補正値の設定状態を取得します。

get-acc-offset

起動時の低電圧検出動作を設定します。

set-startup-lowbatt-alarm

起動時の低電圧検出動作を取得します。

get-startup-lowbatt-alarm10

2章 コマンドの仕様

機能

コマンド

動作中の低電圧検出動作を設定します。

set-normal-lowbatt-alarm

動作中の低電圧検出動作を取得します。

get-normal-lowbatt-alarm

動作中の低電圧検出時の通知を試みる回数を設定します。

set-normal-lowbatt-alarm-count

動作中の低電圧検出時の通知を試みる回数を取得します。

get-normal-lowbatt-alarm-count

2-1-2

ロガーモードのみ

以下のコマンドはロガーモードのみで使用できます。
機能

コマンド

ロガーモードで計測したセンサーデータを取得します。

get-sensor-data

ロガーモードで計測したセンサーデータを消去します。

del-sensor-data

ロガーモードの計測設定をします。

set-config

ロガーモードの計測設定を取得します。

get-config

ロガーモードで計測した記録済みデータ件数を取得します。

get-sensor-data-saved-countロガーモードの記録可能なデータ件数を取得します

get-sensor-data-free-countロガーモードで計測を開始します。

start-rec

ロガーモードで計測を停止します。

stop-rec

時刻を設定します。

set-clock

時刻を取得します。

get-clock2-1-3

コマンド説明で用いる表記

設定するコマンドでは設定内容をスペースで区切り、引数で設定内容を渡します。
引数の説明の表記として以下の表記を使用します。
書式

説明

引数での設定例<引数・パラメータ名>

引数の場合は、値が指定できることを表します。

引数を数値で指定する場合は以下の様にします。

値は数値、または文字列で指定できます。

10 進数で指定する場合 100

応答パラメータの場合は、設定内容などの情報が返されることを表します。

引数を文字列で指定する場合はダブルクォート「”」でくくります。

例) 100 を指定する。
16 進数で指定する場合 0x64例)ABC を指定する。
“ABC”
 コマンドと引数の間はスペースを 1 個以上で区切ります。

11

2章 コマンドの仕様

2-2 コマンドの説明
2-2-1

再起動

機能

再起動します。

コマンドの書式

reset

引数

説明

指定できる内容（引数はありません）

応答
成功時

なし
BUSY[CR][LF]

ロガー動作中応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>reset
備考

2-2-2

直ちにリセットが行われます。

電源を切る

機能

電源を切ります。

コマンドの書式

shutdown

引数

説明指定できる内容（引数はありません）

応答
成功時

OK[CR][LF]
BUSY[CR][LF]

ロガー動作中応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>shutdown
備考

LED は電源オフ時の表示が行われます。（赤 5 回点滅）

12

2章 コマンドの仕様

2-2-3

時刻を設定

機能

時刻の設定を行います。

コマンドの書式

set-clock <time>

引数

説明指定できる内容time

日付時刻の文字列

日付時刻がつながった文字列で設定します。
1 月などは前に 0 をつけて指定桁数にします。
日付 YYYYMMDDYYYY：西暦 4 桁
MM：月 2 桁
DD：日 2 桁
時刻 hhmmss
hh：時刻 24 時間制で 2 桁
mm：分を 2 桁
ss：秒を 2 桁例) 2020 年 11 月 9 日午後 1 時 10 分 0 秒“20201109131000”例) 2020 年 01 月 01 日午前 9 時 10 分 5 秒“20200101091005”

応答
成功時

OK[CR][LF]

失敗時

NG[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-clock “20201109131000”
OK
備考

ロガーモードにおいては、電源をオフとしても、スリープ状態(低消費電力モード)にして時刻カウントを継続します。

本コマンドはロガーモードのみで使用可能です。

13

2章 コマンドの仕様

2-2-4

時刻を取得

機能

時刻を取得します。

コマンドの書式

get-clock

引数

説明指定できる内容（引数はありません）

応答
成功時<year>/<month>/<day> <hour>:<min>:<sec>[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明year

年を 4 桁で表示(西暦)month

月を 2 桁で表示

day

日を 2 桁で表示

hour

時を 2 桁で表示(24 時間制)

min

分を 2 桁で表示

sec

秒を 2 桁で表示

実行例
okd_child_main>get-clock
2020/11/10 11:47:10
備考
本コマンドはロガーモードのみで使用可能です。

2-2-5

ファームウェアのバージョンを取得

機能

ファームウェアのバージョンを取得します。

コマンドの書式

get-fw-ver

引数説明指定できる内容（引数はありません）

応答
成功時<major>.<minor> [CR][LF]
BUSY[CR][LF]

ロガー動作中応答のパラメータ

説明

major

メジャーバージョン番号minor

マイナーバージョン番号

実行例
okd_child_main>get-fw-ver
1.6
備考

14

2章 コマンドの仕様

2-2-6

動作ログを取得機能

動作ログを全件取得します。

コマンドの書式

get-log

引数

説明指定できる内容（引数はありません）

応答
成功時<YMDHMS>,<maincode>,<subcode> [CR][LF]： （ログ件数分繰り返し出力）
OK[CR][LF]
BUSY[CR][LF]

ロガー動作中応答のパラメータ

説明

YMDHMS

ログ情報発生日時

maincode

メインコードsubcodeサブコード

実行例
okd_child_main>get-log
20180731165006, 30, 09
20180731164716, 31, 39
20180731163326, 31, 03
20180731163300, 31, 04
OK
備考

ログ出力は新しい記録から先に出力されます。

15

2章 コマンドの仕様

2-2-7

一般情報を取得

機能

子機の一般情報を取得します。

コマンドの書式

get-childinfo

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<modelno>[CR][LF][CR][LF]<serialno>[CR][LF][CR][LF]<childno>[CR][LF][CR][LF]
OK[CR][LF]

失敗時

NG[CR][LF]
BUSY[CR][LF]

ロガー動作中応答のパラメータ

説明

modelno製品型式 (SC-COK001、SC-COK001-LG、SC-COK002 など)

serialno

シリアル番号

childno

子機番号

実行例
okd_child_main>get-childinfo
SC-COK001
COK001186A0001
1
OK
備考

16

2章 コマンドの仕様

2-2-8

動作モードを取得

機能

動作モードを取得します。

コマンドの書式

get-running-mode

引数説明指定できる内容（引数はありません）

応答
成功時<mode>[CR][LF]
OK[CR][LF]
BUSY[CR][LF]

ロガー動作中応答のパラメータ

説明

mode

現在の動作モード（CLI または Logger）

実行例
okd_child_main>get-running-mode
CLI
OK
備考

17

2章 コマンドの仕様

2-2-9

ビルド番号の取得

機能

ビルド番号を取得します。

コマンドの書式

get-build

引数説明指定できる内容（引数はありません）

応答<number>[CR][LF]

成功時

OK[CR][LF]
応答のパラメータ

説明

number

ビルド番号

実行例
okd_child_main>get-build
20201015192652
OK
備考

2-2-10

電池電圧を取得

機能

電池電圧を取得します。

コマンドの書式

get-batt-volt

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<volt>[CR][LF][CR][LF]
OK[CR][LF]

応答のパラメータ

説明

volt

電池電圧

実行例
okd_child_main>get-batt-volt
Battery 2.94
OK
備考

稼働時の動作負荷をかけた状態での計測値が表示されます。
一般的なテスターでは無負荷で計測されていることが多いため、本コマンドの表示値と異なる場合があります。

18

2章 コマンドの仕様

2-2-11

オフライン時（自動ロガーモード）の記録間隔の設定

機能

オフライン時(自動ロガーモード)の記録間隔を設定します。

コマンドの書式

set-offline-record-period <min>引数説明指定できる内容min

計測値を記録する間隔を指定します。

10：10 分間隔
15：15 分間隔
30：30 分間隔
60：60 分間隔 <出荷時設定>

応答
成功時

OK[CR][LF]

失敗時

ERROR[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main> set-offline-record-period 30
OK
備考

親機に電波が届かない場合のデータ計測・記録間隔を設定します。
記録されたデータは親機に接続されると自動で送信されます。
記録件数は最大 96 件（60 分の設定で 4 日間）です。
FW 2.1 以降で使用できます。

2-2-12

オフライン時（自動ロガーモード）の記録間隔の取得

機能

オフライン時(自動ロガーモード)の記録間隔を取得します。

コマンドの書式

get-offline-record-period

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<min>[CR][LF][CR][LF]
OK[CR][LF]

応答のパラメータ

説明min

オフライン時のデータ記録間隔（分）実行例
okd_child_main>get-offline-record-period
60
OK
備考

親機に電波が届かない場合のデータ計測・記録間隔です。
FW 2.1 以降で使用できます。

19

2章 コマンドの仕様

2-2-13

加速度センサーの計測モード設定

機能

加速度センサーの計測モードの設定をします。

コマンドの書式

set-acc-mode <mode>

引数

説明指定できる内容

mode

設定する計測モードを指定します。

0：姿勢検出モード <出荷時設定>
1：振動計測モード

応答
成功時

OK[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-acc-mode 1
OK
備考FW1.5 以降で使用できます。
振動計測モードは通信モード時のみ使用可能です。
ロガーモードでは本コマンドの設定に関わらず、姿勢検出モードで固定となります。

20

2章 コマンドの仕様

2-2-14

加速度センサーの計測モード取得

機能

加速度センサーの計測モードの設定状態を取得します。

コマンドの書式

get-acc-mode

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<mode>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

mode

0：姿勢検出モード<出荷時設定>1：振動計測モード
実行例
okd_child_main>get-acc-mode
1OK
備考

FW1.5 以降で使用できます。
振動計測モードは通信モード時のみ使用可能です。
ロガーモードでは本コマンドの出力に関わらず、姿勢検出モードで固定となります。

21

2章 コマンドの仕様

2-2-15[振動計測]サンプリングレートの設定

機能

振動計測モード時のデータ取得サンプリングレートを設定します。

コマンドの書式

set-acc-sample-rate <rate>

引数

説明指定できる内容rate

計測時の 1 秒当たりデータ取得件数を指定します。

100：100Hz（100 件） <出荷時設定>
400：400Hz（400 件）
800：800Hz（800 件）

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-acc-sample-rate 100
OK
備考FW1.5 以降で使用できます。

22

2章 コマンドの仕様

2-2-16[振動計測]サンプリングレートの取得

機能振動計測モード時のデータ取得サンプリングレートを取得します。

コマンドの書式

get-acc-sample-rate

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<rate>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

rate

100：100Hz（100 件）に設定
400：400Hz（400 件）に設定
800：800Hz（800 件）に設定

実行例
okd_child_main>get-acc-sample-rate
100
OK
備考

FW1.5 以降で使用できます。

23<出荷時デフォルト>2章 コマンドの仕様

2-2-17[振動計測]データ取得時間の設定

機能

振動計測モード時、1 回のデータ取得の継続時間を設定します。

コマンドの書式

set-acc-sample-time <time>

引数

説明指定できる内容<time>

データ取得を継続する時間を指定します。

1：1 秒間
5：5 秒間10：10 秒間 <出荷時設定>

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-acc-sample-time 10
OK
備考

FW1.5 以降で使用できます。

24

2章 コマンドの仕様

2-2-18[振動計測]データ取得時間の取得

機能

振動計測モード時、1 回のデータ取得の継続時間を取得します。

コマンドの書式

get-acc-sample-time

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<time>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明time

1：1 秒間に設定
5：5 秒間に設定
10：10 秒間に設定<出荷時設定>実行例
okd_child_main>get-acc-sample-time
10
OK
備考

FW1.5 以降で使用できます。

25

2章 コマンドの仕様

2-2-19[振動計測]データ平均化対象の設定

機能

振動計測モード時の平均化データ処理で対象となるデータ範囲を設定します。

コマンドの書式

set-acc-sample-ave <ave>

引数

説明指定できる内容<ave>

対象範囲を指定します

5：全計測データ中の上位 5％を対象にします。
10：全計測データ中の上位 10％を対象にします。
15：全計測データ中の上位 15％を対象にします。<出荷時設定>
20：全計測データ中の上位 20％を対象にします。

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-acc-sample-ave 15
OK
備考FW1.5 以降で使用できます。

26

2章 コマンドの仕様

2-2-20[振動計測]データ平均化対象の取得

機能

振動計測モード時の平均化データ処理で対象となるデータ範囲を取得します。

コマンドの書式

get-acc-sample-ave

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<ave>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明ave

全計測データ中の上位 5％を対象と設定
全計測データ中の上位 10％を対象と設定
全計測データ中の上位 15％を対象と設定
全計測データ中の上位 20％を対象と設定

実行例
okd_child_main>get-acc-sample-ave
15
OK
備考

FW1.5 以降で使用できます。

27<出荷時設定>2章 コマンドの仕様

2-2-21

加速度センサー0Gオフセット補正値設定

機能

加速度センサーの 0G の中心点ずれを補正する値を設定します。

コマンドの書式

set-acc-offset <axis> <value>

引数

説明指定できる内容axis

補正値を設定する軸を指定します

0：X 軸の補正値を設定する。
1：Y 軸の補正値を設定する。
2：Z 軸の補正値を設定する。

value-128～127 の値で補正値。

補正値を指定します。

1 あたり 15.6mg の補正量。
応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-acc-offset 1 5
OK
備考FW1.6 以降で使用できます。

28

2章 コマンドの仕様

2-2-22

加速度センサー0Gオフセット補正値取得機能

加速度センサーの 0G の中心点ずれの補正設定状態を表示します。

コマンドの書式

get-acc-offset

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]
axis X offset : <axis x value>[CR][LF]
axis Y offset : <axis y value>[CR][LF]
axis Z offset : <axis z value>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

axis x value

X 軸の補正値（-128～127）

axis y value

Y 軸の補正値（-128～127）

axis z value

Z 軸の補正値（-128～127）

実行例
okd_child_main>get-acc-offset
axis X offset : 0
axis Y offset : 0
axis Z offset : 0
OK
備考FW1.6 以降で使用できます。

29

2章 コマンドの仕様

2-2-23センサーデータの全取得

機能ロガーモードで記録したセンサーデータを全件取得する。

コマンドの書式

get-sensor-data

引数

説明指定できる内容（引数はありません）

応答
成功時<YYYYMMDDHHmmSS>,<data>： （ログ件数分繰り返し出力）
OK[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明YYYYMMDDHHmmSS

データの記録日付時刻、西暦 4 桁,月 2 桁,日 2 桁,時 2 桁(24 時間制),分 2 桁,秒 2 桁

data

記録設定の応じたデータ出力。項目ごとにカンマ区切り。
内容については「4 章の計測ログフォーマットについて」を参照してください。

実行例
okd_child_main>get-sensor-data
20180806170115, 0002, 00, 04, 65E0, FFFF, 0001, 00, 08, 0B, FF, EFFF, F7FF, D000, 0004, 00, 04, 01, FFFFFF,
0003, 00, 04, 6C1C, 7556
20180806170105, 0002, 00, 04, 65DB, FFFF, 0001, 00, 08, 0B, FF, F5FF, F7FF, D600, 0004, 00, 04, 01, FFFFFF,
0003, 00, 04, 6C1C, 7576
20180806170055, 0002, 00, 04, 65D6, FFFF, 0001, 00, 08, 0B, FF, F2FF, F4FF, D600, 0004, 00, 04, 01, FFFFFF,
0003, 00, 04, 6C10, 756E
OK
備考

データの取得はおくだけアシスタントツールでの取得を推奨します。

30

2章 コマンドの仕様

2-2-24

センサーデータの全消去

機能

ロガーで記録した全データを消去します。

コマンドの書式

del-sensor-data

引数

説明指定できる内容（引数はありません）

応答
成功時

OK[CR][LF]

失敗時

NG[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>del-sensor-data
OK
備考

31

2章 コマンドの仕様

2-2-25

ロガー動作の設定

機能

ロガー動作の設定を行います。

コマンドの書式

set-config <config>

引数説明指定できる内容

config

設定文字列

指定する文字列については「3 章計測設定について」をご覧ください。

応答
成功時

OK[CR][LF]

失敗時<error>[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

error

エラー内容の文字列
Hex strings convert error.

使用できない文字が含まれています。

Config parameter error.

設定できないパラメータがあります。

Periodic measurement cycle is short.

計測周期が短過ぎます。

Failed to set up sensors.

センサーの初期化でエラー発生しました。

実行例
okd_child_main>set-config "FFFFFFFF00F0FF08102700000D01FFFF01800000028000000380000004800000"
OK
備考

ロガー動作の設定を行うと、現在の記録内容が初期化(消去)されます。
センサーの初期化でエラー発生の場合は再起動がかかります。
ロガー動作の設定はおくだけアシスタントツールでの取得を推奨します。

32

2章 コマンドの仕様

2-2-26

ロガー動作の設定取得

機能

ロガー動作の現在の設定内容を取得します。

コマンドの書式

get-config

引数説明指定できる内容（引数はありません）

応答
成功時<config>[CR][LF][CR][LF]
OK[CR][LF]

失敗時

None[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

config

設定文字列

実行例
okd_child_main>get-config
FFFFFFFF00F0FF08102700000D01FFFF01800000028000000380000004800000
OK
備考

33

2章 コマンドの仕様

2-2-27

記録済み件数の取得

機能ロガーで記録済みの件数を取得します。

コマンドの書式

get-sensor-data-saved-count

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<count>[CR][LF][CR][LF]
OK[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

count

記録済み件数実行例
okd_child_main>get-sensor-data-saved-count
57
OK
備考

34

2章 コマンドの仕様

2-2-28空き領域で記録可能件数の取得

機能

ロガーモードで記録可能な残件数を取得します。

コマンドの書式

get-sensor-data-free-count

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<count>[CR][LF][CR][LF]
OK[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

count

空き領域で記録可能な件数。
ただし動作設定でリング記録する設定にしている場合、-1 を応答します。

実行例
okd_child_main>get-sensor-data-free-count
-1
OK
備考

35

2章 コマンドの仕様

2-2-29計測の開始

機能

ロガーモードで記録を開始します。

コマンドの書式

start-rec

引数

説明指定できる内容（引数はありません）

応答
成功時

OK[CR][LF]

失敗時<error>[CR][LF]

ロガー動作中BUSY[CR][LF]

応答のパラメータ

説明

error

エラー内容文字列
Failed to set up sensors.

センサーの初期化でエラーが発生。

Failed to start periodical measurement. 動作設定内容に問題がある、または破損。
実行例
okd_child_main>start-rec
OK
備考

すでに記録済みデータがある場合は追記されます。
開始時にエラーになった場合、再起動がかかります。

36

2章 コマンドの仕様

2-2-30

計測の停止

機能

ロガーモードで記録を停止します。

コマンドの書式

stop-rec

引数

説明指定できる内容（引数はありません）

応答
成功時

OK[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>stop-rec
OK
備考

37

2章 コマンドの仕様

2-2-31

接続先選択ロジックの設定

機能

接続先選択ロジックを設定します。

コマンドの書式

set-connection-select-logic <logic>

引数説明指定できる内容

logic

接続先選択ロジック番号

0：親機優先で接続する。
1：中継機優先で接続する
2：無線強度優先で接続する
3：親機の無線強度が良好(-60dBm 以上)なら親機優先、良好でない場合は無線強度優先で接続する。<出荷時設定>※同じ種別同士の場合は、無線強度で判定します。

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-connection-select-logic 3
OK
備考

従来動作は親機優先です。（ロジック番号 0）
FW 3.0 以降で使用できます。

38

2章 コマンドの仕様

2-2-32

接続先選択ロジックの取得

機能

接続先選択ロジックを取得します。

コマンドの書式

get-connection-select-logic

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<logic>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明

logic

0：親機優先で接続する。
1：中継機優先で接続する
2：無線強度優先で接続する
3：親機の無線強度が良好(-60dBm 以上)なら親機優先、良好でない場合は無線強度優先で接続する。<出荷時設定>※同じ種別同士の場合は、無線強度で判定します。

実行例
okd_child_main>get-connection-select-logic
3OK
備考

FW 3.0 以降で使用できます。

39

2章 コマンドの仕様

2-2-33

外部温度センサー計測モードの設定

機能

外部温度センサーの計測モードを設定します。

コマンドの書式

set-extemp-mode <mode>

引数

説明指定できる内容

mode

計測モード番号

0：通常モード <出荷時設定>
1：WBGT 日射なし（屋内）※
2：WBGT 日射あり（屋外）※

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main>set-extemp-mode 0
OK
備考

従来動作は通常モードです。（ロジック番号 0）
FW 3.0 以降で使用できます。
WBGT 日射あり/日射なしでの計測では、直径 4cm の黒球装着または黒球が装着済みの外部温度センサーが必要です。

※JIS Z 8504:2021 で、屋外・屋内から日射あり・日射なしに改定されています。

40

2章 コマンドの仕様

2-2-34

外部温度センサー計測モードの取得

機能

外部温度センサーの計測モードを取得します。

コマンドの書式

get-extemp-mode

引数説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<mode>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明

mode

0：通常モード <出荷時設定>
1：WBGT 日射なし（屋内） ※2：WBGT 日射あり（屋外） ※実行例
okd_child_main>get-extemp-mode0OK
備考

FW 3.0 以降で使用できます。
WBGT 日射あり/日射なしでの計測では、直径 4cm の黒球装着または黒球が装着済みの外部温度センサーが必要です。

※JIS Z 8504:2021 で、屋外・屋内から日射あり・日射なしに改定されています。

41

2章 コマンドの仕様

2-2-35

起動時の低電圧検出動作を設定

機能

起動時の低電圧検出動作を設定します。

コマンドの書式

set-startup-lowbatt-alarm <mode>

引数

説明指定できる内容mode

低電圧検出時動作

0：起動中 2.4V 以下を検出後、3.5 秒経過後も 2.4V 以
下が継続していた場合に低電圧検出としログへの記録。親機への通知を試みた後に電源を切ります。 <出荷時設定>
1：起動中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みます。動作は継続します。
2：起動中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みた後に電源を切ります。
3：無視します。（低電圧を検出しない）

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main> set-startup-lowbatt-alarm 0
OK
備考FW 1.7 以降で使用できます。
FW 1.6 までの動作は設定番号 0 の動作です。
コイン型電池は消費電流に対して電圧変動が大きいため、設定番号 1 および 2 にした場合、従来よりもかなり早めに低電圧検出が通知されます。

42

2章 コマンドの仕様

2-2-36

起動時の低電圧検出動作を取得

機能

起動時の低電圧検出動作を取得します。

コマンドの書式

get-startup-lowbatt-alarm

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<mode>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明

mode

0：起動中 2.4V 以下を検出後、3.5 秒経過後も 2.4V 以下が継続していた場合に低電圧検出としログへの記録。親機への通知を試みた後に電源を切ります。 <出荷時設定>
1：起動中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みます。
動作は継続します。
2：起動中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みた後に電源を切ります。
3：無視します。（低電圧を検出しない）

実行例
okd_child_main> get-startup-lowbatt-alarm0OK
備考

FW 1.7 以降で使用できます。

43

2章 コマンドの仕様

2-2-37

動作中の低電圧検出動作を設定

機能

動作中の低電圧検出動作を設定します。

コマンドの書式

set-normal-lowbatt-alarm <mode>

引数

説明指定できる内容mode

低電圧検出時動作

0：動作中 2.4V 以下を検出後、3.5 秒経過後も 2.4V 以
下が継続していた場合に低電圧検出としログへの記録。親機への通知を試みた後に電源を切ります。 <出
荷時設定>
1：動作中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みます。電源投入後のログ記録及び通知回数は別のコマンドにて 0～15 回で設定できます。動作は継続します。
2：動作中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みた後に電源を切ります。
3：無視します。（低電圧を検出しない）

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main> set-normal-lowbatt-alarm 0
OK
備考FW 1.7 以降で使用できます。
FW 1.6 までの動作は設定番号 0 の動作です。
コイン型電池は消費電流に対して電圧変動が大きいため、設定番号 1 および 2 にした場合、従来よりもかなり早めに低電圧検出が通知されます。

44

2章 コマンドの仕様

2-2-38

動作中の低電圧検出動作を取得

機能

動作中の低電圧検出動作を取得します。

コマンドの書式

get-normal-lowbatt-alarm

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<mode>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明

mode

0：動作中 2.4V 以下を検出後、3.5 秒経過後も 2.4V 以下が継続していた場合に低電圧検出としログへの記録。親機への通知を試みた後に電源を切ります。 <出荷時設定>
1：動作中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みます。
動作は継続します。
2：動作中 2.4V 以下を検出したら低電圧検出としてログへ記録。親機への通知を試みた後に電源を切ります。
3：無視します。（低電圧を検出しない）

実行例
okd_child_main> get-normal-lowbatt-alarm0OK
備考

FW 1.7 以降で使用できます。

45

2章 コマンドの仕様

2-2-39

動作中に低電圧検出時の通知を試みる回数を設定

機能

動作中の低電圧検出時の通知を試みる回数を設定します。

コマンドの書式

set-normal-lowbatt-alarm-count <count>

引数

説明指定できる内容

count

通知を試みる回数

0～15<出荷時設定>15
電源入れてから 2.4V 以下を検出したときに通知を試みる回数です。
動作中の低電圧検出動作設定で 1 に設定している場合に有効です。

応答
成功時[CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明（応答パラメータはありません）

実行例
okd_child_main> set-normal-lowbatt-alarm-count 3
OK
備考FW 1.7 以降で使用できます。

46

2章 コマンドの仕様

2-2-40

動作中に低電圧検出時の通知を試みる回数を取得

機能

動作中の低電圧検出時の通知を試みる回数を取得します。

コマンドの書式

get-normal-lowbatt-alarm-count

引数

説明指定できる内容（引数はありません）

応答
成功時[CR][LF]<mode>[CR][LF][CR][LF]
OK[CR][LF]

失敗時[CR][LF]ERROR[CR][LF]

応答のパラメータ

説明

count

0～15
<出荷時設定>15
電源入れてから 2.4V 以下を検出したときに通知を試みる回数です。
動作中の低電圧検出時の通知設定で 1 に設定している場合に有効です。

実行例
okd_child_main> get-normal-lowbatt-alarm-count
15
OK
備考

FW 1.7 以降で使用できます。

47

3章 計測設定について

3章 計測設定について
この章では、ロガーモードの記録動作設定文字列について説明します。

3-1 設定文字列について
ロガーモードの設定はすべて 16 進数表記の文字列で指定します。
設定できる内容は「おくだけアシスタントツール」でできる内容と変わりません。
通常は「おくだけアシスタントツール」の使用を強く推奨します。

手動で設定した結果ついては、いかなる場合もサポートの対象外とさせていただきます。
実際にデータを取得する前に十分には検証を行ってください。

3-2 設定文字列の構造
設定文字列は以下の構造になっています
基本設定

各センサーの設定

各センサーの設定

各センサーの設定

設定ブロック説明

基本設定

計測を行う周期、リング記録を行うかの有無を設定します。

各センサーの設定

センサーごとの計測およびイベントの設定を、すべてのセンサー分連ねた形で記述します。計測やイベント検出をしないセンサーについては記述しません。

各設定は設定値を 16 進数表記であらわし、複数バイト長の場合はリトルエンディアンで記述します。
例）設定値が 1 バイト長の 128 の場合、”80”例）設定値が 2 バイト長の 42000 の場合、”A410” → リトルエンディアンにする ”10A4”

3-3 設定文字列の内容
3-3-1

基本設定

基本設定は以下の構造です。
設定項目

設定サイズ

説明

ダミー

4 バイト長“FFFFFFFF” 固定

ヘッダ

2 バイト長“00F0” 固定

ダミー

1 バイト長“FF” 固定

後続データ長1 バイト長”08” 固定

定期計測周期

4 バイト長ミリ秒単位で指定

ダミー

1 バイト長”FF” 固定リング保存

1 バイト長”00” リング保存しない，”01” リング保存する

ダミー

2 バイト長”FFFF” 固定48

3章 計測設定について

 計測周期についてセンサーにより計測に最小限必要な時間が異なるため、定期計測周期は計測対象のセンサーで必要な時間の総和以下には設定できません。
センサーごとの最小計測時間は以下の通りです。
センサー

最小計測時間備考（リング記録時の最小計測時間）

加速度センサー10ms

単体でリング記録ありの場合、13ms

照度センサー

125ms

リング記録にしても上乗せなし

温湿度センサー12ms

リング記録にしても上乗せなし

磁気センサー

5ms

単体でリング記録ありの場合、10ms

例）すべて有効の場合
10 + 125 +12 + 5 ＝ 152ms
リング記録が有効の場合は FLASH メモリの消去時間が必要となるため、短い周期を指定する場合に数 msほどが上乗せされます。

3-3-2

センサーの計測設定

 加速度センサー
 定期計測のみ
定期計測対象にする場合、以下の設定を入れます。
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0180” 固定

動作指示

1 バイト長“00” 固定

後続データ長1 バイト長”00” 固定 イベント
イベントは自由落下もしくはシングルタップのどちらか一方の選択です。同時に指定はできません。

自由落下
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0100” イベント検出のみ”0180” 定期計測とイベント検出

動作指示

1 バイト長“03” 固定

後続データ長1 バイト長”04” 固定

落下検知閾値

1 バイト長落下と判断開始する加速度（1 あたり 62.5mg）
推奨は 300～600mg

落下継続時間

1 バイト長閾値超過継続ミリ秒単位（1 あたり 5ms）
推奨は 100～350ms

ダミー

2 バイト長”FFFF”固定49

3章 計測設定について

シングルタップ
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0100” イベント検出のみ”0180” 定期計測とイベント検出

動作指示

1 バイト長“01” 固定

後続データ長1 バイト長”04” 固定

衝撃検知閾値

1 バイト長タップ(衝撃)と判断開始する加速度（1 あたり 62.5mg）
推奨は 300～600mg

衝撃持続時間

1 バイト長衝撃の持続時間（1 あたり 0.625ms）
推奨はタップなら 6.25ms

検知軸

1 バイト長検出対象とする軸。軸指定値の合算を指定
4：X 軸
2：Y 軸
1：Z 軸

ダミー

1 バイト長”FF” 固定 照度センサー 定期計測のみ
定期計測対象にする場合、以下の設定を入れます。
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0280” 固定

動作指示

1 バイト長“00” 固定

後続データ長1 バイト長”00” 固定

設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0200” イベント検出のみ

 イベント
照明検出”0280” 定期計測とイベント検出
動作指示

1 バイト長“01” 固定

後続データ長1 バイト長”04” 固定

検出開始照度2 バイト長

この閾値を上回るとイベントが発生します。

検出終了照度2 バイト長

この閾値を下回るとイベントが発生します。

50

3章 計測設定について

 温湿度センサー
 定期計測定期計測対象にする場合、以下の設定を入れます。
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0380” 固定

動作指示

1 バイト長“00” 固定

後続データ長1 バイト長”00” 固定 イベント
温湿度センサーにはイベント検出はありません 磁気センサー 定期計測のみ
定期計測対象にする場合以下の設定を入れます。
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0480” 固定

動作指示

1 バイト長“00” 固定

後続データ長1 バイト長”00” 固定 イベント
磁気有無状態が変化した場合をイベントとして検出する場合、以下の設定を入れます。
設定項目

設定サイズ

説明

ヘッダ

2 バイト長“0400” イベント検出のみ”0480” 定期計測とイベント検出

動作指示

1 バイト長“01” 固定

後続データ長1 バイト長”00” 固定

51

4章 計測ログフォーマットについて

4章 計測ログフォーマットについて
この章では、ロガーモードのセンサーデータの出力フォーマットついて説明します。

4-1 センサーデータ出力文字列について
ロガーモードのセンサーデータ出力はデータの項目単位でカンマ区切り、同時刻の複数のデータを１行に連ねた形で出力されます。
センサーのデータの値は直読可能な値ではなく、所定の計算式で換算が必要です。
通常は「おくだけアシスタントツール」の使用を強く推奨します。

手動で計算した結果ついては、いかなる場合もサポートの対象外とさせていただきます。
実際にデータを取得する前には十分に検証を行ってください。

4-2 データ出力のパターンセンサーデータ出力は、周期的に行う「定期計測」と「イベント検出時」では出力が異なります。

4-2-1

定期計測

同時刻に定期計測対象とされたセンサーのすべてのデータが 1 レコードで出力されます。
例) 加速度センサーと温湿度センサーの定期計測の出力
20201110173648, 0100, 00, 08, 0B, FF, F4FF, E6FF, DD00, 0300, 00, 04, 9C6C, BE6B

4-2-2

イベント検出複数のセンサーでイベント検出を行う設定としていても、個々のセンサーイベントの検出ごとに 1 レコー
ドで出力されます。

例) 加速度センサーのタップイベント検出の出力
20201110173648, 0130, 01, 00

52

4章 計測ログフォーマットについて

4-3 出力文字の内容
4-3-1

加速度センサー 定期計測データ
データ項目

データサイズ

説明

ヘッダ

4 文字長

“0100” 固定

データ種別

2 文字長

“00” 固定

後続データ長2 文字長”08” 固定

加速度 X 軸

4 文字長

X 軸加速度データ（リトルエンディアン形式）

加速度 Y 軸

4 文字長

Y 軸加速度データ（リトルエンディアン形式）

加速度 Z 軸

4 文字長

Z 軸加速度データ（リトルエンディアン形式）

各軸の加速データ計算方法は以下の通りです。
1.

エンディアンを治す。

上位バイトと下位バイトが入れ替わっているので、入れ替える。
例） E400 → 00E42.

16 進数から 10 進数に換算する。

例）00E4 → 228
例）FFE6 → -26
3.

※マイナス値は 2 の補数表現です。

加速度値に換算する。

加速度(m/s２) = ( 上記 2.の値 × 3.9 × 9.8 ) ÷ 1000

 イベント検出データ
データ項目

データサイズ

説明

ヘッダ

4 文字長

“0130” 固定

イベント種別2 文字長“01” シングルタップ検出”03” 自由落下検出

後続データ長2 文字長”00” 固定53

4章 計測ログフォーマットについて

4-3-2

照度センサー 定期計測データ
データ項目

データサイズ

説明

ヘッダ

4 文字長

“0200” 固定

データ種別

2 文字長

“00” 固定

後続データ長2 文字長”04” 固定

照度値

4 文字長

照度値(レンジ値 + 計測値) （リトルエンディアン形式）

ダミー

4 文字長

”FFFF” 固定

照度値の計算方法は以下の通りです。
1.

エンディアンを治す。

上位バイトと下位バイトが入れ替わっているので、入れ替える。
例） 6F25 → 256F
2.

レンジ値と計測値に分離する。

上位側 1 文字分がレンジ値、残り 3 文字が計測値になります。
例）レンジ値： 2，計測値 ： 56F3.

16 進数から 10 進数に換算する。

例）レンジ値 2，計測値 1391
4.

照度値に換算する。

照度値(lux) = 0.01 × 2 レンジ値 × 計測値例）55.64 = 0.01 × 22 × 1391

 イベント検出データ
設定項目

データサイズ

説明

ヘッダ

4 文字長

“0130” 固定

イベント種別2 文字長“01” 明るくなった検出”02” 暗くなった検出

後続データ長2 文字長”00” 固定54

4章 計測ログフォーマットについて

4-3-3

温湿度センサー 定期計測データ
データ項目

データサイズ

説明

ヘッダ

4 文字長

“0300” 固定

データ種別

2 文字長

“00” 固定

後続データ長2 文字長”04” 固定

温度値

4 文字長

温度値コード

湿度値

4 文字長

湿度値コード各軸の加速データ計算方法は以下の通りです。
1.

エンディアンを治す。

上位バイトと下位バイトが入れ替わっているので、入れ替える。
例） 786C → 6C78
2.

16 進数から 10 進数に換算する。

例）6C78 → 27768
3.

温度・湿度値に換算する。

温度(℃)

=

175.72 × 温度値コード ÷ 65536 - 46.85

湿度(%RH) = 125 × 湿度コード ÷ 65536 - 6

 イベント検出データ
温湿度センサーにはイベントはありません。

55

4章 計測ログフォーマットについて

4-3-4

磁気センサー 定期計測データ
データ項目

データサイズ

説明

ヘッダ

4 文字長

“0400” 固定

データ種別

2 文字長

“00” 固定

後続データ長2 文字長”04” 固定

磁気状態

2 文字長

“00” 検出した ／ ”01” 検出していない

ダミー

6 文字長

”FFFFFF” 固定

データ項目

データサイズ

説明

ヘッダ

4 文字長

“0430” 固定

データ種別

2 文字長

“01” 固定

後続データ長2 文字長”04” 固定

磁気状態

2 文字長

“00” 検出した ／ ”01” 検出していない

ダミー

6 文字長

”FFFFFF” 固定 イベント検出データ

56

サポートのご案内 ご質問・お問い合わせ
本製品に関するご質問やお問い合わせは、弊社サポートセンターへご連絡願います。

サポートセンター● 電話

0587-53-7606● FAX

0587-55-0815● メール

support-suncomm@sun-denshi.co.jp● 受付時間月曜～金曜

10:00～16:00（12:00～13:00 を除く）

祝祭日、弊社休日を除く

おくだけセンサーソリューション
コマンドインタフェース説明書 Ver.1.04
サン電子株式会社
2022 年 3 月 16 日発行（20220316）

Copyright© SUNCORPORATION All rights reserved.

57