collapseos/recipes/sms
Virgil Dupras 019d05f64c Make the shell a userspace app
That's my mega-commit you've all been waiting for.

The code for the shell share more routines with userspace apps than with kernel
units, because, well, its behavior is that of a userspace app, not a device
driver.

This created a weird situation with libraries and jump tables. Some routine
belonging to the `kernel/` directory felt weird there.

And then comes `apps/basic`, which will likely share even more code with the
shell. I was seeing myself creating huge jump tables to reuse code from the
shell. It didn't feel right.

Moreover, we'll probably want basic-like apps to optionnally replace the shell.

So here I am with this huge change in the project structure. I didn't test all
recipes on hardware yet, I will do later. I might have broken some...

But now, the structure feels better and the line between what belongs to
`kernel` and what belongs to `apps` feels clearer.
2019-11-15 15:37:49 -05:00
..
kbd Make the shell a userspace app 2019-11-15 15:37:49 -05:00
romasm Make the shell a userspace app 2019-11-15 15:37:49 -05:00
.gitignore recipes/sms: New section for Sega Master System 2019-07-01 11:05:25 -04:00
glue.asm Make the shell a userspace app 2019-11-15 15:37:49 -05:00
Makefile Make the shell a userspace app 2019-11-15 15:37:49 -05:00
README.md recipes/sms/romasm: ed and zasm, fully functional! 2019-07-25 14:24:18 -04:00

Sega Master System

The Sega Master System was a popular gaming console running on z80. It has a simple, solid design and, most interestingly of all, its even more popular successor, the Megadrive (Genesis) had a z80 system for compatibility!

This makes this platform very scavenge-friendly and worth working on.

SMS Power is an awesome technical resource to develop for this platform and this is where most of my information comes from.

This platform is tight on RAM. It has 8k of it. However, if you have extra RAM, you can put it on your cartridge.

This recipe is for installing a minimal Collapse OS system on the SMS. There are other recipes related to the SMS:

Gathering parts

  • zasm
  • A Sega Master System or a MegaDrive (Genesis). (I have only tested on a MegaDrive so far)
  • A Megadrive D-pad controller.
  • A way to get an arbitrary ROM to run on the SMS. Either through a writable ROM card or an Everdrive.

Build the ROM

Running make will produce a os.sms ROM that can be put as is on a SD card to the everdrive or flashed as is on a writable ROM cart. Then, just run the thing!

Usage

On boot, you will get a regular Collapse OS shell. See the rest of the documentation for shell usage instructions.

The particularity here is that, unlike with the RC2014, we don't access Collapse OS through a serial link. Our input is a D-Pad and our output is a TV. The screen is 32x28 characters. A bit tight, but usable.

D-Pad is used as follow:

  • There's always an active cursor. On boot, it shows "a".
  • Up/Down increase/decrease the value of the cursor.
  • Left/Right does the same, by increments of 5.
  • A button is backspace.
  • B button skips cursor to next "class" (number, lowcase, upcase, symbols).
  • C button "enters" cursor character and advance the cursor by one.
  • Start button is like pressing Return.

Of course, that's not a fun way to enter text, but using the D-Pad is the easiest way to get started which doesn't require soldering. Your next step after that would be to build a PS/2 keyboard adapter!