Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document the export_v4l2_param_xml tool #25

Merged
merged 2 commits into from
Apr 24, 2018
Merged

Document the export_v4l2_param_xml tool #25

merged 2 commits into from
Apr 24, 2018

Conversation

hamishwillee
Copy link
Collaborator

@hamishwillee hamishwillee commented Apr 19, 2018

This adds instructions on how to build and use the tool introduced in Dronecode/camera-manager#147

After this is merged, I hope to link to it from Mavlink: https://mavlink.io/en/protocol/camera_def.html
... though that would be better if a binary release: Dronecode/camera-manager#165

@hamishwillee hamishwillee requested a review from lbegani April 19, 2018 05:43
@hamishwillee
Copy link
Collaborator Author

@lbegani Can you please review this

The *Camera Definition Files* can be hosted anywhere that is accessible to clients (including *QGroundControl* and Dronecode SDK apps). Often the files are served from the computer running CSD.

CSD is able to supply the URIs for attached cameras using a mapping given in the [CSD Configuration File > \[uri section\]](../guide/configuration_file.md#uri).

This topic explains how to:
* Serve the definition files on the CSD companion computer.
* Map attached cameras to their definition file URIs in the CSD configuration file.

> **Tip** Camera definition files for a number of cameras are provided in [/samples/def](https://github.com/intel/camera-streaming-daemon/tree/master/samples/def).
* Create *Camera Definition Files* for attached Video4Linux (V4L2) devices using the *export_v4l2_param_xml* tool.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check if the sentence proposed below sound better

Create Camera Definition Files for attached Video4Linux (V4L2) devices using the export_v4l2_param_xml tool

Create Camera Definition Files for Video4Linux (V4L2) camera devices attached to linux machine using the export_v4l2_param_xml tool

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The fact that it is Linux is implied by the Video4Linux API, and we say "attached". That said, I have improved this a bit:

Additionally, the export_v4l2_param_xml tool can automatically generate definition files for attached Video4Linux (V4L2) camera devices.

## V4L2 Camera Definition File Generator {#export_v4l2_param_xml}

The CSD project includes the *export_v4l2_param_xml* tool to automate creation of *Camera Definition Files* for attached Video4Linux (V4L2) devices.
The tool queries the device for all available settings in order to populate the file.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Replace settings with controls

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK

./export_v4l2_param_xml -d <device node> - f <output camera-def-file-name>
```
where:
* `device node`: The V3L2 device (query available devices on the command line using: `ls -l /dev/video*`).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The V3L2 device

Typo

@hamishwillee
Copy link
Collaborator Author

Thanks @lbegani ! I've fixed the suggestions and will now merge.

@hamishwillee hamishwillee merged commit 0ffa1b1 into Dronecode:master Apr 24, 2018
@hamishwillee hamishwillee deleted the deftool branch April 24, 2018 01:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants