diff --git a/common/source/docs/common-blueos-opticalflow.rst b/common/source/docs/common-blueos-opticalflow.rst new file mode 100644 index 0000000000..a85d5ec55f --- /dev/null +++ b/common/source/docs/common-blueos-opticalflow.rst @@ -0,0 +1,65 @@ +.. _common-blueos-opticalflow: + +============================ +BlueOS OpticalFlow Extension +============================ + +[copywiki destination="copter,plane,rover"] + +`BlueOS's Optical Flow Extension `__ allows a downward facing camera gimbal to be used as an optical flow sensor to improve performance in non-GPS environments. + +.. youtube:: ir7LfSYoNMc + :width: 100% + +.. note:: + + Support for this extension was added in ArduPilot-4.7 + +Hardware Required +----------------- + +Please see :ref:`ArduPilot's BlueOS installation instructions ` which also includes hardware recommendations. + +Any :ref:`supported camera gimbal ` with ethernet connectivity should work including the :ref:`Siyi `, :ref:`ViewPro ` and :ref:`XFRobot ` camera gimbals. + +The camera gimbal should be mounted on the underside of the vehicle and optical flow will only operate when the camera gimbal is pointing downwards. + +A :ref:`rangefinder ` with at least a few meters of range is also required. + +BlueOS Extension Installation +----------------------------- + +Once BlueOS has been :ref:`installed ` on the companion computer: + +- Ensure the companion computer is connected to the internet +- From the left menu, select "Extensions" +- Search for "opticalflow" and push the "GET" and "INSTALL" buttons + +.. image:: ../../../images/blueos-opticalflow-install.png + :target: ../_images/blueos-opticalflow-install.png + :width: 450px + +- From the left menu, select "OpticalFlow" +- Select the "Camera Type" being used +- Adjust the RTSP URL if not using the camera gimbal's default IP address or RTSP stream +- "Flight Controller SysID" should match the vehicle's :ref:`MAV_SYSID ` parameter (normally 1) +- Optionally adjust the Horizontal FOV to match the camera gimbal's lens + +.. image:: ../../../images/blueos-opticalflow-extension.png + :target: ../_images/blueos-opticalflow-extension.png + :width: 450px + +AutoPilot Configuration and Calibration +--------------------------------------- + +- Set :ref:`FLOW_TYPE ` = 5 (MAVLink) and reboot the autopilot +- Set :ref:`FLOW_OPTIONS ` = 1 (Roll/Pitch stabilised) +- Set :ref:`EK3_FLOW_DELAY ` = 150 (ms) +- Optionally set :ref:`EK3_OPTIONS ` = 4 (Optflow may use terrain alt) to allow optical flow to be used beyond the rangefinder's maximum range +- The "Inflight Calibration" and "Log based Calibration" methods described in the :ref:`Optical Flow Sensor Testing and Setup ` will not work for stabilised camera gimbals. Instead the Extension's "Horizontal FOV" field can be adjusted if the vehicle's estimated position on the map (when using optical flow) significantly overshoots or undershoots the actual distance moved. +- Performance can be improved by setting the :ref:`sensors position parameters `. For example if the camera gimbal is mounted 2cm forward and 5cm below the frame's center of rotation set :ref:`FLOW_POS_X ` to 0.02 and :ref:`FLOW_POS_Z ` to 0.05. + +Testing and Setup +----------------- + +See :ref:`common-optical-flow-sensor-setup` diff --git a/common/source/docs/common-hereflow.rst b/common/source/docs/common-hereflow.rst index ec6fe00a6a..9b7295575b 100644 --- a/common/source/docs/common-hereflow.rst +++ b/common/source/docs/common-hereflow.rst @@ -1,12 +1,12 @@ .. _common-hereflow: -================================ -Hex HereFlow Optical Flow Sensor -================================ +====================================== +CubePilot HereFlow Optical Flow Sensor +====================================== [copywiki destination="copter,plane,rover"] -The `HereFlow optical flow sensor `__ is a lightweight optical flow sensor including a short range lidar which uses the CAN protocol to communicate with the autopilot. This can be used to improve horizontal position control especially in GPS denied environments. +The `HereFlow optical flow sensor `__ is a lightweight optical flow sensor including a short range lidar which uses the CAN protocol to communicate with the autopilot. This can be used to improve horizontal position control especially in GPS denied environments. .. youtube:: MKJB_7cA_0s :width: 100% @@ -18,7 +18,7 @@ The `HereFlow optical flow sensor `__ +The sensor is available from `CubePilot resellers `__ Connection to Autopilot ----------------------- diff --git a/common/source/docs/common-optical-flow-sensors-landingpage.rst b/common/source/docs/common-optical-flow-sensors-landingpage.rst index 751962b91d..db689f6cc0 100644 --- a/common/source/docs/common-optical-flow-sensors-landingpage.rst +++ b/common/source/docs/common-optical-flow-sensors-landingpage.rst @@ -16,6 +16,7 @@ Select the links below for information on the available sensors. Optical Flow Setup ARK Flow ARK Flow MR + BlueOS OpticalFlow Cheerson CX-OF HereFlow Holybro H-Flow diff --git a/images/blueos-opticalflow-extension.png b/images/blueos-opticalflow-extension.png new file mode 100644 index 0000000000..64d6a69c87 Binary files /dev/null and b/images/blueos-opticalflow-extension.png differ diff --git a/images/blueos-opticalflow-install.png b/images/blueos-opticalflow-install.png new file mode 100644 index 0000000000..a744fb2a10 Binary files /dev/null and b/images/blueos-opticalflow-install.png differ