iCloud3 v2.3.2 Maintenance Release

The following bug was fixed in the iCloud3 v2.3.2 update:

• The Name parameter was not being decoded correctly due to a bug introduced in iCloud3 v2.3.1.

Also:

• Added a device_type parameter to override a value extracted from the device_name parameter.
• Updated the iCloud3 version number which was not updated in the v2.3.1 release.

iCloud3 v2.3.1 Maintenance Release

The following bugs have been fixed in iCloud2 v2.3.1.

• The name specified in the Settings App > General > About > Name field (Gary-iPhone) can now be specified on the device_name configuration parameter. Previously, the value in the HA device_tracker entity id had to be specified (gary_iphone).
• When specifying the zone parameter in configuration file for a device. It should be 'track_from_zone'.
• When specifying how the zone displayed (display_zone_as: fname). It was always displaying the zone's name instead of the friendly name.
• When the devicename was duplicated in the Family Sharing List. If an older device has the same name as the newer device, the location was being requested for the older device instead of the newer device. The older devicename probably does not exist anymore so no location information was returned for it.
• When optimizing the device's tracking method. The Family Sharing tracking method was always selected for all devices if they were all in the Family Sharing list and in the Friends list on the FindMy App. In this situation, the Find-my-Friends tracking method should be assigned to each device.
• When the unit_of_measurement parameter was specified in the config_ic3.yaml as 'km'. The unit_of_measurement ('mi' or 'km') would be displayed correctly but the value being displayed was always the miles value.
• Cleaned up the iCloud3 code - Removed the old 2sa Authentication code, removed other obsolete code, cleaned up some messages, removed zone_name_1/2/3 and last_zone_1/2/3 sensors left in by mistake.
• Updated the iCloud3 documentation.

iCloud3 v2.3 (January, 2021)

iCloud3 v2.3 is a significant enhancement to iCloud3. It's major enhancements include:

• Support for Apple's 2-factor authentication trusted device verification. This is the real verification process, the one you are familiar and used by other 2fa apps, web sites and browsers. It replaces the 2-step verification method you have ben using for years.
• The iCloud Location Services tracking methods (Find-my-Friends and Family Sharing) have been combined and the most efficient method is assigned by iCloud3 on a per-device basis. iCloud3 analyzes how your devices are configured and determines the one to use that will minimize the number of locations requests. This reduces the lag time between the request and the response and helps lower the number of old locations received.
• The configuration parameters for defining devices has changed to provide for future device specifications and to conform to HA's methods of configuring devices. The old track_devices still works but is being depreciated.
• Updated the handling of the config_ic3.yaml iCloud3 configuration file.
• New configuration parameters.
• Fixed some bugs.

Gary Cobb, aka Geekstergary
January, 2021

Edit: 1/13/2021

1. Fixed a minor bug handling track_from_zone parameter specified for a tracked device.
2. Fixed a problem displaying the zone's friendly name.

iCloud3 v2.2.1

iCloud3 v2.2.1 includes enhancements, bug fixes and some new configuration parameters. Details are in the iCloud3 User Manual here but the major ones are:

• Updates to the iOS App tracking method that support phone polling requests and updates like the Family Sharing and Find-my-Friends tracking methods.
• Improved zone/zone name display and handling.
• New configuration parameters for displaying zone names in the Event Log and using a 24-hour time format.
• Improved handling of old locations.
• Ability to display the iCloud3 User Manual from the Event Log.
• Improved support for how the iOS App handles zone change notifications.
• Bug fixes.

Updated to v2.2.1a (11/4/2020)

• Fixed a bug where the device_tracker/[DEVICENAME] state was being set to Home instead of home or Away instead of not_home.
• Depreciated the zone_name1, zone_name2 and zone_name3 entities. They have been renamed to zone_name, zone_title and zone_fname respectively. See the 2.4 Using Sensors in the iCloud3 User Manual for more information. You should change any automations and scripts that use the zone_name# entities.

