Clarify multicore_fifo doxygen (#323)

Based on my observations in #284
This commit is contained in:
Andrew Scheller 2021-04-18 23:10:24 +01:00 committed by GitHub
parent b8dbbcf0d7
commit b17fc76c8f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -119,7 +119,7 @@ uint32_t multicore_fifo_pop_blocking(void);
bool multicore_fifo_pop_timeout_us(uint64_t timeout_us, uint32_t *out);
/*! \brief Flush any data in the outgoing FIFO
/*! \brief Flush any data in the incoming FIFO
* \ingroup multicore_fifo
*
*/
@ -130,9 +130,12 @@ static inline void multicore_fifo_drain(void) {
/*! \brief Clear FIFO interrupt
* \ingroup multicore_fifo
*
* Note that this only clears an interrupt that was caused by the ROE or WOF flags.
* To clear the VLD flag you need to use one of the 'pop' or 'drain' functions.
*/
static inline void multicore_fifo_clear_irq(void) {
// Write any value to clear any interrupts
// Write any value to clear the error flags
sio_hw->fifo_st = 0xff;
}