You can change a few of the default settings used. Please keep in mind that it's almost always a tradeoff between memory usage and performance. It's easy to decrease performance by using unfortunate settings or even break the application or making it less stable.
So you should test every change very carefully.
Be aware that settings which work fine on one ESP32 model might not work at all on other. Also, settings should be adjusted according to your application's needs.
We use toml-cfg for the build time configuration
You need to add a cfg.toml file in the root of your binary crate. When using a Cargo Workspace you should put the file in the root of the workspace directory.
A configuration file can look like this:
[esp-wifi]
rx_queue_size = 15
tx_queue_size = 3
static_rx_buf_num = 10
dynamic_rx_buf_num = 16
ampdu_rx_enable = 0
ampdu_tx_enable = 0
rx_ba_win = 32
max_burst_size = 6You can set the following settings
| Key | Description |
|---|---|
| rx_queue_size | Size of the RX queue in frames |
| tx_queue_size | Size of the TX queue in frames |
| max_burst_size | See documentation |
| static_rx_buf_num | WiFi static RX buffer number. See ESP-IDF Programming Guide |
| dynamic_rx_buf_num | WiFi dynamic RX buffer number. See ESP-IDF Programming Guide |
| static_tx_buf_num | WiFi static TX buffer number. See ESP-IDF Programming Guide |
| dynamic_tx_buf_num | WiFi dynamic TX buffer number. See ESP-IDF Programming Guide |
| ampdu_rx_enable | WiFi AMPDU RX feature enable flag. See ESP-IDF Programming Guide |
| ampdu_rx_enable | WiFi AMPDU RX feature enable flag. (0 or 1) See ESP-IDF Programming Guide |
| ampdu_tx_enable | WiFi AMPDU TX feature enable flag. (0 or 1) See ESP-IDF Programming Guide |
| amsdu_tx_enable | WiFi AMSDU TX feature enable flag. (0 or 1) See ESP-IDF Programming Guide |
| rx_ba_win | WiFi Block Ack RX window size. See ESP-IDF Programming Guide |
| country_code | Country code. See ESP-IDF Programming Guide |
| country_code_operating_class | If not 0: Operating Class table number. See ESP-IDF Programming Guide |
| mtu | MTU, see documentation |
| heap_size | Size of the WiFi/BLE heap in bytes |
| tick_rate_hz | Tick rate of the internal task scheduler in hertz. |
| listen_interval | Interval for station to listen to beacon from AP. The unit of listen interval is one beacon interval. For example, if beacon interval is 100 ms and listen interval is 3, the interval for station to listen to beacon is 300 ms |
| beacon_timeout | For Station, If the station does not receive a beacon frame from the connected SoftAP during the inactive time, disconnect from SoftAP. Default 6s. Range 6-30 |
| ap_beacon_timeout | For SoftAP, If the SoftAP doesn’t receive any data from the connected STA during inactive time, the SoftAP will force deauth the STA. Default is 300s. |
| failure_retry_cnt | Number of connection retries station will do before moving to next AP. scan_method should be set as WIFI_ALL_CHANNEL_SCAN to use this config. Note: Enabling this may cause connection time to increase incase best AP doesn't behave properly. Defaults to 1 |
| scan_method | 0 = WIFI_FAST_SCAN, 1 = WIFI_ALL_CHANNEL_SCAN, defaults to 0 |
esp-wifi contains a lot of trace-level logging statements. For maximum performance you might want to disable logging via a feature flag of the log crate. See documentation. You should set it to release_max_level_off