2 onps栈使用说明——ping、域名解析等网络工具测试( 三 ) _生活百科

功能
发送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;}

测试代码首先把时间设定在了2022年9月5日17点42分30秒，目的是为了验证目标系统时间是否会被成功校正。测试代码用到了目标系统应提供的一组rtc时钟操作函数。其中RTCSetSysTime()用于设置系统时间。RTCSetSystemUnixTimestamp()函数同样也是设置系统时间，只不过是通过unix时间戳进行设置。RTCGetSysTime()函数用于读取当前系统时间。相较于ping及dns工具，sntp网络校时工具只提供了一个接口函数sntp_update_by_xx()即可完成校时。我们可以通过ntp服务器地址也可以通过ntp服务器域名进行校时。该函数的详细使用说明如下：
函数原型
BOOL sntp_update_by_ip(const CHAR *pszNtpSrvIp, time_t(*pfunTime)(void), void(*pfunSetSysTime)(time_t), CHAR bTimeZone, EN_ONPSERR *penErr);
功能
发送一个校时请求到pszNtpSrvIp参数指定的ntp服务器，并等待服务器的响应报文，完成校时操作。
参数