配网服务

更新时间:2018-10-19 11:29:34

awss_start()

函数原型 int awss_start(void)
描述 进入配网模式。当用户触控设备之后,调用awss_config_press()确认进行配网。

返回值

详细描述
0
进入配网模式成功
-1
进入配网模式失败
  /**
    * @brief   开始AWSS服务功能,但是配网的功能没有使能
    *
    * @retval  -1 : 失败
    * @retval  0 : 成功
    * @note:
    *     1) 该API仅仅是开启服务,但是出于安全考虑,配网的功能并没有使能,使能配网还需要调用
    *        awss_config_press();
    *     2) 开启服务主要完成设备发现和AP列表收集,设备发现用于零配和路由器配网,而AP收集主要为了校正信道和SSID;        
    *     3)awss_start是一个block的操作,一旦调用直到配网成功才会返回;          
    */
  int awss_start();

awss_config_press()

函数原型 int awss_config_press(void)
描述 确认进行配网。调用该接口之前,需要调用awss_start()进入配网模式。 另外,用户触控了设备之后才可以调用该接口,一旦配网功能使能,设备发现功能就会关闭。

返回值

详细描述
0
配网功能使能成功
-1
配网功能使能失败
  /**
    * @brief   用户确认使能配网功能
    *
    * @retval  -1 : failure
    * @retval  0 : success
    * @note:
    *       1)使能配网需要分别调用awss_start和awss_config_press,这两个API的调用没有先后顺序
    *          但是awss_start是个block的操作;
    *       2)awss_config_press一般需要设备感知用户操作才调用的API,一般借助于中断实现,如按键等;
    *       3)awss_config_press的超时时间最少是60秒,具体时间由HAL的API确定
    *         (HAL_Awss_Get_Timeout_Interval_Ms)
    *       4)该API只是设置一个使能配网的标志位,设备一次配网失败或超时时,该标志位会被清除,
    *          用户要想进入下一次配网,必须再次触达设备确认使能配网;          
    */
  int awss_config_press();

awss_report_cloud()

函数原型
int awss_report_cloud(void)
描述
当配网成功后,调用该函数发送token到云服务器。
该API已经在Linkkit内部流程中自动调用了,上层应用不用再调用该API

返回值

详细描述
0
发送token成功
-1
发送token失败

awss_report_reset()

函数原型 void awss_report_reset(void)
描述 当设备配网成功后,云端会把设备和用户账户绑定在一块,该函数用于重置云端的设备信息

返回值

详细描述
void
  /**
   * @brief   设备向云端上报恢复出厂设置
   *
   * @retval  -1 : failure
   * @retval  0 : sucess
   * @note
   *      1)aos1.3.1中该操作是一个block的操作,调用该接口时一定要确保设备和云端的连接可用;
   *      2)aos1.3.2已经实现了离线恢复出厂设备,调用该API不需要检查设备与云端的连接可用,
   *         一但产品调用了该API,AWSS会在Flash记录reset的标志位,并尝试向云端上报reset,
   *         如果确定收到云端的回复才会清楚Flash中的reset标志;设备重启连接上云之后,  
   *         Linkkit会检查Flash中的reset标志,如果reset标志存在,会自动向云端上报reset;       
   */
  int awss_report_reset();

results matching ""

    No results matching ""