Crash_Override/OVMS3-idf
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
OVMS3-idf/docs/Doxyfile

280 lines
12 KiB
Text
Raw Normal View History

Doxygen configuration clean up
2016-11-16 19:27:55 +00:00
# This is Doxygen configuration file
#
# Doxygen provides over 260 configuration statements
esp32: SEGGER SystemView Tracing Support Implements support for system level traces compatible with SEGGER SystemView tool on top of ESP32 application tracing module. That kind of traces can help to analyse program's behaviour. SystemView can show timeline of tasks/ISRs execution, context switches, statistics related to the CPUs' load distribution etc. Also this commit adds useful feature to ESP32 application tracing module: - Trace data buffering is implemented to handle temporary peaks of events load
2017-03-22 03:07:37 +00:00
# To make this file easier to follow,
Doxygen configuration clean up
2016-11-16 19:27:55 +00: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:
Mass replacement of http with https urls, fixed broken urls
2017-09-05 19:58:31 +00:00
# https://www.stack.nl/~dimitri/doxygen/manual/config.html
Doxygen configuration clean up
2016-11-16 19:27:55 +00:00
API template - reflected template in other DRAFT API dcouments - DRAFT of Bluetooth API - link fixes in CONTRIBUTING.rst
2016-10-26 19:08:36 +00:00
PROJECT_NAME = "ESP32 Programming Guide"
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00: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
esp32: SEGGER SystemView Tracing Support Implements support for system level traces compatible with SEGGER SystemView tool on top of ESP32 application tracing module. That kind of traces can help to analyse program's behaviour. SystemView can show timeline of tasks/ISRs execution, context switches, statistics related to the CPUs' load distribution etc. Also this commit adds useful feature to ESP32 application tracing module: - Trace data buffering is implemented to handle temporary peaks of events load
2017-03-22 03:07:37 +00:00
## These files are placed in '_inc' directory
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## and used to include in API reference documentation
INPUT = \
##
## Wi-Fi - API Reference
##
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_wifi.h \
../../components/esp32/include/esp_wifi_types.h \
../../components/esp32/include/esp_smartconfig.h \
../../components/esp32/include/esp_now.h \
add mesh feature
2018-02-27 10:22:20 +00:00
## Mesh - API Reference
../../components/esp32/include/esp_mesh.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Bluetooth - API Reference
## Controller && VHCI
component/bt : modify header files to avoid conflict 1. add the L1 include path with a prefix, such like osi/list.h, stack/a2d_api.h and etc. 2. modify component, only bluedroid/api/include/api is export to another component and application, other include path just for bluedroid used 3. put bluedroid/include into common/include/common, so the root directory of bluedroid have no include path. 4. modify doxygen to use esp_bt.h and redirect to component/bt/bluedroid/api/include/api/ fix compile
2018-04-08 04:10:50 +00:00
../../components/bt/include/esp_bt.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Bluetooth COMMON
## Issue with __attribute__
component/bt : modify header files to avoid conflict 1. add the L1 include path with a prefix, such like osi/list.h, stack/a2d_api.h and etc. 2. modify component, only bluedroid/api/include/api is export to another component and application, other include path just for bluedroid used 3. put bluedroid/include into common/include/common, so the root directory of bluedroid have no include path. 4. modify doxygen to use esp_bt.h and redirect to component/bt/bluedroid/api/include/api/ fix compile
2018-04-08 04:10:50 +00: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 \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Bluetooth LE
component/bt : modify header files to avoid conflict 1. add the L1 include path with a prefix, such like osi/list.h, stack/a2d_api.h and etc. 2. modify component, only bluedroid/api/include/api is export to another component and application, other include path just for bluedroid used 3. put bluedroid/include into common/include/common, so the root directory of bluedroid have no include path. 4. modify doxygen to use esp_bt.h and redirect to component/bt/bluedroid/api/include/api/ fix compile
2018-04-08 04:10:50 +00:00
../../components/bt/bluedroid/api/include/api/esp_gap_ble_api.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Issue with __attribute__
component/bt : modify header files to avoid conflict 1. add the L1 include path with a prefix, such like osi/list.h, stack/a2d_api.h and etc. 2. modify component, only bluedroid/api/include/api is export to another component and application, other include path just for bluedroid used 3. put bluedroid/include into common/include/common, so the root directory of bluedroid have no include path. 4. modify doxygen to use esp_bt.h and redirect to component/bt/bluedroid/api/include/api/ fix compile
2018-04-08 04:10:50 +00: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 \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Bluetooth Classic
component/bt : modify header files to avoid conflict 1. add the L1 include path with a prefix, such like osi/list.h, stack/a2d_api.h and etc. 2. modify component, only bluedroid/api/include/api is export to another component and application, other include path just for bluedroid used 3. put bluedroid/include into common/include/common, so the root directory of bluedroid have no include path. 4. modify doxygen to use esp_bt.h and redirect to component/bt/bluedroid/api/include/api/ fix compile
2018-04-08 04:10:50 +00:00
../../components/bt/bluedroid/api/include/api/esp_gap_bt_api.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Issue with __attribute__
component/bt : modify header files to avoid conflict 1. add the L1 include path with a prefix, such like osi/list.h, stack/a2d_api.h and etc. 2. modify component, only bluedroid/api/include/api is export to another component and application, other include path just for bluedroid used 3. put bluedroid/include into common/include/common, so the root directory of bluedroid have no include path. 4. modify doxygen to use esp_bt.h and redirect to component/bt/bluedroid/api/include/api/ fix compile
2018-04-08 04:10:50 +00: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 \
component/bt: implement HFP Hands Free Unit Role
2018-05-21 03:33:30 +00:00
../../components/bt/bluedroid/api/include/api/esp_hf_defs.h \
../../components/bt/bluedroid/api/include/api/esp_hf_client_api.h \
NimBLE: Port NimBLE stack to IDF Release v3.3 (Backport v3.3) Includes all the latest NimBLE stack changes from idf-v4.0 with few idf-v3.3 specific modifications. - Addition of nimble component as submodule (`nimble-1.1.0-idf-v3.3`), contains IDF v3.3 specific minor changes. - Example applications are identical to idf-v4.0 - Modification in `bt/Kconfig` to accommodate NimBLE as a BT host.
2019-10-18 05:23:24 +00:00
## NimBLE related Bluetooth APIs
../../components/nimble/esp-hci/include/esp_nimble_hci.h \
ble_mesh: Add ESP BLE Mesh implementation 1. BLE Mesh Core * Provisioning: Node Role * PB-ADV and PB-GATT * Authentication OOB * Provisioning: Provisioner Role * PB-ADV and PB-GATT * Authentication OOB * Networking * Relay * Segmentation and Reassembly * Key Refresh * IV Update * Proxy Support * Multiple Client Models Run Simultaneously * Support multiple client models send packets to different nodes simultaneously * No blocking between client model and server * NVS Storage * Store BLE Mesh node related information in flash * Store BLE Mesh Provisioner related information in flash 2. BLE Mesh Models * Foundation Models * Configuration Server Model * Configuration Client Model * Health Server Model * Health Client Model * Generic * Generic OnOff Server * Generic OnOff Client * Generic Level Server * Generic Level Client * Generic Default Transition Time Server * Generic Default Transition Time Client * Generic Power OnOff Server * Generic Power OnOff Setup Server * Generic Power OnOff Client * Generic Power Level Server * Generic Power Level Setup Server * Generic Power Level Client * Generic Battery Server * Generic Battery Client * Generic Location Server * Generic Location Setup Server * Generic Location Client * Generic Admin Property Server * Generic Manufacturer Property Server * Generic User Property Server * Generic Client Property Server * Generic Property Client * Sensor Server Model * Sensor Server * Sensor Setup Server * Sensor Client * Time and Scenes * Time Server * Time Setup Server * Time Client * Scene Server * Scene Setup Server * Scene Client * Scheduler Server * Scheduler Setup Server * Scheduler Client * Lighting * Light Lightness Server * Light Lightness Setup Server * Light Lightness Client * Light CTL Server * Light CTL Setup Server * Light CTL Client * Light CTL Temperature Server * Light HSL Server * Light HSL Setup Server * Light HSL Client * Light HSL Hue Server * Light HSL Saturation Server * Light xyL Server * Light xyL Setup Server * Light xyL Client * Light LC Server * Light LC Setup Server * Light LC Client 3. BLE Mesh Applications * BLE Mesh Node * OnOff Client Example * OnOff Server Example * BLE Mesh Provisioner * Example * Fast Provisioning * Vendor Fast Prov Server Model * Vendor Fast Prov Client Model * Examples * Wi-Fi & BLE Mesh Coexistence * Example * BLE Mesh Console Commands * Examples
2019-11-01 08:08:47 +00:00
## ESP BLE Mesh APIs
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_common_api.h \
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_local_data_operation_api.h \
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_low_power_api.h \
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_networking_api.h \
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_provisioning_api.h \
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_proxy_api.h \
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_config_model_api.h \
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_generic_model_api.h \
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_health_model_api.h \
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_lighting_model_api.h \
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_sensor_model_api.h \
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_time_scene_model_api.h \
../../components/bt/esp_ble_mesh/api/esp_ble_mesh_defs.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
##
## Ethernet - API Reference
##
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00: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 \
ethernet: support new PHY (IP101) 1. Add support for new PHY IP101. 2. Re-enable GPIO0 output mode. 3. Clean up some docs.
2019-01-28 12:29:58 +00:00
../../components/ethernet/include/eth_phy/phy_ip101.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
##
## Peripherals - API Reference
##
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/driver/include/driver/adc.h \
CAN Driver The following commit contains the first version of the ESP32 CAN Driver. closes #544
2017-12-18 12:32:29 +00:00
../../components/driver/include/driver/can.h \
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00: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 \
../../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 \
doc: Rearrange wifi & ethernet docs into a common "network" doc
2018-12-03 07:11:31 +00:00
## tcpip_adapter - API Reference
../../components/tcpip_adapter/include/tcpip_adapter.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
##
## Protocols - API Reference
##
Resolved Issues
2018-02-14 09:45:50 +00:00
## ESP-TLS
../../components/esp-tls/esp_tls.h \
MQTT: Integrate esp-mqtt library into idf added docs and tests for mqtt library, small fixes (removed warnings, option for custom outbox, websocket bug fixed for longer transports). refactored to use common tcp_transport component, support for CMake build system. Closes #2108
2018-07-24 14:59:03 +00:00
## MQTT
../../components/mqtt/esp-mqtt/include/mqtt_client.h \
Http Server : Add a simple light weight HTTP Server Component. Also add examples, docs and test apps for the HTTP Server.
2018-07-03 10:57:41 +00:00
## mDNS
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/mdns/include/mdns.h \
Add esp_http_client Add error handling for http client set ssid password correct with Example_WIFI test, and clear password before free Fixed the CI failure due to HTTP errror names
2017-11-14 03:16:20 +00:00
../../components/esp_http_client/include/esp_http_client.h \
HTTP Server Docs : Replace http_server with esp_http_server
2018-10-24 09:55:04 +00:00
../../components/esp_http_server/include/esp_http_server.h \
esp_https_server : Docs and API references fixed
2018-11-01 12:54:19 +00:00
../../components/esp_https_server/include/esp_https_server.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
##
Docs : Added Provisioning and Protocomm related docs Co-Authored-By: Amey Inamdar <amey@espressif.com> Co-Authored-By: Anurag Kar <anurag.kar@espressif.com>
2018-09-23 14:44:46 +00: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
wifi_provisioning : Docs updated with information about new provisioning manager
2019-04-21 14:53:31 +00: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 \
Docs : Added Provisioning and Protocomm related docs Co-Authored-By: Amey Inamdar <amey@espressif.com> Co-Authored-By: Anurag Kar <anurag.kar@espressif.com>
2018-09-23 14:44:46 +00:00
../../components/wifi_provisioning/include/wifi_provisioning/wifi_config.h \
wifi_provisioning : Added Wi-Fi Scan list feature to Provisioning Manager List of changes in components/wifi_provisioning: * Manager version is now v1.1 * .proto files and protocomm handler added for sending Wi-Fi scan command and receiving scan results * Implemented handlers for wifi_scan protocomm endpoint * Update manager context data structure to hold scan state and results * scheme_softap now runs Wi-Fi in APSTA mode * Wi-Fi is started in AP mode when provisioning is started. This is necessary for scan list to work * Docs updates with information about new wifi_scan endpoint List of changes in tools/esp_prov: * Added functions for sending and receiving protobuf messages compatible with wifi_scan protocomm endpoint * Added feature to display/refresh scan results and accept user selection at runtime * New functions: * get_version() : only returns the protocol version string * has_capability() : check is a capability is present according to proto-ver response * wifi_scan feature is provided only if the `wifi_scan` capability is present Other changes: * Replace recursive mutex with plain mutex * assert on return value of mutex give / take calls * replace all calls with macros ACQUIRE_LOCK and RELEASE_LOCK * some checks added in scanning related private APIs * free and nullify scanning context and state if service is stopped while ongoing scan
2019-04-23 06:48:28 +00:00
../../components/wifi_provisioning/include/wifi_provisioning/wifi_scan.h \
Docs : Added Provisioning and Protocomm related docs Co-Authored-By: Amey Inamdar <amey@espressif.com> Co-Authored-By: Anurag Kar <anurag.kar@espressif.com>
2018-09-23 14:44:46 +00:00
##
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Storage - API Reference
##
## SPI Flash and Partition APIs
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/spi_flash/include/esp_spi_flash.h \
../../components/spi_flash/include/esp_partition.h \
../../components/bootloader_support/include/esp_flash_encrypt.h \
Add SPIFFS Component to IDF
2017-09-07 14:37:59 +00:00
## SPIFFS
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/spiffs/include/esp_spiffs.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## SD/MMC Card Host
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00: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 \
Http Server : Add a simple light weight HTTP Server Component. Also add examples, docs and test apps for the HTTP Server.
2018-07-03 10:57:41 +00:00
## SDIO slave
doc(sdio_slave): documentation for SDIO slave driver
2017-12-04 12:05:09 +00:00
../../components/driver/include/driver/sdio_slave.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Non-Volatile Storage
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/nvs_flash/include/nvs.h \
../../components/nvs_flash/include/nvs_flash.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Virtual Filesystem
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/vfs/include/esp_vfs.h \
../../components/vfs/include/esp_vfs_dev.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## FAT Filesystem
## NOTE: for two lines below header_file.inc is not used
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/fatfs/src/esp_vfs_fat.h \
../../components/fatfs/src/diskio.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Wear Levelling
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/wear_levelling/include/wear_levelling.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
##
## System - API Reference
##
## Memory Allocation #
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00: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 \
Spiram: Add option to reserve MMU banks; add himem API to make use of those banks
2018-06-29 03:05:36 +00:00
## Himem
../../components/esp32/include/esp_himem.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Interrupt Allocation
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_intr_alloc.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Watchdogs
## NOTE: for two lines below header_file.inc is not used
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_int_wdt.h \
../../components/esp32/include/esp_task_wdt.h \
docs/Added documentation about esp32 hooks This commit adds documentation about the esp32 Idle and Tick Hooks
2017-10-17 10:57:31 +00:00
## Hooks
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_freertos_hooks.h \
docs/ipc documentation This commit updates doxygen comments in the IPC header files and adds an rst docs page.
2017-11-22 07:16:29 +00:00
## Inter-Processor Call
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_ipc.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Over The Air Updates (OTA)
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/app_update/include/esp_ota_ops.h \
esp_https_ota: Add support for HTTPS based ota feature
2018-07-12 12:15:44 +00:00
## ESP HTTPS OTA
../../components/esp_https_ota/include/esp_https_ota.h \
sleep: add light sleep, factor out APIs common for deep/light sleep
2017-04-21 04:32:50 +00:00
## Sleep
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_sleep.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Logging
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/log/include/esp_log.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Base MAC address
## NOTE: for line below header_file.inc is not used
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_system.h \
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
##
## ULP Coprocessor - API Guides
##
## NOTE: for line below header_file.inc is not used
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/ulp/include/esp32/ulp.h \
esp32: SEGGER SystemView Tracing Support Implements support for system level traces compatible with SEGGER SystemView tool on top of ESP32 application tracing module. That kind of traces can help to analyse program's behaviour. SystemView can show timeline of tasks/ISRs execution, context switches, statistics related to the CPUs' load distribution etc. Also this commit adds useful feature to ESP32 application tracing module: - Trace data buffering is implemented to handle temporary peaks of events load
2017-03-22 03:07:37 +00:00
##
## Application Level Tracing - API Reference
##
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/app_trace/include/esp_app_trace.h \
docs: add power management API reference
2017-10-09 06:38:41 +00:00
### Power management
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_pm.h \
../../components/esp32/include/esp32/pm.h \
esp_timer: add documentation, expose profiling option in Kconfig
2017-11-24 10:51:37 +00:00
### esp_timer, High Resolution Timer
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00:00
../../components/esp32/include/esp_timer.h \
event: Implement event loop library
2018-10-26 05:14:19 +00:00
### esp_event, Event Loop Library
../../components/esp_event/include/esp_event.h \
../../components/esp_event/include/esp_event_base.h \
docs: Add efuse
2018-11-19 03:41:26 +00:00
### eFuse Manager
../../components/efuse/include/esp_efuse.h \
pthread: Allow configuration of priority and stacksize The expected usage is: esp_pthread_set_cfg(cfg); pthread_create() If the inherit flag is set, then all subsequent threads forked by this thread will also inherit this configuration. This avoids having to change/prefix this for each and every pthread_create() call.
2018-02-25 09:26:04 +00:00
### ESP Pthread parameters
../../components/pthread/include/esp_pthread.h \
docs: add FreeRTOS API docs - Use `code` tags instead of a mix of `<pre></pre>` and `@verbatim .. @endverbatim` - Remove manually added function prototypes from comment blocks - Remove of grouping (`\defgroup`) — some extra work is needed to make groups compatible with the way we auto-generate API reference from Doxygen XML files. It's pretty easy to add the grouping directives back if/when we implement support for Doxygen groups in the later stages of documentation build process. - Hide private APIs under `@cond .. @endcond` - Convert some comments into Doxygen-compatible ones - Fix various documentation issues: missing documentation for some parameters, mismatch between parameter names in comment block and in function prototype. - Add doxygen comments for functions which didn't have them (thread local storage). - Add [out] param tags where necessary - Redefine `xTaskCreate` and `xTaskCreateStatic` as inline functions instead of macros.
2017-12-01 04:50:45 +00:00
###
### FreeRTOS
###
Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version
2018-02-03 21:12:13 +00: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 \
esp_ringbuf: move ringbuf to seperate component Signed-off-by: Mahavir Jain <mahavir@espressif.com>
2018-08-30 10:29:01 +00:00
### Ringbuffer
../../components/esp_ringbuf/include/freertos/ringbuf.h \
docs: add error codes reference
2018-06-13 08:07:26 +00:00
### Helper functions for error codes
docs: add API reference section for esp_system.h
2018-07-30 13:19:20 +00:00
../../components/esp32/include/esp_err.h \
### System APIs
examples: freemodbus port slave basic implementation This example adds functionality to support basic communication in RS485 networks using Modbus protocol. This example uses FreeModbus stack and regular UART driver API to communicate in RS485 half duplex mode. Added initial support of modbus controller pure C api to access device parameters over Modbus transport. Move freemodbus stack and port files into components folder Move the modbus_controller interface into components idf folder Source files updated after review. Add modbus interface documentation docs/en/api-reference/protocols/modbus.rst porttimer.c: fix bug with timer1 selected in the Kconfig Add support of cmake system (added cmake files) Closes https://github.com/espressif/esp-idf/issues/858
2018-06-28 15:45:41 +00:00
../../components/esp32/include/esp_system.h \
### Modbus controller component header file
../../components/freemodbus/modbus_controller/mbcontroller.h
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
esp32: SEGGER SystemView Tracing Support Implements support for system level traces compatible with SEGGER SystemView tool on top of ESP32 application tracing module. That kind of traces can help to analyse program's behaviour. SystemView can show timeline of tasks/ISRs execution, context switches, statistics related to the CPUs' load distribution etc. Also this commit adds useful feature to ESP32 application tracing module: - Trace data buffering is implemented to handle temporary peaks of events load
2017-03-22 03:07:37 +00:00
## Get warnings for functions that have no documentation for their parameters or return value
Doxygen configuration clean up
2016-11-16 19:27:55 +00:00
##
WARN_NO_PARAMDOC = YES
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
## Enable preprocessing and remove __attribute__(...) expressions from the INPUT files
##
ENABLE_PREPROCESSING = YES
MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = YES
docs: add FreeRTOS API docs - Use `code` tags instead of a mix of `<pre></pre>` and `@verbatim .. @endverbatim` - Remove manually added function prototypes from comment blocks - Remove of grouping (`\defgroup`) — some extra work is needed to make groups compatible with the way we auto-generate API reference from Doxygen XML files. It's pretty easy to add the grouping directives back if/when we implement support for Doxygen groups in the later stages of documentation build process. - Hide private APIs under `@cond .. @endcond` - Convert some comments into Doxygen-compatible ones - Fix various documentation issues: missing documentation for some parameters, mismatch between parameter names in comment block and in function prototype. - Add doxygen comments for functions which didn't have them (thread local storage). - Add [out] param tags where necessary - Redefine `xTaskCreate` and `xTaskCreateStatic` as inline functions instead of macros.
2017-12-01 04:50:45 +00:00
PREDEFINED = \
__attribute__(x)= \
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 \
freertos: add configTASKLIST_INCLUDE_COREID
2018-07-09 07:25:59 +00:00
configUSE_APPLICATION_TASK_TAG=1 \
mqtt: referenced esp-mqtt master to fix disconnect issues and updates doxygen macros to have mqtt docs correctly documented Backport of 6289a26596309f3aa4761d383203dfdc74a8eb50
2019-08-23 07:42:15 +00:00
configTASKLIST_INCLUDE_COREID=1 \
"ESP_EVENT_DECLARE_BASE(x)=extern esp_event_base_t x"
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
Doxygen configuration clean up
2016-11-16 19:27:55 +00:00
## Do not complain about not having dot
##
HAVE_DOT = NO
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
Doxygen configuration clean up
2016-11-16 19:27:55 +00:00
## Generate XML that is required for Breathe
##
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
GENERATE_XML = YES
XML_OUTPUT = xml
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
GENERATE_HTML = NO
HAVE_DOT = NO
GENERATE_LATEX = NO
GENERATE_MAN = YES
GENERATE_RTF = NO
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
Doxygen configuration clean up
2016-11-16 19:27:55 +00:00
## Skip distracting progress messages
##
QUIET = YES
## Log warnings in a file for further review
##
API samples - Logging library - Virtual file system component
2016-10-29 21:00:30 +00:00
WARN_LOGFILE = "doxygen-warning-log.txt"
docs: Generate Doxygen directives for API documentation This is to resolve issue reported in https://github.com/espressif/esp-idf/issues/130.
2017-05-02 08:36:01 +00:00
Reference in a new issue Copy permalink