www.beck-ipc.com

@CHIP-RTOS C Library V2.06 - Hardware API


hal_mask_int

Mask and Unmask an external Interrupt Request.

void hal_mask_int ( unsigned short irq, unsigned char mask );

Parameters

mask

1: Mask IRQ
0: Unmask IRQ

SC1x Parameters

irq
HAL interrupt number from following list:
    0 = INT0 (external)
    1 = Network controller (internal)
    2 = INT2 (external)
    3 = INT3 (external)
    4 = INT4 (external)
    5 = INT5 (external) / DMA Interrupt Channel 0 (if DMA is used)
    6 = INT6 (external) / DMA Interrupt Channel 1 (if DMA is used)
    7 = reserved
    8 = Timer0 (internal)
    9 = Timer1 (internal)
    10 = Timer 1ms (internal)
    11 = Serial port 0 (internal)
    12 = Serial port 1 (internal)
    13 = DMA Interrupt Channel 2 (internal, not on SC12)
    14 = DMA Interrupt Channel 3 (internal, not on SC12)
    15 = NMI (Not maskable!)

SC1x3 Parameters

irq
HAL interrupt number from following list:
    0 = Network controller 0 (internal)
    1 = INT1 (external) / Network controller 1 (internal)
    2 = SPI controller (internal) / I2C controller (internal)
    3 = INT3 (external) / USB controller (internal)
    4 = Serial port 2 (internal)
    5 = DMA Interrupt Channel 0
    6 = DMA Interrupt Channel 1
    7 = INT5 (external) / Serial port 3 (internal)
    8 = Timer0 (internal)
    9 = Timer1 (internal)
    10 = Timer 1ms (internal)
    11 = Serial port 0 (internal)
    12 = Serial port 1 (internal)
    13 = DMA Interrupt Channel 2
    14 = DMA Interrupt Channel 3
    15 = NMI (Not maskable)
    16 = CAN0 controller (internal) / CAN1 controller (internal)

Return Value

-- none --.

Comments

CAUTION:
    Masking any of the three timer interrupts will suspend the @CHIP-RTOS 1000 Hz real-time interrupt, essential for system operation.   Consequently this mask period should be very brief, if used at all.

SC1x Comments

Some interrupts share the same mask bit.   If you mask one of them, the other interrupts which are assigned to the same bit are also masked.   Here are the groups which are masked together:

    Timer0, Timer1, Timer 1ms
    DMA0, INT5
    DMA1, INT6

SC1x3 Comments

Some interrupts share the same mask bit.   If you mask one of them, the other interrupts which are assigned to the same bit are also masked.   Here are the groups which are masked together:

    Timer0, Timer1, Timer 1ms
    INT1 / Network controller 1
    SPI controller / I2C controller
    INT3 / USB controller
    INT5 / Serial port 2
    CAN0 controller / CAN1 controller

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3
    V1.10V1.00V1.00V0.90

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document