今天讓我們來(lái)實(shí)踐一下Air780E軟件的WebSocket應(yīng)用吧，讓我們更了解它。

1、WebSocket概述

WebSocket是HTML5下一種新的協(xié)議（本質(zhì)上是一個(gè)基于TCP的協(xié)議），它實(shí)現(xiàn)了瀏覽器與服務(wù)器之間的全雙工通信，能夠節(jié)省服務(wù)器資源和帶寬，達(dá)到實(shí)時(shí)通訊的目的。WebSocket協(xié)議通過(guò)握手機(jī)制，允許客戶端和服務(wù)器之間建立一個(gè)類(lèi)似TCP的連接，從而方便它們之間的通信。

在線聊天應(yīng)用：允許用戶實(shí)時(shí)發(fā)送和接收消息，而無(wú)需頁(yè)面刷新或輪詢服務(wù)器。

實(shí)時(shí)協(xié)作應(yīng)用：支持多用戶實(shí)時(shí)編輯文檔或共享白板等場(chǎng)景。

實(shí)時(shí)游戲：允許多個(gè)玩家之間進(jìn)行實(shí)時(shí)的游戲交互。

實(shí)時(shí)數(shù)據(jù)展示：用于顯示實(shí)時(shí)數(shù)據(jù)，如股票市場(chǎng)變化、天氣預(yù)報(bào)更新等。

實(shí)時(shí)通知和提醒：用于向用戶發(fā)送實(shí)時(shí)的通知消息，如新郵件提醒、社交媒體通知等。

在線會(huì)議和視頻通話：支持實(shí)時(shí)的音視頻通信。

2、準(zhǔn)備硬件環(huán)境

“古人云：‘工欲善其事，必先利其器?！谏钊虢榻B本功能示例之前，我們首先需要確保以下硬件環(huán)境的準(zhǔn)備工作已經(jīng)完成?！?/p>

2.1 Air780E開(kāi)發(fā)板

本demo使用的是Air780E核心板

此核心板的詳細(xì)使用說(shuō)明參考：
https://docs.openluat.com/air780e/product/

Air780E產(chǎn)品手冊(cè)中的<<開(kāi)發(fā)板Core_Air780E使用說(shuō)明VX.X.X.pdf>>，寫(xiě)這篇文章時(shí)最新版本的使用說(shuō)明為：開(kāi)發(fā)板Core_Air780E使用說(shuō)明V1.0.5.pdf；核心板使用過(guò)程中遇到任何問(wèn)題，可以直接參考這份使用說(shuō)明pdf文檔。

2.2 SIM卡

請(qǐng)準(zhǔn)備一張可正常上網(wǎng)的SIM卡，該卡可以是物聯(lián)網(wǎng)卡或您的個(gè)人手機(jī)卡。

特別提醒：請(qǐng)確保SIM卡未欠費(fèi)且網(wǎng)絡(luò)功能正常，以便順利進(jìn)行后續(xù)操作。

2.3 PC電腦

請(qǐng)準(zhǔn)備一臺(tái)配備USB接口且能夠正常上網(wǎng)的電腦。

2.4 數(shù)據(jù)通信線

請(qǐng)準(zhǔn)備一根用于連接Air780E開(kāi)發(fā)板和PC電腦的數(shù)據(jù)線，該數(shù)據(jù)線將實(shí)現(xiàn)業(yè)務(wù)邏輯的控制與交互。您有兩種選擇：

USB數(shù)據(jù)線（其一端為Type-C接口，用于連接Air780E開(kāi)發(fā)板）。通常，這種數(shù)據(jù)線的外觀如下示意圖所示：

普通的手機(jī)USB數(shù)據(jù)線一般都可以直接使用；

數(shù)據(jù)線是USB轉(zhuǎn)TTL串口線。通常，這種數(shù)據(jù)線的外觀如下示意圖所示：

在本教程中，我們將采用以下數(shù)據(jù)線配置進(jìn)行測(cè)試和數(shù)據(jù)查看：

第一種：USB數(shù)據(jù)線：此數(shù)據(jù)線不僅用于為測(cè)試板供電，還用于查看數(shù)據(jù)日志。其一端為T(mén)ype-C接口，連接Air780E開(kāi)發(fā)板；另一端為標(biāo)準(zhǔn)USB接口，連接PC電腦。

