終端主要接口函數(shù)

1、主講人：趙捷 日期: 2019年7月10日終端終端版本合成02主要接口函數(shù)01目錄主要函數(shù)接口終端發(fā)送數(shù)據(jù)給基站終端接收來自基站的數(shù)據(jù)查詢函數(shù) 設(shè)置終端參數(shù)函數(shù)喂狗終端發(fā)送數(shù)據(jù)給基站/* function name: node_sendDataToGateway * function describe: node send data to Gateway * function parameter: data 數(shù)據(jù)地址 * len 數(shù)據(jù)長度 * * function return: 校驗(yàn)結(jié)果，1 表示成功，0 表示失敗 *隊(duì)列最多存 4 組數(shù)據(jù)，返回 0 表示隊(duì)列已滿 */ int8_t nod

2、e_sendDataToGateway(uint8_t *data,uint16_t len);終端接收來自基站的數(shù)據(jù)/*function name: node_receiveDataFromGateway *function describe: node recieve data from Gateway *function parameter: data 數(shù)據(jù)地址 * len 數(shù)據(jù)長度 *function return: 校驗(yàn)結(jié)果，1 表示成功，0 表示隊(duì)列中無數(shù)據(jù) */ int8_t node_receiveDataFromGateway(uint8_t *data,uint16_t *

3、len)；查詢當(dāng)前LoRa注冊(cè)狀態(tài)/*function name: queryLoraCurStatus *function describe:Query Lora current status *function parameter: void *function return: 查詢結(jié)果，1 表示當(dāng)前是注冊(cè)態(tài)可收發(fā)數(shù)據(jù)*0 表示當(dāng)前是非注冊(cè)態(tài)，不能收發(fā)數(shù)據(jù) */ int8_t queryLoraCurStatus(void);查詢終端轉(zhuǎn)發(fā)數(shù)據(jù)給基站結(jié)果/*function name: queryNtogTxResult *function describe:查詢終端轉(zhuǎn)發(fā)數(shù)據(jù)給基站結(jié)果*fu

4、nction parameter: void *function return: 查詢結(jié)果，1 表示轉(zhuǎn)發(fā)數(shù)據(jù)成功* 0 表示轉(zhuǎn)發(fā)數(shù)據(jù)失敗* */ int8_t queryNtogTxResult(void); 查詢隊(duì)列中數(shù)據(jù)是否為空/*function name: queue_empty *function describe:查詢隊(duì)列中數(shù)據(jù)是否為空 *function parameter: check隊(duì)列類型，1 表示 send 隊(duì)列; * 2 表示 recv 隊(duì)列 *function return: 結(jié)果，1 表示隊(duì)列有數(shù)據(jù)，0 為空 */設(shè)置 SN 碼/*function name: se

5、tSn *function describe:設(shè)置 SN 碼 *function parameter: *pSn 需要設(shè)置的 SN 碼內(nèi)容，字符串 *snLen 長度，必須是 16 個(gè)字節(jié) *function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setSn(uint8_t *pSn, uint8_t snLen);說明：SN 碼不建議修改，每個(gè)終端的 SN 和 ID 號(hào)是一一對(duì)應(yīng)的。置默認(rèn)允許接入基站 ID/*function name: setDefaultGatewayId *function describe:設(shè)置默認(rèn)允許接入基站 ID *functi

6、on parameter: gId 需要設(shè)置的 ID 號(hào)，4 個(gè)字節(jié)的整型數(shù)*function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setDefaultGatewayId(uint32_t gId);設(shè)置終端接收基站的廣播頻點(diǎn)/*function name: setBcrf *function describe:設(shè)置接收基站的廣播頻點(diǎn) *function parameter: bcrf 需要設(shè)置的頻點(diǎn)，4 個(gè)字節(jié)的整型數(shù)*function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setBcrf(uint32_t bcrf);說

7、明：基站默認(rèn)發(fā)廣播是 489100000 頻點(diǎn)，如果要改這個(gè)參數(shù)， 終端和基站都要改成一致的，否則無法通信，而且頻點(diǎn)只能使用固定的幾組，不能隨意更改。設(shè)置帶寬/*function name: setBw *function describe:設(shè)置帶寬 *function parameter: bw 需要設(shè)置的帶寬，1 個(gè)字節(jié)的字符 *function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setBw(uint8_t bw);說明：終端和基站射頻參數(shù)必須一致才能通信設(shè)置功率/*function name: setPw *function describe:設(shè)置功

8、率 *function parameter: pw 需要設(shè)置的功率，1 個(gè)字節(jié)的字符*function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setPw(uint8_t pw);設(shè)置擴(kuò)頻因子/*function name: setSf *function describe:設(shè)置擴(kuò)頻因子 *function parameter: sf 需要設(shè)置的擴(kuò)頻因子，1 個(gè)字節(jié)的字符 *function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setSf(uint8_t sf);說明：終端和基站射頻參數(shù)必須一致才能通信設(shè)置終端 ID/*fun

9、ction name: setNodeId *function describe:設(shè)置終端 ID *function parameter: nId 需要設(shè)置的終端 ID，4 個(gè)字節(jié)的整型數(shù) *function return: 結(jié)果，成功返回 1，失敗返回 0 */ int32_t setNodeId(uint32_t nId);說明：一般不允許修改，僅供測試時(shí)用喂狗/*function name: watchdogFeed *function describe:Feedwatchdog(每 20s 內(nèi)要喂一次狗)*function parameter: void *function return: 空 */ void watchdogFeed(void);終端版本合成02終端版本合成1.壓縮包中的”STM32L071RZ_IAP.hex”文件是終端的 BOOT 啟動(dòng)文件，是必須要下載到終端中的，所以客戶編譯出的版本文件可以和 STM32L071RZ_IAP.hex 合成一個(gè)文件，再下載到終端中；2.版本文件合成方法： 如果客戶編譯的版本文件是 STM32L071RZ.hex ， 同時(shí)將STM3