This release fixes a few bugs with the Fixed Interval parameter introduced in rc10.1. It also simplifies access to NearBy device distance attributes and cleans up some code.
Gary
Important Links
Installing using HACS - iCloud3 is not available on HACS unless you have set it up as a custom repository. See here for instructions on how to do that and then install it. If you just go to HACS and do the installation, you will be installing v2.4.7, not v3.
Manual Download and Install - Go to the iCloud3 Releases page here. Scroll down past the notes, then select Assets, then select icloud3.zip. Download the zip file and unzip it into the /config/custom_components/icloud3 directory. Then restart HA.
Migrating from v2.4._ - See here for instructions on migrating from from an older version.
iCloud3 v3 Documentation - It is still in process, does not include the latest updates to iCloud3 and can be found here
Change Log
-
FIXED INTERVAL -
-
Normally, when a device is getting close to Home, the location interval changes to 15-secs to be able to update the Home distance very quickly. This lets automations fire when approaching Home in addition to when entering the Home zone. When a Fixed Interval was being used, the Fixed Interval was overriding the short interval time iCloud3 calculated based on distance from Home so iCloud/FamShr locates were never being done. Additionally, a locate request would not be done if the Old Location Threshold was greater or the same as the Fixed Interval value and old locations were being accepted.
Now, iCloud3 will calculate the interval using the distance from Home as it normally does. If that value is less than 5-minutes, it will be used. Otherwise, the Fixed Interval will be used if it is set.
-
Fixed a problem where the results from one device with a Fixed Interval was being used for another nearby device that was not using a Fixed Interval.
-
The minimum Fixed Interval is still 5-minutes.
-
-
TRAVEL TIME INTERVAL AND NEXT LOCATION UPDATE MULTIPLIER - (Configure Settings > Tracking Parameters screen) - This value (.1 to .8) is used to determine the Interval and when the Next Location Update should be made using the travel time to Home. For example, if the travel time is 8-mins and the multiplier is .5, the next update will be done in 4-mins. This has been changed from entering a decimal value (.1 to .8) to a drop down list that goes from Shortest Interval Time, to Shorter Interval Time, to Average, Longer and Longest. It defaults to Average (.5*TravelTime) and you will probably never change it.
-
HOME_DISTANCE & ZONE_DISTANCE SENSOR - Changed the way the zone and devices distances are displayed to provide better accuracy and make it easier to display them on a dashboard screen entity card. The iCloud3 documentation > Sensor Attribute chapter was updated to provide screenshots and example code that will help explain how to do this.
-
OTHER STUFF - Fixed a few other bugs. Cleaned up some code.