Todos os produtos
Search
Central de documentação

IoT Platform:Códigos de erro comuns

Última atualização: Jun 26, 2026

Lista os códigos de erro comuns que o C Link SDK retorna quando ocorrem falhas na conexão do dispositivo, abrangendo erros de MQTT, HTTPS e da camada de rede.

Quando uma conexão falha, o Link SDK relata seu status interno de duas formas:

  • A API retorna um código de status, que é um inteiro não positivo do tipo int32_t. O valor 0 indica sucesso; outros valores indicam o status de execução.

    • Use o formato retval = aiot_xxx_yyy() para obter o valor de retorno.

    • Cada valor de retorno corresponde a um ramo de execução interno exclusivo. Para mais informações, consulte aiot_state_api.h ou aiot_xxx_api.h.

    • Os intervalos de valores de retorno dos componentes não se sobrepõem e distribuem-se na faixa de 0x0000 a 0xFFFF.

  • O SDK chama sua função de callback de log.

As tabelas a seguir listam os códigos de erro comuns. Todos os códigos estão definidos em aiot_state_api.h.

Acesso MQTT

Código de erro

Descrição

STATE_MQTT_CONNACK_RCODE_SERVER_UNAVAILABLE

Servidor MQTT negou a conexão. Serviço indisponível. Tente novamente mais tarde.

STATE_MQTT_CONNACK_RCODE_BAD_USERNAME_PASSWORD

Nome de usuário ou senha inválidos.

STATE_MQTT_CONNACK_RCODE_NOT_AUTHORIZED

Falha na verificação de identidade do servidor MQTT. Senha incorreta. Verifique as informações de autenticação do dispositivo.

Acesso HTTPS

Código de erro

Descrição

STATE_HTTP_STATUS_LINE_INVALID

Linha de status inválida na resposta HTTPS. Não foi possível recuperar o StatusCode.

STATE_HTTP_READ_BODY_FINISHED

Corpo da mensagem HTTPS recebido integralmente, mas sem dados adicionais disponíveis.

STATE_HTTP_AUTH_CODE_FAILED

Autenticação HTTPS retornou código de status diferente de 200. Verifique a assinatura de autenticação.

STATE_HTTP_AUTH_NOT_FINISHED

Resposta de autenticação HTTPS incompleta. Falha na autenticação.

STATE_HTTP_AUTH_TOKEN_FAILED

Falha ao analisar o token da resposta de autenticação HTTPS.

Camada de rede

Código de erro

Descrição

STATE_PORT_NETWORK_DNS_FAILED

Falha na resolução DNS TCP. Verifique o nome de domínio ou o endereço IP.

STATE_PORT_NETWORK_CONNECT_FAILED

Falha ao estabelecer conexão TCP.

STATE_PORT_TLS_INVALID_MAX_FRAGMENT

Comprimento máximo da mensagem TLS definido como 0 (inválido). Defina o valor.

STATE_PORT_TLS_INVALID_SERVER_CERT

Configuração inválida do certificado de servidor TLS. Verifique o certificado do servidor.

STATE_PORT_TLS_INVALID_CLIENT_CERT

Configuração inválida do certificado de cliente TLS. Verifique o certificado do cliente.

STATE_PORT_TLS_INVALID_CLIENT_KEY

Configuração inválida da chave de cliente TLS. Verifique a chave do cliente.

STATE_PORT_TLS_DNS_FAILED

Falha na resolução DNS TLS. Verifique o nome de domínio ou o endereço IP.

STATE_PORT_TLS_SOCKET_CREATE_FAILED

Falha ao crie o socket TLS.

STATE_PORT_TLS_SOCKET_CONNECT_FAILED

Falha ao conectar o socket TLS.

STATE_PORT_TLS_INVALID_RECORD

Pacote ssl inválido recebido. Verifique se o comprimento dos dados do quadro TLS é insuficiente.