diff --git a/_config.yml b/_config.yml index 45628e235ee..beb9a9b19a2 100644 --- a/_config.yml +++ b/_config.yml @@ -107,8 +107,8 @@ social: # Home Assistant release details current_major_version: 2022 current_minor_version: 8 -current_patch_version: 6 -date_released: 2022-08-18 +current_patch_version: 7 +date_released: 2022-08-25 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/source/_docs/blueprint/selectors.markdown b/source/_docs/blueprint/selectors.markdown index 47581ccb39b..f48afb289dd 100644 --- a/source/_docs/blueprint/selectors.markdown +++ b/source/_docs/blueprint/selectors.markdown @@ -21,6 +21,7 @@ The following selectors are currently available: - [Attribute selector](#attribute-selector) - [Boolean selector](#boolean-selector) - [Color temperature selector](#color-temperature-selector) +- [Config entry selector](#config-entry-selector) - [Date selector](#date-selector) - [Date & time selector](#date--time-selector) - [Device selector](#device-selector) @@ -280,6 +281,27 @@ max_mireds: The output of this selector is the number of mired selected, for example, `243`. +## Config entry selector + +The config entry selector allows to user to select a configured integration +configuration entry. The selector returns the entry ID of the selected +integration configuration entry. + +![Screenshot of the Configuration entry selector](/images/blueprints/selector-config-entry.png) + +```yaml +config_entry: +``` + +{% configuration config_entry %} +integration: + description: Limits the list of selectable configuration entries to a single integration domain. + type: string + required: false +{% endconfiguration %} + +The output of this selector is the entry ID of the config entry, for example, `6b68b250388cbe0d620c92dd3acc93ec`. + ## Date selector The date selector shows a date input that allows the user to specify a date. @@ -833,10 +855,6 @@ entity_id: description: The entity ID of which an state can be selected from. type: string required: true -attribute: - description: The attribute of which an attribute state can be selected from. - type: string - required: false {% endconfiguration %} The output of this selector is the select state (not the translated or diff --git a/source/_docs/mqtt/discovery.markdown b/source/_docs/mqtt/discovery.markdown index ec336658654..09892697175 100644 --- a/source/_docs/mqtt/discovery.markdown +++ b/source/_docs/mqtt/discovery.markdown @@ -308,6 +308,7 @@ Supported abbreviations for device registry configuration: 'name': 'name', 'mf': 'manufacturer', 'mdl': 'model', + 'hw': 'hw_version', 'sw': 'sw_version', 'sa': 'suggested_area', ``` diff --git a/source/_integrations/advantage_air.markdown b/source/_integrations/advantage_air.markdown index 6f4ae86e688..4a5c02d22bb 100644 --- a/source/_integrations/advantage_air.markdown +++ b/source/_integrations/advantage_air.markdown @@ -60,6 +60,10 @@ The `advantage_air` switch platform will create a switch entity to toggle fresh The `advantage_air` select platform allows you to change the zone used for the "MyZone" feature. +### Light + +The `advantage_air` light platform will create a light entity for each light in MyLights tab of the MyPlace app. + ## Services ### Service `advantage_air.set_time_to` diff --git a/source/_integrations/alarm_control_panel.mqtt.markdown b/source/_integrations/alarm_control_panel.mqtt.markdown index 3194873d5c5..0e635ab0c7f 100644 --- a/source/_integrations/alarm_control_panel.mqtt.markdown +++ b/source/_integrations/alarm_control_panel.mqtt.markdown @@ -135,6 +135,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: "A list of IDs that uniquely identify the device. For example a serial number." required: false diff --git a/source/_integrations/binary_sensor.mqtt.markdown b/source/_integrations/binary_sensor.mqtt.markdown index 849e69d15cb..035cabd138b 100644 --- a/source/_integrations/binary_sensor.mqtt.markdown +++ b/source/_integrations/binary_sensor.mqtt.markdown @@ -99,6 +99,10 @@ device: description: "A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `'connections': ['mac', '02:5b:26:a8:dc:12']`." required: false type: [list, map] + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown index b45aefd37e9..36c07ca5607 100644 --- a/source/_integrations/bluetooth.markdown +++ b/source/_integrations/bluetooth.markdown @@ -59,21 +59,22 @@ If you experience an unreliable Bluetooth connection, installing a short USB ext ### Known working adapters -- ASUS USB-BT400 -- ASUS USB-BT500 -- Avantree DG45 -- Kinivo BTD-400 -- Maxuni BT-501 -- SUMEE BT501 -- UGREEN CM390 -- XDO BT802 (Long Range) -- ZEXMTE BT-505 (Long Range) -- ZEXMTE BT-DG54 +- ASUS USB-BT400 [BCM20702A1] +- ASUS USB-BT500 [RTL8761BU] +- Avantree DG45 [RTL8761BU] +- EDUP LOVE EP-B3536 [RTL8761BU] (Long Range) +- Kinivo BTD-400 [BCM20702A1] +- Maxuni BT-501 [RTL8761B] +- SUMEE BT501 [RTL8761B] +- UGREEN CM390 [RTL8761BU] +- XDO BT802 [RTL8761BU] (Long Range) +- ZEXMTE BT-505 [RTL8761BU] (Long Range) +- ZEXMTE BT-DG54 [RTL8761BU] ### Unsupported adapters -- tp-link UB400 - Frequent connection failures -- tp-link UB500 - Frequent connection failures +- tp-link UB400 [BCM20702A1] - Frequent connection failures with active connections +- tp-link UB500 [RTL8761BU] - Frequent connection failures with active connections ## Multiple adapters @@ -87,6 +88,14 @@ The following methods are known to work to add multiple adapters: Integrations that have followed the [Best practices for library authors](https://developers.home-assistant.io/docs/network_discovery?_highlight=bluetooth#best-practices-for-library-authors) will automatically connect via the adapter with the best signal and failover to an active adapter if one becomes unavailable. +## Passive Scanning + +Passive Scanning on Linux can be enabled in the options flow per adapter if the host system runs BlueZ 4.63 or later with experimental features enabled. + +Many integrations require active scanning and may not function when scanning is passive. + +{% include integrations/option_flow.md %} + ## Remote adapters The Bluetooth integration supports receiving advertisement data from external adapters for devices and sensors that do not need an active connection. The number of remote scanners is limited only by the performance of the host system. diff --git a/source/_integrations/bthome.markdown b/source/_integrations/bthome.markdown new file mode 100644 index 00000000000..5782b5ba501 --- /dev/null +++ b/source/_integrations/bthome.markdown @@ -0,0 +1,43 @@ +--- +title: BThome Bluetooth +description: Instructions on how to integrate BThome BLE devices into Home Assistant. +ha_category: + - Sensor +ha_bluetooth: true +ha_release: 2022.9 +ha_iot_class: Local Push +ha_codeowners: + - '@Ernst79' +ha_domain: bthome +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: integration +--- + +Integrates [BThome](https://bthome.io/) BLE devices into Home Assistant. + +{% include integrations/config_flow.md %} + +The BThome BLE integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional. + +BTHome is an energy effective but flexible BLE format to broadcast data with Bluetooth and allows you to create your own DIY BLE sensors. More information about the BThome BLE format and projects that use the format can be found on the [BThome website](https://bthome.io/). + +## Supported sensor measurements + +The current release supports the following sensor measurement types. + +- Temperature +- Humidity +- Pressure +- Illuminance +- Energy +- Power +- PM2.5 +- PM10 +- CO2 +- VOC + +## Bindkey + +When using encryption for your BThome sensor, you will promted to enter your 32 character hexadecimal (16 bytes) encryption key. This key is called the bindkey. More information about the bindkey can be found in the [specifications](https://bthome.io/#encryption). diff --git a/source/_integrations/button.mqtt.markdown b/source/_integrations/button.mqtt.markdown index 087080634ed..9356f3f728d 100644 --- a/source/_integrations/button.mqtt.markdown +++ b/source/_integrations/button.mqtt.markdown @@ -96,6 +96,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/camera.mqtt.markdown b/source/_integrations/camera.mqtt.markdown index c9276c0205e..4aa5a56ab23 100644 --- a/source/_integrations/camera.mqtt.markdown +++ b/source/_integrations/camera.mqtt.markdown @@ -98,6 +98,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": ["mac", "02:5b:26:a8:dc:12"]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/climate.mqtt.markdown b/source/_integrations/climate.mqtt.markdown index a0408864e6c..959e7c8fe62 100644 --- a/source/_integrations/climate.mqtt.markdown +++ b/source/_integrations/climate.mqtt.markdown @@ -122,6 +122,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/cover.mqtt.markdown b/source/_integrations/cover.mqtt.markdown index 0315165875e..c0541b4a5af 100644 --- a/source/_integrations/cover.mqtt.markdown +++ b/source/_integrations/cover.mqtt.markdown @@ -109,6 +109,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": ["mac", "02:5b:26:a8:dc:12"]`.' required: false type: list + hw_version: + description: "The hardware version of the device." + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/device_tracker.mqtt.markdown b/source/_integrations/device_tracker.mqtt.markdown index fea239e606d..e79615055fb 100644 --- a/source/_integrations/device_tracker.mqtt.markdown +++ b/source/_integrations/device_tracker.mqtt.markdown @@ -133,6 +133,10 @@ device: description: "A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `'connections': ['mac', '02:5b:26:a8:dc:12']`." required: false type: [list, map] + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/environment_canada.markdown b/source/_integrations/environment_canada.markdown index b4310e06623..dda4f393227 100644 --- a/source/_integrations/environment_canada.markdown +++ b/source/_integrations/environment_canada.markdown @@ -31,7 +31,9 @@ You can also specify a weather station to use by providing a identification code ## Entities -The integration will create the entities listed below. Note that many of the entities are disabled by default and can be enabled via the Configuration / Entities screen. +The integration will create the entities listed below. + +Note that many of the entities, such as radar imagery and hourly forecasts, are disabled by default and can be enabled via the Entity status settings available through the Configuration / Entities screen. ### Weather diff --git a/source/_integrations/fan.mqtt.markdown b/source/_integrations/fan.mqtt.markdown index 48ace2c0f97..e1eb5fd9992 100644 --- a/source/_integrations/fan.mqtt.markdown +++ b/source/_integrations/fan.mqtt.markdown @@ -104,6 +104,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: [list, map] + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/fully_kiosk.markdown b/source/_integrations/fully_kiosk.markdown index 565433ecf30..e83ce78031d 100644 --- a/source/_integrations/fully_kiosk.markdown +++ b/source/_integrations/fully_kiosk.markdown @@ -56,4 +56,10 @@ The following controls are available: - Screensaver brightness - Screen on/off - Screen off timer -- Screen brightness \ No newline at end of file +- Screen brightness +- Play and stop media files +- Set device volume + +
+ The Fully Kiosk Browser app does not provide feedback on the device volume or media playback status, so we are unable to display the current volume level or playback status. +
diff --git a/source/_integrations/humidifier.mqtt.markdown b/source/_integrations/humidifier.mqtt.markdown index d89e3095a79..7a6ae783f3a 100644 --- a/source/_integrations/humidifier.mqtt.markdown +++ b/source/_integrations/humidifier.mqtt.markdown @@ -106,6 +106,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: [list, map] + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/led_ble.markdown b/source/_integrations/led_ble.markdown new file mode 100644 index 00000000000..9ab788d478d --- /dev/null +++ b/source/_integrations/led_ble.markdown @@ -0,0 +1,38 @@ +--- +title: LED BLE +description: Instructions on how to integrate LED BLE devices into Home Assistant. +ha_category: + - Light +ha_bluetooth: true +ha_release: 2022.9 +ha_iot_class: Local Polling +ha_codeowners: + - '@bdraco' +ha_domain: led_ble +ha_config_flow: true +ha_platforms: + - light +ha_integration_type: integration +--- + +Integrates multiple brands of Bluetooth Low Energy LED devices into Home Assistant. + +{% include integrations/config_flow.md %} + +This integration works with devices that identify with the following names: + +- LEDnet (except LEDnetWF models) +- BLE-LED +- LEDBLE +- Triones +- LEDBlue + +These devices have been sold under many brands, including: + +- LED BLE +- BLE-LED +- Triones +- Happy Lighting +- Zengee +- LEDBlue +- Zerproc diff --git a/source/_integrations/light.mqtt.markdown b/source/_integrations/light.mqtt.markdown index 3c6df6d18d1..82cdf58c9ec 100644 --- a/source/_integrations/light.mqtt.markdown +++ b/source/_integrations/light.mqtt.markdown @@ -167,6 +167,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/litterrobot.markdown b/source/_integrations/litterrobot.markdown index a0c4b3433ad..84076f7561b 100644 --- a/source/_integrations/litterrobot.markdown +++ b/source/_integrations/litterrobot.markdown @@ -12,7 +12,9 @@ ha_release: 2021.3 ha_config_flow: true ha_codeowners: - '@natekspencer' + - '@tkdrob' ha_domain: litterrobot +ha_dhcp: true ha_platforms: - button - select @@ -26,7 +28,7 @@ The Litter-Robot integration allows you to control and monitor your Wi-Fi-enable You will need a Litter-Robot account as well as a Wi-Fi-enabled Litter-Robot unit that has already been associated with your account. -The Feeder-Robot and Litter-Robot 4 are not currently supported by this integration. +The Feeder-Robot is not currently supported by this integration. {% include integrations/config_flow.md %} @@ -45,7 +47,9 @@ The following entities are created for this component and identified by a single | Status Code | `sensor` | Displays the status code (Clean Cycle in Progress, Ready, Drawer Full, etc). | | Waste Drawer | `sensor` | Displays the current waste drawer level. | | Clean Cycle Wait Time Minutes | `select` | View and select the clean cycle wait time. | -| Reset Waste Drawer | `button` | Button to reset the waste drawer level to 0%. | +| Reset Waste Drawer* | `button` | Button to reset the waste drawer level to 0%. | + +\* Litter-Robot 3 only ## Additional Attributes @@ -61,11 +65,11 @@ Some entities have attributes in addition to the default ones that are available ## Services -Services are utilized for additional functionality that is available in the Litter-Robot companion app. The following are currently available: +Services are utilized for additional functionality that is available in the Whisker (previously Litter-Robot) companion app. The following are currently available: ### set_sleep_mode -Enables (with `start_time` parameter) or disables sleep mode on the Litter-Robot. +Enables (with `start_time` parameter) or disables sleep mode on the Litter-Robot. Currently, this is limited to only the Litter-Robot 3. To make changes to the sleep schedule on your Litter-Robot 4, please continue to use the Whisker app. | Parameter | Type | Required | Description | | ---------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/source/_integrations/lock.mqtt.markdown b/source/_integrations/lock.mqtt.markdown index 405702eda53..f323e377447 100644 --- a/source/_integrations/lock.mqtt.markdown +++ b/source/_integrations/lock.mqtt.markdown @@ -102,6 +102,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/number.mqtt.markdown b/source/_integrations/number.mqtt.markdown index 9d98f91c971..ea393329dbe 100644 --- a/source/_integrations/number.mqtt.markdown +++ b/source/_integrations/number.mqtt.markdown @@ -89,6 +89,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": ["mac", "02:5b:26:a8:dc:12"]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/qingping.markdown b/source/_integrations/qingping.markdown index 7e492e6fe9b..aaac807b064 100644 --- a/source/_integrations/qingping.markdown +++ b/source/_integrations/qingping.markdown @@ -31,3 +31,4 @@ The Qingping integration will automatically discover devices once the [Bluetooth - [Door/Window Sensor](https://www.qingping.co/door-window-sensor/overview) (CGH1) - [LEE GUITARS Thermo-Hygrometer](https://www.qingping.co/lee-guitars-thermo-hygrometer/overview) (CGM1) - [Motion & Ambient Light Sensor](https://www.qingping.co/motion-light-sensor/overview) (CGPR1) +- [Temp RH M](https://www.qingping.co/temp-rh-monitor/overview#mi) (CGG1) diff --git a/source/_integrations/select.mqtt.markdown b/source/_integrations/select.mqtt.markdown index 796b94e5269..69dc6bbe7b0 100644 --- a/source/_integrations/select.mqtt.markdown +++ b/source/_integrations/select.mqtt.markdown @@ -106,6 +106,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": ["mac", "02:5b:26:a8:dc:12"]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: 'A list of IDs that uniquely identify the device. For example a serial number.' required: false diff --git a/source/_integrations/sensor.mqtt.markdown b/source/_integrations/sensor.mqtt.markdown index 8fc0e9cab7f..75418f5e1d0 100644 --- a/source/_integrations/sensor.mqtt.markdown +++ b/source/_integrations/sensor.mqtt.markdown @@ -90,6 +90,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/sensorblue.markdown b/source/_integrations/sensorblue.markdown new file mode 100644 index 00000000000..0fc5455faa4 --- /dev/null +++ b/source/_integrations/sensorblue.markdown @@ -0,0 +1,20 @@ +--- +title: SensorBlue +description: Instructions on how to integrate SensorBlue devices into Home Assistant. +ha_category: + - Sensor +ha_bluetooth: true +ha_release: 2022.9 +ha_iot_class: Local Push +ha_codeowners: + - '@bdraco' +ha_domain: sensorblue +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: integration +ha_supporting_domain: thermobeacon +ha_supporting_integration: ThermoBeacon +--- + +{% include integrations/supported_brand.md %} diff --git a/source/_integrations/siren.mqtt.markdown b/source/_integrations/siren.mqtt.markdown index 03d06dad796..2ed69491d47 100644 --- a/source/_integrations/siren.mqtt.markdown +++ b/source/_integrations/siren.mqtt.markdown @@ -112,6 +112,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 2777968b725..1300ac30077 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -61,6 +61,7 @@ Every time there is a message received, `event: sms.incoming_sms` is fired with Sample automation that forward all SMS to `user1`: #### Define a sensor in `configuration.yaml` to protect user phone number + ```yaml template: - sensor: @@ -74,16 +75,16 @@ template: ```yaml notify_sms_user1: - alias: Notify via SMS to User1 + alias: "Notify via SMS to User1" fields: message: - description: The message content - example: The light is on! + description: "The message content" + example: "The light is on!" sequence: - service: notify.sms data: message: "{{ message }}" - target: states(sensor.user1_phone_number) + target: "{{ states('sensor.user1_phone_number') }}" mode: single icon: mdi:chat-alert ``` @@ -95,42 +96,20 @@ notify_sms_user1: {% raw %} ```yaml -- id: 'forward_sms' - alias: Forward SMS - description: '' +- alias: "Forward SMS" trigger: - platform: event event_type: sms.incoming_sms - condition: [] action: - service: script.notify_sms_user1 data: - message: 'From: {{trigger.event.data.phone}} - {{trigger.event.data.text}} - ' - mode: single + message: | + From: {{trigger.event.data.phone}} + {{trigger.event.data.text}} mode: single ``` {% endraw %} -## Notes about the operating system - -If the integration is used with the Home Assistant Operating System, then version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher is required. - -For installations not running on Home Assistant or Home Assistant Core using Docker, you must install `gammu-dev` package: - -```bash -sudo apt-get install libgammu-dev -``` - -Before running for the first time, check that the system recognizes the modem by running: - -```bash -ls -l /dev/*USB* -``` - -Note: When running Home Assistant, you need to install the SSH add-on. - ## Required Hardware You will need a USB GSM stick modem or device like SIM800L v2 connected via USB UART. diff --git a/source/_integrations/switch.mqtt.markdown b/source/_integrations/switch.mqtt.markdown index 6b7b01af154..32d027cf0fc 100644 --- a/source/_integrations/switch.mqtt.markdown +++ b/source/_integrations/switch.mqtt.markdown @@ -100,6 +100,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/switchbot.markdown b/source/_integrations/switchbot.markdown index 84f55503731..8f40b6b025e 100644 --- a/source/_integrations/switchbot.markdown +++ b/source/_integrations/switchbot.markdown @@ -4,6 +4,7 @@ description: Instructions on how to set up SwitchBot Devices. ha_category: - Binary Sensor - Cover + - Light - Sensor - Switch ha_release: 0.78 @@ -18,6 +19,7 @@ ha_bluetooth: true ha_platforms: - binary_sensor - cover + - light - sensor - switch ha_config_flow: true @@ -43,9 +45,11 @@ Please note, device names configured in the SwitchBot app are not transferred in ## Supported Devices +- Color Bulb (WoBulb) - Bot (WoHand) - Contact Sensor (WoContact) - Curtain (WoCurtain) +- Light Strip (WoStrip) - Meter (WoSensorTH) - Motion Sensor (WoPresence) - Plug Mini (WoPlug), both the original (model W1901400) and HomeKit-enabled (model W1901401) diff --git a/source/_integrations/tag.mqtt.markdown b/source/_integrations/tag.mqtt.markdown index 6fe6e444fd6..fef5180e88f 100644 --- a/source/_integrations/tag.mqtt.markdown +++ b/source/_integrations/tag.mqtt.markdown @@ -37,6 +37,10 @@ device: description: "A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `'connections': ['mac', '02:5b:26:a8:dc:12']`." required: false type: [list, map] + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/thermobeacon.markdown b/source/_integrations/thermobeacon.markdown new file mode 100644 index 00000000000..0260082ebad --- /dev/null +++ b/source/_integrations/thermobeacon.markdown @@ -0,0 +1,27 @@ +--- +title: ThermoBeacon +description: Instructions on how to integrate ThermoBeacon devices into Home Assistant. +ha_category: + - Sensor +ha_bluetooth: true +ha_release: 2022.9 +ha_iot_class: Local Push +ha_codeowners: + - '@bdraco' +ha_domain: thermobeacon +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: integration +--- + +Integrates [ThermoBeacon](http://www.seven-like.com/) devices into Home Assistant. + +## Supported devices + +- SensorBlue WS07 +- SensorBlue WS08 + +The ThermoBeacon integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional. + +{% include integrations/config_flow.md %} diff --git a/source/_integrations/thermoplus.markdown b/source/_integrations/thermoplus.markdown new file mode 100644 index 00000000000..555e046dae1 --- /dev/null +++ b/source/_integrations/thermoplus.markdown @@ -0,0 +1,20 @@ +--- +title: ThermoPlus +description: Instructions on how to integrate ThermoPlus devices into Home Assistant. +ha_category: + - Sensor +ha_bluetooth: true +ha_release: 2022.9 +ha_iot_class: Local Push +ha_codeowners: + - '@bdraco' +ha_domain: thermoplus +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: integration +ha_supporting_domain: thermobeacon +ha_supporting_integration: ThermoBeacon +--- + +{% include integrations/supported_brand.md %} diff --git a/source/_integrations/thermopro.markdown b/source/_integrations/thermopro.markdown new file mode 100644 index 00000000000..1a0848ae3ee --- /dev/null +++ b/source/_integrations/thermopro.markdown @@ -0,0 +1,27 @@ +--- +title: ThermoPro +description: Instructions on how to integrate ThermoPro devices into Home Assistant. +ha_category: + - Sensor +ha_bluetooth: true +ha_release: 2022.9 +ha_iot_class: Local Push +ha_codeowners: + - '@bdraco' +ha_domain: thermopro +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: integration +--- + +Integrates [ThermoPro](https://buythermopro.com/) devices into Home Assistant. + +## Supported devices + +- [TP359](https://buythermopro.com/product/thermopro-tp59-bluetooth-wireless-thermometer-hygrometer-humidity-monitor/) +- [TP357](https://buythermopro.com/product/thermopro-tp357-bluetooth-digital-indoor-hygrometer-thermometer/) + +The ThermoPro integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional. + +{% include integrations/config_flow.md %} diff --git a/source/_integrations/tibber.markdown b/source/_integrations/tibber.markdown index 5f239bf63d3..8ba2eebf8b3 100644 --- a/source/_integrations/tibber.markdown +++ b/source/_integrations/tibber.markdown @@ -20,7 +20,7 @@ ha_integration_type: integration --- The `tibber` integration provides a sensor with the current electricity price if you are a [Tibber](https://tibber.com/) customer. -If you have a [Tibber Pulse](https://norge.tibber.com/products/pulse/) or [Watty](https://tibber.com/se/store/produkt/watty-smart-energimatare) it will also show the electricity consumption in real-time. You get a sensor for monthly consumption, monthly cost, and monthly peak hour. If you do have a real-time meter it is updated once every hour, oterwise it is updated once per day. Statistics with hourly consumption and cost data is generated that can be used in the [Energy Dashboard](/docs/energy/). (The ids are `tibber:energy_consumption_HOMEID` and `tibber:energy_totalcost_HOMEID` ) +If you have a [Tibber Pulse](https://norge.tibber.com/products/pulse/) or [Watty](https://tibber.com/se/store/produkt/watty-smart-energimatare) it will also show the electricity consumption in real-time. You get a sensor for monthly consumption, monthly cost, and monthly peak hour. If you do have a real-time meter it is updated once every hour, otherwise it is updated once per day. Statistics with hourly consumption and cost data is generated that can be used in the [Energy Dashboard](/docs/energy/) (the ids are `tibber:energy_consumption_HOMEID` and `tibber:energy_totalcost_HOMEID`). If you produce energy there are also statistics with hourly production and profit data generated which can also be used there (the ids are `tibber:energy_production_HOMEID` and `tibber:energy_profit_HOMEID`). There is currently support for the following device types within Home Assistant: diff --git a/source/_integrations/vacuum.mqtt.markdown b/source/_integrations/vacuum.mqtt.markdown index ec40ccf4be1..b6639ecca2a 100644 --- a/source/_integrations/vacuum.mqtt.markdown +++ b/source/_integrations/vacuum.mqtt.markdown @@ -396,6 +396,10 @@ device: description: 'A list of connections of the device to the outside world as a list of tuples `[connection_type, connection_identifier]`. For example the MAC address of a network interface: `"connections": [["mac", "02:5b:26:a8:dc:12"]]`.' required: false type: list + hw_version: + description: The hardware version of the device. + required: false + type: string identifiers: description: A list of IDs that uniquely identify the device. For example a serial number. required: false diff --git a/source/_integrations/xiaomi_miio.markdown b/source/_integrations/xiaomi_miio.markdown index 0740c42122b..a1b03de5106 100644 --- a/source/_integrations/xiaomi_miio.markdown +++ b/source/_integrations/xiaomi_miio.markdown @@ -220,6 +220,7 @@ Supported devices: | Air Purifier 4 PRO | zhimi.airp.vb4 | | | Air Fresh A1 | dmaker.airfresh.a1 | MJXFJ-150-A1 | | Air Fresh VA2 | zhimi.airfresh.va2 | | +| Air Fresh VA4 | zhimi.airfresh.va4 | | | Air Fresh T2017 | dmaker.airfresh.t2017 | MJXFJ-300-G1 | | Air Humidifier | zhimi.humidifier.v1 | | | Air Humidifier CA1 | zhimi.humidifier.ca1 | | @@ -612,6 +613,41 @@ Child Lock | Turn on/off `child lock` LED | Turn on/off `led` +### Air Fresh VA4 + +- Power (on, off) +- Operation modes (Auto, Silent, Interval, Low, Middle, Strong) +- Attributes (fan platform) + - `use_time` + - `extra_features` +- Sensor entities + +Sensor | Description | Enabled by default +----------------------- | ----------------------- | ----------------------- +Carbon Dioxide | The current carbon dioxide measured in ppm | True +Filter Life Remaining | The remaining life of the filter | True +Filter Use | Filter usage time in hours | True +Humidity | The current humidity measured | True +PM2.5 | The current particulate matter 2.5 measured | True +Temperature | The current temperature measured | True +Use Time | The accumulative number of seconds the device has been in use | False + +- Select entities + +Select | Description +----------------------- | ----------------------- +LED Brightness | Controls the brightness of the LEDs (bright, dim, off) + +- Switch entities + +Switch | Description +----------------------- | ----------------------- +Buzzer | Turn on/off `buzzer` +Child Lock | Turn on/off `child lock` +LED | Turn on/off `led` +Auxiliary Heat | Turn on/off `heater` + + ### Air Fresh T2017 (dmaker.airfresh.t2017) - Power (on, off) diff --git a/source/_posts/2022-08-03-release-20228.markdown b/source/_posts/2022-08-03-release-20228.markdown index dadb5fd244a..959bb878439 100644 --- a/source/_posts/2022-08-03-release-20228.markdown +++ b/source/_posts/2022-08-03-release-20228.markdown @@ -49,6 +49,7 @@ Enjoy the release! - [Release 2022.8.4 - August 12](#release-202284---august-12) - [Release 2022.8.5 - August 15](#release-202285---august-15) - [Release 2022.8.6 - August 17](#release-202286---august-17) +- [Release 2022.8.7 - August 25](#release-202287---august-25) - [Need help? Join the community!](#need-help-join-the-community) - [Breaking Changes](#breaking-changes) - [Farewell to the following](#farewell-to-the-following) @@ -606,6 +607,56 @@ The following integrations are now available via the Home Assistant UI: [overkiz docs]: /integrations/overkiz/ [slack docs]: /integrations/slack/ +## Release 2022.8.7 - August 25 + +- Add edl21 sensor unit mapping for Hz ([@StephanU] - [#76783]) ([edl21 docs]) +- Change growatt server URL ([@coffeedave] - [#76824]) ([growatt_server docs]) +- Bump pySwitchbot to 0.18.12 ([@bdraco] - [#77040]) ([switchbot docs]) +- Bump pySwitchbot to 0.18.14 ([@bdraco] - [#77090]) ([switchbot docs]) +- Protect against an exception in Shelly climate platform ([@bieniu] - [#77102]) ([shelly docs]) +- Bump ZHA dependencies ([@puddly] - [#77125]) ([zha docs]) +- Minor deCONZ clean up ([@Kane610] - [#76323]) ([deconz docs]) +- Fix level controllable output controls in deCONZ ([@Kane610] - [#77223]) ([deconz docs]) +- Fix Aladdin connect multiple doors on one device ([@mkmer] - [#77226]) ([aladdin_connect docs]) +- Fix met_eireann default wind speed unit ([@donoghdb] - [#77229]) ([met_eireann docs]) +- Update xknx to 1.0.1 ([@farmio] - [#77244]) ([knx docs]) +- Fix grid_export_limit unit for DT inverters ([@mletenay] - [#77290]) ([goodwe docs]) +- Add BLE sensor to Aladdin_connect ([@mkmer] - [#76221]) ([aladdin_connect docs]) + +[#76221]: https://github.com/home-assistant/core/pull/76221 +[#76323]: https://github.com/home-assistant/core/pull/76323 +[#76783]: https://github.com/home-assistant/core/pull/76783 +[#76824]: https://github.com/home-assistant/core/pull/76824 +[#77040]: https://github.com/home-assistant/core/pull/77040 +[#77090]: https://github.com/home-assistant/core/pull/77090 +[#77102]: https://github.com/home-assistant/core/pull/77102 +[#77125]: https://github.com/home-assistant/core/pull/77125 +[#77223]: https://github.com/home-assistant/core/pull/77223 +[#77226]: https://github.com/home-assistant/core/pull/77226 +[#77229]: https://github.com/home-assistant/core/pull/77229 +[#77244]: https://github.com/home-assistant/core/pull/77244 +[#77290]: https://github.com/home-assistant/core/pull/77290 +[@Kane610]: https://github.com/Kane610 +[@StephanU]: https://github.com/StephanU +[@bdraco]: https://github.com/bdraco +[@bieniu]: https://github.com/bieniu +[@coffeedave]: https://github.com/coffeedave +[@donoghdb]: https://github.com/donoghdb +[@farmio]: https://github.com/farmio +[@mkmer]: https://github.com/mkmer +[@mletenay]: https://github.com/mletenay +[@puddly]: https://github.com/puddly +[aladdin_connect docs]: /integrations/aladdin_connect/ +[deconz docs]: /integrations/deconz/ +[edl21 docs]: /integrations/edl21/ +[goodwe docs]: /integrations/goodwe/ +[growatt_server docs]: /integrations/growatt_server/ +[knx docs]: /integrations/knx/ +[met_eireann docs]: /integrations/met_eireann/ +[shelly docs]: /integrations/shelly/ +[switchbot docs]: /integrations/switchbot/ +[zha docs]: /integrations/zha/ + ## Need help? Join the community! Home Assistant has a great community of users who are all more than willing diff --git a/source/_redirects b/source/_redirects index c04245c3ddd..4d66c47245f 100644 --- a/source/_redirects +++ b/source/_redirects @@ -402,6 +402,7 @@ /getting-started/installation-raspberry-pi-all-in-one /getting-started /docs/tools/keyring/ /docs/configuration/secrets /docs/tools/credstash/ /docs/configuration/secrets +/docs/scripts/editor/ /docs/scripts # Blog /blog/2019/05/29/release-94 /blog/2019/06/05/release-94 diff --git a/source/android/index.markdown b/source/android/index.markdown index 2e437db0c0f..5908b3aba74 100644 --- a/source/android/index.markdown +++ b/source/android/index.markdown @@ -4,5 +4,7 @@ description: "Landing page for Home Assistant Android app." --- + + diff --git a/source/images/blueprints/selector-config-entry.png b/source/images/blueprints/selector-config-entry.png new file mode 100644 index 00000000000..95840e0774e Binary files /dev/null and b/source/images/blueprints/selector-config-entry.png differ