doc: add peripheral_types.h as API reference for peripheral docs

Closes DOC-136
Closes IDF-1673

components/soc/include/hal/gpio_types.h

@@ -26,6 +26,8 @@ typedef enum {
     GPIO_PORT_MAX,
 } gpio_port_t;
 
+/** @cond */    //Doxy command to hide preprocessor definitions from docs */
+
 #define GPIO_SEL_0              (BIT(0))                         /*!< Pin 0 selected */
 #define GPIO_SEL_1              (BIT(1))                         /*!< Pin 1 selected */
 #define GPIO_SEL_2              (BIT(2))                         /*!< Pin 2 selected */
@@ -130,6 +132,8 @@ typedef enum {
 #define GPIO_PIN_REG_46          IO_MUX_GPIO46_REG
 #endif
 
+/** @endcond */
+
 typedef enum {
     GPIO_NUM_NC = -1,    /*!< Use to signal not connected to S/W */
     GPIO_NUM_0 = 0,     /*!< GPIO0, input and output */

components/soc/include/hal/spi_types.h

@@ -29,6 +29,8 @@ typedef enum {
 #endif
 } spi_host_device_t;
 
+/** @cond */    //Doxy command to hide preprocessor definitions from docs */
+
 //alias for different chips
 #ifdef CONFIG_IDF_TARGET_ESP32
 #define SPI_HOST    SPI1_HOST
@@ -40,3 +42,5 @@ typedef enum {
 #define HSPI_HOST   SPI3_HOST
 #define VSPI_HOST   SPI4_HOST
 #endif
+
+/** @endcond */

docs/en/api-reference/peripherals/adc.rst

@@ -226,6 +226,8 @@ ADC driver
 
 .. include:: /_build/inc/adc.inc
 
+.. include:: /_build/inc/adc_types.inc
+
 .. _adc-api-reference-adc-calibration:
 
 ADC Calibration

docs/en/api-reference/peripherals/dac.rst

@@ -39,3 +39,4 @@ e.g.
 2. ``DAC_GPIO26_CHANNEL`` is the channel number of GPIO 26 (channel 2).
 
 .. include:: /_build/inc/dac_channel.inc
+.. include:: /_build/inc/dac_types.inc

docs/en/api-reference/peripherals/gpio.rst

@@ -20,9 +20,10 @@ API Reference - Normal GPIO
 ---------------------------
 
 .. include:: /_build/inc/gpio.inc
+.. include:: /_build/inc/gpio_types.inc
 
 API Reference - RTC GPIO
 ------------------------
 
 .. include:: /_build/inc/rtc_io.inc
-
+.. include:: /_build/inc/rtc_io_types.inc

docs/en/api-reference/peripherals/i2c.rst

@@ -250,3 +250,4 @@ API Reference
 -------------
 
 .. include:: /_build/inc/i2c.inc
+.. include:: /_build/inc/i2c_types.inc

docs/en/api-reference/peripherals/i2s.rst

@@ -209,4 +209,5 @@ API Reference
 -------------
 
 .. include:: /_build/inc/i2s.inc
+.. include:: /_build/inc/i2s_types.inc
 

docs/en/api-reference/peripherals/ledc.rst

@@ -174,4 +174,5 @@ API Reference
 -------------
 
 .. include:: /_build/inc/ledc.inc
+.. include:: /_build/inc/ledc_types.inc
 

docs/en/api-reference/peripherals/pcnt.rst

@@ -93,4 +93,5 @@ API Reference
 -------------
 
 .. include:: /_build/inc/pcnt.inc
+.. include:: /_build/inc/pcnt_types.inc
 

docs/en/api-reference/peripherals/rmt.rst

@@ -265,4 +265,5 @@ API Reference
 -------------
 
 .. include:: /_build/inc/rmt.inc
+.. include:: /_build/inc/rmt_types.inc
 

docs/en/api-reference/peripherals/sigmadelta.rst

@@ -30,3 +30,4 @@ API Reference
 -------------
 
 .. include:: /_build/inc/sigmadelta.inc
+.. include:: /_build/inc/sigmadelta_types.inc

docs/en/api-reference/peripherals/timer.rst

@@ -107,3 +107,4 @@ API Reference
 -------------
 
 .. include:: /_build/inc/timer.inc
+.. include:: /_build/inc/timer_types.inc

docs/en/api-reference/peripherals/uart.rst

@@ -380,6 +380,7 @@ API Reference
 -------------
 
 .. include:: /_build/inc/uart.inc
+.. include:: /_build/inc/uart_types.inc
 
 
 GPIO Lookup Macros

docs/zh_CN/api-reference/peripherals/timer.rst

@@ -105,3 +105,4 @@ API 参考
 -------------
 
 .. include:: /_build/inc/timer.inc
+.. include:: /_build/inc/timer_types.inc