driver: indent #define macro and add comments to them

Author: baptleduc

drivers/ads1115/include/ads1115_params.h

@@ -30,51 +30,73 @@ extern "C" {
  * @name    Set default configuration parameters for the ADS1115 driver
  * @{
  */
+
+/* Default I2C bus */
 #ifndef ADS1115_PARAM_I2C
-#define ADS1115_PARAM_I2C        (I2C_DEV(0))
+#  define ADS1115_PARAM_I2C      (I2C_DEV(0))
 #endif
+
+/* Default I2C address */
 #ifndef ADS1115_PARAM_ADDR
-#define ADS1115_PARAM_ADDR       (0x48)
+#  define ADS1115_PARAM_ADDR     (0x48)
 #endif
+
+/* Default multiplexer configuration */
 #ifndef ADS1115_PARAM_MUX
-#define ADS1115_PARAM_MUX        (ADS1115_MUX_AIN0_AIN1)
+#  define ADS1115_PARAM_MUX      (ADS1115_MUX_AIN0_AIN1)
 #endif
+
+/* Default programmable gain amplifier configuration */
 #ifndef ADS1115_PARAM_PGA
-#define ADS1115_PARAM_PGA        (ADS1115_PGA_2_048V)
+#  define ADS1115_PARAM_PGA      (ADS1115_PGA_2_048V)
 #endif
+
+/* Default device mode */
 #ifndef ADS1115_PARAM_MODE
-#define ADS1115_PARAM_MODE       (ADS1115_MODE_SINGLE)
+#  define ADS1115_PARAM_MODE     (ADS1115_MODE_SINGLE)
 #endif
+
+/* Default data rate configuration */
 #ifndef ADS1115_PARAM_DR
-#define ADS1115_PARAM_DR         (ADS1115_DR_128)
+#  define ADS1115_PARAM_DR       (ADS1115_DR_128)
 #endif
+
+/* Default comparator mode */
 #ifndef ADS1115_PARAM_COMP_MODE
-#define ADS1115_PARAM_COMP_MODE  (ADS1115_COMP_MODE_TRADITIONAL)
+#  define ADS1115_PARAM_COMP_MODE  (ADS1115_COMP_MODE_TRADITIONAL)
 #endif
+
+/* Default comparator polarity */
 #ifndef ADS1115_PARAM_COMP_POLARITY
-#define ADS1115_PARAM_COMP_POLARITY (ADS1115_COMP_POLARITY_LOW)
+#  define ADS1115_PARAM_COMP_POLARITY (ADS1115_COMP_POLARITY_LOW)
 #endif
+
+/* Default comparator latch */
 #ifndef ADS1115_PARAM_COMP_LATCH
-#define ADS1115_PARAM_COMP_LATCH (ADS1115_COMP_LATCH_DISABLE)
+#  define ADS1115_PARAM_COMP_LATCH (ADS1115_COMP_LATCH_DISABLE)
 #endif
+
+/* Default comparator queue */
 #ifndef ADS1115_PARAM_COMP_QUEUE
-#define ADS1115_PARAM_COMP_QUEUE (ADS1115_COMP_QUEUE_DISABLE)
+#  define ADS1115_PARAM_COMP_QUEUE (ADS1115_COMP_QUEUE_DISABLE)
 #endif
 
+/* Default parameters structure */
 #ifndef ADS1115_PARAMS
-#define ADS1115_PARAMS          { \
-            .i2c = ADS1115_PARAM_I2C, \
-            .addr = ADS1115_PARAM_ADDR, \
-            .mux = ADS1115_PARAM_MUX, \
-            .pga = ADS1115_PARAM_PGA, \
-            .mode = ADS1115_PARAM_MODE, \
-            .dr = ADS1115_PARAM_DR, \
-            .comp_mode = ADS1115_PARAM_COMP_MODE, \
-            .comp_polarity = ADS1115_PARAM_COMP_POLARITY, \
-            .comp_latch = ADS1115_PARAM_COMP_LATCH, \
-            .comp_queue = ADS1115_PARAM_COMP_QUEUE \
+#  define ADS1115_PARAMS          { \
+    .i2c = ADS1115_PARAM_I2C, \
+    .addr = ADS1115_PARAM_ADDR, \
+    .mux = ADS1115_PARAM_MUX, \
+    .pga = ADS1115_PARAM_PGA, \
+    .mode = ADS1115_PARAM_MODE, \
+    .dr = ADS1115_PARAM_DR, \
+    .comp_mode = ADS1115_PARAM_COMP_MODE, \
+    .comp_polarity = ADS1115_PARAM_COMP_POLARITY, \
+    .comp_latch = ADS1115_PARAM_COMP_LATCH, \
+    .comp_queue = ADS1115_PARAM_COMP_QUEUE \
 }
 #endif
+/** @} */
 
 static const ads1115_params_t ads1115_params[] = {
     ADS1115_PARAMS