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

c/parallel-nand/ports/stm32f103rc/parallel_nand_port_stm32f103rc.c

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32F103RC через программное управление GPIO: на этом корпусе нет доступного
+ * FSMC. Передача команды, адреса и данных использует разные управляющие линии; WP# должен
+ * разрешать запись только по контракту порта.
+ */
+
 #include "parallel_nand_port_stm32f103rc.h"
 #include "stm32f1xx_hal.h"
 

c/parallel-nand/ports/stm32f103rc/parallel_nand_port_stm32f103rc.h

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32F103RC через программное управление GPIO: на этом корпусе нет доступного
+ * FSMC. Передача команды, адреса и данных использует разные управляющие линии; WP# должен
+ * разрешать запись только по контракту порта.
+ */
+
 #ifndef PARALLEL_NAND_PORT_STM32F103RC_H
 #define PARALLEL_NAND_PORT_STM32F103RC_H
 

c/parallel-nand/ports/stm32f103ze/parallel_nand_port_stm32f103ze.c

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32F103ZE через FSMC NAND Bank 3. Отдельные окна команды, адреса и данных
+ * отображаются в пространство процессора; их адреса относятся к шине FSMC, а не к физической
+ * странице NAND.
+ */
+
 #include "parallel_nand_port_stm32f103ze.h"
 
 #include "stm32f1xx_hal.h"

c/parallel-nand/ports/stm32f103ze/parallel_nand_port_stm32f103ze.h

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32F103ZE через FSMC NAND Bank 3. Отдельные окна команды, адреса и данных
+ * отображаются в пространство процессора; их адреса относятся к шине FSMC, а не к физической
+ * странице NAND.
+ */
+
 #ifndef PARALLEL_NAND_PORT_STM32F103ZE_H
 #define PARALLEL_NAND_PORT_STM32F103ZE_H
 

c/parallel-nand/ports/stm32f407ve/parallel_nand_port_stm32f407ve.c

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32F407VE через FSMC Bank 2. Область данных начинается с 0x70000000, а
+ * управляющие адресные биты выбирают команду и адрес; геометрией памяти управляет переносимое
+ * ядро.
+ */
+
 #include "parallel_nand_port_stm32f407ve.h"
 #include "stm32f4xx_hal.h"
 #include "stm32f4xx_hal_nand.h"

c/parallel-nand/ports/stm32f407ve/parallel_nand_port_stm32f407ve.h

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32F407VE через FSMC Bank 2. Область данных начинается с 0x70000000, а
+ * управляющие адресные биты выбирают команду и адрес; геометрией памяти управляет переносимое
+ * ядро.
+ */
+
 #ifndef PARALLEL_NAND_PORT_STM32F407VE_H
 #define PARALLEL_NAND_PORT_STM32F407VE_H
 

c/parallel-nand/ports/stm32g474ce/parallel_nand_port_stm32g474ce.c

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32G474CE через GPIO, где PB0..PB7 образуют шину данных. Порт формирует
+ * управляющие импульсы программно; переключение направления данных необходимо для чтения и
+ * записи одной двунаправленной шиной.
+ */
+
 #include "parallel_nand_port_stm32g474ce.h"
 #include "stm32g4xx_hal.h"
 

c/parallel-nand/ports/stm32g474ce/parallel_nand_port_stm32g474ce.h

@@ -1,3 +1,9 @@
+/*
+ * NAND x8 на STM32G474CE через GPIO, где PB0..PB7 образуют шину данных. Порт формирует
+ * управляющие импульсы программно; переключение направления данных необходимо для чтения и
+ * записи одной двунаправленной шиной.
+ */
+
 #ifndef PARALLEL_NAND_PORT_STM32G474CE_H
 #define PARALLEL_NAND_PORT_STM32G474CE_H
 

c/parallel-nand/ports/tms320f2812/parallel_nand_port_tms320f2812.c

@@ -1,3 +1,8 @@
+/*
+ * NAND через XINTF TMS320F2812 с адресными линиями XA0/XA1 для CLE/ALE. Адреса C28x измеряются
+ * 16-битными словами, но полезные данные NAND остаются восьмибитными октетами.
+ */
+
 #include "parallel_nand_port_tms320f2812.h"
 #include "DSP281x_Device.h"
 

c/parallel-nand/ports/tms320f2812/parallel_nand_port_tms320f2812.h

@@ -1,3 +1,8 @@
+/*
+ * NAND через XINTF TMS320F2812 с адресными линиями XA0/XA1 для CLE/ALE. Адреса C28x измеряются
+ * 16-битными словами, но полезные данные NAND остаются восьмибитными октетами.
+ */
+
 #ifndef PARALLEL_NAND_PORT_TMS320F2812_H
 #define PARALLEL_NAND_PORT_TMS320F2812_H