本文介绍在配置C Link SDK的设备接入功能时,常见错误。
Link SDK通过以下两种渠道,表达建连失败时的内部运行状态。您可以通过内部运行状态,了解失败原因。
API的返回值是
int32_t
的非正数整型,也叫状态码,状态码返回0
表成功,其它值表示运行状态 。使用
retval = aiot_xxx_yyy()
方式获取返回值。所有返回值唯一对应内部运行分支,详情请参见
aiot_state_api.h
或aiot_xxx_api.h
。所有组件返回值的值域互不重叠,共同分别分布在
0x0000 - 0xFFFF
。
从SDK内部,调用您的日志回调函数。
以下为常见错误码,完整的错误码列表,请参见aiot_state_api.h。
MQTT接入
错误码 | 说明 |
MQTT服务器拒绝提供连接, 服务当前不可用。请稍后重试。 | |
连接时的用户名或密码非法。 | |
MQTT服务器进行连接身份验证失败,登录密码错误。请检查设备认证信息是否正确。 |
HTTPS接入
错误码 | 说明 |
解析收到的HTTPS报文时,无法获取有效的关于状态的代码行。无法获取HTTPS | |
解析收到的HTTPS报文时,报文的Body部分已接收完毕,但没有更多数据。 | |
HTTPS认证应答的StatusCode不是200,认证失败。请检查认证签名是否正确。 | |
未完成接收HTTPS认证应答接,认证失败。 | |
HTTPS认证应答中,未能解析到Token,认证失败。 |
网络层
错误码 | 说明 |
TCP域名解析失败,请检查域名或IP是否正确。 | |
TCP建立连接失败。 | |
TLS报文最大长度设置为0,该设置非法,请检查后重新设置。 | |
TLS服务端证书配置错误,请检查服务端证书是否正确。 | |
TLS设备端证书配置错误,请检查客户端证书是否正确。 | |
TLS客户端密钥配置错误,请检查客户端密钥是否正确。 | |
TLS域名解析失败,请检查域名或IP是否配置正确。 | |
TLS Socket创建失败。 | |
TLS Socket连接失败。 | |
SSL收到的数据包出错,请检查TLS帧数据的长度是否过小。 |