https://github.com/tom-seddon/electron_os_disassembly
WIP disassembly of the Acorn Electron OS
https://github.com/tom-seddon/electron_os_disassembly
bbc-micro
Last synced: 25 days ago
JSON representation
WIP disassembly of the Acorn Electron OS
- Host: GitHub
- URL: https://github.com/tom-seddon/electron_os_disassembly
- Owner: tom-seddon
- Created: 2023-11-13T16:40:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-05T00:38:48.000Z (4 months ago)
- Last Synced: 2026-03-05T06:42:12.034Z (4 months ago)
- Topics: bbc-micro
- Language: Python
- Homepage:
- Size: 1.26 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
WIP disassembly of the OS for the Acorn Electron. The following
Acorn versions are covered:
* OS 1.00 - ROM supplied with Electron
The following non-Acorn versions are covered:
* OS 3.00 - ROM supplied with Slogger's Master RAM Board
The following unreleased non-Acorn versions from
[Slogger's old stock](https://stardot.org.uk/forums/viewtopic.php?t=11795)
are also covered:
* 213-OS-3.00-alt1
* 249-OS-3.00-alt2 - identical to OS 3.00
* 524-OS-3.00-alt4
(There is also an alt3 ROM, but it looks invalid.)
**This project is a work in progress.** You'll find many holes, many
missing comments, and some rather unhelpful label names. The initial
goal is simply to separate code and data and ensure everything in the
ROM that needs a label has one.
Starting point was JGH's disassembly of the Electron MOS 1.00 here:
https://mdfs.net/Info/Comp/Acorn/Source/MOS.htm - this has supplied
nearly all the current comments.
# build
This repo has submodules. Clone it with `--recursive`:
git clone --recursive https://github.com/tom-seddon/mos320
Alternatively, if you already cloned it non-recursively, you can do
the following from inside the working copy:
git submodule init
git submodule update
## prerequisites ##
Mandatory:
* Python 3.x
On Unix:
* [`64tass`](http://tass64.sourceforge.net/) (I use r3120)
* GNU Make
(Prebuilt Windows EXEs for 64tass and make are included in the repo.)
## build steps ##
Type `make` from the root of the working copy.
The build process is supposed to be silent when there are no errors
and when the output matches the original ROMs. Some versions of make
might print a load of stuff about entering and leaving the directory.
## build output
The build output is assembler listing files that you can use for
reference. Acorn versions:
- `build/elk100.lst` - OS 1.00
Non-Acorn versions:
- `build/os300.lst` - OS 3.00