OVMS3-idf/docs/en/api-reference/system/index.rst

System API
**********

.. toctree::
   :maxdepth: 1

   FreeRTOS <freertos>
   FreeRTOS Additions <freertos_additions>
   Heap Memory Allocation <mem_alloc>
   Heap Memory Debugging <heap_debug>
   Himem (large external SPI RAM) API <himem>
   Interrupt Allocation <intr_alloc>
   Watchdogs <wdts>
   eFuse Manager <efuse>
   Inter-Processor Call <ipc>
   High Resolution Timer <esp_timer>
   Logging <log>
   Event Loop Library <esp_event>
   Application Level Tracing <app_trace>
   Power Management <power_management>
   Sleep Modes <sleep_modes>
   Over The Air Updates (OTA) <ota>
   ESP HTTPS OTA <esp_https_ota>
   ESP pthread <esp_pthread>
   Error Codes and Helper Functions <esp_err>
   App image format <app_image_format>
   Miscellaneous System APIs <system>


Code examples for this API section are provided in the :example:`system` directory of ESP-IDF examples.
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`System API`
			`**********`

			`.. toctree::`
			`:maxdepth: 1`

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 <freertos>`
freeRTOS/Re-factor ring buffers This fixes multiple bugs with ring buffers and re-factors the code. The public API has not changed, however the underlying implementation have various private functions have been changed. The following behavioral changes have been made - Size of ring buffers for No-Split/Allow-Split buffers will not be rounded up to the nearest 32-bit aligned size. This was done to simplify the implementation - Item size for No-Split/Allow-Split buffers will also be rounded up to the nearest 32-bit aligned size. The following bugs have been fixed - In copyItemToRingbufAllowSplit(), when copying an item where the aligned size is smaller than the remaining length, the function does not consider the case where the true size of the item is less than 4 bytes. - The copy functions will automatically wrap around the write pointers when the remaining length of the buffer is not large enough to fit a header, but does not consider if wrapping around will cause an overlap with the read pointer. This will make a full buffer be mistaken for an empty buffer closes #1711 - xRingbufferSend() can get stuck in a infinite loop when the size of the free memory is larger than the needed_size, but too small to fit in the ring buffer due to alignment and extra overhead of wrapping around. closes #1846 - Fixed documentation with ring buffer queue set API - Adding and removing from queue set does not consider the case where the read/write semaphores actually hold a value. The following functions have been deprecated - xRingbufferIsNextItemWrapped() due to lack of thread safety - xRingbufferAddToQueueSetWrite() and xRingbufferRemoveFromQueueSetWrite() as adding the queue sets only work under receive operations. The following functions have been added - xRingbufferReceiveSplit() and xRingbufferReceiveSplitFromISR() as a thread safe way to receive from allow-split buffers - vRingbufferGetInfo() Documentation for ring buffers has also been added. 2018-04-18 17:20:34 +00:00			`FreeRTOS Additions <freertos_additions>`
doc: Add docs for heap trace & poisoning 2017-07-18 23:07:17 +00:00			`Heap Memory Allocation <mem_alloc>`
			`Heap Memory Debugging <heap_debug>`
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 (large external SPI RAM) API <himem>`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Interrupt Allocation <intr_alloc>`
			`Watchdogs <wdts>`
docs: Add efuse 2018-11-19 03:41:26 +00:00			`eFuse Manager <efuse>`
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 <ipc>`
esp_timer: add documentation, expose profiling option in Kconfig 2017-11-24 10:51:37 +00:00			`High Resolution Timer <esp_timer>`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Logging <log>`
event: Implement event loop library 2018-10-26 05:14:19 +00:00			`Event Loop Library <esp_event>`
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 <app_trace>`
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			`Power Management <power_management>`
			`Sleep Modes <sleep_modes>`
			`Over The Air Updates (OTA) <ota>`
esp_https_ota: Add support for HTTPS based ota feature 2018-07-12 12:15:44 +00:00			`ESP HTTPS OTA <esp_https_ota>`
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 <esp_pthread>`
docs: add error codes reference 2018-06-13 08:07:26 +00:00			`Error Codes and Helper Functions <esp_err>`
docs: Add description 2019-04-29 04:31:50 +00:00			`App image format <app_image_format>`
docs: add API reference section for esp_system.h 2018-07-30 13:19:20 +00:00			`Miscellaneous System APIs <system>`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00
Added links from api category TOC to example category folders Typo fix in bluetooth README.md 2017-01-18 20:04:11 +00:00
Review log.rst and index.rst files in api-reference/system 2019-04-11 07:33:38 +00:00			Code examples for this API section are provided in the :example:`system` directory of ESP-IDF examples.