Implement Serial Port Output for Kernel Debugging

UART Debugging

Serial port COM1 (0x3F8) gives early kernel logs when VGA is not ready. 16550 UART needs divisor latch for baud rate, line control for frame format, and FIFO enable for fewer overruns.

Register Programming

Minimum init:

• Set DLAB, write divisor for 115200 baud
• Clear DLAB, set 8N1 line control
• Enable transmitter holding register empty interrupt optional

For example, divisor 1 at 1.8432 MHz base yields 115200 bps 8N1 output many bootloaders use.

Why This Matters in Production

The UART 16550 you're programming here is why qemu -serial stdio and real hardware debug cables both work identically , serial output is often the only way to debug a kernel before VGA or any other driver is initialized. Forgetting to poll the Line Status Register before sending a byte is a common bug that silently drops characters when the transmit buffer isn't actually empty yet.

Debugging Checklist

Before you call the implementation done, walk failure modes on purpose. Test empty structures, single-element edge cases, maximum concurrency, and errno paths that must not crash the program. OS code usually fails in production when happy-path tests pass but invariants break under contention or memory pressure.

Implementation Notes

Keep structures small and name fields after kernel counterparts when possible. That lets you read man pages and kernel source side by side while you work. Print observable events during development; remove noisy logs once tests pass reliably.

For This Exercise

You will implement serial_putc polling line status bit 0x20 (THRE). This exercise requires printing panic messages on serial when exceptions fire before VGA init.