compactflash.device V1.35 - PCMCIA CompactFlash driver for Amiga 600/1200

Fork of driver/media/CFD133.lha with serial debug and >4GB card support.

CHANGES IN 1.35 (31.12.2025)
============================
* Serial debug output via Flags = 8
  - Connect serial cable (9600 baud) to see debug messages
  - Shows card insert/remove, identification, size, MultiSize
  - Replaces cfddebug tool with readable text-based serial output
* Enforce multi mode via Flags = 16
  - Forces 256 sector reads/writes per IO request
  - Can improve performance on capable cards (1MB/s -> 2MB/s)
  - Warning: May cause data corruption on unsupported cards
* Simplified SD-to-CF adapter support
  - Cleaner retry mechanism for IDENTIFY command introduced in v1.33

FEATURES
========
* Supports CompactFlash, MicroDrive, and various adapters (SD, MemoryStick, SmartMedia)
* TD64 and SCSI emulation support
* Works with fat95 filesystem for FAT32 support
* Serial debug output for troubleshooting (Flags = 8)
* Transfer speeds up to 2.2 MB/s read, 1.9 MB/s write
  (in multi-sector mode if firmware supports it or with Flags = 16 override)

REQUIREMENTS
============
* Amiga 600 or 1200 with PCMCIA slot (A1200 tested)
* AmigaOS 2.0 or higher (3.2.3 tested)
* "CompactFlash to PCMCIA/ATA" adapter card (see images/cf-pcmcia-adapter.jpg)
  or SD-to-CF adapter (see images/sd-cf-adapter.jpg)
* fat95 filesystem (disk/misc/fat95.lha) recommended

INSTALLATION
============
Two versions of the driver are included:

  compactflash.device         10308 bytes  Driver with debug to serial console flag support
  compactflash.device.small 8272 bytes  Driver without debug to serial console support

Choose based on your needs:
- Use the full version if you need serial debug output (Flags = 8)
- Use small for minimal memory footprint (rename to compactflash.device)

Steps:
1. Copy devs/compactflash.device to DEVS:
   (or copy compactflash.device.small as DEVS:compactflash.device)
2. Have fat95 installed on your system
3. Mount the drive by double-clicking devs/CF0

For OS 3.5+:
  Copy def_CF0.info to sys:prefs/env-archive/sys and env:sys

MOUNT FLAGS
===========
Set in CF0 mountlist (can be combined, e.g. Flags = 24 for debug + enforce):

  Flags = 0    /* default */
  Flags = 1    /* "cfd first" hack for PCMCIA conflicts with other drivers */
  Flags = 2    /* skip invalid PCMCIA signature for non-standard cards */
  Flags = 4    /* use CardResource API instead of direct chipset access */
  Flags = 8    /* output init messages to serial port at 9600 baud (v1.35+ full build) */
  Flags = 16   /* force 256 sector transfers regardless of card capability (v1.35+) */

SERIAL DEBUG EXAMPLE
====================
With Flags = 8, connect serial cable and monitor at 9600 baud:

  [CFD] Card inserted
  [CFD] Identifying card...
  [CFD] Reset
  [CFD] Configuring HBA
  [CFD] ..done
  [CFD] Setting voltage
  [CFD] Voltage: 5V
  [CFD] Reading tuples
  [CFD] Tuple CISTPL_CONFIG found
  [CFD] RW test
  [CFD] ..done
  [CFD] Transfer: WORD
  [CFD] Getting IDE ID
  [CFD] ..done
  [CFD] Model: TS4GCF133...............................
  [CFD] Serial: G68120052383AC0700C7
  [CFD] FW: 20110407
  [CFD] IDENTIFY:
    Max Multi (W47):      8001
    Capabilities (W49):   0200
    Multi Setting (W59):  0100
    LBA Sectors (W60-61): 00777E70
    DMA Modes (W63):      0000
    PIO Modes (W64):      0003
    UDMA Modes (W88):     0000
  [CFD] IDENTIFY (raw):
  W0: 848A 1E59 0000 0010 0000 0240 003F 0077 
  W8: 7E70 0000 4736 3831 3230 3035 3233 3833 
  W16: 4143 3037 3030 4337 0002 0002 0004 3230 
  W24: 3131 3034 3037 5453 3447 4346 3133 3320 
  W32: 2020 2020 2020 2020 2020 2020 2020 2020 
  W40: 2020 2020 2020 2020 2020 2020 2020 8001 
  ...
  W248: 0000 0000 0000 0000 0000 0000 0000 0000 
  [CFD] Init multi mode
  [CFD] ..card supports max multi: 1
  [CFD] ..setting multi mode to: 1
  [CFD] ..OK
  [CFD] ..override multi size: 256
  [CFD] ..done
  [CFD] Card identified OK
  [CFD] Notify clients
  [CFD] Card removed

ENFORCE MULTI MODE (FLAG 16)
============================
Forces 256 sector reads/writes per IO regardless of card firmware
support to improve IO performance. Same behaviour as v1.33 and
earlier versions.

WARNING: Verify your card is capable before using for real data!
Set the flag and read any text file from CF card. The content should
not contain repeating 32-byte pattern after first 512 bytes.
See images/multimode-issue.jpg for example of broken output.

