eta6210使用手册

Size: px

Start display at page:

Download "eta6210使用手册"

马崩堀常
6 years ago
Views:

1 Emtronix ETA6210(WINCE)Wifi 扩展模块应用手册

2 感谢您购买英创信息技术有限公司的产品 :ETA6210(WINCE)Wifi 扩展模块您可以访问英创公司网站或直接与英创公司联系以获得 ETA6210 的其他相关资料英创信息技术有限公司联系方式如下 : 地址 : 成都市高新区高朋大道 5 号博士创业园 B 座 407# 邮编 : 联系电话 : 传真 : 网址 : 电子邮件 :support@emtronix.com

ETA6210 简介 ETA6210 是一款标准 minipcie 尺寸的 WiFi 通讯模块, 模块核心芯片为 NXP 的 imx6ul 和 AP6181 WiFi 芯片英创公司 WINCE 工控主板是通过 minipcie 上的 USB 接口来操作 ETA6210 模块的在实际应用中,ETA6210 是插在客户底板的 minipcie 插座上使用开发评估阶段, 可插在英创的

3 ETA6210 简介 ETA6210 是一款标准 minipcie 尺寸的 WiFi 通讯模块, 模块核心芯片为 NXP 的 imx6ul 和 AP6181 WiFi 芯片英创公司 WINCE 工控主板是通过 minipcie 上的 USB 接口来操作 ETA6210 模块的在实际应用中,ETA6210 是插在客户底板的 minipcie 插座上使用开发评估阶段, 可插在英创的 ESMARC EVB 评估底板的 minipcie 插座上使用, 也可利用 ETA303 模块转换成标准 USB 接口使用 ETA6210 本身预装有完整的操作系统, 在上电后自动进行 WIFI 连接并同时打开 3 路虚拟串口 COM10-12 与 WINCE 工控主板进行通信 : 一路 (COM10) 用 AT 指令进行参数设置, 模块控制等一路 (COM11) 用于网络透传一路 (COM12) 备用 ETA6210 网络模式与常规 WIFI 模块略有区别 ETA6210 直接连入 WIFI 网络, 同时作为路由器接受嵌入式主板的连接 ETA6210 将 WIFI 网络中的数据直接透传给嵌入式主板, 所以对于嵌入式主板而言, 与直接连入 WIFI 网络没有区别, 只是无法直接调用 API 函数获得 WIFI 网络中的 IP,MASK, 网关, 而是需要通过 AT 指令访问 ETA6210 获得连接到 WIFI 网络后, 可以使用 SOCKET 编程访问网络安装 ETA6210 可以通过 minipcie 直接连接到英创 ESMARC 底板上, 也可以通过 ETA303 模块转接到板子 USB 上图 1 和图 2 显示它们的连接关系图 ETA303 英创工控主板将在最新内核中支持 ETA6210, 用户可以接上主板后直接使用使用原内核的客户可以联系英创工程师获得 ETA6210 驱动安装程序

使用方法英创公司提供完整代码的源程序供客户参考, 在开始阶段, 客户可以直接使用编译好的界面程序进行测试界面程序 APConnect 简介将英创提供的 APConnect 程序放入工控主板运行, 可以见到如下界面界面上部显示有连接的 WIFI 服务器名称及网络 IP 等信息下部分是模块搜索到的 AP 列表, 客户可以选择 AP, 输入密码, 进行连接英创提供 APConnect

4 使用方法英创公司提供完整代码的源程序供客户参考, 在开始阶段, 客户可以直接使用编译好的界面程序进行测试界面程序 APConnect 简介将英创提供的 APConnect 程序放入工控主板运行, 可以见到如下界面界面上部显示有连接的 WIFI 服务器名称及网络 IP 等信息下部分是模块搜索到的 AP 列表, 客户可以选择 AP, 输入密码, 进行连接英创提供 APConnect 程序源码, 客户可以根据自身需要进行修改接口介绍英创提供的例程 ETA6210Set 是对 ETA6210 模块进行配置的示例例程例程将 ETA6210 模块接口封装到了 class ETA6210 类中,ETA6210 主要 PUBLIC 接口如下 : class ETA6210 public: ETA6210(void); ~ETA6210(void); BOOL CreateEntry();

