Skip to content

Commit 43f5c7d

Browse files
committed
Update Sphinx docs ArduPilot section (Setup and Dev Guide) and increase package.xml version to 0.61.0 [skip ci].
1 parent 7401c1d commit 43f5c7d

File tree

3 files changed

+19
-3
lines changed

3 files changed

+19
-3
lines changed

docs/pages/developer_guide.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -283,7 +283,7 @@ for a custom autopilot setup. Example implementations are provided for PX4 over
283283
the ``misc.autopilot`` ROS parameter and loaded when the :class:`.BaseNode` is initialized.
284284

285285
.. note::
286-
Currently when using :class:`.ArduPilotMAVROS` you need to set the ``misc.static_nadir_facing_camera`` ROS
286+
Currently when using :class:`.ArduPilotMAVROS` you need to set the ``misc.static_camera`` ROS
287287
parameter to ``True`` and the ``map_update.gimbal_projection`` ROS parameter to ``False``, because
288288
:meth:`.ArduPilotMAVROS.gimbal_attitude` and :meth:`.ArduPilotMAVROS.gimbal_set_attitude` are not implemented.
289289
See the ``config/typhoon_h480__ksql_airport_ardupilot.yaml`` file for an example.

docs/pages/setup.rst

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,8 @@ Prerequisites
2121

2222
PX4 Autopilot
2323
===================================================
24-
PX4 **v1.13** is the only autopilot that is currently supported by GISNav.
24+
PX4 **v1.13** is currently supported by GISNav. Earlier versions might work, but the :class:`.MockGPSNode` demo requires
25+
v1.13.
2526

2627
Follow the PX4 instructions to setup your `Ubuntu Development Environment
2728
<https://docs.px4.io/master/en/simulation/ros_interface.html>`_ with `Fast DDS
@@ -242,6 +243,21 @@ ArduPilot SITL simulation environment:
242243
* `Using Gazebo simulator with SITL <https://ardupilot.org/dev/docs/using-gazebo-simulator-with-sitl.html>`_
243244
* `Connecting with ROS <https://ardupilot.org/dev/docs/ros-connecting.html>`_
244245

246+
As of ``gisnav`` v0.61, :class:`.MockGPSNode` can be used in the ArduPilot SITL simulation included in the
247+
`gisnav-docker <https://github.com/hmakelin/gisnav-docker>`_ image. The included ``gazebo-iris`` model only has a static
248+
camera. Because the camera is not stabilized, it likely won't be reliable enough to act as a full replacement for GPS in
249+
ArduPilot's mission mode, while loitering will work. Use the following command to start the ``mock_gps_node`` with the
250+
ArduPilot bridge:
251+
252+
.. code-block:: bash
253+
254+
ros2 run gisnav mock_gps_node --mavros --ros-args --log-level info \
255+
--params-file src/gisnav/config/typhoon_h480__ksql_airport_ardupilot.yaml
256+
257+
258+
.. note::
259+
You may have to enable virtual joystick from QGroundControl settings and have it centered to maintain altitude in
260+
ArduPilot's Loiter mode in the SITL simulation.
245261

246262
.. _QGroundControl:
247263

package.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
33
<package format="3">
44
<name>gisnav</name>
5-
<version>0.60.1</version>
5+
<version>0.61.0</version>
66
<description>Estimates airborne drone global position by matching video to map retrieved from onboard GIS server.</description>
77
<author email="hmakelin@protonmail.com">Harri Makelin</author>
88
<maintainer email="hmakelin@protonmail.com">Harri Makelin</maintainer>

0 commit comments

Comments
 (0)