iCloud3 v2.2 (October, 2020)

This is a major enhancement to iCloud3 that includes:

• The Find-my-Friends and Family Sharing tracking methods have been completely rewritten to support iCloud 2fa accounts.
• Eliminated the need for the 'dummy non-2fa' iCloud account that was required in previous versions of iCloud3.
• Improved iOS App monitoring.
• Enhancements to the iCloud3 Event Log.
• Support for a special iCloud3 configuration file.
• Extensive performance enhancements to minimize the interaction between iCloud3 and the iCloud Location Service.
• New configuration parameters.
• Various Bug fixes.
• Overhauled the iCloud3 documentation.

Review the Change Log for a complete list of the changes and enhancemennts.

iCloud3 v2.1 (3/22/2020)

Device Tracking

• Added checks to recover when no contact data was returned from iCloud Location Services during setup
• You can specify the device users name on the track-device configuratio
• Added raw data debug logging
• Internal changes.

Stationary Zone

• Changed location of initial Stationary Zone to .5km north or south of the Home Zone
• The Stationary Zone is not hidden when you exit it
• Icons associated with the device are displayed on the HA maps
• The Stationary Zone is relocated as you move within it

Event Log card

• Added highlighting to major actions
• The start-finish tracking activity sequence is tied together to easily identify the trigger results.
• Added Debug & Restart-iC3 buttons
• The sensor.icloud3-event-log entity is reset to only show the last 15 items after 5-minutes to reduce it's size
• Other visual enhancements

Other enhancements

• iCloud3 Sensor Changes
• pyicloud-ic3 Support Program Enhancements

See the ChangeLog in the documentation for a detailed list of the enhancements

iCloud3 v2.0.5 Maintenance Update (12/8/2019)

• Fixed a bug introduced in v2.0.4 where a coding error caused NoRoute information to be returned from Waze.
• Added GPS location to Stationary Zone Set Location Event Log message.
• Reset the Stationary Zone to it's base location (90, 180) when an update is being done, the device is in a non-Stationary zone and the Stationary Zone is set to a valid location.
• Raw contact data from the 'username' non-2fa iCloud account will be added to the HA log file when setting up the FmF tracking method. Add the 'log_level: debug' parameter to the iCloud3 configuration and restart HA. Go to 'Sidebar>Developer Tools>Logs' to see the Log entries. Look for "_____ Raw iCloud Contact Data _______" and review the raw data for each contact on the following line. It will be in json format, e.g., 'emails': ['gary_2fa_acct@email.com', 'gary_456@tw'].

iCloud3 v2.0.4 Maintenance Update (11/29/2019)

This release fixes the following issues:

• When the device's location, interval and next poll information were being updated, there were times when the state was 'stationary' but it had actualy moved into another zone. This might be caused by zones being close together, by no zone exit notification from the ios app or by the next update trigger being processed before the zone exit trigger had been received. This caused the device's location to be reset to the old location instead of the new location. This has been fixed.
• Waze history data is used to avoid calling Waze for route information when you are near another device or in a stationary zone with accurate Waze route information. If you were in a stationary zone and entered another zone without a zone exit trigger, the Waze history was still pointing to the old stationary zone. The old location information was being used for distance and interval calculations instead of the new location information. A check was added to always refresh the Waze route information when the state changes.

iCloud3 v2.0.3 Maintenance Update (11/27/2019)

• Fixed a problem with a malformed message that displayed old location information in the Event Log.
• Added a list of devices that are tracked and not tracked for the Family Sharing (famshr) tracking method. This is created when the iCloud account is scanned looking for the devices in the track_devices configuration parameter.

iCloud3 v2.0.2 Maintenance Release (11/27/2019)

Don't download, found a malformed information message dealing with old location information

---

This release fixes the following issues:

• Fixed problem calculating distance and intervals for a second zone.
• Reformatted some Event Log messages.
• Fix for HACS update.