| Option | Effect |
|
| Hardware Selection |
|
| -m1 | Emulate Model I |
| -mj | Emulate Japanese Model I |
| -m2 | Emulate Model II |
| -m3 | Emulate Model III (default) |
| -m3n | Emulate Norcom Model III clone that fit in a Model I case |
| -m4 | Emulate Model 4 (same as -m4a) |
| -m4a | Emulate Model 4 with 2 wait states per instruction |
| -m4b | Emulate Model 4 with 1 wait state per instruction |
| -m4c | Emulate Model 4 with no wait states per instruction |
| -m4ga | Emulate Model 4 Gate Array |
| -m4p | Emulate Model 4P |
| -m4d | Emulate Model 4D |
| -m4ss | Emulate Model 4 Student Station |
| -m12 | Emulate Model 12 |
| -m16 | Emulate Model 16 |
| -m6000 | Emulate Model 6000 |
| -m10 | Emulate Tandy 10 |
| -mc10 | Emulate Micro Color Computer Model MC-10 |
| -mc | Emulate Color Computer |
| -mdt1 | Emulate DT-1 Terminal |
| -mv | Emulate Videotex Terminal |
| -mec | Emulate Electric Crayon |
| -mx70 | Act like MX-70 Printer |
|
| -l1 | Run Level I BASIC ROM (Model I or III) |
| -l2 | Run Level II BASIC ROM (default) (Model I or III) |
| -rN | Use ROM revision N (-r0, -r1, -r2, ...) |
| -nlc | No lowercase for Model I |
| -lld | Load Model I lowercase driver from cassette on startup |
| -nld | Do not load Model I lowercase driver from cassette |
| -nsc | Do not try to set the clock for the boot OS |
| -alt | Use alternate character set |
| -charrom file | Use character generator ROM from file |
| -50 | Set frame rate to 50 Hz |
| -gX | Hires graphics: -g0 none, -gt Tandy (default), -gg Grafyx, -gc Grafyx clone |
| -gtp for Tandy with fixed PROMs for Model 2,3,12,16,6000. |
| -gl for Model 1 Lowe Electronics 18 |
| -ddTYPE | Select Model I floppy doubler: -ddx none, -ddp Percom, |
| -ddr Radio Shack, -ddrp RS+Percom, -ddd detect at boot) |
| -dx | Disable floppy disk controller (boot into ROM BASIC). |
| -dNss | Set drive N (0,1,2,3) single-sided only. |
| -dNds | Set drive N (0,1,2,3) double-sided only. |
| -dNas | Set drive N (0,1,2,3) to automatically act as single or double-sided. |
|
| -hx | Disable hard drive controller |
| -mem n | Emulate n KB of RAM |
| -mem type:n | Emulate n KB of hyper/super/mega expansion RAM. |
| -mem16 n | Emulate n KB of 68000 RAM |
| -memgap16 b n | Unmap an n KB gap in 68000 RAM starting at KB b |
| -mmu16 bits | Set number of extension bits in 68000 MMU (default 3) |
| -z180 | Use Z-180 as main CPU (Model 2) with XLR8er support (Model 4) |
| -mhz16 n | Run 68000 at n MHz (default 8) |
| -rom file | Use ROM image from file |
| -rom1 file | Map ROM image from file to $3000 (Model 1 only) |
| -aft | Aculab floppy tape (Model I only) |
| -80-grafix | 80-Grafix hires character generator (Model I only) |
| -80-grafix+ | 80-Grafix+ hires character generator (Model I only) |
| -pcg-80 | PCG-80 hires character generator (Model I only) |
| -80-grafix3 | 80-Grafix3 hires character generator (Model III only) |
| -omikron | Omikron Mapper for Model I (for Omikron CP/M) |
| -omikron-a | Omikron Mapper using version A ROM |
| -pak file | Use Colour Computer Program Pak (cartridge) ROM from file. |
| -pakq file | As -pak but Program Pak won't auto start |
|
| Program/Media Selection |
|
| -c file.cas | Insert cassette file.cas |
| -w file.tape | Insert floppy tape wafer file.tape into next free drive |
| -dN file.dsk | Insert disk into drive N (0,1,2,3 or A,B) |
| -d file.dsk | Insert disk into next free drive |
| -d dmk | Insert unformatted disk into next free drive (.dmk format) |
| (add -ds for double-sided and #N for tracks) |
| -d imd | Insert unformatted disk into next free drive (.imd format) |
| -d :name | Insert internal diskette ":name" into next free drive |
| -td | Boot TRS-DOS (default) |
| -ld | Boot LDOS or LS-DOS |
| -ad | Boot ADOS (Tandy 10 only) |
| -d0 - | Don't insert TRS-DOS or other boot disk (or -dA -) |
| -h file.hdv | Attach hard drive to next free slot |
| -hN file.hdv | Attach hard drive to slot N |
| -cs -csx | Enable/disable cassette auto save |
| -csd N | Set cassette auto-save delay in 1/10ths of a second. |
| -cix | Disable cassette I/O is happening/CMD"T" warning. |
| file.dsk | Insert disk into next free drive (also .dmk, .imd) |
| file.tape | Insert floppy tape wafer into next free drive |
| file.ccc | Insert Colour Computer Program Pak ROM (CoCo only) |
| :name | Insert internal diskette or wafer into next free drive |
| file | One or more files to load and execute after auto-boot |
| .cmd files are run from dos prompt |
| .cas, .bas and .bds files are loaded into ROM BASIC |
| Files starting with #! are command scripts |
|
| Serial Port (RS-232) Options |
|
| -rx | Disable RS-232 |
| -r host:port | Connect serial port to TCP/IP host, port endpoint. |
| -r @port | Listen for TCP/IP connections on port for serial line. |
| (also -rB for second and -rA for first serial port) |
| -r :mouse | Emulate 2 button mouse on serial port |
| -r :mouse3 | Emulate 3 button mouse on serial port |
| -r :dt1 | Run DT-1 emulator attached to serial port. |
| -r :v | Run Videotex emulator attached to serial port. |
| -r :loop | Loopback device on serial port. |
| -r endpoint | Hook serial port an endpoint (see Endpoint section). |
|
| Printer Port Options |
|
| -p host:port | Connect printer port to TCP/IP host, port endpoint. |
| -p @port | Listen for TCP/IP connections on port for printer. |
| -p :mx70 | Run MX-70 emulator attached to printer port. |
| -p :ec | Run Electric Crayon emulator attached to printer port. |
| -p endpoint | Hook printer port an endpoint (see Endpoint section). |
| -poff | Printer appears powered off |
| -pp -ppx | Enable/Disable printer window pop-up on print. |
|
| View Options |
|
| -va | Authentic display (default) |
| -vs | Sharp display |
| -vi | Sharp display but only allows integer scaling |
| -vh | Cheap display |
| -vN | Scale cheap or sharp display up by N times |
| -vf | Start in full-screen mode (use Alt+Enter to go windowed) |
| -vc #RRGGBB | Set display colour to 24 bit colour value ("-vc - " for default) |
| -vd #RRGGBB | Set beam conflict colour ("-vd -" for default) |
| -vb #RRGGBB | Set border colour ("-vb -" for default) |
| -vr type | Set 256 x 192 artifact colours, x off, s swapped, - default |
| -win WxH | Set window width and height |
| -win full | Start in full-screen mode (use Alt+Enter to go windowed) |
| -bd | Turn beam debugging on |
| -na | Turn off authentic display |
| -vpfon | Turn Tandy 10 PRINT FORM switch on |
| -vpfoff | Turn Tandy 10 PRINT FORM switch off |
| -vrev | Tandy 10 reverse video |
| -vnorm | Tandy 10 normal video (white background) |
| -wtfs N | Update window title only every Nth frame. |
|
| Sound Options |
|
| -s hardware | Enable third party audio for model 1,3 or 4. |
| orch80 Orchestra 80 |
| orch85 Orchestra 85 |
| orch90 Orchestra 90 |
| - Disable third party audio |
| -mute | Start with audio muted. |
| -vol N | Set audio volume percentage (0 to 100; -sv is synonymous) |
| -su | Turn off audio filtering (faster; slightly less accurate) |
| -sx | Disable all audio output |
| -s1 | Force mono sound |
| -s2 | Force stereo sound |
| -sbg | Mute audio if trs80gp does not have the focus |
| -sfg | Audio and sound effects always play (unlike -sbg) |
| -sfmute | Mute sound effects |
| -sfv N | Set sound effect volume percentage |
| -sf fx file.wav | Use file.wav for named sound effect fx: |
| spin-empty empty floppy drive motor on |
| spin-floppy floppy spinning in drive |
| step floppy drive seeking |
| relay-on cassette motor relay activating |
| relay-off cassette motor relay turning off |
|
| Automation Options |
|
| -turbo | Run at top speed |
| -haste | Run fast by drawing once per second (graphics/timing inaccurate) |
| -batch | Have "Record" menu save files without prompting. |
| -fa hex | Update FPS when Z-80 hits address |
| -ta hex | Turbo for 5 frames at Z-80 address |
| -rand | Initialize RAM and the R register with random data. |
| -ct -ctx | Enable/disable cassette auto turbo |
| -dt -dtx | Enable/disable floppy disk auto turbo |
| -ht -htx | Enable/disable hard drive auto turbo |
| -wt -wtx | Enable/disable wafer drive auto turbo |
| -pt -ptx | Enable/disable printer auto turbo |
| -iat -iatx | Enable/disable input/paste auto turbo |
|
| Keyboard, Joystick and Light Pen Input |
|
| -jx | Disable joystick input |
| -js | Swap joystick inputs |
| -kl log|phys|typ Set keyboard layout to logical, physical, typing |
| -kg -kgx | Enable/disable key ghosting on keyboard input |
| -kt -ktx | Enable/disable keyboard auto de-turbo |
| -kc | Clustered key layout in software keyboard (Model 4 only) |
| -ks -ksx | Enable/disable soft capslock (Model 2/12/16/6000 only) |
| -i str | Send str as keyboard input (as if it were pasted) |
| -iy str | Send str with current date/time substitution |
| %m,%d,%y - month, day, year, %h,%i,%s - hour, minute, second |
| %Y - 4 digit year |
| -if file | Send file contents as keyboard input |
| -ifr file | Send untranslated file contents as keyboard input |
| -iw str | Wait until str appears on screen |
| -ik row mask | Set keyboard matrix row to mask |
| -ictl reset | Reset the TRS-80 |
| -id N | Delay N frames |
| -itime N | Give up on input after N frames of waiting (0 to never give up) |
| -ix | Exit emulator when command line input has been sent |
| -ib file | Run trs80gp commands from file |
| -is | Save a screenshot |
| -ics | Save a clean screenshot (no beam interference dropouts) |
| -it | Write text VRAM to file |
| -ig | Write hires graphics VRAM to file |
| -ic | Write programmable character generator VRAM to file |
| -im dump N file | Save ASCII image of disk N to file. |
| -im wp N on|off | Enable or disable write protect on disk N |
| -im trackdump N file |
| Save ASCII image of disk track data of disk N to file |
| -im insert N file |
| Insert disk image file into drive N |
| -im eject N 1 | Eject disk image in drive N with no prompting |
| -ip host:port | Read keyboard input from TCP/IP host, port endpoint. |
| -ip @port | Listen for TCP/IP connections on port for keyboard. |
| -ip endpoint | Hook input to an endpoint (see Endpoint section). |
| -ir audio | Toggle audio recording (turn on if off, off if on) |
| -ir flash | Toggle flash video recording |
| -ir video | Toggle AVI video recording |
| -ir gif | Toggle animated GIF recording |
| -ir mhz | Toggle MHz recording |
| -lp | Enable light pen emulation (1,3,4) |
| -esc-exits | Pressing the escape key exits trs80gp |
|
| Programmer Help |
|
| -b hex | Set debugger breakpoint (can use "-b hex" up to 4 times). |
| -b label | Set breakpoint at label (if .bds file loaded) |
| -b start:end | Set breakpoints from start to end (0:ffff can be handy) |
| -bm hex/label | Set Z-80/6800/6809 memory access breakpoint |
| also -bmr or -bmw to trap only reads or writes |
| -bio hex/label | Set Z-80 I/O access breakpoint |
| also -bior or -biow to trap only reads or writes |
| -b16 hex | Set 68000 debugger breakpoint |
| -b16m hex/label | Set 68000 memory access breakpoint |
| also -b16mr or -b16mw to trap only reads or writes |
| -l file | Load file into memory but don't run it |
| -ls file.bds | Load symbols from file but don't load its data. |
| -ee | Enable emulator extensions (debugging oriented) |
| -trace | Start with tracing on (Record → Trace) |
| -tr addrset | Start with tracing when PC in given address set. |
| -trpr name,nm2 | Device values to output in trace log. |
| -nrs | Don't load any built-in symbols/source code. |
| -8z | Use Zilog mnemonics when disassembling 8080 code. |
| -8i | Use Intel mnemonics when disassembling 8080 code. |
|
| FreHD Emulation |
|
| -frehd | Enable FreHD emulation |
| -frehd_dir dir | Set directory used for FreHD external file import/export |
| Also enables FreHD emulation |
| -frehd_load fl | Use boot block in file instead of the built-in one |
| -frehd_patch | Apply FreHD auto-start patches to the ROM |
| -frehd_menu | Use built-in FreHD menu program rather than frehd.rom |
| in the -frehd_dir |
|
| Becker Port Options (CoCo only) |
|
| -bck host:port | Connect Becker port to TCP/IP host, port endpoint. |
| -bck @port | Listen for TCP/IP connections on port for Becker port. |
| -bck :v | Run Videotex emulator attached to Becker port. |
| -bck endpoint | Hook Becker port to an endpoint (see Endpoint section). |
|
| Scripting and Customization |
|
| -menu name cmd | Add "name" to Custom menu executing to execute cmd |
| -menu Soft [ postmsg keyboard_soft ] |
| -menu "Debug Source" [ |
| [ postmsg debug ] |
| [ postmsg source_code ] ] |
| -cmd cmd | Commands to run at program start |
|
| Endpoint Syntax |
|
| host:port | Connect to TCP/IP host name and port number. |
| :port | Connect to TCP/IP port number on localhost. |
| @port | Listen for TCP/IP connection on port number. |
| /file/path | Unix serial port like "/dev/ttyUSB0" or a fifo. |
| >filename | Write all output to a file. |
| <filename | Read input from file. |
| <infile>outfile | Read from infile and write to outfile. |
| |command %p | Run command that will connect to %p TCP/IP port. |
| :loop | Loopback device on serial port. |
| :mouse | Emulate 2 button mouse device. |
| :mouse3 | Emulate 3 button mouse device. |
| :dt1 | DT-1 emulator. |
| :v | Videotex emulator. |
| :mx70 | MX-70 printer emulator. |
| :ec | Electric Crayon emulator. |
| [ :model args ] | Pass arguments to :mx70, etc. e.g., [ :mx70 -mute ] |
|
| Esoterica |
|
| -event endpoint | Send high level system events to an endpoint. |
| -sync | Try to maintain frame rate exactly (uses excessive CPU) |
| -trsnic | Preliminary trsnic emulation (model 1,3,4 only) |
| -time render|frame|emulation | Show timing in title bar |
| -showkey | Show Windows key code in title bar |
| -showframe | Show the frame number in title bar |
| -writerom | Make ROM writeable (Model 1 and 3 only) |
| -m1_vblank | VBLANK readable as bit 0 of port $FF (Model I only) |
| -x1hack | Temporary fix for Xenix 1 boot error (and TRSDOS-16) |
| (disables 68000 to Z-80 interrupt request through CTC1) |
| -rtc16 | Enable real time clock for Model 16,6000 (default) |
| -rtc16x | Disable real time clock for Model 16,6000 |
| -mmu9f | Model I 16 RAM bank 0 when bit 0 of port $9F set. |
| -t1hack | Modification to when FDC switches to Type I status. |
| Only useful to make TRSDOS-II RESTORE work. |