HighlightOS

January 1, 2025 · View on GitHub

x86_64 System Operacyjny (kernel) zrobiony od zera w Assembly & Rust

README in English README in Polish README in Italian Documentation

GitHub Release GitHub License GitHub repo size GitHub Actions Workflow Status GitHub Actions Workflow Status

Spis treści

Budowa ze źródła na Linuxie

Główny Kernel

Wymagania:

Kroki:

  1. Upewnij się że rustup jest zainstalowany:
rustup --version
  1. Stwórz lokalną kopię repozytorium:
git clone git@github.com:adamperkowski/highlightos.git && cd highlightos
  1. Użyj cd do folderu kernel/:
cd kernel
  1. Zbuduj bootowalny plik binarny:
cargo bootimage --release

Ta komenda stworzy folder target/target/release w którym znajdziesz bootimage-hlkernel.bin, czyli plik binarny.

HighlightOS ASM

Wymagania:

  • System kontroli wersji Git
  • Kompilator Assembly NASM

Kroki:

  1. Stwórz lokalną kopię repozytorium:
git clone git@github.com:adamperkowski/highlightos.git && cd highlightos
  1. Użyj cd do folderu asm/:
cd asm
  1. Skompiluj plik binarny:
nasm -f bin boot.asm -o boot.bin

Ta komenda stworzy plik boot.bin i umieści go w twoim aktualnym folderze.

Uruchamianie w QEMU na Linuxie

Wymagania:

Kroki:

  1. Użyj cd do folderu z plikiem binarnym.
  2. Użyj następującej komendy:
qemu-system-x86_64 -drive format=raw,file=<your_binary_filename>.bin

Important

Upewnij się że zamieniłeś <nazwa_twojego_pliku_binarnego> na właściwą nazwę pliku który pobrałeś/zbudowałeś.

Uruchamianie na prawdziwym sprzęcie

Możesz również sflaszować plik binarny do swojego USB pedrive'a i uruchomić go na prawdziwej maszynie

Żeby to zrobić wykorzystaj następującą komende:

dd if=<your_binary_filename>.bin of=/dev/sdX && sync

Important

Upewnij się że zamieniłeś <nazwa_twojego_pliku_binarnego> na właściwą nazwę pliku który pobrałeś/zbudowałeś i upewnij się żeby zamienić /dev/sdX na numerem partycji z twojego USB. Wszelkie dane zostaną starocone!

Note

Możesz wybrać urządzenie bootujące z poziomu BIOS boot menu (dostępne poprzez klikanie F8 lub F12).

Sprawdź czy twoja płyta główna obsługuję bootowanie z starszych (legacy) nośników, gdyż HighlightOS nie jest jeszcze kompatybilny z UEFI.

Załączniki

Documentation

Status rozwoju

https://github.com/user-attachments/assets/663e8477-4275-411b-a39a-c12e54096ad8

Dodatkowe informacje

Czy wiedziałeś że mamy kanał IRC? Jest to '#highlightos' na libera.chat.

Lista wbudowanych komend i funkcji jest dostępna tutaj.
Po więcej informacji na temat HighlightOS, zapraszamy na nasze wiki.

Używanie prekompilowanych plików binarnych z sekcji kodu tego repo nie jest zalecane.

Współtwórcy

WIELKIE podziękowania każdemu współtwórcy:

Przypisy

Niektóre części kodu były inspirowane blog_os. Świetny projekt!

Polskie tłumaczenie: Sebaguardian

Copyright © 2025 Adam Perkowski