# Usage

### PCの準備

1. ダウンロードしたアーカイブをわかりやすいフォルダ(例えばC:) に解凍する。
2. 下記WebページよりPCの環境にあったAnacondaをダウンロードし、インストールする。\
   <https://www.anaconda.com/download/>\
   Anacondaをインストールしたくない場合は”Anacondaをインストールしない場合”を参照
3. Anaconda Promptを立ち上げ、下記コマンドを実行しpyserialをインストールする。 (Windowsの場合、Anaconda Promptは スタートメニュー → Anaconda3 内にあるのでそちらから立ち上げること。)

```
> pip install pyserial
```

#### Anacondaをインストールしない場合

下記のインストール手順はOSがWindowsの場合の一例です。 各種ライブラリのドキュメントをご覧の上、必要なソフトウェアおよびライブラリをインストールしてください。

1. &#x20;下記ページよりPythonの最新版をダウンロードしインストールする。\
   <https://www.python.org/downloads/>\
   \
   その時、下図の枠で囲まれている部分にチェックを入れること\
   もしくはPythonのインストール先にPathを通すこと。

   <img src="https://1646086758-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LfZAhb-wdN7QaTpSyZH%2F-LfwolHA2mLWDVOd1ypo%2F-LfwpZMjJy4R8PeBKRDY%2Fgraph_pyIns.png?alt=media&#x26;token=4fc85e06-f28f-49df-a4a2-d22f57e422d0" alt="" data-size="original">
2. コマンドプロンプトを立ち上げ、下記コマンドを入力しpyserialをインストールする。

```
> pip install pyserial
```

### TWELITE PAL の準備

1. BLUE PAL/RED PALにSENSE PALを接続する。
2. BLUE PAL/RED PALの電池ホルダーにコイン型電池(CR2032)を挿入する。

### MONOSTICK の準備

1. MONOSTICKのアプリ（App\_PAL-Parent-xxx-MONOSTICK.bin）を書き換える。
2. MONOSTICKをリセットもしくはUSBポートに差しなおす。

### スクリプトの実行方法

MONOSTICKのCOMポートがCOM6の場合、Anaconda Promptで下記コマンドを実行すると下記のようなデータが出力されます。（Teratermが接続された状態では起動できません。）

```
> cd C:\PAL_Script
> python PAL_Script.py -t COM6
*** MONOWIRELESS App_PAL_Viewer 1.1.0 ***
  *** Open COM6 ***
ArriveTime : 2021/03/05 09:43:28.880
LogicalID : 1
EndDeviceSID : 10B6465
RouterSID : No Relay
LQI : 180 (-35.50 [dBm])
…
```

スクリプトを終了させるにはAnaconda Promptで'Ctrl+C'を入力してください。

### スクリプトの引数

スクリプト実行時に以下の引数を使用できます。

#### 引数：-h

機能：コマンドライン引数の一覧を表示\
使用例：python PAL\_Script.py -h

#### 引数：-t

機能：MONOSTICKが使用するポート名を指定\
設定項目：MONOSTICKのポート名\
初期値：Windowsの場合：COM3、Linuxなどの場合：/dev/ttyUSB0\
使用例：python PAL\_Script.py -t COM6

#### 引数：-b

機能：MONOSTICKが使用するポートのボーレートを指定\
設定項目：MONOSTICKのボーレート\
初期値：115200\
使用例：python PAL\_Script.py -t COM6 -b 115200

#### 引数：-l

機能：CSV形式のログを出力\
使用例：python PAL\_Script.py -t COM6 -l\
備考：同一ディレクトリ内にCSVファイルが生成される。\
ファイル名はAppPAL\_シリアル番号\_PAL\_YYYYMMDD.csv

CSVファイルの読み方は下記表の通りです。

| 見出し                                                    | 値の説明         | 単位  |
| ------------------------------------------------------ | ------------ | --- |
| LogicalID                                              | 子機の論理デバイスID  | -   |
| EndDeviceSID                                           | 子機のシリアルナンバー  | -   |
| LQI                                                    | LQI          | -   |
| Power                                                  | 電源電圧         | mV  |
| ADC\*                                                  | 電圧           | mV  |
| HALLIC                                                 | マグネットセンサーの状態 | -   |
| Temperature                                            | 温度           | ℃   |
| Humidity                                               | 湿度           | %   |
| Illuminance                                            | 照度           | Lux |
| <p>AccelerationX<br>AccelerationY<br>AccelerationZ</p> | 加速度          | g   |