2016-11-16 14:27:55 -05:00
|
|
|
# This is Doxygen configuration file
|
|
|
|
#
|
|
|
|
# Doxygen provides over 260 configuration statements
|
2017-03-21 23:07:37 -04:00
|
|
|
# To make this file easier to follow,
|
2016-11-16 14:27:55 -05:00
|
|
|
# it contains only statements that are non-default
|
|
|
|
#
|
|
|
|
# NOTE:
|
|
|
|
# It is recommended not to change defaults unless specifically required
|
|
|
|
# Test any changes how they affect generated documentation
|
|
|
|
# Make sure that correct warnings are generated to flag issues with documented code
|
|
|
|
#
|
|
|
|
# For the complete list of configuration statements see:
|
2017-09-05 15:58:31 -04:00
|
|
|
# https://www.stack.nl/~dimitri/doxygen/manual/config.html
|
2016-11-16 14:27:55 -05:00
|
|
|
|
|
|
|
|
2016-10-26 15:08:36 -04:00
|
|
|
PROJECT_NAME = "ESP32 Programming Guide"
|
2016-10-29 17:00:30 -04:00
|
|
|
|
2017-05-02 04:36:01 -04:00
|
|
|
## The 'INPUT' statement below is used as input by script 'gen-df-input.py'
|
|
|
|
## to automatically generate API reference list files heder_file.inc
|
2017-03-21 23:07:37 -04:00
|
|
|
## These files are placed in '_inc' directory
|
2017-05-02 04:36:01 -04:00
|
|
|
## and used to include in API reference documentation
|
|
|
|
|
|
|
|
INPUT = \
|
|
|
|
##
|
|
|
|
## Wi-Fi - API Reference
|
|
|
|
##
|
2019-03-22 02:21:15 -04:00
|
|
|
../../components/esp_wifi/include/esp_wifi.h \
|
|
|
|
../../components/esp_wifi/include/esp_wifi_types.h \
|
|
|
|
../../components/esp_wifi/include/esp_smartconfig.h \
|
|
|
|
../../components/esp_wifi/include/esp_now.h \
|
2018-02-27 05:22:20 -05:00
|
|
|
## Mesh - API Reference
|
2019-03-22 02:21:15 -04:00
|
|
|
../../components/esp_wifi/include/esp_mesh.h \
|
2018-11-21 02:56:06 -05:00
|
|
|
## Event loop - API Reference
|
|
|
|
../../components/esp_event/include/esp_event.h \
|
|
|
|
../../components/esp_event/include/esp_event_base.h \
|
|
|
|
../../components/esp_event/include/esp_event_legacy.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Bluetooth - API Reference
|
|
|
|
## Controller && VHCI
|
2018-04-08 00:10:50 -04:00
|
|
|
../../components/bt/include/esp_bt.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Bluetooth COMMON
|
|
|
|
## Issue with __attribute__
|
2018-04-08 00:10:50 -04:00
|
|
|
../../components/bt/bluedroid/api/include/api/esp_bt_defs.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_bt_main.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_bt_device.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Bluetooth LE
|
2018-04-08 00:10:50 -04:00
|
|
|
../../components/bt/bluedroid/api/include/api/esp_gap_ble_api.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Issue with __attribute__
|
2018-04-08 00:10:50 -04:00
|
|
|
../../components/bt/bluedroid/api/include/api/esp_gatt_defs.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_gatts_api.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_gattc_api.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_blufi_api.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Bluetooth Classic
|
2018-04-08 00:10:50 -04:00
|
|
|
../../components/bt/bluedroid/api/include/api/esp_gap_bt_api.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Issue with __attribute__
|
2018-04-08 00:10:50 -04:00
|
|
|
../../components/bt/bluedroid/api/include/api/esp_a2dp_api.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_avrc_api.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_spp_api.h \
|
2018-05-20 23:33:30 -04:00
|
|
|
../../components/bt/bluedroid/api/include/api/esp_hf_defs.h \
|
|
|
|
../../components/bt/bluedroid/api/include/api/esp_hf_client_api.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
##
|
|
|
|
## Ethernet - API Reference
|
|
|
|
##
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/ethernet/include/esp_eth.h \
|
|
|
|
../../components/ethernet/include/eth_phy/phy.h \
|
|
|
|
../../components/ethernet/include/eth_phy/phy_tlk110.h \
|
|
|
|
../../components/ethernet/include/eth_phy/phy_lan8720.h \
|
2019-01-28 07:29:58 -05:00
|
|
|
../../components/ethernet/include/eth_phy/phy_ip101.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
##
|
|
|
|
## Peripherals - API Reference
|
|
|
|
##
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/driver/include/driver/adc.h \
|
2017-12-18 07:32:29 -05:00
|
|
|
../../components/driver/include/driver/can.h \
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/driver/include/driver/dac.h \
|
|
|
|
../../components/driver/include/driver/gpio.h \
|
|
|
|
../../components/driver/include/driver/rtc_io.h \
|
|
|
|
../../components/driver/include/driver/i2c.h \
|
|
|
|
../../components/driver/include/driver/i2s.h \
|
|
|
|
../../components/driver/include/driver/ledc.h \
|
|
|
|
../../components/driver/include/driver/mcpwm.h \
|
|
|
|
../../components/driver/include/driver/pcnt.h \
|
|
|
|
../../components/driver/include/driver/rmt.h \
|
|
|
|
../../components/driver/include/driver/sigmadelta.h \
|
|
|
|
../../components/driver/include/driver/spi_common.h \
|
|
|
|
../../components/driver/include/driver/spi_master.h \
|
|
|
|
../../components/driver/include/driver/spi_slave.h \
|
|
|
|
../../components/driver/include/driver/timer.h \
|
|
|
|
../../components/driver/include/driver/touch_pad.h \
|
|
|
|
../../components/driver/include/driver/uart.h \
|
|
|
|
../../components/esp_adc_cal/include/esp_adc_cal.h \
|
2019-06-13 02:12:54 -04:00
|
|
|
../../components/soc/include/hal/spi_types.h \
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/soc/esp32/include/soc/adc_channel.h \
|
|
|
|
../../components/soc/esp32/include/soc/dac_channel.h \
|
|
|
|
../../components/soc/esp32/include/soc/touch_channel.h \
|
|
|
|
../../components/soc/esp32/include/soc/uart_channel.h \
|
|
|
|
../../components/soc/esp32/include/soc/rtc_gpio_channel.h \
|
2018-12-03 02:11:31 -05:00
|
|
|
## tcpip_adapter - API Reference
|
|
|
|
../../components/tcpip_adapter/include/tcpip_adapter.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
##
|
|
|
|
## Protocols - API Reference
|
|
|
|
##
|
2018-02-14 04:45:50 -05:00
|
|
|
## ESP-TLS
|
|
|
|
../../components/esp-tls/esp_tls.h \
|
2018-07-24 10:59:03 -04:00
|
|
|
## MQTT
|
|
|
|
../../components/mqtt/esp-mqtt/include/mqtt_client.h \
|
2018-07-03 06:57:41 -04:00
|
|
|
## mDNS
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/mdns/include/mdns.h \
|
2017-11-13 22:16:20 -05:00
|
|
|
../../components/esp_http_client/include/esp_http_client.h \
|
2019-06-20 03:37:40 -04:00
|
|
|
../../components/esp_websocket_client/include/esp_websocket_client.h \
|
2018-10-24 05:55:04 -04:00
|
|
|
../../components/esp_http_server/include/esp_http_server.h \
|
2018-11-01 08:54:19 -04:00
|
|
|
../../components/esp_https_server/include/esp_https_server.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
##
|
2018-09-23 10:44:46 -04:00
|
|
|
## Provisioning - API Reference
|
|
|
|
##
|
|
|
|
## Protocol Communication
|
|
|
|
../../components/protocomm/include/common/protocomm.h \
|
|
|
|
../../components/protocomm/include/security/protocomm_security.h \
|
|
|
|
../../components/protocomm/include/security/protocomm_security0.h \
|
|
|
|
../../components/protocomm/include/security/protocomm_security1.h \
|
|
|
|
../../components/protocomm/include/transports/protocomm_ble.h \
|
|
|
|
../../components/protocomm/include/transports/protocomm_console.h \
|
|
|
|
../../components/protocomm/include/transports/protocomm_httpd.h \
|
|
|
|
## WiFi Provisioning
|
2019-04-21 10:53:31 -04:00
|
|
|
../../components/wifi_provisioning/include/wifi_provisioning/manager.h \
|
|
|
|
../../components/wifi_provisioning/include/wifi_provisioning/scheme_ble.h \
|
|
|
|
../../components/wifi_provisioning/include/wifi_provisioning/scheme_softap.h \
|
|
|
|
../../components/wifi_provisioning/include/wifi_provisioning/scheme_console.h \
|
2018-09-23 10:44:46 -04:00
|
|
|
../../components/wifi_provisioning/include/wifi_provisioning/wifi_config.h \
|
|
|
|
##
|
2017-05-02 04:36:01 -04:00
|
|
|
## Storage - API Reference
|
|
|
|
##
|
|
|
|
## SPI Flash and Partition APIs
|
2019-06-19 08:35:55 -04:00
|
|
|
../../components/spi_flash/include/esp_flash.h \
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/spi_flash/include/esp_partition.h \
|
|
|
|
../../components/bootloader_support/include/esp_flash_encrypt.h \
|
2019-06-19 08:35:55 -04:00
|
|
|
../../components/soc/include/hal/spi_flash_types.h \
|
2017-09-07 10:37:59 -04:00
|
|
|
## SPIFFS
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/spiffs/include/esp_spiffs.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## SD/MMC Card Host
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/sdmmc/include/sdmmc_cmd.h \
|
|
|
|
../../components/driver/include/driver/sdmmc_host.h \
|
|
|
|
../../components/driver/include/driver/sdmmc_types.h \
|
|
|
|
../../components/driver/include/driver/sdspi_host.h \
|
2018-07-03 06:57:41 -04:00
|
|
|
## SDIO slave
|
2017-12-04 07:05:09 -05:00
|
|
|
../../components/driver/include/driver/sdio_slave.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Non-Volatile Storage
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/nvs_flash/include/nvs.h \
|
|
|
|
../../components/nvs_flash/include/nvs_flash.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Virtual Filesystem
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/vfs/include/esp_vfs.h \
|
|
|
|
../../components/vfs/include/esp_vfs_dev.h \
|
2019-02-19 14:50:18 -05:00
|
|
|
../../components/vfs/include/esp_vfs_semihost.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## FAT Filesystem
|
|
|
|
## NOTE: for two lines below header_file.inc is not used
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/fatfs/src/esp_vfs_fat.h \
|
|
|
|
../../components/fatfs/src/diskio.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Wear Levelling
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/wear_levelling/include/wear_levelling.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
##
|
|
|
|
## System - API Reference
|
|
|
|
##
|
|
|
|
## Memory Allocation #
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/heap/include/esp_heap_caps.h \
|
|
|
|
../../components/heap/include/esp_heap_trace.h \
|
|
|
|
../../components/heap/include/esp_heap_caps_init.h \
|
|
|
|
../../components/heap/include/multi_heap.h \
|
2018-06-28 23:05:36 -04:00
|
|
|
## Himem
|
2019-03-18 03:46:15 -04:00
|
|
|
../../components/esp32/include/esp32/himem.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Interrupt Allocation
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/esp32/include/esp_intr_alloc.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Watchdogs
|
|
|
|
## NOTE: for two lines below header_file.inc is not used
|
2019-03-15 05:44:27 -04:00
|
|
|
../../components/esp_common/include/esp_int_wdt.h \
|
|
|
|
../../components/esp_common/include/esp_task_wdt.h \
|
2017-10-17 06:57:31 -04:00
|
|
|
## Hooks
|
2019-03-26 04:30:43 -04:00
|
|
|
../../components/esp_common/include/esp_freertos_hooks.h \
|
2017-11-22 02:16:29 -05:00
|
|
|
## Inter-Processor Call
|
2019-03-26 04:30:43 -04:00
|
|
|
../../components/esp_common/include/esp_ipc.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Over The Air Updates (OTA)
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/app_update/include/esp_ota_ops.h \
|
2018-07-12 08:15:44 -04:00
|
|
|
## ESP HTTPS OTA
|
|
|
|
../../components/esp_https_ota/include/esp_https_ota.h \
|
2017-04-21 00:32:50 -04:00
|
|
|
## Sleep
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/esp32/include/esp_sleep.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Logging
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/log/include/esp_log.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
## Base MAC address
|
|
|
|
## NOTE: for line below header_file.inc is not used
|
2019-03-15 05:44:27 -04:00
|
|
|
../../components/esp_common/include/esp_system.h \
|
2019-03-22 00:40:12 -04:00
|
|
|
## IDF version
|
|
|
|
../../components/esp_common/include/esp_idf_version.h \
|
2017-05-02 04:36:01 -04:00
|
|
|
##
|
|
|
|
## ULP Coprocessor - API Guides
|
|
|
|
##
|
|
|
|
## NOTE: for line below header_file.inc is not used
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/ulp/include/esp32/ulp.h \
|
2017-03-21 23:07:37 -04:00
|
|
|
##
|
|
|
|
## Application Level Tracing - API Reference
|
|
|
|
##
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/app_trace/include/esp_app_trace.h \
|
2018-12-12 10:57:55 -05:00
|
|
|
../../components/app_trace/include/esp_sysview_trace.h \
|
2017-10-09 02:38:41 -04:00
|
|
|
### Power management
|
2019-03-15 05:44:27 -04:00
|
|
|
../../components/esp_common/include/esp_pm.h \
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/esp32/include/esp32/pm.h \
|
2017-11-24 05:51:37 -05:00
|
|
|
### esp_timer, High Resolution Timer
|
2019-03-15 05:44:27 -04:00
|
|
|
../../components/esp_common/include/esp_timer.h \
|
2018-10-26 01:14:19 -04:00
|
|
|
### esp_event, Event Loop Library
|
|
|
|
../../components/esp_event/include/esp_event.h \
|
|
|
|
../../components/esp_event/include/esp_event_base.h \
|
2018-11-18 22:41:26 -05:00
|
|
|
### eFuse Manager
|
|
|
|
../../components/efuse/include/esp_efuse.h \
|
2018-02-25 04:26:04 -05:00
|
|
|
### ESP Pthread parameters
|
|
|
|
../../components/pthread/include/esp_pthread.h \
|
2017-11-30 23:50:45 -05:00
|
|
|
###
|
|
|
|
### FreeRTOS
|
|
|
|
###
|
2018-02-03 16:12:13 -05:00
|
|
|
../../components/freertos/include/freertos/task.h \
|
|
|
|
../../components/freertos/include/freertos/queue.h \
|
|
|
|
../../components/freertos/include/freertos/semphr.h \
|
|
|
|
../../components/freertos/include/freertos/timers.h \
|
|
|
|
../../components/freertos/include/freertos/event_groups.h \
|
2018-08-30 06:29:01 -04:00
|
|
|
### Ringbuffer
|
|
|
|
../../components/esp_ringbuf/include/freertos/ringbuf.h \
|
2018-06-13 04:07:26 -04:00
|
|
|
### Helper functions for error codes
|
2019-03-15 05:44:27 -04:00
|
|
|
../../components/esp_common/include/esp_err.h \
|
2018-07-30 09:19:20 -04:00
|
|
|
### System APIs
|
2019-03-15 05:44:27 -04:00
|
|
|
../../components/esp_common/include/esp_system.h \
|
2018-06-28 11:45:41 -04:00
|
|
|
### Modbus controller component header file
|
2018-10-19 09:51:27 -04:00
|
|
|
../../components/freemodbus/common/include/esp_modbus_common.h \
|
|
|
|
../../components/freemodbus/common/include/esp_modbus_slave.h \
|
|
|
|
../../components/freemodbus/common/include/esp_modbus_master.h
|
|
|
|
|
2016-10-29 17:00:30 -04:00
|
|
|
|
2017-03-21 23:07:37 -04:00
|
|
|
## Get warnings for functions that have no documentation for their parameters or return value
|
2016-11-16 14:27:55 -05:00
|
|
|
##
|
|
|
|
WARN_NO_PARAMDOC = YES
|
2016-10-29 17:00:30 -04:00
|
|
|
|
2017-05-02 04:36:01 -04:00
|
|
|
## Enable preprocessing and remove __attribute__(...) expressions from the INPUT files
|
|
|
|
##
|
|
|
|
ENABLE_PREPROCESSING = YES
|
|
|
|
MACRO_EXPANSION = YES
|
|
|
|
EXPAND_ONLY_PREDEF = YES
|
2017-11-30 23:50:45 -05:00
|
|
|
PREDEFINED = \
|
|
|
|
__attribute__(x)= \
|
2019-04-17 02:31:07 -04:00
|
|
|
IDF_DEPRECATED(X)= \
|
2017-11-30 23:50:45 -05:00
|
|
|
IRAM_ATTR= \
|
|
|
|
configSUPPORT_DYNAMIC_ALLOCATION=1 \
|
|
|
|
configSUPPORT_STATIC_ALLOCATION=1 \
|
|
|
|
configQUEUE_REGISTRY_SIZE=1 \
|
|
|
|
configUSE_RECURSIVE_MUTEXES=1 \
|
|
|
|
configTHREAD_LOCAL_STORAGE_DELETE_CALLBACKS=1 \
|
|
|
|
configNUM_THREAD_LOCAL_STORAGE_POINTERS=1 \
|
2018-07-09 03:25:59 -04:00
|
|
|
configUSE_APPLICATION_TASK_TAG=1 \
|
2018-11-21 02:56:06 -05:00
|
|
|
configTASKLIST_INCLUDE_COREID=1 \
|
|
|
|
"ESP_EVENT_DECLARE_BASE(x)=extern esp_event_base_t x"
|
2017-05-02 04:36:01 -04:00
|
|
|
|
2016-11-16 14:27:55 -05:00
|
|
|
## Do not complain about not having dot
|
|
|
|
##
|
|
|
|
HAVE_DOT = NO
|
2016-10-29 17:00:30 -04:00
|
|
|
|
2016-11-16 14:27:55 -05:00
|
|
|
## Generate XML that is required for Breathe
|
|
|
|
##
|
2017-05-02 04:36:01 -04:00
|
|
|
GENERATE_XML = YES
|
|
|
|
XML_OUTPUT = xml
|
2016-10-29 17:00:30 -04:00
|
|
|
|
2017-05-02 04:36:01 -04:00
|
|
|
GENERATE_HTML = NO
|
|
|
|
HAVE_DOT = NO
|
|
|
|
GENERATE_LATEX = NO
|
|
|
|
GENERATE_MAN = YES
|
|
|
|
GENERATE_RTF = NO
|
2016-10-29 17:00:30 -04:00
|
|
|
|
2016-11-16 14:27:55 -05:00
|
|
|
## Skip distracting progress messages
|
|
|
|
##
|
|
|
|
QUIET = YES
|
|
|
|
## Log warnings in a file for further review
|
|
|
|
##
|
2016-10-29 17:00:30 -04:00
|
|
|
WARN_LOGFILE = "doxygen-warning-log.txt"
|
2017-05-02 04:36:01 -04:00
|
|
|
|