SDLTRS Help Options

| SDLTRS Help Options Introduction Features Options Text GUI OS X Features Known Bugs Release History Credits

Options
All of the below options can be specified as command line options (on Windows or Linux (actually, on Mac OS X also, but you have to dive into the SDLTRS.app package, and find the actual executable to pass them to. If you don't know what that means, don't try command line options on the Mac!)).
The same options are used in configuration files by removing the leading '-', and adding a following '=' if a parameter is included. (i..e -model 1 becomes model=1).
On the Macintosh, all of the same setting can also be found in the Preferences dialog.
Also on the command line, any command line arguments ending in .t8c will be assumed to be a configuration file, and those options will be loaded before startup of the emulator. Any command line arguments ending in .t8s will be assumed to be a state file, and that emulator state will be restored upon startup of the emulator.

-background color | Specifies the background color of the sdltrs window. Format is 0xRRGGBB, where RR, GG, and BB are the hex values of the Red, Greeen, and Blue components. Default is black. (0x000000)
-foreground color | Specifies the foreground color of the sdltrs window. Default is white. (0xffffff)
-guibackground color | Specifies the background color of the sdltrs text based GUI window. Default is green.(0x008010)
-guiforeground color | Specifies the foreground color of the sdltrs text based GUI window. Default is white.(0xffffff)
-borderwidth width | Put a border of width pixels around the TRS-80 display. The default is 2.
-scale factor | Scale the emulator window by factor times. Valid values for factor are 1,2,3, and 4. Default is 1.
-scale1 -scale2 -scale3 -scale4 | Scale the emulator window by 1,2,3, or 4 times. Default is scale1.
-resize3 -resize4 | In Model 3 (resize3) or 4/4P (resize4) mode, resize the window whenever the emulated display mode changes between 64x16 text (or 512x192 graphics) and 80x24 text (or 640x240 graphics). Default is -resize3 (-noresize4 is the default).
-noresize3 -noresize4 | In Model 3 (noresize3) or 4/4P (noresize4), always keep the X window large enough for 80x24 text or 640x240 graphics, putting a blank margin around the outside when the emulated display mode is 64x16 text or 512x192 graphics. -noresize4 is the default (-resize3 is the default).
-fullscreen | Run in fullscreen mode.
-nofullscreen | Run in windowed mode.
-showled | Show disk activity LED's at bottom of emualtor screen.
-hideled | Hide disk activity LED's at bottom of emualtor screen.
-charset1 name -charset3 name -charset4 name | 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 (-charset1), five 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. (It was reconstructed partly from memory and may have some minor bit errors.) 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. Finally, german or genie gives an approximate emulation of the GENIE, a German Model I clone. Characters are 8 pixels wide, and double width is supported even though later GENIE models did not include it. In Model III (-charset3), 4 and 4P (-charset4) 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.
-disk0 filename -disk1 filename -disk2 filename -disk3 filename -disk4 filename -disk5 filename -disk6 filename -disk7 filename | Speifies the name of the floppy disk image file to be inserted into DiskN, where N=0 through 7.
-hard0 filename -hard1 filename -hard2 filename -hard3 filename | Speifies the name of the hard disk image file to be inserted into HardN, where N=0 through 3.
-cassette | Specifies the name of the cassette image file to be inserted into the emulated cassette drive.
-microlabs | In Model III or 4/4P mode, emulate the Micro Labs Grafyx Solution hi-res graphics card. Note that the Model III and Model 4/4P cards from Micro Labs are very different from one another.
-nomicrolabs | In Model I mode, emulate the HRG1B 384x192 hi-res graphics card. In Model III mode or Model 4/4P mode, emulate the Radio Shack hi-res card. This is now the default.
-debug | Enter zbx, the z80 debugger.
-romfile filename -romfile3 filename3 -romfile4p filename4p | Use the romfile specified by filename in Model I mode, the romfile specified by filename3 in Model III and Model 4 mode, or the romfile specified by filename4p in Model 4P mode, A romfile can be either a raw binary dump, Intel hex format, or TRS-80 cmd format (for example, a MODELA/III file). If you do not set this option, a default established at compile time is used (if any); see Makefile.local for instructions on compiling in default romfiles or default romfile names.
-model m | Specifies which TRS-80 model to emulate. Values accepted are 1 or I (Model I), 3 or III (Model III), 4 or IV (Model 4), and 4P or IVP (Model 4P). Model I is the default.
-model1 -model3 -model4 -model4p | Specifies which TRS-80 model to emulate. -model1 is the default.
-keystretch cycles | Fine-tune the keyboard behavior. To prevent keystrokes from being lost, sdltrs "stretches" the intervals between key transitions, so that the Z-80 program has time to see each transition before the next one occurs. Whenever the Z-80 program reads the keyboard matrix and sees an emulated key go up or down, sdltrs waits cycles Z-80 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 Z-80 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.
-shiftbracket | 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.
-noshiftbracket | 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.
-diskdir dir | Specify the directory containing floppy disk images. The default value is ".".
-harddir dir | Specify the directory containing hard disk images. The default value is ".".
-cassdir dir | Specify the directory containing cassette images. The default value is ".".
-disksetdir dir | Specify the directory containing diskset files. (These files specify the contents of all of the floppy and harddrives, allowing you to load them all at once). The default value is ".".
-statedir dir | Specify the directory containing the saved emulator state files. The default value is ".".
-printerdir dir | Specify the directory containing the saved printer output files. The default value is ".".
-printercmd "cmd" | Specify the command to be executed when the printer device is closed. On Linux, this defaults to "lpr %s", on Windows "notepad %s", and on the Mac "open %s". The %s in the printer command will be replaced with the name of the printer output file. (On the Mac, this is for the text printer only, not the Epson emulation).
-doubler type | Specify what type of double density adaptor to emulate (Model I mode only). The type may be percom, radioshack (or tandy), both, or none. The type may be abbreviated to one character. The default is both, which causes the double density adaptor emulation to respond to the special commands of both the Percom and Radio Shack cards.
-doublestep | Make all real floppy drives double-step, allowing access to 35-track or 40-track media in an 80-track drive. Linux only. See the Floppy Disks section of Features for limitations.
-nodoublestep | Turn off double-step mode for all real floppy drives. Linux only. This is the default.
-stepmap s0,s1,s2,s3,s4,s5,s6,s7 | Selectively set double-step mode for individual real floppy drives. If sU is 2 and the disk is a real drive, the drive will be double-stepped; if sU is 1, it will be single-stepped. You can omit values from the end of the list; those drives will get the default value set by -doublestep or -nodoublestep.
-sizesize z0,z1,z2,z3,z4,z5,z6,z7 | Selectively set whether drives are emulated as 5-inch or 8-inch. If zU is 5, the drive will appear to Z-80 software as 5-inch; if 8, as 8-inch. The default setting (as reflected in the documentation above) is 5,5,5,5,8,8,8,8. You can omit values from the end of the list; those drives will get the default values. Setting one or more of the first four drives to 8-inch may be useful for CP/M software that supports 8-inch drives. You can also use XTRS8/DCT with 8-inch drives in the first four positions; even though the prompt suggests the unit number must be 4-7, numbers 0-3 are accepted. XTRS8 does not check whether the unit you've selected is really being emulated as an 8-inch drive, however; you'll simply get errors during FORMAT if you get this wrong.
-truedam | 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. See also "Common File Formats for Emulated TRS-80 Floppy Disks", available at http://www.tim- mann.org/trs80/dskspec.html.
-notruedam | The opposite of -truedam. This setting is the default.
-samplerate rate | Set the sample rate for new cassette wav files, direct cassette I/O to the sound card, and game sound output to the sound card. Existing wav files will be read or modified using their original sample rate regardless of this flag. The default is 44,100 Hz.
-serial ttyname | Set the tty device to be used for I/O to the TRS-80's serial port. The default is /dev/ttyS0 on Linux, "" on Windows and Mac. Setting the name to be empty (-serial "") emulates having no serial port.
-switches value | 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 option 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.
-keypadjoy | Use numeric keypad as joystick.
-nokeypadjoy | Do not use numeric keypad as joystick.
-joysticknum num | Use USB joystick number "num" as the joystick in the emulator. Options are "num", and 0 through number of USB joysticks - 1.
-emtsafe | Turn off ability for emts (Emulation traps) to write to unexpected places in the host filesystem.
-noemtsafe |
Turn on ability for emts (Emulation traps) to write to unexpected places in the host filesystem.(This is the default).