mirror
/
esp-idf
kopia lustrzana https://github.com/espressif/esp-idf
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność
esp-idf/docs/en/api-guides/RF_calibration.rst

61 wiersze
2.7 KiB
ReStructuredText
Czysty Zwykły widok Historia

doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
RF calibration
==============
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
{IDF_TARGET_NAME} supports three RF calibration methods during RF initialization:
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
1. Partial calibration
2. Full calibration
3. No calibration
Partial calibration
-------------------
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
During RF initialization, the partial calibration method is used by default for RF calibration.
It is done based on the full calibration data which is stored in the NVS.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
To use this method, please go to ``menuconfig`` and enable :ref:`CONFIG_ESP32_PHY_CALIBRATION_AND_DATA_STORAGE`.
Full calibration
----------------
Full calibration is triggered in the follwing conditions:
1. NVS does not exist.
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
2. The NVS partition to store calibration data is erased.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
3. Hardware MAC address is changed.
4. PHY library version is changed.
5. The RF calibration data loaded from the NVS partition is broken.
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
It takes about 100ms more than partial calibration.
If boot duration is not critical, it is suggested to use the full calibration method.
To switch to the full calibration method, go to ``menuconfig`` and disable :ref:`CONFIG_ESP32_PHY_CALIBRATION_AND_DATA_STORAGE`.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
If you use the default method of RF calibration, there are two ways to add the function of triggering full calibration as a last-resort remedy.
1. Erase the NVS partition if you don't mind all of the data stored in the NVS partition is erased. That is indeed the easiest way.
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
2. Call API :cpp:func:`esp_phy_erase_cal_data_in_nvs` before initializing WiFi and BT/BLE based on some conditions (e.g. an option provided in some diagnostic mode).
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
In this case, only phy namespace of the NVS partition is erased.
No calibration
---------------
docs: Fix broken or incorrect link roles to IDF files & directories
2020-02-10 08:52:41 +00:00
No calibration method is only used when the device wakes up from deep sleep.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
PHY initialization data
-----------------------
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
The PHY initialization data is used for RF calibration.
There are two ways to get the PHY initialization data.
esp_phy: decouple esp_phy component from esp_wifi and bt * add esp-phy-lib submodule * move libphy.a and phy_init.c from esp_wifi to esp_phy * move librtc.a from esp_wifi to esp_phy * move libbtbb.a from bt to esp_phy * corresponding updates to build system
2021-05-24 11:39:39 +00:00
One is the default initialization data which is located in the header file :idf_file:`components/esp_phy/{IDF_TARGET_PATH_NAME}/include/phy_init_data.h`.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
It is embedded into the application binary after compiling and then stored into read-only memory (DROM).
To use the default initialization data, please go to ``menuconfig`` and disable :ref:`CONFIG_ESP32_PHY_INIT_DATA_IN_PARTITION`.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
doc: Update English pages with generic target name
2019-12-09 03:01:09 +00:00
Another is the initialization data which is stored in a partition.
When using a custom partition table, make sure that PHY data partition is included (type: `data`, subtype: `phy`).
With default partition table, this is done automatically.
If initialization data is stored in a partition, it has to be flashed there, otherwise runtime error will occur.
doc: add documentation for RF calibration Add an API to erase phy namespace of NVS
2018-11-29 08:07:28 +00:00
To switch to the initialization data stored in a partition, go to ``menuconfig`` and enable :ref:`CONFIG_ESP32_PHY_INIT_DATA_IN_PARTITION`.