Adding humidity sensor
This commit is contained in:
parent
6b46c9cdb8
commit
6f373379ae
83
README.md
83
README.md
@ -19,6 +19,8 @@ This plugin currently supports the following services (and characteristics):
|
|||||||
| [ContactSensor](#contact-sensor) | Simple contact sensor, for example for windows |
|
| [ContactSensor](#contact-sensor) | Simple contact sensor, for example for windows |
|
||||||
| [Doorbell](#doorbell) | Doorbell, sends message to devices on ring |
|
| [Doorbell](#doorbell) | Doorbell, sends message to devices on ring |
|
||||||
| [Fan](#fan) | Simple on/off fan, may be extended in future |
|
| [Fan](#fan) | Simple on/off fan, may be extended in future |
|
||||||
|
| [GarageDoor](#garage-door) | Garage door opener |
|
||||||
|
| [HumiditySensor](#humidity-sensor) | Humidity sensor |
|
||||||
| [Lightbulb](#lightbulb) | Everything, from simple light to dimmable, RGB and RGBW |
|
| [Lightbulb](#lightbulb) | Everything, from simple light to dimmable, RGB and RGBW |
|
||||||
| [MotionSensor](#motion-sensor) | Detects and reports motion |
|
| [MotionSensor](#motion-sensor) | Detects and reports motion |
|
||||||
| [OccupancySensor](#occupancy-sensor) | Detects presence in a room |
|
| [OccupancySensor](#occupancy-sensor) | Detects presence in a room |
|
||||||
@ -28,7 +30,6 @@ This plugin currently supports the following services (and characteristics):
|
|||||||
| [TemperatureSensor](#temperature-sensor) | Temperature sensor |
|
| [TemperatureSensor](#temperature-sensor) | Temperature sensor |
|
||||||
| [Thermostat](#thermostat) | Thermostat with temperature sensor and heating state |
|
| [Thermostat](#thermostat) | Thermostat with temperature sensor and heating state |
|
||||||
| [WindowCovering](#window-covering) | Window covering (shutters, blinds, ...) |
|
| [WindowCovering](#window-covering) | Window covering (shutters, blinds, ...) |
|
||||||
| [GarageDoor](#garage-door) | Garage door opener |
|
|
||||||
|
|
||||||
Other accessories are being worked on and will be added as soon as ready.
|
Other accessories are being worked on and will be added as soon as ready.
|
||||||
|
|
||||||
@ -156,6 +157,60 @@ For now this accessory only supports turning the fan on and off. Further improve
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Garage Door
|
||||||
|
This accessory is used for opening/closing garage doors or any other automatic gate.
|
||||||
|
|
||||||
|
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
|
||||||
|
| Parameter | Possible values | Mandatory | Default | Description |
|
||||||
|
|:---------------------------|:----------------|:----------|:--------|:------------------------------------------------------------------|
|
||||||
|
| CurrentDoorState | \<item> | Yes | | SHNG item to monitor the current door state |
|
||||||
|
| TargetDoorState | \<item> | Yes | | SHNG item to monitor and set the target position |
|
||||||
|
| ObstructionDetected | \<item> | No | | SHNG item to monitor if the door is blocked |
|
||||||
|
|
||||||
|
#### Additional comments
|
||||||
|
|
||||||
|
Valid values for 'CurrentDoorState':
|
||||||
|
* OPEN = 0
|
||||||
|
* CLOSED = 1
|
||||||
|
* OPENING = 2
|
||||||
|
* CLOSING = 3
|
||||||
|
* STOPPED = 4
|
||||||
|
|
||||||
|
Valid values for 'TargetDoorState':
|
||||||
|
* OPEN = 0
|
||||||
|
* CLOSED = 1
|
||||||
|
|
||||||
|
'ObstructionDetected' may be set 'true' if there is any physical problem opening/closing the door.
|
||||||
|
|
||||||
|
#### Example
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"type": "GarageDoor",
|
||||||
|
"name": "GarageRechts",
|
||||||
|
"currentdoorstate": "garage.rechts.cds",
|
||||||
|
"targetdoorstate": "garage.rechts.tds",
|
||||||
|
"obstructiondetected": "garage.rechts.od"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Humidity sensor
|
||||||
|
This accessory is used for showing the current humidity value.
|
||||||
|
|
||||||
|
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
|
||||||
|
| Parameter | Possible values | Mandatory | Description |
|
||||||
|
|:-------------------|:----------------|:----------|:-------------------------------------|
|
||||||
|
| CurrentHumidity | \<item> | Yes | SHNG item to monitor humidity |
|
||||||
|
|
||||||
|
|
||||||
|
#### Example:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"type": "HumiditySensor",
|
||||||
|
"name": "Luftfeuchtigkeit Glashaus",
|
||||||
|
"CurrentHumidity": "Glashaus.Luftfeuchtigkeit"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
### LightBulb
|
### LightBulb
|
||||||
Lightbulb can be as simple as a generic on/off light, but can also be as complex as a full RGBW led strip.
|
Lightbulb can be as simple as a generic on/off light, but can also be as complex as a full RGBW led strip.
|
||||||
|
|
||||||
@ -400,32 +455,6 @@ The above optional parameters allow you to specify the neede range for your devi
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### Garage Door
|
|
||||||
This accessory type can be used for opening/closing garage doors or any automatic gates.
|
|
||||||
|
|
||||||
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
|
|
||||||
| Parameter | Possible values | Mandatory | Default | Description |
|
|
||||||
|:---------------------------|:----------------|:----------|:--------|:------------------------------------------------------------------|
|
|
||||||
| CurrentDoorState | \<item> | Yes | | SHNG item to monitor the current door state |
|
|
||||||
| TargetDoorState | \<item> | Yes | | SHNG item to monitor and set the target position |
|
|
||||||
| ObstructionDetected | \<item> | No | | SHNG item to monitor if the door is blocked |
|
|
||||||
|
|
||||||
#### Additional comments
|
|
||||||
|
|
||||||
CurrentDoorState can be OPEN, CLOSED, OPENING, CLOSING and STOPPED. TargetDoorState can be OPEN or CLOSED.
|
|
||||||
ObstructionDetected can be set to true if there is a physical problem opening/closing the door.
|
|
||||||
|
|
||||||
#### Example
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"type": "GarageDoor",
|
|
||||||
"name": "GarageRechts",
|
|
||||||
"currentdoorstate": "garage.rechts.cds",
|
|
||||||
"targetdoorstate": "garage.rechts.tds",
|
|
||||||
"obstructiondetected": "garage.rechts.od"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Example configuration file
|
### Example configuration file
|
||||||
This is an example config file which just uses this plugin and some example SmartHomeNG items.
|
This is an example config file which just uses this plugin and some example SmartHomeNG items.
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user