README-pl.md

HighlightOS

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

Spis treści

• Budowa ze źródła na Linuxie
• Uruchamianie w QEMU na Linuxie
• Uruchamianie na prawdziwym sprzęcie
• Załączniki
  • Status rozwoju
  • Dodatkowe informacje
  • Przypisy

Budowa ze źródła na Linuxie

Główny Kernel

Wymagania:

• System kontroli wersji Git
• Rust toolchain

Kroki:

1. Upewnij się że rustup jest zainstalowany:

rustup --version

2. Stwórz lokalną kopię repozytorium:

git clone [email protected]:adamperkowski/highlightos.git && cd highlightos

3. Użyj cd do folderu kernel/:

cd kernel

4. 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 [email protected]:adamperkowski/highlightos.git && cd highlightos

2. Użyj cd do folderu asm/:

cd asm

3. 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:

• QEMU (cały pakiet)
• Bootwalny plik binarny HighlightOS. Możesz takowy pobrać z wydań, albo zbudować własny.

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

Status rozwoju

2024-11-09_11-53-04.mp4

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

Copyright © 2024 Adam Perkowski