自旋锁的协作图:

结构体
struct	xwos_splk
	XWOS API：自旋锁更多...

函数
static void	xwos_splk_init (struct xwos_splk *spl)
	XWOS API：初始化自旋锁

static void	xwos_splk_lock (struct xwos_splk *spl)
	XWOS API：上锁自旋锁，若自旋锁已开启临界区，就自旋等待

static xwer_t	xwos_splk_trylock (struct xwos_splk *spl)
	XWOS API：尝试上锁自旋锁

static void	xwos_splk_unlock (struct xwos_splk *spl)
	XWOS API：解锁自旋锁

static void	xwos_splk_lock_cpuirq (struct xwos_splk *spl)
	XWOS API：上锁自旋锁，并关闭本地CPU的中断

static xwer_t	xwos_splk_trylock_cpuirq (struct xwos_splk *spl)
	XWOS API：尝试上锁自旋锁，并关闭本地CPU的中断

static void	xwos_splk_unlock_cpuirq (struct xwos_splk *spl)
	XWOS API：解锁自旋锁，并开启本地CPU的中断

static void	xwos_splk_lock_cpuirqsv (struct xwos_splk spl, xwreg_t cpuirq)
	XWOS API：上锁自旋锁，保存本地CPU的中断标志并关闭

static xwer_t	xwos_splk_trylock_cpuirqsv (struct xwos_splk spl, xwreg_t cpuirq)
	XWOS API：尝试上锁自旋锁，保存本地CPU的中断标志并关闭

static void	xwos_splk_unlock_cpuirqrs (struct xwos_splk *spl, xwreg_t cpuirq)
	XWOS API：解锁自旋锁，并恢复本地CPU的中断标志

static void	xwos_splk_lock_irqs (struct xwos_splk *spl, const xwirq_t irqs[], xwsz_t num)
	XWOS API：上锁自旋锁，并关闭部分中断

static xwer_t	xwos_splk_trylock_irqs (struct xwos_splk *spl, const xwirq_t irqs[], xwsz_t num)
	XWOS API：尝试上锁自旋锁，并关闭部分中断

static void	xwos_splk_unlock_irqs (struct xwos_splk *spl, const xwirq_t irqs[], xwsz_t num)
	XWOS API：解锁自旋锁，并开启部分中断

