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

c/ds18b20/ports/stm32f1/onewire_config.f103.template.h

@@ -1,3 +1,9 @@
+/*
+ * Конфигурация ds18b20 для порта stm32f1. Макросы задают параметры сборки и ограничения,
+ * используемые исходниками этого модуля. Это образец для проекта: значения выводов, размеров
+ * памяти и параметров устройства необходимо согласовать с целевой платой.
+ */
+
 /**
  * @file onewire_config.f103.template.h
  * @brief Шаблон привязки шины 1-Wire для STM32F103 (порт stm32f1).

c/ds18b20/ports/stm32f1/onewire_stm32f1.c

@@ -1,3 +1,9 @@
+/*
+ * Аппаратные временные слоты 1-Wire на STM32F1: управление линией, чтение уровня и
+ * микросекундные задержки. Конфигурация выбирает GPIO и таймер; общий алгоритм поиска ROM
+ * остаётся в onewire.c.
+ */
+
 /**
  * @file onewire_stm32f1.c
  * @brief Порт шины 1-Wire на STM32F1: тайминги, вывод и задержки.

c/ds18b20/ports/stm32f4/onewire_config.f407.template.h

@@ -1,3 +1,9 @@
+/*
+ * Конфигурация ds18b20 для порта stm32f4. Макросы задают параметры сборки и ограничения,
+ * используемые исходниками этого модуля. Это образец для проекта: значения выводов, размеров
+ * памяти и параметров устройства необходимо согласовать с целевой платой.
+ */
+
 /**
  * @file onewire_config.f407.template.h
  * @brief Шаблон привязки шины 1-Wire для STM32F407VET6 (порт stm32f4).

c/ds18b20/ports/stm32f4/onewire_stm32f4.c

@@ -1,3 +1,9 @@
+/*
+ * Аппаратные временные слоты 1-Wire на STM32F4 с открытым стоком. Порт использует
+ * CMSIS-регистры и параметры onewire_config.h; частота таймера должна соответствовать расчёту
+ * задержек при обмене с датчиками.
+ */
+
 /**
  * @file onewire_stm32f4.c
  * @brief Порт шины 1-Wire на STM32F4: тайминги, вывод и задержки.

c/ds18b20/ports/stm32g4/onewire_config.g431.template.h

@@ -1,3 +1,9 @@
+/*
+ * Конфигурация ds18b20 для порта stm32g4. Макросы задают параметры сборки и ограничения,
+ * используемые исходниками этого модуля. Это образец для проекта: значения выводов, размеров
+ * памяти и параметров устройства необходимо согласовать с целевой платой.
+ */
+
 /**
  * @file onewire_config.g431.template.h
  * @brief Шаблон привязки шины 1-Wire для STM32G431 (порт stm32g4).

c/ds18b20/ports/stm32g4/onewire_config.g474.template.h

@@ -1,3 +1,9 @@
+/*
+ * Конфигурация ds18b20 для порта stm32g4. Макросы задают параметры сборки и ограничения,
+ * используемые исходниками этого модуля. Это образец для проекта: значения выводов, размеров
+ * памяти и параметров устройства необходимо согласовать с целевой платой.
+ */
+
 /**
  * @file onewire_config.g474.template.h
  * @brief Шаблон привязки шины 1-Wire для STM32G474 (порт stm32g4).

c/ds18b20/ports/stm32g4/onewire_stm32g4.c

@@ -1,3 +1,9 @@
+/*
+ * Аппаратные временные слоты 1-Wire для STM32G431/G474. GPIO и таймер задаются конфигурацией
+ * проекта; чтение уровня выполняется с линии, поэтому паразитное питание и подтяжка относятся
+ * к схеме платы.
+ */
+
 /**
  * @file onewire_stm32g4.c
  * @brief Порт шины 1-Wire на STM32G4: тайминги, вывод и задержки.