onps棧使用說明（2）——ping、功能變數名稱解析等網路工具測試

来源:https://www.cnblogs.com/neo-T/archive/2022/11/11/onps-5.html
-Advertisement-
Play Games

AIR32F103CBT6的存儲容量加上206MHz頻率, 跑RTOS才能充分利用它的性能. 關於FreeRTOS的介紹和集成, 網路上已經有不少文章, 可以直接百度搜索查看, 這裡主要介紹一下項目中的FreeRTOS集成步驟和代碼說明. ...


1. ping測試

協議棧提供ping工具，其頭文件為“net_tools/ping.h”，將其include進你的目標系統中即可使用這個工具。

……
#include "onps.h"
#include "net_tools/ping.h"

//* 回調函數，收到目標地址的應答報文後ping工具會調用這個函數完成用戶的特定處理邏輯
//* 針對這個測試，在這裡就是簡單地列印出了應答報文的內容以及ping的響應時間
static void  ping_recv_handler(USHORT usIdentifier,   //* ping的標識id，響應報文與探測報文這個id應該一致
                               in_addr_t unFromAddr,  //* 響應報文的源地址
                               USHORT usSeqNum,       //* 響應報文序號，其與探測報文一致
                               UCHAR *pubEchoData,    //* 響應報文攜帶的響應數據，其與探測報文一致
                               UCHAR ubEchoDataLen,   //* 響應報文攜帶的數據長度
                               UCHAR ubTTL,           //* ttl值
                               UCHAR ubElapsedMSecs)  //* 響應時長，單位：秒，從發送探測報文開始計時到收到響應報文結束計時
{
    CHAR szSrcAddr[20];
    struct in_addr stInAddr; 
    stInAddr.s_addr = unFromAddr; 
    printf("<Fr>%s, recv %d bytes, ID=%d, Sequence=%d, Data='%s', TTL=%d, time=%dms\r\n", 
           inet_ntoa_safe(stInAddr, szSrcAddr), //* 這是一個線程安全的ip地址轉ascii字元串函數
           (UINT)ubEchoDataLen, 
           usIdentifier, 
           usSeqNum, 
           pubEchoData, 
           (UINT)ubTTL, 
           (UINT)ubElapsedMSecs);
}

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 0
        emac_init(); //* ethernet網卡初始化函數，並註冊網卡到協議棧
    #else
        while(!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; 
    }
    
    //* 啟動ping測試
    USHORT usSeqNum = 0;
    UINT unErrCount = 0; 
    INT nPing = ping_start(&enErr); 
    if(nPing < 0)
    {
        //* 啟動失敗，輸出一條日誌信息
        printf("ping_start() failed, %s\r\n", onps_error(enErr));
        return -1; 
    }
    
    while(TRUE && usSeqNum < 100)
    {
        //* ping目標地址
        INT nRtnVal = ping(nPing, inet_addr("192.168.0.2"), usSeqNum++, 64, GetElapsedMSecs, ping_recv_handler, 3, &enErr);
        if(nRtnVal <= 0) //* ping返回一個錯誤
        {
            //* 累計ping錯誤數
            unErrCount++; 

            //* 控制台列印當前錯誤數        
            printf("no reply received, the current number of errors is %d, current error: %s\r\n", unErrCount, nRtnVal ? onps_error(enErr) : "recv timeout"); 
        }
        os_sleep_secs(1); 
    }    
    
    //* 結束ping測試
    ping_end(nPing);
    
    return 0; 
}

上述示例代碼調用了ping測試工具提供的幾個api函數。ping_start()函數的調用非常簡單，其功能就是開啟ping測試。結束ping測試需要調用ping_end()函數，否則ping測試會一直占用協議棧資源。這幾個函數的說明如下：

函數原型

INT ping_start(EN_ONPSERR *penErr);

功能

啟動ping測試。註意，啟動後你可以隨時更換目標地址，不必拘泥於一個固定的目標地址。

參數

  • penErr：如果啟動失敗，該參數用於接收具體的錯誤碼

返回值

成功，返回當前啟動的ping測試任務的句柄；失敗，返回值小於0，具體錯誤信息參看pennErr保存的錯誤碼。

-

函數原型

void ping_end(INT nPing);

功能

結束ping測試，釋放占用的協議棧資源。

參數

  • nPing：ping_start()函數返回的ping測試句柄

返回值

無

-

函數原型

INT ping(INT nPing,

         in_addr_t unDstAddr,

         USHORT usSeqNum,

         UCHAR ubTTL,

         UINT(*pfunGetCurMSecs)(void),

         void(*pfunRcvHandler)(USHORT usIdentifier,

                               in_addr_t unFromAddr,

                               USHORT usSeqNum,

                               UCHAR *pubEchoData,

                               UCHAR ubEchoDataLen,

                               UCHAR ubTTL,

                               UCHAR ubElapsedMSecs),

         UCHAR ubWaitSecs,

         EN_ONPSERR *penErr);

功能

ping目標地址並等待接收對端的響應報文。其功能與通用的ping測試工具完全相同。

參數

  • nPing：ping_start()函數返回的ping測試句柄
  • unDstAddr：目標地址
  • usSeqNum：報文序號，用於唯一的標識發出的探測報文
  • ubTTL：ttl值，探測報文到達目標地址之前的生存時間
  • pfunGetCurMSecs：函數指針，這個函數返回系統定時器自啟動以來的工作時長，單位：毫秒，其精度取決於os定時器粒度，其用於統計
  • ping的響應時間，必須提供這個函數，否則ping操作將無法完成
  • pfunRcvHandler：函數指針，收到響應報文後將調用這個函數完成用戶指定的操作，ping_recv_handler()就是它的實際實現
  • ubWaitSecs：響應報文的最長等待時間，單位：秒
  • penErr：如果ping失敗，該參數保存具體的錯誤碼

