amigaXfer is an easy to use GUI tool for lightning fast serial-port floppy and
file transfers.

As it uses the Kickstart built-in debugger, no software is needed in the Amiga
side. Just loadwb -debug, select the Debug/RomWack/SAD option in Workbench's
extra debug menu and enjoy.

This is a Win32 (Windows 7+) build. Alternatively, source code (python and
m68k assembly) is available under MIT license, and runs on multiple platforms,
requiring Python 3.8+, pyserial and wxpython.

It is even possible to bootstrap an Amiga for which no bootable disks are
available.
https://rvalles.net/bootstrapping-an-amiga-without-a-bootable-amiga-floppy.html

If no serial cable is available but a parallel link cable is, then do consider
Ralf Hoffmann's APCComm.
http://www.boomerangsworld.de/cms/apccomm/index.html

*** AmigaXfer's highlights
- Supports RomWack (AmigaOS 1.x, 2.x and Hyperion 3.x) and SAD (AmigaOS 3.x)
  builtin debuggers.
- High speed transfers; 512kbps possible on basic 68000 7MHz A500.
- Can be used to bootstrap an Amiga for which no bootable disks are available.
- Checksums (CRC32/ISO-HDLC) used throughout to ensure transfer integrity.

*** About the serial port
- Only three wires are used: RX, TX and GND.
- "null-modem" cable setup:
--  RX \/ RX
--  TX /\ TX
-- GND -- GND
- IBM PC standard serial port only support up to 115200 bps.
- USB-serial controllers can generally handle higher speeds.
- Short cables work better. USB adapters can make this trivial.

*** Entering the debugger
- Load WB with "loadwb -debug", then select romwack/sad on debug menu.
- Use provided debug AmigaOS binary and icon, on CLI or WB.
- Boot from provided debug bootblocks.
- Crash the Amiga, enter the debugger as power led blinks.
-- Refer to URL above or included bootstrap doc.
- Crash the Amiga with a non-critical guru (no reboot or blinking led).
-- Use ResetFirst setting, right click the mouse on guru screen.

*** Features
- Floppy Tool
-- Read/Write/Compare ADF.
-- All four floppy drives.
- Bootblock Tool
-- Write included bootblocks to any floppy drive.
-- Does read and apply the existing filesystem's flags.
-- Able to format the first track to make non-Amiga formatted disks bootable.
- DOS Tool (preview)
-- Read and write files.
-- Volume names are discouraged. Drive names are recommended.
-- Use of RAM: recommended, particularly as destination.
-- If targetting floppy drives (like DF0:), delays to allow drive to settle.
-- Hard disk targets are discouraged, as writes could happen late if at all.
- ROM Tool
-- Dump the Amiga's kickstart rom.

*** Version History
1.1.1 (2021-07-08)
- SetupDialog
-- Detect missing m68k objects.
-- Better UX on connection issues.
- Bootblock Tool
-- New bootblocks:
--- exitstrap is a hack to actually exit strap's init routine.
--- warmdos is exitstrap + start dos via WarmCapture(). A curiosity.
- DOS Tool (preview)
-- BUG: Fix crash with AmigaOS 2.x and setpatch.
-- File transfers can now be interrupted.
- Improved log output.
- Thanks to Ralf Hoffmann for AmigaOS 2.x issue report and testing fix and 
  Daniel Doran for pre-release testing.

1.1.0 (2021-05-18)
- SetupDialog
-- ResetFirst will reboot machine during connection.
--- Allows entry via non-critical guru right click.
--- Writing floppies is slightly faster in this environment, due to less tasks
    running.
--- DosTool not usable in this environment due to dos.library being not yet
    initialized.
- FloppyTool
-- BUG: Fixed tool not working at all and instead spitting FCh ioerr on some
   machines.
--- Thanks to Michael Kagerbauer for reporting issue and testing fix.
-- Disk2ADF will now retry reads 5 times before giving up.
-- More user friendly IO error reporting.
--- Thanks to Michael Kagerbauer for feedback on old IOERR reporting.
- BootblockTool
-- Better error reporting.
- BUG: Fixed issue in workaround for WRITE_BYTE SAD bug (kick v39).
- Workaround introduced for SAD reboot function ACK bug.
-- SAD doesn't check TSRE after writing ACK to SERDAT; reboot will interrupt
   ACK on a fast CPU.
