espressif/esp-mqtt
1
0
Fork 1
mirror of https://github.com/espressif/esp-mqtt.git synced 2026-08-03 20:14:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

feat: Provide reason code in MQTT event

Browse Source
This commit is contained in:
Bogdan Kolendovskyy
2026-04-24 14:15:29 +02:00
parent 996177a46d
commit f1fc00ca44
6 changed files with 35 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
include/mqtt5_client.h
+19 -3
View File
@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -18,7 +18,17 @@ typedef struct esp_mqtt_client *esp_mqtt5_client_handle_t;
/**
* MQTT5 protocol error reason code, more details refer to MQTT5 protocol document section 2.4
*/
typedef enum mqtt5_error_reason_code_t {
typedef enum mqtt5_reason_code_t {
MQTT5_SUCCESS = 0x00,
MQTT5_NORMAL_DISCONNECT = 0x00,
MQTT5_GRANTED_QOS0 = 0x00,
MQTT5_GRANTED_QOS1 = 0x01,
MQTT5_GRANTED_QOS2 = 0x02,
MQTT5_DISCONNECT_WITH_WILL = 0x04,
MQTT5_NO_MATCHING_SUBSCRIBERS = 0x10,
MQTT5_NO_SUBSCRIPTION_EXISTED = 0x11,
MQTT5_CONTINUE_AUTHENTICATION = 0x18,
MQTT5_REAUTHENTICATE = 0x19,
MQTT5_UNSPECIFIED_ERROR = 0x80,
MQTT5_MALFORMED_PACKET = 0x81,
MQTT5_PROTOCOL_ERROR = 0x82,
@@ -59,7 +69,13 @@ typedef enum mqtt5_error_reason_code_t {
MQTT5_MAXIMUM_CONNECT_TIME = 0xA0,
MQTT5_SUBSCRIBE_IDENTIFIER_NOT_SUPPORT = 0xA1,
MQTT5_WILDCARD_SUBSCRIBE_NOT_SUPPORT = 0xA2,
} esp_mqtt5_error_reason_code_t;
} esp_mqtt5_reason_code_t;
/**
* \deprecated alias esp_mqtt5_error_reason_code_t for esp_mqtt5_reason_code_t exists for backwards compatibility reasons
* and will be removed in subsequent updates.
*/
typedef __attribute__((deprecated)) esp_mqtt5_reason_code_t esp_mqtt5_error_reason_code_t;
/**
* MQTT5 user property handle
include/mqtt_client.h
+2 -3
View File
@@ -199,9 +199,7 @@ typedef struct esp_mqtt_error_codes {
connect_return_code; /*!< connection refused error code reported from
*MQTT* broker on connection */
#ifdef CONFIG_MQTT_PROTOCOL_5
esp_mqtt5_error_reason_code_t
disconnect_return_code; /*!< disconnection reason code reported from
*MQTT* broker on disconnection */
esp_mqtt5_reason_code_t disconnect_return_code __attribute__((deprecated)); /*!<\deprecated disconnection reason code reported from *MQTT* broker on disconnection, deprecated - use reason_code in event instead */
#endif
/* tcp_transport extension */
int esp_transport_sock_errno; /*!< errno from the underlying socket */
@@ -234,6 +232,7 @@ typedef struct esp_mqtt_event_t {
esp_mqtt_protocol_ver_t
protocol_ver; /*!< MQTT protocol version used for connection, defaults to value from menuconfig*/
#ifdef CONFIG_MQTT_PROTOCOL_5
esp_mqtt5_reason_code_t reason_code; /*!< *MQTT* 5 reason code */
esp_mqtt5_event_property_t *property; /*!< MQTT 5 property associated with this event */
#endif