# Pegasus与Taurus WiFi互联通信 - 在学习Pegasus与Taurus WiFi互联通信前，需要将[device_soc_hisilicon](http://gitee.com/openharmony/device_soc_hisilicon)仓下载，在ubuntu下执行：git lfs clone xxxxx仓库地址,下载完成后，将device_soc_hisilicon/hi3861v100/sdk_liteos/build/libs/libhistreaminglink.a这个库文件替换到自己工程下的device\soc\hisilicon\hi3861v100\sdk_liteos\build\libs\目录下。同时需要下载[vendor_hisilicon](http://gitee.com/openharmony/vendor_hisilicon)仓，在ubuntu下执行：git lfs clone xxxxx仓库地址，将vendor_hisilicon\hispark_pegasus\demo\histreaming_client_demo整个文件夹复制到自己工程下的vendor\hisilicon\hispark_pegasus\demo目录下。 - 前言：HiStreaming 组件作为一种技术基础设施，使得海思芯片可以通过WiFi或有线网络实现物联网设备之间的设备自动发现、服务注册与识别、服务操作。HiStreaming把物联网设备分为两类角色，对外部提供服务的设备称之为 Server 设备，而使用其他设备提供的服务的设备称之为 Client 设备。 ![输入图片说明](../doc/figures/histreaming_client_demo/011histreamingclient.png) ## 硬件环境搭建 - 硬件要求：Hi3861V100核心板、底板(其他外设根据自己需要)；硬件搭建如下图所示。注意这里需要跟Taurus同时使用，详情可以参考[WiFi互联server](http://gitee.com/openharmony/device_soc_hisilicon/blob/master/hi3516dv300/sdk_linux/sample/taurus/histreaming_server/README.md)端。 ![输入图片说明](../doc/figures/histreaming_client_demo/012histreamingclient.png) ![输入图片说明](../doc/figures/histreaming_client_demo/013histreamingclient.png) ## 组网方式 - 组网方案1：将Taurus开发套件设置成为WiFi AP模式，Pegasus开发套件和手机直接连接到Taurus的WiFi AP热点。Taurus开发板上跑的是HiStreaming-Server和HiStreaming-Client程序，Pegasus开发板上跑的是HiStreaming-Server程序，手机上跑的是HiStreaming-Client程序。当三者在同一局域网内，手机能够同时发现Taurus和Pegasus上的HiStreaming-Server，且Taurus上的HiStreaming-Client也能发现Pegasus上的HiStreaming-Server。Taurus端、Pegasus端、手机端，三者之间的组网方式如下图所示。 ![输入图片说明](../doc/figures/histreaming_client_demo/014histreamingclient.png) - 组网方案2：Pegasus端、Taurus端、手机端都配置成为STA模式，使Taurus开发套件、Pegasus开发套件以及手机都连接在同一路由器发出的WiFi AP热点下面，组成一个局域网。其中，Taurus开发板上跑的是HiStreaming-Server和HiStreaming-Client程序，Pegasus开发板上跑的是HiStreaming-Server程序，手机上跑的是HiStreaming-Client程序。当三者在同一局域网内，手机能够同时发现Taurus和Pegasus上的HiStreaming-Server，且Taurus上的HiStreaming-Client也能发现Pegasus上的HiStreaming-Server。Taurus端、Pegasus端、手机端，三者之间的组网方式如下图所示。（其实手机作为热点代替路由器也是可行的） ![输入图片说明](../doc/figures/histreaming_client_demo/015histreamingclient.png) ## 软件介绍 - 注意这里需要跟Taurus同时使用，Taurus软件介绍详情可以参考[WiFi互联server](http://gitee.com/openharmony/device_soc_hisilicon/blob/master/hi3516dv300/sdk_linux/sample/taurus/histreaming_server/README.md)。 - 1.代码目录结构及相应接口功能介绍 - WiFi API | API | 接口说明 | | ------------------------------------------------------------ | --------------------------------------- | | WifiErrorCode EnableWifi(void); | 开启STA | | WifiErrorCode DisableWifi(void); | 关闭STA | | int IsWifiActive(void); | 查询STA是否已开启 | | WifiErrorCode Scan(void); | 触发扫描 | | WifiErrorCode GetScanInfoList(WifiScanInfo* result, unsigned int* size); | 获取扫描结果 | | WifiErrorCode AddDeviceConfig(const WifiDeviceConfig* config, int* result); | 添加热点配置，成功会通过result传出netld | | WifiErrorCode GetDeviceConfigs(WifiDeviceConfig* result, unsigned int* size); | 获取本机所有热点配置 | | WifiErrorCode RemoveDevice(int networkId); | 删除热点配置 | | WifiErrorCode ConnectTo(int networkId); | 连接到热点 | | WifiErrorCode Disconnect(void); | 断开热点连接 | | WifiErrorCode GetLinkedInfo(WifiLinkedInfo* result); | 获取当前连接热点信息 | | WifiErrorCode RegisterWifiEvent(WifiEvent* event); | 注册事件监听 | | WifiErrorCode UnRegisterWifiEvent(const WifiEvent* event); | 解除事件监听 | | WifiErrorCode GetDeviceMacAddress(unsigned char* result); | 获取Mac地址 | | WifiErrorCode AdvanceScan(WifiScanParams *params); | 高级搜索 | - DHCP客户端接口： | API | 描述 | | ------------------- | ------------------ | | netifapi_netif_find | 按名称查找网络接口 | | netifapi_dhcp_start | 启动DHCP客户端 | | netifapi_dhcp_stop | 停止DHCP客户端 | - HiStreaming接口： | API | 描述 | | ------------------- | ------------------ | | LinkPlatformGe | 获得HiStreamingLinkLite组件对象 | | LinkPlatformFree | 释放HiStreamingLinkLite组件对象 | | LinkServiceAgentFree | 释放从设备列表中pop出来的LinkServiceAgent对象 | | LinkAgentGet | 获得LinkAgent对象 | | LinkAgentFree | 释放LinkAgent对象 | | QueryResultFree | 释放设备列表QueryResult。同时也释放设备列表关联的LinkServiceAgent对象 | - 2.工程编译 - 将源码./vendor/hisilicon/hispark_pegasus/demo目录下的histreaming_client_demo整个文件夹及内容复制到源码./applications/sample/wifi-iot/app/下，如图。 ``` . └── applications └── sample └── wifi-iot └── app └──histreaming_client_demo └── 代码 ``` - 修改./applications/sample/wifi-iot/app/histreaming_client_demo/wifi_connecter中PARAM_HOTSPOT_SSID，PARAM_HOTSPOT_PSK为路由器或者Taurus发出的WiFi名称和WiFi密码。 ``` #define PARAM_HOTSPOT_SSID "x" // your AP SSID #define PARAM_HOTSPOT_PSK "xxxxx" // your AP PSK ``` - 修改源码./applications/sample/wifi-iot/app/BUILD.gn文件，在features字段中增加索引，使目标模块参与编译。features字段指定业务模块的路径和目标,features字段配置如下。 ``` import("//build/lite/config/component/lite_component.gni") lite_component("app") { features = [ "histreaming_client_demo:histreamingClentDemo", ] } ``` - 工程相关配置完成后,然后rebuild编译。 - 3.烧录 - 编译成功后，点击DevEco Home->配置工程->hi3861->upload_port->选择对应串口端口号->选择upload_protocol->选择hiburn-serial->点击save保存，在保存成功后点击upload进行烧录，出现connecting, please reset device..字样复位开发板等待烧录完成。 - 烧录成功后，Taurus端或者路由器需要发出热点，同时Taurus端运行ohos_histreaming_server可执行文件，再次点击Hi3861核心板上的“RST”复位键，此时开发板的系统会运行起来。运行结果:打开串口工具，可以看到如下打印,同时3861主板灯闪亮一下。 ![输入图片说明](../doc/figures/histreaming_client_demo/012histreamingclient.png) ![输入图片说明](../doc/figures/histreaming_client_demo/016histreamingclient.png) ![输入图片说明](../doc/figures/histreaming_client_demo/017histreamingclient.png) - 4.手机端控制 - 如果你想使用手机来控制Pegasus或者Taurus，手机端安装及使用（源码下载](https://gitee.com/leo593362220/shistreaming.git)），然后进入app-release.rar目录，将程序安装到手机上，具体的安装过程这里就不介绍了(通过数据线复制到手机，或使用微信、QQ等方式发送到手机再安装)。 APP安装成功后，打开手机的WiFi列表，连接到Taurus开发板的AP热点或者路由器热点，再打开刚安装好的HiStreaming APP，下拉刷新几次，手机会发现两个设备，分别是Pegasus开发板设备和Taurus开发板设备。 - 任意点击一个设备进行操作，点击LED灯控制按钮，会进入一个灯的控制界面。点击图片会发生变化，且会给对应的设备发送数据,同时控制灯亮与熄。 ![输入图片说明](../doc/figures/histreaming_client_demo/021histreamingclient.png) ![输入图片说明](../doc/figures/histreaming_client_demo/022histreamingclient.png) ![输入图片说明](../doc/figures/histreaming_client_demo/023histreamingclient.png)