-
Notifications
You must be signed in to change notification settings - Fork 2
User guide
| Contents |
|---|
| Prerequisites |
| Setup |
| Additional setup (optional) |
| Usage |
Software
- SerialDisk PC binaries
- SERDISK3.TOS Atari ST binary (included with SerialDisk download)
Hardware
- An Atari computer running TOS with an available serial port
- A PC running a supported operating system
- A PC RS232 serial port. If using a USB-serial adapter I strongly suggest avoiding anything with a CH340 chipset
- A null-modem RS232 cable
- A PC floppy disk drive and disk for the file transfer. This disk must be Double Sided Double Density (720KiB when formatted in DOS) and not Double Sided High Density (1.44MiB when formatted in DOS).
Connect the PC to the Atari using the null modem cable.
Prepare a double density (720KiB) disk on a PC, then copy SERDISK3.TOS, SERDISK.RES and SERDISK.CFG to it.
In GEM desktop, click on any drive icon to highlight it, then in the Options top menu select "Install Disk Drive". Choose "M" as the drive identifier. Optionally name it "SERIAL DISK" and click "Install". If you save your desktop using the Options menu, you won't have to do this again next time you start your Atari.
Run SERDISK3.TOS from the floppy disk. It will return to the desktop when it has loaded.
By default, the Atari ST will be configured to use:
- Baud rate: 9600bps
- Data bits: 8
- Stop bits: 1
- Parity: None
- Handshake: None
This will be slow, but is enough to check that everything has been set up correctly. To get more throughput and stability, follow the additional setup steps below.
Extract the SerialDisk files from the compressed download to a folder
Copy the SerialDisk app from the dmg to a folder on your disk drive
XCONTROL provides a simple way to configure the serial port on the Atari ST. The baud rate can be set as high as 19200bps (2KBps) on an ST or STe.
Copy XCONTROL.ACC (for USA) or XCONT_UK.ACC (for UK) and MODEM.CPX to the root directory of a floppy or hard disk and restart the Atari ST.
In the GEM Desk menu there will now be a Control Panel option. This control panel has a Modem Setup option where you can configure the serial port.
Installing this driver fixes some bugs in the inbuilt serial drivers on the Atari, and makes the connection more reliable.
Put DRVIN.PRG into the AUTO folder on your disk, followed by MFP.PRG (use SCC.PRG with MegaSTe, TT, or Falcon), then SETTER.TTP. The order in which the files are copied is important!
DRVIN.PRG has two user options. FASTINT should be "on", EXOPEN "off".
Drag and drop MFP.PRG (or SCC.PRG) onto SETTER.TTP to configure the driver. If that doesn't work, run SETTER.TTP and enter MFP.PRG or SCC.PRG when prompted.
My recommended settings for a standard ST (MFP.PRG):
| Option | Description | Value |
|---|---|---|
| RSVE | Only for users of RSVE hardware. | N |
| HISP | Enables high speed RSVE baud rates. Skipped if RSVE is N. | N |
| REPL | Sets RSVE baud rates. U = ungültig (not applicable). | U (six times) |
| DTR | Enable Data Terminal Ready signal | Y |
| RBL | Receive buffer length. | 1024 |
| TBL | Transmit buffer length. | 8192 |
Atari World recommended setting for MegaSTe and Falcon (SCC.PRG):
| Option | Value |
|---|---|
| M2TT | U |
| M1EMU | U |
| LANBIT | N |
| LANEXT | N |
| LAN_S2 | U |
| DTRM2 | Y |
| DTRS2 | Y |
| RBLM2 | 16384 |
| TBLM2 | 8192 |
| RBLS2 | 16 |
| TBLS2 | 16 |
Now HS-MODEM is configured. Restart your Atari and the new drivers will be loaded.
To run SerialDisk automatically when the Atari boots:
- Create a folder named AUTO on your boot drive if it does not already exist
- Copy SERDISK3.TOS, SERDISK.RES and SERDISK.CFG to the AUTO folder
- Rename SERDISK3.TOS in the AUTO folder to SERDISK3.PRG
Run the SerialDiskUI executable file
Run the SerialDisk app
SerialDiskCLI must be run from a command prompt / terminal.
Run SerialDiskCLI.exe --help to view available parameters and serial ports.
Example usage:
SerialDiskCLI.exe --port COM1 c:\atari
Run ./SerialDiskCLI --help to view available parameters and serial ports.
If needed, grant read/write access to your serial port with sudo chmod a+rw /dev/ttyUSB0 (your device name may differ)
Ensure the current user has read/write permissions for the chosen virtual disk folder.
Example usage:
./SerialDiskCLI --port /dev/ttyUSB0 /user/home/atari
For more information see Configuration
The baud rate, data bits, stop bits, parity and handshake must match the settings on the Atari ST.
While SerialDisk is running, open the M drive on the Atari ST and you should be presented with the contents of your chosen PC directory.