中断

中断 的协作图:

函数
static xwer_t	xwos_irq_enable (xwirq_t irqn)
	XWOS API：开启中断
static xwer_t	xwos_irq_disable (xwirq_t irqn)
	XWOS API：关闭中断
static xwer_t	xwos_irq_save (xwirq_t irqn, xwreg_t *flag)
	XWOS API：保存中断的开关，然后将其关闭
static xwer_t	xwos_irq_restore (xwirq_t irqn, xwreg_t flag)
	XWOS API：恢复中断的开关
static xwer_t	xwos_irq_get_id (xwirq_t *irqnbuf)
	XWOS API：判断当前的上下文是否为中断上下文，并取得当前中断的中断号
static void	xwos_cpuirq_enable_lc (void)
	XWOS API：开启本地CPU的中断
static void	xwos_cpuirq_disable_lc (void)
	XWOS API：关闭本地CPU的中断
static void	xwos_cpuirq_restore_lc (xwreg_t cpuirq)
	XWOS API：恢复本地CPU的中断
static void	xwos_cpuirq_save_lc (xwreg_t *cpuirq)
	XWOS API：保存然后关闭本地CPU的中断

详细描述

技术参考手册： 中断管理

CPU中断开关

• xwos_cpuirq_enable_lc() ：开启CPU的中断开关
• xwos_cpuirq_disable_lc() ：关闭CPU的中断开关
• xwos_cpuirq_save_lc() ：保存当前CPU的中断开关状态后关闭
• xwos_cpuirq_restore_lc() ：恢复之前保存的CPU的中断开关状态

外设中断

获取当前代码的中断号

• xwos_irq_get_id() 可以用来获取当前中断的中断号和判断上下文。

外设中断的其他CAPI

• xwos_irq_enable() ：开启某个外设中断
• xwos_irq_disable() ：关闭某个外设中断
• xwos_irq_save() ：保存某个外设中断的开关，然后将其关闭
• xwos_irq_restore() ：恢复某个外设中断的开关

C++

C++头文件： xwos/osal/irq.hxx

函数说明

xwos_cpuirq_disable_lc()

static void xwos_cpuirq_disable_lc ( void  )

inlinestatic

XWOS API：关闭本地CPU的中断

注解

• 上下文：任意

此函数运行在哪个CPU上，关闭的就是哪个CPU的中断。

在文件 irq.h 第 158 行定义.

{
        xwosdl_cpuirq_disable_lc();
}

xwos_cpuirq_enable_lc()

static void xwos_cpuirq_enable_lc ( void  )

inlinestatic

XWOS API：开启本地CPU的中断

注解

• 上下文：任意

此函数运行在哪个CPU上，开启的就是哪个CPU的中断。

在文件 irq.h 第 145 行定义.

{
        xwosdl_cpuirq_enable_lc();
}

xwos_cpuirq_restore_lc()

static void xwos_cpuirq_restore_lc ( xwreg_t  cpuirq )

inlinestatic

XWOS API：恢复本地CPU的中断

参数

[in]

cpuirq

本地CPU的中断开关

注解

• 上下文：任意

此函数运行在哪个CPU上，恢复的就是哪个CPU的中断。

在文件 irq.h 第 172 行定义.

{
        xwosdl_cpuirq_restore_lc(cpuirq);
}

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

xwos_cpuirq_save_lc()

static void xwos_cpuirq_save_lc ( xwreg_t *  cpuirq )

inlinestatic

XWOS API：保存然后关闭本地CPU的中断

参数

[out]

cpuirq

指向缓冲区的指针，此缓冲区用于返回本地CPU的中断开关

注解

• 上下文：任意

此函数运行在哪个CPU上，保存然后关闭的就是哪个CPU的中断。

在文件 irq.h 第 186 行定义.

{
        xwosdl_cpuirq_save_lc(cpuirq);
}

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

xwos_irq_disable()

static xwer_t xwos_irq_disable ( xwirq_t  irqn )

inlinestatic

XWOS API：关闭中断

参数

[in]

irqn

中断号

返回

错误码

返回值

XWOK	没有错误
-ERANGE	中断号超出范围
-ENOSYS	没有实现此功能

注解

• 上下文：任意

在文件 irq.h 第 79 行定义.

{
        return xwosdl_irq_disable(irqn);
}

xwos_irq_enable()

static xwer_t xwos_irq_enable ( xwirq_t  irqn )

inlinestatic

XWOS API：开启中断

参数

[in]

irqn

中断号

返回

错误码

返回值

XWOK	没有错误
-ERANGE	中断号超出范围
-ENOSYS	没有实现此功能

注解

• 上下文：任意

在文件 irq.h 第 63 行定义.

{
        return xwosdl_irq_enable(irqn);
}

xwos_irq_get_id()

static xwer_t xwos_irq_get_id ( xwirq_t *  irqnbuf )

inlinestatic

XWOS API：判断当前的上下文是否为中断上下文，并取得当前中断的中断号

参数

[out]

irqnbuf

指向缓冲区的指针，通过此缓冲区返回当前中断号： 返回结果仅当返回值为OK时有效 可为NULL，表示不需要返回中断号

返回

错误码

返回值

XWOK	当前上下文为中断
-ETHDCTX	当前上下文为线程
-EBHCTX	当前上下文为中断底半部

注解

• 上下文：任意

在文件 irq.h 第 132 行定义.

{
        return xwosdl_irq_get_id(irqnbuf);
}

xwos_irq_restore()

static xwer_t xwos_irq_restore ( xwirq_t  irqn, xwreg_t  flag  )

inlinestatic

XWOS API：恢复中断的开关

参数

[in]	irqn	中断号
[in]	flag	中断开关

返回

错误码

返回值

XWOK	没有错误
-ERANGE	中断号超出范围
-ENOSYS	没有实现此功能

注解

• 上下文：任意

在文件 irq.h 第 114 行定义.

{
        return xwosdl_irq_restore(irqn, flag);
}

xwos_irq_save()

static xwer_t xwos_irq_save ( xwirq_t  irqn, xwreg_t *  flag  )

inlinestatic

XWOS API：保存中断的开关，然后将其关闭

参数

[in]	irqn	中断号
[out]	flag	指向缓冲区的指针，此缓冲区用于返回中断开关

返回

错误码

返回值

XWOK	没有错误
-ERANGE	中断号超出范围
-ENOSYS	没有实现此功能
-EFAULT	空指针

注解

• 上下文：任意

在文件 irq.h 第 97 行定义.

{
        return xwosdl_irq_save(irqn, flag);
}