7.1. DUALSHOCK®を使った操縦#

HSRはDUALSHOCK®3またはDUALSHOCK®4を用いた操作が可能です。ここでは、その操作方法について説明します。

7.1.1. DUALSHOCK®3の接続#

DUALSHOCK®3では、有線接続と無線接続が可能です。

7.1.1.1. DUALSHOCK®3への切り替え#

以下の手順でDUALSHOCK®3に変更できます。

シミュレータを起動している場合は、「Ctrl」+「C」を押し、シミュレータを停止してください。
以下を実行し、環境変数を設定してください。
```
$ export USE_DUALSHOCK4=false
```
必要に応じた環境のシミュレータを起動してください。

7.1.1.2. 有線接続#

有線での接続方法と切断方法を説明します。

7.1.1.2.1. 接続方法#

開発PCのUSBポートへDUALSHOCK®3を接続します。

DUALSHOCK®3をUSBポートに接続後、下図の「PS」ボタンを押してください。

7.1.1.2.2. 切断方法#

切断するには、DUALSHOCK®3のUSBケーブルをUSBポートから抜いてください。 DUALSHOCK®3の上部の赤いランプが消灯すれば切断が確認できます。

7.1.1.3. 無線接続#

無線接続に必要な事前準備および無線での接続方法と切断方法を説明します。

7.1.1.3.1. 事前準備#

初回のみ行う設定
1. 以下を実行し、必要なパッケージをインストールしてください。
```
$ sudo apt update
$ sudo apt install -y bluetooth bluez bluez-tools
```
2. 開発PCの /etc/bluetooth/input.conf の ClassicBondedOnly を false にしてください。
```
ClassicBondedOnly=false
```
起動のたびに行う確認

開発PCのBluetoothが無効化されていると無線接続できないため、再起動するたびにBluetoothの状態を確認する必要があります。ここでは確認方法と有効化手順を説明します。
- 確認方法
  
  以下を実行し、Bluetoothの状態を確認してください。
```
$ rfkill list
0: hci0: Bluetooth
  Soft blocked: no
  Hard blocked: no
```
  Soft blocked と Hard blocked が両方とも「no」の場合、Bluetoothは有効です。いずれか一方でも「yes」の場合は Bluetooth が無効化されているため、以下の有効化手順を実施してください。
- 有効化手順
  
  以下を実行し、Bluetoothの有効化と再起動を行ってください。
```
$ sudo rfkill unblock bluetooth
$ sudo systemctl restart bluetooth
```
  以下を実行し、Bluetoothの状態を確認してください。
```
$ rfkill list
```
  いずれか一方が「yes」で、Bluetoothがうまく起動しない場合は、以下を実行してください。
```
$ sudo hciconfig hci0 up piscan
$ sudo hciconfig hci0
```
  UP という表示が確認できれば、Bluetoothが起動しています。

7.1.1.3.2. 接続方法#

以下を実行し、 bluetoothctl を起動してください。
```
$ bluetoothctl
```
起動すると以下のようなコンソールが表示されます。このコンソールにコマンドを入力して、Bluetoothを操作します。
```
[bluetooth]#
```
抜けるには「Ctrl」+「D」を押してください。

以下を実行し、Bluetoothを起動してください。

[bluetooth]# agent on
[bluetooth]# default-agent
[bluetooth]# power on

開発PCのUSBポートへDUALSHOCK®3を接続してください。

bluetoothctl に Yes/No の確認メッセージが表示されたら、 Yes と入力してください。
DUALSHOCK®3のUSBケーブルをUSBポートから抜いて「PS」ボタンを押すと、 DUALSHOCK®3の赤いランプが1つ点灯することを確認してください。赤いランプが点灯すれば接続に成功しています。

7.1.1.3.3. 切断方法#

接続を切断する際は、以下のいずれかを実施してください。

