Short:        Ethernet driver for ENC28J60 on TF534
Author:       Andrea Campanella <campanella.andrea@gmail.com>
Uploader:     Andrea Campanella <campanella andrea gmail com>
Type:         driver/net
Version:      1.0
Architecture: m68k-amigaos
URL:          https://github.com/andreacampanella/TF534_SPI_enc28j60.device

SANA-II Ethernet driver for the Amiga, targeting the ENC28J60 SPI
Ethernet module connected to the TF534 SPI port (CPLD-based SPI
controller on the TF534 68030 accelerator card).

This is a fork of Mathesar's enc28j60.device. The SPI transport
layer has been rewritten for the TF534's SPI controller.

REQUIREMENTS

  - Amiga 500 (or other 68k Amiga) with TF534 accelerator card
  - ENC28J60 SPI Ethernet module wired to the TF534 SPIPORT header
  - 74HC14N inverter on the CLK line (TF534 SPI port operates in
    Mode 2, ENC28J60 needs Mode 0)
  - AmigaOS 3.2 / 3.2.x (Kickstart 47.111+) recommended
  - A TCP/IP stack: Roadshow, MiamiDx, AmiTCP or similar

WIRING

  There are two SPI ports, the outer one has an interrupt pin
  next to it, we will use the inner one.

  TF534 SPIPORT pin    ENC28J60 pin
  1 (3V3)              VCC
  2 (GND)              GND
  3 (MOSI)             SI
  4 (MISO)             SO
  5 (SCK)              SCK  (via 74HC14N inverter)
  7 (CS1)              CS

INSTALLATION

  1. Copy enc28j60.device to DEVS:Networks/
  2. Install your favourite TCP/IP stack, it's been tested
     with Miami, AmiTCP and Road Show.

PERFORMANCE

  Measured on TF534 at 50 MHz, 10 Mbit half-duplex:
       ~267 KB/s pure RX through the driver core (nic_bench)
       ~140 KB/s sustained TCP under MiamiDx with FTP to RAM
       ~105 KB/s sustained TCP under Roadshow with FTP to RAM
       YMMV

KNOWN LIMITATIONS

  - The TF534 CPLD has the EXTINT path declared but unrouted by
    default, so the ENC28J60's /INT line cannot be wired without
    a CPLD reflash. RX is driven by timer.device polling at 1 kHz.

CONTENTS

  enc28j60.device      The driver - copy to DEVS:Networks/
  README               Long-form documentation
  LICENSE              GPL v3
  Source               Available on Github (see URL above)

CREDITS

  Mike Stirling          original ENC28J60 driver (2018)
  Dennis van Weeren      A500 Simple SPI port (2022, 2025)
  Mathesar               enc28j60.device upstream this forks from
  Andrea Campanella      TF534 SPI transport, cross-compile build

LICENSE

  GPL v3, inherited from the upstream project.