| # SDLTRS ## Text GUI Introduction | Features | Options | Text GUI | Known Bugs | Release History | Credits

- Main Menu
- Floppy Disk Management
- Hard Disk Management
- Cassette Management
- Stringy Wafer Management
- Emulator Settings
- Display Settings
- Miscellaneous Settings
- Configuration/State Files
- Joystick Settings
- Default Directories
- ROM File_Selection

## Main Menu

The main menu is the entry point for the Text GUI. You may move up and down through the menu items using the arrow keys. The Home and End keys moves to the first or last menu item. Typing the first letter of a menu item marks it for selection. Pressing a number key from 0 to 9 jumps to the line in the menu. A menu item may be selected by pressing the Enter, Insert, Space or Tab key when the item is highlighted. Pressing F7, BackSpace or ESC moves up a menu level (or exits the GUI if you are at the top level). Besides entering the GUI using F7, Alt-M or Alt-Comma, submenus may be entered by using the key shortcuts shown after the menu items.

## Floppy Disk Management

The floppy disk management menu allows you to insert and remove floppy images into the emulated drives, as well as save and load disk sets, create new disk images, and set emulated disk drive options.

For the first 8 options in the menu, there are three options:

- Hitting Enter, Insert or Tab while the item is selected, will move to the disk image selection screen.
- Hitting Delete will remove a disk image in the drive.
- Hitting Space will toggle the write protect for the drive. The indicator for write protect is an asterisk "*" in front of the "Disk" in the menu item.

### Save Disk Set:

This option allows the user to save the names of the disk images that are currently in the drives to a file, to be loaded later. The file that the set is save in has an extension of `.set`, and it is a human readable text file, containing the paths of the image files, or a blank line for a drive for a drive that has no disk.

### Load Disk Set:

This button allows the user to load a disk set saved earlier with the Save Disk Set Button. The user is allowed to browse for the set file, displaying files ending in `.set`. The emulator then loads the disk images specified in the file into the corresponding drives. If a drive in the set file is a blank line, no changes are made to the drive. This allows the user to load multiple disk sets sequentially.

When the user presses Enter on a Drive item in the Floppy Disk Management screen, the file open menu is displayed. The arrow keys and page up/down may be used to scroll through the list of files. Home and End moves to beginning or end of the list. Pressing Enter on the <..> item will take you to the parent directory. On Windows, the Drive letters are listed as the last items in the menu, and you can change drives by pressing Enter on those items. You may also go to a particular section of the file list by pressing the first letter of the file name.

In the Floppy Creation screen, you may choose a format of a disk. It may be created in either the JV1, JV3, or DMK disk image format (See the Features page for info on the disk formats).

If the "Insert Created Disk Into This Drive" is set to something besides none, the created image will be mounted on the specified floppy drive.

The first eight items allows you to set the size of each disk drive, as either a 5" or 8" drive.

### Floppy Disk Controller:

Enables or disables the Floppy Disk Controller (Expansion Interface) of the TRS-80. Without activated FDC, ROM BASIC is booted and access to floppy disks is not possible.

### Doubler Type:

Specify what type of double density adaptor to emulate (Model I mode only). The type may be Percom, Tandy, Both, or None. The default is Both, which causes the double density adaptor emulation to respond to the special commands of both the Percom and Tandy cards.

### True DAM Emulation:

Turn off the single density data address mark remapping kludges described in the "Emulated floppy disks" and "Real floppy disks" sections above. With this option given, the distinction between F8 and FA data address marks is strictly observed on both writing and reading. This option is probably not useful unless you need to deal with Model I disks that use the distinction as part of a copy-protection scheme.

Note: only on Linux there is the last menu that allows to set the drive steps for real floppys:

## Hard Disk Management

The hard disk management menu allows you to insert and remove floppy images into the emulated drives, as well as save and load disk sets and create new disk images.

For the first 4 options in the menu, there are three options:

- Hitting Enter, Insert or Tab while the item is selected, will move to the image selection screen, which is explained above in the floppy disk section.
- Hitting Delete will remove a disk image in the drive.
- Hitting Space will toggle the write protect for the drive. The indicator for write protect is an asterisk "*" in front of the "Hard" in the menu item.

