TheWire13 is a TCP/IP stack for Amiga systems running AmigaOS 1.3.
==================================================================
Contribute me with a cup of coffee: paypal.me/mytubefree
:-)

The project was written specifically for low-level AmigaOS networking
experiments and real hardware usage on systems without modern TCP/IP
stacks available.

TheWire13 currently provides:

* SANA-II networking
* ARP
* IPv4
* UDP
* TCP client connections
* DNS resolver
* ICMP Echo (Ping)
* DHCP client support
* bsdsocket.library compatibility layer

The stack is intended to provide a lightweight and OS1.3-compatible
networking environment for custom tools and applications.

## Current Status

THIS IS AN ALPHA VERSION.

TheWire13 is still under active development and internal structures,
network behavior, and APIs may change between releases.

At the moment the stack has only been tested with:

* a314eth.device (Thx to Niklas)
* enc62413.device (Zorro-LAN-IDE-CP Card)

Other SANA-II drivers may or may not work yet wich primary depends on 
OS 1.3 compatibility.

The stack is considered experimental software and should not yet be
expected to provide the same stability or compatibility as mature Amiga
TCP/IP stacks such as AmiTCP, Miami, Genesis, or Roadshow.

## Requirements

* AmigaOS 1.3
* SANA-II compatible network driver
* at least 68000 CPU (>=68020 recommended)
* enough free RAM for networking buffers

## Installation
copy TheWire13 to C:
copy bsdsocket.library to LIBS:
copy amitcp13.conf to S:
copy all mini_* programs to C: (e.g. mini_ping)

For Zorro-LAN-IDE-CP Card:
copy enc62413.device DEVS:networks


## Configuration

The stack currently uses the configuration file:
S:amitcp13.conf

Example options:

device = a314eth.device
unit = 0
dhcp = 1

or static configuration:

device = a314eth.device
unit = 0
dhcp = 0
ip = 192.168.7.16
netmask = 255.255.255.0
gateway = 192.168.7.1
dns = 192.168.7.1

## Starting

Start the stack from Shell:

TheWire13

Expected startup banner:

TheWire13 v1.2 Alpha by Marcel Jähne (c)2026
Stack running...

## Notes

* The stack binary itself is intentionally kept lightweight and avoids
  large stdio/newlib runtime dependencies.
* DHCP support is integrated.
* bsdsocket.library support is still incomplete and evolving.

## Known Limitations

* Alpha quality software
* Only limited SANA-II driver testing so far
* Primarily focused on TCP client usage
* Long-running/high-throughput transfers are still under investigation

## History

1.2
- TCP throughput tuning.
- TCP bulk download stabilization restored.
- Silent TheWire13 trace ring added.
- TCP window updates tuned.
- SANA RX serviced during IPC bursts.
- SANA RX burst servicing throttled.
- TCP RX buffers moved to dynamic AllocMem().
- TCP RX buffers released on socket close.
- TCP write readiness fixed for uploads.
- TCP partial-send handling added.
- Deferred TCP FIN fixed after upload drain.

    MiniFTP 0.9

  - Local directory navigation added.
  - Public name changed to MiniFTP v0.7.
  - Port field added, MiniFTP v0.8.
  - Transfer redraws reduced.
  - Downloads now validate against FTP SIZE, so short/incomplete transfers no longer show false ?Download complete?.

    enc62413.device 0.5 / SANA RX

  - RX liveness debug builds added.
  - Poll process startup hardened.
  - RX drain improved during private polls.
  - RX ring recovery hardened.
  - RX flow control tested/enabled.
  - SANA RX polling added during WaitSelect().
  - TX register ordering fixed.
  - RX length derived from ring distance.
  - SANA RX read depth increased and later restored to 32.
  - SANA reads refilled before driver polling.
  - Double-buffered TX added.
  - RX frames held until SANA reads are ready.
  - RX status validation, byte order, and EtherType handling adjusted.
  - RX polling interval and budget tuned repeatedly.
  - Silent enc62413 stall counters added.
  - Dynamic RX buffering for enc62413 bursts added.
  - Staged RX reads drained directly.

