133 lines
4.7 KiB
Markdown
133 lines
4.7 KiB
Markdown
# Консоль и отладка
|
||
|
||
---
|
||
|
||
## TTY — PSF2 терминал
|
||
|
||
**Файл**: `src/tty.rs`
|
||
|
||
Шрифтовой терминал на основе PSF2 (PC Screen Font v2). Это **реально используемая консоль** в `kmain`.
|
||
|
||
### Psf2Header — `#[repr(C, packed)]`
|
||
|
||
```rust
|
||
struct Psf2Header {
|
||
magic: u32, // магическое число PSF2
|
||
version: u32,
|
||
header_size: u32,
|
||
flags: u32,
|
||
num_glyphs: u32, // количество глифов
|
||
bytes_per_glyph: u32,
|
||
height: u32, // высота шрифта в пикселях
|
||
width: u32, // ширина шрифта в пикселях
|
||
}
|
||
```
|
||
|
||
### Console
|
||
|
||
```rust
|
||
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
|
||
|
||
```rust
|
||
pub struct SerialPort(pub u16); // номер порта
|
||
```
|
||
|
||
### Инициализация UART (`init()`)
|
||
|
||
```rust
|
||
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
|
||
|
||
```rust
|
||
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]`) и доступны из любого модуля.
|