ジョイスティックコントローラによる操縦#

無線ジョイスティックコントローラを用いた操縦について紹介する. 本演習では,DualShock 3(PS3コントローラー)やその互換コントローラーを使用してロボットを操作する.

../_images/ps3joy_battery_chargings.jpg

図 68 PS3ジョイスティックのバッテリー充電#

../_images/ps3joy-controllers.jpg

図 69 PS3ジョイスティックコントローラ.真ん中の丸いボタンがPairingボタンである.#

有線接続での動作確認#

Bluetooth接続の前に,まず有線(USB)接続でコントローラーが正常に動作することを確認する. これにより,コントローラー自体の動作確認とROS 2との連携テストを行うことができる.

コントローラーの接続#

図 68のようにDualShockコントローラーをUSBケーブルでPCに接続する.

jstest-gtkでの動作確認#

jstest-gtkを使用してコントローラーのボタンやスティックが正しく認識されているか確認する.

$ sudo apt install jstest-gtk
$ jstest-gtk

jstest-gtkのウィンドウが開くと,図 70のように接続されているコントローラーの一覧が表示される.

../_images/ps3-jstest-gtk-select.jpg

図 70 jstest-gtkの起動画面.接続されているコントローラー一覧が表示される#

コントローラーを選択すると,図 71のような画面が表示される. 各ボタンやスティックを操作すると,画面上で対応する軸やボタンの状態がリアルタイムに更新され,正常に動作していることを確認できる.

../_images/ps3-jstest-gtk.jpg

図 71 jstest-gtkでのコントローラー動作確認画面.ボタンを押したりスティックを倒すと反応が表示される#

ROS 2での動作確認#

teleop_twist_joyパッケージを使用して,コントローラーからの入力がROSトピックとして出力されることを確認する.

$ source ~/ros2_ws/install/setup.bash
$ ros2 launch jedy_bringup joystick_teleop.launch.py

別のターミナルで/joyトピックをモニタする:

$ ros2 topic echo /joy

コントローラーのボタンやスティックを操作すると,sensor_msgs/Joyメッセージが出力される. axes配列にはスティックの値,buttons配列にはボタンの状態(0または1)が格納される.

ロボット操作の確認#

DualShock 3コントローラーでロボットを操作する場合,以下の操作方法となる:

  • L1ボタン(enable button)を押しながら左スティックを操作する

    • 左スティック縦(上下):前進・後退

    • 左スティック横(左右):回転

L1ボタンを押していない状態では,スティックを倒してもロボットは動作しない(安全機構).

../_images/jedy-gazebo-joystick.jpg

図 72 Gazebo上でL1ボタンを押しながら左スティックを倒すとロボットが動作する様子#

図 72は,Gazebo上でコントローラーを使用してロボットを操作している様子を示している. L1ボタンを押しながら左スティックを操作することで,シミュレータ内のロボットを動かすことができる.

メカナムホイールロボットを操作する場合の起動例:

$ source ~/ros2_ws/install/setup.bash
$ ros2 launch jedy_bringup joystick_teleop.launch.py

Bluetooth接続の設定#

有線接続での動作確認が完了したら,Bluetooth接続の設定を行う.

BluetoothデーモンのClassicBondedOnly設定#

DualShock 3コントローラーをBluetooth接続する際,図 73のようなPIN確認画面が表示されることがある. この画面が表示される場合,/etc/bluetooth/input.confClassicBondedOnlyfalseに設定する必要がある.

../_images/ps3-bluetooth-paring-failed.jpg

図 73 Bluetoothペアリング時のPIN確認画面.この画面が表示される場合は設定変更が必要#

$ sudo vim /etc/bluetooth/input.conf
# もしくは
$ sudo emacs -nw /etc/bluetooth/input.conf

以下のように設定する:

[General]
ClassicBondedOnly=false

設定後,Bluetoothサービスを再起動する:

$ sudo systemctl daemon-reload
$ sudo systemctl restart bluetooth

設定内容を確認する:

$ head /etc/bluetooth/input.conf
# Configuration file for the input service

# This section contains options which are not specific to any
# particular interface
[General]

ClassicBondedOnly=false
# Set idle timeout (in minutes) before the connection will
# be disconnect (defaults to 0 for no timeout)
#IdleTimeout=30

Bluetoothが有効になっているかの確認#

ターミナルで以下を実行する:

