7842 - new directory organization
Baremetal is now the default build target and therefore has its sources
at the top-level. Baremetal programs build using the phase-2 Mu toolchain
that requires a Linux kernel. This phase-2 codebase which used to be at
the top-level is now under the linux/ directory. Finally, the phase-2 toolchain,
while self-hosting, has a way to bootstrap from a C implementation, which
is now stored in linux/bootstrap. The bootstrap C implementation uses some
literate programming tools that are now in linux/bootstrap/tools.
So the whole thing has gotten inverted. Each directory should build one
artifact and include the main sources (along with standard library). Tools
used for building it are relegated to sub-directories, even though those
tools are often useful in their own right, and have had lots of interesting
programs written using them.
A couple of things have gotten dropped in this process:
- I had old ways to run on just a Linux kernel, or with a Soso kernel.
No more.
- I had some old tooling for running a single test at the cursor. I haven't
used that lately. Maybe I'll bring it back one day.
The reorg isn't done yet. Still to do:
- redo documentation everywhere. All the README files, all other markdown,
particularly vocabulary.md.
- clean up how-to-run comments at the start of programs everywhere
- rethink what to do with the html/ directory. Do we even want to keep
supporting it?
In spite of these shortcomings, all the scripts at the top-level, linux/
and linux/bootstrap are working. The names of the scripts also feel reasonable.
This is a good milestone to take stock at.
2021-03-04 06:09:50 +00:00
|
|
|
#!/bin/sh
|
|
|
|
# Translate a Mu program to a bootable disk image.
|
|
|
|
|
|
|
|
set -e
|
|
|
|
|
2021-08-29 18:25:08 +00:00
|
|
|
# Map of the Mu code disk
|
|
|
|
export DISK=20160 # 20*16*63 512-byte sectors = almost 10MB
|
2021-08-30 03:54:05 +00:00
|
|
|
dd if=/dev/zero of=code.img count=$DISK status=none
|
2021-08-30 03:34:53 +00:00
|
|
|
# code: sectors 0-8999
|
2021-09-01 05:49:27 +00:00
|
|
|
# font: sectors 9000-10079 (1080 sectors = space enough for 16k glyphs (1080 * 512 / 34 bytes per glyph))
|
2021-08-30 03:34:53 +00:00
|
|
|
export FONT=9000 # keep this sync'd with boot.subx
|
2021-08-29 18:25:08 +00:00
|
|
|
# debug: sector 10080 onwards
|
|
|
|
export DEBUG=10080
|
|
|
|
|
|
|
|
## Code
|
|
|
|
|
2021-08-29 16:32:40 +00:00
|
|
|
cat $* [0-9]*.mu |linux/mu > a.subx
|
7842 - new directory organization
Baremetal is now the default build target and therefore has its sources
at the top-level. Baremetal programs build using the phase-2 Mu toolchain
that requires a Linux kernel. This phase-2 codebase which used to be at
the top-level is now under the linux/ directory. Finally, the phase-2 toolchain,
while self-hosting, has a way to bootstrap from a C implementation, which
is now stored in linux/bootstrap. The bootstrap C implementation uses some
literate programming tools that are now in linux/bootstrap/tools.
So the whole thing has gotten inverted. Each directory should build one
artifact and include the main sources (along with standard library). Tools
used for building it are relegated to sub-directories, even though those
tools are often useful in their own right, and have had lots of interesting
programs written using them.
A couple of things have gotten dropped in this process:
- I had old ways to run on just a Linux kernel, or with a Soso kernel.
No more.
- I had some old tooling for running a single test at the cursor. I haven't
used that lately. Maybe I'll bring it back one day.
The reorg isn't done yet. Still to do:
- redo documentation everywhere. All the README files, all other markdown,
particularly vocabulary.md.
- clean up how-to-run comments at the start of programs everywhere
- rethink what to do with the html/ directory. Do we even want to keep
supporting it?
In spite of these shortcomings, all the scripts at the top-level, linux/
and linux/bootstrap are working. The names of the scripts also feel reasonable.
This is a good milestone to take stock at.
2021-03-04 06:09:50 +00:00
|
|
|
|
2021-08-30 03:34:53 +00:00
|
|
|
cat boot.subx mu-init.subx [0-9]*.subx a.subx |linux/braces > a.braces
|
2021-08-29 16:32:40 +00:00
|
|
|
|
|
|
|
cat a.braces |linux/calls > a.calls
|
|
|
|
|
|
|
|
cat a.calls |linux/sigils > a.sigils
|
|
|
|
|
|
|
|
cat a.sigils |linux/tests > a.tests
|
|
|
|
|
|
|
|
# no assort since baremetal SubX doesn't have segments yet
|
|
|
|
|
|
|
|
cat a.tests |linux/dquotes > a.dquotes
|
|
|
|
|
|
|
|
cat a.dquotes |linux/pack > a.pack
|
|
|
|
|
|
|
|
cat a.pack |linux/survey_baremetal > labels
|
|
|
|
cat a.pack |linux/labels_baremetal labels > a.survey
|
|
|
|
|
|
|
|
cat a.survey |linux/hex > a.bin
|
|
|
|
|
2021-08-30 03:54:05 +00:00
|
|
|
dd if=a.bin of=code.img conv=notrunc status=none
|
2021-08-29 16:32:40 +00:00
|
|
|
|
|
|
|
if [ `stat --printf="%s" a.bin` -ge 492544 ] # 15 tracks * 63 sectors per track * 512 bytes per sector (keep this sync'd with boot.subx)
|
|
|
|
then
|
|
|
|
echo "a.bin won't all be loaded on boot"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
|
|
|
if [ `stat --printf="%s" a.bin` -ge 492544 ] # 15 tracks * 63 sectors per track * 512 bytes per sector
|
|
|
|
then
|
|
|
|
echo "a.bin will overwrite BIOS/Video memory; you'll need to adjust boot.subx to load code to some other non-contiguous area of memory"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
2021-08-30 03:34:53 +00:00
|
|
|
if [ `stat --printf="%s" a.bin` -ge $(($FONT*512)) ]
|
2021-08-29 18:25:08 +00:00
|
|
|
then
|
2021-08-30 03:34:53 +00:00
|
|
|
echo "a.bin will overwrite font in disk"
|
2021-08-29 18:25:08 +00:00
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
|
|
|
## Latter half of disk is for debug info
|
|
|
|
|
2021-08-29 16:32:40 +00:00
|
|
|
if [ `stat --printf="%s" labels` -ge 1048576 ] # 8 reads * 256 sectors * 512 bytes per sector
|
|
|
|
then
|
|
|
|
echo "labels won't all be loaded on abort"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
|
|
|
if [ `wc -l < labels` -gt 20480 ] # 0x5000 stream capacity in abort.subx
|
|
|
|
then
|
|
|
|
echo "abort will go into infinite regress"
|
|
|
|
exit 1
|
|
|
|
fi
|
2021-08-29 18:25:08 +00:00
|
|
|
|
2021-08-30 03:54:05 +00:00
|
|
|
dd if=labels of=code.img seek=$DEBUG conv=notrunc status=none # keep this sync'd with abort.subx
|
2021-08-30 03:34:53 +00:00
|
|
|
|
2021-08-30 03:39:42 +00:00
|
|
|
## Font data at another well-defined location
|
|
|
|
cat font.subx |sed 's,/[^ ]*,,' |linux/hex > a.font
|
2021-08-30 03:34:53 +00:00
|
|
|
|
2021-09-01 05:49:27 +00:00
|
|
|
if [ `stat --printf="%s" a.font` -ge 262144 ] # 0x200 sectors * 512 bytes per sector (keep this sync'd with boot.subx)
|
|
|
|
then
|
|
|
|
echo "font won't all be loaded on boot"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
|
|
|
if [ `stat --printf="%s" a.font` -ge 14680064 ] # 0x00e00000 = 0x00f00000 - 0x00100000
|
|
|
|
then
|
|
|
|
echo "font is so large it overlaps the ISA memory hole; see https://wiki.osdev.org/Memory_Map_(x86)"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
2021-09-01 05:19:40 +00:00
|
|
|
if [ `stat --printf="%s" a.font` -ge $(( ($DEBUG - $FONT) * 512 )) ]
|
2021-08-30 03:34:53 +00:00
|
|
|
then
|
|
|
|
echo "font will overwrite debug info in disk"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
2021-08-30 03:54:05 +00:00
|
|
|
dd if=a.font of=code.img seek=$FONT conv=notrunc status=none
|