配网服务

更新时间：2018-08-14 18:26:52

awss_start()

返回值

  /**
    * @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()

返回值

  /**
    * @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()

返回值

awss_report_reset()

返回值

  /**
   * @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();