2939387245/agent-skill_stm32-freertos

Overview

This skill is an STM32 + FreeRTOS embedded development expert for Cortex-M microcontrollers. It helps you design, implement, and debug real-time firmware using native FreeRTOS v10+ or CMSIS-RTOS v2 APIs. The skill covers tasks, queues, semaphores, drivers, low-power tickless mode, and trace-based debugging tools.

How this skill works

The skill inspects your request and selectively reads only the relevant reference or example modules to generate focused guidance or code snippets. It can produce task and IPC templates, HAL driver skeletons (UART/DMA, ADC, I2C, TIM), FreeRTOSConfig checks, and step-by-step debug instructions. For problem diagnosis it follows targeted patterns for interrupts, deadlocks, stack overflows, and priority issues.

When to use it

• Creating tasks, queues, semaphores, mutexes, event groups, or task notifications
• Implementing or adapting HAL drivers with DMA or interrupt-based flows
• Configuring low-power Tickless modes or STM32CubeMX project settings
• Reviewing and fixing deadlocks, priority inversion, and FromISR misuse
• Setting up SEGGER SystemView or Percep TRACEalyzer traces for runtime analysis
• Preparing production-ready builds with static allocation and stack checks

Best practices

• Prefer static allocation (xTaskCreateStatic) to avoid heap fragmentation
• Use task notifications for lightweight signaling and queues for data transfer
• Never block in ISRs; use FromISR APIs and portYIELD_FROM_ISR when needed
• Enable configASSERT and stack overflow checks in FreeRTOSConfig.h
• Estimate stack sizes using uxTaskGetStackHighWaterMark and test under load
• Keep HAL callbacks minimal and hand off work to tasks via queues or notifications

Example use cases

• Generate a UART DMA receive pipeline with IDLE detection and queue-based processing
• Create producer-consumer tasks using a queue and item ownership semantics
• Implement low-power sleep with tickless idle and wakeup from EXTI or RTC
• Review an interrupt-to-task handoff and fix incorrect FromISR usage
• Produce FreeRTOSConfig.h validation output via the provided freertos_config_check.py script