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

2026-10-02 16:45:50 +03:00
parent 6cbce6c360
commit 427fc70100
488 changed files with 2877 additions and 1 deletions
--- a/c/rtc-service/rtc_service.h
+++ b/c/rtc-service/rtc_service.h
@@ -1,3 +1,9 @@
+/*
+ * Единое представление календарного времени и логика RTC с резервированием. Проверка полей
+ * календаря отделена от регистров часов и backup-памяти; аппаратные операции выполняются через
+ * контракт rtc_service_port.
+ */
+
 /**
  ****************************************************************************
  * @file    rtc_service.h
--- a/c/rtc-service/rtc_service_core.c
+++ b/c/rtc-service/rtc_service_core.c
@@ -1,3 +1,9 @@
+/*
+ * Единое представление календарного времени и логика RTC с резервированием. Проверка полей
+ * календаря отделена от регистров часов и backup-памяти; аппаратные операции выполняются через
+ * контракт rtc_service_port.
+ */
+
 /**
  ****************************************************************************
  * @file    rtc_service_core.c
--- a/c/rtc-service/rtc_service_port.h
+++ b/c/rtc-service/rtc_service_port.h
@@ -1,3 +1,9 @@
+/*
+ * Граница между календарной логикой и аппаратными RTC/backup-регистрами. Порт предоставляет
+ * операции чтения и записи, благодаря чему ядро сервиса можно использовать с другим
+ * контроллером без изменения правил проверки времени.
+ */
+
 /**
  ****************************************************************************
  * @file    rtc_service_port.h
--- a/c/rtc-service/rtc_service_port_k1921vk028.c
+++ b/c/rtc-service/rtc_service_port_k1921vk028.c
@@ -1,3 +1,9 @@
+/*
+ * Аппаратный порт RTC и backup-памяти K1921VK028 через plib028. Доступная реализация принимает
+ * выбор источника AUTO; запросы принудительного LSE/LSI возвращают неподдерживаемый режим, а
+ * не молча выбирают другой источник.
+ */
+
 /**
  ****************************************************************************
  * @file    rtc_service_port_k1921vk028.c
--- a/c/rtc-service/rtc_service_types.h
+++ b/c/rtc-service/rtc_service_types.h
@@ -1,3 +1,9 @@
+/*
+ * Единое представление календарного времени и логика RTC с резервированием. Проверка полей
+ * календаря отделена от регистров часов и backup-памяти; аппаратные операции выполняются через
+ * контракт rtc_service_port.
+ */
+
 /**
  ****************************************************************************
  * @file    rtc_service_types.h