diff --git a/bli-guides/_01-setup-bli-pro/07-interfaces.md b/bli-guides/_01-setup-bli-pro/07-interfaces.md index a97d5c72..bf6b2f20 100644 --- a/bli-guides/_01-setup-bli-pro/07-interfaces.md +++ b/bli-guides/_01-setup-bli-pro/07-interfaces.md @@ -37,7 +37,7 @@ and is allowed to access all zones via browser or _BLApp_.
-Per default, _admin_ password is unknown but it can be set to "_admin_" by activating the Setup button function No.2 ([See button functions](https://khimo.github.io/bli-guides/bli_advanced_user_guide/05-user_button)). This +Per default, _admin_ password is unknown but it can be set to "_admin_" by activating the Setup button function No.2 ([See button functions](https://sofiboselli.github.io/bli-guides/bli_advanced_user_guide/05-user_button)). This password will last 5 minutes (for security purposes) during which a new one must be set. Press the _admin_ entry in the left column to change password (see figure above). #### Users - new user @@ -182,6 +182,8 @@ copy and paste the text when setting up other similar cameras and for each of th > E.g. adjust to the correct IP-address. +This configuration can be the same for cameras of the same brand/model, click [here](../camera_configs) to access a list of configurations of other users and help expanding it by adding yours! +
Interfaces Camera paths diff --git a/bli-guides/_help_drivers/honeywell_tcc.md b/bli-guides/_help_drivers/honeywell_tcc.md new file mode 100644 index 00000000..2c15ea3b --- /dev/null +++ b/bli-guides/_help_drivers/honeywell_tcc.md @@ -0,0 +1,38 @@ +--- +title: Honeywell TCC Thermostat International (experimental) +layout: pagetoc +notice: DoNotEdit, created automatically from the driver metadata, must be updated on the driver itself +--- +# Honeywell Total Connect Comfort Thermostat driver + +This driver is for international accounts. It will only work for accounts that are able to log in in the [international](https://international.mytotalconnectcomfort.com/Account/Login) portal. +Supported Honeywell products: EvoHome, Single Zone Thermostat/Connected Round + +## Connecting +To connect to the Honeywell account press the "Link" button in systems. This will redirect to a Honeywell page where email address and password should be entered, after accepting the EULA terms +the location of the desired thermostats should be chosen. + +You should also choose a Temporary override duration. This will be the hours a temporary change in the setpoint will last, if the value is 0 then the changes will be permanent (until a follow schedule command is sent). + +## Adding resources +Adding a resource can be done by pressing the *Import resources* button and then *Load +resources from connected system*. A list of the available thermostats should appear. + +## Supported resources + +Only thermostats are supported. The available commands are: +- Set Setpoint: change the heat setpoint +- Set Mode: choose mode between Off, Auto, Eco, Away, Day Off, Auto With Reset, Custom, Off, Heat and Emercengy Heat. The availability of each mode depends on the system, not all of them may be supported. +- Follow Schedule: Reverts setpoint overrides and makes thermostats follow schedule. + +The available states are: +- Temperature: if available, the current temperature +- Setpoint: the current setpoint +- Mode: the current mode +- Online: whether the device is online. +- Setpoint mode: whether the setpoint is following schedule, is in permanent override or temporary override. + +## Changelog +### v0.1 | 11/09/2021 +- Initial version + diff --git a/bli-guides/_help_drivers/honeywell_tcc_na.md b/bli-guides/_help_drivers/honeywell_tcc_na.md new file mode 100644 index 00000000..0083df88 --- /dev/null +++ b/bli-guides/_help_drivers/honeywell_tcc_na.md @@ -0,0 +1,42 @@ +--- +title: Honeywell TCC Thermostat North America +layout: pagetoc +notice: DoNotEdit, created automatically from the driver metadata, must be updated on the driver itself +--- +# Honeywell Total Connect Comfort Thermostat driver + +This driver is for north american accounts. It will only work for accounts that are able to log in in the [north american](https://mytotalconnectcomfort.com/portal/) portal. +Supported Honeywell products: TCC North America: Wifi 9000, Vision Pro, Focus Pro, RedLink Prestige IAQ + +## Connecting +To connect to the Honeywell account press the "Link" button in systems. This will redirect to a Honeywell page where email address and password should be entered, after accepting the EULA terms +the location of the desired thermostats should be chosen. + +You should also choose a Temporary override duration. This will be the hours a temporary change in the setpoint will last, if the value is 0 then the changes will hold (until a follow schedule command is sent). + +## Adding resources +Adding a resource can be done by pressing the *Import resources* button and then *Load +resources from connected system*. A list of the available thermostats should appear. + +## Supported resources + +The following types of thermostats are supported: 1 Setpoint Heat, 1 Setpoint Cool, 2 Setpoints Heat, Cool and 2 Setpoints (Heat and Cool) with Auto. +The available commands are: +- Set Setpoint: change the heat setpoint +- Set Mode: choose mode between Off, Auto, Heat, Cool and Em. Heat. The availability of each mode depends on the thermostat type, not all of them may be supported +- Follow Schedule: Reverts setpoint overrides and makes thermostats follow schedule +- Set Fan Auto: Sets the fan in auto mode + +The available states are: +- Temperature: if available, the current temperature +- Setpoints: the current setpoint +- Mode: the current mode +- Online: whether the device is online +- Setpoint mode: whether the setpoint is following schedule, is holding or temporary +- Fan Auto: whether the fan is in auto mode or not + + +## Changelog +### v0.1 | 22/11/2021 +- Initial version + diff --git a/bli-guides/_help_drivers/netatmo.md b/bli-guides/_help_drivers/netatmo.md new file mode 100644 index 00000000..56fa8b31 --- /dev/null +++ b/bli-guides/_help_drivers/netatmo.md @@ -0,0 +1,55 @@ +--- +title: Netatmo +layout: pagetoc +notice: DoNotEdit, created automatically from the driver metadata, must be updated on the driver itself +--- +# Netatmo + +**DISCLAIMER:** This driver has **only** been tested for the Smart Radiator Valve. Other resources may not work. All feedback is welcome at support+netatmo@khimo.com + +## Connecting + +To connect with the Netatmo system you should press the "Link" button in systems. This will redirect to a Netatmo page where you should enter your email address and password and accept the terms. + +## Adding resources + +This driver supports the Smart Thermostat, the Smart Radiator Valve, Smarther with Netatmo, Smart Modulating Thermostat, Netatmo lock and Smart Home Weather Station. +The Home Weather Station must be added manually with the MAC address as the resource address. The other supprted devices can be discovered automatically by pressing the *Import resources* button and then *Load +resources from connected system*. + + +## Supported resources + +The available commands are: +- Thermostat: + - Set Setpoint: change the heat setpoint + - Set Mode: choose mode between Heat, Cool and Off (depending on the thermostat). In Smart Radiator Valve and Smart Thermostat 'Heat' reverts to the schedule. + - **Follow Schedule**: If the setpoint was changed, this command revokes the setpoint and goes back to following the home's schedule. +- Lock: + - Set: set lock state to 1 (unlock) or 0 (lock) + +The available states are: +- Thermostat: + - Temperature: if available, the current temperature in the BLI's temperature unit + - Setpoint: the current setpoint + - Mode: the current mode + - Online: whether the device is online. +- Lock: + - State: the state will only show the state according to the last command the BLI sent. If changes that don't involve the BLI happen the state will NOT change. +- **Weather**: + - Temperature: the current temperature in the BLI's temperature unit + - CO2: the current CO2 level in ppm + - Humidity: the current humidity level in percentage + - Noise: the current noise level in dB + - Pressure: the current pressure in mbar + - Online: whether the device is online + +Note for the weather station: according to Netatmo you should keep in mind that data are measured every 5 minutes by the modules and sent to the servers every 10 minutes. +This means that the state will not be updating in real time, worst case scenario it will in 10 minutes. + +*Please, report any issue with this driver to: support+netatmo@khimo.com* + +## Changelog +### v0.1 | 6/12/2021 +- Initial version + diff --git a/bli-guides/_help_drivers/tuya_open_api.md b/bli-guides/_help_drivers/tuya_open_api.md new file mode 100644 index 00000000..33d1c584 --- /dev/null +++ b/bli-guides/_help_drivers/tuya_open_api.md @@ -0,0 +1,42 @@ +--- +title: Tuya +layout: pagetoc +notice: DoNotEdit, created automatically from the driver metadata, must be updated on the driver itself +--- +# TuyaAPI driver | Integrates tuya devices using the open Tuya API + +## Connecting + +To use this driver you will need to create an account in the [Tuya IoT Platform](https://iot.tuya.com/). In Cloud->Development click Create Cloud Project and fill the required fields: +in Development Method select SmartHome, in Data Center choose the one that fits best with your location (if you are not sure which one, you can select more than one). The next window will be "Authorize API Services" where you should choose at least: IoT Core, Authorization, Smart Home Scene Linkage, IoT Data Analytics and Device Status Notification. +Once the project is created in Cloud->Development->Your Project->Overview copy the Access ID/Client ID and the Access Secret/Client Secret and paste them in the Client id and Client secret fields in the Systems Tab of the BLI. + +Next you will need to link your Tuya app account. In Cloud->Development->Your Project->Devices choose Link Tuya App Account->Add App Account. A QR code will appear that must be scanned with the tuya app. If the linking isn't succesful +check if the data center chosen corresponds with the region on your app (if you selected more than one Data Center you can change it in the top right, scan the code until the app account appears in the list). Once this is done copy the UID and paste it in the "User ID" field on the BLI. + +## Resources + +To add resources simply click on Import Resources->Load resource from connected system. The address of the resource corresponds with the Device ID presented in Cloud->Development->Your Proejct->Devices->All Devices. + +Currently, as v0.7, the following resource are tested and working correctly: + - "Dimmable light" + - "Light non dimmable" + - "Thermostat" : 1SP thermostat (ON/OFF/Temperature) + - "Switch" + +The following resources are implemented but were never tested with real hardware, so please send us your feedback if you use them: + - "Shade" + +Switches that correspond to ligths will be discover as switches and as non-dimmable lights, choose the one that fits best for you. +For thermostats, it is important to adjust the temperature unit and correction parameters in the BLI System settings. Tuya does not provide this information and they change depending on the thermostat manufacturers. +For reference, command correction is a multiplier while state correction is a divider. + +Please let us know your experience and any issues with this driver at: [support+drivers_tuya@khimo.com](mailto:support+drivers_tuya@khimo.com) + +## Changelog +**v0.4** + * First public version +**v0.6** + * Added support for lights with tuya code "dj" +**v0.7** + * Fixed "cz" switches not discovering as lights diff --git a/bli-guides/bli-faq.md b/bli-guides/bli-faq.md index 0a182142..61a0f401 100644 --- a/bli-guides/bli-faq.md +++ b/bli-guides/bli-faq.md @@ -395,4 +395,5 @@ The _BeoLink Gateway_ configuration is fully compatible with the _BeoLiving Inte #### Q: Where can I buy a BeoLiving Intelligence? -You can buy the BeoLiving Intelligence from any Bang & Olufsen dealer or by contacting us at info@khimo.com \ No newline at end of file +You can buy the BeoLiving Intelligence from any Bang & Olufsen dealer or by contacting us at info@khimo.com + diff --git a/bli-guides/bli-pro-user-guideorig.md b/bli-guides/bli-pro-user-guideorig.md index 995dc977..c7460b29 100644 --- a/bli-guides/bli-pro-user-guideorig.md +++ b/bli-guides/bli-pro-user-guideorig.md @@ -639,6 +639,8 @@ The configuration of several network cameras is permitted. To add a camera, pres

+To help expand the list of camera configuration, add yours [here](camera_form.md). + ##### Camera basic configuration _BLI PRO_ has a simple and strong capability integration with most CCTV systems or IP Cameras found in the market. diff --git a/bli-guides/camera_configs.md b/bli-guides/camera_configs.md new file mode 100644 index 00000000..b9f60c1f --- /dev/null +++ b/bli-guides/camera_configs.md @@ -0,0 +1,191 @@ +--- +title: Camera Configuration +layout: pagetoc +--- + +## HTTP cameras Resource path examples + +Below are some examples of cameras and their corresponding configuration. Fill this [form](https://forms.gle/gmnRyVcy7sTrGjGy7) to add your configuration to the table and help others to configure their own cameras! + +The table offers a button that will copy the Raw Configuration of the camera to your clipboard, this configuration should later be copied to "Interfaces" under "Camera resources path" after clicking "Raw Edit" in the desired camera. Some setup comments will appear once the button is clicked if they are available. + + + + + +
+ + + + \ No newline at end of file diff --git a/logos/honeywell_tcc.jpg b/logos/honeywell_tcc.jpg new file mode 100644 index 00000000..9e65fbeb Binary files /dev/null and b/logos/honeywell_tcc.jpg differ diff --git a/logos/honeywell_tcc_na.jpg b/logos/honeywell_tcc_na.jpg new file mode 100644 index 00000000..9e65fbeb Binary files /dev/null and b/logos/honeywell_tcc_na.jpg differ diff --git a/logos/netatmo.jpg b/logos/netatmo.jpg new file mode 100644 index 00000000..d36ba7e0 Binary files /dev/null and b/logos/netatmo.jpg differ diff --git a/logos/tuya_open_api.jpg b/logos/tuya_open_api.jpg new file mode 100644 index 00000000..efa4eb43 Binary files /dev/null and b/logos/tuya_open_api.jpg differ