dronecode / camera-manager-docs Goto Github PK

Waiting on: Dronecode/camera-manager#147

https://github.com/Dronecode/csd_docs/blob/master/en/guide/deploying.md#csd-binary-dependencies

Section is currently TBD. Need this information from @lbegani

Should include all dependencies, including realsense, avahi, whatever.

There is proposal to rename CSD. If this happens, need to globally update docs.

A high level document about the MAVLink camera interface.

• This should link to the official docs but not try and reproduce them: https://mavlink.io/en/protocol/camera.html
• Explain that PX4 can integrate with cameras that support the MAVLink camera protocol, and that the CSD implements this protocol for any connected camera (essentially it provides an adaption layer for creating a MAVLink interface)
• Explain the level of support for the API.
• Show message flow at high level for both hardware and simulation case.

As part of the task the MAVLink Protocol document should be moved from the wiki into /docs/en/interface_mavlink_camera_protocol.md.

Migrated from Dronecode/camera-manager#102

Currently we cover how to set up Gazebo/CSD in the Gazebo Quickstart

@lbegani questions for you ....

1. You recently updated Gazebo integration in Add custom parameters for Gazebo camera and provided test instructions:

   1) Start the simulator: make posix gazebo_typhoon_h480
   2) Open QGC 
   3) Select UDP Video Source in General Setting-> Video -> Video Source -> UDP Video Stream. Fill in UDP Port as 5600
   4) Compile the csd with gazebo and mavlink support
       `./autogen.sh && ./configure --enable-gazebo --enable-mavlink`
   5) Host the camera-def-gazebo.xml file in a http server (I have used apache)
          `sudo cp samples/camera-def-gazebo.xml /var/www/html/`
   6) Start the csd
       `./csd -g info -c samples/gazebo.conf`
   7. Select the "Cameras" dropdown in QGC
   8) Change the parameters in QGC and see the value set in the video frames (edited)
   

   • What documentation is required for this - I think just a new step in the gazebo setup stating where you go to find the parameters for the current camera right?

2. There is a new PR in mavlink/qgroundcontrol#6186 - what impact would this have on Docs

3. At top of Gazebo Quickstart it says "Warning These instructions are in progress. At time of writing build without --enable-mavlink and connect on udp port 5600 (RTSP publishing not supported). To be reviewed 9 March 2018."

   • is that all still correct. If not, which parts have changed?

4. Your docs for Gazebo design are here. Is the design/structure useful? If so, can we get this doc updated to reflect how things are now?

Camera Streaming Daemon > Overview

So basically explain how many cameras are supported, and what happens if you attach more. This is covered briefly in the CSD definition file, but belongs at top level too.

See #3

Plan is to move source repo from /intel to /dronecode. When/if this happens need to update all docs to reflect the move.

It looks like the deployed version and this git repository are out of sync. The last deployed update was 2018-06-19, and the latest PR merged on 2018-11-19.

Basically, as I go through the guide I find mistakes, then I want to fix them, just to find out that they are already fixed 😄 .

Dronecode/camera-manager#157 (comment)

Actions:

• UPdate to overview to say that MAVLink video capture is supported
• Addition of vidcap information about config file changes
• Update sample file (@lbegani )

This is waiting on @lbegani for part 3.

The job is to:

• delete the old docs in source repo wiki and source tree
• Update source repo README to point to new docs.

This depends on new docs having "proper" URL (waiting on Anitha).

The docs in Sanity Tests still need to be tested on Gazebo. Waiting on test machine.