List of changes in components/wifi_provisioning: * Manager version is now v1.1 * .proto files and protocomm handler added for sending Wi-Fi scan command and receiving scan results * Implemented handlers for wifi_scan protocomm endpoint * Update manager context data structure to hold scan state and results * scheme_softap now runs Wi-Fi in APSTA mode * Wi-Fi is started in AP mode when provisioning is started. This is necessary for scan list to work * Docs updates with information about new wifi_scan endpoint List of changes in tools/esp_prov: * Added functions for sending and receiving protobuf messages compatible with wifi_scan protocomm endpoint * Added feature to display/refresh scan results and accept user selection at runtime * New functions: * get_version() : only returns the protocol version string * has_capability() : check is a capability is present according to proto-ver response * wifi_scan feature is provided only if the `wifi_scan` capability is present Other changes: * Replace recursive mutex with plain mutex * assert on return value of mutex give / take calls * replace all calls with macros ACQUIRE_LOCK and RELEASE_LOCK * some checks added in scanning related private APIs * free and nullify scanning context and state if service is stopped while ongoing scan
104 lines
3.2 KiB
C
104 lines
3.2 KiB
C
// Copyright 2019 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#pragma once
|
|
|
|
#include <esp_event_loop.h>
|
|
|
|
#include <protocomm.h>
|
|
#include <protocomm_security.h>
|
|
|
|
#include "wifi_provisioning/manager.h"
|
|
#include "wifi_provisioning/wifi_config.h"
|
|
#include "wifi_provisioning/wifi_scan.h"
|
|
|
|
/**
|
|
* @brief Notify manager that provisioning is done
|
|
*
|
|
* Stops the provisioning. This is called by the get_status_handler()
|
|
* when the status is connected. This has no effect if main application
|
|
* has disabled auto stop on completion by calling
|
|
* wifi_prov_mgr_disable_auto_stop()
|
|
*
|
|
* @return
|
|
* - ESP_OK : Provisioning will be stopped
|
|
* - ESP_FAIL : Failed to stop provisioning
|
|
*/
|
|
esp_err_t wifi_prov_mgr_done(void);
|
|
|
|
/**
|
|
* @brief Start Wi-Fi AP Scan
|
|
*
|
|
* @param[in] blocking Set true to return only after scanning is complete
|
|
* @param[in] passive Set true to perform passive scan instead of default active scan
|
|
* @param[in] group_channels Number of channels to scan in one go
|
|
* (set to 0 for scanning all channels in one go)
|
|
* @param[in] period_ms Scan time (in milli-seconds) on each channel
|
|
*
|
|
* @return
|
|
* - ESP_OK : Successfully started Wi-Fi scanning
|
|
* - ESP_FAIL : Provisioning app not running
|
|
*/
|
|
esp_err_t wifi_prov_mgr_wifi_scan_start(bool blocking, bool passive,
|
|
uint8_t group_channels,
|
|
uint32_t period_ms);
|
|
|
|
/**
|
|
* @brief Use to query the state of Wi-Fi scan
|
|
*
|
|
* @return
|
|
* - true : Scan finished
|
|
* - false : Scan running
|
|
*/
|
|
bool wifi_prov_mgr_wifi_scan_finished(void);
|
|
|
|
/**
|
|
* @brief Get the count of results in the scan list
|
|
*
|
|
* @return
|
|
* - count : Number of Wi-Fi Access Points detected while scanning
|
|
*/
|
|
uint16_t wifi_prov_mgr_wifi_scan_result_count(void);
|
|
|
|
/**
|
|
* @brief Get AP record for a particular index in the scan list result
|
|
*
|
|
* @param[out] index Index of the result to fetch
|
|
*
|
|
* @return
|
|
* - result : Pointer to Access Point record
|
|
*/
|
|
const wifi_ap_record_t *wifi_prov_mgr_wifi_scan_result(uint16_t index);
|
|
|
|
/**
|
|
* @brief Get protocomm handlers for wifi_config provisioning endpoint
|
|
*
|
|
* @param[out] ptr pointer to structure to be set
|
|
*
|
|
* @return
|
|
* - ESP_OK : success
|
|
* - ESP_ERR_INVALID_ARG : null argument
|
|
*/
|
|
esp_err_t get_wifi_prov_handlers(wifi_prov_config_handlers_t *ptr);
|
|
|
|
/**
|
|
* @brief Get protocomm handlers for wifi_scan provisioning endpoint
|
|
*
|
|
* @param[out] ptr pointer to structure to be set
|
|
*
|
|
* @return
|
|
* - ESP_OK : success
|
|
* - ESP_ERR_INVALID_ARG : null argument
|
|
*/
|
|
esp_err_t get_wifi_scan_handlers(wifi_prov_scan_handlers_t *ptr);
|