-- Don't bother waiting for ACK.
- Floppyless Bootstrap should now work on all kickstarts.
-- Tested on kickstart 34/37/39/40/45/46.
- Size SetupDialog/RomTool windows to contents.
-- Thanks to Alexander Fritsch for feedback/screenshots on window sizing
   issues with some win7 themes.
- Cleaned up tool startup/cleanup procedures for all tools.

1.0.1-newzip (2021-04-03)
- Reissued zip as win7's zip support had trouble unpacking the old one. It
  does not like advzip (advcomp) zips.

1.0.1 (2021-04-02)
- RomTool
-- Initialization GUI work outside GUI thread issue fixed.
-- Kickstart detection logic is now slightly more clever.
-- Can now be interrupted mid-dumping.
-- Larger transfer blocks, faster dumping.
-- Timer added.
-- Debug text output added.
- DosTool
-- Target directory can safely contain a trailing slash.
-- Buffer size scales with free RAM, up to 256KB. Faster.
-- Timer added.
- FloppyTool
-- Progressbar added.
- UI improvements.
- Documentation improvements.

1.0.0 (2021-03-25)
- Initial release.


*** Other Amiga projects from me
- comm/term/amigaterm_enh: 1985 serial port ANSI Terminal, enhanced

Archive:  /home/aminet/aminet_root/doc//comm/misc/amigaXfer_win32.zip
 Length   Method    Size  Cmpr    Date    Time   CRC-32   Name