DUALSHOCK®3の「PS」ボタンを10秒程度長押ししてください。
bluetoothctl で以下を実行してください。
```
[bluetooth]# disconnect
```
または、 bluetoothctl に入っていない状態で以下を実行してください。
```
$ bluetoothctl disconnect
```

DUALSHOCK®3の上部の赤いランプが消灯すれば切断が確認できます。

7.1.2. DUALSHOCK®4の接続#

DUALSHOCK®4では、有線接続と無線接続が可能です。

7.1.2.1. DUALSHOCK®4への切り替え#

以下の手順でDUALSHOCK®4に変更できます。

シミュレータを起動している場合は「Ctrl」+「C」を押し、シミュレータを停止してください。
以下を実行し、環境変数を設定してください。
```
$ export USE_DUALSHOCK4=true
```
必要に応じた環境のシミュレータを起動してください。

7.1.2.2. 有線接続#

有線での接続方法と切断方法を説明します。

7.1.2.2.1. 接続方法#

開発PCのUSBポートへDUALSHOCK®4を接続します。

DUALSHOCK®4をUSBポートに接続後、下図の「PS」ボタンを押してください。

7.1.2.2.2. 切断方法#

切断するには、DUALSHOCK®4のUSBケーブルをUSBポートから抜いてください。 DUALSHOCK®4の上部のライトバーが消灯すれば切断が確認できます。

7.1.2.3. 無線接続#

無線接続に必要な事前準備および無線での接続方法と切断方法を説明します。

7.1.2.3.1. 事前準備#

「DUALSHOCK®3の接続」の事前準備を参照し、Bluetoothの準備を行ってください。

7.1.2.3.2. 接続方法#

DUALSHOCK®4はDUALSHOCK®3と異なり、初回設定を行うことでペアリング情報を保持でき、容易に無線接続できるようになります。

以下の手順ではまず初回の接続設定を実施します。

初回の接続設定（ペアリング）
1. 以下を実行し、 bluetoothctl を起動してください。
```
$ bluetoothctl
```
  起動すると以下のようなコンソールが表示されます。このコンソールにコマンドを入力して、Bluetoothを操作します。
```
[bluetooth]#
```
  抜けるには「Ctrl」+「D」を押してください。
2. 以下を実行し、Bluetoothを起動してください。
```
[bluetooth]# agent on
[bluetooth]# default-agent
[bluetooth]# power on
```
3. DUALSHOCK®4の「SHARE」ボタンと「PS」ボタンを同時に長押しすると、 DUALSHOCK®4の上部のライトバーが白く2回ずつ点滅することを確認してください。
4. bluetoothctl で以下を実行し、DUALSHOCK®4のデバイス名(Wireless Controller)を確認してください。
```
[bluetooth]# scan on
```
  DUALSHOCK®4のデバイス名が表示されたら、以下を実行してください。
```
[bluetooth]# scan off
```
5. 以下を実行し、DUALSHOCK®4のアドレス番号を確認してください。以下の場合、アドレス番号は A4:AE:11:20:39:F1 です。
```
[bluetooth]# devices
Device A4:AE:11:20:39:F1 Wireless Controller
```
6. 以下を実行し、ペアリングを行ってください。なお、 <Address> にはDUALSHOCK®4のアドレス番号を入力してください。
```
[bluetooth]# pair <Address>
```
  bluetoothctl に Yes/No の確認メッセージが表示されたら、 Yes と入力してください。 DUALSHOCK®4の上部のライトバーが青く点灯すれば接続に成功しています。
7. 以下を実行し、次回起動時に接続できるようにしてください。なお、 <Address> には上記で入力したアドレス番号を入力してください。
```
[bluetooth]# trust <Address>
```
2回目以降の接続
1. 以下を実行し、Bluetoothを起動してください。
```
$ bluetoothctl power on
```
2. DUALSHOCK®4の「PS」ボタンを押してください。 DUALSHOCK®4の上部のライトバーが青く点灯すれば接続に成功しています。