Skip to content

Improving icloud device tracker#5240

Merged
fabaff merged 2 commits into
home-assistant:nextfrom
evgeniy-khatko:patch-1
May 8, 2018
Merged

Improving icloud device tracker#5240
fabaff merged 2 commits into
home-assistant:nextfrom
evgeniy-khatko:patch-1

Conversation

@evgeniy-khatko
Copy link
Copy Markdown
Contributor

@evgeniy-khatko evgeniy-khatko commented Apr 24, 2018

Updating documentation for new pull request to main HA codebase: "Improving icloud device tracker"

Description:

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

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.

Updating documentation for new pull request to main HA codebase: "Improving icloud device tracker"
@frenck frenck added the new-feature This PR adds documentation for a new Home Assistant feature to an existing integration label Apr 24, 2018
@evgeniy-khatko
Copy link
Copy Markdown
Contributor Author

Anyone can take a look at this?
Thanks!


4 services are available for this component:
- **icloud_update**: This service can be used to ask for an update of a certain iDevice. The `account_name` and `device_name` are optional.
- **icloud_update**: This service can be used to ask for an update of a certain iDevice. The `account_name` and `device_name` are optional. Request will result in new Home Assistant event describing current iphone location. Can be used in automations when manual location update is needed, e.g. to check if anyone is home when door's been opened.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Can you indicate what event is fired?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Updated with link to state_changed event.

- **username** (*Required*): The username for the iCloud account.
- **password** (*Required*): The password for your given username.
- **account_name** (*Optional*): The friendly name for the account_name. If this isn't given, it will use the account_name of the username (so the part before the `@` in the email address).
- **max_interval** (*Optional*): Maximum interval in minutes between subsequent location checks. This tracker uses dynamic intervals for requesting location updates. When iphone is stationary, interval will eventually be set to `max_interval`. This saves battery. E.g. setting it to 10 means that when you start moving after being stationary, maximum 10 min will pass until your location starts updating. Default is 30 min. Very minimum value is 1 min.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Can you simplify what does For example, setting it to 10 means that when you start moving after being stationary, maximum 10 min will pass until your location starts updating. mean? I am guessing, if the phone is stationary, it updates every 10 minutes. What about when the phone is not stationary?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Rephrased a bit. Let me know if it still sounds confusing.

Copy link
Copy Markdown
Member

@fabaff fabaff left a comment

Choose a reason for hiding this comment

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

Thanks 🐦

@fabaff fabaff modified the milestones: 0.69, 0.70 May 8, 2018
@fabaff fabaff changed the base branch from current to next May 8, 2018 21:44
@fabaff fabaff removed this from the 0.70 milestone May 8, 2018
@fabaff fabaff merged commit 9dce793 into home-assistant:next May 8, 2018
Oro pushed a commit to Oro/home-assistant.github.io that referenced this pull request May 20, 2018
* Improving icloud device tracker

Updating documentation for new pull request to main HA codebase: "Improving icloud device tracker"

* Update device_tracker.icloud.markdown
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-feature This PR adds documentation for a new Home Assistant feature to an existing integration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants