1# Pegasus与Taurus WiFi互联通信<a name="ZH-CN_TOPIC_0000001130176841"></a> 2- 在学习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目录下。 3 4- 前言：HiStreaming 组件作为一种技术基础设施，使得海思芯片可以通过WiFi或有线网络实现物联网设备之间的设备自动发现、服务注册与识别、服务操作。HiStreaming把物联网设备分为两类角色，对外部提供服务的设备称之为 Server 设备，而使用其他设备提供的服务的设备称之为 Client 设备。 5 6  7 8## 硬件环境搭建 9- 硬件要求：Hi3861V100核心板、底板(其他外设根据自己需要)；硬件搭建如下图所示。注意这里需要跟Taurus同时使用，详情可以参考[WiFi互联server](http://gitee.com/openharmony/device_soc_hisilicon/blob/master/hi3516dv300/sdk_linux/sample/taurus/histreaming_server/README.md)端。 10 11  12 13  14 15## 组网方式 16- 组网方案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端、手机端，三者之间的组网方式如下图所示。 17 18  19 20- 组网方案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端、手机端，三者之间的组网方式如下图所示。（其实手机作为热点代替路由器也是可行的） 21 22  23 24## 软件介绍 25- 注意这里需要跟Taurus同时使用，Taurus软件介绍详情可以参考[WiFi互联server](http://gitee.com/openharmony/device_soc_hisilicon/blob/master/hi3516dv300/sdk_linux/sample/taurus/histreaming_server/README.md)。 26- 1.代码目录结构及相应接口功能介绍 27- WiFi API 28 29| API | 接口说明 | 30| ------------------------------------------------------------ | --------------------------------------- | 31| WifiErrorCode EnableWifi(void); | 开启STA | 32| WifiErrorCode DisableWifi(void); | 关闭STA | 33| int IsWifiActive(void); | 查询STA是否已开启 | 34| WifiErrorCode Scan(void); | 触发扫描 | 35| WifiErrorCode GetScanInfoList(WifiScanInfo* result, unsigned int* size); | 获取扫描结果 | 36| WifiErrorCode AddDeviceConfig(const WifiDeviceConfig* config, int* result); | 添加热点配置，成功会通过result传出netld | 37| WifiErrorCode GetDeviceConfigs(WifiDeviceConfig* result, unsigned int* size); | 获取本机所有热点配置 | 38| WifiErrorCode RemoveDevice(int networkId); | 删除热点配置 | 39| WifiErrorCode ConnectTo(int networkId); | 连接到热点 | 40| WifiErrorCode Disconnect(void); | 断开热点连接 | 41| WifiErrorCode GetLinkedInfo(WifiLinkedInfo* result); | 获取当前连接热点信息 | 42| WifiErrorCode RegisterWifiEvent(WifiEvent* event); | 注册事件监听 | 43| WifiErrorCode UnRegisterWifiEvent(const WifiEvent* event); | 解除事件监听 | 44| WifiErrorCode GetDeviceMacAddress(unsigned char* result); | 获取Mac地址 | 45| WifiErrorCode AdvanceScan(WifiScanParams *params); | 高级搜索 | 46 47- DHCP客户端接口： 48 49| API | 描述 | 50| ------------------- | ------------------ | 51| netifapi_netif_find | 按名称查找网络接口 | 52| netifapi_dhcp_start | 启动DHCP客户端 | 53| netifapi_dhcp_stop | 停止DHCP客户端 | 54 55- HiStreaming接口： 56 57| API | 描述 | 58| ------------------- | ------------------ | 59| LinkPlatformGe | 获得HiStreamingLinkLite组件对象 | 60| LinkPlatformFree | 释放HiStreamingLinkLite组件对象 | 61| LinkServiceAgentFree | 释放从设备列表中pop出来的LinkServiceAgent对象 | 62| LinkAgentGet | 获得LinkAgent对象 | 63| LinkAgentFree | 释放LinkAgent对象 | 64| QueryResultFree | 释放设备列表QueryResult。同时也释放设备列表关联的LinkServiceAgent对象 | 65 66 67- 2.工程编译 68 - 将源码./vendor/hisilicon/hispark_pegasus/demo目录下的histreaming_client_demo整个文件夹及内容复制到源码./applications/sample/wifi-iot/app/下，如图。 69 ``` 70 . 71 └── applications 72 └── sample 73 └── wifi-iot 74 └── app 75 └──histreaming_client_demo 76 └── 代码 77 ``` 78 79 - 修改./applications/sample/wifi-iot/app/histreaming_client_demo/wifi_connecter中PARAM_HOTSPOT_SSID，PARAM_HOTSPOT_PSK为路由器或者Taurus发出的WiFi名称和WiFi密码。 80 ``` 81 #define PARAM_HOTSPOT_SSID "x" // your AP SSID 82 #define PARAM_HOTSPOT_PSK "xxxxx" // your AP PSK 83 ``` 84 85 - 修改源码./applications/sample/wifi-iot/app/BUILD.gn文件，在features字段中增加索引，使目标模块参与编译。features字段指定业务模块的路径和目标,features字段配置如下。 86 ``` 87 import("//build/lite/config/component/lite_component.gni") 88 89 lite_component("app") { 90 features = [ 91 "histreaming_client_demo:histreamingClentDemo", 92 ] 93 } 94 ``` 95 96 - 工程相关配置完成后,然后rebuild编译。 97- 3.烧录 98 - 编译成功后，点击DevEco Home->配置工程->hi3861->upload_port->选择对应串口端口号->选择upload_protocol->选择hiburn-serial->点击save保存，在保存成功后点击upload进行烧录，出现connecting, please reset device..字样复位开发板等待烧录完成。 99 - 烧录成功后，Taurus端或者路由器需要发出热点，同时Taurus端运行ohos_histreaming_server可执行文件，再次点击Hi3861核心板上的“RST”复位键，此时开发板的系统会运行起来。运行结果:打开串口工具，可以看到如下打印,同时3861主板灯闪亮一下。 100 101  102 103  104 105  106 107- 4.手机端控制 108 - 如果你想使用手机来控制Pegasus或者Taurus，手机端安装及使用（源码下载](https://gitee.com/leo593362220/shistreaming.git)），然后进入app-release.rar目录，将程序安装到手机上，具体的安装过程这里就不介绍了(通过数据线复制到手机，或使用微信、QQ等方式发送到手机再安装)。 109APP安装成功后，打开手机的WiFi列表，连接到Taurus开发板的AP热点或者路由器热点，再打开刚安装好的HiStreaming APP，下拉刷新几次，手机会发现两个设备，分别是Pegasus开发板设备和Taurus开发板设备。 110 111 - 任意点击一个设备进行操作，点击LED灯控制按钮，会进入一个灯的控制界面。点击图片会发生变化，且会给对应的设备发送数据,同时控制灯亮与熄。 112 113  114 115  116 117 
