kopia lustrzana https://github.com/espressif/esp-idf
102 wiersze
3.0 KiB
C
102 wiersze
3.0 KiB
C
/* Common functions for protocol examples, to establish Wi-Fi or Ethernet connection.
|
|
|
|
This example code is in the Public Domain (or CC0 licensed, at your option.)
|
|
|
|
Unless required by applicable law or agreed to in writing, this
|
|
software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
|
|
CONDITIONS OF ANY KIND, either express or implied.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "sdkconfig.h"
|
|
#include "esp_err.h"
|
|
#include "esp_netif.h"
|
|
#if CONFIG_EXAMPLE_CONNECT_ETHERNET
|
|
#include "esp_eth.h"
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if CONFIG_EXAMPLE_CONNECT_WIFI
|
|
#define EXAMPLE_NETIF_DESC_STA "example_netif_sta"
|
|
#endif
|
|
|
|
#if CONFIG_EXAMPLE_CONNECT_ETHERNET
|
|
#define EXAMPLE_NETIF_DESC_ETH "example_netif_eth"
|
|
#endif
|
|
|
|
/* Example default interface, prefer the ethernet one if running in example-test (CI) configuration */
|
|
#if CONFIG_EXAMPLE_CONNECT_ETHERNET
|
|
#define EXAMPLE_INTERFACE get_example_netif_from_desc(EXAMPLE_NETIF_DESC_ETH)
|
|
#define get_example_netif() get_example_netif_from_desc(EXAMPLE_NETIF_DESC_ETH)
|
|
#elif CONFIG_EXAMPLE_CONNECT_WIFI
|
|
#define EXAMPLE_INTERFACE get_example_netif_from_desc(EXAMPLE_NETIF_DESC_STA)
|
|
#define get_example_netif() get_example_netif_from_desc(EXAMPLE_NETIF_DESC_STA)
|
|
#endif
|
|
|
|
/**
|
|
* @brief Configure Wi-Fi or Ethernet, connect, wait for IP
|
|
*
|
|
* This all-in-one helper function is used in protocols examples to
|
|
* reduce the amount of boilerplate in the example.
|
|
*
|
|
* It is not intended to be used in real world applications.
|
|
* See examples under examples/wifi/getting_started/ and examples/ethernet/
|
|
* for more complete Wi-Fi or Ethernet initialization code.
|
|
*
|
|
* Read "Establishing Wi-Fi or Ethernet Connection" section in
|
|
* examples/protocols/README.md for more information about this function.
|
|
*
|
|
* @return ESP_OK on successful connection
|
|
*/
|
|
esp_err_t example_connect(void);
|
|
|
|
/**
|
|
* Counterpart to example_connect, de-initializes Wi-Fi or Ethernet
|
|
*/
|
|
esp_err_t example_disconnect(void);
|
|
|
|
/**
|
|
* @brief Configure stdin and stdout to use blocking I/O
|
|
*
|
|
* This helper function is used in ASIO examples. It wraps installing the
|
|
* UART driver and configuring VFS layer to use UART driver for console I/O.
|
|
*/
|
|
esp_err_t example_configure_stdin_stdout(void);
|
|
|
|
/**
|
|
* @brief Returns esp-netif pointer created by example_connect() described by
|
|
* the supplied desc field
|
|
*
|
|
* @param desc Textual interface of created network interface, for example "sta"
|
|
* indicate default WiFi station, "eth" default Ethernet interface.
|
|
*
|
|
*/
|
|
esp_netif_t *get_example_netif_from_desc(const char *desc);
|
|
|
|
#if CONFIG_EXAMPLE_PROVIDE_WIFI_CONSOLE_CMD
|
|
/**
|
|
* @brief Register wifi connect commands
|
|
*
|
|
* Provide a simple wifi_connect command in esp_console.
|
|
* This function can be used after esp_console is initialized.
|
|
*/
|
|
void example_register_wifi_connect_commands(void);
|
|
#endif
|
|
|
|
#if CONFIG_EXAMPLE_CONNECT_ETHERNET
|
|
/**
|
|
* @brief Get the example Ethernet driver handle
|
|
*
|
|
* @return esp_eth_handle_t
|
|
*/
|
|
esp_eth_handle_t get_example_eth_handle(void);
|
|
#endif // CONFIG_EXAMPLE_CONNECT_ETHERNET
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|