2 onps栈使用说明——ping、域名解析等网络工具测试( 二 )


2. dns测试这个测试需要为网卡设定好能够访问互联网的网关、DNS服务器地址等配置信息 。当然如果采用dhcp动态地址申请的方式能够得到这些信息那就更省事了 。dns查询工具的头文件为"net_tools/dns.h" 。
……#include "onps.h"#include "net_tools/ping.h"int main(void){if(open_npstack_load(&enErr)){printf("The open source network protocol stack (ver %s) is loaded successfully. \r\n", ONPS_VER);//* 协议栈加载成功,在这里初始化ethernet网卡或等待ppp链路就绪#if 0emac_init(); //* ethernet网卡初始化函数 , 并注册网卡到协议栈#elsewhile(!netif_is_ready("ppp0")) //* 等待ppp链路建立成功os_sleep_secs(1);#endif}else{printf("The open source network protocol stack failed to load, %s\r\n", onps_error(enErr));return -1;}//* dns查询测试in_addr_t unPrimaryDNS, unSecondaryDNS;INT nDnsClient = dns_client_start(&unPrimaryDNS, &unSecondaryDNS, 3, &enErr);if(nDnsClient < 0){//* dns客户端启动失败 , 输出一条错误日志printf("%s\r\n", onps_error(enErr));}else{//* 发送查询请求并等待dns服务器的应答in_addr_t unIp = dns_client_query(nDnsClient, unPrimaryDNS, unSecondaryDNS, "gitee.com", &enErr);if(unIp) //* 查询成功{CHAR szAddr[20];printf("The ip addr: %s\r\n", inet_ntoa_safe_ext(unIp, szAddr));}elseprintf("%s\r\n", onps_error(enErr)); //* 查询失败//* 结束dns查询 , 释放占用的协议栈资源dns_client_end(nDnsClient);}return 0;}与ping测试工具相同,dns查询工具同样提供了一组简单的api函数用于实现域名查询 。这一组函数包括dns_client_start()、dns_client_end()以及dns_client_query(),其使用说明如下:
函数原型
INT dns_client_start(in_addr_t *punPrimaryDNS, in_addr_t *punSecondaryDNS, CHAR bRcvTimeout, EN_ONPSERR *penErr);
功能
启动一个域名查询客户端 。
参数

  • punPrimaryDNS:指针类型,用于接收主域名服务器地址 。协议栈会选择缺省路由绑定的网卡,并得到网卡携带的dns服务器地址用于接下来的域名查询,该参数即用于保存主dns服务器的地址
  • punSecondaryDNS:指针类型,与上同,用于接收次域名服务器地址
  • bRcvTimeout:查询超时时间,单位:秒
  • penErr:如果启动失败 , 该参数用于接收具体的错误码
返回值
成功,返回当前启动的dns客户端的句柄;失败,返回值小于0,具体错误信息参看pennErr保存的错误码 。
-
函数原型
void dns_client_end(INT nClient);
功能
结束dns客户端,释放占用的协议栈资源 。
参数
  • nClient:dns_client_start()函数返回的dns客户端句柄
返回值

-
函数原型
in_addr_t dns_client_query(INT nClient, in_addr_t unPrimaryDNS, in_addr_t unSecondaryDNS, const CHAR *pszDomainName, EN_ONPSERR *penErr);
功能
发送dns查询请求 , 并等待服务器的响应报文,功能与通用的dns客户端完全相同 。
参数
  • nClient:dns_client_start()函数返回的dns客户端句柄
  • punPrimaryDNS:主域名服务器地址,其值为dns_client_start()函数得到的主域名服务器地址
  • punSecondaryDNS:次域名服务器地址,其值为dns_client_start()函数得到的次域名服务器地址
  • pszDomainName:指针类型,指向要查询的域名
  • penErr:如果查询失败,该参数用于接收具体的错误码
返回值
成功,返回域名对应的ip地址;失败 , 返回值为0,具体错误信息参看pennErr保存的错误码 。3. sntp网络校时测试与dns的测试要求一样,要进行这个测试依然要确保你的开发板在物理层能够访问互联网,同时你的开发板支持rtc , 并提供一组rtc操作函数,包括读取、设置系统当前时间等api 。这里假设你的测试环境已经具备上述测试条件 。sntp网络校时工具的头文件为"net_tools/sntp.h" 。
……#include "onps.h"#include "net_tools/sntp.h"int main(void){if(open_npstack_load(&enErr)){printf("The open source network protocol stack (ver %s) is loaded successfully. \r\n", ONPS_VER);//* 协议栈加载成功,在这里初始化ethernet网卡或等待ppp链路就绪#if 0emac_init(); //* ethernet网卡初始化函数 , 并注册网卡到协议栈#elsewhile(!netif_is_ready("ppp0")) //* 等待ppp链路建立成功os_sleep_secs(1);#endif}else{printf("The open source network protocol stack failed to load, %s\r\n", onps_error(enErr));return -1;}//* 先设定个不合理的时间,以测试网络校时功能是否正常,由rtc驱动提供,负责修改系统当前时间//* RTC前缀的函数为目标系统应提供的rtc时钟操作函数RTCSetSysTime(22, 9, 5, 17, 42, 30);//* 开启网络校时 , sntp_update_by_ip()与sntp_update_by_dns()均可使用ST_DATETIME stDateTime;#if 1if(sntp_update_by_ip("52.231.114.183", NULL, RTCSetSystemUnixTimestamp, 8, &enErr)) //* ntp服务器地址直接校时#elseif(sntp_update_by_dns("time.windows.com", Time, RTCSetSystemUnixTimestamp, 8, &enErr)) //* ntp服务器域名方式校时#endif{//* 获取系统时间,检查校时结果RTCGetSysTime(&stDateTime);//* 控制台输出当前系统时间printf("The time is %d-%02d-%02d %02d:%02d:%02d\r\n", stDateTime.usYear, stDateTime.ubMonth,stDateTime.ubDay, stDateTime.ubHour, stDateTime.ubMin, stDateTime.ubSec);}else{printf("%s\r\n", onps_error(enErr));return -1;}return 0;}

推荐阅读