5 ; BOOL GetState(LinkStates *plinkstates); BOOL GetAPList(APInfo *papinfo, int maxnum, int *pnum); BOOL ConnectAP(char *ssid, char *password); BOOL DisconnectAP(); BOOL GetIPInfo(IPInfo *pipinfo); BOOL SetIPInfo(IPInfo *pipinfo); 客户将封装好的库添加进自己工程中, 即可很方便的操作 ETA6210 参考例程, 使用时在工程中添加 Serial.h, Serial.cpp, ETA6210.h, ETA6210.cpp 共 4 个文件并定义 ETA6210 类 #include "ETA6210.h" ETA6210 eta6210; ETA6210 模块初始化使用 ETA6210 首先需要创建拨号连接拨号连接只需要创建一次, 重复创建不会产生变化, 不会返回失败函数原型 BOOL CreateEntry(); 返回值调用成功返回 TRUE, 失败返回 FALSE 调用实例 bret = eta6210.createentry(); 查询 wifi 列表查询 ETA6210 能够搜索到的附近 AP, 并将它们存入结构体数组中返回函数原型 BOOL GetAPList(APInfo *papinfo, int maxnum, int *pnum); 参数 papinfo 指向 APInfo 结构体数组指针, 当调用成功,AP 信息将依次存

6 入结构体数组中 maxnum 传入的结构体数组大小返回值 pnum 返回的 AP 数量, 不会超过 maxnum 调用成功返回 TRUE, 失败返回 FALSE 参数结构体定义 struct APInfo char ssid[50]; //ssid char mac[18]; //mac ca:d7:19:d8:a6:44 int channel; int rssi; //rssi 信号强度 int ecn; // 加密方式 :OPEN,WEP,WPA_PSK,WPA2_PSK, WPA_WPA2_PSK int freqoffset; // 频偏 int freqcalibration; // 频率校准 ; 调用实例 APInfo apinfo[15]; int n; bret = eta6210.getaplist(apinfo, 15, &n); 连接 WIFI 设置要连接的 WIFI 热点的 SSID, 及密码, 并拨号连接函数原型 BOOL ConnectAP(char *ssid, char *password); 参数 ssid AP 名称, 如果为空, 则使用上次连接的 SSID password AP 密码, 如果为空, 则使用上次使用的密码返回值

7 连接成功返回 TRUE, 失败返回 FALSE 调用实例 bret = eta6210.connectap("emtronix.20", " "); 或 bret = eta6210.connectap(null, NULL); // 使用上次的 SSID 及密码断开连接断开 WIFI 连接函数原型 BOOL DisconnectAP(); 返回值成功断开返回 TRUE, 失败返回 FALSE 调用实例 bret = eta6210.disconnectap(); 查询模块状态查询模块当前状态包括模块是否处于连接状态, 连接的 AP 的 SSID 函数原型 BOOL GetState(LinkStates *plinkstates); 参数 plinkstates 指向 LinkStates 结构体, 记录模块网络是否连接成功, 及连接的 SSID 名, 及信号强度返回值调用成功返回 TRUE, 失败返回 FALSE 参数结构体定义 struct LinkStates

8 BOOL blink; // 连接状态 char ssid[50]; //ssid int rssi; // 信号强度调用实例 LinkStates linkstates; bret = eta6210.getstate(&linkstates); 查询网络参数因为英创嵌入式主板只连接到 ETA6210 模块的内部网络中,ETA6210 再连接到 WIFI 网络并将数据透传给英创嵌入式主板嵌入式主板通过 API 只能获得内部网络里的 IP, 必须通过以下接口函数获得在 WIFI 网络里的 IP,MASK, 网关参数函数原型 BOOL GetIP(IPInfo *pipinfo); 参数 pipinfo 指向 IpInfo 结构体, 储存有连接到 WIFI 中时的网络 IP,mask 及网关返回值调用成功返回 TRUE, 失败返回 FALSE 参数结构体定义 struct IPInfo char ip[16]; char gw[16]; char mask[16]; ; 调用实例 IPInfo ipinfo; bret = eta6210.getip(&ipinfo);

