Hardware interrupt

Hardware interrupt 的协作图:

类型定义
typedef UINT32	HWI_HANDLE_T
typedef UINT16	HWI_PRIOR_T
typedef UINT16	HWI_MODE_T
typedef UINTPTR	HWI_ARG_T
typedef VOID(*	HWI_PROC_FUNC) (VOID)

函数
STATIC INLINE UINT32	LOS_IntLock (VOID)
	Disable all interrupts. | 关闭当前处理器所有中断响应 更多...
STATIC INLINE UINT32	LOS_IntUnLock (VOID)
	Enable all interrupts. | 打开当前处理器所有中断响应 更多...
STATIC INLINE VOID	LOS_IntRestore (UINT32 intSave)
	Restore interrupts. | 恢复到使用LOS_IntLock关闭所有中断之前的状态 更多...
UINT32	LOS_GetSystemHwiMaximum (VOID)
	Gets the maximum number of interrupts supported by the system. 更多...
UINT32	LOS_HwiCreate (HWI_HANDLE_T hwiNum, HWI_PRIOR_T hwiPrio, HWI_MODE_T hwiMode, HWI_PROC_FUNC hwiHandler, HwiIrqParam *irqParam)
	Create a hardware interrupt. 更多...
UINT32	LOS_HwiDelete (HWI_HANDLE_T hwiNum, HwiIrqParam *irqParam)
	delete a hardware interrupt. 更多...

变量
size_t	g_intCount []
	中断次数,每个CPU都会记录响应中断的次数 更多...

详细描述

类型定义说明

HWI_ARG_T

typedef UINTPTR HWI_ARG_T

Define the type of the parameter used for the hardware interrupt creation function. The function of this parameter varies among platforms.

在文件 los_hwi.h 第 236 行定义.

HWI_HANDLE_T

typedef UINT32 HWI_HANDLE_T

Define the type of a hardware interrupt number. //定义硬件中断号的类型

在文件 los_hwi.h 第 217 行定义.

HWI_MODE_T

typedef UINT16 HWI_MODE_T

Define the type of hardware interrupt mode configurations. //定义硬件中断配置的类型

在文件 los_hwi.h 第 229 行定义.

HWI_PRIOR_T

typedef UINT16 HWI_PRIOR_T

Define the type of a hardware interrupt priority. //定义硬件中断优先级的类型

在文件 los_hwi.h 第 223 行定义.

HWI_PROC_FUNC

typedef VOID(* HWI_PROC_FUNC) (VOID)

Define the type of a hardware interrupt handling function. //定义硬件中断处理函数的类型

在文件 los_hwi.h 第 242 行定义.

函数说明

LOS_GetSystemHwiMaximum()

UINT32 LOS_GetSystemHwiMaximum

(

VOID

)

Gets the maximum number of interrupts supported by the system.

Description:

• This API is used to gets the maximum number of interrupts supported by the system.

参数

None.

返回值

None.

Dependency:

• los_hwi.h: the header file that contains the API declaration.

Gets the maximum number of interrupts supported by the system.

在文件 los_hwi.c 第 174 行定义.

{
    return OS_HWI_MAX_NUM;
}

LOS_HwiCreate()

UINT32 LOS_HwiCreate	(	HWI_HANDLE_T	hwiNum,
		HWI_PRIOR_T	hwiPrio,
		HWI_MODE_T	hwiMode,
		HWI_PROC_FUNC	hwiHandler,
		HwiIrqParam *	irqParam
	)

Create a hardware interrupt.

Description:

This API is used to configure a hardware interrupt and register a hardware interrupt handling function.

注意

• The hardware interrupt module is usable only when the configuration item for hardware interrupt tailoring is enabled.
• Hardware interrupt number value range: [OS_USER_HWI_MIN,OS_USER_HWI_MAX].
• OS_HWI_MAX_NUM specifies the maximum number of interrupts that can be created.
• Before executing an interrupt on a platform, refer to the chip manual of the platform.
• The parameter handler of this interface is a interrupt handler, it should be correct, otherwise, the system may be abnormal.
• The input irqParam could be NULL, if not, it should be address which point to a struct HwiIrqParam

参数

hwiNum	[IN] Type HWI_HANDLE_T: hardware interrupt number. for an ARM926 platform is [0,31].
hwiPrio	[IN] Type HWI_PRIOR_T: hardware interrupt priority. The value range is [0, GIC_MAX_INTERRUPT_PREEMPTION_LEVEL - 1] << PRIORITY_SHIFT.
hwiMode	[IN] Type HWI_MODE_T: hardware interrupt mode. Ignore this parameter temporarily.
hwiHandler	[IN] Type HWI_PROC_FUNC: interrupt handler used when a hardware interrupt is triggered.
irqParam	[IN] Type HwiIrqParam: input parameter of the interrupt handler used when a hardware interrupt is triggered.

返回值

#OS_ERRNO_HWI_PROC_FUNC_NULL	Null hardware interrupt handling function.
#OS_ERRNO_HWI_NUM_INVALID	Invalid interrupt number.
#OS_ERRNO_HWI_NO_MEMORY	Insufficient memory for hardware interrupt creation.
#OS_ERRNO_HWI_ALREADY_CREATED	The interrupt handler being created has already been created.
#LOS_OK	The interrupt is successfully created.

Dependency:

• los_hwi.h: the header file that contains the API declaration.

参见

None.

Create a hardware interrupt.

参数

