README.md
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}