9 设置网络参数设置模块连入 WIFI 网络里的网络参数, 如, 在做 TCP 服务器时需要用到函数原型 BOOL SetIP(IPInfo *pipinfo); 参数 pipinfo 指向 IpInfo 结构体, 将要设置的网络 IP,mask 及网关填入结构体中, 如果为空字符串, 则该项不设置, 任使用原参数返回值调用成功返回 TRUE, 失败返回 FALSE 参数结构体定义 struct IPInfo char ip[16]; char gw[16]; char mask[16]; ; 调用实例 IPInfo ipinfo; bret = eta6210.getip(&ipinfo); sprintf(ipinfo.ip, " "); sprintf(ipinfo.gw, " "); sprintf(ipinfo.mask, " "); bret = eta6210.setip(&ipinfo); SOCKET 编程示例拨号成功后, 可以使用 SOCKET 进行网络通信以英创开发光盘里的例程为例 TCP 客户端 C# 例程参考英创开发光盘中 C# 例程 step4_tcptest 例程, 不用修改例程即可直接进

10 行调试连接服务端通过 WIFI 网络, 连接到服务器, 并建立接收线程 try rip = IPAddress.Parse(textBox_rip.Text); rport = Convert.ToInt32(textBox_rport.Text); 口 IPEndPoint rep = new IPEndPoint(rip, rport); 远程 IP, 端口初始一个 IPEndPoint 类 //IP // 端 // 用 ctcp = new TcpClient(); ctcp.connect(rep); revthread = new Thread(new ThreadStart(waitforMessage)); threadstop = false; revthread.start(); // 启动 waitformessage 线程 catch(exception ex) MessageBox.Show(" 连接失败 :"); statusbar1.text = (ex.message); return; 发送消息 byte[] OutBuffer; int length; OutBuffer = Encoding.Default.GetBytes(textBox_send.Text); length = OutBuffer.Length; ctcp.client.send(outbuffer, length, 0); 消息接收线程函数 void waitformessage() // 客户机状态下接收数据线程 int i; byte[] InBuffer = new byte[1024]; while (!threadstop)

11 i = ctcp.client.receive(inbuffer); if (i == 0) Invoke(new EventHandler(serverDisconnect)); // 注意使用 Invoke return; revstr = Encoding.Default.GetString(InBuffer, 0, InBuffer.Length); Invoke(new EventHandler(textBox_rev_Show)); 图光盘 C# 例程 step4_tcptest 测试图 TCP 服务端 C 例程参考英创开发光盘中 C 例程 test_tcp_server 例程并对例程稍作修改

12 获得 WIFI 口 IP 获得 WIFI 网口的 IP, 并显示到 MFC 程序界面上 m_cedit_name2.setwindowtext(l"eta6210"); bret = GetNetWorkAdapterInfo( L"ETA6210", &AdptInfo ); m_ip2 = AdptInfo.IPAddr; wsprintf(wstr, L"%d.%d.%d.%d", m_ip2>>24, (m_ip2>>16)&0xff, (m_ip2>>8)&0xff, m_ip2&0xff); m_cedit_ip2.setwindowtext(wstr); m_cedit_port2.setwindowtext(l"5000"); 打开服务端初始化网络, 创建 SOCKET 并绑定到 WIFI 网口, 建立接收线程 //1. 初始化 socket 资源 if (WSAStartup(MAKEWORD(1,1),&wsa)!= 0) return -1;// 代表失败 //2. 创建套接字 if ((m_socketserver = socket(af_inet, SOCK_STREAM, IPPROTO_TCP))<0) return -2; //3. 绑定端口 SOCKADDR_IN serveraddr; ZeroMemory((char *)&serveraddr,sizeof(serveraddr)); serveraddr.sin_family = AF_INET; serveraddr.sin_port = htons(m_dwport); serveraddr.sin_addr.s_addr = htonl(m_dwip); if (bind(m_socketserver, (struct sockaddr *)&serveraddr, sizeof(serveraddr))<0) return -3 ; //4. 设置为侦听套接字, 可同时响应个客户的连接请求 if (listen(m_socketserver, 8)!=0)

