Skip to content

Expand ecobee documentation for set_hold_mode #5980

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

Merged
merged 3 commits into from
Aug 17, 2018

Conversation

dbrowndan
Copy link
Contributor

Add some notes explaining how to access your custom ecobee Comfort Settings when using the 'set_hold_mode' service
Source: My own experimentation

Description:
Just minor documentation tweaks.

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

Checklist:

  • Branch: Fixes, changes and adjustments should be created against current. New documentation for platforms/components and features should go to next.
  • The documentation follow the standards.

@ghost ghost added the to-do label Aug 8, 2018
@frenck frenck added enhancement in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch and removed to-do labels Aug 8, 2018
frenck
frenck previously requested changes Aug 8, 2018
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.

Since this PR changes the currently existing documentation, the target branch should be current.
Please change the target and rebase if needed.

@dbrowndan dbrowndan changed the base branch from next to current August 8, 2018 22:56
@dbrowndan dbrowndan closed this Aug 9, 2018
@ghost ghost removed the in-progress This PR/Issue is currently being worked on label Aug 9, 2018
Added some notes explaining how to access your custom ecobee "Comfort Settings" when using set_hold_mode
@dbrowndan
Copy link
Contributor Author

Thanks for bearing with me. This is my first ever attempt to commit to a major open-source project. Learning to rebase now. Closed by accident, reopening.

@dbrowndan dbrowndan reopened this Aug 9, 2018
@ghost ghost added the to-do label Aug 9, 2018
@frenck frenck added ready-for-review This PR needs to be reviewed current This PR goes into the current branch and removed needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch to-do labels Aug 9, 2018
@frenck
Copy link
Member

frenck commented Aug 9, 2018

Well... you did a fine job @dbrowndan 👍
Marking PR ready for review.

@@ -245,7 +245,7 @@ canceled.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
| `hold_mode` | no | 'temp', 'home', 'away', 'sleep', etc., None
| `hold_mode` | no | `temp`, `home`, `away`, `sleep`, `None`, etc. NOTE: If you create custom hold modes (also known as "Comfort Settings") on your ecobee.com dashboard, their hold_modes are 'smart1', 'smart2', 'smart3', etc. The number for each custom mode should match the mode's icon on your ecobee.com dashboard. Also note that the mode numbers/icons in the ecobee mobile app MAY NOT MATCH the numbers/icons from the ecobee.com web dashboard. The ones on the website are the ones you shoud use to determine the correct 'smartX' hold_mode IDs.
Copy link
Contributor

Choose a reason for hiding this comment

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

This makes the table hard to read IMO - it'd be better having that as a follow on paragraph after the table.

@dbrowndan
Copy link
Contributor Author

Thanks for looking things over, @DubhAd! Changes committed.

| `hold_mode` | no | 'temp', 'home', 'away', 'sleep', etc., None
| `hold_mode` | no | `temp`, `home`, `away`, `sleep`, `None`, `smart1`, `smart2`, etc.

NOTE: If you create custom hold modes (also known as "Comfort Settings") on your ecobee.com dashboard, their hold_modes are `smart1`, `smart2`, `smart3`, etc. The number for each custom mode should match the mode's icon on your ecobee.com dashboard. Also note that the mode numbers/icons in the ecobee mobile app MAY NOT MATCH the numbers/icons from the ecobee.com web dashboard. The ones on the website are the ones you shoud use to determine the correct 'smartX' hold_mode IDs.
Copy link
Contributor

Choose a reason for hiding this comment

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

Sorry, missed the SHOUTING - please use italics for emphasis

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sure thing, updated. Thanks again.

Copy link
Contributor

@DubhAd DubhAd left a comment

Choose a reason for hiding this comment

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

👍

@DubhAd DubhAd dismissed frenck’s stale review August 17, 2018 09:16

Target is correct

@DubhAd DubhAd merged commit 42e60cc into home-assistant:current Aug 17, 2018
@ghost ghost removed the ready-for-review This PR needs to be reviewed label Aug 17, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
current This PR goes into the current branch
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants