From 4b32cda46e7d38c9ce67969f747bf88dd9e1a136 Mon Sep 17 00:00:00 2001 From: Andrey Kruchinkin Date: Sun, 30 Aug 2026 03:44:36 +0300 Subject: [PATCH] docs: add HTML library catalog --- doc/index.html | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 doc/index.html diff --git a/doc/index.html b/doc/index.html new file mode 100644 index 0000000..140eba5 --- /dev/null +++ b/doc/index.html @@ -0,0 +1,45 @@ + + +Templates — переносимые библиотеки + +
Embedded library catalog

Переносимые библиотеки без привязки к плате

Единый справочник по репозиторию templates: назначение модулей, границы платформенного кода и практический маршрут переноса на новый микроконтроллер.

11библиотек C99
1Python-пакет
0обязательных HAL/OS
3.9+версия Python
+ +
+

О репозитории

Повторно используемый код прошивок и инструментов. Каждая библиотека подключается отдельно и хранит состояние у вызывающей стороны.

Ядро независимо

В переносимом слое нет заголовков MCU, HAL, регистров, IRQ, ОС и динамической памяти.

Порт узкий

SPI, GPIO, I²C, UART, CAN, Flash и часы передаются через callbacks или небольшой файл порта.

Подключение точечное

В сборку добавляются только исходники выбранной библиотеки, include-каталог и нужный порт.

Главное правило: распиновка, частоты шин и периферия принадлежат плате. Они остаются в board/ или port/, но не попадают в ядро.

Как добавить в проект

Для фиксируемой версии предпочтителен Git submodule:

git submodule add https://git.rd12.ru/Andrey/templates.git lib/templates
+git submodule update --init --recursive

Если изменения регулярно возвращаются в библиотеку, используйте subtree:

git subtree add --prefix lib/templates https://git.rd12.ru/Andrey/templates.git master --squash
+git subtree pull --prefix lib/templates https://git.rd12.ru/Andrey/templates.git master --squash
Не копируйте исходники вручную: копия быстро расходится с источником и перестаёт получать исправления.
+ + + + +
+