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 |
-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, -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. |
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) |
-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 |
-d0 - | Don't insert TRS-DOS disk |
-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 |
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 | |
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. |
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. |
-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 |
-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 | Set keyboard layout to logical or physical |
-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 |
-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 |
-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. |
-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) |
-nrs | Don't load any built-in symbols/source 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 | |
Esoterica | |
-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) | |
-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. |