README.md 2.87 KB
Newer Older
1
2
# Aquanaute

3
4
5
Repository to simulate the Aquanaute boat in maritime conditions such as wind and waves and with autopilot provided by ardupilot, using the plugins created for the VRX and VRX-Challenge in Gazebo and ROS and the plugin ardupilot-gazebo.

---
6
7
8
9

## Installation

* Clone this repo to a Catkin Workspace
10

11
12
13
14
* Clone the VRX repo (hosted at ensta) to the same Workspace (<http://git-u2is.ensta.fr/ssh/vrx>) and change to the branch "aquanaute"

### ardupilot parameters

15
16
in the file "vehiculeinfo.py" (/ardupilot/Tools/autotest/pysim) you need to change the default parameters file for the "gazebo-rover" in the line 280 to the aquanaute.parm file provided in /aquanaute/aquanaute_description/ardu_params you can copy and paste the file in the default_params folder located inside (/ardupilot/Tools/autotest).
*There is an error when you launch ardupilot, the motors in the gazebo simulation will start to turn in a fixed direction and wont respond to commands, this issue has not yet been fixed and it's root cause has not yet been found, It's believed that the ardupilot-gazebo plugin doesnt know how to interpret the signals sended by ardupilot*
17
18

---
19
20

## Usage
21

22
### modify wind and waves
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

in the ocean.world.xacro (/vrx_gazebo/worlds) you have

    <!--Waves-->
    <xacro:include filename="$(find wave_gazebo)/world_models/ocean_waves/model.xacro"/>
    <xacro:ocean_waves gain="0.0" period="5" direction_x="-1.0" direction_y="0.0" angle="0.0"/>

    <!--Wind-->
    <xacro:include filename="$(find vrx_gazebo)/worlds/xacros/usv_wind_plugin.xacro"/>
    <xacro:usv_wind_gazebo direction="90" mean_vel="0" var_gain="5" var_time="1">
      <wind_objs>
        <wind_obj>
          <name>wamv</name>
          <link_name>base_link</link_name>
          <coeff_vector>0.5 0.5 0.33</coeff_vector>
        </wind_obj>
      </wind_objs>
    </xacro:usv_wind_gazebo>

It is configured to have no waves and no wind, also the wind and the waves move in the same direction, to activate wind and waves change the "mean_vel" and "gain" parameters respectively (recomended values are smaller than 1.0).  
Even when these values are set to 0, the boat will move from right to left.

---
46
47

### run
48

49
50
51
52
53
54
55
#### compilation

in the workspace run the command at the beginning (and every time you change a parameter in the vrx xacros)

    catkin_make

#### gazebo simulation
56

57
then launch the file you created
58

59
60
    roslaunch aquanaute_gazebo aquanaute.launch testing:=false

61
62
this parameter can be changed to true to deactivate the plugins from vrx (the world will be changed to an empty world without gravity).  
You will have an error "Missing Model.../dock_permutations) this is normal.
63
64

#### ardupilot
65
66
67

on another terminal (inside the ardupilot root) run

68
    ./Tools/autotest/sim_vehicle.py -v APMrover2 -f gazebo-rover --map --console -l 48.71603264538473,2.213283777236939,155,0 
69

70
---
71

72
## Author
73

74
Ricardo RICO URIBE intern at U2IS in the summer of 2020