raspimouse_navigation

Nav2パッケージを使用してRaspberry Pi Mouseを自律移動させるパッケージです。

Table of Contents

• raspimouse_navigation
  • Table of Contents
  • Navigation
    • Setup
      • Using Raspberry Pi Mouse
      • Using Gazebo
    • Launching Navigation
      • Using Raspberry Pi Mouse
      • Using Gazebo
    • Running Navigation
  • Parameters

Navigation

<img src=https://rt-net.github.io/images/raspberry-pi-mouse/navigation_ros2_with_raspimouse_model.png width=500 />

[!NOTE] 　サンプルの実行には、Raspberry Pi MouseとRemote PCが同じネットワーク上で同じROS_DOMAIN_IDを指定している必要があります。

Setup

Using Raspberry Pi Mouse

Raspberry Pi Mouse上で、次のコマンドを実行します。Raspberry Pi MouseのモータとLiDARを制御するためのノードを起動します。

# RPLIDAR A1の場合
ros2 launch raspimouse_navigation robot_navigation.launch.py lidar:=rplidar
# LDS-01の場合
ros2 launch raspimouse_navigation robot_navigation.launch.py lidar:=lds
# URG-04LX-UG01の場合
ros2 launch raspimouse_navigation robot_navigation.launch.py lidar:=urg lidar_port:=/dev/ttyACM0

Using Gazebo

以下のコマンドを実行し、Gazebo上でRaspberry Pi Mouseを起動します。Gazebo上での実行には、raspimouse_simパッケージのインストールが必要です。

# RPLIDAR A1の場合
ros2 launch raspimouse_gazebo raspimouse_with_lakehouse.launch.py lidar:=rplidar
# LDS-01の場合
ros2 launch raspimouse_gazebo raspimouse_with_lakehouse.launch.py lidar:=lds
# URG-04LX-UG01の場合
ros2 launch raspimouse_gazebo raspimouse_with_lakehouse.launch.py lidar:=urg

Launching Navigation

自己位置推定と経路生成用のノードを起動し、RVizを立ち上げます。 引数のmapパラメータには、SLAMで生成した地図（.yamlファイル）を指定してください。

Using Raspberry Pi Mouse

Remote PC上で、次のコマンドを実行します。

ros2 launch raspimouse_navigation pc_navigation.launch.py map:=$HOME/MAP_NAME.yaml

Using Gazebo

Gazebo上のRaspberry Pi Mouseに対して実行する場合はuse_sim_time:=trueオプションを指定します。

ros2 launch raspimouse_navigation pc_navigation.launch.py map:=$HOME/MAP_NAME.yaml use_sim_time:=true 

Running Navigation

RVizが起動したら、初期位置・姿勢を合わせます。RVizの画面上部の2D Pose Estimateをクリックします。

地図上でRaspberry Pi Mouseが存在すべき尤もらしい位置をクリックし、そのままホールドします。

ホールドしながらカーソルを動かし、表示されている矢印の向きをRaspberry Pi Mouseの尤もらしい向きに合わせてからボタンを離します。

<img src=https://rt-net.github.io/images/raspberry-pi-mouse/navigation_ros2_setting_initialpose.gif width=500 />

初期位置・姿勢の指示が完了したら、次は目標位置・姿勢を指示します。RVizの画面上部のNavigation2 Goalをクリックします。

地図上で、初期位置・姿勢を合わせた時と同様に、地図上をクリックして目標位置を、ホールドしたままカーソルを動かして目標姿勢を指示します。目標姿勢の指示が完了すると、Raspberry Pi Mouseが自律移動を開始します。

<img src=https://rt-net.github.io/images/raspberry-pi-mouse/navigation_ros2_setting_goalpose.gif width=500 />

Stopping the robot

下記画像のようなナビゲーション用のパネルがRViz左下に表示されます。 Cancelボタンを押すと自律移動が中断されます。

<img src=https://rt-net.github.io/images/raspberry-pi-mouse/navigation_ros2_rviz_panel.png width=300 />

Raspberry Pi Mouseを停止させる別の方法として、モータへの電源供給を止める方法もあります。

次のコマンドを実行すると、ソフトウェア側からモータ電源をON / OFFできます。

File truncated at 100 lines see the full file

Changelog for package raspimouse_navigation

3.0.0 (2024-11-28)

• Support ROS 2 Jazzy (#13)
• Added the setting [enable_stamped_cmd_vel: True]{.title-ref} to standardize the velocity to [TwistStamped]{.title-ref} from [Twist]{.title-ref}
• Modified the [use_sim_time]{.title-ref} setting in [collision_monitor]{.title-ref} to be [True]{.title-ref} during simulations and [False]{.title-ref} during real-world operations
• Changed to provide [use_sim_time]{.title-ref} from the launch command
• Removed the descriptions for [default_nav_to_pose_bt_xml]{.title-ref} and [default_nav_through_poses_bt_xml]{.title-ref}, changing to automatically load the default settings
• Contributors: Kazushi Kurasawa, YusukeKato

2.1.0 (2024-03-05)

• Use rplidar_a1_launch.py because rplidar.launch.py does not exist. (#8)
• Contributors: Shota Aoki

2.0.0 (2023-08-04)

• Humble対応 (#6)
• Contributors: Shuhei Kozasa

1.0.0 (2022-07-29)

• DWB:Criticsのパラメータを調整
• AMCL:回転のノイズを調整
• DWB: 走行速度を小さくした
• AMCL: 回転のノイズパラメータを小さくした
• DWBにゴール判定のプラグインを追加
• DWBの走行速度パラメータをラズパイマウスに合わせて調整
• AMCLのパラメータに仮の初期位置・姿勢を設定
• コストマップのパラメータを調整
• 1m四方のフィールドで自己位置推定ができるように、AMCLのパラメータを調整した
• footprintをラズパイマウスとケーブルの形状に合わせて長方形に変更
• Change the raspimouse node activation method
• Save the map file to the home directory and use the absolute path to the map file
• Adds raspimouse_description as a dependent pacakgae
• Update launch file so that it brings up the node for RPLIDAR
• Removes arguments and replaces with LaunchConfigurationEquals
• Adds lifecycle sequence
• Adds joint_state_publisher node
• Add navigation launch file for Robot
• Add navigation launch file for PC
• Adds README for navigation package
• Creates raspimouse_navigation package
• Contributors: Shota Aoki, Shuhei Kozasa