static void	xwos_splk_lock_irqssv (struct xwos_splk *spl, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：上锁自旋锁，保存部分中断的中断标志并关闭

static xwer_t	xwos_splk_trylock_irqssv (struct xwos_splk *spl, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：尝试上锁自旋锁，保存部分中断的中断标志并关闭

static void	xwos_splk_unlock_irqsrs (struct xwos_splk *spl, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：解锁自旋锁，并恢复部分中断的中断标志

static void	xwos_splk_lock_bh (struct xwos_splk *spl)
	XWOS API：上锁自旋锁，关闭本地CPU的中断底半部

static xwer_t	xwos_splk_trylock_bh (struct xwos_splk *spl)
	XWOS API：尝试上锁自旋锁，关闭本地CPU的中断底半部

static void	xwos_splk_unlock_bh (struct xwos_splk *spl)
	XWOS API：解锁自旋锁，开启本地CPU的中断底半部

详细描述

技术参考手册：自旋锁

自旋锁的初始化

xwos_splk_init() ：静态初始化

锁模式

只保护线程上下文之间的临界区
- xwos_splk_lock() ：上锁，关闭抢占
- xwos_splk_trylock() ：尝试上锁，关闭抢占
- xwos_splk_unlock() ：解锁，开启抢占
保护任意上下文之间的临界区
- xwos_splk_lock_cpuirq() ：上锁，关闭抢占、CPU中断
- xwos_splk_trylock_cpuirq() ：尝试上锁，关闭抢占、CPU中断
- xwos_splk_unlock_cpuirq() ：解锁，开启抢占、CPU中断
多个自旋锁保护任意上下文之间的嵌套临界区
- xwos_splk_lock_cpuirqsv() ：上锁，关闭抢占，保存CPU中断标志并关闭
- xwos_splk_trylock_cpuirqsv() ：尝试上锁，关闭抢占，保存CPU中断标志并关闭
- xwos_splk_unlock_cpuirqrs() ：解锁，开启抢占，恢复CPU中断
保护线程和 指定的外设中断 上下文之间的临界区
- xwos_splk_lock_irqs() ：上锁，关闭抢占，关闭部分中断
- xwos_splk_trylock_irqs() ：尝试上锁，关闭抢占，关闭部分中断
- xwos_splk_unlock_irqs() ：解锁，开启抢占、开启部分中断
多个自旋锁保护线程和 指定的外设中断 上下文之间的嵌套临界区
- xwos_splk_lock_irqssv() ：上锁，关闭抢占，保存部分中断标志并关闭
- xwos_splk_trylock_irqssv() ：尝试上锁，关闭抢占，保存部分中断标志并关闭
- xwos_splk_unlock_irqsrs() ：解锁，开启抢占、恢复部分中断
保护线程和 中断底半部 上下文之间的临界区
- xwos_splk_lock_bh() ：上锁，关闭抢占、中断底半部
- xwos_splk_trylock_bh() ：尝试上锁，关闭抢占、中断底半部
- xwos_splk_unlock_bh() ：解锁，开启抢占、中断底半部

C++

C++头文件： xwos/osal/lock/spinlock.hxx

函数说明

◆ xwos_splk_init()

static void xwos_splk_init ( struct xwos_splk * spl )

inlinestatic

XWOS API：初始化自旋锁

参数

[in] spl 自旋锁的指针

注解

上下文：任意

在文件 spinlock.h 第 84 行定义.

{
        xwosdl_splk_init(&spl->osspl);
}

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

◆ xwos_splk_lock()

static void xwos_splk_lock ( struct xwos_splk * spl )

inlinestatic

XWOS API：上锁自旋锁，若自旋锁已开启临界区，就自旋等待

参数

[in] spl 自旋锁的指针

注解

上下文：线程、空闲任务

此函数只会关闭本地CPU的抢占，因此只能保证其临界区在线程中是安全的。

在文件 spinlock.h 第 98 行定义.

{
        xwosdl_splk_lock(&spl->osspl);
}

◆ xwos_splk_lock_bh()

static void xwos_splk_lock_bh ( struct xwos_splk * spl )

inlinestatic

XWOS API：上锁自旋锁，关闭本地CPU的中断底半部

参数

[in] spl 自旋锁的指针

注解

上下文：线程、中断底半部

此函数只会关闭本地CPU的抢占和中断底半部，因此只能保证其临界区在线程上下文与中断底半部中是安全的。

在文件 spinlock.h 第 353 行定义.

{
        xwosdl_splk_lock_bh(&spl->osspl);
}

◆ xwos_splk_lock_cpuirq()

static void xwos_splk_lock_cpuirq ( struct xwos_splk * spl )

inlinestatic

XWOS API：上锁自旋锁，并关闭本地CPU的中断

参数

[in] spl 自旋锁的指针

注解

上下文：任意

此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文中都是安全的。

在文件 spinlock.h 第 142 行定义.

{
        xwosdl_splk_lock_cpuirq(&spl->osspl);
}

◆ xwos_splk_lock_cpuirqsv()

static void xwos_splk_lock_cpuirqsv	(	struct xwos_splk *	spl,
		xwreg_t *	cpuirq
	)

inlinestatic

XWOS API：上锁自旋锁，保存本地CPU的中断标志并关闭

参数

[in]	spl	自旋锁的指针
[out]	cpuirq	缓冲区指针，用于返回本地CPU的中断标志

注解

上下文：任意

此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文中都是安全的。

在文件 spinlock.h 第 187 行定义.

{
        xwosdl_splk_lock_cpuirqsv(&spl->osspl, cpuirq);
}

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

◆ xwos_splk_lock_irqs()

static void xwos_splk_lock_irqs	(	struct xwos_splk *	spl,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：上锁自旋锁，并关闭部分中断

参数

[in]	spl	自旋锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

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

{
        xwosdl_splk_lock_irqs(&spl->osspl, irqs, num);
}

◆ xwos_splk_lock_irqssv()

static void xwos_splk_lock_irqssv	(	struct xwos_splk *	spl,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：上锁自旋锁，保存部分中断的中断标志并关闭

参数

[in]	spl	自旋锁的指针
[in]	irqs	中断资源数组指针
[out]	flags	缓冲区指针，用于返回部分中断的中断标志
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 spinlock.h 第 295 行定义.

{
        xwosdl_splk_lock_irqssv(&spl->osspl, irqs, flags, num);
}

◆ xwos_splk_trylock()

static xwer_t xwos_splk_trylock ( struct xwos_splk * spl )

inlinestatic

XWOS API：尝试上锁自旋锁

参数

[in] spl 自旋锁的指针

返回: 错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

注解

上下文：线程、空闲任务

若自旋锁已开启临界区，立即返回，不会自旋等待。
此函数只会关闭本地CPU的抢占，因此只能保证其临界区在线程中是安全的。

在文件 spinlock.h 第 116 行定义.

{
        return xwosdl_splk_trylock(&spl->osspl);
}

◆ xwos_splk_trylock_bh()

static xwer_t xwos_splk_trylock_bh ( struct xwos_splk * spl )

inlinestatic

XWOS API：尝试上锁自旋锁，关闭本地CPU的中断底半部

参数

[in] spl 自旋锁的指针

返回: 错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

注解

上下文：线程、中断底半部

若自旋锁已开启临界区，立即返回，不会自旋等待。
此函数只会关闭本地CPU的抢占和中断底半部，因此只能保证其临界区在线程上下文与中断底半部中是安全的。

在文件 spinlock.h 第 372 行定义.

{
        return xwosdl_splk_trylock_bh(&spl->osspl);
}

◆ xwos_splk_trylock_cpuirq()

static xwer_t xwos_splk_trylock_cpuirq ( struct xwos_splk * spl )

inlinestatic

XWOS API：尝试上锁自旋锁，并关闭本地CPU的中断

参数

[in] spl 自旋锁的指针

返回: 错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

注解

上下文：任意

若自旋锁已开启临界区，立即返回，不会自旋等待。
此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文中都是安全的。

在文件 spinlock.h 第 160 行定义.

{
        return xwosdl_splk_trylock_cpuirq(&spl->osspl);
}

◆ xwos_splk_trylock_cpuirqsv()

static xwer_t xwos_splk_trylock_cpuirqsv	(	struct xwos_splk *	spl,
		xwreg_t *	cpuirq
	)

inlinestatic

XWOS API：尝试上锁自旋锁，保存本地CPU的中断标志并关闭

参数

[in]	spl	自旋锁的指针
[out]	cpuirq	缓冲区指针，用于返回本地CPU的中断标志

返回: 错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

注解

上下文：任意

若自旋锁已开启临界区，立即返回，不会自旋等待。
此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文中都是安全的。

在文件 spinlock.h 第 206 行定义.

{
        return xwosdl_splk_trylock_cpuirqsv(&spl->osspl, cpuirq);
}

◆ xwos_splk_trylock_irqs()

static xwer_t xwos_splk_trylock_irqs	(	struct xwos_splk *	spl,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：尝试上锁自旋锁，并关闭部分中断

参数

[in]	spl	自旋锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

返回: 错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

注解

上下文：线程、中断资源数组中描述的中断

若自旋锁已开启临界区，立即返回，不会自旋等待。
此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 spinlock.h 第 259 行定义.

{
        return xwosdl_splk_trylock_irqs(&spl->osspl, irqs, num);
}

◆ xwos_splk_trylock_irqssv()

static xwer_t xwos_splk_trylock_irqssv	(	struct xwos_splk *	spl,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：尝试上锁自旋锁，保存部分中断的中断标志并关闭

参数

[in]	spl	自旋锁的指针
[in]	irqs	中断资源数组指针
[out]	flags	缓冲区指针，用于返回部分中断的中断标志
[in]	num	数组中元素数量

返回: 错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

注解

上下文：线程、中断资源数组中描述的中断

若自旋锁已开启临界区，立即返回，不会自旋等待。
此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 spinlock.h 第 319 行定义.

{
        return xwosdl_splk_trylock_irqssv(&spl->osspl, irqs, flags, num);
}

◆ xwos_splk_unlock()

static void xwos_splk_unlock ( struct xwos_splk * spl )

inlinestatic

XWOS API：解锁自旋锁

参数

[in] spl 自旋锁的指针

注解

上下文：线程、空闲任务

在文件 spinlock.h 第 128 行定义.

{
        xwosdl_splk_unlock(&spl->osspl);
}

◆ xwos_splk_unlock_bh()

static void xwos_splk_unlock_bh ( struct xwos_splk * spl )

inlinestatic

XWOS API：解锁自旋锁，开启本地CPU的中断底半部

参数

[in] spl 自旋锁的指针

上下文：线程、中断底半部

在文件 spinlock.h 第 384 行定义.

{
        xwosdl_splk_unlock_bh(&spl->osspl);
}

◆ xwos_splk_unlock_cpuirq()

static void xwos_splk_unlock_cpuirq ( struct xwos_splk * spl )

inlinestatic

XWOS API：解锁自旋锁，并开启本地CPU的中断

参数

[in] spl 自旋锁的指针

注解

上下文：任意

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

{
        xwosdl_splk_unlock_cpuirq(&spl->osspl);
}

◆ xwos_splk_unlock_cpuirqrs()

static void xwos_splk_unlock_cpuirqrs	(	struct xwos_splk *	spl,
		xwreg_t	cpuirq
	)

inlinestatic

XWOS API：解锁自旋锁，并恢复本地CPU的中断标志

参数

[in]	spl	自旋锁的指针
[in]	cpuirq	本地CPU的中断标志

注解

上下文：任意

在文件 spinlock.h 第 219 行定义.

{
        xwosdl_splk_unlock_cpuirqrs(&spl->osspl, cpuirq);
}

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

◆ xwos_splk_unlock_irqs()

static void xwos_splk_unlock_irqs	(	struct xwos_splk *	spl,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：解锁自旋锁，并开启部分中断

参数

[in]	spl	自旋锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

在文件 spinlock.h 第 275 行定义.

{
        xwosdl_splk_unlock_irqs(&spl->osspl, irqs, num);
}

◆ xwos_splk_unlock_irqsrs()

static void xwos_splk_unlock_irqsrs	(	struct xwos_splk *	spl,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：解锁自旋锁，并恢复部分中断的中断标志

参数

[in]	spl	自旋锁的指针
[in]	irqs	中断资源数组指针
[in]	flags	部分中断的中断标志数组
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

在文件 spinlock.h 第 336 行定义.

{
        xwosdl_splk_unlock_irqsrs(&spl->osspl, irqs, flags, num);
}

结构体

函数

详细描述

自旋锁的初始化

锁模式

C++

函数说明

◆ xwos_splk_init()

◆ xwos_splk_lock()

◆ xwos_splk_lock_bh()

◆ xwos_splk_lock_cpuirq()

◆ xwos_splk_lock_cpuirqsv()

◆ xwos_splk_lock_irqs()

◆ xwos_splk_lock_irqssv()

◆ xwos_splk_trylock()

◆ xwos_splk_trylock_bh()

◆ xwos_splk_trylock_cpuirq()

◆ xwos_splk_trylock_cpuirqsv()

◆ xwos_splk_trylock_irqs()

◆ xwos_splk_trylock_irqssv()

◆ xwos_splk_unlock()

◆ xwos_splk_unlock_bh()

◆ xwos_splk_unlock_cpuirq()

◆ xwos_splk_unlock_cpuirqrs()

◆ xwos_splk_unlock_irqs()

◆ xwos_splk_unlock_irqsrs()