### Save Disk Set:

This option allows the user to save the names of the disk images that are currently in the drives to a file, to be loaded later. The file that the set is save in has an extension of `.set`, and it is a human readable text file, containing the paths of the image files, or a blank line for a drive for a drive that has no disk.

### Load Disk Set:

This button allows the user to load a disk set saved earlier with the Save Disk Set Button. The user is allowed to browse for the set file, displaying files ending in `.set`. The emulator then loads the disk images specified in the file into the corresponding drives. If a drive in the set file is a blank line, no changes are made to the drive. This allows the user to load multiple disk sets sequentially.

The next three options allows you to specify parameters for creating a hard disk image (See the Features page for info on the hard disk formats).

If the "Insert Created Disk Into This Drive" is set to something besides none, the created image will be mounted on the specified hard drive.

The final option allows you to create a blank hard disk image.

## Cassette Management

The cassette management menu allows you to insert and remove cassette images into the emulated drive, as well as create new cassette images.

For the first option in the menu, there are three options:

- Hitting Enter, Insert or Tab while the item is selected, will move to the image selection screen, which is explained above in the floppy disk section.
- Hitting Delete will remove a cassette image in the drive.
- Hitting Space will toggle the write protect for the cassette. The indicator for write protect is an asterisk "*" in front of the "Cass" in the menu item.

The second option allows you to set the position of the cassette tape by changing the Position field. Valid values are 0 (fully rewound) through the number of bytes on the tape (at end of tape).

The third option allows you to define the default sample rate in Hz.

The fourth option allows you to choose a format of a cassette (`.cas` or `.wav`).

If the "Insert Created Cassette Into Drive" is set to Yes, the created image will be used in the cassette drive.

The final option allows you to create a blank cassette image.

## Stringy Wafer Management

The stringy wafer management menu allows you to insert and remove wafer images into the emulated drives, as well as save and load disk sets, and create new wafer images with default parameters.

For the first 8 options in the menu, there are three options:

- Hitting Enter, Insert or Tab while the item is selected, will move to the image selection screen, which is explained above in the floppy disk section.
- Hitting Delete will remove a wafer image in the drive.
- Hitting Space will toggle the write protect for the wafer. The indicator for write protect is an asterisk "*" in front of the "Wafer" in the menu item.

## Emulator Settings

### Model:

Specifies what TRS-80 model to emulate. Selecting a different model will perform a "Cold Boot" in the Emulator after exiting the Emulator Settings.

### CPU Clock Speed:

The default CPU speed of the selected TRS-80 model can be changed here, but use this with CAUTION: overclocking the Z80 will result in all forms of "timing-errors"!

### Speedup Kit Emulation:

Selects the speed-up modification for the TRS-80 Model I: None, Archbold, Holmes or Seatronics. Select Banking for memory banking (by Martin Doppelbauer) on I/O-port `0xFE`. LNW80 sets the CPU clock to 4 MHz and enables banking for the 480*192 HRG in the lower 16 KB. Use TCS SpeedMaster for this enhanced Model I clone running at 5.35 MHz, with 480*192 HRG and memory banking support. Set CT-80 Aster for emulation of the dutch TRS-80 model I clone.

### Exatron Stringy Floppy:

Emulates up to 8 Stringy Floppy Drives for the TRS-80 Model I.

### Lowercase:

Emulate a "Lowercase Modification Kit" for the TRS-80 Model I.

### Lubomir:

Emulates the "Lubomir Soft Banker" from Schmidtke electronic (Germany) for the TRS-80 Model I.

### Graphics Emulations:

In Model III or 4/4P mode select which Hi-Res graphics card to emulate, the Micro-Labs Grafyx Solution Hi-Res graphics card or Radio Shack Hi-Res card. In Model I mode, the HRG1B 384x192 Hi-Res graphics card is emulated. Note that the Model III and Model 4/4P cards from Micro-Labs are very different from one another.

The Lowe Electronics LE18 Graphics Adapter can also be emulated.

### Memory Expansions:

Various memory expansions can be emulated for a total of 4 MB RAM.

## Display Settings

### Emulator Colors:

