Interactua con el API de eWelink desde .NET con eWelinkNET Deja un comentario
eWelinkNET es un API escrito en .NET Standard que nos permite interactuar directamente con al API de eWelink usando tus credenciales de usuario. eWelinkNET es compatible con Windows, Linux y MAC, Android e iOS.
Algunas de las características claves de ewelinkNET son:
- Encender y apagar dispotivios
- Leer medidas (humedad, temperatura…)
- Escuchar los eventos del dispositivo a través de Websocket
- Trabajar en modo online y offline (también conocido como LAN mode o Zeroconf)
- Multiplataforma
Basic usage
Aquí tenemos un ejemplo básico de cómo emplear ewelinkNET.
|
var ewelink = new Ewelink(Email, Password, Region); await ewelink.GetCredentials(); await ewelink.GetDevices(); var device = ewelink.Devices.First(x=> x.deviceid == deviceId) as SwitchDevice; device.TurnOn(); |
Obtener credenciales
Podemos obtener las credenciales necesarias para realizar las acciones necesarias mediante nuestro Email, Password y Region.
|
var ewelink = new Ewelink(Email, Password, Region); var credentials = await ewelink.GetCredentials(); |
alternativamente, puedes guardar las credenciales obtenidas para evitar tener que hacer login posteriormente.
|
ewelink.StoreCredenditalsFromFile(); |
Posteriormente, podemos recuperar las credenciales haciendo.
|
ewelink.RestoreCredenditalsFromFile(); |
Get Devices
Podemos obtener los dispositivos registrados en tu cuenta eWelink.
|
var ewelink = new Ewelink(Email, Password, Region); await ewelink.GetCredentials(); await ewelink.GetDevices(); |
Los dispositivos se convierten en las siguientes clases.
- SwitchDevice
- MultiSwitchDevice
- ThermostatDevice
- RFBridgeDevice
- CurtainDevice
Todos ellas derivan de la clase base ‘Device’.
Interactuar con los dispositivos
Cada clase dispone de sus propios métodos para realizar las acciones permitidas por el tipo de dispositivo.
Each class provides there own methods to perform actions or retrieve measurement.
Así, por ejemplo, ‘ThermostatDevice’ proporciona,
- TurnOn()
- TurnOff()
- Toggle()
- GetTemperature()
- GetHumidity()
Mientras que ‘MultiSwitchDevice’ proporciona,
- TurnOn()
- TurnOn(int channel)
- TurnOff()
- TurnOff(int channel)
Escuchar a cambios en el dispositivo
Los cambios en el estado del dispositivo se obtienen a través de una conexión Websocket. El dispositivo lanza los eventos oportunos ante un cambio de estado.
|
ewelink.websocket.OnMessage += (s, e) => Console.WriteLine(e.AsJson()); ewelink.OpenWebsocket(); |
Además de lanzar los eventos necesarios, los dispositivos se actualizan internamente acorde al nuevo estado.
Zeroconf (LAN mode)
Es posible interactuar con los dispositivos eWelink a través del modo LAN (también llamado Zeroconf), sin necesidad de conexión a internet o acceso a la nube de eWelink.
Para que el modo LAN funcione, hay que proporcionar una tabla ARP (una relación de MAC-IP) para poder encontrar la IP del dispositivo.
For LAN mode to work, a ArpTable (and list or the Mac – Ip relationship) has to be provided, to allow find the device Ip.
|
ewelink.RestoreArpTableFromFile(); |
Descarga el código
eWelink es un desarrollo OpenSource. El código de esta entrada está disponible para su descarga en GitHub.
