Update WiFiInterface.h

pull/8541/head
Paul Szczepanek 2018-10-25 11:24:11 +01:00 committed by GitHub
parent de261a4673
commit 5241c3b38d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 7 deletions

View File

@ -22,13 +22,13 @@
#include "netsocket/NetworkInterface.h" #include "netsocket/NetworkInterface.h"
#include "netsocket/WiFiAccessPoint.h" #include "netsocket/WiFiAccessPoint.h"
/** Common interface that is shared between WiFi devices. /** Common interface that is shared between Wi-Fi devices.
* *
* @addtogroup netsocket * @addtogroup netsocket
*/ */
class WiFiInterface: public virtual NetworkInterface { class WiFiInterface: public virtual NetworkInterface {
public: public:
/** Get the default WiFi interface. /** Get the default Wi-Fi interface.
* *
* This is provided as a weak method so applications can override. * This is provided as a weak method so applications can override.
* Default behaviour is to get the target's default interface, if * Default behaviour is to get the target's default interface, if
@ -38,7 +38,7 @@ public:
*/ */
static WiFiInterface *get_default_instance(); static WiFiInterface *get_default_instance();
/** Set the WiFi network credentials. /** Set the Wi-Fi network credentials.
* *
* @param ssid Name of the network to connect to. * @param ssid Name of the network to connect to.
* @param pass Security passphrase to connect to the network. * @param pass Security passphrase to connect to the network.
@ -49,7 +49,7 @@ public:
virtual nsapi_error_t set_credentials(const char *ssid, const char *pass, virtual nsapi_error_t set_credentials(const char *ssid, const char *pass,
nsapi_security_t security = NSAPI_SECURITY_NONE) = 0; nsapi_security_t security = NSAPI_SECURITY_NONE) = 0;
/** Set the WiFi network channel. /** Set the Wi-Fi network channel.
* *
* @param channel Channel on which the connection is to be made, or 0 for any (Default: 0). * @param channel Channel on which the connection is to be made, or 0 for any (Default: 0).
* @return NSAPI_ERROR_OK on success, or error code on failure. * @return NSAPI_ERROR_OK on success, or error code on failure.
@ -63,7 +63,7 @@ public:
*/ */
virtual int8_t get_rssi() = 0; virtual int8_t get_rssi() = 0;
/** Attempt to connect to a WiFi network. /** Attempt to connect to a Wi-Fi network.
* *
* @param ssid Name of the network to connect to. * @param ssid Name of the network to connect to.
* @param pass Security passphrase to connect to the network. * @param pass Security passphrase to connect to the network.
@ -74,7 +74,7 @@ public:
virtual nsapi_error_t connect(const char *ssid, const char *pass, virtual nsapi_error_t connect(const char *ssid, const char *pass,
nsapi_security_t security = NSAPI_SECURITY_NONE, uint8_t channel = 0) = 0; nsapi_security_t security = NSAPI_SECURITY_NONE, uint8_t channel = 0) = 0;
/** Attempt to connect to a WiFi network. Requires ssid and passphrase to be set. /** Attempt to connect to a Wi-Fi network. Requires ssid and passphrase to be set.
* If passphrase is invalid, NSAPI_ERROR_AUTH_ERROR is returned. * If passphrase is invalid, NSAPI_ERROR_AUTH_ERROR is returned.
* *
* @return NSAPI_ERROR_OK on success, negative error code on failure * @return NSAPI_ERROR_OK on success, negative error code on failure
@ -110,7 +110,7 @@ public:
#if !defined(DOXYGEN_ONLY) #if !defined(DOXYGEN_ONLY)
protected: protected:
/** Get the target's default WiFi interface. /** Get the target's default Wi-Fi interface.
* *
* This is provided as a weak method so targets can override. The * This is provided as a weak method so targets can override. The
* default implementation returns NULL. * default implementation returns NULL.