name: hardware-integration-check version: 1.3.0 description: > Проверка использования GPIO, DMA, IRQ и таймеров перед генерацией или правкой HAL/LL-кода: сначала источник правды в docs/HW_IO_MAP.md, затем производный снимок docs/hsi/*, потом .ioc и код инициализации. Использовать при любом изменении аппаратных ресурсов; не использовать как общий skill для задач вне аппаратной области. tags: ["hardware", "stm32", "hal", "integration", "check"] project_context: "docs/PROJECT_CONTEXT.md" io_map: "docs/HW_IO_MAP.md" dma_map: "docs/hsi/HSI_DMA_MAP.md" safety_pins: "docs/HW_IO_MAP.md" when_to_use:

• "перед генерацией кода инициализации периферии (HAL_Init)"
• "при добавлении нового драйвера или модуля, работающего с железом"
• "при изменении настроек DMA, GPIO или таймеров" outputs:
• "Отчет о конфликтах [HARDWARE CONFLICT] или подтверждение корректности"

Skill: Hardware Integration Check

Миссия

Не допустить использования занятых ресурсов, неверной конфигурации периферии или нарушения схемы подключения. Код не должен противоречить документу-владельцу docs/HW_IO_MAP.md, файлу *.ioc и зафиксированным производным снимкам docs/hsi/*.

Чек-лист проверки

Перед написанием кода драйвера/HAL проверь следующее:

1. Pin Mux (GPIO)

• Источник правды: Сначала сверься с docs/HW_IO_MAP.md. Какая роль сигнала, полярность и статус факта (confirmed / provisional / TBD) уже зафиксированы?
• Конфликт пинов: Затем сверься с docs/hsi/HSI_IO_MAP.md. Совместим ли снимок pinmux с документом-владельцем?
• Режим (Mode): Соответствует ли запрошенный режим (Input/Output/AF) тому, что в таблице?
• Метка (Label): Используй #define или имя из таблицы (например, TIM1_BKIN, AD7606_BUSY), а не сырой PB10.

2. DMA & DMAMUX

• Конфликт каналов: Сверься с docs/hsi/HSI_DMA_MAP.md. Не занят ли канал другой периферией? (Для STM32G4 учитывай DMAMUX Request ID).
• Приоритет: Соответствует ли приоритет DMA требованиям модуля (High для АЦП/ШИМ, Low для UART/логов)?

3. NVIC (Прерывания)

• Safety/RT Priority: Если это fast_loop (PWM, ADC Watchdog) — приоритет должен быть наивысшим (0..4).
• RTOS Safe Priority: Если ISR вызывает FromISR API FreeRTOS — приоритет должен быть логически ниже (числом больше) или равен configMAX_SYSCALL_INTERRUPT_PRIORITY (обычно 5..15).
• Конфликт векторов: Не вешай два разных обработчика на один вектор (если они не делят его явно).

4. Safety Pins (Критично)

• BKIN/BKIN2/STO/SKYPER_ERRIN/PRIM_nERROR_IN: Любые манипуляции с этими safety-линиями из docs/HW_IO_MAP.md требуют особой осторожности. Проверь полярность, роль сигнала и то, является ли он базовым или вторичным путем запрета по docs/PROJECT_CONTEXT.md.
• Конфликт документа-владельца и снимка: Если docs/HW_IO_MAP.md, docs/hsi/*, .ioc и сгенерированный код инициализации расходятся, останови генерацию и потребуй синхронизации документа-владельца, .ioc и снимка.

Контракт ответа

Если обнаружен конфликт, ОСТАНОВИ ГЕНЕРАЦИЮ и выдай отчет:

⛔ [HARDWARE CONFLICT DETECTED]

• Resource: DMA1_Channel1
• Requested by: UART_RX
• Already used by: TIM3_UP (согласно HSI_DMA_MAP.md)
• Action: Выбери другой канал или обнови .ioc файл.

Если конфликтов нет — продолжай генерацию кода.