Function esp_idf_svc::hal::sys::esp_wifi_set_max_tx_power
source ยท pub unsafe extern "C" fn esp_wifi_set_max_tx_power(power: i8) -> i32
Expand description
@brief Set maximum transmitting power after WiFi start.
@attention 1. Maximum power before wifi startup is limited by PHY init data bin. @attention 2. The value set by this API will be mapped to the max_tx_power of the structure wifi_country_t variable. @attention 3. Mapping Table {Power, max_tx_power} = {{8, 2}, {20, 5}, {28, 7}, {34, 8}, {44, 11}, {52, 13}, {56, 14}, {60, 15}, {66, 16}, {72, 18}, {80, 20}}. @attention 4. Param power unit is 0.25dBm, range is [8, 84] corresponding to 2dBm - 20dBm. @attention 5. Relationship between set value and actual value. As follows: {set value range, actual value} = {{[8, 19],8}, {[20, 27],20}, {[28, 33],28}, {[34, 43],34}, {[44, 51],44}, {[52, 55],52}, {[56, 59],56}, {[60, 65],60}, {[66, 71],66}, {[72, 79],72}, {[80, 84],80}}.
@param power Maximum WiFi transmitting power.
@return
- ESP_OK: succeed
- ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init
- ESP_ERR_WIFI_NOT_STARTED: WiFi is not started by esp_wifi_start
- ESP_ERR_INVALID_ARG: invalid argument, e.g. parameter is out of range