niobe/applications/app/TW005_OS_mutex/README.md

Niobe WiFi IoT开发板OpenHarmony内核编程开发——mutex

本示例将演示如何在Niobe WiFi IoT开发板上使用cmsis 2.0 接口进行互斥锁开发

mutex API分析

osThreadNew()

osThreadId_t osThreadNew(osThreadFunc_t	func, void *argument,const osThreadAttr_t *attr )

描述：

函数osThreadNew通过将线程添加到活动线程列表并将其设置为就绪状态来启动线程函数。线程函数的参数使用参数指针*argument传递。当创建的thread函数的优先级高于当前运行的线程时，创建的thread函数立即启动并成为新的运行线程。线程属性是用参数指针attr定义的。属性包括线程优先级、堆栈大小或内存分配的设置。可以在RTOS启动(调用 osKernelStart)之前安全地调用该函数，但不能在内核初始化 (调用 osKernelInitialize)之前调用该函数。

注意 :不能在中断服务调用该函数

参数：

名字	描述
func	线程函数.
argument	作为启动参数传递给线程函数的指针
attr	线程属性

osMutexNew()

osMutexNew (const osMutexAttr_t *attr);

描述：

创建互斥锁

参数：

名字	描述
attr	mutex属性

osMutexAcquire()

osMutexAcquire (osMutexId_t mutex_id, uint32_t timeout);

描述：

获取互斥锁

参数：

名字	描述
mutex_id	mutex ID
timeout	delay时间

osMutexRelease()

osMutexRelease (osMutexId_t mutex_id);

描述：

释放互斥锁

参数：

名字	描述
mutex_id	mutex ID

软件设计

主要代码分析

在os_mutex_example函数中，通过osThreadNew()函数创建了firstThread、twoThread、threeThread三个线程，firstThread、twoThread、threeThread三个线程启动后会输出打印日志。

void firstThread(void)
{
  osDelay(100U);
for(i=0;i<3;i++)
  {
    osMutexAcquire(mutex_id, osWaitForever);
    printf("firstThread is Acquire.\r\n");
    osDelay(200U);
    osMutexRelease(mutex_id);
  }
}

void twoThread(void)
{
  osDelay(100U);
for(i=0;i<3;i++)
  {
    printf("twoThread is Acquire.\r\n");
    osDelay(50U);
  }
}

void threeThread(void)
{
  osDelay(100U);	
for(i=0;i<3;i++)
  {
    osMutexAcquire(mutex_id, osWaitForever);
    printf("threeThread is Acquire.\r\n");
    osDelay(100U);
    osMutexRelease(mutex_id);
  }
}

void os_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 = "firstThread";
  attr.priority = 0;
  if (osThreadNew((osThreadFunc_t)firstThread, NULL, &attr) == NULL)
  {
    printf("create firstThread failed!\n");
  }
  attr.name = "twoThread";
  attr.priority = 1;
  if (osThreadNew((osThreadFunc_t)twoThread, NULL, &attr) == NULL)
  {
    printf("create twoThread failed!\n");
  }
  attr.name = "threeThread";
  attr.priority = 2;
  if (osThreadNew((osThreadFunc_t)threeThread, NULL, &attr) == NULL)
  {
    printf("create threeThread failed!\n");
  }
  mutex_id = osMutexNew(NULL);
  if (mutex_id == NULL)
  {
    printf("create Mutex failed!\n");
  }
}

编译调试

修改 BUILD.gn 文件

修改 applications/app/路径下 BUILD.gn 文件，指定 mutex_example 参与编译。

#"TW001_OS_helloworld:helloworld_example",
"TW005_OS_mutex:mutex_example",	
#"TW003_OS_timer:os_timer_example",
#"TW004_OS_event:os_event_example",
#"TW005_OS_mutex:os_mutex_example",
#"TW006_OS_semp:os_semaphore_example",
#"TW007_OS_message:os_message_example",

运行结果

示例代码编译烧录代码后，按下开发板的RESET按键，通过串口助手查看日志

firstThread is Acquire
twoThread is Acquire
threeThread is Acquire