IRQ

IRQ (Interrupt Request) commands for PIO state machines. These are PIO assembler instructions used to control interrupt flags for synchronization between state machines or signaling the main processor.

IRQ Control Instructions

IRQ SET params

Sets an interrupt flag in the PIO state machine. This is a PIO assembler instruction used within PIO programs to control interrupt signaling between state machines or to the main processor.

Parameters:

  • params: Interrupt number and optional modifiers (0-7 for PIO interrupts)

Context: Used in PIO assembler programs to set interrupt flags. PIO interrupts can be used for synchronization between multiple state machines or to signal the main processor.

Cross-reference: See F_the_pio_programming_package.md for PIO programming details and using_the_io_pins.md for general interrupt concepts.

IRQ WAIT params

Waits for an interrupt flag to be set in the PIO state machine. This instruction stalls the state machine until the specified interrupt condition is met.

Parameters:

  • params: Interrupt number to wait for (0-7 for PIO interrupts)

Context: Used in PIO assembler programs to synchronize state machine execution with interrupt events. The state machine will pause until the specified interrupt flag is set.

Cross-reference: See F_the_pio_programming_package.md for PIO programming details and using_the_io_pins.md for general interrupt concepts.

IRQ CLEAR params

Clears (resets) an interrupt flag in the PIO state machine. This instruction resets the specified interrupt flag to its inactive state.

Parameters:

  • params: Interrupt number to clear (0-7 for PIO interrupts)

Context: Used in PIO assembler programs to reset interrupt flags after they have been processed. This prevents the interrupt from remaining active indefinitely.

Cross-reference: See F_the_pio_programming_package.md for PIO programming details and using_the_io_pins.md for general interrupt concepts.

IRQ NOWAIT params

Clears the wait condition for an interrupt flag without blocking. This instruction allows the state machine to continue execution regardless of interrupt state.

Parameters:

  • params: Interrupt number (0-7 for PIO interrupts)

Context: Used in PIO assembler programs to override interrupt wait conditions. Unlike IRQ WAIT, this instruction doesn't stall the state machine.

Cross-reference: See F_the_pio_programming_package.md for PIO programming details and using_the_io_pins.md for general interrupt concepts.

IRQ params

General IRQ instruction for PIO state machines. This is a versatile instruction that can set, clear, or wait for interrupts depending on the parameters used.

Parameters:

  • params: Interrupt operation and number (0-7 for PIO interrupts)

Context: Used in PIO assembler programs for interrupt control. The exact behavior depends on the specific parameters, but generally controls interrupt flags for synchronization between PIO state machines.

Cross-reference: See F_the_pio_programming_package.md for PIO programming details, using_the_io_pins.md for general interrupt concepts, interrupt.md and interruptsub.md for software interrupt commands.