Merge branch 'docs/clarify_keepalive_timeout' into 'master'

docs: Clarify keepalive timeout

See merge request espressif/esp-mqtt!186
This commit is contained in:
Rocha Euripedes
2023-07-11 05:34:46 +08:00

View File

@ -315,7 +315,10 @@ typedef struct esp_mqtt_client_config_t {
int retain; /*!< LWT retained message flag */
} last_will; /*!< Last will configuration */
bool disable_clean_session; /*!< *MQTT* clean session, default clean_session is true */
int keepalive; /*!< *MQTT* keepalive, default is 120 seconds */
int keepalive; /*!< *MQTT* keepalive, default is 120 seconds
When configuring this value, keep in mind that the client attempts
to communicate with the broker at half the interval that is actually set.
This conservative approach allows for more attempts before the broker's timeout occurs */
bool disable_keepalive; /*!< Set `disable_keepalive=true` to turn off keep-alive mechanism, keepalive is active
by default. Note: setting the config value `keepalive` to `0` doesn't disable
keepalive feature, but uses a default keepalive period */