You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,13 +3,13 @@ Disassembly of the Sinclair QL's operating system, version "JS".
3
3
4
4
The Sinclair QL came with an operating system in ROM called QDOS. Version "JS" is the last version that was available in the UK.
5
5
6
-
This is a commented disassembly of the ROM that has been available online and was created by Wolfgang Goeller. Additional comments by Richard Zidlicky.
6
+
This is a commented disassembly of the ROM that has been available online and was created by Wolfgang Goeller. Additional comments by Richard Zidlicky and Daniele Terdina.
7
7
8
8
## History
9
9
1. Disassembly and comments by Wolfgang Goeller (downloaded from the *Maya* FTP archive in the early days of the Internet).
10
10
2. Additional comments by Richard Zidlicky (also available on Dilwyn's web site).
11
11
3. Additional comments by Daniele Terdina (also available on Q-emuLator's web site).
12
-
4. Minor changes to cross-assemble with Asm68K_QL
12
+
4. Minor changes to cross-assemble with Asm68K_QL and generate accurate binary.
13
13
14
14
## Building with the GST assembler
15
15
According to a comment in system_asm, it's possible to assemble the ROM code with the GST Macro Assembler. It needs a 256 KB memory expansion and using the -NOLIST option to avoid running out of space.
@@ -18,5 +18,11 @@ Use the [original sources](https://github.com/CodeDreamer/JS_ROM/releases/tag/or
18
18
## Building with Asm68K
19
19
Using the Asm68K cross-assembler, assemble with:
20
20
```
21
-
Asm68K system_asm
22
-
```
21
+
Asm68K --noopt system_asm
22
+
```
23
+
The --noopt is not necessary, but makes the output closer to the original.
24
+
25
+
## Releases
26
+
Available GitHub releases (code snapshots):
27
+
-`original` is the original disassembly published in the 90s, plus some additional comments.
28
+
-`accurate` produces code identical to the JS ROM when assembled with Asm68K_QL, with one exception: some jumps in the original ROM use "absolute long" addressing (probably by mistake), while the assembler generates "absolute short" addressing. There is no functional difference, and the disassembly already included NOPs to keep the following code at the original address.
0 commit comments