bh17xx: minor documentation and formatting updates, added rohm to vendor groups

Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>

doxy/samples.mapping.txt

@@ -3,6 +3,9 @@ a110x.cxx A110X_Example.java a110x.js a110x.py
 a110x-intr.cxx A110X_intr_Example.java a110x-intr.js a110x-intr.py
 adc121c021.cxx ADC121C021_Example.java adc121c021.js adc121c021.py
 adxl345.cxx Adxl345_Example.java adxl345.js adxl345.py
+bh1749.cxx BH1749_Example.java bh1749.js bh1749.py
+bh1750.cxx BH1750_Example.java bh1750.js bh1750.py
+bh1792.cxx BH1792_Example.java bh1792.js bh1792.py
 biss0001.cxx BISS0001_Example.java biss0001.js biss0001.py
 bmpx8x.cxx BMPX8X_Example.java bmpx8x.js bmpx8x.py
 bno055.cxx BNO055_Example.java bno055.js bno055.py

examples/c++/bh1749.cxx

@@ -39,6 +39,7 @@ void signal_int_handler(int signo)
         isStopped = true;
 }
 
+//! [Interesting]
 void PrintData(void *args)
 {
     std::vector<uint16_t> result = dev.GetMeasurements();
@@ -67,3 +68,4 @@ int main(int argc, char **argv)
 
     return 0;
 }
+//! [Interesting]

examples/c++/bh1792.cxx

@@ -37,6 +37,7 @@ void signal_int_handler(int signo)
         isStopped = true;
 }
 
+//! [Interesting]
 void PrintData(void *args)
 {
     std::vector<std::vector<int>> fifo;
@@ -77,3 +78,4 @@ int main(int argc, char **argv)
 
     return 0;
 }
+//! [Interesting]

examples/java/BH1749_Example.java

@@ -25,6 +25,7 @@
 public class BH1749_Example {
 
     public static void main(String[] args) throws InterruptedException {
+    //! [Interesting]
         int sampleCounter = 10;
         long waitTime;
         upm_bh1749.BH1749 bh1749;
@@ -47,5 +48,6 @@ public class BH1749_Example {
 
             Thread.sleep((long) waitTime);
         }
+    //! [Interesting]
     }
 }

examples/java/BH1792_Example.java

@@ -22,6 +22,7 @@
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
 
+//! [Interesting]
 public class BH1792_Example {
 
     public static void main(String[] args) throws InterruptedException {
@@ -65,3 +66,4 @@ class BH1792ISR implements Runnable {
         System.out.println("Timestamp: " + System.nanoTime() + " nsec\n");
     }
 }
+//! [Interesting]

src/bh1749/bh1749.h

@@ -36,19 +36,11 @@ extern "C"
 #include "bh1749_registers.h"
 
 /**
- * @brief C API for the bh1749 color sensor driver
+ * @file bh1749.h
- * @defgroup bh1749 libupm-bh1749
- * @ingroup ROHM i2c color
- */
-/**
  * @library bh1749
- * @sensor bh1749
- * @comname ROHM Color Sensor
- * @type color
- * @man ROHM
- * @con i2c
- *
  * @brief C API for the bh1749 driver
+ *
+ * @include bh1749.c
  */
 
 /**

src/bh1749/bh1749.hpp

@@ -28,19 +28,22 @@
 #include "bh1749.h"
 
 /**
- * @brief C++ API wrapper for the bh1749 color sensor driver
+ * @brief BH1749 Color Sensor
  * @defgroup bh1749 libupm-bh1749
- * @ingroup ROHM i2c color
+ * @ingroup rohm i2c color
  */
+
 /**
  * @library bh1749
  * @sensor bh1749
  * @comname Color Sensor
  * @type color sensor
- * @man ROHM
+ * @man rohm
  * @con i2c
  *
  * @brief C++ API wrapper for the bh1749 driver
+ *
+ * @snippet bh1749.cxx Interesting
  */
 
 namespace upm {

src/bh1750/bh1750.hpp

@@ -36,7 +36,7 @@ namespace upm {
     /**
      * @brief BH1750 Light Sensor
      * @defgroup bh1750 libupm-bh1750
-     * @ingroup dfrobot i2c
+     * @ingroup rohm dfrobot i2c
      */
 
     /**
@@ -44,7 +44,7 @@ namespace upm {
      * @sensor bh1750
      * @comname Digital Light Sensor
      * @type light
-     * @man dfrobot
+     * @man rohm dfrobot
      * @con i2c
      * @web http://www.dfrobot.com/index.php?route=product/product&product_id=531
      *

src/bh1792/bh1792.h

@@ -37,19 +37,11 @@ extern "C"
 #include "bh1792glc_registers.h"
 
 /**
- * @brief C API for the bh1792 Heart Rate sensor driver
+ * @file bh1792.h
- * @defgroup bh1792 libupm-bh1792
- * @ingroup ROHM i2c medical
- */
-/**
  * @library bh1792
- * @sensor bh1792
+ * @brief C API for the bh1792 driver
- * @comname Heart Rate Sensor
- * @type medical
- * @man ROHM
- * @con i2c
  *
- * @brief C API for the bh1792 Heart Rate sensor driver
+ * @include bh1792.c
  */
 
 #define ONE_SEC_IN_MIRCO_SEC 1000000

src/bh1792/bh1792.hpp

@@ -29,19 +29,21 @@
 #include "bh1792.h"
 
 /**
- * @brief C++ API for the bh1792 Heart Rate sensor driver
+ * @brief BH1792 Heart Rate Sensor
  * @defgroup bh1792 libupm-bh1792
- * @ingroup ROHM i2c medical
+ * @ingroup rohm i2c medical
  */
 /**
  * @library bh1792
  * @sensor bh1792
  * @comname Heart Rate Sensor
  * @type medical
- * @man ROHM
+ * @man rohm
  * @con i2c
  *
  * @brief C++ API for the bh1792 driver
+ *
+ * @snippet bh1792.cxx Interesting
  */
 
 namespace upm {

src/groups.md

@@ -422,6 +422,10 @@ and is not meant to be installed anywhere.
 @ingroup byman
 @brief Semtech Corporation
 
+@defgroup rohm ROHM Semiconductor
+@ingroup byman
+@brief ROHM Semiconductor
+
 
 ### Groups for the various Starter Kits ###