1# HiSpark WiFi-IoT 开发套件样例开发--线程（Thread） 2 3 4 5[HiSpark WiFi-IoT开发套件]首发于HDC 2020，是首批支持OpenHarmony 2.0的开发套件，亦是官方推荐套件，由润和软件HiHope量身打造，已在OpenHarmony社区和广大OpenHarmony开发者中得到广泛应用。 6 7 8 9## 一、Thread API 10 11| API名称 | 说明 | 12| --------------------- | ------------------------------------------------------ | 13| osThreadNew | 创建一个线程并将其加入活跃线程组中 | 14| osThreadGetName | 返回指定线程的名字 | 15| osThreadGetId | 返回当前运行线程的线程ID | 16| osThreadGetState | 返回当前线程的状态 | 17| osThreadSetPriority | 设置指定线程的优先级 | 18| osThreadGetPriority | 获取当前线程的优先级 | 19| osThreadYield | 将运行控制转交给下一个处于READY状态的线程 | 20| osThreadSuspend | 挂起指定线程的运行 | 21| osThreadResume | 恢复指定线程的运行 | 22| osThreadDetach | 分离指定的线程（当线程终止运行时，线程存储可以被回收） | 23| osThreadJoin | 等待指定线程终止运行 | 24| osThreadExit | 终止当前线程的运行 | 25| osThreadTerminate | 终止指定线程的运行 | 26| osThreadGetStackSize | 获取指定线程的栈空间大小 | 27| osThreadGetStackSpace | 获取指定线程的未使用的栈空间大小 | 28| osThreadGetCount | 获取活跃线程数 | 29| osThreadEnumerate | 获取线程组中的活跃线程数 | 30 31### osThreadNew() 32 33```c 34osThreadId_t osThreadNew(osThreadFunc_t func, void *argument,const osThreadAttr_t *attr ) 35``` 36 37> **注意** :不能在中断服务调用该函数 38 39**参数：** 40 41| 名字 | 描述 | 42| :------- | :------------------------------- | 43| func | 线程函数. | 44| argument | 作为启动参数传递给线程函数的指针 | 45| attr | 线程属性 | 46 47### osThreadTerminate() 48 49```c 50osStatus_t osThreadTerminate (osThreadId_t thread_id) 51``` 52 53| 名字 | 描述 | 54| --------- | ---------------------------------------------------- | 55| thread_id | 指定线程id，该id是由osThreadNew或者osThreadGetId获得 | 56 57## 二、代码分析 58 59创建线程，创建成功则打印线程名字和线程ID 60 61``` 62osThreadId_t newThread(char *name, osThreadFunc_t func, void *arg) { 63 osThreadAttr_t attr = { 64 name, 0, NULL, 0, NULL, 1024*2, osPriorityNormal, 0, 0 65 }; 66 osThreadId_t tid = osThreadNew(func, arg, &attr); 67 if (tid == NULL) { 68 printf("osThreadNew(%s) failed.\r\n", name); 69 } else { 70 printf("osThreadNew(%s) success, thread id: %d.\r\n", name, tid); 71 } 72 return tid; 73} 74``` 75 76该函数首先会打印自己的参数，然后对全局变量count进行循环+1操作，之后会打印count的值 77 78``` 79void threadTest(void *arg) { 80 static int count = 0; 81 printf("%s\r\n",(char *)arg); 82 osThreadId_t tid = osThreadGetId(); 83 printf("threadTest osThreadGetId, thread id:%p\r\n", tid); 84 while (1) { 85 count++; 86 printf("threadTest, count: %d.\r\n", count); 87 osDelay(20); 88 } 89} 90``` 91 92主程序rtosv2_thread_main创建线程并运行，并使用上述API进行相关操作，最后终止所创建的线程。 93 94``` 95void rtosv2_thread_main(void *arg) { 96 (void)arg; 97 osThreadId_t tid=newThread("test_thread", threadTest, "This is a test thread."); 98 99 const char *t_name = osThreadGetName(tid); 100 printf("[Thread Test]osThreadGetName, thread name: %s.\r\n", t_name); 101 102 osThreadState_t state = osThreadGetState(tid); 103 printf("[Thread Test]osThreadGetState, state :%d.\r\n", state); 104 105 osStatus_t status = osThreadSetPriority(tid, osPriorityNormal4); 106 printf("[Thread Test]osThreadSetPriority, status: %d.\r\n", status); 107 108 osPriority_t pri = osThreadGetPriority (tid); 109 printf("[Thread Test]osThreadGetPriority, priority: %d.\r\n", pri); 110 111 status = osThreadSuspend(tid); 112 printf("[Thread Test]osThreadSuspend, status: %d.\r\n", status); 113 114 status = osThreadResume(tid); 115 printf("[Thread Test]osThreadResume, status: %d.\r\n", status); 116 117 uint32_t stacksize = osThreadGetStackSize(tid); 118 printf("[Thread Test]osThreadGetStackSize, stacksize: %d.\r\n", stacksize); 119 120 uint32_t stackspace = osThreadGetStackSpace(tid); 121 printf("[Thread Test]osThreadGetStackSpace, stackspace: %d.\r\n", stackspace); 122 123 uint32_t t_count = osThreadGetCount(); 124 printf("[Thread Test]osThreadGetCount, count: %d.\r\n", t_count); 125 126 osDelay(100); 127 status = osThreadTerminate(tid); 128 printf("[Thread Test]osThreadTerminate, status: %d.\r\n", status); 129} 130``` 131 132## 三、如何编译 133 1341. 将此目录下的 `thread.c` 和 `BUILD.gn` 复制到openharmony源码的`applications\sample\wifi-iot\app\iothardware`目录下， 1352. 修改openharmony源码的`applications\sample\wifi-iot\app\BUILD.gn`文件，将其中的 `features` 改为： 136 137``` 138 features = [ 139 "iothardware:thread_demo", 140 ] 141``` 142 1433. 在openharmony源码顶层目录执行：`python build.py wifiiot` 144 145## 四、运行结果 146 147``` 148[Thread Test] osThreadNew(test_thread) success. 149[Thread Test] osThreadGetName, thread name: test_thread. 150[Thread Test] osThreadGetState, state :1. 151[Thread Test] This is a test thread. <-testThread log 152[Thread Test] threadTest osThreadGetId, thread id:0xe8544 153[Thread Test] threadTest, count: 1. <-testThread log 154[Thread Test] osThreadSetPriority, status: 0. 155[Thread Test] osThreadGetPriority, priority: 28. 156[Thread Test] osThreadSuspend, status: 0. 157[Thread Test] osThreadResume, status: 0. 158[Thread Test] osThreadGetStackSize, stacksize: 2048. 159[Thread Test] osThreadGetStackSpace, stackspace: 1144. 160[Thread Test] osThreadGetCount, count: 12. 161[Thread Test] threadTest, count: 2. <-testThread log 162[Thread Test] threadTest, count: 3. <-testThread log 163[Thread Test] threadTest, count: 4. <-testThread log 164[Thread Test] threadTest, count: 5. <-testThread log 165[Thread Test] threadTest, count: 6. <-testThread log 166[Thread Test] osThreadTerminate, status: 0. 167``` 168 169### 【套件支持】 170 171##### 1. 套件介绍 http://www.hihope.org/pro/pro1.aspx?mtt=8 172 173##### 2. 套件购买 https://item.taobao.com/item.htm?id=622343426064&scene=taobao_shop 174 175##### 3. 技术资料 176 177- Gitee码云网站（OpenHarmony Sample Code等) **https://gitee.com/hihopeorg** 178 179- HiHope官网-资源中心（SDK包、技术文档下载）[**www.hihope.org**](http://www.hihope.org/) 180 181##### 4. 互动交流 182 183- 润和HiHope技术交流-微信群（加群管理员微信13605188699，发送文字#申请加入润和官方OpenHarmony群#，予以邀请入群） 184- HiHope开发者社区-论坛 **https://bbs.elecfans.com/group_1429** 185- 润和HiHope售后服务群（QQ：980599547） 186- 售后服务电话（025-52668590） 187 188
){kind=link}
){kind=link}