Retro/pcjs
Watch
1
0
Fork
You've already forked pcjs
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

More documentation updates

Browse source
This commit is contained in:
Jeff Parsons 2016-04-08 22:45:25 -07:00
commit 231ca3961e
24 changed files with 184 additions and 18 deletions
Download patch file Download diff file Expand all files Collapse all files

10
tests/README.md Normal file
View file

@ -0,0 +1,10 @@
---
layout: page
title: Test Resources
permalink: /tests/
---
Test Resources
---
An assortment of [PC Tests](pc/) is available.

10
tests/pc/80386/README.md Normal file
View file

@ -0,0 +1,10 @@
---
layout: page
title: 80386 Tests
permalink: /tests/pc/80386/
---
Overview
---
See [test386.asm](test386.asm).

4
tests/pc/80386/makefile
View file

@ -1,7 +1,7 @@
all: test386.json test386.img
test386.com: test386.nasm ../inc/dos.inc ../inc/misc.inc ../inc/x86.inc
nasm -i../inc/ -f bin test386.nasm -l test386.lst -o test386.com
test386.com: test386.asm ../inc/dos.inc ../inc/misc.inc ../inc/x86.inc
nasm -i../inc/ -f bin test386.asm -l test386.lst -o test386.com
test386.json: test386.com
node ../../../modules/filedump/bin/filedump --file=test386.com --output=test386.json --overwrite

2
tests/pc/80386/test386.nasm → tests/pc/80386/test386.asm
View file

@ -1,5 +1,5 @@
;
; test386.nasm
; test386.asm
; Copyright © 2012-2015 Jeff Parsons <Jeff@pcjs.org>
;
; This file is part of PCjs, which is part of the JavaScript Machines Project (aka JSMachines)

12
tests/pc/README.md Normal file
View file

@ -0,0 +1,12 @@
---
layout: page
title: PC Test Resources
permalink: /tests/pc/
---
PC Test Resources
---
* [80386 Tests](80386/)
* [Trace Utility](trace/)
* [VGA "Black Book" Tests](vga/)

7
tests/pc/trace/README.md
View file

@ -1,4 +1,7 @@
Overview
---
layout: page
title: PC Trace Utility
permalink: /tests/pc/trace/
---
WARNING: This utility is obsolete. It has been superseded by [test386](/tests/pc/80386/),
@ -6,6 +9,7 @@ which, going forward, serves as our new model for instruction-level testing. As
the **traceLog()** functionality mentioned below has been removed from the PCjs source code
(but you can always dig it back up if you really want it).
Overview
---
TRACE.COM takes an instruction log, as recorded by the PCjs Debugger's traceLog() function, and
@ -32,6 +36,7 @@ instructions, even though we'll be missing OVERFLOW validation for all single-bi
Operation
---
To load TRACE.COM and TRACE.TXT onto a virtual disk image that PCjs can access, you can add an
"automount" setting to your PCjs <fdc> configuration that will dynamically generate a fresh disk image
every time the machine is loaded, via the DiskDump API. This is useful when you're constantly