dma_channel_abort() function

Stop a DMA transfer Function will only return once the DMA has stopped. \if rp2040_specific RP2040 only: Note that due to errata RP2040-E13, aborting a channel which has transfers in-flight (i.e. an individual read has taken place but the corresponding write has not), the ABORT status bit will clear prematurely, and subsequently the in-flight transfers will trigger a completion interrupt once they complete. \endif The effect of this is that you \em may see a spurious completion interrupt on the channel as a result of calling this method. The calling code should be sure to ignore a completion IRQ as a result of this method. This may not require any additional work, as aborting a channel which may be about to complete, when you have a completion IRQ handler registered, is inherently race-prone, and so code is likely needed to disambiguate the two occurrences. If that is not the case, but you do have a channel completion IRQ handler registered, you can simply disable/re-enable the IRQ around the call to this method as shown by this code fragment (using DMA IRQ0). \code // disable the channel on IRQ0 dma_channel_set_irq0_enabled(channel, false); // abort the channel dma_channel_abort(channel); // clear the spurious IRQ (if there was one) dma_channel_acknowledge_irq0(channel); // re-enable the channel on IRQ0 dma_channel_set_irq0_enabled(channel, true); \endcode \if rp2350_specific RP2350 only: Due to errata RP12350-E5 (see the RP2350 datasheet for further detail), it is necessary to clear the enable bit of the aborted channel and any chained channels prior to the abort to prevent re-triggering. \endif