開放平臺(tái)接口nova os interface user guide

1、文檔 NOVA-API-OS-V1.1發(fā)布日期 2013-12-02 17:03接口說明LongSung Technology(Shanghai) Co.,.科技()歸科技()本文檔受中人不得在民著作權(quán)法保護(hù)，所有，任何的情況下進(jìn)行打印、發(fā)送、上傳等操作。本文檔包含的信息是的，接收人不得用于除規(guī)定外任何目的，也不得將本文檔或文檔中的內(nèi)容給任何第。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二、定時(shí)器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五、消息機(jī)制5.1、send_signal5.2、send_signal_front5.3、get_signal5.4、peek_signal六、臨界區(qū)、enter_critical_section、leave_critical_section七、日期時(shí)間、get_date_time、set_date_time7.3、convert_time7.4、get_system_time7.5、get_tick_count八、隨機(jī)數(shù)8.1、srand8.2、rand備注說明參考資料III修訂

4、V1.0V1.12013.05.162013.12.02創(chuàng)建文件修改文件一一IV版本號日 期修改修訂人文檔說明 說明此文檔中定義的接口與 NOVA接口一一對應(yīng)，供開發(fā)者快速查閱和參考。如果發(fā)現(xiàn)文檔中有錯(cuò)誤或紕漏，請及時(shí)反饋，以保證內(nèi)容的正確和完整。注意：一些接口可能因升級而發(fā)生改變，所以請使用當(dāng)前版本對應(yīng)的此文檔。 數(shù)據(jù)類型NOVA為保證的可移植性，對C語言的一些基本類型進(jìn)行了，詳見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創(chuàng)建一個(gè)線程。 參數(shù)： 返回：創(chuàng)建成功時(shí)，返回線程的句柄。創(chuàng)建失敗時(shí)，返回 NOVA_INVALID_THREAD。具體實(shí)例請參考相關(guān) Demo 代碼。1.2、destory_task銷毀一個(gè)線程。 參數(shù)：1參數(shù)類型默認(rèn)說明threadNameCHAR*線程名queueNameCHAR*消息隊(duì)列名entryTHREAD_ENTRY函數(shù)argcU32參數(shù)個(gè)數(shù)argvVOID*參數(shù)列表stackSizeU16?？臻g大小queueNumU16隊(duì)列數(shù)量priorityE_NOVA_

7、PRIOR優(yōu)先級autoStartBOOL是否自啟動(dòng) 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。1.3、suspend_task掛起一個(gè)線程。 參數(shù)：參數(shù)類型默認(rèn)說明 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。1.4、resume_task恢復(fù)一個(gè)掛起的線程。 參數(shù)：參數(shù)類型默認(rèn)說明2hThreadHANDLE*線程句柄參數(shù)類型默認(rèn)說明hThreadHANDLE*線程句柄 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。1.5、terminate_task終止一個(gè)線程。 參數(shù)：參數(shù)類型默認(rèn)說明 返回：TRUE/FALSE。具體實(shí)例請參

8、考相關(guān) Demo 代碼。1.6、current_task獲取當(dāng)前線程。 參數(shù)：無。3hThreadHANDLE*線程句柄hThreadHANDLE*線程句柄 返回：當(dāng)前線程句柄。具體實(shí)例請參考相關(guān) Demo 代碼。1.7、exit_task退出線程。 參數(shù)：無。 返回：無。具體實(shí)例請參考相關(guān) Demo 代碼。1.8、sleep線程延遲。 參數(shù)： 返回：無。4參數(shù)類型默認(rèn)說明timesU32*延遲毫秒數(shù)具體實(shí)例請參考相關(guān) Demo 代碼。5二、定時(shí)器2.1、create_timer創(chuàng)建一個(gè)定時(shí)器。 參數(shù)： 返回：創(chuàng)建成功時(shí)，返回定時(shí)器的句柄。創(chuàng)建失敗時(shí)，返回 0。具體實(shí)例請參考相關(guān) Demo 代

9、碼。2.2、create_period_timer創(chuàng)建一個(gè)周期定時(shí)器。 參數(shù)：參數(shù) func param times類型 TIMER_CALLBACK VOID*默認(rèn)說明定時(shí)器回調(diào)回調(diào)參數(shù)定時(shí)器周期毫秒數(shù)U326參數(shù)類型默認(rèn)說明funcTIMER_CALLBACK定時(shí)器回調(diào)paramVOID*回調(diào)參數(shù)timesU32定時(shí)器周期毫秒數(shù)autoStartBOOL是否自啟動(dòng) 返回：創(chuàng)建成功時(shí)，返回定時(shí)器的句柄。創(chuàng)建失敗時(shí)，返回 0。具體實(shí)例請參考相關(guān) Demo 代碼。2.3、start_timer啟動(dòng)定時(shí)器。 參數(shù)：參數(shù)hTimer類型HANDLE默認(rèn)說明定時(shí)器句柄 返回：TRUE/FALSE。具體

10、實(shí)例請參考相關(guān) Demo 代碼。2.4、restart_timer重啟定時(shí)器。7autoStartBOOL是否自啟動(dòng) 參數(shù)：參數(shù) hTimer func times類型HANDLE TIMER_CALLBACK默認(rèn)說明定時(shí)器句柄定時(shí)器回調(diào)定時(shí)器周期毫秒數(shù)U32 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。2.5、stop_timer終止一個(gè)定時(shí)器。 參數(shù)：參數(shù)hTimer類型HANDLE默認(rèn)說明定時(shí)器句柄 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。2.6、destroy_timer銷毀一個(gè)定時(shí)器。8 參數(shù)：參數(shù)hTimer類型HANDLE默認(rèn)說明定時(shí)器

