Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rflink cover component #3145

Merged
merged 11 commits into from
Oct 9, 2017
Merged

Rflink cover component #3145

merged 11 commits into from
Oct 9, 2017

Conversation

passie
Copy link

@passie passie commented Aug 6, 2017

New cover component for the rflink component.

Pull request in home-assistant (if applicable): home-assistant/core#9432

Copy link
Contributor

@Landrash Landrash left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some missing information and formation that can be improved upon.

footer: true
logo: rflink.png
ha_category: Cover
ha_release: 0.50
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Release will need to be updated before merge. Most likely to 0.52 since 0.51 is rather imminent.

logo: rflink.png
ha_category: Cover
ha_release: 0.50
ha_iot_class: "Local Polling"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this component really Polling?

RTS_0100F2_0:
name: SunShade
```

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Configuration variables are missing.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Configuration variables are added to the readme.


The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). RFLink gateway is an Arduino firmware that allows two-way communication with a multitude of RF wireless devices using cheap hardware (Arduino + transceiver).

First you have to set up your [rflink hub](/components/rflink/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Markdown has very good support for list and nested lists. Suggest you look in to how that's formatted and apply that to increase the readability of this guide.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure what you mean by this comment, since it's a exact copy of readme from the rflink/light component.
I have rewritten some parts of the readme. So hopefully it's correct now.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Example of a nested list 🙂

  • Level 1
    • Level 2
      • Level 3

---

The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). RFLink gateway is an Arduino firmware that allows two-way communication with a multitude of RF wireless devices using cheap hardware (Arduino + transceiver).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest you add a header to this list called installation or setup.

@Landrash Landrash added the new-integration This PR adds documentation for a new Home Assistant integration label Aug 9, 2017
@passie passie changed the title Rflink Somfy cover component Rflink cover component Aug 9, 2017
Copy link
Contributor

@Landrash Landrash left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good and can be merged when parent PR is merged 🍪

Copy link
Member

@frenck frenck left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Found some minor spelling & grammar issues.
@passie, could you please take a look?

ha_release: 0.53
---

The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). RFLink gateway is an Arduino firmware that allows two-way communication with a multitude of RF wireless devices using cheap hardware (Arduino + transceiver).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling & Grammar:

  • Missing comma after example -> for example, the Nodo RFLink


The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). RFLink gateway is an Arduino firmware that allows two-way communication with a multitude of RF wireless devices using cheap hardware (Arduino + transceiver).

First you have to set up your [rflink hub](/components/rflink/).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling & Grammar:

  • Missing comma after First -> First, you have to

The `rflink` component support devices that use [RFLink gateway firmware](http://www.nemcon.nl/blog2/), for example the [Nodo RFLink Gateway](https://www.nodo-shop.nl/nl/21-rflink-gateway). RFLink gateway is an Arduino firmware that allows two-way communication with a multitude of RF wireless devices using cheap hardware (Arduino + transceiver).

First you have to set up your [rflink hub](/components/rflink/).
After configuring the RFLink hub covers will be automatically discovered and added. With the exeption of the Somfy RTS devices.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling & Grammar:

  • exeption -> exception.
  • Alternatively, you could replace With the exception of the Somfy RTS devices. by Except the Somfy RTS devices.


After configuring the RFLink Somfy RTS you have to add the cover to the configuration like any other RFlink device.

RFLink cover ID's are composed of: protocol, id and gateway. For example: `RTS_0100F2_0`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling & Grammar:

  • Missing comma after id -> protocol, id, and gateway.


RFLink cover ID's are composed of: protocol, id and gateway. For example: `RTS_0100F2_0`.

Once the ID of a cover is known it can be used to configure the cover in HA, for example to add it to a different group, hide it or configure a nice name.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling & Grammar:

  • Missing comma after known -> cover is known, it can be used
  • HA -> Home Assistant
  • Missing comma after example -> in HA, for example, to add
  • Suggestion: or configure a nice name. -> set a nice name.


Once the ID of a cover is known it can be used to configure the cover in HA, for example to add it to a different group, hide it or configure a nice name.

Assigning name to a cover:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling & Grammar:

  • Missing determiner for name -> Assigning a name to a cover

minor spelling & grammar issues
@frenck
Copy link
Member

frenck commented Sep 2, 2017

Thanks for fixing the issues @passie! 🥇

@passie passie mentioned this pull request Oct 9, 2017
@fabaff fabaff merged commit f597f65 into home-assistant:next Oct 9, 2017
fabaff pushed a commit that referenced this pull request Oct 9, 2017
* Markdown for rflink cover

* .

* Rewritten some parts based on the feedback from Landrash

* Rewritten some parts based on the feedback from Landrash ( now saved the file :) )

* Update cover.rflink.markdown

* bump version release

* Fixed comments from frenck
minor spelling & grammar issues

* version bump

* Update cover.rflink.markdown

* version bump didn't made it in 0.54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new-integration This PR adds documentation for a new Home Assistant integration
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants