Skip to content

Commit 4789820

Browse files
LaurentiuM1234nashif
authored andcommitted
dma: remove isr-ok tag from channel request and release
The channel filter and release functions can be used by some DMA drivers to perform blocking operations (i.e: allocating, de-allocating channel resources). In such scenarios, the channel request and release functions become unsuitable for usage inside ISRs. Drop the `isr-ok` tag and add comments regarding this behavior being driver-dependent. Signed-off-by: Laurentiu Mihalcea <[email protected]>
1 parent 513aa78 commit 4789820

File tree

1 file changed

+6
-2
lines changed
  • include/zephyr/drivers

1 file changed

+6
-2
lines changed

include/zephyr/drivers/dma.h

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -553,7 +553,9 @@ static inline int z_impl_dma_resume(const struct device *dev, uint32_t channel)
553553
* request DMA channel resources
554554
* return -EINVAL if there is no valid channel available.
555555
*
556-
* @funcprops \isr_ok
556+
* @note It is safe to use this function in contexts where blocking
557+
* is not allowed, e.g. ISR, provided the implementation of the filter
558+
* function does not block.
557559
*
558560
* @param dev Pointer to the device structure for the driver instance.
559561
* @param filter_param filter function parameter
@@ -598,7 +600,9 @@ static inline int z_impl_dma_request_channel(const struct device *dev,
598600
*
599601
* release DMA channel resources
600602
*
601-
* @funcprops \isr_ok
603+
* @note It is safe to use this function in contexts where blocking
604+
* is not allowed, e.g. ISR, provided the implementation of the release
605+
* function does not block.
602606
*
603607
* @param dev Pointer to the device structure for the driver instance.
604608
* @param channel channel number

0 commit comments

Comments
 (0)