upm  1.3.0
Sensor/Actuator repository for libmraa (v1.7.0)
 All Classes Namespaces Functions Groups Pages
Writing sensor documentation

It is highly encouraged to provide at least some basic documentation for the sensors that you want to add to UPM:

The sensor block

This is added just before the class declaration in your header(.h) file and has mandatory fields. For single sensor libraries, this block will actually follow immediately after the library block. If you have multiple physical sensors, add this to every one. Here's an example (disregard the "@verbatim" tags in your actual code):

```

/**
 * @library <lib-name>
 * @sensor <chip-id>
 * @comname <component-name>
 * @altname <alt-name>
 * @altid <alt-id>
 * @type <component-category>
 * @man <component-manufacturer>
 * @web <component-weblinks>
 * @con <connection-type>
 * @kit <component-kit>
 *
 * @brief Short class/sensor description
 *
 *   Then add a longer
 *   description here.
 *
 * @image html <component-img.jpeg>
 * @snippet <example-name.cxx> Interesting
 */

```

Existing groups that can be used for the manufacturer, connection, category and kit tags are found in the src/groups.md file.

Optionally, a small representative image can be placed in the "docs/images" subfolder and linked with the "@image" tag. Please do not use existing, copyrighted images with your sensors!

The example should have an 'Interesting' section which will be highlighted as a code sample in doxygen. Everything in between such tags will show up in the class documentation when "@snippet" is added at the end of a class docstring. Tags use this format (in "example-name.cxx"):

```

 //! [Interesting]

    ...example code here...

 //! [Interesting]

```

For more examples take a look at the existing headers in our github repository.

The library block

New libraries must have the "@brief", "@defgroup" and "@ingroup" tags in one block. This usually follows the namespace and it is common to have one sensor per library.

You should end up with something like this:

```

/**
 * @brief Short description for entire library
 *
 * Optional longer description.
 *
 * @defgroup <lib-name> libupm-<lib-name>
 * @ingroup <manufacturer> <connection> <category> (<kit>)
 */

```

In "@defgroup" use the same <lib-name> used in the sensor block. Multiple sensors can be added to the same library this way. For "@ingroup" add the same values as in the sensor block for manufacturer, category, connection type and kit. If you have multiple classes or sensors per library, only use the "@ingroup" tags that are common for all of them.