feat(wifi): Add vendor ie API description

wujiangang · wujiangang · commit 802390060e91 · 2017-08-30T18:38:36.000+08:00
internal: 45cf72a6
diff --git a/include/espressif/esp_wifi.h b/include/espressif/esp_wifi.h
@@ -832,6 +832,18 @@ typedef enum {
     VND_IE_TYPE_NUM,
 } vendor_ie_type;
 
+/**
+  * @brief  Vendor IE received callback.
+  *
+  * @param  vendor_ie_type type :  type of vendor IE.
+  * @param  const uint8 sa[6] : source address of the packet.
+  * @param  uint8 *vendor_ie : pointer of vendor IE.
+  * @param  sint32 rssi : signal strength.
+  *
+  * @return null
+  */
+typedef void (*vendor_ie_recv_cb_t)(vendor_ie_type type, const uint8 sa[6], const uint8 *vnd_ie, sint32 rssi);
+
 /**
   * @brief  Set Vendor IE of ESP8266.
   *
@@ -852,6 +864,25 @@ typedef enum {
   */
 bool wifi_set_vnd_ie(bool enable, vendor_ie_type type, uint8_t idx, uint8_t *vnd_ie);
 
+/**
+  * @brief   Register vendor IE received callback.
+  *
+  * @param   vendor_ie_recv_cb_t cb : callback
+  *
+  * @return  0 : succeed
+  * @return -1 : fail
+  */
+sint32 wifi_register_vnd_ie_recv_cb(vendor_ie_recv_cb_t cb);
+
+/**
+  * @brief  Unregister vendor IE received callback.
+  *
+  * @param  null
+  *
+  * @return null
+  */
+void wifi_unregister_vnd_ie_recv_cb(void);
+
 /**
   * @}
   */
