Add Colored Flash Example to deCONZ

[D34DC3N73R]

Proposed change

Update documentation with an example of colored flashing of hue bulbs via deconz.configure as a workaround since the light.turn_on service with flash:long|short and color does not work with deCONZ.

Type of change

• Spelling, grammar or other readability improvements (current branch).
• Adjusted missing or incorrect information in the current documentation (current branch).
• Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • I've opened up a PR to add logo's and icons in Brands repository.
• Added documentation for a new feature I'm adding to Home Assistant (next branch).
• Removed stale or deprecated documentation.

Additional information

• Additional discussion: https://community.home-assistant.io/t/update-deconz-integration-to-support-flash-with-color/246904

Checklist

• This PR uses the correct branch, based on one of the following:
  • I made a change to the existing documentation and used the current branch.
  • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
• The documentation follows the Home Assistant documentation standards.

[Kane610]

Awesome! Thanks for contributing. Looks good to me

[D34DC3N73R]

Ok so, I think the original script example had some errors. It should use entity instead of entity_id if I'm not mistaken, and entity should be in the first data: of the service call. I thought the nested data: lines were an error too but it turns out it's required so field can be included. I couldn't get the script to run correctly at first so I changed the example to an automation.

The replacement automation example works too. But IMO, this updated script may be a better example with less extraneous detail.

script:
  hue_lamp_flash:
    alias: Hue Lamp Flash
    sequence:
    - service: deconz.configure
      data:
        field: /state
        data:
          'on': true
          hue: 65535
          sat: 255
          bri: 255
          alert: breathe
        entity: light.hue_lamp
    - delay: '15'
    - service: deconz.configure
      data:
        field: /state
        data:
          'on': false
        entity: light.hue_lamp
    mode: single

Sorry for the runaround. Let me know if you'd like this to be submitted as another commit, or even as a separate PR.

[frenck]

This is not documenting flashing but a breathing flash effect, which is kinda Philips specific. I think we need to be clear on the difference in the description.

[frenck]

removed the review request, as my original suggestion in the review comment wasn't resolved.

[D34DC3N73R]

I updated the Note: line to include Philips Hue by name.
alert: breathe is what hue bridge uses with service light.turn_on and flash, so I think it makes sense to keep that description for users looking for a replacement.

[frenck]

Thanks 👍