alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2025-11-18 10:31:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(wifi): Document WiFi expansion on wifi-less chips

Browse Source
This commit is contained in:
David Cermak
2024-06-10 10:06:22 +02:00
parent 83a947d540
commit 80543cf39c
5 changed files with 32 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/en/api-guides/index.rst
View File

@@ -44,4 +44,5 @@ API Guides
:SOC_WIFI_SUPPORTED: wifi
:SOC_WIFI_SUPPORTED: wifi-security
low-power-mode
wifi-expansion
:SOC_WIFI_SUPPORTED or SOC_BT_SUPPORTED or SOC_IEEE802154_SUPPORTED: phy

27
docs/en/api-guides/wifi-expansion.rst Normal file
View File

@@ -0,0 +1,27 @@
Wi-Fi Expansion
===============
:link_to_translation:`zh_CN:[中文]`
.. only:: not SOC_WIFI_SUPPORTED
{IDF_TARGET_NAME} does not support Wi-Fi functionality natively, but it is possible to use the same Wi-Fi API and features using Wi-Fi expansion.
.. only:: SOC_WIFI_SUPPORTED
{IDF_TARGET_NAME} does support Wi-Fi functionality natively, please refer to :doc:`wifi` documentation. Even though Wi-Fi is supported on {IDF_TARGET_NAME}, it is possible to expand it and use another instance of Wi-Fi expansion interfaces using esp_wifi_remote <https://components.espressif.com/components/espressif/esp_wifi_remote>`_ component.
The principle of Wi-Fi Expansion operation is to add another ESP32 series, Wi-Fi capable, target connected to the {IDF_TARGET_NAME} in a pre-defined way. Your project could then include the `esp_wifi_remote <https://components.espressif.com/components/espressif/esp_wifi_remote>`_ component using:
.. code:: bash
idf.py add-dependency esp_wifi_remote
Please follow the instructions described in the `esp_wifi_remote documentation <https://github.com/espressif/esp-protocols/blob/master/components/esp_wifi_remote/README.md>`_.
.. only:: not SOC_WIFI_SUPPORTED
To explore the Wi-Fi Expansion functionality on {IDF_TARGET_NAME}, you can get started with this example: :idf_file:`examples/protocols/mqtt/tcp/README.md` and choose Wi-Fi connection in the project configuration menu.