1.1
- Added AMITCP13_SOCKET_CLEANUP_DEBUG=1, which enables socket cleanup/pool diagnostics. 
- Added fd/socket/TCP/UDP/RAW pool summaries behind debug builds. 
- Hardened TCP cleanup for stuck CLOSED, FIN_WAIT_1, FIN_WAIT_2, CLOSING, and LAST_ACK PCBs. 
- Cleaned failed initial SYN send path without prematurely reusing the socket wrapper.

1.0
- Added central limits in include/amitcp13/socket_limits.h. 
- Increased core/IPC socket slots from 8 to 16. 
- Increased TCP PCB pool from 8 to 12.

0.9.1
* Improved RX speed on enc62413.device by factor 10
* Bumped Mini_FTP_Gui to v0.4
  - mini_ftp_gui now tracks the PASV data socket with a single g_data_fd.
  - Before every new PASV data connection, any previous data socket is closed.
  - LIST/GET/PUT close data sockets on success and error paths, then wait for final 226/250 replies where appropriate.
  - Ambiguous transfer failures now close the control session and show reconnect-required status.

0.9 Alpha
* Improved stability
* Introduce the new enc62413.device
* Reduced debug output

0.8 Alpha

* Public runtime renamed to TheWire13
* DHCP support added
* ICMP support added
* TCP throughput improvements
* Reduced memory footprint / stdio-free runtime
* Improved network recovery stability
* Expanded bsdsocket.library compatibility

##License

TheWire13 is freeware and 100% Java free!

This software may be freely used, copied, and redistributed in unmodified
form.

The software is provided "as is" without warranty of any kind. Use at your
own risk.

Copyright (c)2026 Marcel Jähne

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                23394   43496  53.8% -lh5- 5a31 May 21 12:04 c/mini_irc
[generic]                 2872    5068  56.7% -lh5- aee0 May 21 12:03 c/mini_nslookup
[generic]                 6166   10952  56.3% -lh5- 53e6 May 21 12:03 c/mini_ntp
[generic]                 4220    7256  58.2% -lh5- 4cc9 May 21 12:03 c/mini_ping
[generic]                 4951    8676  57.1% -lh5- 5349 May 21 12:03 c/mini_wget
[generic]                12634   22188  56.9% -lh5- 7742 May 24 11:20 c/sic
[generic]                60057  120448  49.9% -lh5- aba1 May 31 20:13 c/TheWire13
[generic]                 3360    6156  54.6% -lh5- ca24 May 24 18:52 devs/networks/a314eth.device
[generic]                 5867    9908  59.2% -lh5- fd2f May 31 19:44 devs/networks/enc62413.device
[generic]                 2966    7076  41.9% -lh5- e30a May 21 13:18 docs/mini_ftp_gui.readme
[generic]                 1881    4285  43.9% -lh5- fe1d May 21 13:19 docs/mini_ntp.readme
[generic]                 9334   20068  46.5% -lh5- 7035 May 21 12:03 libs/bsdsocket.library
[generic]                  106     151  70.2% -lh5- e0fa May 24 13:09 s/amitcp13.conf
[generic]                   78     100  78.0% -lh5- aaaa May 21 15:49 s/mini_irc.conf
[generic]                   47      47 100.0% -lh0- c973 May 24 13:08 s/mini_ntp.conf
[generic]                 2739    5881  46.6% -lh5- 8ce8 May 31 19:56 TheWire13.readme
[generic]                13935   24944  55.9% -lh5- 4fd8 May 31 19:52 tools/MiniFTP
[generic]                  176     450  39.1% -lh5- b5bf May 25 16:20 tools/MiniFTP.info
[generic]                15677   29512  53.1% -lh5- 12bc May 29 08:35 tools/MiniTelnet
[generic]                  101     106  95.3% -lh5- 875d May 28 11:55 tools/minitelnet.conf
[generic]                  176     450  39.1% -lh5- b5bf May 29 08:35 tools/MiniTelnet.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        21 files  170737  327218  52.2%            Jun  1 22:49