Elyz/kernel/docs/console.md

Консоль и отладка

---

TTY — PSF2 терминал

Файл: src/tty.rs

Шрифтовой терминал на основе PSF2 (PC Screen Font v2). Это реально используемая консоль в kmain.

Psf2Header — #[repr(C, packed)]

struct Psf2Header {
    magic: u32,          // магическое число PSF2
    version: u32,
    header_size: u32,
    flags: u32,
    num_glyphs: u32,     // количество глифов
    bytes_per_glyph: u32,
    height: u32,         // высота шрифта в пикселях
    width: u32,          // ширина шрифта в пикселях
}

Console

pub struct Console<'a> {
    framebuffer: &'a Framebuffer<'a>,
    font: &'static [u8],     // сырые данные PSF2
    x: usize,                // курсор X (в пикселях)
    y: usize,                // курсор Y (в пикселях)
    fg_color: u32,           // цвет текста (0xFFFFFF = белый)
    bg_color: u32,           // цвет фона (0x000000 = чёрный)
}

Методы

Метод	Описание
new(framebuffer, font)	Создаёт консоль, курсор в (0,0)
set_color(fg)	Устанавливает цвет текста
clear()	Зануляет фреймбуфер, сбрасывает курсор
header()	Возвращает ссылку на Psf2Header
scroll()	Сдвигает фреймбуфер на высоту шрифта, зануляет низ
draw_glyph(glyph_index, x, y)	Рисует глиф: сканирует bitmap шрифта, пишет fg_color для установленных битов
write_char(c)	Обрабатывает \n, word wrap, поиск глифа (0 для отсутствующих), скролл
write_str(s)	Реализация fmt::Write — итерация по символам

draw_glyph — ключевой метод: строки шрифта — это побитовое представление, каждый бит — один пиксель. Если бит установлен → пишется fg_color, иначе пропускается.

---

Serial — последовательный порт

Файл: src/debug/serial.rs

Драйвер UART 16550 на COM1.

SerialPort

pub struct SerialPort(pub u16);  // номер порта

Инициализация UART (init())

port + 1 = 0x00   // отключение прерываний
port + 3 = 0x80   // DLAB = 1 (доступ к делителю)
port + 0 = 0x03   // делитель младший байт (~38400 бод)
port + 1 = 0x00   // делитель старший байт
port + 3 = 0x03   // 8N1: 8 бит, no parity, 1 stop bit
port + 2 = 0xC7   // FIFO enable, clear, 14-byte threshold
port + 4 = 0x0B   // DTR + RTS (data terminal ready)

Методы

Метод	Описание
is_transmit_empty() -> bool	Проверка бита 5 Line Status Register
send(data: u8)	Ждёт is_transmit_empty(), затем пишет в порт
write_str(s) (fmt::Write)	Поcимвольная отправка

Функции

Функция	Описание
init_global()	Инициализирует COM1, сохраняет в SERIAL_PORT
write_global(args: Arguments)	Пишет форматированную строку в serial
outb(port, val)	unsafe: инструкция out (write I/O port)
inb(port) -> u8	unsafe: инструкция in (read I/O port)

---

Логирование

Файл: src/debug.rs

LogLevel

pub enum LogLevel {
    Info,   // зелёный:  ANSI \x1b[32m, RGB 0x00FF00
    Warn,   // жёлтый:   ANSI \x1b[33m, RGB 0xFFFF00
    Error,  // красный:  ANSI \x1b[31m, RGB 0xFF0000
}

Макросы

log!(console, level, module, $($arg)*)

Формат: [ LOG ] <module> | <message>\n

Двойной вывод:

• Console: цветной [ LOG ] (по LogLevel) + белый <module> | <message>
• Serial: ANSI-цветной [ LOG ] + <module> | <message> + ANSI reset

info!(console, module, ...)

Обёртка над log! с LogLevel::Info. Зелёный [ LOG ].

warn!(console, module, ...)

Обёртка над log! с LogLevel::Warn. Жёлтый [ LOG ].

error!(console, module, ...)

Обёртка над log! с LogLevel::Error. Красный [ LOG ].

Все макросы экспортируются (#[macro_export]) и доступны из любого модуля.