EZ-Link是RDA物聯(lián)網(wǎng)應用集成開發(fā)平臺，該平臺包括SDK開發(fā)包，Eclipse集成開發(fā)環(huán)境，調試工具和燒錄工具。SDK開發(fā)包提供了在EZ-Link平臺進行物聯(lián)網(wǎng)開發(fā)必需的模塊和標準API接口，同時通過對硬件層抽象，提供對RDA物聯(lián)網(wǎng)系列芯片的全面支持。
RDA物聯(lián)網(wǎng)系列芯片即有獨立藍牙、WIFI芯片，也有在SoC上集成Wi-Fi、Bluetooth和GSM功能的組合芯片,并提供包括UART/ADC/I2S在內的硬件接口。
RDA特有的共存技術使用戶可以獨立或并行使用Wi-Fi及藍牙功能。
本文闡述EZ-Link平臺SDK的主要功能和使用方法。本文所描述SDK為精簡版，該版本針對物聯(lián)網(wǎng)設備開發(fā)周期短、市場反應敏感等特點，對EZ-Link SDK進行了一系列優(yōu)化升級，以幫助客戶提高開發(fā)效率。用戶僅需要了解必要的接口，然后通過SDK提供的豐富示例代碼，簡單修改甚至零修改就可以實現(xiàn)一款完整的物聯(lián)網(wǎng)應用。
1.1 PCB設計硬件層 |
硬件抽象層 |
驅動和操作系統(tǒng)層 |
服務層 |
應用程序層 |
芯片模塊化 | RDA 芯片為本SDK設計參照的核心，芯片類型決定系統(tǒng)的CPU硬件架構、IO接口、總線等特性，進而影響服務層提供的服務、產(chǎn)品特性和源碼編譯等。芯片模塊化使用戶在無需修改上層軟件的情況下，根據(jù)需求選擇適當?shù)男酒?/div> |
操作系統(tǒng)模塊化 | 目前市面上嵌入式實時操作系統(tǒng)種類繁多，用戶可以根據(jù)自己的偏好和使用習慣選擇操作系統(tǒng)而不影響其他應用 |
驅動模塊化 | 用戶通常有更換外設的需求，驅動模塊化正是滿足該項需求 |
服務模塊化 | 服務層模塊化，有效減少各個子模塊之間耦合，方便用戶刪減與特定產(chǎn)品無關服務，添加新服務 |
特性 |
SDK源碼目錄結構 |
目錄 | 說明 | |
apps | 客戶應用程序和RDA示例代碼 | |
platform | RDA IOT平臺代碼，其下包括：chip、edrv、 rtos、 service等子目錄，子目錄會在下面依次說明 | |
chip | 平臺芯片相關代碼，包括：boot loader，hal層，寄存器地址定義和rom代碼。通常用戶無需修改rom代碼 | |
edrv | 包括外設驅動和芯片內驅動，外設驅動包括：LCD，F(xiàn)M等；芯片內部驅動為內部總線驅動，如GPIO，UART等 | |
rtos | 實時操作系統(tǒng)層，該目錄包括原生操作系統(tǒng) | |
service | base | 基礎服務，包括RTOS操作等 |
net | 網(wǎng)絡服務，提供http，lwna，tcp/ip操作接口 | |
bt | 藍牙服務 | |
camera | 提供相機操作接口 | |
gps | 提供GPS定位服務 | |
gui | 用戶界面操作接口 | |
gsm | GSM/GPRS操作服務接口 | |
media | 音頻、視頻服務接口等 | |
iotapi | 簡單iot應用程序編程接口 | |
target | 用戶產(chǎn)品配置文件 | |
build | 影子目錄，該目錄在編譯時由編譯腳本生成，用來存放編譯過程中生成的臨時文件 | |
lib | 模塊靜態(tài)連接庫 | |
hex | Lod文件、Ramrun文件和其他GDB相關asm及map文件 | |
配置文件 | 說明 |
target.def | 產(chǎn)品配置，target表示產(chǎn)品、開發(fā)板 |
target_common.def | 對target.def信息的集中處理，通常不需要用戶修改 |
memd.def | Flash屬性定義 |
tgt_app_cfg.h | 用戶功能宏頭文件，控制用戶APP特性 文件存在./target/include |
tgt_board_cfg.h | 硬件線路板配置 文件存在./target/include |
tgt_calib_cfg.h | 校準配置 文件存在./target/include |
選項 | 說明 | |
芯片描述信息 | 定義芯片類型和封裝 | |
觸屏驅動 | 定義觸屏設置 | |
FM驅動 | 定義FM總線和時鐘管腳 | |
FLASH驅動 | 定義FLASH類型、時鐘及ADMUX | |
LCD驅動 | 定義LCD總線 | |
CAMERA驅動 | 是否支持CAMERA及各種特性 | |
藍牙驅動 | 定義藍牙模塊類型，32K時鐘管腳，UART透傳 | |
T卡驅動 | 定義T卡接口類型 | |
音頻驅動 | 定義音頻設置 | |
WIFI驅動 | 定義WIFI 32K時鐘管腳，TCP/IP支持，SDIO，GPIO，SDMMC接口支持，DLNA接口支持，WIFI音箱支持 | |
32K時鐘配置 | 配置時鐘 | |
用戶項目定義 | APP_BASEDIR | 客戶APP目錄 |
CT_PROJECT | 定義資源類型 | |
AUD_MAX_LEVEL | 定義音量 | |
RESOURCE_SUPPORT | 是否包含資源 | |
AT_SUPPORT | 是否支持AT命令 | |
BT_SPP | 是否支持藍牙SPP | |
USB支持類型 | 是否支持USB音箱；USB HOST | |
編譯優(yōu)化選項 | CT_OPT：優(yōu)化編譯空間 WITHOUT_WERROR：告警是否停止編譯 | |
調試選項 | TRACE控制選項； | |
 | Eclipse和JRE（Jave Run Environment）選用32位版本，可以兼容64和32位操作系統(tǒng) |
