iCloud3 v3.0.rc7 (10/15/2023)

Change Log:

1. yaml Zones - Fixed a problem where zones configured using yaml were not being loaded when iCloud3 started.

2. Zone-Devices Count - New feature - The number of the devices within a zone is displayed with the tracking results on the Event Log. The counts are the numbers (x) after the zone name. For Example, the following shows 2-devices are not in a zone (Away), 1 is at School and 1 is in the Warehouse zone.
   Zone > Away (2) > Home-2.45km, IndRivShores-6.53km, School-8.47km (1), Publix-10.3km, ThePoint-11.0km, Quail-12.0km, Warehouse-16.5km (1), GPS-(/±47m)

   An item is also posted to the Event Log when another device changes it's zone:
   Zone-Device Counts > Home (4), School (1), Warehouse (1)

3. Stationary Zones - Minor changes to the handling of deleting a stationary zone when all devices have exited from it.

iCloud3 v3.0.rc6 Release Candidate 6 (10/10/2023)

This Release includes some bug fixes and a few updates. (rc5 was an internal update and never released)

Change Log:

1. Add Device Bug Fix - Fixes the bug where devices could not be added if this was a new installation.
2. Bug Fix - Fixed the error causing the "AttributeError: 'iCloud3_Device' object has no attribute 'interval_secs' message at line 680, in determine_interval_after_error" error.
3. China Users - Added an option to the Configure Settings - iCloud Account & iOS App Data Sources screen to enable the '.cn. Apple Web Server URL address suffix.
4. Monitored Devices - The iOSApp state value is no longer displayed on the Event Log if it is different than the iCloud3 zone and it is earlier the last FamShr update time since it is old and is probably incorrect.
5. iCloud3 Version - The version that is currently running is now displayed in the Configure Settings menu screen and more clearly on Event Log messages during startup.
6. Battery - HA has changed the battery 'state class' internal value from 'battery' to 'measurement'.
7. Prerelease Version number - This has changed to Release Candidate number to better conform to HA standards. Version pr1.5 was a developer test version and not released.
8. Configure Setting - Made some minor menu text changes for consistency.

iCloud3 v3, Prerelease pr1.5 (9/27/2023)

1. Bug Fix - Fixed the error causing the "AttributeError: 'iCloud3_Device' object has no attribute 'interval_secs' message at line 680, in determine_interval_after_error" error.
2. China Users - Added an option to the Configure Settings - iCloud Account & iOS App Data Sources screen to enable the '.cn. Apple Web Server URL address suffix

iCloud3 v3, Prerelease Version pr1.4 (9/22/2023)

Notes:

This is an update to Prerelease Version pr1.3 that fixes a few bugs and changes the way Stationary Zones are handled.

Change Log:

1. Bug Fix - Fixes a "type object 'GlobalVariables' has no attribute 'this_update_tine'" error. it should be '_time', not '_tine'
2. Fixed a problem adding the first device to a new iCloud3 installation that was generating a 'TypeError: 'NoneType' object is not callable -- Gb.async_add_entities_device_tracker(NewDeviceTrackers, True) error message.
3. Stationary zones - Stationary zones are now removed from HA Zones instead of moving them back to their 'base' location when all of the devices have exited the zone. Monitored devices will no longer create a stationary zone since they are not actually tracked.
4. Error handling - If a device goes offline for an extended period of time (in Airplane mode) the longest interval was changed from 2-hours to 1-hour. An iOS App Location Request will be made when the interval time changes to see if the device is now available for tracking.
5. China - Fixed a problem updating the Apple Web Server URL for China. This uses the HA Country Code or the Configuration File icloud_server_endpoint_suffix: "cn" parameter to add .cn to the https://www.icloud.com and https://setup.icloud.com URLs in the iCloud3-iCloud Account interface module.

iCloud3 v3, Prerelease v1.3 (8/23/2023)

This is an update to Prerelease v1.1 that contains the pr1.2 & pr1.3 patch files.

Change Log:

1. Battery - Fixed a problem where the battery level/status was not being updated immediately in the Event Log when it went from 'charging' to 'not charging' or 'not charging' to 'charging'.
2. GPS - The 'Show GPS Coordinates' parameter is now applied when the event is displayed in the Event Log instead of when it is added to the Event Log. You can disable this parameter so they are not normally displayed. Later, if you need to review where a device has been, reenable the parameter and the location coordinates for previous events will be displayed.
3. Event Log - Fixed a problem where the event time was not displayed if the 'Zone Display-as' parameter was set to display the zone entity_id.
4. Event Log - Fixed a problem with the Event Log Card not detecting a version update.

