Draft lite V1.0
EZ-LINK平臺開發(fā)手冊
1 平臺簡介
1.1 PCB設(shè)計
1.2 SDK架構(gòu)
1.3 源碼目錄
2 開發(fā)環(huán)境
2.1 配置文件
2.2 庫文件
2.3 IDE配置
2.4 編程框架
2.5 燒錄Flash
2.6 調(diào)試
3 IOT接口
3.1 系統(tǒng)服務(wù)
3.2 硬件服務(wù)
3.3 WIFI
3.4 Bluetooth
3.5 GSM
3.6 GPS
縮略詞：
BCPU
Baseband CPU
BTCPU
Bluetooth CPU
XCPU
System CPU
BSS
Basic Service Set
BSSID
BSS ID
COS
Common Operating System
1 平臺簡介 EZ-Link是RDA物聯(lián)網(wǎng)應(yīng)用集成開發(fā)平臺，該平臺包括SDK開發(fā)包，Eclipse集成開發(fā)環(huán)境，調(diào)試工具和燒錄工具。SDK開發(fā)包提供了在EZ-Link平臺進(jìn)行物聯(lián)網(wǎng)開發(fā)必需的模塊和標(biāo)準(zhǔn)API接口，同時通過對硬件層抽象，提供對RDA物聯(lián)網(wǎng)系列芯片的全面支持。 RDA物聯(lián)網(wǎng)系列芯片即有獨(dú)立藍(lán)牙、WIFI芯片，也有在SoC上集成Wi-Fi、Bluetooth和GSM功能的組合芯片,并提供包括UART/ADC/I2S在內(nèi)的硬件接口。 RDA特有的共存技術(shù)使用戶可以獨(dú)立或并行使用Wi-Fi及藍(lán)牙功能。 本文闡述EZ-Link平臺SDK的主要功能和使用方法。本文所描述SDK為精簡版，該版本針對物聯(lián)網(wǎng)設(shè)備開發(fā)周期短、市場反應(yīng)敏感等特點(diǎn)，對EZ-Link SDK進(jìn)行了一系列優(yōu)化升級，以幫助客戶提高開發(fā)效率。用戶僅需要了解必要的接口，然后通過SDK提供的豐富示例代碼，簡單修改甚至零修改就可以實(shí)現(xiàn)一款完整的物聯(lián)網(wǎng)應(yīng)用。 1.1 PCB設(shè)計請參考各芯片數(shù)據(jù)手冊。
1.2 SDK架構(gòu)EZ-Link SDK具有模塊化、可擴(kuò)展的架構(gòu)和清晰的層次結(jié)構(gòu)，靈活的SDK架構(gòu)為產(chǎn)品定制提供軟件支撐，用戶可以根據(jù)不同市場需求和變化，進(jìn)行快速調(diào)整。
EZ-Link SDK的架構(gòu)如下，每一部分將會在下面具體描述。
除了APP應(yīng)用層需要客戶完成，其余模塊將由RDA統(tǒng)一打包發(fā)布給客戶。 圖1-1 EZ-Link SDK架構(gòu)
最底層為硬件層，包括芯片和外設(shè)硬件。
第二層為硬件抽象層，該層隱藏底層硬件細(xì)節(jié)，為上層驅(qū)動提供統(tǒng)一接口，為實(shí)現(xiàn)不同芯片間平滑切換提供軟件支持。
第三層為驅(qū)動和操作系統(tǒng)層。RDA在RTOS之上又提供了一層瘦COS層，該COS層封裝了核心操作系統(tǒng)接口如任務(wù)調(diào)度，并發(fā)處理等，為服務(wù)層提供統(tǒng)一接口。COS層為用戶提供兩方面便利：用戶可以隨心所欲選擇自己偏好的操作系統(tǒng)；用戶可以移植已有的應(yīng)用程序，復(fù)用代碼，提高代碼利用效率，加速開發(fā)進(jìn)度。
第四層為服務(wù)層，服務(wù)層應(yīng)用程序類似windows服務(wù)程序或linux deamon程序，這些程序長時間執(zhí)行，為上層用戶和應(yīng)用提供特定的服務(wù)，如http，GPS服務(wù)等。上層用戶可以通過標(biāo)準(zhǔn)接口使用服務(wù)層程序提供的服務(wù)，如多媒體應(yīng)用程序可以通過GUI接口顯示播放界面，同時可以通過media服務(wù)進(jìn)行音頻數(shù)據(jù)解碼和播放。服務(wù)層應(yīng)用程序通常為操作系統(tǒng)的任務(wù)(task)，該任務(wù)直接調(diào)用COS接口以降低與RTOS的耦合。 服務(wù)層應(yīng)用程序十分豐富，可以滿足當(dāng)前主流的物聯(lián)網(wǎng)應(yīng)用。良好的可擴(kuò)展架構(gòu)使用戶可以添加更多自有服務(wù)程序或第三方應(yīng)用程序，滿足客戶特殊的產(chǎn)品需求。 該層同時提供精簡的IOT API，通過精簡IOT API，用戶可以快速開發(fā)一款簡單的物聯(lián)網(wǎng)應(yīng)用，如智能水杯等。
最高層為應(yīng)用程序?qū)樱脩敉ǔ９ぷ髟诒緦印?yīng)用程序?qū)油ㄟ^調(diào)用服務(wù)層接口進(jìn)行軟件開發(fā)。
EZ-Link各層之間以松散的方式耦合，各層提供的接口和實(shí)現(xiàn)分離，層內(nèi)關(guān)注實(shí)現(xiàn)，層間關(guān)注接口。除此之外，EZ-Link SDK同樣遵循模塊化設(shè)計原則，方便用戶對產(chǎn)品特性進(jìn)行裁剪以適應(yīng)客戶需求，發(fā)揮用戶平臺、硬件資源的最大效率:
| RDA 芯片為本SDK設(shè)計參照的核心，芯片類型決定系統(tǒng)的CPU硬件架構(gòu)、IO接口、總線等特性，進(jìn)而影響服務(wù)層提供的服務(wù)、產(chǎn)品特性和源碼編譯等。芯片模塊化使用戶在無需修改上層軟件的情況下，根據(jù)需求選擇適當(dāng)?shù)男酒?/div> | | 目前市面上嵌入式實(shí)時操作系統(tǒng)種類繁多，用戶可以根據(jù)自己的偏好和使用習(xí)慣選擇操作系統(tǒng)而不影響其他應(yīng)用 | | 用戶通常有更換外設(shè)的需求，驅(qū)動模塊化正是滿足該項需求 | | 服務(wù)層模塊化，有效減少各個子模塊之間耦合，方便用戶刪減與特定產(chǎn)品無關(guān)服務(wù)，添加新服務(wù) |
本SDK支持多種RDA芯片。豐富的IO接口方便連接各種外設(shè) 硬件抽象層為上層驅(qū)動提供統(tǒng)一接口，方便驅(qū)動程序移植 驅(qū)動模塊包括：GPIO,、UART、flash、LCD等 強(qiáng)大的實(shí)時操作系統(tǒng)： - 支持多任務(wù)處理
- 定時器管理
- 支持并發(fā)訪問控制鎖和任務(wù)間同步信號量
- 任務(wù)間通信機(jī)制
- 動態(tài)內(nèi)存管理和glibc兼容的內(nèi)存操作接口
提供對RTOS封裝，可針對不同RTOS進(jìn)行適配，使服務(wù)層和應(yīng)用層程序擺脫對操作系統(tǒng)依賴 EZ-Link將系統(tǒng)功能抽象成模塊化的服務(wù)，并提供標(biāo)準(zhǔn)的服務(wù)接口，極大簡化編程過程。針對物聯(lián)網(wǎng)特點(diǎn)，EZ-Link提供豐富的網(wǎng)絡(luò)協(xié)議，方便不同設(shè)備商之間的智能設(shè)備互聯(lián)互通： - 支持AllSeen協(xié)議
- 支持lwIP協(xié)議棧和http等應(yīng)用層協(xié)議，方便擴(kuò)展互聯(lián)網(wǎng)應(yīng)用
- 多媒體功能，音頻、視頻等
- GPS定位服務(wù)
- 支持DLNA協(xié)議
- GSM/GPRS服務(wù)
- 硬件層服務(wù)，主要針對GPIO、UART等串行總線接口
- OS服務(wù)，主要封裝定時器、內(nèi)存操作、調(diào)試等接口
簡易IOT接口，簡化編程，快速生成IOT應(yīng)用，實(shí)現(xiàn)簡單IOT產(chǎn)品 相對簡單應(yīng)用程序?qū)樱瑢?shí)現(xiàn)更復(fù)雜的物聯(lián)網(wǎng)應(yīng)用
1.3 源碼目錄SDK源碼目錄結(jié)構(gòu)如下，各個目錄將會在下面詳細(xì)描述。
圖1-2 EZ-Link SDK源碼目錄結(jié)構(gòu) 圖中各目錄模塊說明如下：
| | | | | RDA IOT平臺代碼，其下包括：chip、edrv、 rtos、 service等子目錄，子目錄會在下面依次說明 | | 平臺芯片相關(guān)代碼，包括：boot loader，hal層，寄存器地址定義和rom代碼。通常用戶無需修改rom代碼 | | 包括外設(shè)驅(qū)動和芯片內(nèi)驅(qū)動，外設(shè)驅(qū)動包括：LCD，F(xiàn)M等；芯片內(nèi)部驅(qū)動為內(nèi)部總線驅(qū)動，如GPIO，UART等 | | 實(shí)時操作系統(tǒng)層，該目錄包括原生操作系統(tǒng) | | | | | 網(wǎng)絡(luò)服務(wù)，提供http，lwna，tcp/ip操作接口 | | | | | | | | | | | | | | | | | | 影子目錄，該目錄在編譯時由編譯腳本生成，用來存放編譯過程中生成的臨時文件 | | | | Lod文件、Ramrun文件和其他GDB相關(guān)asm及map文件 |
表1-1 EZ-LINK SDK目錄結(jié)構(gòu)描述
2 開發(fā)環(huán)境EZ-LINK選用windows操作系統(tǒng)作主機(jī)（HOST），在windows系統(tǒng)中搭建交叉編譯環(huán)境。 2.1 配置文件模塊化的設(shè)計為用戶定制產(chǎn)品提供了便利。通常定制產(chǎn)品通過修改配置文件來完成。配置文件在target目錄，EZ-LINK配置文件主要涉及以下幾個：
| | | 產(chǎn)品配置，target表示產(chǎn)品、開發(fā)板 | | 對target.def信息的集中處理，通常不需要用戶修改 | | | | 用戶功能宏頭文件，控制用戶APP特性 文件存在./target/include | | 硬件線路板配置 文件存在./target/include | | 校準(zhǔn)配置 文件存在./target/include |
表2-1 配置文件
產(chǎn)品定義配置文件target.def包含下面一些選項，各選項精確的函數(shù)請參考配置文件說明注釋： | | | | | | | | | | | | | | | 定義藍(lán)牙模塊類型，32K時鐘管腳，UART透傳 | | | | | | 定義WIFI 32K時鐘管腳，TCP/IP支持，SDIO，GPIO，SDMMC接口支持，DLNA接口支持，WIFI音箱支持 | | | | | | | | | | | | | | | | | | | CT_OPT：優(yōu)化編譯空間 WITHOUT_WERROR：告警是否停止編譯 | | |
表2-2 產(chǎn)品配置文件選項 2.2 庫文件EZ-Link開發(fā)平臺庫文件統(tǒng)一放置在./platform/lib/chip_name目錄。用戶開發(fā)程序時引用的頭文件放置在各模塊./inlcude目錄。
庫文件分為release和debug兩個版本，通過文件名區(qū)分。debug版本包含調(diào)試信息，并可以使用GDB工具進(jìn)行單步調(diào)試，調(diào)試信息可以通過串口打印到控制臺；release版本不包含調(diào)試信息。正式發(fā)布的產(chǎn)品bin文件應(yīng)當(dāng)鏈接release版本庫以減少bin文件體積，提高運(yùn)行速度。
2.3 IDE配置EZ-LINK SDK選擇Eclipse作為集成開發(fā)環(huán)境，SDK編譯工具鏈統(tǒng)一集成在Eclipse中。
| Eclipse和JRE（Jave Run Environment）選用32位版本，可以兼容64和32位操作系統(tǒng) |
- 下載EZ-LINK集成開發(fā)工具包，其中包含JRE安裝程序和Eclipe軟件
- 安裝JRE，安裝過程始終選擇默認(rèn)安裝選項
- Eclipse無需安裝，直接解壓運(yùn)行
Eclipse成功運(yùn)行說明集成開發(fā)環(huán)境工作正常，下一步通過Eclipse配置編譯工具，導(dǎo)入SDK庫文件和源碼。
打開Eclipse, 選擇菜單“File/New”, 然后選擇“RDA Project”。項目配置窗口如下，自定義工程名，選擇項目代碼路徑： 圖2-1 創(chuàng)建項目
項目基礎(chǔ)代碼由RDA提供，用戶可以在基礎(chǔ)代碼之上實(shí)現(xiàn)自己特有的功能和應(yīng)用。 文檔中示例工程名為“iot”，選擇代碼路徑后單擊“Finish”按鈕，生成工程如下：  圖2-2 項目瀏覽器
在“Project Explorer”中點(diǎn)擊右鍵，選擇“Properties”，進(jìn)入“Properties”窗口，選擇“C/C++ Build”，然后選擇“RDA Project”，配置目標(biāo)： 圖2-3 項目配置
在“Project Explorer”中點(diǎn)擊右鍵，選擇“RDA Tools”，然后可以看到兩個編譯選項：
圖2-4 編譯項目
在“Project Explorer”中展開根目錄 iot，選擇模塊，在模塊上點(diǎn)擊右鍵，選擇“RDA Tools”，然后可以看到如下兩個選項：
圖2-5 編譯模塊
2.4 編程框架對EZ-LINK開發(fā)平臺而言，短短數(shù)十行代碼就可以完成一個簡單的物聯(lián)網(wǎng)應(yīng)用，如智能LED燈等。簡單物聯(lián)網(wǎng)應(yīng)用編程框架有兩部分組成：
- init()函數(shù)，負(fù)責(zé)資源初始化
- loop()函數(shù)，持續(xù)監(jiān)聽系統(tǒng)事件，并處理。loop函數(shù)不間斷運(yùn)行直至系統(tǒng)關(guān)機(jī)
圖2-6 用戶代碼結(jié)構(gòu)
include目錄存放用戶頭文件，如果用戶無自定義頭文件，該目錄可以為空，或者直接刪除。
src目錄存放用戶源文件。源文件中實(shí)現(xiàn)init()和loop()，用戶在init()中實(shí)現(xiàn)初始化代碼，在loop()中處理外設(shè)如WIFI模塊產(chǎn)生的事件。源文件結(jié)構(gòu)參考示例代碼。
makefile文件具有固定格式，簡單易用。模塊makefile甚至無需修改就可以正確編譯用戶代碼，將用戶代碼與系統(tǒng)庫文件一起編譯鏈接生成可燒錄的flash二進(jìn)制文件。
## ----------------------------------------------------------- ## ## Don't touch the next line unless you know what you're doing.## ## ----------------------------------------------------------- ## include ${SOFT_WORKDIR}/env/compilation/compilevars.mk
# Name of the module LOCAL_NAME := apps/ap_customer
# list all modules APIs that are neccessary to compile this module LOCAL_API_DEPENDS := \ platform \ platform/service \ ## ----------------------------------------------------------- ## ## List all your sources here ## ## ----------------------------------------------------------- ## include src/make.srcs
## ----------------------------------------------------------- ## ## Do Not touch below this line ## ## ----------------------------------------------------------- ## include ${SOFT_WORKDIR}/env/compilation/compilerules.mk |
2.5 燒錄Flash
燒錄BIN文件使用USB轉(zhuǎn)串口線，RDA提供的開發(fā)包中包含USB轉(zhuǎn)串口驅(qū)動程序，點(diǎn)擊安裝。驅(qū)動安裝成功后，依次查看windows“控制面板”->“設(shè)備管理”->“端口”，在“端口”選項下，有如下所示USB-to-Serial端口，說明安裝成功：
圖2-7 安裝串口驅(qū)動
在Eclipse菜單項選擇“windows”，然后選擇“Preference”，選擇“C/C++”，然后選擇“RDA Tools”。在“Serial Setting”中選擇串口和正確的Baudrate。
圖2-8 串口配置
燒錄相關(guān)按鈕在Eclipse工具欄，如下圖示。 自左向右分別是： | | | 連接目標(biāo)板，成功失敗都會有彈出對話框提示 | | | | 打開內(nèi)存讀寫窗口，該部分將在2.6 調(diào)度中介紹 | | |
連接UART COM口：藍(lán)線連接HST_RXD，白線連接HST_TXD，黑線接地。 啟動Eclipse，點(diǎn)擊工具欄“Connect Target”，連接成功后，點(diǎn)擊“Down Flash”，選擇Lod文件，點(diǎn)擊“Download”： 圖2-9 下載選項
| Flash Programmer File文件由build flash產(chǎn)生 System Lod File文件由build image產(chǎn)生，參考2.3 IDE配置
|
2.6 調(diào)試串口打印trace是最為常見的調(diào)試手段。EZ-LINK trace按模塊分類，模塊內(nèi)按重要性分為不同等級。
通過宏開關(guān)，可以選擇編譯時是否包含特定模塊trace。
通過Eclipse工具，可以選擇運(yùn)行時是否輸出特定模塊和該模塊特定級別的trace。設(shè)置步驟如下：
在Eclipse菜單欄選擇“windows”，然后選擇“Preference”，選擇“C/C++”，然后選擇“RDA Tools”，最后單擊“Trace Mask”按鈕，彈出如下對話框。
圖2-10 配置Trace
“Select Module”選擇trace模塊，16個level控制trace輸出級別。
3 IOT接口3.1 系統(tǒng)服務(wù)3.1.1 內(nèi)存頭文件：iot_base.h 3.1.1.1 iot_Malloc | | | PVOID iot_Malloc(UINT32 size) | |
| | | | | |
|
|
3.1.1.2 iot_Free3.1.2 Trace頭文件iot_base.h 3.1.2.1 iot_Printf | |
| iotPrintf("led status = %d ", ledOn); | | VOID iot_Printf(INT8* fmt,...) | |
| | | | | |
|
|
3.1.3 延時3.1.3.1 iot_DelayMs | | | VOID iot_delayMs(UIN32 ms) | |
| | | | | |
|
|
3.1.3.2 iot_DelaySeconds | | | VOID iot_DelaySeconds( UINT32 seconds) | |
| | | | | |
|
|
3.2 硬件服務(wù)3.2.1 UART3.2.1.1 uart_Open | | | VOID uart_Open(UINT8 id, UINT32 baudrate) | |
| | | | | | | | |
|
|
3.2.1.2 uart_Close | | | VOID uart_Close(UINT8 id); | |
| | |
| | |
|
|
3.2.1.3 uart_Write | 通過UART接口發(fā)送數(shù)據(jù)，每次只發(fā)送一個字節(jié)數(shù)據(jù) | | UINT32 uart_Write(UINT8 id, CHAR ch); | |
| | | | | | | | | | 通過UART發(fā)送字節(jié)數(shù) |
| | | |
3.2.1.4 uart_Read | | | UINT32 uart_Read(UINT8 id, CHAR* buff) | |
| | | | | | | | | | |
| | | |
3.2.2 GPIO3.2.2.1 gpio_Open | | | VOID gpio_Open(UINT8 port, UINT8 direction) | |
| | | | | | | | |
|
|
3.2.2.2 gpio_Close | | | VOID gpio_Close(UINT8 port) | |
| | | | | |
|
|
3.2.2.3 gpio_Write | | | VOID gpio_Write(UINT8 port, UINT8 data) | |
| | | | | | | | |
|
|
3.2.2.4 gpio_Read | | | UINT32 gpio_Read(UINT8 port) | |
| | | | | GPIO接口當(dāng)前數(shù)據(jù) |
|
|
3.2.2.5 示例程序簡單物聯(lián)網(wǎng)應(yīng)用：智能LED燈，通過WIFI無線控制LED燈開關(guān)。現(xiàn)實(shí)生活中，可以減少裝修布線，減輕對墻體破壞等。
// app_led.c #include “hal_gpio.h” #include “tcpip_sockets.h”
static struct sockaddr_in ledSckAddr; static INT8 ledSckServer; static INT8 ledSckClient = 0; ///Only accept 1 byte data(0 or 1), ok for turn on/off the LED #define MAX_RECV_BUFF 1 #define LED_SCK_PORT 5050 #define MAX_LED_CONNECTION 1
VOID init(VOID) { struct sockaddr_in clientAddr; HAL_GPIO_GPIO_ID_T ledGpioId; HAL_GPIO_DIRECTION_T direction;
///Use the tenth GPIO port ledGpioId = HAL_GPIO_10; direction = HAL_GPIO_DIRECTION_OUTPUT; ///Must open the GPIO before use it gpio_Open(ledGpioId, direction);
ledSckServer = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP); memset(&ledSckAddr,0, sizeof(struct sockaddr_in));
ledSckAddr.sin_family=AF_INET; ledSckAddr.sin_addr.s_addr=htonl(INADDR_ANY); ledSckAddr.sin_port=htons(LED_SCK_PORT);
if(-1 == bind(ledSckServer, (struct sockaddr *)(& ledSckAddr),sizeof(sockaddr_in))) { return ; } }
VOID loop(VOID) { INT8 readLen = 0; UINT8 ledOn; /// If no connection, waiting for connect if (ledSckClient <= 0) { if(-1 == listen(ledSckServer, MAX_LED_CONNECTION)) { return ; } addrSize = sizeof(struct sockaddr_in); ledSckClient = accept(ledSckServer, (struct sockaddr *)(&clientAddr), &addrSize); if(-1 == ledSckClient) { return ; } } readLen = read(ledSckClient, &ledOn, MAX_REV_BUF_SIZE); if (readLen > 0) { if (0 == ledOn || 1 == ledOn) gpio_Write(ledGpioId, ledOn); } } |
3.3 WIFI3.3.1 編程接口頭文件：iot_wifi.h 3.3.1.1 iot_Connect | | | INT32 iot_Connect(const char *addr, INT16 portno) | |
| | | | | | | | |
| |
| |
| |
3.3.1.2 iot_Send | | | INT32 iot_Send(INT32 sockfd, const INT8* buffer, UINT32 len) | |
| | | | | | | | | | | |
|
|
3.3.1.3 iot_Recv | | | INT32 iot_Recv(INT32 sockfd, INT8 *buffer, UINT32 len) | |
| | | | | | | | | | | |
|
|
3.3.1.4 iot_Close | | | INT32 iot_Close(INT32 sockfd) | |
| | | | |
|
|
|
3.3.2 示例程序#include "iot_wifi.h" // Source device id allocated by oneNet #define SRC_DEV "777" // Destination device id allocated by oneNet #define DST_DEV "778" // API key allocated by oneNet #define API_KEY "your api key" // Data stream name, created on oneNet #define DATA_STREAM "your data stream" #define MAX_RESP_BUF 32
// ============================================================================ // Loop forever // Send temperature value to cloud application whenever changed // @return void // ============================================================================ VOID loop() { // Server information for connection INT8 *server_ip = "183.230.40.39"; INT8 *port = "876"; INT8 *src_dev = SRC_DEV; INT8 *dst_dev = DST_DEV; INT8 *src_api_key = API_KEY; INT8 *data_stream = DATA_STREAM; DOUBLE temperature = 0.0; INT sock, ret; EdpPacket *pkg = NULL; INT8 buffer[MAX_RESP_BUF] = { 0 }; SaveDataType data_type = kTypeSimpleJsonWithoutTime;
recv_buf = NewBuffer(); // Connect to server sock = iot_Connect(server_ip, atoi(port)); if (sock < 0) { iot_Printf("Error connect cloud server. \n"); return; } // Build connect package follow oneNet EDP protocol pkg = PacketConnect1(src_dev, src_api_key); if (pkg == NULL) { iot_Printf("Build connect pkg failed.\n"); return; } // Send connection request pkg to cloud server ret = iot_Send(sock, (const char*)pkg->_data, pkg->_write_pos); DeleteBuffer(&pkg); while (1) { Temperature = user_poll_current_temperature(); // Build save data pkg follow oneNet EDP protocol pkg =PacketSavedataDouble(data_type,dst_dev,data_stream,temperature,0, NULL); if (pkg == NULL) { iot_Printf("Build data failed.\n"); return; } // Send temperature value pkg to clould server iot_Send(sock, (const char*)pkg->_data, pkg->_write_pos); DeleteBuffer(&pkg); iot_DelayMs(2000); } // Close socket iot_Close(sock); return; } |
3.4 Bluetooth3.4.1 編程接口頭文件：iot_bt.h 3.4.1.1 bt_Open3.4.1.2 bt_Close3.4.1.3 bt_SetLocalName | | | VOID bt_SetLocalName(UINT8* name) | |
| | | | | | |
|
3.4.1.4 bt_SetVisible | | | VOID bt_SetVisable(UINT8 visable); | |
| | | | | | |
|
3.4.1.5 bt_ScanDevice | | | UINT32 bt_ScanDevice(UINT32 timeout) | |
| | | | | |
|
|
3.4.1.6 bt_BoneDevice | | | UINT32 bt_BondDevice( t_bdaddr device_addr, UINT32 timeout ) | |
| | | | | |
|
3.4.1.7 bt_GetBonedDevice | | | BOOL bt_GetBonedDevice(UINT32 index, rdabt_device_t_app *device); | |
| | | | | | 藍(lán)牙設(shè)備信息數(shù)據(jù)指針 | | | | |
| | | |
3.4.1.8 bt_SppConnect | | | BOOL bt_SppConnect(t_bdaddr device_addr, UINT8 timeout); | |
| | | | | | | | | | |
| | | |
3.4.1.9 bt_SppDisconnect | | | VOID bt_SppDisconnect(VOID) | |
| | |
| | |
|
|
3.4.1.10 bt_SppSend | | | INT32 bt_SppSend(UINT8* buf, UINT32 size) | |
| | | | | | | | | | 實(shí)際發(fā)送字節(jié)數(shù) |
| | | |
3.4.1.11 bt_SppRecv | 通過藍(lán)牙SPP接收數(shù)據(jù) | | INT32 bt_SppRecv(UINT32 timeout， UINT8 *buf) | |
| | | | | | | | | | 成功接收數(shù)據(jù)字節(jié)數(shù) |
| | | |
3.4.1.12 bt_SppAccept | | | BOOL bt_SppAccept(UINT32 timeout) | |
| | | | | | | |
| | | |
3.4.2 示例程序簡單物聯(lián)網(wǎng)應(yīng)用：智能插座，通過藍(lán)牙無線控制插座的開關(guān)。
// app_smart_plug.c
#include “bt_types.h” #include “hal_gpio.h”
static HAL_GPIO_GPIO_ID_T plugGpioId;
VOID init(VOID) { HAL_GPIO_DIRECTION_T direction;
// Use the fifth GPIO port plugGpioId = HAL_GPIO_15; direction = HAL_GPIO_DIRECTION_OUTPUT; // Must open the GPIO before use it gpio_Open(plugGpioId, direction ); bt_Open(VOID); }
VOID loop(VOID) { t_DataBuf btData;
memcpy(&btData, 0, sizeof(t_DataBuf)); // Return only when data available or error bt_SppRecv(&btData); if (btData.len > 0) { if (0 == (*btData.buff) || 1 == (*btData.buff) ) { gpio_Write(plugGpioId, *btData.buff); } } } |
全部資料51hei下載地址（含源碼與手冊）：
http://www.raoushi.com/bbs/dpj-135991-1.html
| 
QQ好友和群
QQ空間
騰訊微博
騰訊朋友
收藏
淘帖
頂
踩
