docs: добавь поясняющие комментарии к модулям и инструментам

2026-10-02 16:46:19 +03:00
parent 6cbce6c360
commit 427fc70100
488 changed files with 2877 additions and 1 deletions
@@ -1,3 +1,9 @@
+/*
+ * Аппаратная подготовка периферийного стенда STM32G474. Конфигурация GPIO и периферии
+ * относится к плате; сервисы регистров и протоколы подключаются поверх уже подготовленного
+ * оборудования.
+ */
+
 /**
 * Аппаратный порт STM32G474RB: векторы приложения, тактирование и GPIO.
 * Алгоритмы UMP/TMS/IGBT находятся в общем C-ядре templates; здесь только пины.
@@ -1,3 +1,9 @@
+/*
+ * Точка входа примера периферийного стенда STM32G474. Инициализация платы предшествует
+ * обслуживанию транспорта и сервисов; этот файл связывает переносимую библиотеку с жизненным
+ * циклом прошивки.
+ */
+
 /**
 * Точка входа прошивки. Здесь только порядок запуска и совместное обслуживание модулей.
 * Настройки оборудования находятся в board.c, обмен — в transport.c, генератор — в wave_hal.c.
@@ -1,3 +1,8 @@
+/*
+ * UART/USB-транспорт стенда STM32G474 для регистровых сервисов. Входные байты передаются
+ * обработчику общего протокола; аппаратные очереди и отправка ответа относятся к этому порту.
+ */
+
 /**
 * USART2/VCP и FDCAN1 в режиме Classic CAN. Формат запросов совпадает с F407:
 * UART RTU, CAN extended ID 0xBA0000+mode-1; ответы 0xBA0020+mode-1.
@@ -1,3 +1,9 @@
+/*
+ * Аппаратное воспроизведение таблицы сигналов на STM32G474. Таймер, ЦАП и DMA реализуют
+ * операции порта генератора; массив выборок должен оставаться доступным до полной остановки
+ * передачи.
+ */
+
 /**
 * Аппаратный исполнитель генератора: таблица uint16_t в SRAM -> DMA1 -> DAC1/PA4.
 * TIM6 задаёт частоту выборок аппаратными событиями TRGO; CPU не отправляет каждый отсчёт.