第二種：USB轉(zhuǎn)TTL串口線：此數(shù)據(jù)線主要用于Websocket-UART透?jìng)鲾?shù)據(jù)的查看。其一端為USB接口，連接PC電腦；另一端為T(mén)TL串口接口，連接Air780E開(kāi)發(fā)板，以便進(jìn)行串口通信和數(shù)據(jù)傳輸。

2.5 組裝硬件環(huán)境

2.5.1 請(qǐng)按照SIM卡槽上的指示方向正確插入SIM卡，務(wù)必確保插入方向正確，避免插反導(dǎo)致?lián)p壞！

通常，插入SIM卡的步驟如下：

將SIM卡的金屬接觸面朝下，對(duì)準(zhǔn)卡槽的開(kāi)口。

用力平穩(wěn)地將SIM卡推入卡槽，直至聽(tīng)到“咔嚓”一聲，表示SIM卡已正確安裝到位。

2.5.2 USB數(shù)據(jù)線，連接電腦和Air780E開(kāi)發(fā)板，如下圖所示：

3、準(zhǔn)備軟件環(huán)境

“凡事預(yù)則立，不預(yù)則廢。”在詳細(xì)闡述本功能示例之前，我們需先精心籌備好以下軟件環(huán)境。

3.1 Luatools工具

要想燒錄AT固件到4G模組中，需要用到的調(diào)試工具：Luatools；

Luatools工具集具備以下幾大核心功能：

一鍵獲取最新固件：自動(dòng)連接服務(wù)器，輕松下載最新的模組固件。

固件與腳本燒錄：便捷地將固件及腳本文件燒錄至目標(biāo)模組中。

串口日志管理：實(shí)時(shí)查看模組通過(guò)串口輸出的日志信息，并支持保存功能。

串口調(diào)試助手：提供簡(jiǎn)潔的串口調(diào)試界面，滿足基本的串口通信測(cè)試需求。

Luatools下載之后，無(wú)需安裝，解壓到你的硬盤(pán)，點(diǎn)擊Luatools_v3.exe運(yùn)行，出現(xiàn)如下界面，就代表Luatools安裝成功了：

3.2 燒錄代碼

首先要說(shuō)明一點(diǎn)：腳本代碼，要和固件的LuatOS-SoC_V1112_EC618_FULL.soc文件一起燒錄。

整體壓縮文件：內(nèi)含有文件一：Core固件和文件二：WebSocket加密通訊腳本文件，文件三：WebSocket-UART透?jìng)髂_本文件，如圖所示。

3.2.1 壓縮文件：

閱讀原文下載完整壓縮文件包：
https://docs.openluat.com/air780e/luatos/app/socket/websocket/

3.2.2 壓縮包內(nèi)部文件

文件一：Core固件

文件二：WebSocket加密通訊腳本文件

文件三：WebSocket-UART透?jìng)髂_本文件

3.2.3 找到燒錄的固件文件

https://docs.openluat.com/air780e/luatos/app/socket/websocket/

3.2.4 正確連接電腦和4G模組電路板

使用帶有數(shù)據(jù)通信功能的數(shù)據(jù)線，不要使用僅有充電功能的數(shù)據(jù)線；

3.2.5 識(shí)別4G模組的boot引腳

在下載之前，要用模組的boot引腳觸發(fā)下載，也就是說(shuō)，要把4G模組的boot引腳拉到1.8v，或者直接把boot引腳和VDD_EXT引腳相連。我們要在按下BOOT按鍵時(shí)讓模塊開(kāi)機(jī)，就可以進(jìn)入下載模式了。

具體到Air780E開(kāi)發(fā)板，

當(dāng)我們模塊沒(méi)開(kāi)機(jī)時(shí)，按著B(niǎo)OOT鍵然后長(zhǎng)按POW開(kāi)機(jī)。

當(dāng)我們模塊開(kāi)機(jī)時(shí)，按著B(niǎo)OOT鍵然后點(diǎn)按重啟鍵即可。

3.2.6 識(shí)別電腦的正確端口

判斷是否進(jìn)入BOOT模式：-模塊上電，此時(shí)在電腦的設(shè)備管理器中，查看串口設(shè)備，如下圖：

進(jìn)入boot下載模式，如下圖所示：

這時(shí)候，硬件連接上就緒狀態(tài)，恭喜你，可以進(jìn)行燒錄了！

