1 # This is Doxygen configuration file
3 # Doxygen provides over 260 configuration statements
4 # To make this file easier to follow,
5 # it contains only statements that are non-default
8 # It is recommended not to change defaults unless specifically required
9 # Test any changes how they affect generated documentation
10 # Make sure that correct warnings are generated to flag issues with documented code
12 # For the complete list of configuration statements see:
13 # http://www.stack.nl/~dimitri/doxygen/manual/config.html
16 PROJECT_NAME = "ESP32 Programming Guide"
18 ## The 'INPUT' statement below is used as input by script 'gen-df-input.py'
19 ## to automatically generate API reference list files heder_file.inc
20 ## These files are placed in '_inc' directory
21 ## and used to include in API reference documentation
25 ## Wi-Fi - API Reference
27 ../components/esp32/include/esp_wifi.h \
28 ../components/esp32/include/esp_smartconfig.h \
29 ## Bluetooth - API Reference
31 ../components/bt/include/bt.h \
33 ## Issue with __attribute__
34 ../components/bt/bluedroid/api/include/esp_bt_defs.h \
35 ../components/bt/bluedroid/api/include/esp_bt_main.h \
36 ../components/bt/bluedroid/api/include/esp_bt_device.h \
38 ../components/bt/bluedroid/api/include/esp_gap_ble_api.h \
39 ## Issue with __attribute__
40 ../components/bt/bluedroid/api/include/esp_gatt_defs.h \
41 ../components/bt/bluedroid/api/include/esp_gatts_api.h \
42 ../components/bt/bluedroid/api/include/esp_gattc_api.h \
43 ../components/bt/bluedroid/api/include/esp_blufi_api.h \
45 ../components/bt/bluedroid/api/include/esp_gap_bt_api.h \
46 ## Issue with __attribute__
47 ../components/bt/bluedroid/api/include/esp_a2dp_api.h \
48 ../components/bt/bluedroid/api/include/esp_avrc_api.h \
50 ## Ethernet - API Reference
52 ../components/ethernet/include/esp_eth.h \
53 ../components/ethernet/include/eth_phy/phy.h \
54 ../components/ethernet/include/eth_phy/phy_tlk110.h \
55 ../components/ethernet/include/eth_phy/phy_lan8720.h \
57 ## Peripherals - API Reference
59 ../components/driver/include/driver/adc.h \
60 ../components/driver/include/driver/dac.h \
61 ../components/driver/include/driver/gpio.h \
62 ../components/driver/include/driver/rtc_io.h \
63 ../components/driver/include/driver/i2c.h \
64 ../components/driver/include/driver/i2s.h \
65 ../components/driver/include/driver/ledc.h \
66 ../components/driver/include/driver/mcpwm.h \
67 ../components/driver/include/driver/pcnt.h \
68 ../components/driver/include/driver/rmt.h \
69 ../components/driver/include/driver/sigmadelta.h \
70 ../components/driver/include/driver/spi_common.h \
71 ../components/driver/include/driver/spi_master.h \
72 ../components/driver/include/driver/spi_slave.h \
73 ../components/driver/include/driver/timer.h \
74 ../components/driver/include/driver/uart.h \
76 ## Protocols - API Reference
78 ../components/mdns/include/mdns.h \
80 ## Storage - API Reference
82 ## SPI Flash and Partition APIs
83 ../components/spi_flash/include/esp_spi_flash.h \
84 ../components/spi_flash/include/esp_partition.h \
85 ../components/bootloader_support/include/esp_flash_encrypt.h \
87 ## NOTE: for three lines below header_file.inc is not used
88 ../components/sdmmc/include/sdmmc_cmd.h \
89 ../components/driver/include/driver/sdmmc_host.h \
90 ../components/driver/include/driver/sdmmc_types.h \
91 ## Non-Volatile Storage
92 ../components/nvs_flash/include/nvs.h \
93 ../components/nvs_flash/include/nvs_flash.h \
95 ../components/vfs/include/esp_vfs.h \
96 ../components/vfs/include/esp_vfs_dev.h \
98 ## NOTE: for two lines below header_file.inc is not used
99 ../components/fatfs/src/esp_vfs_fat.h \
100 ../components/fatfs/src/diskio.h \
102 ../components/wear_levelling/include/wear_levelling.h \
104 ## System - API Reference
106 ## Memory Allocation #
107 ../components/heap/include/esp_heap_caps.h \
108 ../components/heap/include/multi_heap.h \
109 ## Interrupt Allocation
110 ../components/esp32/include/esp_intr_alloc.h \
112 ## NOTE: for two lines below header_file.inc is not used
113 ../components/esp32/include/esp_int_wdt.h \
114 ../components/esp32/include/esp_task_wdt.h \
115 ## Over The Air Updates (OTA)
116 ../components/app_update/include/esp_ota_ops.h \
118 ## NOTE: for line below header_file.inc is not used
119 ../components/esp32/include/esp_deep_sleep.h \
121 ../components/log/include/esp_log.h \
123 ## NOTE: for line below header_file.inc is not used
124 ../components/esp32/include/esp_system.h \
126 ## ULP Coprocessor - API Guides
128 ## NOTE: for line below header_file.inc is not used
129 ../components/ulp/include/esp32/ulp.h \
131 ## Application Level Tracing - API Reference
133 ../components/app_trace/include/esp_app_trace.h
136 ## Get warnings for functions that have no documentation for their parameters or return value
138 WARN_NO_PARAMDOC = YES
140 ## Enable preprocessing and remove __attribute__(...) expressions from the INPUT files
142 ENABLE_PREPROCESSING = YES
143 MACRO_EXPANSION = YES
144 EXPAND_ONLY_PREDEF = YES
145 PREDEFINED = __attribute__(x)=
147 ## Do not complain about not having dot
151 ## Generate XML that is required for Breathe
162 ## Skip distracting progress messages
165 ## Log warnings in a file for further review
167 WARN_LOGFILE = "doxygen-warning-log.txt"