hwiNum	硬中断句柄编号 默认范围[0-127]
hwiPrio	硬中断优先级
hwiMode	硬中断模式 共享和非共享
hwiHandler	硬中断处理函数
irqParam	硬中断处理函数参数

返回

LITE_OS_SEC_TEXT_INIT

在文件 los_hwi.c 第 429 行定义.

{
    UINT32 ret;
 
    (VOID)hwiPrio;
    if (hwiHandler == NULL) {//中断处理函数不能为NULL
        return OS_ERRNO_HWI_PROC_FUNC_NULL;
    }
    if ((hwiNum > OS_USER_HWI_MAX) || ((INT32)hwiNum < OS_USER_HWI_MIN)) {//中断数区间限制 [32,96]
        return OS_ERRNO_HWI_NUM_INVALID;
    }
 
#ifdef LOSCFG_NO_SHARED_IRQ //不支持共享中断
    ret = OsHwiCreateNoShared(hwiNum, hwiMode, hwiHandler, irqParam);
#else
    ret = OsHwiCreateShared(hwiNum, hwiMode, hwiHandler, irqParam);
#endif
    return ret;
}

函数调用图:

这是这个函数的调用关系图:

LOS_HwiDelete()

UINT32 LOS_HwiDelete	(	HWI_HANDLE_T	hwiNum,
		HwiIrqParam *	irqParam
	)

delete a hardware interrupt.

Description:

This API is used to delete a hardware interrupt.

注意

• The hardware interrupt module is usable only when the configuration item for hardware interrupt tailoring is enabled.
• Hardware interrupt number value range: [OS_USER_HWI_MIN,OS_USER_HWI_MAX].
• OS_HWI_MAX_NUM specifies the maximum number of interrupts that can be created.
• Before executing an interrupt on a platform, refer to the chip manual of the platform.

参数

hwiNum	[IN] Type HWI_HANDLE_T: hardware interrupt number.
irqParam	[IN] Type HwiIrqParam *: id of hardware interrupt which will base on when delete the hardware interrupt.

返回值

#OS_ERRNO_HWI_NUM_INVALID	Invalid interrupt number.
#OS_ERRNO_HWI_SHARED_ERROR	Invalid interrupt mode.
#LOS_OK	The interrupt is successfully deleted.
#LOS_NOK	The interrupt is failed deleted based on the pDev_ID.

Dependency:

• los_hwi.h: the header file that contains the API declaration.

参见

None.

delete a hardware interrupt.

在文件 los_hwi.c 第 453 行定义.

{
    UINT32 ret;
 
    if ((hwiNum > OS_USER_HWI_MAX) || ((INT32)hwiNum < OS_USER_HWI_MIN)) {
        return OS_ERRNO_HWI_NUM_INVALID;
    }
 
#ifdef LOSCFG_NO_SHARED_IRQ //不支持共享中断
    ret = OsHwiDelNoShared(hwiNum);
#else
    ret = OsHwiDelShared(hwiNum, irqParam);
#endif
    return ret;
}

函数调用图:

LOS_IntLock()

STATIC INLINE UINT32 LOS_IntLock

(

VOID

)

Disable all interrupts. | 关闭当前处理器所有中断响应

Description:

• This API is used to disable all IRQ and FIQ interrupts in the CPSR.

注意

• None.

参数

None.

返回值

UINT32

CPSR value obtained before all interrupts are disabled.

Dependency:

• los_hwi.h: the header file that contains the API declaration.

参见

LOS_IntRestore

在文件 los_hwi.h 第 286 行定义.

{//此API用于禁用CPSR中的所有IRQ和FIQ中断。CPSR:程序状态寄存器(current program status register)
    return ArchIntLock();
}//IRQ(Interrupt Request)：指中断模式。FIQ(Fast Interrupt Request)：指快速中断模式。

函数调用图:

这是这个函数的调用关系图:

LOS_IntRestore()

STATIC INLINE VOID LOS_IntRestore

(

UINT32

intSave

)

Restore interrupts. | 恢复到使用LOS_IntLock关闭所有中断之前的状态

Description:

• This API is used to restore the CPSR value obtained before all interrupts are disabled.

注意

• This API can be called only after all interrupts are disabled, and the input parameter value should be the value returned by LOS_IntLock.

参数

intSave

[IN] Type UINT32 : CPSR value obtained before all interrupts are disabled.

返回值

None.

Dependency:

• los_hwi.h: the header file that contains the API declaration.

参见

LOS_IntLock

在文件 los_hwi.h 第 337 行定义.

{//只有在禁用所有中断之后才能调用此API，并且输入参数值应为LOS_IntLock返回的值。
    ArchIntRestore(intSave);
}

函数调用图:

这是这个函数的调用关系图:

LOS_IntUnLock()

STATIC INLINE UINT32 LOS_IntUnLock

(

VOID

)

Enable all interrupts. | 打开当前处理器所有中断响应

Description:

• This API is used to enable all IRQ and FIQ interrupts in the CPSR.

注意

• None.

参数

None.

返回值

UINT32

CPSR value obtained after all interrupts are enabled.

Dependency:

• los_hwi.h: the header file that contains the API declaration.

参见

LOS_IntLock

在文件 los_hwi.h 第 311 行定义.

{//此API用于启用CPSR中的所有IRQ和FIQ中断。
    return ArchIntUnlock();
}

函数调用图:

这是这个函数的调用关系图:

变量说明

g_intCount

size_t g_intCount[]

extern

中断次数,每个CPU都会记录响应中断的次数

Count of interrupts.

中断次数,每个CPU都会记录响应中断的次数

在文件 los_hwi.c 第 153 行定义.