Ядро независимо
В переносимом слое нет заголовков 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Не копируйте исходники вручную: копия быстро расходится с источником и перестаёт получать исправления.
Библиотеки C99
Поиск работает по имени, интерфейсу и назначению. Метка «готовый порт» показывает уже реализованные платформы.
st7789
TFT ST7789V: окна, заливка, линии и текст без framebuffer.
Порт: SPI write, DC, delay; опционально CS, RESET, backlight.
keypad
Шесть кнопок: антидребезг, удержание, автоповтор и очередь событий.
Порт: чтение уровня и время в миллисекундах.
menu
Стек экранов, курсор, прокрутка и тема для динамического меню.
Порт: fill_rect и draw_text.
eeprom-ft24c256
EEPROM 24Cxx с нарезкой записи по страницам.
Порт: I²C write, write-read и delay.
can-sensor
Передача 64-битных ROM датчиков парой CAN-кадров.
Порт: CAN TX/RX.
ds18b20
1-Wire, CRC8, SEARCH ROM и несколько термометров.
Порт: Init, DelayUs, Reset, WriteBit, ReadBit.
protocan-transport
ProtoCAN над байтовым потоком: CRC16, ring, GAS и каталог GUI.
Порт: stream write и доступный объём TX.
protocan-boot
Прошивка по ProtoCAN: A/B-слоты, resume, CRC32, verify и rollback.
Порт: CAN TX, Flash, metadata, verify, reboot.
rs485-boot
SETGUI v1 firmware update: stream parser, CRC32 и resume.
Порт: UART TX/RX, DE и Flash.
set-protocol
SET v2: управление, телеметрия и прошивка через UART/CAN/USB/Ethernet.
Порт: доставка кадров, часы, карта и firmware backend.
rtc-service
RTC с резервным backup-томом и единым API времени.
Порт: RTC и backup storage.
Ничего не найдено.
protocan для Python
Хостовая сторона без Qt и pyserial: принимает и возвращает bytes, подходит GUI, скриптам и CI.
protocan.py
29-битный CAN ID и тела сообщений. Зеркало pcan_id.c.
transport.py
Кадр AA 55, stream parser, ресинхронизация и CRC16.
protocol + gas_catalog
Кадр A5 5A, CRC32, каталог и подписка на значения.
from protocan import protocan, transport
parser = transport.FrameParser()
for frame in parser.feed(port.read(256)):
print(protocan.decode(frame.can_id, frame.data).summary)Python 3.9+, только stdlib. Полное README.
Как портировать
Маршрут для STM32, K1921, другого MCU или host-окружения.
Выберите библиотеку
Найдите в README раздел «Что нужно от платформы» или «Контракт порта».
Подключите ядро
Добавьте переносимые src/ и include/. CMSIS/HAL и IRQ оставьте в проекте.
Проверьте готовый порт
DS18B20: F1/G4/F4; ProtoCAN transport: F4; RS-485 boot: F103/G474; RTC: K1921.
Реализуйте контракт
Создайте callbacks для I/O, времени или Flash. Контекст передавайте через void *.
Настройте плату
Распиновку, clocks и адреса храните в board/app_config.h или config библиотеки.
Проверьте
Сначала host-тесты, затем smoke-test платы, границы памяти и аппаратные тайминги.
Типовые контракты
| Класс | Реализует проект | Остаётся в ядре |
|---|---|---|
| Дисплей | SPI, GPIO, delay | команды, геометрия, текст |
| Датчик | GPIO/open-drain, delay | поиск, CRC, данные |
| Поток | UART/USB/TCP RX/TX | кадры, CRC, parser |
| Загрузчик | Flash, metadata, verify | сессия, resume, state machine |
USB/TCP chunks не равны границам кадров; CAN router не вызывают из ISR; RS-485 DE снимают после физического TC; firmware backend пишет в неактивный слот и имеет rollback.
Структура нового проекта
При смене MCU заменяются board/, port/, startup и linker script; приложение и ядра остаются.
my-device/
├── app/ логика изделия
├── board/app_config.h выводы, частоты, адреса
├── port/ адаптеры библиотек к SDK MCU
├── vendor/ CMSIS, startup, linker script
└── lib/templates/ git submodule
├── c/
└── python/Пример: DS18B20 на STM32G474
lib/templates/c/ds18b20/src/onewire.c
lib/templates/c/ds18b20/src/ds18b20.c
lib/templates/c/ds18b20/ports/stm32g4/onewire_stm32g4.c
board/onewire_config.hInclude paths: c/ds18b20/include и board. В конфигурации меняются GPIO, pin и clock.