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

tools/dsview/decoders/gate_driver_timing/__init__.py

@@ -1,3 +1,7 @@
+# Точка обнаружения декодера gate_driver_timing в DSView/libsigrokdecode. Экспорт класса
+# Decoder из pd.py позволяет загрузчику зарегистрировать плагин; сам разбор потока выполняется
+# в модуле декодера.
+
 """DSView protocol decoder for SCALE gate-driver timing checks."""
 
 from .pd import Decoder

tools/dsview/decoders/gate_driver_timing/pd.py

@@ -1,3 +1,9 @@
+# Проверка временных характеристик драйвера затвора по цифровым фронтам. Параметры профилей
+# задаются в наносекундах; типичная задержка ACK используется для предупреждения, а
+# нормированная длительность импульса — для PASS/FAIL. Этот адаптер переводит события
+# libsigrokdecode в аннотации DSView; координаты выборок пересчитываются с учётом частоты
+# захвата.
+
 """DSView/libsigrokdecode front end for SCALE gate-driver timing checks."""
 
 import sigrokdecode as srd

tools/dsview/decoders/pm35_uart/__init__.py

@@ -1 +1,5 @@
+# Точка обнаружения декодера pm35_uart в DSView/libsigrokdecode. Экспорт класса Decoder из
+# pd.py позволяет загрузчику зарегистрировать плагин; сам разбор потока выполняется в модуле
+# декодера.
+
 from .pd import Decoder

tools/dsview/decoders/pm35_uart/pd.py

@@ -1,3 +1,8 @@
+# Декодирование UART-обмена ПМ35 с командами Modbus 03/06. Учитывается исторический ответ на
+# 128 слов с нулевым полем числа байтов; универсальный Modbus-parser без этого правила
+# потеряет границу сообщения. Этот адаптер переводит события libsigrokdecode в аннотации
+# DSView; координаты выборок пересчитываются с учётом частоты захвата.
+
 import sigrokdecode as srd
 from common.setgui_decoders.pm35_uart import PM35Parser
 

tools/dsview/decoders/set_can/__init__.py

@@ -1 +1,5 @@
+# Точка обнаружения декодера set_can в DSView/libsigrokdecode. Экспорт класса Decoder из pd.py
+# позволяет загрузчику зарегистрировать плагин; сам разбор потока выполняется в модуле
+# декодера.
+
 from .pd import Decoder

tools/dsview/decoders/set_can/pd.py

@@ -1,3 +1,8 @@
+# Сегментация SET v2 и интерпретация CAN-данных зависят от выбранного слоя. Адрес и номер
+# сегмента должны проверяться до объединения данных; classic CAN-пакет ограничен восемью
+# байтами. Этот адаптер переводит события libsigrokdecode в аннотации DSView; координаты
+# выборок пересчитываются с учётом частоты захвата.
+
 import sigrokdecode as srd
 from common.setgui_decoders.set_can import Reassembler, legacy
 

tools/dsview/decoders/set_uart/__init__.py

@@ -1 +1,5 @@
+# Точка обнаружения декодера set_uart в DSView/libsigrokdecode. Экспорт класса Decoder из
+# pd.py позволяет загрузчику зарегистрировать плагин; сам разбор потока выполняется в модуле
+# декодера.
+
 from .pd import Decoder

tools/dsview/decoders/set_uart/pd.py

@@ -1,3 +1,8 @@
+# Декодирование потоков UART протоколов SET по накопленным байтам. Поиск сигнатуры и проверка
+# сообщения должны переживать границу входного фрагмента; неверная контрольная сумма не
+# выдаётся как успешный пакет. Этот адаптер переводит события libsigrokdecode в аннотации
+# DSView; координаты выборок пересчитываются с учётом частоты захвата.
+
 import sigrokdecode as srd
 from common.setgui_decoders.set_uart import StreamParser
 

tools/dsview/decoders/transistor_pair/__init__.py

@@ -1 +1,5 @@
+# Точка обнаружения декодера transistor_pair в DSView/libsigrokdecode. Экспорт класса Decoder
+# из pd.py позволяет загрузчику зарегистрировать плагин; сам разбор потока выполняется в
+# модуле декодера.
+
 from .pd import Decoder

tools/dsview/decoders/transistor_pair/pd.py

@@ -1,3 +1,8 @@
+# Анализ двух комплементарных входов транзисторной пары. Совместное включение, паузы и
+# интервалы определяются только по этим входам; ACK/Vstat драйвера не участвуют в данной
+# модели. Этот адаптер переводит события libsigrokdecode в аннотации DSView; координаты
+# выборок пересчитываются с учётом частоты захвата.
+
 """Two-input transistor pair analyzer, independent of driver feedback."""
 import sigrokdecode as srd
 from common.setgui_decoders.transistor_pair import PairTimingChecker