OVMS3-idf/docs/index.rst

146 lines
3.1 KiB
ReStructuredText
Raw Normal View History

2016-10-24 18:44:57 +00:00
ESP32 Programming Guide
=======================
2016-10-29 21:35:12 +00:00
.. caution::
Until ESP-IDF release 1.0, this documentation is a draft. It is incomplete and may have mistakes. Please mind your step!
2016-10-30 18:38:44 +00:00
2016-11-16 19:17:44 +00:00
Documentation adressed to developers of applications for `ESP32 <https://espressif.com/en/products/hardware/esp32/overview>`_ by `Espressif <https://espressif.com/>`_ using `esp-idf <https://github.com/espressif/esp-idf>`_.
2016-10-24 18:44:57 +00:00
Contents:
2016-10-24 18:44:57 +00:00
.. toctree::
:caption: Setup Toolchain
:maxdepth: 1
2016-10-24 18:44:57 +00:00
Windows <windows-setup>
Linux <linux-setup>
Mac OS <macos-setup>
2016-10-24 18:44:57 +00:00
.. Connect - TBA
2016-10-24 18:44:57 +00:00
.. toctree::
:caption: Build and Flash
:maxdepth: 1
2016-10-25 19:28:21 +00:00
Make <make-project>
2016-10-24 18:44:57 +00:00
Eclipse IDE <eclipse-setup>
.. toctree::
:caption: What Else?
:maxdepth: 1
2016-10-24 18:44:57 +00:00
General Notes <general-notes>
2016-10-24 18:44:57 +00:00
partition-tables
build_system
2016-10-25 19:28:21 +00:00
openocd
2016-11-11 04:40:29 +00:00
Secure Boot <security/secure-boot>
ULP coprocessor <api/ulp.rst>
.. API Reference
..
Table of Contents Outline
..
1. System - TBA
1.1. Fundamentals of multiprocessor programming with FreeRTOS - TBA
1.2. Application startup flow - TBA
2016-11-16 19:17:44 +00:00
1.3. Flash encryption and secure boot: how they work and APIs
1.4. Lower Power Coprocessor - TBA
2016-11-17 04:09:08 +00:00
1.5. Watchdogs <api/wdts>
1.6. ...
2016-11-17 04:09:08 +00:00
2. Memory - TBA
2.1. Memory layout of the application (IRAM/IROM, limitations of each) - TBA
2.2. Flash layout and partitions - TBA
2.3. Flash access APIs - TBA
2.4. Partition APIs - TBA
2.5. OTA mechanism (app partitions, OTA partition) and APIs - TBA
2.6. ...
3. Wi-Fi
4. Bluetooth
4.1. BT Classic - TBA
4.2. BLE
5. Ethernet - TBA
6. Interfaces
6.1. GPIO
6.2. ADC - TBA
6.3. DAC - TBA
2016-11-16 19:17:44 +00:00
6.4. UART
6.5. I2C - TBA
6.6. I2S - TBA
6.7. SPI - TBA
6.8. CAN - TBA
6.9. SD Controller - TBA
6.10. Infrared - TBA
6.11. Pulse Counter - TBA
6.12. PWM - TBA
6.13. LED PWM
6.14. ...
7. Sensors - TBA
7.1. Hall Sensor - TBA
7.2. Temperature Sensor - TBA
7.3. Touch Sensor - TBA
8. Protocols - TBA
9. Components
2016-11-16 19:17:44 +00:00
9.1. Logging
9.2 Non-Volatile Storage
9.3 Virtual Filesystem
9.3. Http sever - TBA
10. Applications - TBA
..
API Dcoumentation Teamplate
..
2016-10-24 18:44:57 +00:00
.. toctree::
:caption: API Reference
:maxdepth: 1
2016-10-24 18:44:57 +00:00
Wi-Fi <api/esp_wifi>
Bluetooth <api/bt>
2016-11-17 04:09:08 +00:00
Watchdogs <api/wdts>
OTA <api/ota>
2016-11-23 13:22:19 +00:00
GPIO <api/gpio>
UART <api/uart>
LED Control <api/ledc>
Remote Control <api/rmt>
Timer <api/timer>
2016-11-23 13:25:06 +00:00
Pulse Counter <api/pcnt>
SPI Flash and Partition APIs <api/spi_flash>
Logging <api/log>
Non-Volatile Storage <api/nvs_flash>
Virtual Filesystem <api/vfs>
Ethernet <api/esp_eth>
deep-sleep-stub
Template <api/template>
.. toctree::
2016-10-25 19:28:21 +00:00
:caption: Technical Reference
2016-10-25 19:28:21 +00:00
Technical Reference <http://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf>
.. Resources - TBA
.. toctree::
:caption: Contribute
:maxdepth: 1
contributing
Style Guide <style-guide>
2016-10-30 18:38:44 +00:00
documenting-code
contributor-agreement
.. toctree::
2016-10-24 18:44:57 +00:00
:caption: Legal
:maxdepth: 1
COPYRIGHT
2016-10-25 19:28:21 +00:00
Indices
2016-11-16 19:17:44 +00:00
-------
* :ref:`genindex`
* :ref:`search`