OVMS3-idf/docs/index.rst

ESP-IDF Programming Guide
=========================

This is the documentation for Espressif IoT Developement Framework (`esp-idf <https://github.com/espressif/esp-idf>`_). ESP-IDF is the official development framework for the `ESP32 <https://espressif.com/en/products/hardware/esp32/overview>`_ chip.


Contents:

.. toctree::
   :caption: Setup Toolchain
   :maxdepth: 1

   Windows <windows-setup>
   Linux <linux-setup>
   Mac OS <macos-setup>

.. Connect - TBA

.. toctree::
   :caption: Build and Flash
   :maxdepth: 1

   Make <make-project>
   Eclipse IDE <eclipse-setup>

.. toctree::
   :caption: What Else?
   :maxdepth: 1

   General Notes <general-notes>
   Build System <build-system>
   Debugging <openocd>
   ESP32 Core Dump <core_dump>
   Partition Tables <partition-tables>
   Flash Encryption <security/flash-encryption>
   Secure Boot <security/secure-boot>
   Deep Sleep Wake Stubs <deep-sleep-stub>
   ULP Coprocessor <ulp>
   Unit Testing <unit-tests>

.. toctree::
   :caption: API Reference
   :maxdepth: 2

   Wi-Fi <api/wifi/index>
   Bluetooth <api/bluetooth/index>
   Ethernet <api/ethernet/index>
   Peripherals <api/peripherals/index>
   System <api/system/index>
   Storage <api/storage/index>
   Protocols <api/protocols/index>

.. toctree::
   :caption: Hardware Reference

   Technical Reference Manual (PDF) <http://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf>
   Pin List and Functions (PDF) <http://espressif.com/sites/default/files/documentation/esp32_chip_pin_list_en.pdf>
   Chip Pinout (PDF) <http://espressif.com/sites/default/files/documentation/esp32_pinout_v1_0.pdf>
   Silicon Errata (PDF) <http://espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_en.pdf>
   
.. toctree::
   :caption: Contribute
   :maxdepth: 1

   Contributions Guide <contributing>
   Style Guide <style-guide>
   Documenting Code <documenting-code>
   API Template <api/template>
   Contributor Agreement <contributor-agreement>

.. toctree::
   :caption: Legal
   :maxdepth: 1

   COPYRIGHT

 
Indices
=======

* :ref:`genindex`
docs: update index, improve structure of the readme 2017-01-15 17:48:47 +00:00			`ESP-IDF Programming Guide`
			`=========================`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
docs: update index, improve structure of the readme 2017-01-15 17:48:47 +00:00			This is the documentation for Espressif IoT Developement Framework (`esp-idf <https://github.com/espressif/esp-idf>`_). ESP-IDF is the official development framework for the `ESP32 <https://espressif.com/en/products/hardware/esp32/overview>`_ chip.
doc: Index clean up 2016-11-16 19:17:44 +00:00

Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`Contents:`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`.. toctree::`
			`:caption: Setup Toolchain`
			`:maxdepth: 1`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`Windows <windows-setup>`
			`Linux <linux-setup>`
			`Mac OS <macos-setup>`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`.. Connect - TBA`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`.. toctree::`
			`:caption: Build and Flash`
			`:maxdepth: 1`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Make section 2016-10-25 19:28:21 +00:00			`Make <make-project>`
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`Eclipse IDE <eclipse-setup>`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
			`.. toctree::`
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			`:caption: What Else?`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00			`:maxdepth: 1`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00
docs: add description of ESP-IDF application startup flow and memory layout 2016-11-14 07:40:54 +00:00			`General Notes <general-notes>`
Typo corrections 2017-01-17 20:12:54 +00:00			`Build System <build-system>`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Debugging <openocd>`
			`ESP32 Core Dump <core_dump>`
			`Partition Tables <partition-tables>`
			`Flash Encryption <security/flash-encryption>`
Secure boot: Documentation tweaks 2016-11-11 04:40:29 +00:00			`Secure Boot <security/secure-boot>`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Deep Sleep Wake Stubs <deep-sleep-stub>`
			`ULP Coprocessor <ulp>`
esp32: add unit testing doc 2016-12-05 09:29:12 +00:00			`Unit Testing <unit-tests>`
deep-sleep-stub added + TOC outline TOC outline to show overal planned structure 2016-11-05 16:13:44 +00:00
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`.. toctree::`
			`:caption: API Reference`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`:maxdepth: 2`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Wi-Fi <api/wifi/index>`
			`Bluetooth <api/bluetooth/index>`
			`Ethernet <api/ethernet/index>`
			`Peripherals <api/peripherals/index>`
			`System <api/system/index>`
			`Storage <api/storage/index>`
			`Protocols <api/protocols/index>`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
			`.. toctree::`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`:caption: Hardware Reference`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Docs: Mark PDF links as such in the documentation index Nothing worse than clicking what you think is an internal page link and finding a PDF downloading! 2017-02-14 01:56:51 +00:00			`Technical Reference Manual (PDF) <http://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf>`
			`Pin List and Functions (PDF) <http://espressif.com/sites/default/files/documentation/esp32_chip_pin_list_en.pdf>`
			`Chip Pinout (PDF) <http://espressif.com/sites/default/files/documentation/esp32_pinout_v1_0.pdf>`
			`Silicon Errata (PDF) <http://espressif.com/sites/default/files/documentation/eco_and_workarounds_for_bugs_in_esp32_en.pdf>`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
			`.. toctree::`
			`:caption: Contribute`
			`:maxdepth: 1`

Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Contributions Guide <contributing>`
New items to documentation TOC - Style Guide - UART API 2016-11-10 21:47:29 +00:00			`Style Guide <style-guide>`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`Documenting Code <documenting-code>`
			`API Template <api/template>`
			`Contributor Agreement <contributor-agreement>`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
			`.. toctree::`
Initial list of Wi-Fi API 2016-10-24 18:44:57 +00:00			`:caption: Legal`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00			`:maxdepth: 1`

			`COPYRIGHT`

Make section 2016-10-25 19:28:21 +00:00
			`Indices`
Moved api documentation to new folders / categories 2017-01-16 22:08:35 +00:00			`=======`
Initial Sphinx / ReadTheDocs.org configuration 2016-10-23 20:14:24 +00:00
Docs: Mark PDF links as such in the documentation index Nothing worse than clicking what you think is an internal page link and finding a PDF downloading! 2017-02-14 01:56:51 +00:00			* :ref:`genindex`