安裝Eclipse |
創(chuàng)建工程 |
配置工程 |
Select Target | 選擇目標Target |
Target Wizard | 項目向導，配置項目特性、模塊等 |
Remove | 刪除Target |
New Target | 新建Target |
Select Release | 選擇生成“release”還是“debug”版本 |
Base Build Command | - |
Custom Build Option | - |
編譯工程 |
Build Flash | 編譯Ramrun文件 |
Build Image | 編譯Flash文件 |
編譯模塊 |
Build this module | 編譯該模塊 |
Clean this module | 清除模塊已編譯中間文件 |
用戶模塊組織結構 |
Makefile格式 |
## ----------------------------------------------------------- ## ## 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 |
安裝串口驅動 |
配置串口 |
Eclipse燒錄工具條目 |
Reset Target | 重置目標板，目標板將重啟 |
Connect Target | 連接目標板，成功失敗都會有彈出對話框提示 |
Open Coolwatcher | 打開CoolWatcher工具 |
Open Memory View | 打開內存讀寫窗口，該部分將在2.6 調度中介紹 |
Down Flash | 下載Ramrun 和Flash 文件 |
燒錄BIN文件 |
 | Flash Programmer File文件由build flash產(chǎn)生 System Lod File文件由build image產(chǎn)生，參考2.3 IDE配置 |
