dustin
/
basementhud
1
0
Fork 0
Code Pull Requests Releases Activity
5 Commits
2 Branches
0 Tags
382 KiB
Shell 89%
Dockerfile 5.7%
Makefile 5.3%
 
 
 
Go to file
Dustin 4ec3117b3c cmdline: enable serial console 
While developing, it will be nice to have the serial console available
for troubleshooting, especially for issues that prevent network/SSH from
working correctly.  I've temporarily connected a USB-TTL console cable
to *serial0* to control the serial console of the HUD machine.
 		2022-04-04 20:59:34 -05:00
ci Initial commit 2022-04-04 20:59:32 -05:00
overlay Switch to Openbox 2022-04-04 20:59:34 -05:00
.gitignore Initial commit 2022-04-04 20:59:32 -05:00
Makefile Initial commit 2022-04-04 20:59:32 -05:00
README.md Initial commit 2022-04-04 20:59:32 -05:00
cmdline.txt cmdline: enable serial console 2022-04-04 20:59:34 -05:00
config.txt config: disable HDMI overscan 2022-04-04 20:59:34 -05:00
mkinitramfs.sh Initial commit 2022-04-04 20:59:32 -05:00
mkrootfs.sh Switch to Openbox 2022-04-04 20:59:34 -05:00
prepare.sh Initial commit 2022-04-04 20:59:32 -05:00
publish.sh publish: Upload rootfs image atomically 2022-04-04 20:59:34 -05:00
squashfs-exclude.txt Initial commit 2022-04-04 20:59:32 -05:00

README.md

Basement Hud Network-Booted OS

Customized Fedora-based operating system distributed as an immutable root filesystem image.

Building

Must run on a Fedora host or privileged container.

Build the root filesystem image:

make rootfs

This will create an _build/rootfs directory containing the root filesystem hierarchy. The _build/rootfs/boot directory contains the necessary files to boot the system:

  • efi: This directory contains the Raspberry Pi firmware files
  • initramfs.img: Early userspace image
  • vmlinuz: Kernel image
  • basementhud.squashfs: Root filesystem image

The Raspberry Pi firmware, initramfs image, and kernel image files must be served by a TFTP, while the rootfs image is served by NBD.

Build the initramfs image:

make initramfs