11、句柄 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。2.7、is_timer_active判斷定時(shí)器是否是活動(dòng)狀態(tài)。 參數(shù)：參數(shù)hTimer類型HANDLE默認(rèn)說明定時(shí)器句柄 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。9三、信號量3.1、create_semaphore創(chuàng)建一個(gè)信號量。 參數(shù)：參數(shù) name initCount類型CHAR*默認(rèn)說明信號量名稱初始計(jì)數(shù)值U32 返回：創(chuàng)建成功時(shí)，返回信號量的句柄。創(chuàng)建失敗時(shí)，返回 0。具體實(shí)例請參考相關(guān) Demo 代碼。3.2、destroy_semaphore銷毀一個(gè)信號量。 參數(shù)：參數(shù)hSem類型HAN

12、DLE默認(rèn)說明信號量句柄 返回：10TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。3.3、get_semaphore獲取信號量。 參數(shù)：參數(shù) hSem waitOption類型HANDLE默認(rèn)說明信號量句柄等待選項(xiàng)U32 返回：TRUE/FALSE。waitOption（等待選項(xiàng)）可以是 NOVA_WAIT_FOREVER、NOVA_WAIT_NONE 或等待時(shí)間（10 x0FE 毫秒）具體實(shí)例請參考相關(guān) Demo 代碼。3.4、put_semaphore信號量。 參數(shù)：參數(shù)hSem類型HANDLE默認(rèn)說明信號量句柄11 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代

13、碼。12四、互斥量4.1、create_mutex創(chuàng)建一個(gè)互斥量。 參數(shù)：參數(shù) name inherit類型 CHAR* BOOL默認(rèn)說明互斥量名稱是否繼承 返回：創(chuàng)建成功時(shí)，返回互斥量的句柄。創(chuàng)建失敗時(shí)，返回 0。具體實(shí)例請參考相關(guān) Demo 代碼。4.2、destroy_mutex銷毀一個(gè)互斥量。 參數(shù)：參數(shù)hSem類型HANDLE默認(rèn)說明互斥量句柄 返回：13TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。4.3、get_mutex獲取互斥量。 參數(shù)：參數(shù) hSem waitOption類型HANDLE默認(rèn)說明互斥量句柄等待選項(xiàng)U32 返回：TRUE/FALSE。waitOpt

14、ion（等待選項(xiàng)）可以是 NOVA_WAIT_FOREVER、NOVA_WAIT_NONE 或等待時(shí)間（10 x0FE 毫秒）具體實(shí)例請參考相關(guān) Demo 代碼。4.4、put_mutex互斥量。 參數(shù)：參數(shù)hSem類型HANDLE默認(rèn)說明互斥量句柄14 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。15五、消息機(jī)制5.1、send_signal發(fā)送一個(gè)消息。 參數(shù)：參數(shù) hThread signalPtr類型 HANDLE VOID*默認(rèn)說明線程句柄消息內(nèi)容 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。5.2、send_signal_front發(fā)送一個(gè)消

15、息至隊(duì)列前端。 參數(shù)：參數(shù) hThread signalPtr類型 HANDLE VOID*默認(rèn)說明線程句柄消息內(nèi)容 返回：TRUE/FALSE。16具體實(shí)例請參考相關(guān) Demo 代碼。5.3、get_signal從消息隊(duì)列獲取一個(gè)消息，如果隊(duì)列為空，則等待。 參數(shù)：參數(shù)hThread類型HANDLE默認(rèn)說明線程句柄 返回：消息內(nèi)容。具體實(shí)例請參考相關(guān) Demo 代碼。5.4、peek_signal從消息隊(duì)列獲取一個(gè)消息，如果隊(duì)列為空，則返回空。 參數(shù)：參數(shù)hThread類型HANDLE默認(rèn)說明線程句柄 返回：消息內(nèi)容。17具體實(shí)例請參考相關(guān) Demo 代碼。18六、臨界區(qū)6.1、enter_

16、critical_section進(jìn)入臨界區(qū)。 參數(shù)：無。 返回：無。具體實(shí)例請參考相關(guān) Demo 代碼。6.2、leave_critical_section離開臨界區(qū)。 參數(shù)：無。 返回：無。具體實(shí)例請參考相關(guān) Demo 代碼。19七、日期時(shí)間7.1、get_date_time獲取系統(tǒng)的日期和時(shí)間。 參數(shù)：參數(shù)dateTime類型NOVA_DATE_TIME*默認(rèn)說明日期時(shí)間指針 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。7.2、set_date_time設(shè)置系統(tǒng)的日期和時(shí)間。 參數(shù)：參數(shù)dateTime類型NOVA_DATE_TIME*默認(rèn)說明日期時(shí)間指針 返回：TRUE/FALSE。20具體實(shí)例請參考相關(guān) Demo 代碼。7.3、convert_time日期時(shí)間與時(shí)間戳轉(zhuǎn)換。 參數(shù)：參數(shù)datetime_ptr類型NOVA_DATE_TIME*默認(rèn)說明日期時(shí)間指針U32*timest_ptr時(shí)間戳toTimestBOOL是:正向轉(zhuǎn)換，否:反向轉(zhuǎn)換 返回：TRUE/FALSE。具體實(shí)例請參考相關(guān) Demo 代碼。7.4、get_system_time獲取系統(tǒng)的時(shí)間。 參數(shù)：無。 返回：返回從 2000/01/0 起的秒數(shù)。21