Add Alarm docs
Update docs to reflect the current state (new features & changes)
This commit is contained in:
Edward Firmo
107
README.md
107
README.md
@@ -28,6 +28,7 @@ The goal was to create a version that allows everyone to use the NSpanel fully l
|
||||
|
||||
🙋 WE ARE LOOKING FOR YOU! _**We are always looking for people who would like to support this project. We are looking for help with "programming new features, writing documentation or translating documentation to EN. If you are interested then please contact us :)**_
|
||||
|
||||
|
||||
## NSPanel:
|
||||
|
||||
|
||||
@@ -35,46 +36,46 @@ The goal was to create a version that allows everyone to use the NSpanel fully l
|
||||
|
||||
|
||||
|
||||
(Home and Buttonpage)
|
||||
(Home and Button page)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
(Lightsettings - Brightness and TEMP Color)
|
||||
(Light settings - Brightness and TEMP Color)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
(Colorwheel and Thermostat)
|
||||
(Light color wheel and Thermostat)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
(Coversetting and Weather Forecast)
|
||||
(Cover settings and Weather forecast)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
(NSPanel Settings and Boot Screen)
|
||||
(NSPanel settings and Boot screen)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
(HA Device Setting for Example temperature correction)
|
||||
|
||||
(HA device settings - Temperature correction)
|
||||
|
||||
|
||||
## Blueprint:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Features:
|
||||
- Easy to use and simple configuration via Blueprint - no change in the code is necessary
|
||||
- 32 buttons on 4 button pages with long press function for settings (more buttons are also possible)
|
||||
@@ -82,9 +83,9 @@ The goal was to create a version that allows everyone to use the NSpanel fully l
|
||||
- Buttons show current brightness and cover position in the button itself
|
||||
- Buttons label can be assigned via blueprint
|
||||
- Weather + 5 days weather forecast
|
||||
- Thermostat + Touch + Relay control for floor heating
|
||||
- Light control (brightness-slider, colorwheel, TempColor-slider) - via long Press
|
||||
- Cover control (open, close, position-slider) - via long press
|
||||
- Thermostat + Touch + [Relay control for floor heating](/docs/en/addon_climate.md)
|
||||
- Light control (brightness, color and temperature) - via long Press
|
||||
- Cover control (open, close and position) - via long press
|
||||
- Settings page (display brightness, display dim brightness, sleep mode, reboot NSPanel)
|
||||
- Swipe between pages
|
||||
- Top menu with 10 icons for specific states
|
||||
@@ -93,10 +94,10 @@ The goal was to create a version that allows everyone to use the NSpanel fully l
|
||||
- 2 physical switches with optional fallback mode
|
||||
- and much more ;)
|
||||
|
||||
|
||||
## Pages
|
||||
|
||||
# Pages
|
||||
|
||||
## Home
|
||||
### Home
|
||||
- Current weather with button to Weather Forcast page
|
||||
- Hardware buttons can be freely assigned
|
||||
- Hardware button label (optional)
|
||||
@@ -107,63 +108,69 @@ The goal was to create a version that allows everyone to use the NSpanel fully l
|
||||
- Room humidity
|
||||
- Up to 3 user's selectable entities
|
||||
|
||||
|
||||
## Button Page
|
||||
- 32 Button
|
||||
|
||||
### Button Page
|
||||
- Up to 32 buttons
|
||||
- 4 Button pages
|
||||
- Button design is automatically generated based on the selected entity
|
||||
- Buttons show current brightness and cover position in the button itself
|
||||
- Buttons label can be assigned via blueprint
|
||||
- all buttons with long press function
|
||||
- automatic detection by long press if it is a light or cover for submenu
|
||||
- swipe between all pages
|
||||
- swipe also down and up for fast access to certain pages
|
||||
- All buttons with long press function
|
||||
- Automatic detection by long press if it is a light, cover or climate for submenu
|
||||
- Swipe between all pages
|
||||
- Swipe also down and up for fast access to certain pages
|
||||
|
||||
|
||||
## Light Settings
|
||||
|
||||
### Light Settings
|
||||
- Light current state
|
||||
- Brightness Slider
|
||||
- Colorwheel
|
||||
- TempColor slider
|
||||
- Brightness slider
|
||||
- RGB color wheel
|
||||
- Color temperature slider
|
||||
- Jump back to the right button page
|
||||
|
||||
|
||||
## Cover Settings
|
||||
|
||||
### Cover Settings
|
||||
- Open and close cover
|
||||
- Cover position via slider
|
||||
- Cover battery value if available (I use Ikea roller blind)
|
||||
- Cover battery value (when available)
|
||||
- jump back to the right button page
|
||||
|
||||
|
||||
### Thermostat / Climate
|
||||
- Target temperature control slider
|
||||
- Current temperature
|
||||
- 4 user's selectable values (for water and external temperatures, etc.)
|
||||
- All the standard climate controls from Home Assistant (`heat`, `fan`, `cool`, `auto`, `dry`)
|
||||
- 2 user's selectable buttons
|
||||
- [Can be used for local control (even when Wi-Fi is unavailable) when your panel's relays are used to control your heater](/docs/en/addon_climate.md)
|
||||
|
||||
## Thermostat
|
||||
- Touch Temp control
|
||||
- Outside temperature
|
||||
- Hot water
|
||||
- heating on, off and idle
|
||||
- Hot water button
|
||||
|
||||
### Fan speed
|
||||
- Turn-on and turn-off fan
|
||||
- Set speed via slider or buttons
|
||||
- jump back to the right button page
|
||||
|
||||
|
||||
## Weather Forecast
|
||||
- 5 days Weather Forecast via swipe (Integration Accuweather - but should also go with other integrations)
|
||||
- Lowest and highest temperature outside
|
||||
|
||||
### Weather Forecast
|
||||
- 5 days weather forecast via swipe (supports most used weather integrations)
|
||||
- Min and max outside temperatures
|
||||
- Date
|
||||
- Rain probability
|
||||
- Sunshine hours
|
||||
- UV index
|
||||
- Thunderstorm probability
|
||||
- Wind speed
|
||||
- Other weather parameters (when provided by your integration):
|
||||
- Rain probability
|
||||
- Sunshine hours
|
||||
- UV index
|
||||
- Thunderstorm probability
|
||||
- Wind speed
|
||||
|
||||
|
||||
## Display Settings
|
||||
|
||||
### Display Settings
|
||||
- Restart NSPanel
|
||||
- Sleep mode - display off after time X
|
||||
- Sleep mode - Turn off display after given time (seconds)
|
||||
- Display brightness slider
|
||||
- Display dim brightness slider
|
||||
- Status Brightness in %
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Thanks to:
|
||||
SmartHome Yourself: https://www.youtube.com/c/SmarthomeyourselfDe_DIY
|
||||
|
||||
|
||||
@@ -61,13 +61,11 @@ Please refeer to the [documentation](/docs/en/addon_climate.md) to get more deta
|
||||
|
||||
|
||||
### 2. Alarm control panel
|
||||
recommend api-encryption: https://esphome.io/components/api.html#configuration-variables
|
||||
and, of course warn the user that this is a possible security issue.
|
||||
Anyways - this is also done with many other projects, AND it would require that a possible hacker is already inside the internal (or mayby iot) (W)LAN - and at this point....
|
||||
recommend to have a big warning, and that the user has to take care about e.g.:
|
||||
- secure internal network
|
||||
- split internal networks: IOT, Guest, Internal, Management, ...
|
||||
- enable api-encryption
|
||||
Now you can control an Alarm Control Panel from your NSPanel, which will allow you to set the alarm mode between the standard modes supported by Home Assistant (Home, Away, Night, Vacation or Custom bypass) or disarm the alarm.
|
||||
|
||||
<<< ADD SCREENSHOT >>>
|
||||
|
||||
For more details, instructions and security considerations, please take a look at the [Alarm Control Panel docs](/docs/en/alarm.md).
|
||||
|
||||
|
||||
### 3. Support to sensor display precision from Home Assistant
|
||||
|
||||
28
docs/en/alarm.md
Normal file
28
docs/en/alarm.md
Normal file
@@ -0,0 +1,28 @@
|
||||
# Alarm Control Panel
|
||||
|
||||
You can control an Alarm Control Panel from your NSPanel, which will allow you to set the alarm mode between the standard modes supported by Home Assistant (Home, Away, Night, Vacation or Custom bypass) or disarm the alarm.
|
||||
|
||||
Currently, only alarms without a code will be supported. If your alarm requires a code, you will still be able to display it on your NSPanel, however, when you click in any button it will send services calls to Home Assistant without the code and it will fail for the service where a code is requires.
|
||||
|
||||
|
||||
### Security advisory
|
||||
|
||||
By default, the communication between your NSPanel (ESPHome) and Home Assistant (HA) is not encrypted, which means a person with access to your network could potentially monitor the communication between your panel and HA and replicate the service calls. Although this is not a big issue for most of the service calls (turn-on a light, close a curtain, etc.), it can be a problem when controlling your alarm system.<br>
|
||||
Based on that, we hardly reccoment the use of API encryption for all users controlling an Alarm system via a NSPanel. You can easily enable this by following the ["API encryption" example available here](customization.md#api-encryption).
|
||||
|
||||
|
||||
## Configuration
|
||||
Open the automation based on the NSPanel Blueprint and look for a section related to "Alarm Control Panel".<br>
|
||||
Select your alarm control panel entity, click "Save", and your are done. :)<br>
|
||||
<<< ADD SCREENSHOT >>>>
|
||||
|
||||
|
||||
## Controlling your alarm from your panel
|
||||
When an alarm control panel is set in your Blueprint automation, you will see the alarm icon on your panel's Home page:<br>
|
||||
<<< ADD ICON IMAGE >>>><br>
|
||||
|
||||
|
||||
A click on that icon will show the Alarm Control Panel page:<br>
|
||||
<<< ADD SCREENSHOT >>>>
|
||||
|
||||
You can change your alarm settings with a single click on the button related to the new state you want to set your alarm to, or close the page to go back to Home page.
|
||||
Reference in New Issue
Block a user