$ gnome-control-center

「Bluetooth」を選択し,ウィンドウの右上に「ON」と表示されているか確認する. 「OFF」と表示されている場合は,「OFF」の表示をクリックして「ON」に切り替える.

コントローラーのペアリング#

  1. gnome-control-centerのBluetoothウィンドウで,「デバイス」の一覧を確認する

  2. DualShock 3コントローラーのPSボタン(中央のプレステマークのボタン)を長押しして,ペアリングモードにする

  3. USBをPCにさしてコントローラーが検出されたら,図 74のような確認ダイアログが表示される.「Allow」をクリックして接続を許可する

../_images/ps3-bluetooth-paring.jpg

図 74 Bluetooth接続確認ダイアログ.「Allow」をクリックして接続を許可する#

接続が成功すると,コントローラーのLEDが点灯する.

接続確認#

Bluetooth接続後,有線接続時と同様にコントローラーの動作を確認する.

まず,jstest-gtkで無線接続されたコントローラーが認識されているか確認する:

$ jstest-gtk

図 75のように,無線接続されたコントローラーがデバイス一覧に表示されれば,Bluetooth接続が成功している.

../_images/ps3-bluetooth-jstest.jpg

図 75 Bluetooth接続が成功すると,jstest-gtkで無線接続されたコントローラーが認識される#

次に,joy_linuxノードを起動する:

$ ros2 run joy_linux joy_linux_node

以下のようなメッセージが表示され,ジョイスティックが認識されたことが確認できる:

[WARN] [timestamp] [joy_node]: Couldn't open joystick force feedback: Bad file descriptor
[INFO] [timestamp] [joy_node]: Opened joystick: /dev/input/js0. deadzone_: 0.050000.

または,teleop_twist_joyパッケージを使用して確認する:

$ ros2 launch teleop_twist_joy teleop-launch.py joy_config:='ps3'

別のターミナルで/joyトピックを確認:

$ ros2 topic echo /joy

Bluetooth接続でも/joyトピックが正常に出力されれば,設定完了である.

ジョイスティック操縦#

ジョイスティックで台車ロボットを操縦する方法について説明する.

jedy_bringup.launch.pyが起動している状態で,ロボットPCの別のターミナルで以下を実行する:

$ source ~/ros2_ws/install/setup.bash
$ ros2 launch jedy_bringup joystick_teleop.launch.py

/dev/input/js0が見つからず,ジョイスティックが/dev/input/js1として認識されている場合は,以下のように指定する:

$ source ~/ros2_ws/install/setup.bash
$ ros2 launch jedy_bringup joystick_teleop.launch.py joy_dev:=/dev/input/js1

ジョイスティックコントローラのL1を押しながら左ジョイスティックを前後左右にすると,前進後退,旋回を行う.

本プログラムでも,別のターミナルで以下を実行すると,指令速度がトピックとして送られていることが確認できる:

$ ros2 topic echo /cmd_vel

このように,異なる操縦デバイスであっても,共通のトピックを使いロボットの移動行動を実現している.

ジョイスティックのEusLispサンプル#

ジョイスティックに関するトピックである/joyをEusLispでsubscribeするサンプルについて紹介する. これは次回以降の講義で,アームの操縦プログラムを開発する際に必要となる.

ロボットPCのターミナルで以下を実行する:

$ source ~/ros2_ws/install/setup.bash
$ ros2 launch jedy_bringup joystick_teleop.launch.py

別のターミナルで以下を実行する:

$ roscd jedyeus/euslisp
$ roseus joy-sample.l

circle-buttonに応答するサンプルプログラムが起動する.Enterで終了する.

EusLisp REPLで以下のコマンドを実行すると,全ボタンの状態を表示できる:

;; 全ボタンの状態を表示
irteusgl$ (sample-ps3joy)

;; :circle-buttonの他に,ジョイスティック・十字キー・ボタンに対応したメソッド一覧を表示
irteusgl$ (send *joy* :axis-names)
irteusgl$ (send *joy* :button-names)

EusLispでps3joyの値がとれて表示されているのがわかる. あとは,この値をEusLisp上で何らかの処理と対応付ければ,ジョイスティックに応じてロボットが動くプログラムが作れる.

どのボタンの値がとれるかは,(send *joy* :button-names)(send *joy* :axis-names)で調べたり,(sample-ps3joy)関数の出力を見ながら調べるとよい.