Clase genérica¶
Los métodos y propiedades que se describen en esta sección son específicos de ESP8266. No están cubiertos en la documentación de la librería WiFi de Arduino. Antes de que estén completamente documentados, consulte la información a continuación.
onEvent¶
void onEvent (WiFiEventCb cb, WiFiEvent_t event=WIFI_EVENT_ANY) __attribute__((deprecated))
Para ver como se utiliza onEvent
comprueba el sketch de ejemplo WiFiClientEvents.ino disponible dentro de la carpeta de ejemplos de la librería ESP8266WiFi.
WiFiEventHandler¶
WiFiEventHandler onStationModeConnected (std::function< void(const WiFiEventStationModeConnected &)>)
WiFiEventHandler onStationModeDisconnected (std::function< void(const WiFiEventStationModeDisconnected &)>)
WiFiEventHandler onStationModeAuthModeChanged (std::function< void(const WiFiEventStationModeAuthModeChanged &)>)
WiFiEventHandler onStationModeGotIP (std::function< void(const WiFiEventStationModeGotIP &)>)
WiFiEventHandler onStationModeDHCPTimeout (std::function< void(void)>)
WiFiEventHandler onSoftAPModeStationConnected (std::function< void(const WiFiEventSoftAPModeStationConnected &)>)
WiFiEventHandler onSoftAPModeStationDisconnected (std::function< void(const WiFiEventSoftAPModeStationDisconnected &)>)
Para ver un ejemplo de aplicación con WiFiEventHandler
, comprueba la sección separada con ejemplos dedicados específicamente a la clase genérica.
persistent¶
WiFi.persistent(persistent)
El ESP8266 puede volver a conectarse a la red Wi-Fi utilizada por última vez al encenderse o establece el mismo punto de acceso al encender o restablecer. De forma predeterminada, estas configuraciones se escriben en sectores específicos de la flash cada vez que se cambian en WiFi.begin(ssid, password)
o WiFi.softAP(ssid, passphrase, channel)
, y cuando se invoca a WiFi.disconnect
o WiFi.softAPdisconnect
. Llamar con frecuencia a estas funciones podría ocasionar desgaste en la memoria flash (consulte el issue #1054).
Si establece WiFi.persistent(false)
, entonces WiFi.begin
, WiFi.disconnect
, WiFi.softAP
o WiFi.softAPdisconnect
solo cambian los ajustes actuales de Wi-Fi en memoria y no afecta la configuración de Wi-Fi almacenada en la memoria flash.
mode¶
WiFi.mode(m)
WiFi.getMode()
WiFi.mode(m)
: establece el modo aWIFI_AP
,WIFI_STA
,WIFI_AP_STA
oWIFI_OFF
WiFi.getMode()
: devuelve el modo WiFi actual (alguno de los cuatro anteriores)
Administración de energía WiFi, DTIM¶
El tipo de modo de suspensión es WIFI_NONE_SLEEP
, WIFI_LIGHT_SLEEP
o WIFI_MODEM_SLEEP
. (listenInterval
apareció en esp8266-arduino core v2.5.0 utilizando la última revisión de V2 de nonos-sdk antes de V3)
Citando la hoja de datos de nonos-sdk:
NONE
: desactiva el ahorro de energíaLIGHT
oMODEM
: tasa de temporizador TCP aumentada de 250 ms a 3 segundos
Cuando listenInterval
se establece en 1..10, en el modo LIGHT
o MODEM
, la estación se activa cada (DTIM-interval * listenInterval
). Esto salva energía pero la interfaz de la estación puede perder datos de transmisión. De lo contrario (valor predeterminado 0), la estación se activa a cada intervalo DTIM (configurado en el punto de acceso).
Citando Wikipedia: Un mapa de indicación de tráfico de entrega (DTIM) es un tipo de mapa de indicación de tráfico (TIM) que informa a los clientes sobre la presencia de búferes de datos de multicast/broadcast en el punto de acceso. Se genera dentro de la beacon periódica a una frecuencia especificada por el intervalo DTIM. Las bbeacon son paquetes enviados por un punto de acceso para sincronizar una red inalámbrica.
Otras llamadas a funciones¶
int32_t channel (void)
bool setSleepMode (WiFiSleepType_t type)
WiFiSleepType_t getSleepMode ()
bool setPhyMode (WiFiPhyMode_t mode)
WiFiPhyMode_t getPhyMode ()
void setOutputPower (float dBm)
WiFiMode_t getMode ()
bool enableSTA (bool enable)
bool enableAP (bool enable)
bool forceSleepBegin (uint32 sleepUs=0)
bool forceSleepWake ()
int hostByName (const char *aHostname, IPAddress &aResult)
Documentación para las funciones anteriores aún no está preparada.
Consulte la sección separada con ejemplos dedicados específicamente a la clase genérica.