stm32_timers_dma_burst_read(9)

💅 stm32_timers_dma_burst_read(9) — the kernel API manual, bestie edition 🎀

okay so this is a page from the Kernel API Manual (yes, that manual) and it's about stm32_timers_dma_burst_read, which is literally the function you call when you want the STM32 timers to spill their register tea straight into memory via DMA. no CPU babysitting, no cap. ✨

---

🌸 NAME 🌸

stm32_timers_dma_burst_read — Read from timers registers using DMA. 💖

like, that's it, that's the whole vibe: DMA reads the timer registers for you.

---

🦋 SYNOPSIS 🦋

int stm32_timers_dma_burst_read (struct device *dev , u32 *buf , enum
       stm32_timers_dmas id , u32 reg , unsigned int num_reg , unsigned int
       bursts , unsigned long tmo_ms );

she takes seven arguments and returns an int. main character energy, honestly. 👑

---

✨ ARGUMENTS ✨

• dev — reference to the stm32_timers MFD device. like, the parent device, the one who actually knows the timers. 🫶
• buf — the DMA'able destination buffer. key word DMA'able — it has to be memory the DMA engine can actually touch, so don't be cute and pass it something random. 🙈
• id — the stm32_timers_dmas event identifier. the options are ch[1..4], up, trig or com. pick your fighter. 💅
• reg — the registers start offset for DMA to read from (like CCRx for capture). aka where the reading starts. 📍
• num_reg — number of registers to read upon each DMA request, starting at reg. so it's a stretch, not a single. 🌈
• bursts — number of bursts to read (e.g. like two for pwm period capture). yes, bursts plural, she's greedy in the best way. 🔥
• tmo_ms — timeout, in milliseconds. the "girl wrap it up" timer. ⏰

---

💜 DESCRIPTION 💜

Read from STM32 timers registers using DMA on a single event. 🎀

that's the whole bit — one event fires, DMA goes and scoops up the register values into your buffer, and you get to keep your CPU cycles for yourself. slay.

ngl the manpage keeps this section short, so I'm not gonna invent lore. it's one event, it's DMA, it reads registers. periodt. 💀

---

🔍 SEE ALSO 🔍

• Kernel file ./drivers/mfd/stm32-timers.c — go read the source, bestie, that's where all the lore lives. 📖

---

and that's the page!! 💖 source lives under ./drivers/mfd, and the version/date stamp says October 2026 — so yeah, this manual is from the future, iykyk. 🧚 ⭐ 🌸

stm32_timers_dma_burst_read(9) — fly high, DMA queen. 🦋👑