Specifies the foreground and background color of the SDLTRS window. Default is white (`0xE0E0FF`) for foreground and black (`0x000000`) for background.

### GUI Colors:

Specifies the foreground and background color of the fullscreen Text GUI. Default is white (`0xE0E0FF`) for foreground and dark green (`0x344843`) for background.

### Character Sets:

Select among several sets of built-in character bitmaps. The three different options allow you to specify the character set used for each model, should you change models during SDLTRS execution using the GUI. In Model I mode, seven sets are available. The default, Wider, is a modified Model III set with characters 8 pixels wide; it looks better on a modern computer screen with square pixels than the real Model I fonts, which were 6 pixels wide. LCmod is the character set in the replacement character generator that was supplied with the Radio Shack lower case modification. Stock is the character set in the stock character generator supplied with most upper case only machines. Since SDLTRS currently always emulates the extra bit of display memory needed to support lower case, this character set gives you the authentic, unpleasant effect that real Model I users saw when they tried to do homebrew lower case modifications without replacing the character generator: lower case letters appear at an inconsistent height, and if you are using the Level II BASIC ROM display driver, upper case letters are replaced by meaningless symbols. early is the same as stock, but with the standard ASCII characters [, \, ], and ^ in the positions where most Model I's had directional arrows. This was the default programming in the Motorola character generator ROM that Radio Shack used, and a few early machines were actually shipped with this ROM. Genie gives an emulation of the Genie I/II (relabled Video Genie in Germany) with German characters ("Umlauts"). HT-1080Z emulates the HT-1080Z (relabled Video Genie in Hungary) with accented Hungarian characters. Meritum I is the uppercase charset of a TRS-80 Model I clone in Poland, build by Mera-Elzab. Video Genie displays the character set of the EACA Video Genie (also labeled as the System 80 in Australia/New Zealand and PMC-80/81 in North America). CT-80 Aster is the character set of the dutch, improved TRS-80 Model I clone.

In Model III, 4 and 4P modes, three sets are available:

Katakana (the default for Model III) is the original Model III set with Japanese Katakana characters in the alternate character positions. This set was also used in early Model 4's. International (the default for Model 4 and 4P) is a later Model 4 set with accented Roman letters in the alternate positions. Bold is a bold set from a character generator ROM found in one Model III, origin uncertain.

### Window Border Width:

Put a border of width pixels around the TRS-80 display. default is 2.

### Resize Window on Model 3 Mode Change:

In Model 3 mode, resize the window whenever the emulated display mode changes between 64x16 text (or 512x192 graphics) and 80x24 text (or 640x240 graphics).

### Resize Window on Model 4 Mode Change:

In Model 4/4P mode, resize the window whenever the emulated display mode changes between 64x16 text (or 512x192 graphics) and 80x24 text (or 640x240 graphics).

### Scale Factor for Window:

This options allows scaling of the SDLTRS window by the selected factor: "none", "2 x", "3 x" or "4 x".

### LED Display for Disks and Turbo Mode:

This option allows the user to chose if disk activity indicators and Turbo Mode LED are shown in the TRS-80 Emulator window (lower edge).

### Display Scanlines:

This option draws Scanlines on every second line of the emulator screen to simulate the pixel resolution of an old CRT monitor. The brightness of the scanlines can be adjusted from 0 (= dark) to 255 (= light).

## Miscellaneous Settings

### Close and Reopen Printer Output File:

Selecting this option will cause the printer output file to be closed, and the next file will be automatically created.

### Emulator Traps Safe:

Turn on/off ability for emts (Emulation traps) to write to unexpected places in the host filesystem.

### Fake year for TRS-80 time-of-day-clock:

Set the year for TRS-80 time-of-day clock instead of the current year. This can useful for TRS-80 operating systems that behave better when the year is within a limited range. Enter year including the century or `0` (default setting) to use the current year.

### Keystretch Value:

Fine-tune the keyboard behavior. To prevent keystrokes from being lost, SDLTRS "stretches" the intervals between key transitions, so that the Z80 program has time to see each transition before the next one occurs. Whenever the Z80 program reads the keyboard matrix and sees an emulated key go up or down, SDLTRS waits cycles Z80 clock cycles (T-states) before it allows the program to see another key transition. Key transitions that are received during the waiting period or when the Z80 program is not reading the keyboard are held in a queue. The default stretch value is 4000 cycles; it should seldom if ever be necessary to change it.

