# ととのう宇宙ラウンジ

## 使い方 (iPhoneアプリ)
- 「接続」ボタンを押すと、接続可能なVIEデバイスの一覧が表示されます。接続したいVIEデバイスを選択して接続します。一度接続すると、過去に接続したデバイスに自動で接続します。
- 「切断」ボタンを押すと現在接続しているVIEデバイスとの接続を切断します。正常に動作していないと感じた場合は、一度「切断」ボタンを押して、再度「接続」ボタンを押してVIEデバイスと接続してください。
- 各アイコン、ラベルの意味は以下の通りです。
- 「左耳」 : VIEデバイスの左耳の装着状態を表します。装着しているときは青色になります。
- 「右耳」 : VIEデバイスの右耳の装着状態を表します。装着しているときは青色になります。
- 「ブルートゥース」 : VIEデバイスからデータを受信しているかどうかを表します。受信しているときは青色になります。
- 「イーサネット」 : サーバーと通信しているかを表します。通信している場合は青色になります。
- 「ノイズ」 : サーバーで計算したノイズ値を表示します。小さいほどノイズが入っていないことを表します。目安は100以下となります。
- 「電池」 : VIEデバイスの電池残り残量を表示します。
- 「デバイスID」 : VIEデバイスのIDを表示します。
- アプリケーションを起動すると自動で接続を行うように設定しています。


### 通信先の指定 (iPhoneアプリ)
サーバーと通信する時の設定はiPhoneの「設定」アプリから「ととのう22」アプリを選択して行います。設定を行う項目は以下の通りです。
- oscServerPort : iPhone側のサーバーからデータを受け取るポートを指定します。
- oscClientPort : 送信先のサーバーのポートを指定します。
- oscClientIP : 送信先のサーバーのIPアドレスを指定します。


## トラブルシューティング
問題が発生した場合は、以下の手順でご対応をお願いいたします。
1. 各種デバイスの配線、電源が抜けていないかご確認ください。
2. iPhoneアプリを一度閉じて、再度開いてみてください。
3. 2台あるサーバー(ラズベリーパイ)の電源を一度抜いて、再度さしてみてください。
4. 症状が直らない場合は各種デバイスを交換することで対応をお願いいたします。

### VIEデバイスの交換
VIEデバイスを交換する場合は以下の手順で交換を行なってください。
1. 古いVIEデバイスが接続されているiPhoneの「設定」を開きます。
2. 「Bluetooth」を選択して、「VIE ZONE」を選択します。
3. 古いVIEデバイスの接続を解除します。
4. 古いVIEデバイスの電源を切ります。
5. 新しいVIEデバイスの電源を入れます。
6. 「ととのう22」アプリを立ち上げ、「接続」を選択し、新しいVIEデバイスと接続します。

### iPhoneの交換
新しいiPhoneに交換する手順は以下の通りです。
1. 古いiPhoneとVIEデバイスの接続を解除します。
2. 新しいiPhoneとVIEデバイスを接続します。
3. 「通信先の指定」に記載の通り、IPアドレスとポートの設定を行います。
4. イーサネットケーブルを接続し、「設定」から「Ethernet」を選択します。
5. 古いiPhoneと同じIPアドレスを入力します。
6. 「ととのう22」アプリを立ち上げます。

### サーバー(ラズベリーパイ)の交換
古いサーバーのイーサネットケーブル、電源を抜いて、新しいサーバーに電源とイーサネットケーブルを接続してください。

### アプリの更新
アプリを更新する場合は、一度イーサネットケーブルを抜いてから、「TestFlight」アプリを起動し、「ととのう22」アプリを選択して、アップデートを行なってください。

## 仕様
脳波計測デバイスのシステムは、脳波計測を行うデバイスである「VIEデバイス」、「iPhoneアプリ」、「サーバー」で構成されています。VIEデバイスはブルトゥースで左右の耳から取得した脳波データをiPhoneアプリに送信し、iPhoneアプリは1秒ごとに1秒間に取得した脳波データをまとめて、サーバーへ送信します。サーバーでは4秒間のデータをまとめて、「ととのい具合」を推論します。ととのい具合は0.0から1.0の実数値になります。1.0に近いほどととのっていることを表します。iPhone4台につき、サーバーが1台対応しています。推論した結果はOSCで送信されます。

### OSCの仕様
有線のイーサネットでOSCを用いて通信します。仕様は以下の通りです。

IPアドレス

- 192.168.10.159 : Raspberry Pi 1
- 192.168.10.160 : Raspberry Pi 2
- 192.168.10.151 ~ 192.168.10.158 : iPhone
- 192.168.10.203 : PC (Unity)

ポート

- 12500 ~ 12507 : Raspberry Pi
- 13500 ~ 13507 : iOS
- 8001 : PC (Unity)

OSCアドレス

Address
- /inference [iOS port, left, right, noise, inference]

Values
- iOS port : INT32 (iPhoneのポート番号 デバイスの識別用)
- left : Int32 (左耳 0:非接地 or 1:接地)
- right : Int32 (右耳 0:非接地 or 1:接地)
- noise : INT32 (脳波のノイズ 研究では2程度が閾値、100以下が望ましい)
- inference : FLOAT (ととのい具合の推論値 0.0 ~ 1.0) 大きいほどととのっている