1# HiSpark WiFi-IoT 套件样例开发--互斥锁（Mutex） 2 3 4 5[HiSpark WiFi-IoT开发套件](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w5003-23341819265.1.bf644a82Da9PZK&id=622343426064&scene=taobao_shop) 首发于HDC 2020，是首批支持OpenHarmony 2.0的开发套件，亦是官方推荐套件，由润和软件HiHope量身打造，已在OpenHarmony社区和广大OpenHarmony开发者中得到广泛应用。 6 7 8 9## 一、Mutex API 10 11| API名称 | 说明 | 12| --------------- | -------------------------------------------------------- | 13| osMutexNew | 创建并初始化一个互斥锁 | 14| osMutexGetName | 获得指定互斥锁的名字 | 15| osMutexAcquire | 获得指定的互斥锁的访问权限，若互斥锁已经被锁，则返回超时 | 16| osMutexRelease | 释放指定的互斥锁 | 17| osMutexGetOwner | 获得指定互斥锁的所有者线程 | 18| osMutexDelete | 删除指定的互斥锁 | 19 20## 二、代码分析 21 22全局变量`g_test_value`若同时被多个线程访问，会将其加1，然后判断其奇偶性，并输出日志，如果没有互斥锁保护，线程会被中断导致错误，所以需要创建互斥锁来保护多线程共享区域 23 24```c 25void number_thread(void *arg) { 26 osMutexId_t *mid = (osMutexId_t *)arg; 27 while(1) { 28 if (osMutexAcquire(*mid, 100) == osOK) { 29 g_test_value++; 30 if (g_test_value % 2 == 0) { 31 printf("[Mutex Test] %s gets an even value %d.\r\n", osThreadGetName(osThreadGetId()), g_test_value); 32 } else { 33 printf("[Mutex Test] %s gets an odd value %d.\r\n", osThreadGetName(osThreadGetId()), g_test_value); 34 } 35 osMutexRelease(*mid); 36 osDelay(5); 37 } 38 } 39} 40``` 41 42创建三个线程访问全局变量`g_test_value` ，同时创建一个互斥锁共所有线程使用 43 44```c 45void rtosv2_mutex_main(void *arg) { 46 (void)arg; 47 osMutexAttr_t attr = {0}; 48 49 osMutexId_t mid = osMutexNew(&attr); 50 if (mid == NULL) { 51 printf("[Mutex Test] osMutexNew, create mutex failed.\r\n"); 52 } else { 53 printf("[Mutex Test] osMutexNew, create mutex success.\r\n"); 54 } 55 56 osThreadId_t tid1 = newThread("Thread_1", number_thread, &mid); 57 osThreadId_t tid2 = newThread("Thread_2", number_thread, &mid); 58 osThreadId_t tid3 = newThread("Thread_3", number_thread, &mid); 59 60 osDelay(13); 61 osThreadId_t tid = osMutexGetOwner(mid); 62 printf("[Mutex Test] osMutexGetOwner, thread id: %p, thread name: %s.\r\n", tid, osThreadGetName(tid)); 63 osDelay(17); 64 65 osThreadTerminate(tid1); 66 osThreadTerminate(tid2); 67 osThreadTerminate(tid3); 68 osMutexDelete(mid); 69} 70``` 71 72 73 74## 三、如何编译 75 761. 将此目录下的 `mutex.c` 和 `BUILD.gn` 复制到openharmony源码的`applications\sample\wifi-iot\app\iothardware`目录下， 772. 修改openharmony源码的`applications\sample\wifi-iot\app\BUILD.gn`文件，将其中的 `features` 改为： 78 79``` 80 features = [ 81 "iothardware:mutex_demo", 82 ] 83``` 84 853. 在openharmony源码顶层目录执行：`python build.py wifiiot` 86 87## 四、运行结果 88 89截取部分运行结果 90 91``` 92[Mutex Test] osMutexNew, create mutex success. 93[Mutex Test] osThreadNew(Thread_1) success, thread id: 0xe84c4. 94RTOSV2.0_TES[Mutex Test] Thread_1 gets an odd value 1. 95[Mutex Test] Thread_2 gets an even value 2. 96T: osThreadNew(Thread_2) success, thread id: 0xe871c. 97[Mutex Test] osThreadNew(Thread_3) success, thread id: 0xe8910. 98[Mutex Test] Thread_3 gets an odd value 3. 99[Mutex Test] Thread_1 gets an even value 4. 100[Mutex Test] Thread_2 gets an odd value 5. 101[Mutex Test] Thread_3 gets an even value 6. 102[Mutex Test] Thread_1 gets an odd value 7. 103[Mutex Test] Thread_2 gets an even value 8. 104[Mutex Test] Thread_3 gets an odd value 9. 105[Mutex Test] osMutexGetOwner, thread id: 0xe8910, thread name: Thread_3. 106[Mutex Test] Thread_1 gets an even value 10. 107[Mutex Test] Thread_2 gets an odd value 11. 108[Mutex Test] Thread_3 gets an even value 12. 109``` 110 111### 【套件支持】 112 113##### 1. 套件介绍 http://www.hihope.org/pro/pro1.aspx?mtt=8 114 115##### 2. 套件购买 https://item.taobao.com/item.htm?id=622343426064&scene=taobao_shop 116 117##### 3. 技术资料 118 119- Gitee码云网站（OpenHarmony Sample Code等) **https://gitee.com/hihopeorg** 120 121- HiHope官网-资源中心（SDK包、技术文档下载）[**www.hihope.org**](http://www.hihope.org/) 122 123##### 4. 互动交流 124 125- 润和HiHope技术交流-微信群（加群管理员微信13605188699，发送文字#申请加入润和官方群#，予以邀请入群） 126- HiHope开发者社区-论坛 **https://bbs.elecfans.com/group_1429** 127- 润和HiHope售后服务群（QQ：980599547） 128- 售后服务电话（025-52668590） 129 130
){kind=link}
){kind=link}