Skip to content

Releases

v1.02

Choose a tag to compare

@1hedu 1hedu released this 27 Aug 00:53
  • Mouse pointer to VDP sprite
  • Fixed a periodic slowdown
  • Fixed splash
  • Slightly better scroll

v1.01 — the serial keyboard, fixed on hardware

Choose a tag to compare

@1hedu 1hedu released this 23 Aug 04:48

The serial keyboard needed four fixes since v1.0, three of them in the path between a key being pressed on the EXT port and the character reaching the document, all found because a Flipper Zero on the bench kept losing letters and keeping their Enters.

What was wrong

The receiver in the 315-5309 is a one-byte latch with no FIFO behind it. At 4800 baud a byte completes every 2 ms, and a frame is 16 ms — so anything that sends a line ending after each character puts two or three bytes on the wire back to back, and the servant was only looking once a frame.

The port is now serviced inside the frame, not once per it. uart_poll() runs from wait_vblank()'s spin loops, where the printer's transmit pump already lived, and from inside the frame's long stretches — the 4000-byte copy+diff, the tile converter, the cart sector loops — each of which runs for milliseconds without reaching the blank. GEOS-Genesis services its receiver from HBlank for the same reason.

An overrun no longer destroys the byte it spared. The first version handled the RERR flag by reading the latch and discarding the value, but on an overrun the latch holds the byte that survived. One read now serves both flags; RERR is counted, not acted on.

Each scancode is acknowledged before the next is posted. GA_KEY is a single latest-wins word, and one post per frame meeting one INT2 per frame held right up until a serial keyboard could type during a redraw. The sub now echoes each sequence byte through the COMFLG byte that has been dead since boot, and the servant holds its queue until the echo matches, with a half-second timeout against an older EmuTOS.

EJECT.PRG no longer calls a NULL pointer. A driver built without CONF_WITH_SCD_DIAG — the default, so every release build — publishes scd_api.snapshot as NULL by design rather than a stub returning zeros. CDTEST.PRG checks it; EJECT.PRG did not, so the first thing after Opening the tray... was a call through NULL, in supervisor mode, that walked the vector table as instructions until it hit Panic: Illegal Instruction, pc=00000030. It checks now.

Downloads

emutosmd-U.iso + emutosmd-U.cue the disc, NTSC-U. Download both into the same folder — the .cue names the .iso
m1emu.bin 512 KB Mode 1 cartridge
SHA256SUMS.txt checksums for the three files above

Disc: burn the .cue/.iso pair; slow burns read more reliably on real hardware. Region-locked — tools/build-iso.sh J|E builds the others, and J still does not boot.

Cartridge: flash m1emu.bin, Mega CD attached, tray empty. Region-free, and it works on a console whose drive no longer does.

Controls

D-pad pointer
A / B left / right click
Start on-screen keyboard

A real keyboard runs on the EXT port at 4800 8N1, enabled from a key on the on-screen keyboard — that is the path these fixes are about. A Sega Mouse in port 2 works too.

Drives

C: ramdisk, system drive; rebuilt every boot
D: the disc (disc boot only)
I: internal backup RAM, 8 KB
S: cartridge save RAM, or a CD Backup RAM Cart

Options → Save Desktop writes to I:, and both boots read it. Format I: once with FORMATI.PRG first — that erases game saves, so copy them off with SRAMTOOL.PRG beforehand. Seat a backup RAM cart before powering on; hot-inserting one erases it.

v1.0 — EmuTOS on the Sega Mega CD

Choose a tag to compare

@1hedu 1hedu released this 21 Aug 19:07

An Atari ST desktop on a Sega Mega CD, booting from CD-R or from a cartridge.

EmuTOS runs on the Mega CD's sub 68000, where address 0 is PRG-RAM, so the Atari ST low-memory ABI is byte-authentic rather than emulated. The Genesis main 68000 runs iofw, a servant that converts EmuTOS's planar framebuffer to the VDP and injects pad input as IKBD packets. GEMDOS, the AES and the VDI are all really there.

Downloads

emutosmd-U.iso + emutosmd-U.cue the disc, NTSC-U. Download both into the same folder — the .cue names the .iso
m1emu.bin 512 KB Mode 1 cartridge
SHA256SUMS.txt checksums for the three files above

Disc: burn the .cue/.iso pair. Slow burns read more reliably on real hardware. The disc is region-locked; tools/build-iso.sh J|E builds the other two regions.

Cartridge: flash m1emu.bin, Mega CD attached. Region-free, and it works on a console whose drive no longer does — the cartridge carries EmuTOS, the ramdisk and the servant in ROM, and the laser never spins.

Controls

D-pad pointer
A / B left / right click
Start on-screen keyboard

On the on-screen keyboard the D-pad selects and A presses. One of its keys enables a real keyboard on the EXT port at 4800 8N1. A Sega Mouse in port B also works.

Connections

Controller Pad in Port A, Mouse on Port B, UART on Port C (EXT).
Plan to support whatever configurations are connected at boot IE UART on Port A, controller pad out the back EXT port--whatever you desire, as they're all electrically the same, so anything can go anywhere EVENTUALLY.

UART Keyboard -- Model 1 with EXT port ONLY. Model 1 without EXT port and Model 2 do not have hardware UART.

EXT pin signal connect to
9 RxD — into the Genesis your adapter's TX
6 TxD — out of the Genesis your adapter's RX (only needed for Printer)
8 GND adapter GND

BEWARE Genesis outputs 5v, so you're UART adapter needs to handle 5v or you may cause damage to your adapter.

Drives

C: ramdisk, system drive; rebuilt every boot
D: the disc (disc boot only)
I: internal backup RAM, 8 KB
S: cartridge save RAM, or a CD Backup RAM Cart

Options → Save Desktop writes to I:, and both boots read it. Format I: once with FORMATI.PRG first — that erases any game saves, so copy them off with SRAMTOOL.PRG (which writes I: to S:\BRAM.BIN) if you need them. FORMATS.PRG formats S:. I: and S: use Sega's own backup RAM format, so game saves and EmuTOS files share the cart.

Seat a backup RAM cart before powering on. Hot-inserting one erases it.

README.TXT on C: describes each program on the disc — a picture viewer, a text editor, the formatters and the backup tool. PRN: is a printer on the EXT port.

Known not to work

The J region disc does not boot, and this is not a new fault — it has been true for as long as there have been J builds. Under Genesis Plus GX with a Japanese BIOS the disc parks on the BIOS screen: the frame hash is identical at 4500 and 6000 frames, and the servant's region of Genesis work RAM is still entirely zero, so ip.bin never ran. U and E both reach the desktop. docs/build.md says where to start looking.

Sonic is not here

He cannot be: the art and the movement constants are Sega's, and this project distributes neither. What the repository carries is the pipeline that reads them out of dumps you already own, and the port of GEOS-Genesis's engine onto this machine. docs/build.md covers building him; docs/sonic.md covers what that port had to solve.