NATALIZIOFIR_32

NATALIZIOFIR_32 è il firmware/bootloader custom per il sistema operativo NATALIZIOOS. Supporta sia Legacy BIOS sia un percorso UEFI-style (NatalizioPkg), tutto codice originale in assembly (NASM), senza dipendenze TianoCore/EDK II.

• Target: IA-32 (solo 32-bit al momento)
• Partizionamento: Hybrid (Protective MBR + GPT)
• Filesystem: FAT16 (OS.BIN + BOOT.EFI)
• Test: QEMU su WSL
• Policy: Legacy BIOS non deprecato — dual-path first-class
• SFU: capsule NFUP (UPDATE / ROLLBACK / USB)
• i18n: EN · IT · ES · DE
• Linea corrente: v6.10 (Diagnostic Suite F10 + Diag Text F9; firmware-only)

  [Power On]
       │
       ▼
  Stage1 (MBR 0xEE) ──► Stage2 @ 0x8000 (128 settori da LBA 34)
       │
       ├─ DS/ES/SS=CS, text mode (v5.10)
       ├─ load_config (LBA 161)  [verbose, choice, timeout, PIN, SFU status, lang]
       ├─ gui_init (VBE se GUI e non TEXT)
       ├─ show_splash (countdown / F2 / F8 / Enter)  [testi i18n]
       │     ├─ F2 → Form Browser (HII Setup)
       │     ├─ F8 → Boot Menu rapido
       │     └─ Enter / timeout → boot
       ├─ install_legacy_bios (IVT)
       ├─ parse GPT + FAT16
       └─ boot_choice → OS.BIN | BOOT.EFI | Halt

Settore LBA 161, magic little-endian NF32 (0x3233464E).

Offset	Campo	Valori
0–3	Magic	NF32
4	Version	config layout ver
5	boot_verbose	0=GUI, 1=TEXT POST
6	boot_choice	0=OS.BIN, 1=BOOT.EFI, …
7	boot_timeout	0–9 secondi (0=wait forever)
8–9	PIN (XOR-obfuscated)	chiave 0x5C (v4.10)
10	setup_pin_en	0/1
11	sfu_last_result	0=none, 1=OK, 2=FAIL
12	sfu_last_slot	0=UPDATE, 1=ROLLBACK, 2=USB
13–14	sfu_last_ver	es. 0x0401
15	ui_lang	0=EN, 1=IT, 2=ES, 3=DE

Capsule NFUP (magic 0x5055464E). Header 512 byte + payload Stage2. Apply scrive su LBA 34 (Stage2) settore per settore con barra di progresso, poi reboot.

Sorgente	Dove	Note
Update firmware prototype	LBA 70 = UPDATE · LBA 107 = ROLLBACK	Voci separate in Setup → Update
Update from USB	Disco BIOS 0x81, CAP a LBA 0	make run-usb

• Checksum header su payload[0..15] (path RAM)
• Fallback: se CAP non in RAM → lettura da disco (v4.9)
• Dopo flash: stato salvato in config (Main: Last SFU)
• UPDATE e ROLLBACK devono essere visibilmente diversi (stringhe versione patchate a lunghezza uguale)

In tab Main / Lang: E=English · I=Italiano · S=Español · D=Deutsch. Persistente su LBA 161.

Localizzati: titoli SFU, voci Update, warning flash, hint splash (F2 / INVIO), tab Setup, News.

Layout disco rilevante (v4.x / v5.x firmware-only)

LBA	Contenuto
0	Protective MBR
1	GPT Header
2–33	Partition entries
34+	Stage2 (target flash SFU)
70	UPDATE.CAP (prototype)
107	ROLLBACK.CAP (prototype)
161	Config NF32
162+	Volume FAT16 (OS.BIN, BOOT.EFI, …)
~1800 / ~1900	CAP raw (build recenti SFU)
~2000	Log ring NFLOG (v5.x se abilitato)

Setup Main (v4.10+) — campi visualizzati

• Firmware Version / Architecture / Legacy ACTIVE / UEFI ACTIVE
• System Time / System Date (RTC BCD)
• CPU Vendor (CPUID)
• Last SFU : OK/FAIL UPDATE|ROLLBACK|USB
• Language: English|Italiano|Espanol|Deutsch
• Boot options, Display G/T, timeout

Tab Setup (linea 5.x)

Main | Adv | Boot | Sec | Lang | Update | Debug | Diag | News | Exit

• Debug: console, POST/CPUID/memoria, CMOS-RTC, serial, dump live
• Adv: quiet/debug/log/legacy e altre opzioni avanzate
• News: changelog build (separata da Diag)

v5.10 — dettaglio fix stabilità

• All’ingresso Stage2: cli, DS=ES=SS=CS, SP=0x7C00, sti
• Mode VGA testo 03h + messaggio NATALIZIOFIR Stage2 v5.10 sempre stampato
• Se TEXT verbose: skip VBE; altrimenti gui_init solo se path GUI ok
• Prima del Protected Mode: di nuovo mode 03h (OS.BIN su B8000)
• Makefile: run-wsl / run-usb-wsl al posto di target run duplicati
• Niente Linux PE nel firmware (esperimento archiviato a parte)

Introdotto nella serie 6.x. Due percorsi separati:

Tasto	Quando	Cosa
F9	Solo splash TEXT	Diagnostic Text (menu in-process, legacy/f9_launch.asm)
F10	Solo splash GUI	Diagnostic Suite binary @ LBA 3000 (trampoline → 0:8000)

• Suite shipping: v0.4 (legacy/diag_suite.bin, 32 KB)
• Trampoline: load LBA 3000 → 0x2000:0, copia a 0:8000, DS=ES=SS=0, SP=0x7C00
• Menu: CPU / MEMORY / STORAGE / DISPLAY / BOOT / SETTINGS + TOOLS (sysinfo, about, SFU, SMART, HALT, REBOOT)
• F9 su splash GUI è ignorato; F10 su splash TEXT fa fallback al menu text

Layout disco aggiunto in v6.x

LBA	Contenuto
3000	Diagnostic Suite binary (32 KB, v0.4)

Il resto del layout (MBR/GPT/Stage2@34/config@161/FAT/CAP) resta come in v4.x–v5.x.

unzip -o NATALIZIOFIR_32-v6.10.zip
cd NATALIZIOFIR_32
make clean && make && make run

# Log atteso:
#   F10 Diagnostic Suite : LBA 3000 (32768 bytes)
#   Image OK (v6.10 + Diagnostic Suite)

# QEMU tipico
qemu-system-i386 -m 64 -vga std \
  -drive format=raw,file=build/nataliziofir.img

• ESC dalla Suite → soft return al firmware
• GUI splash: countdown/stelle senza GDT thrash
• GUI splash grafica affidabile (LFB/BMP) senza regressioni
• HII: IFR/VFR parser reale
• Secure Boot stub / firma capsule
• Altre lingue (FR, PT, …)
• Track 64-bit NATALIZIOFIR_64 (futuro)
• Integrazione kernel NATALIZIOOS
• Linux PE: chiuso come esperimento (solo archivio separato se presente)