Todos los productos
Search
Centro de documentos

IoT Platform:Códigos de error comunes

Última actualización: Sep 04, 2026

Enumera los códigos de error comunes que devuelve el C Link SDK cuando fallan las conexiones de dispositivos, incluidos errores de MQTT, HTTPS y de la capa de red.

Cuando falla una conexión, el Link SDK notifica su estado interno de dos maneras:

  • La API devuelve un código de estado, que es un entero no positivo de tipo int32_t. Un valor de 0 indica éxito; otros valores indican el estado de ejecución.

    • Use el formato retval = aiot_xxx_yyy() para obtener el valor devuelto.

    • Cada valor devuelto corresponde a una rama de ejecución interna única. Para más información, consulte aiot_state_api.h o aiot_xxx_api.h.

    • Los rangos de valores devueltos de todos los componentes no se superponen y se distribuyen entre 0x0000 y 0xFFFF.

  • El SDK invoca la función de callback de registros.

A continuación se listan los códigos de error comunes. Todos los códigos están definidos en aiot_state_api.h.

Acceso MQTT

Código de error

Descripción

STATE_MQTT_CONNACK_RCODE_SERVER_UNAVAILABLE

El servidor MQTT denegó la conexión. Servicio no disponible. Inténtelo más tarde.

STATE_MQTT_CONNACK_RCODE_BAD_USERNAME_PASSWORD

Nombre de usuario o contraseña no válidos.

STATE_MQTT_CONNACK_RCODE_NOT_AUTHORIZED

Falló la verificación de identidad del servidor MQTT. Contraseña incorrecta. Compruebe la información de autenticación del dispositivo.

Acceso HTTPS

Código de error

Descripción

STATE_HTTP_STATUS_LINE_INVALID

Línea de estado no válida en la respuesta HTTPS. No se pudo recuperar el StatusCode.

STATE_HTTP_READ_BODY_FINISHED

Cuerpo del mensaje HTTPS recibido por completo, pero no hay más datos disponibles.

STATE_HTTP_AUTH_CODE_FAILED

La autenticación HTTPS devolvió un código de estado distinto de 200. Compruebe la firma de autenticación.

STATE_HTTP_AUTH_NOT_FINISHED

Respuesta de autenticación HTTPS incompleta. Falló la autenticación.

STATE_HTTP_AUTH_TOKEN_FAILED

Error al analizar sintácticamente el token de la respuesta de autenticación HTTPS.

Capa de red

Código de error

Descripción

STATE_PORT_NETWORK_DNS_FAILED

Falló la resolución DNS TCP. Compruebe el nombre de dominio o la dirección IP.

STATE_PORT_NETWORK_CONNECT_FAILED

Error al establecer una conexión TCP.

STATE_PORT_TLS_INVALID_MAX_FRAGMENT

La longitud máxima de mensaje TLS está establecida en 0, lo cual no es válido. Restablezca el valor.

STATE_PORT_TLS_INVALID_SERVER_CERT

Configuración de certificado de servidor TLS no válida. Compruebe el certificado del servidor.

STATE_PORT_TLS_INVALID_CLIENT_CERT

Configuración de certificado de cliente TLS no válida. Compruebe el certificado del cliente.

STATE_PORT_TLS_INVALID_CLIENT_KEY

Configuración de clave de cliente TLS no válida. Compruebe la clave del cliente.

STATE_PORT_TLS_DNS_FAILED

Falló la resolución DNS TLS. Compruebe el nombre de dominio o la dirección IP.

STATE_PORT_TLS_SOCKET_CREATE_FAILED

Error al crear el socket TLS.

STATE_PORT_TLS_SOCKET_CONNECT_FAILED

Error al conectar el socket TLS.

STATE_PORT_TLS_INVALID_RECORD

Se recibió un paquete SSL no válido. Compruebe si la longitud de datos de la trama TLS es demasiado pequeña.