3.2.7 新建項(xiàng)目

首先，確保你的Luatools的版本大于或者等于3.0.6版本.

在Luatools的左上角上有版本顯示的，如圖所示：

Luatools版本沒(méi)問(wèn)題的話，就點(diǎn)擊Luatools右上角的“項(xiàng)目管理測(cè)試”按鈕，如下圖所示：

這時(shí)會(huì)彈出項(xiàng)目管理和燒錄管理的對(duì)話框，如下圖：

3.2.8 開(kāi)始燒錄

選擇780E板子對(duì)應(yīng)的底層core和剛改的main.lua腳本文件。下載到板子中。

點(diǎn)擊下載后，我們需要進(jìn)入boot模式才能正常下載。

3.3 PC端串口工具

閱讀原文下載：
https://docs.openluat.com/air780e/luatos/app/socket/websocket/

串口接線方式：Air780提供三個(gè)Uart.

MAIN_UART：通用串口，可用于AT命令和數(shù)據(jù)傳輸最大波特率921600bps，默認(rèn)波特率自適應(yīng)9600-115200bps支持硬件流控（RTS/CTS）

AUX_UART：通用串口

DBG_UART：用于輸出調(diào)試信息

注意：

以上PinOut圖示,對(duì)應(yīng)的V1.8的開(kāi)發(fā)板，版本號(hào)在板子絲印上可查閱。

V1.4的開(kāi)發(fā)板,由于LCD腳有差異,圖示的LCD_RS/LCD_CLK實(shí)際位于開(kāi)發(fā)板管腳編號(hào)06/05的UART2/AUX_UART腳,不在編號(hào)11/14腳。

V1.8的開(kāi)發(fā)板17腳改為VBAT.

3.3.1 LLCOM工具設(shè)置：初始配置

3.3.2 數(shù)據(jù)發(fā)送前的配置

4、WebSocket加密通訊的概述

本小節(jié)教你怎么使用luatos腳本語(yǔ)言，就可以讓4G模組連接上一個(gè)WebSocket服務(wù)器，并且模組和服務(wù)器之間實(shí)現(xiàn)數(shù)據(jù)的交互！

4.1 本教程實(shí)現(xiàn)的功能定義：

4G模組插卡開(kāi)機(jī)后，連接上WebSocket服務(wù)器；

這是個(gè)測(cè)試服務(wù),當(dāng)4G模組發(fā)送的是json,且action=echo,就會(huì)回顯所發(fā)送的內(nèi)容

發(fā)送內(nèi)容是

wsc:send((json.encode({action="echo",msg=os.date()})))

4.2 文章內(nèi)容引用

780E開(kāi)發(fā)板軟硬件資料：Air780E產(chǎn)品手冊(cè)

websocket函數(shù)接口不做詳細(xì)介紹，可通過(guò)此鏈接查看具體介紹：websocket-網(wǎng)絡(luò)接口-LuatOS文檔

4.3 核心腳本代碼詳解

4.3.1 websocket客戶端創(chuàng)建

4.3.2 設(shè)置額外的headers

4.3.3 設(shè)置自動(dòng)重連機(jī)制

4.3.4 注冊(cè)websocket回調(diào)

4.3.5 連接服務(wù)器

4.3.6 發(fā)布消息

4.3.7 websocket客戶端關(guān)閉(關(guān)閉后資源釋放無(wú)法再使用)

wsc:close()

4.4 成果演示與深度解析：視頻+圖文全面展示

4.4.1 成果運(yùn)行精彩呈現(xiàn)

4.4.2 演示視頻生動(dòng)展示

4.4.3 完整實(shí)例深度剖析

5、WebSocket-UART透?jìng)鞯母攀?/p>

在某些應(yīng)用場(chǎng)景下，可能需要將WebSocket接收到的數(shù)據(jù)通過(guò)UART串口發(fā)送到其他設(shè)備，或者將UART串口接收到的數(shù)據(jù)通過(guò)WebSocket發(fā)送到服務(wù)器。這通常需要通過(guò)一個(gè)中間層或網(wǎng)關(guān)設(shè)備來(lái)實(shí)現(xiàn)數(shù)據(jù)的轉(zhuǎn)換和傳輸。

5.1 本教程實(shí)現(xiàn)的功能定義：

