https://github.com/albertogeniola/dlinkw215
https://github.com/albertogeniola/dlinkw215
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/albertogeniola/dlinkw215
- Owner: albertogeniola
- Created: 2018-08-19T19:31:55.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-21T20:08:06.000Z (almost 8 years ago)
- Last Synced: 2025-09-09T01:38:52.446Z (9 months ago)
- Language: C#
- Size: 39.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DLinkW215
This is a C# port of the nice [pyW215](https://github.com/LinuxChristian/pyW215)
python library for the DLink W215 smart plug. Credits go to both @LinuxChristian and
to @bikerp, who both contributed to the creation of respectively Python and Javascript
implementations.
Just to be clear, the following is the PowerPlug we are talking about:
## Installation
In order to use this library in your projects, you might either reference the package via NuGet or download the project and reference the library externally.
I strongly recommend to use NuGet package manager to do so. The package has been pushed on NuGet repository: https://www.nuget.org/packages/DLinkW215/.
From the package manager console:
PM> Install-Package DLinkW215 -Version 0.0.2
Or from .NET CLI
> dotnet add package DLinkW215 --version 0.0.2
Or from Packet CLI
> paket add DLinkW215 --version 0.0.2
## Usage
The library is pretty easy to use:
```cs
// The first parameter is the IP address of the power plug
// while the second one is the ACCESS CODE printed on the plug itself
var plug = new DLinkW215SmartPlug("192.168.1.9", "123456");
// Returns the current power switch state
var state = plug.GetState();
// Return the current power consumption in Watts. If an error occurred, null is returned.
var powerConsumption = plug.GetCurrentConsumption();
if (powerConsumption==null)
Console.Out.WriteLine("Current consumption is " + powerConsumption + " Watts");
else
Console.Out.WriteLine("An error occurred and it was not possible to read the power consumtpion from the device");
// Same thing happens for the following:
// plug.GetTotalConsumption()
// plug.GetTemperature() // In Celsius!
// Turn the switch On
plug.SetState(DLinkW215.DLinkW215SmartPlug.On);
// Turn the switch Off
plug.SetState(DLinkW215.DLinkW215SmartPlug.Off);
```
## Notes and known issues
The library works as expected, however no verbose error handling system has been implemented. This means that, if there is something wrong, exception are not well handled. Most of the APIs will simply catch any exception and return null instead.