akkartik
/
mu
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
mu/baremetal/README.md

41 lines
1.8 KiB
Markdown
Raw Normal View History

7403 - baremetal/ for apps without a kernel
2020-12-26 21:22:28 +00:00
Some apps written in SubX and Mu. Where the rest of this repo relies on a few
Linux syscalls, the apps in this subdirectory interface directly with hardware.
7419
2020-12-27 06:56:44 +00:00
We still need the top-level and apps to build them.
7404 - baremetal: first example program Design choice: all programs will use a graphics mode (1280x1024) with 256 colors. That should be fairly widely available. (It turns out text modes larger than 80x25 are not widely available even among modern emulators. Mu will need fonts sooner rather than later.) Mu will never try to be smart and do things like autodetect your hardware. We _will_ help you modify Mu for your hardware.
2020-12-26 22:21:04 +00:00
I'd like to eventually test these programs on real hardware, and to that end
they are extremely parsimonious in the hardware they assume:
7406
2020-12-26 23:34:10 +00:00
7410
2020-12-27 01:35:16 +00:00
0. Lots (more than 640KB/1MB[1]) of RAM
7424 - baremetal: downsize graphics resolution If it's large enough that I have doubts whether my top-of-the-line Mac is showing the bottom of the screen inside an emulator, it's too large. This way I also feel more confident that most modern hardware will support this graphics mode, and that these programs will work for others.
2020-12-27 16:33:22 +00:00
1. Pure-graphics video mode (1024x768 pixels) in 256-color mode. At 8x8
7423
2020-12-27 16:03:48 +00:00
pixels per grapheme, this will give us 160x128 graphemes. But it's still
an open question if it's reasonably widely supported by modern hardware.
If it isn't, I'll downsize.
2. Keyboard. Just a partial US keyboard for now.
7404 - baremetal: first example program Design choice: all programs will use a graphics mode (1280x1024) with 256 colors. That should be fairly widely available. (It turns out text modes larger than 80x25 are not widely available even among modern emulators. Mu will need fonts sooner rather than later.) Mu will never try to be smart and do things like autodetect your hardware. We _will_ help you modify Mu for your hardware.
2020-12-26 22:21:04 +00:00
That's it:
* No wifi, no networking
* No multitouch, no touchscreen, no mouse
7423
2020-12-27 16:03:48 +00:00
* No graphics acceleration
7404 - baremetal: first example program Design choice: all programs will use a graphics mode (1280x1024) with 256 colors. That should be fairly widely available. (It turns out text modes larger than 80x25 are not widely available even among modern emulators. Mu will need fonts sooner rather than later.) Mu will never try to be smart and do things like autodetect your hardware. We _will_ help you modify Mu for your hardware.
2020-12-26 22:21:04 +00:00
* No virtual memory, no memory reclamation
7406
2020-12-26 23:34:10 +00:00
7407
2020-12-27 00:37:10 +00:00
Just your processor, gigabytes of RAM[1], a moderately-sized monitor and a
7423
2020-12-27 16:03:48 +00:00
keyboard. (The mouse should also be easy to provide.)
7404 - baremetal: first example program Design choice: all programs will use a graphics mode (1280x1024) with 256 colors. That should be fairly widely available. (It turns out text modes larger than 80x25 are not widely available even among modern emulators. Mu will need fonts sooner rather than later.) Mu will never try to be smart and do things like autodetect your hardware. We _will_ help you modify Mu for your hardware.
2020-12-26 22:21:04 +00:00
7423
2020-12-27 16:03:48 +00:00
We can't yet read from or write to disk, except for the initial load of the
program. Enabling access to lots of RAM gives up access to BIOS helpers for
the disk.
These programs don't convert to formats like ELF that can load on other
operating systems. There's also currently no code/data segment separation,
just labels and bytes. I promise not to write self-modifying code. Security
and sandboxing is still an open question.
7404 - baremetal: first example program Design choice: all programs will use a graphics mode (1280x1024) with 256 colors. That should be fairly widely available. (It turns out text modes larger than 80x25 are not widely available even among modern emulators. Mu will need fonts sooner rather than later.) Mu will never try to be smart and do things like autodetect your hardware. We _will_ help you modify Mu for your hardware.
2020-12-26 22:21:04 +00:00
7489 - include GNU Unifont https://en.wikipedia.org/wiki/GNU_Unifont#The_.hex_font_format http://unifoundry.com/unifont/index.html Since GNU Unifont is covered under the GPL v2, so I believe is this repo.
2021-01-09 23:38:03 +00:00
Most programs here assume `main` starts at address 0x9000 (7KB or 14 disk
7404 - baremetal: first example program Design choice: all programs will use a graphics mode (1280x1024) with 256 colors. That should be fairly widely available. (It turns out text modes larger than 80x25 are not widely available even among modern emulators. Mu will need fonts sooner rather than later.) Mu will never try to be smart and do things like autodetect your hardware. We _will_ help you modify Mu for your hardware.
2020-12-26 22:21:04 +00:00
sectors past the BIOS entrypoint). See baremetal/boot.hex for details.
So far the programs have only been tested in Qemu and Bochs emulators.
7407
2020-12-27 00:37:10 +00:00
7408
2020-12-27 00:38:01 +00:00
[1] Though we might need to start thinking of [the PC memory map](https://wiki.osdev.org/Memory_Map_(x86))
7420
2020-12-27 06:57:16 +00:00
as our programs grow past the first 512KB of memory. Writing to random
locations can damage hardware or corrupt storage devices.