From f4f21f86e22edfa9b809a1ca80b7b324dadca6b5 Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel <41558831+felipediel@users.noreply.github.com> Date: Fri, 6 Mar 2020 06:06:19 -0300 Subject: [PATCH 01/10] Add device type --- source/_integrations/broadlink.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index d71d66f4f3f0..704d6e3ab473 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -33,6 +33,7 @@ remote: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS + type: 0x5f36 ``` {% configuration %} @@ -44,6 +45,10 @@ mac: description: Device MAC address. required: true type: string +type: + description: Device type. + required: false + type: int timeout: description: Timeout in seconds for the connection to the device. required: false From f0b120e23f786b5c8beebde6bb04bc74d2b079f7 Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Fri, 6 Mar 2020 15:07:21 -0300 Subject: [PATCH 02/10] Fix type --- source/_integrations/broadlink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index 704d6e3ab473..921eb0bb2f9c 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -48,7 +48,7 @@ mac: type: description: Device type. required: false - type: int + type: integer timeout: description: Timeout in seconds for the connection to the device. required: false From 31a712b9730b4459c36a13edf26f955836cc115e Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Sat, 7 Mar 2020 17:44:39 -0300 Subject: [PATCH 03/10] Remove optional requirement from default sample --- source/_integrations/broadlink.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index 921eb0bb2f9c..f263d086b2a6 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -33,7 +33,6 @@ remote: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: 0x5f36 ``` {% configuration %} From 17cf7fe6f9121d580750ed3ebd4a9c067cd00c4d Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Sat, 7 Mar 2020 18:09:48 -0300 Subject: [PATCH 04/10] Add troubleshooting section --- source/_integrations/broadlink.markdown | 33 +++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index f263d086b2a6..fe80e39e10fe 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -178,6 +178,39 @@ script: - turn off display ``` +### Troubleshooting + +Many users are experiencing problems with Broadlink RM Mini 3 type 0x5f36 firmware v44057. + +If you have this device, you need to follow these steps: +- Remove the device from Broadlink App +- Reset the device +- Add the device to your local network using the app +- Do not set up a cloud. Not now, not ever. +- Specify the device type in the configuration file + +Example 1: Set up 0x5f36 as a remote + +```yaml +# Example configuration.yaml entry +remote: + - platform: broadlink + host: IP_ADDRESS + mac: MAC_ADDRESS + type: 0x5f36 +``` + +Example 2: Set up 0x5f36 as switch + +```yaml +# Example configuration.yaml entry +switch: + - platform: broadlink + host: IP_ADDRESS + mac: MAC_ADDRESS + type: "rm_mini3_5f36" +``` + ## Sensor The `broadlink` sensor platform let you monitor data from an RM2 and A1 E-air. There is currently no support for the cloud API. From 4f048effe1784a482ef66d19a592ff4c9dd6c55f Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Sat, 7 Mar 2020 18:13:55 -0300 Subject: [PATCH 05/10] Remove dots --- source/_integrations/broadlink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index fe80e39e10fe..5d8dd55f35ba 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -186,7 +186,7 @@ If you have this device, you need to follow these steps: - Remove the device from Broadlink App - Reset the device - Add the device to your local network using the app -- Do not set up a cloud. Not now, not ever. +- Do not set up a cloud (not now, not ever) - Specify the device type in the configuration file Example 1: Set up 0x5f36 as a remote From c85d28a2e678df16f163334cbbf23d006a558187 Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Mon, 9 Mar 2020 19:10:09 -0300 Subject: [PATCH 06/10] Extend support to RM4 --- source/_integrations/broadlink.markdown | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index 5d8dd55f35ba..f18a11f15abd 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -180,13 +180,14 @@ script: ### Troubleshooting -Many users are experiencing problems with Broadlink RM Mini 3 type 0x5f36 firmware v44057. +Many users are experiencing problems with Broadlink RM Mini 3 0x5f36 and the entire RM4 series. -If you have this device, you need to follow these steps: +If you have these devices, you need to follow these steps: - Remove the device from Broadlink App - Reset the device - Add the device to your local network using the app - Do not set up a cloud (not now, not ever) +- Use [Broadlink Manager](https://sourceforge.net/projects/broadlink-manager/) to get your device type - Specify the device type in the configuration file Example 1: Set up 0x5f36 as a remote @@ -208,7 +209,18 @@ switch: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: "rm_mini3_5f36" + type: 'rm_mini3_5f36' +``` + +Example 3: Set up RM4 as switch + +```yaml +# Example configuration.yaml entry +switch: + - platform: broadlink + host: IP_ADDRESS + mac: MAC_ADDRESS + type: 'rm4' ``` ## Sensor @@ -353,7 +365,7 @@ friendly_name: required: false type: string type: - description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." + description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_5f36`, `rm4`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." required: true type: string switches: From fac1ac3c2070dbda7384aec235bed9341b35ceb0 Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Sat, 11 Apr 2020 02:33:28 -0300 Subject: [PATCH 07/10] Discriminate RM4 Mini and Pro --- source/_integrations/broadlink.markdown | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index f18a11f15abd..5316acfc822e 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -190,7 +190,7 @@ If you have these devices, you need to follow these steps: - Use [Broadlink Manager](https://sourceforge.net/projects/broadlink-manager/) to get your device type - Specify the device type in the configuration file -Example 1: Set up 0x5f36 as a remote +Example 1: Set up RM Mini 3 0x5f36 as a remote ```yaml # Example configuration.yaml entry @@ -201,7 +201,7 @@ remote: type: 0x5f36 ``` -Example 2: Set up 0x5f36 as switch +Example 2: Set up RM Mini 3 0x5f36 as switch ```yaml # Example configuration.yaml entry @@ -212,7 +212,7 @@ switch: type: 'rm_mini3_5f36' ``` -Example 3: Set up RM4 as switch +Example 3: Set up RM4 Mini as switch ```yaml # Example configuration.yaml entry @@ -220,7 +220,7 @@ switch: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: 'rm4' + type: 'rm4_mini' ``` ## Sensor @@ -365,7 +365,8 @@ friendly_name: required: false type: string type: - description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_5f36`, `rm4`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." + description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_5f36`, `rm4_mini`, `rm4_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` + devices can be registered as `sp2`." required: true type: string switches: From 72e8b88568cfe098143da08efedbe1c9654cd6ea Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Sat, 11 Apr 2020 02:36:50 -0300 Subject: [PATCH 08/10] Fix line break --- source/_integrations/broadlink.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index 5316acfc822e..ac0f947bac9b 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -365,8 +365,7 @@ friendly_name: required: false type: string type: - description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_5f36`, `rm4_mini`, `rm4_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` - devices can be registered as `sp2`." + description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_5f36`, `rm4_mini`, `rm4_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." required: true type: string switches: From 5e48b17223a5165677aa2d0fe28a2c5dfa1ffb71 Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Tue, 14 Apr 2020 23:25:56 -0300 Subject: [PATCH 09/10] Add recently discovered device types --- source/_integrations/broadlink.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index ac0f947bac9b..01a568585903 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -209,7 +209,7 @@ switch: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: 'rm_mini3_5f36' + type: 'rm_mini3_redbean' ``` Example 3: Set up RM4 Mini as switch @@ -365,7 +365,7 @@ friendly_name: required: false type: string type: - description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_5f36`, `rm4_mini`, `rm4_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." + description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_newblackbean`, `rm_mini3_redbean`, `rm4_mini`, `rm4_pro`, `rm4c_mini`, `rm4c_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." required: true type: string switches: From 1d30f1a8a6290f544a93f6911f123c925ef75622 Mon Sep 17 00:00:00 2001 From: Felipe Martins Diel Date: Fri, 17 Apr 2020 18:10:30 -0300 Subject: [PATCH 10/10] Use strings for device types --- source/_integrations/broadlink.markdown | 42 +++++++++++++++---------- 1 file changed, 25 insertions(+), 17 deletions(-) diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown index 01a568585903..d43bac300c53 100644 --- a/source/_integrations/broadlink.markdown +++ b/source/_integrations/broadlink.markdown @@ -45,9 +45,9 @@ mac: required: true type: string type: - description: Device type. + description: "Device type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_newblackbean`, `rm_mini3_redbean`, `rm4_mini`, `rm4_pro`, `rm4c_mini`, `rm4c_pro`." required: false - type: integer + type: string timeout: description: Timeout in seconds for the connection to the device. required: false @@ -180,17 +180,18 @@ script: ### Troubleshooting -Many users are experiencing problems with Broadlink RM Mini 3 0x5f36 and the entire RM4 series. +Many users are experiencing problems with the new Broadlink RM Mini 3 and the entire RM4 series. -If you have these devices, you need to follow these steps: +Once connected to the cloud, these devices lose their local capabilities and can no longer be controlled by Home Assistant. + +To fix the problem, you need to follow these steps: - Remove the device from Broadlink App -- Reset the device +- Factory reset the device - Add the device to your local network using the app - Do not set up a cloud (not now, not ever) -- Use [Broadlink Manager](https://sourceforge.net/projects/broadlink-manager/) to get your device type -- Specify the device type in the configuration file +- Specify the correct device type in the configuration file -Example 1: Set up RM Mini 3 0x5f36 as a remote +Example 1: Set up the new RM Mini 3 using remote platform ```yaml # Example configuration.yaml entry @@ -198,10 +199,10 @@ remote: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: 0x5f36 + type: rm_mini3_redbean ``` -Example 2: Set up RM Mini 3 0x5f36 as switch +Example 2: Set up RM4C Mini using switch platform ```yaml # Example configuration.yaml entry @@ -209,23 +210,26 @@ switch: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: 'rm_mini3_redbean' + type: rm4c_mini ``` -Example 3: Set up RM4 Mini as switch +Example 3: Set up RM4 Pro using sensor platform ```yaml # Example configuration.yaml entry -switch: +sensor: - platform: broadlink host: IP_ADDRESS mac: MAC_ADDRESS - type: 'rm4_mini' + type: rm4_pro + monitored_conditions: + - temperature + - humidity ``` ## Sensor -The `broadlink` sensor platform let you monitor data from an RM2 and A1 E-air. There is currently no support for the cloud API. +The `broadlink` sensor platform let you monitor data from an RM2, RM4 and A1 E-air. There is currently no support for the cloud API. To enable it, add the following lines to your `configuration.yaml`: @@ -253,6 +257,10 @@ name: required: false default: Broadlink sensor type: string +type: + description: "Device type. Choose one from: `a1`, `rm`, `rm2`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm4_mini`, `rm4_pro`, `rm4c_mini`, `rm4c_pro`." + required: false + type: string scan_interval: description: Time in seconds to fetch data from sensors. required: false @@ -365,8 +373,8 @@ friendly_name: required: false type: string type: - description: "Switch type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_newblackbean`, `rm_mini3_redbean`, `rm4_mini`, `rm4_pro`, `rm4c_mini`, `rm4c_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." - required: true + description: "Device type. Choose one from: `rm`, `rm2`, `rm_mini`, `rm_pro_phicomm`, `rm2_home_plus`, `rm2_home_plus_gdt`, `rm2_pro_plus`, `rm2_pro_plus2`, `rm2_pro_plus_bl`, `rm_mini_shate`, `rm_mini3_newblackbean`, `rm_mini3_redbean`, `rm4_mini`, `rm4_pro`, `rm4c_mini`, `rm4c_pro`, `sp1`, `sp2`, `honeywell_sp2`, `sp3`, `spmini2`, `spminiplus` or `mp1`. `SC1` devices can be registered as `sp2`." + required: false type: string switches: description: The array that contains all switches.