Skip to content

Commit f9edea8

Browse files
authored
Update README.md with new usage
1 parent 8784793 commit f9edea8

File tree

1 file changed

+43
-30
lines changed

1 file changed

+43
-30
lines changed

README.md

+43-30
Original file line numberDiff line numberDiff line change
@@ -76,36 +76,49 @@ NTVCM can be built to target real-mode DOS using the Watcom compiler. Details in
7676

7777
The two versions of Turbo Pascal and the apps they generate use a tiny fraction of Z80 instructions. It took a day to implement the instructions for Turbo Pascal, and three more days to implement the full instruction set. Getting the undocumented features to work took an extra couple days. The invaluable resources required to do that are listed in x80.cxx. No single resource was 100% correct or complete. It takes a village :)
7878

79-
NT Virtual CP/M 2.2 Machine: emulates a CP/M 2.2 i8080/Z80 runtime environment
80-
81-
usage: ntvcm [-c] [-p] [-s:X] [-t] <cp/m 2.2 .com file> [filearg1] [filearg2]
82-
83-
notes: filearg1 and filearg2 optionally specify filename arguments for the command
84-
-b translate bios console input backspace (BS / 0x08) to delete (DEL / 0x7f).
85-
-c never auto-detect ESC characters and change to to 80x24 mode
86-
-C always switch to 80x24 mode
87-
-d don't clear the display on app exit when in 80x24 mode
88-
-i trace 8080/Z80 instructions when tracing with -t
89-
-k translate Kaypro II extended characters to Windows code page 437 or Linux ascii art
90-
-l force CP/M filenames to be lowercase (can be useful on Linux)
91-
-p show performance information at app exit
92-
-s:X speed in Hz. Default is 0, which is as fast as possible.
93-
for 4Mhz, use -s:4000000
94-
-t enable debug tracing to ntvcm.log
95-
-v:X translate escape sequences to VT-100 where X can be one of:
96-
5: translate vt-52 escape sequences. for CalcStar and other apps
97-
k: translate Kaypro II / Lear-Siegler ADM-3A escape sequences. for strtrk.com
98-
-z:X applies X as a hex mask to SetProcessAffinityMask, e.g.:
99-
/z:11 2 performance cores on an i7-1280P
100-
/z:3000 2 efficiency cores on an i7-1280P
101-
/z:11 2 random good cores on a 5950x
102-
-8 emulate the i8080, not Z80
103-
e.g. to assemble, load, and run test.asm:
104-
ntvcm asm.com test
105-
ntvcm load.com test
106-
ntvcm test.com
107-
e.g. to run Star Trek in mbasic in 80x24 mode using i8080 emulation:
108-
ntvcm -8 -C mbasic startrek.bas
79+
Usage: ntvcm [-?] [-c] [-p] [-s:X] [-t] <command> [arg1] [arg2]
80+
A CP/M 2.2 emulator.
81+
82+
-b backspace/BS/0x08 key sends delete/DEL/0x7f.
83+
(for use with Turbo Pascal).
84+
-c never auto-detect ESC characters and change
85+
to to 80x24 mode.
86+
-C always switch to 80x24 mode.
87+
-d don't clear the display on exit when in 80x24 mode.
88+
-f:<file> specify an input file containing keystrokes.
89+
-i trace 8080/Z80 instructions when tracing with -t.
90+
-k translate Kaypro II extended characters to ASCII
91+
equivalents.
92+
-l force CP/M filenames to be lowercase.
93+
-n don't sleep for apps in tight bdos 6 loops. (Use
94+
with apps like nvbasic).
95+
-p show performance information at app exit.
96+
-s:X specify clock speed in Hz.
97+
defaults to 0 which is as fast as possible.
98+
-t enable debug tracing to ntvcm.log.
99+
-V display version and exit.
100+
-v:X translate escape sequences to VT-100
101+
where X can be one of:
102+
5: for vt-52 escape sequences (use with CalcStar etc)
103+
k: for Kaypro II/Lear-Siegler ADM-3A escape sequences.
104+
(use with strtrk).
105+
-z:X applies X as a hex mask to SetProcessAffinityMask.
106+
e.g.:
107+
/z:11 2 performance cores on an i7-1280P
108+
/z:3000 2 efficiency cores on an i7-1280P
109+
/z:11 2 random good cores on a 5950x
110+
-8 use 8080 instruction set, not Z80
111+
112+
e.g. to assemble, load, and run test.asm:
113+
ntvcm asm.com test
114+
ntvcm load.com test
115+
ntvcm test.com
116+
117+
e.g. to run test.com at 4MHz:
118+
ntvcm -s:4000000 test
119+
120+
e.g. to run Star Trek in mbasic in 80x24 mode using i8080 emulation:
121+
ntvcm -8 -C mbasic startrek.bas
109122

110123
Example usage:
111124

0 commit comments

Comments
 (0)