开放平台接口nova os interface user guide

1、文档 NOVA-API-OS-V1.1发布日期 2013-12-02 17:03接口说明LongSung Technology(Shanghai) Co.,.科技()归科技()本文档受中人不得在民著作权法保护，所有，任何的情况下进行打印、发送、上传等操作。本文档包含的信息是的，接收人不得用于除规定外任何目的，也不得将本文档或文档中的内容给任何第。I目录I目录II修订IVV文档说明一、线程管理111223344666778891.1、create_task1.2、destory_task1.3、suspend_task1.4、resume_task1.5、terminate_task1.6、cu

2、rrent_task1.7、exit_task1.8、sleep二、定时器2.1、create_timer2.2、create_period_timer2.3、start_timer2.4、restart_timer2.5、stop_timer2.6、destroy_timer2.7、is_timer_active三、信号量1010101111133.1、create_semaphore3.2、destroy_semaphore3.3、get_semaphore3.4、put_semaphore四、互斥量II4.1、create_mutex131314141616161717191919202

3、02021212223232324254.2、destroy_mutex、get_mutex、put_mutex五、消息机制5.1、send_signal5.2、send_signal_front5.3、get_signal5.4、peek_signal六、临界区、enter_critical_section、leave_critical_section七、日期时间、get_date_time、set_date_time7.3、convert_time7.4、get_system_time7.5、get_tick_count八、随机数8.1、srand8.2、rand备注说明参考资料III修订

4、V1.0V1.12013.05.162013.12.02创建文件修改文件一一IV版本号日 期修改修订人文档说明 说明此文档中定义的接口与 NOVA接口一一对应，供开发者快速查阅和参考。如果发现文档中有错误或纰漏，请及时反馈，以保证内容的正确和完整。注意：一些接口可能因升级而发生改变，所以请使用当前版本对应的此文档。 数据类型NOVA为保证的可移植性，对C语言的一些基本类型进行了，详见nova_types.h，常见类型如下表：VNOVA 类型C 语言类型CHARcharUCHARunsigned charSCHARsigned charSHORTshortUSHORTunsigned short

5、SSHORTsigned shortWCHARunsigned shortPCHARchar*FLOATfloatDOUBLEdoubleNULL0VOIDvoidBOOLcharTRUE1FALSE0EXTERNexternDPARAMvoid*NOVA 类型C 语言类型8signed charU8unsigned charS8signed char16signed shortU16unsigned shortS16signed short32signed longU32unsigned longS32signed longUunsignedSsignedLONGlongULONGunsig

6、ned longSLONGsigned longCONSTconstSICsic一、线程管理1.1、create_task创建一个线程。 参数： 返回：创建成功时，返回线程的句柄。创建失败时，返回 NOVA_INVALID_THREAD。具体实例请参考相关 Demo 代码。1.2、destory_task销毁一个线程。 参数：1参数类型默认说明threadNameCHAR*线程名queueNameCHAR*消息队列名entryTHREAD_ENTRY函数argcU32参数个数argvVOID*参数列表stackSizeU16栈空间大小queueNumU16队列数量priorityE_NOVA_

7、PRIOR优先级autoStartBOOL是否自启动 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。1.3、suspend_task挂起一个线程。 参数：参数类型默认说明 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。1.4、resume_task恢复一个挂起的线程。 参数：参数类型默认说明2hThreadHANDLE*线程句柄参数类型默认说明hThreadHANDLE*线程句柄 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。1.5、terminate_task终止一个线程。 参数：参数类型默认说明 返回：TRUE/FALSE。具体实例请参

8、考相关 Demo 代码。1.6、current_task获取当前线程。 参数：无。3hThreadHANDLE*线程句柄hThreadHANDLE*线程句柄 返回：当前线程句柄。具体实例请参考相关 Demo 代码。1.7、exit_task退出线程。 参数：无。 返回：无。具体实例请参考相关 Demo 代码。1.8、sleep线程延迟。 参数： 返回：无。4参数类型默认说明timesU32*延迟毫秒数具体实例请参考相关 Demo 代码。5二、定时器2.1、create_timer创建一个定时器。 参数： 返回：创建成功时，返回定时器的句柄。创建失败时，返回 0。具体实例请参考相关 Demo 代

9、码。2.2、create_period_timer创建一个周期定时器。 参数：参数 func param times类型 TIMER_CALLBACK VOID*默认说明定时器回调回调参数定时器周期毫秒数U326参数类型默认说明funcTIMER_CALLBACK定时器回调paramVOID*回调参数timesU32定时器周期毫秒数autoStartBOOL是否自启动 返回：创建成功时，返回定时器的句柄。创建失败时，返回 0。具体实例请参考相关 Demo 代码。2.3、start_timer启动定时器。 参数：参数hTimer类型HANDLE默认说明定时器句柄 返回：TRUE/FALSE。具体

