Where there is a difference between the ProDOS and SOS versions of the ADTPro client program, screen capture text will appear white-on-black for ProDOS, and green-on-black for SOS below.
The ADTPro client has built-in disk formatting capabilities. ProDOS and SOS don't include an INIT or FORMAT command natively, so this is the place to get your media initially formatted. Note that formatting a disk does not make it bootable. Choosing "F" from the main menu brings up the volume selection screen:
From this screen, choose the volume (slot/drive) or device you want to format. When you make your choice, you will be asked for the new disk's name (ProDOS only), you will be asked for a confirmation, and once finished, will be given a chance to format another volume:
Note: The act of formatting a floppy or other drive does not make it bootable. When you get done formatting a disk, you might want to write an image to it that will ultimately make it bootable to an operating system. This is different from the way DOS 3.3 and its variants worked, where the INIT command would make a disk bootable. In ProDOS and SOS, it's a whole different process.
SOS Note: If SOS feels a floppy disk drive is spinning too slowly or too quickly, it will fail to format the disk and will issue a message stating so. If the drive is found to be too slow, the message will read: "DRIVE TOO SLOW! ADJUST CLOCKWISE." If too fast, the messasge will read: "DRIVE TOO FAST! ADJUST ANTI-CLOCKWISE." This "adjustment" is referring to the small speed adjuster on the back-right side of the drive. It will take some disassembly of the Apple /// to get at that adjuster. Start by rotating it 1/8 turn in the suggested direction with a jewler's screwdriver; then retry formatting.
Buying Blank Disks: If you need new blank floppy disks, they can be purchased here.
Whatever directory the host software starts in will be the "Current working directory" until changed to something else. Disk images will be read from and written to this directory. You can change the directory with the "C" key from the client:
You can enter any absolute or relative directory change from this screen. For example, changing to a full directory specification:
Note that you can also change the working directory from the server.
Hitting the "V" key from the main menu will bring up a list of all volumes that ProDOS or SOS can see:
The leftmost two columns will show you the slot and drive assignments of a particular volume. The Volume Name column will show you what ProDOS thinks it's called. It typically takes ProDOS a fair amount of time to scan for all volumes and names, so ADTPro caches this information. If you remove and insert different disks, you may want to hit the 'R' key to re-scan for the latest names.
The "Blocks" column is the count of ProDOS blocks present on the disk. Each block contains 512 bytes of data. So, typical disk sizes are:
|127||64k RAM disk (128k Apples)|
|280||5-1/4" Floppy disk (140k)|
|1600||3-1/2" Floppy disk (800k)|
|65535||32MB Hard drive|
Some messages may appear in the "Volume name" column to indicate various situations:
|<NO NAME>||A DOS 3.3 disk is in the drive (which is ok)|
|<I/O ERROR>||Can't read the disk in the drive, or the drive is empty|
Some Apple II emulators have the ability to virtualize a serial port over IP. That means serial traffic in and out of the virtual Apple II actually flows over a socket, but the Apple still understands it and treats it as if it is serial. The ADTPro server can take advantage of this and communicate to the emulator this way. Starting the ADTPro server with the command line parameter 'localhost' triggers this behavior.
In socket communications terms, the role of "server" and "client" are reversed - the Apple II emulator is actually the entity serving the port, and the ADTPro server is the client in this case. When started with the 'localhost' parameter, the ADTPro server titlebar will reflect the port and host it will be trying to connect to. The ADTPro server will then attempt to contact an emulator that starts serving its serial port as socket port 1977 (the default for AppleWin) on the local machine.
The first time ADTPro starts in this mode, it will write out two new properties in the ADTPro.properties file:
These values may be changed in the properties file to accommodate different ports and hosts. The following are the default ports used by emulators for slot 2 serial emulation:
The usual connect/disconnect buttons do not function when the ADTPro server is started in this mode, and pressing one of them will terminate the virtual serial communications and start whatever other mode was selected.