noe/homebridge-smarthomeng
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Typo corrections

Browse Source
This commit is contained in:
Serge Wagener 2022-02-15 11:41:13 +01:00
parent 3248262e7a
commit 660fd07e2e
1 changed files with 39 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@ -53,23 +53,31 @@ If you already have a working homebridge installation just add the platform sect
### Platform configuration ### Platform configuration
The following parameters are available to configure the plugin as platform in homebridge. The following parameters are available to configure the plugin as platform in homebridge.
| Parameter | Possible values | Mandatory | Description |
|:----------|:---------------------------------------|:----------|:----------------------------------------------------|
| platform | Any \<string> | Yes | Internal name of your platform |
| name | Any \<string> | Yes | Visible name in HomeKit |
| host | IP address or FQDN of your SHNG server | Yes | Your SHNG host |
| port | Port \<number> | No | Listening port of websocket module. Default is 2424 |
| tls | \<boolean> | No | Should TLS encryption be used. Defaults is 'false' |
#### Example configuration:
```json ```json
{ {
"platform": "SmartHomeNG", "platform": "SmartHomeNG",
"name": "SmartHomeNG", "name": "SmartHomeNG",
"host": "<your SHNG server name or IP>", "host": "smarthome.my.domain",
"port": 2425, "port": 2425,
"tls": true, "tls": true,
} }
``` ```
If the `port` and `tls` parameters are not specified the plugin defaults to port 2424 without tls encryption.
### Common accessories characteristics ### Common accessories characteristics
The following characteristics are valid for all accessories: The following characteristics are valid for all accessories:
| Parameter | Possible values | Mandatory | Description | | Parameter | Possible values | Mandatory | Description |
|:-------------|:----------------------------------------------|:----------|:--------------------------------| |:-------------|:-----------------------------------------------|:----------|:--------------------------------|
| type | <type> from the above list of supported types | Yes | Type of accessory | | type | \<type> from the above list of supported types | Yes | Type of accessory |
| name | Any \<string> | Yes | Visible name in HomeKit | | name | Any \<string> | Yes | Visible name in HomeKit |
| manufacturer | Any \<string> | No | Visible manufacturer in HomeKit | | manufacturer | Any \<string> | No | Visible manufacturer in HomeKit |
| model | Any \<string> | No | Visible model in HomeKit | | model | Any \<string> | No | Visible model in HomeKit |
@ -90,7 +98,7 @@ Further investigation is needed, but for now it still works.
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics) #### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
| Parameter | Possible values | Mandatory | Description | | Parameter | Possible values | Mandatory | Description |
|:-------------|:----------------|:----------|:---------------------------------------| |:-------------|:----------------|:----------|:---------------------------------------|
| SinglePress | <item> | Yes | SHNG item to monitor for doorbell ring | | SinglePress | \<item> | Yes | SHNG item to monitor for doorbell ring |
#### Example: #### Example:
```json ```json
@ -107,7 +115,7 @@ For now this accessory only supports turning the fan on and off. Further improve
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics) #### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
| Parameter | Possible values | Mandatory | Description | | Parameter | Possible values | Mandatory | Description |
|:----------|:----------------|:----------|:---------------------------------------| |:----------|:----------------|:----------|:---------------------------------------|
| Active | <item> | Yes | SHNG item to set and get the fan state | | Active | \<item> | Yes | SHNG item to set and get the fan state |
#### Example: #### Example:
@ -128,7 +136,7 @@ This sensor is tripped if it detects presence in a room.
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics) #### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
| Parameter | Possible values | Mandatory | Description | | Parameter | Possible values | Mandatory | Description |
|:------------------|:----------------|:----------|:----------------------------------| |:------------------|:----------------|:----------|:----------------------------------|
| OccupancyDetected | <item> | Yes | SHNG item to monitor for presence | | OccupancyDetected | \<item> | Yes | SHNG item to monitor for presence |
#### Example: #### Example:
@ -148,7 +156,7 @@ This sensor is tripped if it detects motion in a room.
#### Characteristics in addition to [common characteristics](#common-accessories-characteristics) #### Characteristics in addition to [common characteristics](#common-accessories-characteristics)
| Parameter | Possible values | Mandatory | Description | | Parameter | Possible values | Mandatory | Description |
|:---------------|:----------------|:----------|:--------------------------------| |:---------------|:----------------|:----------|:--------------------------------|
| MotionDetected | <item> | Yes | SHNG item to monitor for motion | | MotionDetected | \<item> | Yes | SHNG item to monitor for motion |
#### Example: #### Example: