使用云连接器API,您可以随时连接或断开远程管理器。管理连接到远程管理器使用以下功能:

函数 描述

cc_init_error_t init_cloud_connection (const char * config_file)

初始化云连接器提供的参数配置文件。如果它是零使用默认配置文件的位置(/etc/cc.conf)。

cc_start_error_t start_cloud_connection(空白)

打开云连接器连接。

cc_status_t get_cloud_connection_status(空白)

返回云连接器连接状态。

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 ();如果(start_error ! = CC_START_ERROR_NONE) {log_error (“不能开始云连接,错误% d”,start_error);返回EXIT_FAILURE;}[…]stop_error = stop_cloud_connection ();[…]返回EXIT_SUCCESS;}

初始化连接

初始化过程配置云连接器提供配置文件中的值。

cc_init_error_t init_cloud_connection (常量字符* config_file)

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

在这个配置文件:

  • 一般设置为描述性信息设备远程管理。您可以访问这些信息通过远程管理web界面和使用它来轻松地确定您的设备。

  • 连接设置建立连接与远程管理器的参数,如使重新连接或试图重新连接之前等待的时间。

  • 服务设置允许您启用文件系统服务,地图虚拟目录,或识别路径下载的固件文件。

  • 系统监视设置管理这个功能的状态和参数监测。

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

关于配置设置的更多信息,检查配置文件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

云连接器遇到问题使用同步机制。您的系统可能会耗尽资源。2022世界杯G组

CC_INIT_CCAPI_START_ERROR_ALREADY_STARTED

云连接器已经初始化。

CC_INIT_ERROR_PARSE_CONFIGURATION

提供的配置文件是无效的。

CC_INIT_ERROR_ADD_VIRTUAL_DIRECTORY

云连接器不能添加一个虚拟目录,因为目标目录不存在,你没有权限,或者它已经映射。

开始连接

一旦云连接器被初始化,你可以连接到远程管理器使用函数start_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设置)。

停止联系

您可以手动停止云连接器,自由分配的内存,并停止所有云连接器的活动线程函数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

云连接器没有开始