This is a free USB driver for the NetUSBee cartridge for the Atari 
ST/TT/Falcon. For TOS, MagiC, FreeMiNT and EmuTOS. It is released under the 
GNU General Public License (GPL) and is the work of many authors. No 
warranty. No support. Source code: https://github.com/freemint/freemint .

This is distribution package v8 put together by Claude Labelle, 
https://www.perdrixapps.com/usb .

INSTALLATION FOR TOS, EmuTOS or MagiC
=====================================
Open the DRIVERS folder, then the TOSMAGIC folder.

You can install the drivers to a hard disk drive or a floppy disk. The 
driver installs a cookie, so if it fails to load with an error related to a 
cookie, you may need a (larger) cookie jar such as JARnnn.PRG.

Copy the files from the TOSMAGIC folder to your AUTO folder one by one, in 
this order:

    USB.PRG
    <device drivers>
    NETUSBEE.PRG (from folder 000 for 68000, 02060 for 68020 to 68060 CPU)

where <device drivers> is one or more of the following, according to what 
devices you are using:

KEYBOARD.PRG
MOUSE.PRG
STORAGE.PRG (USB thumb drives, card readers, CD/DVD drives, floppy drive)
PRINTER.PRG (printers with PCL5 or PCL5C emulation)
TABLET.PRG (Wacom Intuos S model CTL-4100 and PF1209 tablets)

The order of the device drivers is not important.

Put USBTOOL.ACC in the root of your boot drive. This accessory provides the 
capability to hotplug/remove devices, it polls for changes every second.

INSTALLATION FOR MiNT or FREEMINT
=================================
Open the DRIVERS folder, then the FREEMINT folder.

A computer with a 68020 to 68060 CPU is required.

Copy the MiNT modules and the loader (loader.prg, usb.km, netusbee.ucd, 
storage.udd, mouse.udd, keyboard.udd, printer.udd, tablet.udd), in the same 
directory and just run loader.prg, you can do it from the desktop or from 
mint.cnf.

IMPORTANT
=========
Read other device-specific notes in the DOC folder. In particular, there 
are instructions for partitioning USB keys, how to use a CD/DVD writer and 
limitations of using a floppy disc drive. If you use a CD/DVD drive or 
floppy disc drive, you need a powered hub and attach the device to it.

GOODIES
=======
Take a look in the GOODIES folder. There you will find HDDRIVER 11 module 
versions of the drivers and all sorts of utilities.

ISSUES and KNOWN CONFLICTS
==========================
Note 1. Under MagiC, if you experience error messages during data 
transfers, you can rename USBTOOL.ACC to USBTOOLX.ACC, it will only polls 
while the window is opened, so you'll have to open the window to 
hotplug/remove. Otherwise, keep the window closed.

Note 2: If you are using Sting under TOS, or Maxgnet under MagiC, through 
the NetUSBee ethernet port, it conflicts with data transfers, even if you 
rename USBTOOL.ACC. However, you can use a PicoWifi USB-to-Wifi adapter or 
Asix USB-to-Ethernet adapter with a Sting driver, see 
https://github.com/czietz/usbsting.

Note 3: On Falcon with CT60/CT63, data transfers won't work if caches are 
set to "Cache delay 5 S" in the CT60 Config CPX ("Boot" menu, "TOS" item). 
In addition, unless you have a CTPCI and CT60 TOS version 2.0x installed, 
put CACHEON.PRG before the USB drivers in the AUTO folder.

Note 4: If you are using a USB wireless receiver that is designed for both 
keyboard and mouse, but use just the wireless mouse together with a wired 
keyboard: put KEYBOARD.PRG before MOUSE.PRG.

Note 5: For TOS 1.04, POOLFIX4.PRG is needed, first in AUTO folder.

Note 6: On Falcon CT60/CT63 in 060 mode, connecting a corded mouse directly 
to a NetUSBee port conflicts with a USB thumb drive on the other port. Data 
transfers may fail or the USB system may stop. Workaround: use a powered 
hub, attach to it the mouse and drive; or use a wireless mouse.