# HiSpark WiFi-IoT 套件样例开发--wifihotspot（AP模式） ![hihope_illustration](https://gitee.com/hihopeorg/hispark-hm-pegasus/raw/master/docs/figures/hihope_illustration.png) [HiSpark WiFi-IoT开发套件](https://item.taobao.com/item.htm?id=622343426064&scene=taobao_shop) 首发于HDC 2020，是首批支持OpenHarmony 2.0的开发套件，亦是官方推荐套件，由润和软件HiHope量身打造，已在OpenHarmony社区和广大OpenHarmony开发者中得到广泛应用。 ![wifi_iot](https://gitee.com/hihopeorg/hispark-hm-pegasus/raw/master/docs/figures/2.png) ## 一、Wifi STA API 使用原始WiFI API接口进行编程，AP模式需要使用原始接口以及一些DHCP客户端接口。 #### WiFi AP模式相关的API接口文件路径 **foundation/communication/interfaces/kits/wifi_lite/wifiservice/wifi_hotspot_config.h** **foundation/communication/interfaces/kits/wifi_lite/wifiservice/wifi_hotspot.h** 所使用的API接口有： | API | 接口说明 | | ------------------------------------------------------------ | ------------------------ | | WifiErrorCode EnableHotspot(void); | 打开Wifi AP 模式 | | WifiErrorCode DisableHotspot(void); | 关闭Wifi AP 模式 | | WifiErrorCode SetHotspotConfig(const HotspotConfig* config); | 设置当前AP热点的配置参数 | | WifiErrorCode GetHotspotConfig(HotspotConfig* result); | 获取当前AP热点的配置参数 | | int IsHotspotActive(void); | 查询AP是否已经开启 | | WifiErrorCode GetStationList(StationInfo* result, unsigned int* size); | 获取接入的设备列表 | | int GetSignalLevel(int rssi, int band); | 获取信号强度等级 | | WifiErrorCode SetBand(int band); | 设置当前频段 | | WifiErrorCode GetBand(int* result); | 获取当前频段 | #### Hi3861 SDK的DHCP客户端接口： | API | 描述 | | ------------------- | ------------------ | | netifapi_netif_find | 按名称查找网络接口 | | netifapi_dhcp_start | 启动DHCP客户端 | | netifapi_dhcp_stop | 停止DHCP客户端 | ## 二、代码分析 ```c //wifi ap task static void WifiHotspotTask(void *arg) { (void)arg; WifiErrorCode errCode; HotspotConfig config = {0}; // 配置作为AP热点的ssid和key strcpy(config.ssid, "HiSpark-AP"); strcpy(config.preSharedKey, "12345678"); config.securityType = WIFI_SEC_TYPE_PSK; config.band = HOTSPOT_BAND_TYPE_2G; config.channelNum = 7; osDelay(10); printf("starting AP ...\r\n"); //开启热点 errCode = StartHotspot(&config); printf("StartHotspot: %d\r\n", errCode); //热点将开启1分钟 int timeout = 60; while (timeout--) { printf("After %d seconds Ap will turn off!\r\n", timeout); osDelay(100); } // 可以通过串口工具发送 AT+PING=192.168.xxx.xxx(如手机连接到该热点后的IP) 去ping连接到该热点的设备的IP地址 printf("stop AP ...\r\n"); //关闭热点 StopHotspot(); printf("stop AP ...\r\n"); } ``` ## 三、如何编译 1. 将此目录下的 `wifi_hotspot_demo.c` 和 `BUILD.gn` 复制到openharmony源码的`applications\sample\wifi-iot\app\iothardware`目录下， 2. 修改openharmony源码的`applications\sample\wifi-iot\app\BUILD.gn`文件，将其中的 `features` 改为： ``` features = [ "iothardware:wifi_demo", ] ``` 3. 在openharmony源码顶层目录执行：`python build.py wifiiot` ## 四、运行结果 ``` ready to OS start sdk ver:Hi3861V100R001C00SPC025 2020-09-03 18:10:00 FileSystem mount ok. wifi init success! 00 00:00:00 0 132 D 0/HIVIEW: hilog init success. 00 00:00:00 0 132 D 0/HIVIEW: log limit init success. 00 00:00:00 0 132 I 1/SAMGR: Bootstrap core services(count:3). 00 00:00:00 0 132 I 1/SAMGR: Init service:0x4af278 TaskPool:0xe4b38 00 00:00:00 0 132 I 1/SAMGR: Init service:0x4af284 TaskPool:0xe4b58 00 00:00:00 0 132 I 1/SAMGR: Init service:0x4af3ac TaskPool:0xe4b78 00 00:00:00 0 164 I 1/SAMGR: Init service 0x4af284 success! 00 00:00:00 0 64 I 1/SAMGR: Init service 0x4af278 success! 00 00:00:00 0 8 D 0/HIVIEW: hiview init success. 00 00:00:00 0 8 I 1/SAMGR: Init service 0x4af3ac success! 00 00:00:00 0 8 I 1/SAMGR: Initialized all core system services! 00 00:00:00 0 64 I 1/SAMGR: Bootstrap system and application services(count:0). 00 00:00:00 0 64 I 1/SAMGR: Initialized all system and application services! 00 00:00:00 0 64 I 1/SAMGR: Bootstrap dynamic registered services(count:0). starting AP ... RegisterWifiEvent: 0 SetHotspotConfig: 0 OnHotspotStateChanged: 1. EnableHotspot: 0 g_hotspotStarted = 1. netifapi_netif_set_addr: 0 netifapi_dhcp_start: 0 StartHotspot: 0 After 59 seconds Ap will turn off! After 58 seconds Ap will turn off! After 57 seconds Ap will turn off! +NOTICE:STA CONNECTED PrintStationInfo: mac=54:19:C8:D9:A7:35, reason=0. +OnHotspotStaJoin: active stations = 1. After 56 seconds Ap will turn off! After 55 seconds Ap will turn off! AT+PING=192.168.1.2 +PING: [0]Reply from 192.168.1.2:time=90ms TTL=64 After 49 seconds Ap will turn off! [1]Reply from 192.168.1.2:time=25ms TTL=64 After 48 seconds Ap will turn off! [2]Reply from 192.168.1.2:time=28ms TTL=64 After 47 seconds Ap will turn off! [3]Reply from 192.168.1.2:time=4ms TTL=64 4 packets transmitted, 4 received, 0 loss, rtt min/avg/max = 4/36/90 ms OK ... ... ... After 3 seconds Ap will turn off! After 2 seconds Ap will turn off! After 1 seconds Ap will turn off! After 0 seconds Ap will turn off! stop AP ... netifapi_dhcps_stop: 0 UnRegisterWifiEvent: 0 +NOTICE:STA DISCONNECTED EnableHotspot: 0 stop AP ... ``` ### 【套件支持】 ##### 1. 套件介绍 http://www.hihope.org/pro/pro1.aspx?mtt=8 ##### 2. 套件购买 https://item.taobao.com/item.htm?id=622343426064&scene=taobao_shop ##### 3. 技术资料 - Gitee码云网站（OpenHarmony Sample Code等) **https://gitee.com/hihopeorg** - HiHope官网-资源中心（SDK包、技术文档下载）**http://www.hihope.org/** ##### 4. 互动交流 - 润和HiHope技术交流-微信群（加群管理员微信13605188699，发送文字#申请加入润和官方群#，予以邀请入群） - HiHope开发者社区-论坛 **https://bbs.elecfans.com/group_1429** - 润和HiHope售后服务群（QQ：980599547） - 售后服务电话（025-52668590）