### Printer Type:

Controls the type of printer emulation that is used for outputting to the TRS-80 printer: None and Text. Text simply sends the printer output to a text file (automatically created from `trsprn0000.txt` to `trsprn9999.txt`).

### Serial Port Name:

Set the tty device to be used for I/O to the TRS-80's serial port. Setting the name to be empty emulates having no serial port.

### Serial Port Switches:

Set the sense switches on the Model I serial port card. This option is meaningful only in Model I mode, and only when the Serial Port Name is not set to "". The default value is `0x6f`, which Radio Shack software conventionally interprets as 9600 bps, 8 bits/word, no parity, 1 stop bit.

### Shift Bracket Emulation:

Chose Shift Bracket Emulation on or off. If on, emulate [, \, ], ^, and _ as shifted keys, and {, |, }, and ~ as unshifted. This is the default in Model 4 and 4P modes, and it works well with the keyboard driver in Model 4 TRSDOS/LS-DOS 6. If off, emulate [, \, ], ^, and _ as unshifted keys, and {, |, }, and ~ as shifted. This is the default in Model I and III modes, and it works well with many TRS-80 keyboard drivers. With some keyboard drivers these keys do not work at all, however.

### Sound Output:

Turn Sound Output on or off. The Alt-U key binding may be used to switch Sound Output on or off while running the emulator.

### Turbo Mode:

This will turn Turbo mode on or off. When turbo mode is on, the emulator will run faster than a normal TRS-80, by a factor of Turbo Rate, which is explained below, and also set on this page. The F12 key or Alt-N may be used to switch Turbo mode on or off while running the emulator.

### Turbo Speed:

Set the number of times normal TRS-80 speed that the emulator runs when in "Turbo" mode. Turbo mode can be used to speed compute intensive applications, compiling source code for example, on the emulator. The default setting is 5x. Above around 8x you may experience problems with runaway keyboard repeat on the emulator, so use higher values with caution.

### Turbo Paste:

While pasting from the clipboard to the TRS-80 emulator, Turbo mode is temporarily activated.

## Configuration/State Files

### Save State (Alt-S):

This menu item allows you to save the state of the emulator, so that it may be loaded later with the Load State command. Disk images inserted into the computer are stored in the state file.

### Load State (Alt-L):

This menu item allows you load a state file (`.t8s`) previous saved with the Save State command.

### Write Configuration (Alt-W):

This menu item allows you to save the configuration of the emulator, so that it may be loaded later with the Load Configuration command. Configuration files (`.t8c`) are discussed further on the Features page.

### Read Configuration (Alt-R):

This menu item allows you load a Configuration file (`.t8c`) previous saved with the Save Configuration command.

## Joystick Settings

### Use Keypad for Joystick:

This item determines if the numeric keypad is used for emulation of a joystick.

### USB Joystick/Gamepad:

This item allows the user to select which USB joystick, if any, is used for emulation of the TRS-80 Joystick. It will bring up a list of the USB joysticks that SDL is aware of as shown below:

### Map Button to Key/Function:

These options allows the user to map keys or functions of SDLTRS to Joystick buttons. Use "Write Configuration File" in the Configuration/State File Management menu to save the mapping.

## Default Directories

This menu allows the user to specify the default directories used for loading/saving various types of file used by the emulator. To choose the directory, press Enter when the appropriate entry is highlighted. That will bring up the Directory select screen. The arrow keys, page up/down and Home/End may be used to scroll through the list of directories. Pressing Enter on the <..> item will take you to the parent directory. On Windows, the Drive letters are listed as the last items in the menu, and you can change drives by pressing Enter on those items. The directory is selected by pressing the Insert or Tab key.

## ROM File Selection

This menu allows you to chose the ROM files used in the emulation of the TRS-80. These files are not provided with the emulator. To select the file, press Enter when the appropriate item is highlighted, and the file selection menu will appear. It's operation is explained in the Floppy Disk section above.