rp_pico_display_engine/docs/display.c.ru.md

display.c — актуальное описание (без display_poll)

Коротко

Модуль управляет выводом кадров на ST7789 через DMA и работает в двух режимах:

• DISPLAY_MODE_SAFE — безопасная буферизация, с новым контрактом begin/end paint.
• DISPLAY_MODE_RAW — ручное управление буферами и отправкой.

Механизм display_poll() и callback завершения кадра удалён.

Новый paint-контракт

display_begin_paint_try()

• Неблокирующе пытается начать рисование нового кадра.
• Возвращает NULL, если буфер недоступен или paint уже начат.

display_begin_paint_blocking()

• Блокирующе ждёт доступный буфер и начинает paint-секцию.

display_end_paint()

• Завершает paint-секцию и отправляет кадр в вывод.
• Возвращает false, если нарушен порядок вызовов (end без begin) или DMA занят.

SAFE и RAW

SAFE

• Обычно используется begin/end paint.
• Движок сам держит корректный порядок отправки.

RAW

• Для ручного контроля в RAW используется тот же begin/end-контракт, а swap выполняется явно:
  • display_begin_paint_try() / display_begin_paint_blocking()
  • display_swap_buffers()
  • display_end_paint()

Что делает IRQ

display_dma_irq_handler():

1. Сбрасывает IRQ-флаг DMA.
2. Завершает SPI-транзакцию (поднимает CS).
3. Снимает флаг dma_busy.

Никакой callback из основного цикла больше не нужен.

Рекомендуемый цикл 50 Гц

if (frame_tick_due) {
    frame_tick_due = false;

    uint16_t* buf = display_begin_paint_try();
    if (buf) {
        // draw
        bool ok = display_end_paint();
        hard_assert(ok);
    }
}

Инварианты

1. После успешного begin обязательно вызвать display_end_paint().
2. Нельзя начинать второй paint, пока первый не завершён.
3. Нельзя вызывать ручной display_submit() внутри открытой paint-секции.