互斥锁
本示例将演示如何在BearPi-HM_Nano开发板上使用cmsis 2.0 接口使用互斥来同步任务
一、准备工作
参考BearPi-HM_Nano十分钟上手教程完成开发环境搭建、代码获取等工作,以及熟悉代码的编译和烧录流程。
二、软件设计
主要代码分析
打开applications\BearPi\BearPi-HM_Nano\sample\A4_kernel_mutex\Mutex_example.c
,在Mutex_example函数中,通过osMutexNew()函数创建了互斥锁ID,并创建的三个不同优先级的任务,在第一秒,高优先级和中优先级线程被延迟。因此,低优先级线程可以启动自己的工作,获得互斥锁并在持有它时延迟。在第一秒之后,高优先级和中优先级线程就准备好了。因此高优先级线程获得优先级并尝试获取互斥锁。因为互斥锁已经被低优先级线程所拥有,所以高优先级线程被阻塞,中间优先级线程被执行,并开始执行许多非阻塞的工作,3S后低优先级释放互斥锁,高优先级线程准备就绪并立即被调度。
void HighPrioThread(void)
{
osDelay(100U); // wait 1s until start actual work
while(1)
{
osMutexAcquire(mutex_id, osWaitForever); // try to acquire mutex
printf("HighPrioThread is runing.\r\n");
osDelay(300U);
osMutexRelease(mutex_id);
}
}
void MidPrioThread(void)
{
osDelay(100U); // wait 1s until start actual work
while(1)
{
printf("MidPrioThread is runing.\r\n");
osDelay(100);
}
}
void LowPrioThread(void)
{
while(1)
{
osMutexAcquire(mutex_id, osWaitForever);
printf("LowPrioThread is runing.\r\n");
osDelay(300U); // block mutex for 5s
osMutexRelease(mutex_id);
}
}
void Mutex_example(void)
{
osThreadAttr_t attr;
attr.attr_bits = 0U;
attr.cb_mem = NULL;
attr.cb_size = 0U;
attr.stack_mem = NULL;
attr.stack_size = 1024 * 4;
attr.name = "HighPrioThread";
attr.priority = 26;
if (osThreadNew((osThreadFunc_t)HighPrioThread, NULL, &attr) == NULL)
{
printf("Falied to create HighPrioThread!\n");
}
attr.name = "MidPrioThread";
attr.priority = 25;
if (osThreadNew((osThreadFunc_t)MidPrioThread, NULL, &attr) == NULL)
{
printf("Falied to create MidPrioThread!\n");
}
attr.name = "LowPrioThread";
attr.priority = 24;
if (osThreadNew((osThreadFunc_t)LowPrioThread, NULL, &attr) == NULL)
{
printf("Falied to create LowPrioThread!\n");
}
mutex_id = osMutexNew(NULL);
if (mutex_id == NULL)
{
printf("Falied to create Mutex!\n");
}
}
Mutex API分析
osMutexNew()
osMutexId_t osMutexNew(const osMutexAttr_t *attr)
描述:
函数osMutexNew创建并初始化一个新的互斥锁对象,并返回指向互斥锁对象标识符的指针,如果出现错误则返回NULL,可以在RTOS启动(调用 osKernelStart)之前安全地调用该函数,但不能在内核初始化 (调用 osKernelInitialize)之前调用该函数。
注意 :不能在中断服务调用该函数
参数:
名字 | 描述 |
---|---|
attr | 互斥对象的属性. |
osMutexAcquire()
osStatus_t osMutexAcquire(osMutexId_t mutex_id,uint32_t timeout)
描述: 函数osMutexAcquire一直等待,直到参数mutex_id指定的互斥对象可用为止。如果没有其他线程获得互斥锁,该函数立即返回并阻塞互斥锁对象。
注意 :不能在中断服务调用该函数
参数:
名字 | 描述 |
---|---|
mutex_id | 通过osMutexNew获得互斥锁ID. |
timeout | 超时值. |
osMutexRelease()
osStatus_t osMutexRelease(osMutexId_t mutex_id)
描述: 函数osMutexRelease释放一个由参数mutex_id指定的互斥量。当前等待这个互斥锁的其他线程将被置于就绪状态。
注意 :不能从中断服务例程调用此函数。
参数:
名字 | 描述 |
---|---|
mutex_id | 通过osMutexNew获得互斥锁ID. |
三、编译调试
修改 BUILD.gn 文件
修改 applications\BearPi\BearPi-HM_Nano\sample
路径下 BUILD.gn 文件,指定 mutex_example
参与编译。
#"A1_kernal_thread:thread_example",
#"A2_kernel_timer:timer_example",
#"A3_kernel_event:event_example",
"A4_kernel_mutex:mutex_example",
#"A5_kernel_semaphore:semaphore_example",
#"A6_kernel_message:message_example",
运行结果
示例代码编译烧录代码后,按下开发板的RESET按键,通过串口助手查看日志,中优先级任务一直正常运行,而高优先级和低优先级的任务因为互相抢占互斥锁,交替运行。
LowPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
HighPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
LowPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
HighPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing.
MidPrioThread is runing