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

Closes DOC-136
Closes IDF-1673
This commit is contained in:
Marius Vikhammer 2020-04-28 10:52:14 +08:00
parent 4a558131ea
commit 27fa1dc0dd
15 changed files with 26 additions and 2 deletions

View file

@ -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 */

View file

@ -27,6 +27,8 @@ typedef enum {
SPI3_HOST=2, ///< SPI3
} 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
@ -38,3 +40,5 @@ typedef enum {
#define FSPI_HOST SPI2_HOST
#define HSPI_HOST SPI3_HOST
#endif
/** @endcond */

View file

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

View file

@ -44,3 +44,4 @@ e.g.
2. ``DAC_{IDF_TARGET_DAC_CH_2}_CHANNEL`` is the channel number of GPIO 26 (channel 2).
.. include-build-file:: inc/dac_channel.inc
.. include-build-file:: inc/dac_types.inc

View file

@ -30,9 +30,12 @@ API Reference - Normal GPIO
---------------------------
.. include-build-file:: inc/gpio.inc
.. include-build-file:: inc/gpio_types.inc
API Reference - RTC GPIO
------------------------
.. include-build-file:: inc/rtc_io.inc
.. include-build-file:: inc/rtc_io_types.inc

View file

@ -104,7 +104,7 @@ The following describes how a command link for a "master write" is set up and wh
1. Create a command link with :cpp:func:`i2c_cmd_link_create`.
Then, populate it with the series of data to be sent to the slave:
a) **Start bit** - :cpp:func:`i2c_master_start`
b) **Slave address** - :cpp:func:`i2c_master_write_byte`. The single byte address is provided as an argument of this function call.
c) **Data** - One or more bytes as an argument of :cpp:func:`i2c_master_write`
@ -249,3 +249,4 @@ API Reference
-------------
.. include-build-file:: inc/i2c.inc
.. include-build-file:: inc/i2c_types.inc

View file

@ -204,7 +204,7 @@ Configuring I2S to use internal DAC for analog output
i2s_driver_install(i2s_num, &i2s_config, 0, NULL); //install and start i2s driver
i2s_set_pin(i2s_num, NULL); //for internal DAC, this will enable both of the internal channels
//You can call i2s_set_dac_mode to set built-in DAC output mode.
//i2s_set_dac_mode(I2S_DAC_CHANNEL_BOTH_EN);
@ -217,4 +217,5 @@ API Reference
-------------
.. include-build-file:: inc/i2s.inc
.. include-build-file:: inc/i2s_types.inc

View file

@ -203,4 +203,5 @@ API Reference
-------------
.. include-build-file:: inc/ledc.inc
.. include-build-file:: inc/ledc_types.inc

View file

@ -98,4 +98,5 @@ API Reference
-------------
.. include-build-file:: inc/pcnt.inc
.. include-build-file:: inc/pcnt_types.inc

View file

@ -296,4 +296,5 @@ API Reference
-------------
.. include-build-file:: inc/rmt.inc
.. include-build-file:: inc/rmt_types.inc

View file

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

View file

@ -108,3 +108,4 @@ API Reference
-------------
.. include-build-file:: inc/timer.inc
.. include-build-file:: inc/timer_types.inc

View file

@ -401,6 +401,7 @@ API Reference
-------------
.. include-build-file:: inc/uart.inc
.. include-build-file:: inc/uart_types.inc
GPIO Lookup Macros

View file

@ -173,4 +173,5 @@ API 参考
-------------
.. include-build-file:: inc/ledc.inc
.. include-build-file:: inc/ledc_types.inc

View file

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