GUI application and command line tool to handle loading 
and saving of clocks on address A12.
Works with RF5C01A, MSM6242B and compatible clocks.

ClockPort
---------
This is a GUI application to show clocks on different ports. 
Clock time and date are shown directly from the data on the clock-port. 
Raw data is shown in the 0x0 to 0xF fields. 
Select the port from the list to attempt to load and identify the clock.

Options
- Reset: reset all registers on the clock and sets 24h time
- Stop: stop a clock (only useful to test your clock is responding)
- Start: start a clock (only useful to test your clock is responding)
- Load: write the clock data from the battery clock to the Amiga
- Save: write the Amiga system time to the battery clock

Reading and writing clocks take into consideration the locale timezone.

Emulated environments do not accurately replicate battery clocks and
therefore this application will not alter the clocks with stop, start
and reset commands.

LoadClockA12
------------
For use with hardware clock-ports on A1200 Gary 
supportting addresses from A12.
An example is Matthias Münch's A1200 Gayle adapter.

LoadClockA12 is a command line utility to set the Amiga system clock from 
the battery clock on address lines A12-A15. 

Simply add this to your S:startup-sequence to load the clock on start-up.
Returns warning (5) if no clock detected. May return error (10) if there
are issues setting the system time.

IMPORTANT NOTE:
---------------
These applications should be used on known clocks existing on the clock-port!
Any attempt to reset, stop, start, load or save on other clock-port hardware
could cause damage or unexpected behaviour to non-battery clock devices.

Legal Information
-----------------
ClockPort and LoadClockA12 are Copyright (c) 2022 Aidan Holmes

Redistribution and use of the binaries are permitted as long as the 
file names are retained, binaries are unmodifed 
and the above copyright notice is reproduced.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 9171   16872  54.4% -lh5- bfea Aug 15 18:43 ClockPort
[unknown]                 1520    3104  49.0% -lh5- f955 Aug 15 18:43 ClockPort.readme
[unknown]                 5463    9120  59.9% -lh5- a192 Aug 15 18:43 LoadClockA12
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         3 files   16154   29096  55.5%            Aug 16 16:42