10、实例请参考相关 Demo 代码。2.4、restart_timer重启定时器。7autoStartBOOL是否自启动 参数：参数 hTimer func times类型HANDLE TIMER_CALLBACK默认说明定时器句柄定时器回调定时器周期毫秒数U32 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。2.5、stop_timer终止一个定时器。 参数：参数hTimer类型HANDLE默认说明定时器句柄 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。2.6、destroy_timer销毁一个定时器。8 参数：参数hTimer类型HANDLE默认说明定时器

11、句柄 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。2.7、is_timer_active判断定时器是否是活动状态。 参数：参数hTimer类型HANDLE默认说明定时器句柄 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。9三、信号量3.1、create_semaphore创建一个信号量。 参数：参数 name initCount类型CHAR*默认说明信号量名称初始计数值U32 返回：创建成功时，返回信号量的句柄。创建失败时，返回 0。具体实例请参考相关 Demo 代码。3.2、destroy_semaphore销毁一个信号量。 参数：参数hSem类型HAN

12、DLE默认说明信号量句柄 返回：10TRUE/FALSE。具体实例请参考相关 Demo 代码。3.3、get_semaphore获取信号量。 参数：参数 hSem waitOption类型HANDLE默认说明信号量句柄等待选项U32 返回：TRUE/FALSE。waitOption（等待选项）可以是 NOVA_WAIT_FOREVER、NOVA_WAIT_NONE 或等待时间（10 x0FE 毫秒）具体实例请参考相关 Demo 代码。3.4、put_semaphore信号量。 参数：参数hSem类型HANDLE默认说明信号量句柄11 返回：TRUE/FALSE。具体实例请参考相关 Demo 代

13、码。12四、互斥量4.1、create_mutex创建一个互斥量。 参数：参数 name inherit类型 CHAR* BOOL默认说明互斥量名称是否继承 返回：创建成功时，返回互斥量的句柄。创建失败时，返回 0。具体实例请参考相关 Demo 代码。4.2、destroy_mutex销毁一个互斥量。 参数：参数hSem类型HANDLE默认说明互斥量句柄 返回：13TRUE/FALSE。具体实例请参考相关 Demo 代码。4.3、get_mutex获取互斥量。 参数：参数 hSem waitOption类型HANDLE默认说明互斥量句柄等待选项U32 返回：TRUE/FALSE。waitOpt

14、ion（等待选项）可以是 NOVA_WAIT_FOREVER、NOVA_WAIT_NONE 或等待时间（10 x0FE 毫秒）具体实例请参考相关 Demo 代码。4.4、put_mutex互斥量。 参数：参数hSem类型HANDLE默认说明互斥量句柄14 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。15五、消息机制5.1、send_signal发送一个消息。 参数：参数 hThread signalPtr类型 HANDLE VOID*默认说明线程句柄消息内容 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。5.2、send_signal_front发送一个消

15、息至队列前端。 参数：参数 hThread signalPtr类型 HANDLE VOID*默认说明线程句柄消息内容 返回：TRUE/FALSE。16具体实例请参考相关 Demo 代码。5.3、get_signal从消息队列获取一个消息，如果队列为空，则等待。 参数：参数hThread类型HANDLE默认说明线程句柄 返回：消息内容。具体实例请参考相关 Demo 代码。5.4、peek_signal从消息队列获取一个消息，如果队列为空，则返回空。 参数：参数hThread类型HANDLE默认说明线程句柄 返回：消息内容。17具体实例请参考相关 Demo 代码。18六、临界区6.1、enter_

16、critical_section进入临界区。 参数：无。 返回：无。具体实例请参考相关 Demo 代码。6.2、leave_critical_section离开临界区。 参数：无。 返回：无。具体实例请参考相关 Demo 代码。19七、日期时间7.1、get_date_time获取系统的日期和时间。 参数：参数dateTime类型NOVA_DATE_TIME*默认说明日期时间指针 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。7.2、set_date_time设置系统的日期和时间。 参数：参数dateTime类型NOVA_DATE_TIME*默认说明日期时间指针 返回：TRUE/FALSE。20具体实例请参考相关 Demo 代码。7.3、convert_time日期时间与时间戳转换。 参数：参数datetime_ptr类型NOVA_DATE_TIME*默认说明日期时间指针U32*timest_ptr时间戳toTimestBOOL是:正向转换，否:反向转换 返回：TRUE/FALSE。具体实例请参考相关 Demo 代码。7.4、get_system_time获取系统的时间。 参数：无。 返回：返回从 2000/01/0 起的秒数。21