docs: added sensor categories to upm.h

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

Doxyfile.in

@@ -755,7 +755,8 @@ WARN_LOGFILE           =
 # spaces.
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = @CMAKE_CURRENT_SOURCE_DIR@/src \
+INPUT                  = @CMAKE_CURRENT_SOURCE_DIR@/src/upm.h \
+                         @CMAKE_CURRENT_SOURCE_DIR@/src \
                          @CMAKE_CURRENT_SOURCE_DIR@/docs \
                          @CMAKE_CURRENT_SOURCE_DIR@/README.md
 

DoxygenLayout.xml

@@ -6,15 +6,16 @@
     <tab type="pages" visible="yes" title="" intro=""/>
     <tab type="modules" visible="yes" title="UPM libraries" intro="Here is a
     list of UPM libraries that can be used. Note that each of the classes
-    listed in these libraries are completely seperate so you will need to link
-    against all those that you have used in your program"/> <tab
+    listed in these libraries are completely separate so you will need to link
+    against all those that you have used in your program. Use the hierarchical
+    tree to filter between different types of sensors."/> <tab
     type="namespaces" visible="yes" title="">
     <tab type="namespacelist" visible="yes" title="" intro=""/>
     <tab type="namespacemembers" visible="yes" title="" intro=""/>
     </tab>
     <tab type="classes" visible="yes" title="">
     <tab type="classlist" visible="yes" title="" intro=""/>
-    <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/> 
+    <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
     <tab type="hierarchy" visible="yes" title="" intro=""/>
     <tab type="classmembers" visible="yes" title="" intro=""/>
     </tab>
@@ -22,7 +23,7 @@
     <tab type="filelist" visible="yes" title="" intro=""/>
     <tab type="globals" visible="yes" title="" intro=""/>
     </tab>
-    <tab type="examples" visible="yes" title="" intro=""/>  
+    <tab type="examples" visible="yes" title="" intro=""/>
   </navindex>
 
   <!-- Layout definition for a class page -->

src/upm.h

@@ -1,5 +1,6 @@
 /*
  * Author: Brendan Le Foll <brendan.le.foll@intel.com>
+ * Contributions: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
  * Copyright (c) 2014 Intel Corporation.
  *
  * Permission is hereby granted, free of charge, to any person obtaining
@@ -31,27 +32,312 @@
  */
 /// @endcond DEV
 
