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

c/parallel-nand/include/parallel_nand.h

@@ -1,3 +1,9 @@
+/*
+ * Команды параллельной NAND x8: идентификация, чтение, программирование, стирание и проверка
+ * bad-block marker. Геометрия страницы и блока определяется профилем микросхемы; операции
+ * записи требуют корректного управления WP#.
+ */
+
 #ifndef PARALLEL_NAND_H
 #define PARALLEL_NAND_H
 

c/parallel-nand/include/parallel_nand_gas.h

@@ -1,3 +1,8 @@
+/*
+ * Банковое окно доступа к NAND через регистры GAS. Пары октетов упаковываются в слова явно;
+ * переключение банка задаёт видимую область памяти и не меняет физическую геометрию NAND.
+ */
+
 #ifndef PARALLEL_NAND_GAS_H
 #define PARALLEL_NAND_GAS_H
 

c/parallel-nand/include/parallel_nand_pcan_gas.h

@@ -1,3 +1,8 @@
+/*
+ * Связка окна NAND с сервером ProtoCAN GAS. Относительные адреса региона и результаты операций
+ * переводятся в контракт GAS, а выполнение команд памяти остаётся в parallel_nand_gas.
+ */
+
 #ifndef PARALLEL_NAND_PCAN_GAS_H
 #define PARALLEL_NAND_PCAN_GAS_H
 

c/parallel-nand/include/parallel_nand_port.h

@@ -1,3 +1,9 @@
+/*
+ * Контракт аппаратного доступа к NAND: команды, адреса, данные и ожидание готовности. Один
+ * octet хранится в целом типе, чтобы восемь значащих бит оставались переносимыми на C28x с
+ * 16-битным char.
+ */
+
 #ifndef PARALLEL_NAND_PORT_H
 #define PARALLEL_NAND_PORT_H