esp_mesh_send returns ESP_ERR_MESH_XMIT although documentation doesn't litst it. (IDFGH-13550)

[yaqwsx]

Answers checklist.

• I have read the documentation ESP-IDF Programming Guide and the issue is not addressed there.
• I have updated my IDF branch (master or release) to the latest version and checked that the issue is present there.
• I have searched the issue tracker for a similar issue and not found a similar issue.

IDF version.

v5.1.4

Espressif SoC revision.

ESP32

Operating System used.

Linux

How did you build your project?

Command line with idf.py

If you are using Windows, please specify command line type.

None

Development Kit.

ESP32-DevKitC

Power Supply used.

USB

What is the expected behavior?

The documentation of esp_mesh_send permits the following error codes:

ESP_OK
ESP_FAIL
ESP_ERR_MESH_ARGUMENT
ESP_ERR_MESH_NOT_START
ESP_ERR_MESH_DISCONNECTED
ESP_ERR_MESH_OPT_UNKNOWN
ESP_ERR_MESH_EXCEED_MTU
ESP_ERR_MESH_NO_MEMORY
ESP_ERR_MESH_TIMEOUT
ESP_ERR_MESH_QUEUE_FULL
ESP_ERR_MESH_NO_ROUTE_FOUND
ESP_ERR_MESH_DISCARD

However, sometimes it returns ESP_ERR_MESH_XMIT, which is not allowed according to documentation. Also, the documentation on this error code is not explanatory - it just says "XMIT". Since the source of ESP-MESH-WIFI is not available, we cannot check when this occurs, what the error code means and how to prevent it or how to recover from it.

What is the actual behavior?

esp_mesh_send behaves as described in the documentation. The descriptions of possible return codes are more explanatory in the documentation.

Steps to reproduce.

Set up a mesh network of one root and three nodes. Start periodic traffic to root. Observe unexpected return codes every ~60-120 seconds.

Debug Logs.

No response

More Information.

No response