+////////////////////////////////////////////////////////////////// @cond HEA
+/// Main group place holders.
+////////////////////////////////////////////////////////////////// @endcond HEA
+
+/**
+ * @brief Sensors grouped by category
+ * @defgroup bycat Sensor Categories
+ */
+
+/**
+ * @brief Sensors grouped by connection type
+ * @defgroup bycon Connection Type
+ */
+
+/**
+ * @brief Sensors grouped by manufacturer
+ * @defgroup byman Manufacturer
+ */
+
+/**
+ * @brief Sensors grouped into starter kits
+ * @defgroup bykit Starter Kits
+ */
+
+////////////////////////////////////////////////////////////////// @cond CAT
+/// Groups for the various Sensor Categories.
+////////////////////////////////////////////////////////////////// @endcond CAT
+
+/**
+ * @brief Measure acceleration & tilt or collision detection
+ * @defgroup accelerometer Accelerometer
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Sensors with a variable voltage output
+ * @defgroup ainput Analog Inputs
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure pressure and atmospheric conditions
+ * @defgroup pressure Atmospheric Pressure
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Button, Switch or Toggle
+ * @defgroup button Button
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Light sensors with special function: Color recognition
+ * @defgroup color Color Sensor
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure magnetic field to give rotation or heading
+ * @defgroup compass Compass/Gyro/Magnometers
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Resistive digital to analog converters
+ * @defgroup digipot Digital Potentiometer
+ * @ingroup bycat
+ */
+
+/**
+ * @brief TFT, LCD, LED display elements
+ * @defgroup display Displays
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure electric current
+ * @defgroup electric Electricity
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure bending or detect vibration
+ * @defgroup flex Flex/Force
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure substance concentrations in gases
+ * @defgroup gaseous Gas
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Provide positioning capabilities
+ * @defgroup gps GPS
+ * @ingroup bycat
+ */
+
+/**
+ * @brief LEDs, LED strips, LED matrix displays & controllers
+ * @defgroup led LEDs
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure light intensity or distances
+ * @defgroup light Light/Proximity/IR
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure liquid flow rates or levels
+ * @defgroup liquid Liquid Flow
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Sensors with specific medical application
+ * @defgroup medical Medical
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Various motors & controllers to get things moving
+ * @defgroup motor Motor
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Other types of supported sensors
+ * @defgroup other Other
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Different low and high power relays
+ * @defgroup relay Relay
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Wireless sensors using RFID tags
+ * @defgroup rfid RFID
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Various servo motors & controllers
+ * @defgroup servos Servo
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Provide sound recording or playback
+ * @defgroup sound Sound
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Measure temperature & humidity
+ * @defgroup temp Temperature/Humidity
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Sensors using serial communication
+ * @defgroup serial Serial
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Real time clocks & time measurement
+ * @defgroup time Time
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Capacitive touch sensors
+ * @defgroup touch Touch Sensor
+ * @ingroup bycat
+ */
+
+/**
+ * @brief Provide WiFi, Bluetooth, RF communication
+ * @defgroup wifi Wireless Communication
+ * @ingroup bycat
+ */
+
+////////////////////////////////////////////////////////////////// @cond CON
+/// Groups for the various Connection Types.
+////////////////////////////////////////////////////////////////// @endcond CON
+
 /**
  * @brief Sensors requiring an ADC value to be read
- * @defgroup analog Analog Sensors
+ * @defgroup analog AIO
+ * @ingroup bycon
  */
 
 /**
  * @brief Modules using the i2c bus
- * @defgroup i2c I2c
+ * @defgroup i2c I2C
+ * @ingroup bycon
  */
 
 /**
  * @brief Modules using the SPI bus
  * @defgroup spi SPI
+ * @ingroup bycon
  */
 
 /**
  * @brief Modules using GPIOs directly
  * @defgroup gpio GPIO
+ * @ingroup bycon
  */
 
 /**
  * @brief Modules using a PWM capable GPIO pin
  * @defgroup pwm PWM
+ * @ingroup bycon
+ */
+
+/**
+ * @brief Modules using a PWM capable GPIO pin
+ * @defgroup uart UART
+ * @ingroup bycon
+ */
+
+////////////////////////////////////////////////////////////////// @cond MAN
+/// Groups for the various Manufacturers.
+////////////////////////////////////////////////////////////////// @endcond MAN
+
+/**
+ * @brief Adafruit Industries
+ * @defgroup adafruit Adafruit
+ * @ingroup byman
+ */
+
+/**
+ * @brief Amazon.com
+ * @defgroup amazon Amazon
+ * @ingroup byman
+ */
+
+/**
+ * @brief Banggood.com
+ * @defgroup banggood Banggood
+ * @ingroup byman
+ */
+
+/**
+ * @brief EpicTinker
+ * @defgroup epict EpicTinker
+ * @ingroup byman
+ */
+
+/**
+ * @brief Generic brands
+ * @defgroup generic Generic
+ * @ingroup byman
+ */
+
+/**
+ * @brief Honeywell
+ * @defgroup honeywell Honeywell
+ * @ingroup byman
+ */
+
+/**
+ * @brief Maxim Integrated
+ * @defgroup maxim Maxim Integrated
+ * @ingroup byman
+ */
+
+/**
+ * @brief Newegg.com
+ * @defgroup newegg Newegg
+ * @ingroup byman
+ */
+
+/**
+ * @brief SeeedStudio - Grove
+ * @defgroup seeed SeeedStudio
+ * @ingroup byman
+ */
+
+/**
+ * @brief Sparkfun
+ * @defgroup sparkfun Sparkfun
+ * @ingroup byman
+ */
+
+/**
+ * @brief Texas Instruments
+ * @defgroup ti Texas Instruments
+ * @ingroup byman
+ */
+
+////////////////////////////////////////////////////////////////// @cond KIT
+/// Groups for the various Starter Kits.
+////////////////////////////////////////////////////////////////// @endcond KIT
+
+/**
+ * @brief Grove Starter Kit
+ * @defgroup grovesk Grove Starter Kit
+ * @ingroup bykit
  */