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

c/gas-logger/ports/c28x/gas_logger_c28x.c

@@ -1,3 +1,9 @@
+/*
+ * Критические секции регистратора для TI C28x. При входе сохраняется прежнее состояние
+ * прерываний, при выходе восстанавливается именно оно: безусловное разрешение нарушило бы
+ * вложенную критическую секцию.
+ */
+
 #include "gas_logger_c28x.h"
 /* __disable_interrupts/__restore_interrupts are TI C28x compiler intrinsics. */
 uint32_t gl_c28x_enter(void *user) { (void)user; return __disable_interrupts(); }

c/gas-logger/ports/c28x/gas_logger_c28x.h

@@ -1,3 +1,9 @@
+/*
+ * Критические секции регистратора для TI C28x. При входе сохраняется прежнее состояние
+ * прерываний, при выходе восстанавливается именно оно: безусловное разрешение нарушило бы
+ * вложенную критическую секцию.
+ */
+
 #ifndef GAS_LOGGER_C28X_H
 #define GAS_LOGGER_C28X_H
 #include <stdint.h>

c/gas-logger/ports/pm35/gas_logger_pm35.c

@@ -1,3 +1,9 @@
+/*
+ * Связь регистратора ПМ35 с картой доступных сигналов. Адреса сигналов согласуются с
+ * JSON-картой клиента; изменение только одной стороны приводит к неверной интерпретации снимка
+ * даже при успешном обмене.
+ */
+
 #include "gas_logger_pm35.h"
 #include "pm35_map.h"
 static uint32_t enter(void *u) { gl_pm35_context *p=u; return p->enter(p->irq_user); }

c/gas-logger/ports/pm35/gas_logger_pm35.h

@@ -1,3 +1,9 @@
+/*
+ * Связь регистратора ПМ35 с картой доступных сигналов. Адреса сигналов согласуются с
+ * JSON-картой клиента; изменение только одной стороны приводит к неверной интерпретации снимка
+ * даже при успешном обмене.
+ */
+
 #ifndef GAS_LOGGER_PM35_H
 #define GAS_LOGGER_PM35_H
 #include "gas_logger.h"

c/gas-logger/ports/pm35/pm35_map.h

@@ -1,3 +1,9 @@
+/*
+ * Связь регистратора ПМ35 с картой доступных сигналов. Адреса сигналов согласуются с
+ * JSON-картой клиента; изменение только одной стороны приводит к неверной интерпретации снимка
+ * даже при успешном обмене.
+ */
+
 /* Generated from pm35.json. Do not edit. */
 #ifndef GL_PM35_MAP_H
 #define GL_PM35_MAP_H

c/gas-logger/ports/stm32/gas_logger_stm32.c

@@ -1,3 +1,9 @@
+/*
+ * Критические секции регистратора для STM32 через состояние маски прерываний. Сохранённое
+ * значение передаётся из входа в выход, чтобы не разрешить прерывания, уже запрещённые
+ * вызывающим кодом.
+ */
+
 #include "gas_logger_stm32.h"
 #ifndef GL_STM32_DEVICE_HEADER
 #define GL_STM32_DEVICE_HEADER "stm32f4xx.h"

c/gas-logger/ports/stm32/gas_logger_stm32.h

@@ -1,3 +1,9 @@
+/*
+ * Критические секции регистратора для STM32 через состояние маски прерываний. Сохранённое
+ * значение передаётся из входа в выход, чтобы не разрешить прерывания, уже запрещённые
+ * вызывающим кодом.
+ */
+
 #ifndef GAS_LOGGER_STM32_H
 #define GAS_LOGGER_STM32_H
 #include <stdint.h>