13 return -4; //4. 设置监听套接字通讯模式为异步模式 //DWORD ul= 1; //ioctlsocket(m_socketserver,fionbio,&ul); //5. 创建侦听通讯线程, 在线程里, 等待客户端连接请求 m_blistenthreadstop = FALSE; m_hlistenthread = CreateThread(NULL, 0, SocketListenThread, this, 0, NULL); if (m_hlistenthread == NULL) closesocket(m_socketserver); return -5; 发送消息 ilen = m_cedit_send1.getwindowtext(wstr, 1024); ilen = WideCharToMultiByte(CP_ACP, 0, wstr, ilen, str, 1024, NULL, NULL); m_tcpserver1.send(str, ilen); 消息接收线程函数 DWORD CTCPServer::SocketListenThread(PVOID lparam) CTCPServer *ptcpserver; // 得到 CTCPServer_CE 实例指针 ptcpserver = (CTCPServer*)lparam; while (!ptcpserver->m_blistenthreadstop) SOCKADDR_IN clientaddr; int addrlen = sizeof(clientaddr); // 等待客户端连接 ptcpserver->m_socketclient[0] = accept(ptcpserver->m_socketserver, (struct sockaddr *)&clientaddr, &addrlen); if (ptcpserver->m_socketclient[0] > 0) // 判定是否连接上了 ptcpserver->m_revlen = recv(ptcpserver->m_socketclient[0], ptcpserver->m_revbuf, sizeof(ptcpserver->m_revbuf), 0); while (ptcpserver->m_revlen > 0)

ptcpserver->onrev(lparam); ptcpserver->m_revlen = recv(ptcpserver->m_socketclient[0], ptcpserver->m_revbuf, sizeof(ptcpserver->m_revbuf), 0); return 0; 注 : 该例程设定的网口 2 由有线网口改为了 wifi, 所以网络名修改为了

14 ptcpserver->onrev(lparam); ptcpserver->m_revlen = recv(ptcpserver->m_socketclient[0], ptcpserver->m_revbuf, sizeof(ptcpserver->m_revbuf), 0); return 0; 注 : 该例程设定的网口 2 由有线网口改为了 wifi, 所以网络名修改为了 ETA6210, 同时绑定的 IP 需要设置为 ETA6210 内部网络的 IP, 默认但是本例测试时, 连入到 WIFI 网络中的 IP 通过接口函数 GetIP 查到是 , 所以测试 PC 连接的 TCP 服务端 IP 为而不是图光盘 C 例程 test_tcp_server 测试图

15 网络测试 WIFI 网络内的 PC 可以通过 IP PING 通使用 ETA6210 的嵌入式主板, 也可以通过 TELNET 连接到嵌入式主板中测试 ETA6210 可以满足正常的 WIFI 应用获得英创提供了例程及源代码, 有需要的客户可以联系英创工程师

Slide 1

网络编程入门篇利用 socket 实现 TCP 服务器目录基础知识具体示例示例代码讲解基础知识基础知识 socket 编程一般采用客户端 - 服务器模式 ( 即由客户进程向服务器进程发出请求, 服务器进程执行请求的任务并将执行结果返回给客户进程的模式 ) 今天我们要讲的就是如何利用 socket 编程实现基于 TCP 协议通信的服务器首先我们先向大家展示 socket 编程的流程,