Can be combined with MaxTransfer to limit sectors per IO:
  Flags = 16
  MaxTransfer = 0x10000   /* 128 sectors per IO (64 KB) */

Tested configurations (author's experience - your results may vary):
  SD-to-CF adapter (SanDisk)  32GB        - Works
  SD-to-CF adapter (Samsung)  32GB, 64GB  - Works
  CF cards                    <=4GB       - Works
  CF cards                    >4GB        - Not working

SOURCE CODE
===========
Source code available at:
https://github.com/pulchart/cfd

Licensed under GNU LGPL v2.1

HISTORY
=======
see https://github.com/pulchart/cfd/blob/master/README.md for complete history

CHECKSUMS
=========
compactflash.device (full, 10308 bytes):
  MD5:    d0ccafa7e95b466eb58b292b3ceed9cc
  SHA256: a441bb05696f19a5008cf8e4ceb68cab6d8acd5ca994020c465beab385b8e2a5

compactflash.device.small (no debug, 8272 bytes):
  MD5:    f12b04284eb114dff480cdb97e42abfc
  SHA256: cfa43c8e95203d2991a026d6a41cb37e88b947080602998049b44db8b1169401

CONTENTS
========
cfd/c/pcmciacheck     - PCMCIA check utility
cfd/c/pcmciaspeed     - Speed test utility
cfd/devs/CF0          - Mountlist entry (with flags documentation)
cfd/devs/compactflash.device       - Driver with debug to serial console flag support
cfd/devs/compactflash.device.small - Driver without debug to serial console support
cfd/src/              - Full assembler source code
cfd/images/cf-pcmcia-adapter.jpg - CF-to-PCMCIA adapter photo
cfd/images/sd-cf-adapter.jpg     - SD-to-CF adapter photo
cfd/images/multimode-issue.jpg - Example of broken output with unsupported enforce multi mode
cfd/LICENSE           - GNU LGPL v2.1
cfd/README.md         - Full documentation

Have Fun!

"CompactFlash" is (TM) by CompactFlash Association

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Jan  1 11:49 cfd/
-rw-r--r--  1000/1000     9637   26526  36.3% -lh5- e336 Jan  1 11:49 cfd/LICENSE
-rw-r--r--  1000/1000     4875   11455  42.6% -lh5- 0900 Jan  1 11:49 cfd/README.md
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Jan  1 11:49 cfd/c/
-rw-r--r--  1000/1000     1116    1708  65.3% -lh5- 5584 Jan  1 11:49 cfd/c/pcmciacheck
-rw-r--r--  1000/1000      761     976  78.0% -lh5- 38ad Jan  1 11:49 cfd/c/pcmciaspeed
-rw-r--r--  1000/1000     1355    1694  80.0% -lh5- 2f02 Jan  1 11:49 cfd/c.info
-rw-r--r--  1000/1000     1695    1958  86.6% -lh5- da76 Jan  1 11:49 cfd/def_CF0.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Jan  1 11:49 cfd/devs/
-rw-r--r--  1000/1000      461     724  63.7% -lh5- 7450 Jan  1 11:49 cfd/devs/CF0
-rw-r--r--  1000/1000     1460    2431  60.1% -lh5- 81de Jan  1 11:49 cfd/devs/CF0.info
-rw-r--r--  1000/1000     6339   10308  61.5% -lh5- ce07 Jan  1 11:49 cfd/devs/compactflash.device
-rw-r--r--  1000/1000     5137    8272  62.1% -lh5- 3414 Jan  1 11:49 cfd/devs/compactflash.device.small
-rw-r--r--  1000/1000     1358    1694  80.2% -lh5- 7131 Jan  1 11:49 cfd/devs.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Jan  1 11:49 cfd/images/
-rw-r--r--  1000/1000    48501   48688  99.6% -lh5- 1172 Jan  1 11:49 cfd/images/cf-pcmcia-adapter.jpg
-rw-r--r--  1000/1000     2336    2925  79.9% -lh5- e3ec Jan  1 11:49 cfd/images/cf-pcmcia-adapter.jpg.info
-rw-r--r--  1000/1000    82156   82371  99.7% -lh5- 37e1 Jan  1 11:49 cfd/images/multimode-issue.jpg
-rw-r--r--  1000/1000     2336    2925  79.9% -lh5- e3ec Jan  1 11:49 cfd/images/multimode-issue.jpg.info
-rw-r--r--  1000/1000    28360   30514  92.9% -lh5- 0f36 Jan  1 11:49 cfd/images/sd-cf-adapter.jpg
-rw-r--r--  1000/1000     2336    2925  79.9% -lh5- e3ec Jan  1 11:49 cfd/images/sd-cf-adapter.jpg.info
-rw-r--r--  1000/1000     1444    1994  72.4% -lh5- e8f5 Jan  1 11:49 cfd/images.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Jan  1 11:49 cfd/src/
-rw-r--r--  1000/1000    25545   88761  28.8% -lh5- 18f1 Jan  1 11:49 cfd/src/cfd.s
-rw-r--r--  1000/1000     6251   18850  33.2% -lh5- 54f1 Jan  1 11:49 cfd/src/pcmciacheck.s
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        25 files  233459  347699  67.1%            Jan  3 01:14