OSAL的應(yīng)用編程接口

OSAL的應(yīng)用編程接口無線組網(wǎng)技術(shù)*CONTENTSPAGE目錄頁1編程接口函數(shù)分類編程接口函數(shù)介紹2目錄無線組網(wǎng)技術(shù)*

1.編程接口函數(shù)分類OSAL的應(yīng)用編程接口無線組網(wǎng)技術(shù)編程接口函數(shù)分類OSAL提供了API（ApplicationProgrammingInterface）對(duì)協(xié)議棧進(jìn)行管理

根據(jù)不同的應(yīng)用，可以分為消息管理任務(wù)同步時(shí)間管理中斷管理任務(wù)管理內(nèi)存管理電源管理非易失存儲(chǔ)管理OSAL的應(yīng)用編程接口一些API函數(shù)及主要功能函數(shù)名稱功能描述voidosal_nv_init()初始化FLASH存儲(chǔ)器uint8osal_init_system()初始化操作系統(tǒng)voidosal_mem_init()初始化內(nèi)存分配系統(tǒng)voidosalTimerInit()初始化定時(shí)器voidosalInitTasks()初始化系統(tǒng)任務(wù)voidosal_start_system()進(jìn)入操作系統(tǒng)voidosal_run_system()運(yùn)行操作系統(tǒng)voidosalTimeUpdate()操作系統(tǒng)時(shí)間更新voidHal_ProcessPoll()硬件層檢查OSAL的應(yīng)用編程接口*

2.編程接口函數(shù)介紹無線組網(wǎng)技術(shù)OSAL的應(yīng)用編程接口消息管理

負(fù)責(zé)消息緩存分配、釋放、接收、發(fā)送等uint8*osal_msg_allocate(uint16len)申請(qǐng)消息緩存區(qū)，該函數(shù)調(diào)用void*osal_mem_alloc(uint16size)函數(shù)實(shí)現(xiàn)，從堆中申請(qǐng)存儲(chǔ)空間

uint8osal_msg_deallocate(uint8*msg_ptr)接收到消息的任務(wù)處理完成后釋放消息緩存空間

uint8osal_msg_send(uint8destination_task,uint8*msg_ptr)發(fā)送消息到指定任務(wù)，將消息放入隊(duì)列，并把任務(wù)的相應(yīng)事件標(biāo)志置位

uint8*osal_msg_receive(uint8task_id)消息接收，在任務(wù)處理完消息后，必修釋放消息的存儲(chǔ)空間。該函數(shù)查找消息隊(duì)列，如果消息隊(duì)列中有多個(gè)發(fā)送給該任務(wù)的消息，保持事件標(biāo)志位

osal_event_hdr_t*osal_msg_find(uint8task_id,uint8event)尋找消息：發(fā)送給具有某個(gè)事件的任務(wù)的消息OSAL的應(yīng)用編程接口任務(wù)同步

負(fù)責(zé)任務(wù)間的時(shí)間同步，允許一個(gè)任務(wù)等待一個(gè)事件的發(fā)生uint8osal_set_event(uint8task_id,uint16event_flag)設(shè)置任務(wù)的事件標(biāo)志。event_flag為16位，只有一個(gè)系統(tǒng)事件SYS_EVENT_MSG，其余的事件都是用戶定義的事件。OSAL的應(yīng)用編程接口時(shí)間管理

允許內(nèi)部任務(wù)以及應(yīng)用層任務(wù)使用定時(shí)器，函數(shù)提供了啟動(dòng)和停止定時(shí)器的功能，定時(shí)器最小增量為1毫秒。uint8osal_start_timerEx(uint8taskID,uint16event_id,uint16timeout_value)為某個(gè)任務(wù)啟動(dòng)一個(gè)定時(shí)器，taskID為任務(wù)ID，event_id為用戶指定的事件標(biāo)志位，timeout_value為超時(shí)時(shí)間，以ms為單位

uint8osal_start_reload_timer(uint8taskID,uint16event_id,uint16timeout_value)啟動(dòng)定時(shí)器，與上一個(gè)函數(shù)不同的是該函數(shù)設(shè)置的定時(shí)器超時(shí)后被重新裝載

uint8osal_stop_timerEx(uint8task_id,uint16event_id)停止一個(gè)已經(jīng)開始的定時(shí)器

uint32osal_GetSystemClock(void)獲取系統(tǒng)時(shí)間，返回值以ms為單位OSAL的應(yīng)用編程接口中斷管理

負(fù)責(zé)外部中斷的開啟和停止uint8osal_int_enable(uint8interrupt_id)允許某個(gè)中斷

uint8osal_int_disable(uint8interrupt_id)禁止某個(gè)中斷OSAL的應(yīng)用編程接口任務(wù)管理

負(fù)責(zé)對(duì)OSAL的任務(wù)進(jìn)行管理osal_init_system()該函數(shù)初始化OSAL系統(tǒng)。該函數(shù)必須在啟動(dòng)任何一個(gè)OSAL函數(shù)之前被調(diào)用

osal_start_system()這個(gè)函數(shù)是系統(tǒng)任務(wù)的主循環(huán)函數(shù)，在循環(huán)里面將遍歷所有的任務(wù)事件，為觸發(fā)事件的任務(wù)調(diào)用任務(wù)事件處理函數(shù)。如果一個(gè)特定任務(wù)有事件發(fā)送，那么該函數(shù)就將調(diào)用該任務(wù)的事件處理函數(shù)。當(dāng)事件處理完之后，將返回主循環(huán)。繼續(xù)查找其他的任務(wù)事件。如果沒有事件，函數(shù)將把處理器轉(zhuǎn)到睡眠模式OSAL的應(yīng)用編程接口內(nèi)存管理

負(fù)責(zé)對(duì)內(nèi)存進(jìn)行管理

osal_mem_alloc()內(nèi)存分配函數(shù)，如果成功則返回一個(gè)緩沖區(qū)的指針osal_mem_free()釋放已分配的內(nèi)存來重新使用。只有當(dāng)內(nèi)存已使用osal_mem_alloc()分配過才可以工作OSAL的應(yīng)用編程接口電源管理

負(fù)責(zé)對(duì)電源進(jìn)行管理voidosal_pwrmgr_init(void)初始化電源管理模塊的變量，被osal_init_system()調(diào)用

voidosal_pwrmgr_powerconserve(void)使系統(tǒng)進(jìn)入節(jié)電模式，已經(jīng)在系統(tǒng)的主循環(huán)中被調(diào)用，不能調(diào)用

voidosal_pwrmgr_device(uint8pwrmgr_device)全局設(shè)備電源的開關(guān)

uint8osal_pwrmgr_task_state(uint8task_id,uint8state)控制任務(wù)節(jié)電狀態(tài)OSAL的應(yīng)用編程接口非易失性存儲(chǔ)器管理

非易失性存儲(chǔ)器（Non-VolatileMemory：NV）的操作耗時(shí)費(fèi)電，并且將暫時(shí)關(guān)閉中斷，最好在收發(fā)器關(guān)閉的時(shí)候調(diào)用這些函數(shù)

uint8osal_nv_item_init(uint16id,uint16len,void*buf)初始化一個(gè)NVitemuint8osal_nv_read(uint16id,uint16offset,uint16len,void*buf)讀取NVuint8osal_nv_write(uint16id,uint16offset,uint16len,void*buf)寫入NV

osal_