功能描述： | 分配內存, glibc兼容 | |||
函數(shù)： | PVOID iot_Malloc(UINT32 size) | |||
參數(shù)： | ||||
【輸入】 | size | 申請內存大小 | ||
返回值： | 指向分配內存的指針 | |||
功能描述： | 釋放內存, glibc兼容 | |||
函數(shù)： | VOID iot_Free(PVOID ptr) | |||
參數(shù)： | ||||
【輸入】 | ptr | 內存指針 | ||
返回值： | 無 | |||
功能描述： | 打印trace，示例打印LED燈狀態(tài)： | |||
iotPrintf("led status = %d ", ledOn); | ||||
函數(shù)： | VOID iot_Printf(INT8* fmt,...) | |||
參數(shù)： | ||||
【輸入】 | fmt | 打印格式 | ||
返回值： | 無 | |||
功能描述： | 程序延時 | |||
函數(shù)： | VOID iot_delayMs(UIN32 ms) | |||
參數(shù)： | ||||
【輸入】 | ms | 延時ms毫秒 | ||
返回值： | 無 | |||
功能描述： | 程序延時 | |||
函數(shù)： | VOID iot_DelaySeconds( UINT32 seconds) | |||
參數(shù)： | ||||
【輸入】 | secondes | 定時器時長，以秒為單位 | ||
返回值： | 無 | |||
功能描述： | 打開UART接口 | |||
函數(shù)： | VOID uart_Open(UINT8 id, UINT32 baudrate) | |||
參數(shù)： | ||||
【輸入】 | id | Uart ID | ||
【輸入】 | baudrate | Uart 波特率 | ||
返回值： | 無 | |||
功能描述： | 關閉UART接口 | |||
函數(shù)： | VOID uart_Close(UINT8 id); | |||
參數(shù)： | ||||
【輸入】 | id | |||
返回值： | 無 | |||
功能描述： | 通過UART接口發(fā)送數(shù)據(jù)，每次只發(fā)送一個字節(jié)數(shù)據(jù) | |||
函數(shù)： | UINT32 uart_Write(UINT8 id, CHAR ch); | |||
參數(shù)： | ||||
【輸入】 | uartId | UART ID | ||
【輸入】 | ch | 數(shù)據(jù)地址指針 | ||
返回值： | > 0 | - | 通過UART發(fā)送字節(jié)數(shù) | |
0 | - | 發(fā)送數(shù)據(jù)失敗 | ||
功能描述： | 通過UART接口讀數(shù)據(jù) | |||
函數(shù)： | UINT32 uart_Read(UINT8 id, CHAR* buff) | |||
參數(shù)： | ||||
【輸入】 | id | UART ID | ||
【輸入】 | buff | 數(shù)據(jù)地址指針 | ||
返回值： | > 0 | - | 通過UART接收字節(jié)數(shù) | |
0 | - | 接收數(shù)據(jù)失敗 | ||
功能描述： | 打開GPIO接口 | |||
函數(shù)： | VOID gpio_Open(UINT8 port, UINT8 direction) | |||
參數(shù)： | ||||
【輸入】 | port | 端口號 | ||
【輸入】 | direction | 0 – 輸入 ；1 – 輸出 | ||
返回值： | 無 | |||
功能描述： | 關閉GPIO接口 | |||
函數(shù)： | VOID gpio_Close(UINT8 port) | |||
參數(shù)： | ||||
【輸入】 | port | 端口號 | ||
返回值： | 無 | |||
功能描述： | 向GPIO寫“0”或者“1” | |||
函數(shù)： | VOID gpio_Write(UINT8 port, UINT8 data) | |||
參數(shù)： | ||||
【輸入】 | port | 端口號 | ||
【輸入】 | data | 數(shù)據(jù) | ||
返回值： | 無 | |||
功能描述： | 從GPIO讀數(shù)據(jù) | |||
函數(shù)： | UINT32 gpio_Read(UINT8 port) | |||
參數(shù)： | ||||
【輸入】 | port | 端口號 | ||
返回值： | GPIO接口當前數(shù)據(jù) | |||
// 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); } } |
功能描述： | 連接網(wǎng)絡 | |||
函數(shù)： | INT32 iot_Connect(const char *addr, INT16 portno) | |||
參數(shù)： | ||||
【輸入】 | addr | 網(wǎng)絡地址，URL或者 IP | ||
【輸入】 | portno | 端口號 | ||
返回值： | < 0 | 失敗 | ||
其他 | 成功 | |||
功能描述： | 發(fā)送數(shù)據(jù) | |||
函數(shù)： | INT32 iot_Send(INT32 sockfd, const INT8* buffer, UINT32 len) | |||
參數(shù)： | ||||
【輸入】 | sockfd | 套接字句柄 | ||
【輸入】 | buffer | 發(fā)送數(shù)據(jù)緩存 | ||
【輸入】 | len | 發(fā)送數(shù)據(jù)長度 | ||
返回值： | 指定索引的BSSID字串 | |||
功能描述： | 接收數(shù)據(jù) | |||
函數(shù)： | INT32 iot_Recv(INT32 sockfd, INT8 *buffer, UINT32 len) | |||
參數(shù)： | ||||
【輸入】 | sockfd | 套接字句柄 | ||
【輸入】 | buffer | 接收數(shù)據(jù)緩存 | ||
【輸入】 | len | 接收數(shù)據(jù)長度 | ||
返回值： | 實際接收字節(jié)數(shù) | |||
功能描述： | 關閉網(wǎng)絡 | |||
函數(shù)： | INT32 iot_Close(INT32 sockfd) | |||
參數(shù)： | ||||
【輸入】 | sockefd | 套接字句柄 | ||
返回值： | ||||
#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; } |
功能描述： | 啟動藍牙模塊 | |||
函數(shù)： | VOID bt_Open(VOID) | |||
參數(shù)： | ||||
【輸入】 | 無 | |||
返回值： | 無 | |||
功能描述： | 關閉藍牙模塊 | |||
函數(shù)： | VOID bt_Close(VOID) | |||
參數(shù)： | ||||
【輸入】 | 無 | |||
返回值： | 無 | |||
功能描述： | 設置本地藍牙設備名 | |||
函數(shù)： | VOID bt_SetLocalName(UINT8* name) | |||
參數(shù)： | ||||
【輸入】 | name | 本地藍牙設備名 | ||
返回值： | 無 | - | ||
功能描述： | 設置本地藍牙可見性 | |||
函數(shù)： | VOID bt_SetVisable(UINT8 visable); | |||
參數(shù)： | ||||
【輸入】 | visible | TRUE – 可見；FALSE – 不可見 | ||
返回值： | 無 | - | ||
功能描述： | 掃描周邊藍牙設備 | |||
函數(shù)： | UINT32 bt_ScanDevice(UINT32 timeout) | |||
參數(shù)： | ||||
【輸入】 | timeout | 掃描超時時間，單位秒 | ||
返回值： | 獲取藍牙設備總數(shù) | |||
功能描述： | 配對藍牙設備 | ||
函數(shù)： | UINT32 bt_BondDevice( t_bdaddr device_addr, UINT32 timeout ) | ||
參數(shù)： | |||
【輸入】 | Timeout | 配對超時時間，單位秒 | |
返回值： | TRUE 配對成功 FALSE 配對失敗 | ||
功能描述： | 藍牙配對 | |||
函數(shù)： | BOOL bt_GetBonedDevice(UINT32 index, rdabt_device_t_app *device); | |||
參數(shù)： | ||||
【輸入】 | Index | 藍牙設備索引，取值范圍0~9 | ||
【輸出】 | device | 藍牙設備信息數(shù)據(jù)指針 | ||
返回值： | TRUE | - | 獲取成功 | |
FALSE | - | 獲取失敗 | ||
功能描述： | 連接藍牙SPP服務端 | |||
函數(shù)： | BOOL bt_SppConnect(t_bdaddr device_addr, UINT8 timeout); | |||
參數(shù)： | ||||
【輸入】 | device_addr | 藍牙地址 | ||
【輸入】 | timeout | 藍牙連接超時 | ||
返回值： | TRUE | - | 連接成功 | |
FALSE | - | 連接失敗 | ||
功能描述： | 斷開藍牙SPP連接 | |||
函數(shù)： | VOID bt_SppDisconnect(VOID) | |||
參數(shù)： | ||||
【輸入】 | 無 | |||
返回值： | 無 | |||
功能描述： | 通過SPP發(fā)送數(shù)據(jù) | |||
函數(shù)： | INT32 bt_SppSend(UINT8* buf, UINT32 size) | |||
參數(shù)： | ||||
【輸入】 | buf | 發(fā)送數(shù)據(jù)緩沖區(qū) | ||
【輸入】 | size | 發(fā)送數(shù)據(jù)長度 | ||
返回值： | > 0 | - | 實際發(fā)送字節(jié)數(shù) | |
<= 0 | - | 發(fā)送失敗 | ||
功能描述： | 通過藍牙SPP接收數(shù)據(jù) | |||
函數(shù)： | INT32 bt_SppRecv(UINT32 timeout， UINT8 *buf) | |||
參數(shù)： | ||||
【輸入】 | timeout | 超時時間，單位秒 | ||
【輸出】 | buf | 接收數(shù)據(jù)緩沖區(qū) | ||
返回值： | > 0 | - | 成功接收數(shù)據(jù)字節(jié)數(shù) | |
<= 0 | - | 接收數(shù)據(jù)失敗 | ||
功能描述： | 藍牙SPP服務端接受客戶端連接 | |||
函數(shù)： | BOOL bt_SppAccept(UINT32 timeout) | |||
參數(shù)： | ||||
【輸入】 | timeout | 超時時間，單位秒 | ||
返回值： | TRUE | - | 連接成功 | |
FALSE | - | 連接失敗 | ||
// 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); } } } |
| 歡迎光臨 (http://www.torrancerestoration.com/bbs/) | Powered by Discuz! X3.1 |