iCloud3 v3, Prerelease 1.1 (8/20/2023)

New version and release name - pr1/pr1.1. Previous release version and release name was rc3/rc3a/rc3b
Fixes some minor bugs in rc3a and renamed pr1:

1. Reload iCloud3 - Fixed the Configure Settings > Actions > Reload iCloud3 so it works.
2. iOSApp location data - The location data from the iOS App is now updated based on the locations time earlier in the data analysis process. It was looking at whether or not the data needed to be updated instead of just doing it if it was newer.
3. Fixed a DeletedDeviceEntry error message being displayed when starting up.

This is a rerelease of rc3b that is renamed as pr1a (version is displayed as pr1) to keep it in sync with the iCloud3 repo prerelease. There was also a quick update to fix item 3 that did not get picked up correctly as a new commit in rc3b.

iCloud3 v3, Release Candidate 3 (8/19/2023)

I think this will probably be the final Release Candidate in the iCloud3_v3 repository. The next step will be creating a pre-release in the main iCloud3 repository that will get picked up by HACS. Both the iCloud3 and iCloud3_v3 repositories will be maintained for a while. Any issues identified and fixed will continue to be released in iCloud3_v3 before being promoted to iCloud3.

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:

1. Reverted the 'manifest.json' file to prevent iCloud3 from hanging on an HA startup if there is a problem starting some of the HA components.
2. Configure Settings - Added a 'Restart HA, Reload iCloud3' to the Configure Settings > Actions list. You can now restart HA or reload only the iCloud3 component if the is a problem.
3. Migration - Fixed some v2 to v3 configuration migration issues.
4. Area - The device will be assigned to the 'Personal Device' Area when it is added or when iCloud3 starts if it is not assigned to one.
5. Old Location - The status of both the iOS App and FamShr location is now checked when seeing if the old location status/counter should be reset as soon as the data is available. It was being reset only when the FamShr data was updated and later in the tracking process.

iCloud3 v3, Release Candidate 2 (8/8/2023)

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:

1. Fixed the problem causing the duplicate_msg error during start up.
2. Services - Added the iCloud3 Service Calls to the Developer tools > Services screen.
3. Cleaned up some code.
4. Direction of Travel History - Reformatted the history that is display when showing Tracking Monitors

iCloud3 v3, Release Candidate 1 (8/6/2023)

iCloud3 has graduated from a Beta status to a Release Candidate status.

Beta 1 was uploaded in Dec, 2022 and went through 20 iterations. During that time many features were added based on your feedback, suggestions and feature requests. Not to mention that more than a few bugs were found and fixed. Right now, it has almost 30,000 lines of code and took more than 2 1/2 years from the last release of v2. At the last count, v2 has about 9800 downloads world wide.

Thanks for working with me. I appreciate it,

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:

1. Event Log - Changed the text on the heading for each update. Now the Arrival Time (if going towards Home or another Track-fromZone) or the Next Update time is displayed.
2. Short interval tracking (15-secs when close to a zone) - The current location data is used if it is below the old location threshold. When interval is short (5-secs) after leaving or approaching a zone, that location was reused when the next interval was reached since it was not old and still acceptable. Now, the next update interval time is taken into consideration when determining if the locaqtion should be refreshed.
3. iOS APP Loation Request - If the iCloud account (FamShr) location is old a number of times in a row, a location request will be sent to the iOS App on every 4th iCloud request.
4. Improvements to Monitored Devices tracking.

iCloud3 v3, Beta 20.1.1 (8/3/2023)

iCloud3 v3, Beta 20.1 was Uploaded

1. The HA 2023.08 broke the way iCloud3 set up the notifications for iOSApp devices and the way the iOS App state and attributes values were being read. This has been fixed.
2. And a few other things

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:

1. The HA 2023.08 broke the way iCloud3 set up the notifications for iOSApp devices and the way the iOS App state and attributes values were being read. This has been fixed.
2. Direction of Travel - Tweaked the method used to determine how the direction of travel was being set.
3. Tracking from another zone - The zone name that is used to determine the next update is now capitalized. Also, it will only be used when traveling towards that zone, not away from it. When traveling away from it, the Home zone is used.
4. Monitored Devices - Their information is now displayed using the same 'next_update_time' method as tracked devices. This greatly reduces the duplicate results in the Event Log.
5. Event Log - Tweaked some display methods to improve readability. A browser refresh is needed.