4G模組插卡開(kāi)機(jī)后，連接上WebSocket服務(wù)器；

本小節(jié)教你怎么使用luatos腳本語(yǔ)言，就可以讓合宙4G模組通過(guò)Uart1透?jìng)鲾?shù)據(jù)發(fā)送到WebSocket服務(wù)器，并且模組和服務(wù)器之間實(shí)現(xiàn)數(shù)據(jù)的交互！

5.2 文章內(nèi)容引用

780E開(kāi)發(fā)板軟硬件資料：Air780E產(chǎn)品手冊(cè)

websocket函數(shù)接口不做詳細(xì)介紹，可通過(guò)此鏈接查看具體介紹：websocket-網(wǎng)絡(luò)接口-LuatOS文檔

5.3 核心腳本代碼詳解

5.3.1 websocket客戶端創(chuàng)建

5.3.2 設(shè)置額外的headers

5.3.3 設(shè)置自動(dòng)重連機(jī)制

5.3.4 注冊(cè)websocket回調(diào)

5.3.5 連接服務(wù)器

5.3.6 串口初始化

本文示例：串口使用MAIN_UART(uart1)

5.3.7 接收UART消息

5.3.8 發(fā)布消息

5.3.9 websocket客戶端關(guān)閉(關(guān)閉后資源釋放無(wú)法再使用)

5.4 成果演示與深度解析：視頻+圖文全面展示

5.4.1 成果運(yùn)行精彩呈現(xiàn)

5.4.2完整實(shí)例深度剖析

6、總結(jié)

WebSocket加密確保了數(shù)據(jù)在傳輸過(guò)程中的安全性，防止被竊取或篡改；而WebSocket透?jìng)鲃t指數(shù)據(jù)在不改變內(nèi)容的情況下，通過(guò)WebSocket協(xié)議進(jìn)行傳輸，通常涉及中間層或網(wǎng)關(guān)設(shè)備的數(shù)據(jù)格式轉(zhuǎn)換與傳遞

Air780E作為一款4G模組，支持WebSocket協(xié)議，并可通過(guò)Luatools等工具進(jìn)行調(diào)試和固件管理。在Air780E上實(shí)現(xiàn)WebSocket加密通訊，通常需要使用SSL/TLS等加密協(xié)議來(lái)確保數(shù)據(jù)傳輸?shù)陌踩浴?/p>

7、常見(jiàn)問(wèn)題

websocket服務(wù)器的連接地址,格式為ws(或wss)://xxx開(kāi)頭

websocket需要在任務(wù)中啟動(dòng),帶自動(dòng)重連,支持心跳協(xié)議

websocket心跳包，建議180秒

注意串口發(fā)送過(guò)去的數(shù)據(jù)是字符格式，這里進(jìn)行對(duì)比時(shí)注意echo的類(lèi)型ifuart_rx_buff_data=='"echo"'

8、擴(kuò)展

在WebSocket中，WS和WSS代表兩種不同的連接類(lèi)型，它們分別具有以下特點(diǎn)：

8.1 WS（WebSocket）

含義：表示非安全的WebSocket連接，即沒(méi)有加密的WebSocket通信。

端口：默認(rèn)情況下，WebSocket的WS協(xié)議使用80端口。

使用場(chǎng)景：適用于不需要數(shù)據(jù)加密的場(chǎng)景，或者在安全性要求不高的環(huán)境中使用。然而，對(duì)于敏感數(shù)據(jù)或需要保護(hù)通信內(nèi)容的情況，WS可能不是最佳選擇。

8.2 WSS（WebSocketSecure）

含義：表示安全的WebSocket連接，即在TLS（傳輸層安全協(xié)議）之上的WebSocket通信。WSS相當(dāng)于HTTPS在WebSocket中的應(yīng)用，提供了數(shù)據(jù)加密和完整性驗(yàn)證等安全功能。

端口：默認(rèn)情況下，WSS協(xié)議使用443端口，這是大多數(shù)網(wǎng)站用于HTTPS通信的標(biāo)準(zhǔn)端口。

使用場(chǎng)景：適用于需要保護(hù)通信內(nèi)容、防止數(shù)據(jù)竊取或篡改的場(chǎng)景。WSS是處理敏感數(shù)據(jù)或進(jìn)行安全通信時(shí)的推薦選擇。

審核編輯 黃宇