--------  ------  ------- ---- ---------- ----- --------  ----
       0  Stored        0   0% 2021-07-07 20:43 00000000  amigaXfer_1.1.1/
 2143741  Defl:N  2043960   5% 2021-07-07 20:20 87c853f5  amigaXfer_1.1.1/amigaXfer.exe
    1495  Defl:N      627  58% 2021-07-07 20:20 1ed67dd9  amigaXfer_1.1.1/amigaXfer.exe.manifest
   18744  Defl:N    10432  44% 2021-03-08 13:35 c01e093d  amigaXfer_1.1.1/api-ms-win-core-console-l1-1-0.dll
   18232  Defl:N    10260  44% 2021-03-08 13:35 feef3b91  amigaXfer_1.1.1/api-ms-win-core-datetime-l1-1-0.dll
   18232  Defl:N    10279  44% 2021-03-08 13:35 12e78f59  amigaXfer_1.1.1/api-ms-win-core-debug-l1-1-0.dll
   18232  Defl:N    10325  43% 2021-03-08 13:35 fd133e51  amigaXfer_1.1.1/api-ms-win-core-errorhandling-l1-1-0.dll
   21816  Defl:N    11281  48% 2021-03-08 13:35 5525c716  amigaXfer_1.1.1/api-ms-win-core-file-l1-1-0.dll
   18232  Defl:N    10292  44% 2021-03-08 13:35 7888788d  amigaXfer_1.1.1/api-ms-win-core-file-l1-2-0.dll
   18232  Defl:N    10413  43% 2021-03-08 13:35 f4699d05  amigaXfer_1.1.1/api-ms-win-core-file-l2-1-0.dll
   18232  Defl:N    10293  44% 2021-03-08 13:35 11700b42  amigaXfer_1.1.1/api-ms-win-core-handle-l1-1-0.dll
   18232  Defl:N    10458  43% 2021-03-08 13:35 71e21909  amigaXfer_1.1.1/api-ms-win-core-heap-l1-1-0.dll
   17856  Defl:N     9977  44% 2021-03-08 13:35 2315f4fa  amigaXfer_1.1.1/api-ms-win-core-interlocked-l1-1-0.dll
   18744  Defl:N    10532  44% 2021-03-08 13:35 b08a064c  amigaXfer_1.1.1/api-ms-win-core-libraryloader-l1-1-0.dll
   20792  Defl:N    11036  47% 2021-03-08 13:35 991b148c  amigaXfer_1.1.1/api-ms-win-core-localization-l1-2-0.dll
   18744  Defl:N    10472  44% 2021-03-08 13:35 bfb6a831  amigaXfer_1.1.1/api-ms-win-core-memory-l1-1-0.dll
   18232  Defl:N    10378  43% 2021-03-08 13:35 37258a28  amigaXfer_1.1.1/api-ms-win-core-namedpipe-l1-1-0.dll
   19248  Defl:N    10526  45% 2021-03-08 13:35 f1c25621  amigaXfer_1.1.1/api-ms-win-core-processenvironment-l1-1-0.dll
   19392  Defl:N    10502  46% 2021-03-08 13:35 0ff50b6e  amigaXfer_1.1.1/api-ms-win-core-processthreads-l1-1-0.dll
   18744  Defl:N    10496  44% 2021-03-08 13:35 793969bd  amigaXfer_1.1.1/api-ms-win-core-processthreads-l1-1-1.dll
   17712  Defl:N    10230  42% 2021-03-08 13:35 f4a6ed8b  amigaXfer_1.1.1/api-ms-win-core-profile-l1-1-0.dll
   17720  Defl:N    10238  42% 2021-03-08 13:35 d22bbc25  amigaXfer_1.1.1/api-ms-win-core-rtlsupport-l1-1-0.dll
   18232  Defl:N    10351  43% 2021-03-08 13:35 e2869b8e  amigaXfer_1.1.1/api-ms-win-core-string-l1-1-0.dll
   20280  Defl:N    10807  47% 2021-03-08 13:35 24352d97  amigaXfer_1.1.1/api-ms-win-core-synch-l1-1-0.dll
   18744  Defl:N    10538  44% 2021-03-08 13:35 9e779f84  amigaXfer_1.1.1/api-ms-win-core-synch-l1-2-0.dll
   19248  Defl:N    10571  45% 2021-03-08 13:35 bfabedf6  amigaXfer_1.1.1/api-ms-win-core-sysinfo-l1-1-0.dll
   18224  Defl:N    10352  43% 2021-03-08 13:35 2a90dcc5  amigaXfer_1.1.1/api-ms-win-core-timezone-l1-1-0.dll
   18232  Defl:N    10282  44% 2021-03-08 13:35 82651198  amigaXfer_1.1.1/api-ms-win-core-util-l1-1-0.dll
   19256  Defl:N    10586  45% 2021-03-08 13:35 f5c804b7  amigaXfer_1.1.1/api-ms-win-crt-conio-l1-1-0.dll
   22328  Defl:N    11452  49% 2021-03-08 13:35 29b4635d  amigaXfer_1.1.1/api-ms-win-crt-convert-l1-1-0.dll
   18736  Defl:N    10438  44% 2021-03-08 13:35 edeba32f  amigaXfer_1.1.1/api-ms-win-crt-environment-l1-1-0.dll
   20280  Defl:N    10954  46% 2021-03-08 13:35 68adcb9c  amigaXfer_1.1.1/api-ms-win-crt-filesystem-l1-1-0.dll
   19256  Defl:N    10572  45% 2021-03-08 13:35 a016c333  amigaXfer_1.1.1/api-ms-win-crt-heap-l1-1-0.dll
   18744  Defl:N    10563  44% 2021-03-08 13:35 3c5ae513  amigaXfer_1.1.1/api-ms-win-crt-locale-l1-1-0.dll
   28984  Defl:N    13205  54% 2021-03-08 13:35 524a7773  amigaXfer_1.1.1/api-ms-win-crt-math-l1-1-0.dll
   26424  Defl:N    12232  54% 2021-03-08 13:35 7dae2c38  amigaXfer_1.1.1/api-ms-win-crt-multibyte-l1-1-0.dll
   19256  Defl:N    10619  45% 2021-03-08 13:35 9c376d11  amigaXfer_1.1.1/api-ms-win-crt-process-l1-1-0.dll
   22840  Defl:N    11706  49% 2021-03-08 13:35 1e462b97  amigaXfer_1.1.1/api-ms-win-crt-runtime-l1-1-0.dll
   24368  Defl:N    11960  51% 2021-03-08 13:35 f47691ba  amigaXfer_1.1.1/api-ms-win-crt-stdio-l1-1-0.dll
   23488  Defl:N    11588  51% 2021-03-08 13:35 c04cb509  amigaXfer_1.1.1/api-ms-win-crt-string-l1-1-0.dll
   20792  Defl:N    11034  47% 2021-03-08 13:35 fffceb82  amigaXfer_1.1.1/api-ms-win-crt-time-l1-1-0.dll
   18744  Defl:N    10583  44% 2021-03-08 13:35 dd940147  amigaXfer_1.1.1/api-ms-win-crt-utility-l1-1-0.dll
       0  Stored        0   0% 2021-07-07 20:31 00000000  amigaXfer_1.1.1/asm/
    1024  Defl:N      228  78% 2021-07-07 18:13 d287d225  amigaXfer_1.1.1/asm/bootblock_debug.dd
     354  Defl:N      239  33% 2021-05-18 04:34 3bc7a6a4  amigaXfer_1.1.1/asm/bootblock_debug.desc
    1024  Defl:N      194  81% 2021-07-07 18:13 08e14c09  amigaXfer_1.1.1/asm/bootblock_dos.dd
     188  Defl:N      141  25% 2021-05-18 04:34 94871dd9  amigaXfer_1.1.1/asm/bootblock_dos.desc
    1024  Defl:N      464  55% 2021-07-07 18:13 6d8b6ea1  amigaXfer_1.1.1/asm/bootblock_optdebug.dd
     726  Defl:N      410  44% 2021-05-18 04:34 c8650cf0  amigaXfer_1.1.1/asm/bootblock_optdebug.desc
    1024  Defl:N      192  81% 2021-07-07 18:13 3cfcc009  amigaXfer_1.1.1/asm/bootblock_strapexit.dd
     742  Defl:N      402  46% 2021-07-07 18:12 90f63252  amigaXfer_1.1.1/asm/bootblock_strapexit.desc
    1024  Defl:N      331  68% 2021-07-07 18:13 f5c8cb1f  amigaXfer_1.1.1/asm/bootblock_warmdos.dd
     282  Defl:N      179  37% 2021-07-07 18:12 a5b17754  amigaXfer_1.1.1/asm/bootblock_warmdos.desc
    1078  Stored     1078   0% 2021-07-07 18:13 f2b0c83b  amigaXfer_1.1.1/asm/crc32.o
       8  Stored        8   0% 2021-07-07 18:13 a06f110d  amigaXfer_1.1.1/asm/debug.o
      22  Defl:N       19  14% 2021-07-07 18:13 9d9978d0  amigaXfer_1.1.1/asm/debugloop.o
     612  Defl:N      439  28% 2021-07-07 18:13 e3aef9b8  amigaXfer_1.1.1/asm/floppyxfer.o
      96  Defl:N       72  25% 2021-07-07 18:13 49def524  amigaXfer_1.1.1/asm/memrecv.o
      90  Defl:N       71  21% 2021-07-07 18:13 1b91e2d4  amigaXfer_1.1.1/asm/memsend.o
  788030  Defl:N   197378  75% 2021-07-07 20:20 4d330e2e  amigaXfer_1.1.1/base_library.zip
       0  Stored        0   0% 2021-07-07 20:43 00000000  amigaXfer_1.1.1/copy_to_amiga/
      68  Defl:N       40  41% 2021-04-02 06:52 0eece57c  amigaXfer_1.1.1/copy_to_amiga/debug
     322  Defl:N      121  62% 2021-04-02 06:52 52b7f059  amigaXfer_1.1.1/copy_to_amiga/debug.info
       0  Stored        0   0% 2021-07-07 20:42 00000000  amigaXfer_1.1.1/docs/
  109510  Defl:N   108415   1% 2021-03-25 09:41 2c34a587  amigaXfer_1.1.1/docs/a500_berr.png
    4265  Defl:N     2011  53% 2021-07-07 18:12 532f4ad9  amigaXfer_1.1.1/docs/bootstrapping.txt
    2016  Defl:N     1065  47% 2021-04-02 06:44 6bbbb6d9  amigaXfer_1.1.1/docs/romwack.txt
       0  Stored        0   0% 2021-07-07 20:31 00000000  amigaXfer_1.1.1/Include/
   21096  Defl:N     6147  71% 2021-02-19 13:55 e1c67f5c  amigaXfer_1.1.1/Include/pyconfig.h
 2234560  Defl:N   852064  62% 2021-03-08 13:35 3819ce77  amigaXfer_1.1.1/libcrypto-1_1.dll
   29208  Defl:N    16780  43% 2021-03-08 13:35 84b2ece3  amigaXfer_1.1.1/libffi-7.dll
  538304  Defl:N   193528  64% 2021-03-08 13:35 ab434a7d  amigaXfer_1.1.1/libssl-1_1.dll
    1101  Defl:N      643  42% 2021-03-25 10:42 2143d3d4  amigaXfer_1.1.1/LICENSE.txt
  443192  Defl:N   149670  66% 2021-03-08 13:35 b918223d  amigaXfer_1.1.1/MSVCP140.dll
      89  Defl:N       56  37% 2021-07-07 18:12 ea89e3d5  amigaXfer_1.1.1/nativeobjs.list
  168624  Defl:N    71990  57% 2021-03-08 13:35 13cae34c  amigaXfer_1.1.1/pyexpat.pyd
 4052656  Defl:N  1639595  60% 2021-03-08 13:35 2abdc446  amigaXfer_1.1.1/python38.dll
    5463  Defl:N     2588  53% 2021-07-07 23:59 cd950e12  amigaXfer_1.1.1/README.txt
   24752  Defl:N    12937  48% 2021-03-08 13:35 04c7c4f8  amigaXfer_1.1.1/select.pyd
 1142072  Defl:N   506730  56% 2021-03-08 13:35 4ed86fd4  amigaXfer_1.1.1/ucrtbase.dll
 1091248  Defl:N   359655  67% 2021-03-08 13:35 70898d78  amigaXfer_1.1.1/unicodedata.pyd
   76168  Defl:N    41227  46% 2021-03-08 13:35 2752eb88  amigaXfer_1.1.1/VCRUNTIME140.dll
       0  Stored        0   0% 2021-07-07 20:31 00000000  amigaXfer_1.1.1/wx/
  169472  Defl:N    64689  62% 2021-03-08 13:35 0fc6c1f4  amigaXfer_1.1.1/wxbase315u_net_vc140.dll
 2242048  Defl:N   780834  65% 2021-03-08 13:35 82050fcc  amigaXfer_1.1.1/wxbase315u_vc140.dll
 7071232  Defl:N  2302982  67% 2021-03-08 13:35 0506f17b  amigaXfer_1.1.1/wxmsw315u_core_vc140.dll
  638464  Defl:N   202584  68% 2021-03-08 13:35 d746e09f  amigaXfer_1.1.1/wxmsw315u_html_vc140.dll
  100352  Defl:N    42674  58% 2021-03-08 13:35 3d33e882  amigaXfer_1.1.1/wx/siplib.cp38-win32.pyd
  978944  Defl:N   222079  77% 2021-03-08 13:35 1c5b76d8  amigaXfer_1.1.1/wx/_adv.cp38-win32.pyd
 6105600  Defl:N  1422459  77% 2021-03-08 13:35 be5d7d40  amigaXfer_1.1.1/wx/_core.cp38-win32.pyd
  524800  Defl:N   134528  74% 2021-03-08 13:35 c15b9486  amigaXfer_1.1.1/wx/_html.cp38-win32.pyd
   86528  Defl:N    26729  69% 2021-03-08 13:35 e4bbc705  amigaXfer_1.1.1/wx/_msw.cp38-win32.pyd
   57520  Defl:N    25127  56% 2021-03-08 13:35 e9699558  amigaXfer_1.1.1/_asyncio.pyd
   79536  Defl:N    39213  51% 2021-03-08 13:35 e7c1e9e1  amigaXfer_1.1.1/_bz2.pyd
  117424  Defl:N    51622  56% 2021-03-08 13:35 7a522d5b  amigaXfer_1.1.1/_ctypes.pyd
  228528  Defl:N    94165  59% 2021-03-08 13:35 e46a54be  amigaXfer_1.1.1/_decimal.pyd
   39088  Defl:N    18443  53% 2021-03-08 13:35 bb3b17ea  amigaXfer_1.1.1/_hashlib.pyd
  159408  Defl:N    82311  48% 2021-03-08 13:35 cc5939ee  amigaXfer_1.1.1/_lzma.pyd
   26800  Defl:N    13769  49% 2021-03-08 13:35 ffb39d64  amigaXfer_1.1.1/_multiprocessing.pyd
   40112  Defl:N    18810  53% 2021-03-08 13:35 962120d9  amigaXfer_1.1.1/_overlapped.pyd
   26288  Defl:N    13512  49% 2021-03-08 13:35 db85b4fc  amigaXfer_1.1.1/_queue.pyd
   69808  Defl:N    31287  55% 2021-03-08 13:35 0d2230e0  amigaXfer_1.1.1/_socket.pyd
  143024  Defl:N    58126  59% 2021-03-08 13:35 1b50ee23  amigaXfer_1.1.1/_ssl.pyd
--------          -------  ---                            -------
32564098         12276450  62%                            103 files