返回值

大於0，ping成功；0，等待響應報文超時；小於0，失敗，具體的錯誤信息參看pennErr保存的錯誤碼。

 

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 0
        emac_init(); //* ethernet網卡初始化函數，並註冊網卡到協議棧
    #else
        while(!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));
        }
        else
            printf("%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 0
        emac_init(); //* ethernet網卡初始化函數，並註冊網卡到協議棧
    #else
        while(!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 1    
    if(sntp_update_by_ip("52.231.114.183", NULL, RTCSetSystemUnixTimestamp, 8, &enErr)) //* ntp伺服器地址直接校時
#else
    if(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伺服器，並等待伺服器的響應報文，完成校時操作。

參數

  • pszNtpSrvIp：ntp伺服器ip地址
  • pfunTime：函數指針，與c庫函數time()功能及原型相同，返回自1970年1月1日0時0分0秒以來經過的秒數，可以為空
  • pfunSetSysTime：函數指針，通過unix時間戳設置系統當前時間，由sntp_update_by_xx()內部調用，收到正確的響應報文後調用該函數設置系統時間
  • bTimeZone：時區，例如東8區，其值為8；西8區其值為-8
  • penErr：如果校時失敗，該參數用於接收具體的錯誤碼

返回值

校時成功，返回TRUE；失敗，返回FALSE，具體錯誤信息參看pennErr保存的錯誤碼。

sntp_update_by_dns()函數與sntp_update_by_ip()函數除了第一個入口參數變成了功能變數名稱外，其它完全相同，不再贅述。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 淺談PHP設計模式的原型模式
    簡介： 原型模式，屬於創建型模式的一種。 主要針對對象進行克隆，把被克隆的對象稱之為原型，原型模式稱之為克隆模式也許更為貼切。 用原型實例指定創建對象的種類，並且通過拷貝這些原型創建新的對象。 適用場景： 實例化對象的資源開銷過大時可直接克隆。 需要迴圈創建大量對象，此時用克隆也是一個挺不錯的選擇。 ...
  • SAS 日期處理(一)
    1 文件結構 每個C/C++程式通常分為兩個文件，頭文件（保存程式的聲明）和定義文件（保持程式的實現）。 頭文件以“.h”為尾碼；C程式的定義文件以“.c”為尾碼，C++程式的定義文件通常以“.cpp”為尾碼（也有一些“.cc”、“.cxx”、“.hpp”為尾碼）。 1.1 版權和版本的聲明 每個頭 ...
  • 【python】點燃我，溫暖你 ，快來Get同款~
    前言 大家早好、午好、晚好吖 ❤ ~ 最近，一部名叫《點燃我，溫暖你》得電視劇衝進了大家得視野~ 講述得是肆意張揚的編程天才李峋與勇敢堅韌的少女學霸朱韻從青澀校園到職場拼搏幾經波折，依然攜手前行的成長愛情故事！ 其中李峋用代碼做出的紅色跳動的愛心，一下子跳到朱韻的心坎里，同樣也跳到我們的心坎 今天， ...
  • 前後端分離項目解決前端跨域訪問問題
    前後端分離開發，必須解決跨域問題！ 跨域：對於 url 如 http://localhost:8080，請求協議、ip 地址、埠號，只要發送請求方和接收請求方的這三個數據中，只要有一個不同，就表示是跨域訪問！ AJAX 跨域訪問：用戶訪問 A 網站時所產生的對 B 網站的跨域訪問請求均提交到 A ...
  • 【JS 逆向百例】猿人學系列 web 比賽第二題：js 混淆 - 動態 cookie，詳細剖析
    逆向目標 猿人學 - 反混淆刷題平臺 Web 第二題：js 混淆，動態 cookie 目標：提取全部 5 頁發佈日熱度的值，計算所有值的加和 主頁：https://match.yuanrenxue.com/match/2 介面：https://match.yuanrenxue.com/api/mat ...
  • .NET7 gRPC JSON轉碼+OpenAPI
    gRPC JSON轉碼 gRPC JSON 轉碼允許瀏覽器應用調用 gRPC 服務，就像它們是使用 JSON 的 RESTful API 一樣。 瀏覽器應用不需要生成 gRPC 客戶端或瞭解 gRPC 的任何信息。 通過使用 HTTP 元數據註釋 .proto 文件，可從 gRPC 服務自動創建 R ...
  • 乘風破浪，遇見最佳跨平臺跨終端框架.Net Core/.Net生態 - .NET 7正式發佈，看看ASP.NET Core 7.0和EF Core 7新增哪些功能
    2022年11月8日.NET 7正式發佈 .NET仍然是最快、最受歡迎、最值得信賴的平臺之一，其龐大的.NET軟體包生態系統包括33萬多個軟體包。 .NET 7為您的應用程式帶來了更高的性能和C# 11/F# 7、.NET MAUI、ASP.NET Core/Blazor、Web APIs、WinF ...
  • 一文搞懂Path環境變數
    什麼是Path環境變數？ 在探討這個問題之前，我們需要瞭解什麼是環境變數。 “環境變數”和“path環境變數”其實是兩個東西，這一點大家一定要區分開，不要混為一談。 “環境變數”是操作系統工作環境設置的一些選項或屬性參數。每個環境變數由變數名和文件路徑組成的，可以設置很多個環境變數。 我們一般使用環 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類