使用云连接器API，您可以随时连接或断开远程管理器。通过以下功能管理与Remote Manager的连接:

函数 描述

Cc_init_error_t init_cloud_connection(const char *config_file)

使用提供的配置文件中的参数初始化Cloud Connector。如果是的话零，使用默认配置文件位置(/etc/cc.conf）.

cc_start_error_t start_cloud_connection(空白)

打开Cloud Connector连接。

cc_status_t get_cloud_connection_status(空白)

返回Cloud Connector连接状态。

cc_stop_error_t stop_cloud_connection(空白)

关闭云连接器连接。

在尝试连接之前，请确保您的设备已在远程管理器帐户中注册。有关在远程管理器中注册设备的详细信息，请参见连接到远程管理器．

管理设备云连接
int主要（无效) {cc_init_error_t init_error;cc_start_error_t start_error;cc_stop_error_t stop_error;[…]init_error = init_cloud_connection(config_file);如果(init_error != CC_INIT_ERROR_NONE) {log_error"无法初始化云连接，错误%d", init_error);返回EXIT_FAILURE;}[…start_error = start_cloud_connection();如果= CC_START_ERROR_NONE) {log_error("无法启动云连接，错误%d", start_error);返回EXIT_FAILURE;}[…stop_error = stop_cloud_connection();[…]返回EXIT_SUCCESS;}

初始化连接

初始化过程用提供的配置文件中的值配置Cloud Connector。

cc_init_error_t init_cloud_connection (常量字符* config_file)

默认情况下，如果config_file是零，/etc/cc.conf使用。

在这个配置文件中:

  • 常规设置在远程管理器中提供有关设备的描述性信息。您可以通过Remote Manager web界面访问这些信息，并使用它轻松识别您的设备。

  • 连接设置为与Remote Manager的连接建立参数，例如启用重新连接或在尝试重新连接之前等待的时间。

  • 服务设置包括开启文件系统服务、映射虚拟目录、识别固件文件下载路径等。

  • 系统监控设置管理该特性的状态和要监控的参数。

  • 日志记录设置允许您建立日志记录级别。

有关配置设置的更多信息，请查看配置文件cc.conf．

这个函数init_cloud_connection ()返回一个cc_init_error_t指示初始化过程中是否发生任何失败的错误代码。下面的子集cc_init_error_t返回错误init_cloud_connection ():

错误 描述

CC_INIT_ERROR_NONE

操作成功完成。没有发现错误。

CC_INIT_CCAPI_START_ERROR_INSUFFICIENT_MEMORY

云连接器在分配内存以初始化连接时遇到问题。您的系统可能已经耗尽了资源。2022世界杯G组

CC_INIT_CCAPI_START_ERROR_THREAD_FAILED

尝试创建线程时出错。您的系统没有足够的资源来创建另一个线程，或者它达到了线程数2022世界杯G组量的限制。

CC_INIT_CCAPI_START_ERROR_LOCK_FAILED

Cloud Connector在使用同步机制时遇到了问题。您的系统可能已经耗尽了资源。2022世界杯G组

CC_INIT_CCAPI_START_ERROR_ALREADY_STARTED

云连接器已经初始化。

CC_INIT_ERROR_PARSE_CONFIGURATION

提供的配置文件无效。

CC_INIT_ERROR_ADD_VIRTUAL_DIRECTORY

Cloud Connector无法添加虚拟目录，因为目标目录不存在、您没有权限或它已经被映射。

开始连接

一旦正确初始化了Cloud Connector，您就可以使用function连接到Remote Managerstart_cloud_connection ()．

cc_start_error_t start_cloud_connection (无效）

此函数根据初始化时配置的设置建立与云的连接。

下面的子集cc_start_error_t返回错误start_cloud_connection ():

错误 描述

CC_START_ERROR_NONE

操作成功完成。没有发现错误。

CC_START_CCAPI_TCP_START_ERROR_ALREADY_STARTED

云连接器已经启动。

CC_START_CCAPI_TCP_START_ERROR_INSUFFICIENT_MEMORY

云连接器在分配内存以启动连接时遇到问题。您的系统可能已经耗尽了资源。2022世界杯G组

CC_START_CCAPI_TCP_START_ERROR_INIT

云连接器无法初始化与远程管理器的连接。

CC_START_ERROR_NOT_INITIALIZE

云连接器在启动前未初始化。

CC_START_ERROR_SYSTEM_MONITOR

云连接器无法启动系统监视器功能。

获取连接状态

您可以使用远程管理器获取连接的当前状态get_cloud_connection_status ()函数。

cc_status_t get_cloud_connection_status (无效）

的以下值cc_status_t可以由这个函数返回:

状态 描述

CC_STATUS_DISCONNECTED

设备未连接到远程管理器。

CC_STATUS_CONNECTING

设备正在尝试连接到远程管理器。

CC_STATUS_CONNECTED

设备已连接到远程管理器。
如果连接丢失，在配置文件(enable_reconnect设置)，一旦配置的重新连接超时时间过期，设备将自动尝试连接到远程管理器(reconnect_time设置)。

停止联系

您可以手动停止Cloud Connector，释放已分配的内存，并停止所有具有函数的活动Cloud Connector线程stop_cloud_connection ()．

cc_stop_error_t stop_cloud_connection (无效）

函数stop_cloud_connection ()返回一个cc_stop_error_t指示在停止过程中是否发生任何故障的错误代码。下面的子集cc_stop_error_t错误可以通过这个函数返回:

错误 描述

CC_STOP_ERROR_NONE

操作成功完成。没有发现错误。

CC_STOP_CCAPI_STOP_ERROR_NOT_STARTED

云连接器未启动