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 6 Entity Framework Core Db First（1） 創建模型
    .Net8.0 Blazor Hybird 桌面端 (WPF/Winform) 實測可以完整運行在 win7sp1/win10/win11. 如果用其他工具打包,還可以運行在mac/linux下, 傳送門BlazorHybrid 發佈為無依賴包方式 安裝 WebView2Runtime 1.57 M ...
  • 資料庫升級PostgreSql+Garnet
    目錄前言PostgreSql安裝測試額外Nuget安裝Person.cs模擬運行Navicate連postgresql解決方案Garnet為什麼要選擇Garnet而不是RedisRedis不再開源Windows版的Redis是由微軟維護的Windows Redis版本老舊，後續可能不再更新Garne ...
  • 如何基於surging架設流媒體視頻推流（視頻講解）
    C#TMS系統代碼-聯表報表學習 領導被裁了之後很快就有人上任了，幾乎是無縫銜接，很難讓我不想到這早就決定好了。我的職責沒有任何變化。感受下來這個系統封裝程度很高，我只要會調用方法就行。這個系統交付之後不會有太多問題，更多應該是做小需求，有大的開發任務應該也是第二期的事，嗯？怎麼感覺我變成運維了？而 ...
  • EAV模型（實體-屬性-值）的設計和低代碼的處理方案（2）--數據的查詢處理
    我在隨筆《EAV模型（實體-屬性-值）的設計和低代碼的處理方案（1）》中介紹了一些基本的EAV模型設計知識和基於Winform場景下低代碼（或者說無代碼）的一些實現思路，在本篇隨筆中，我們來分析一下這種針對通用業務，且只需定義就能構建業務模塊存儲和界面的解決方案，其中的數據查詢處理的操作。 ...
  • C# 程式集、模塊和類型概念及關係
    對某個遠程伺服器啟用和設置NTP服務(Windows系統) 打開註冊表 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W32Time\TimeProviders\NtpServer 將 Enabled 的值設置為 1，這將啟用NTP伺服器功 ...
  • Django信號與擴展：深入理解與實踐
    title: Django信號與擴展：深入理解與實踐 date: 2024/5/15 22:40:52 updated: 2024/5/15 22:40:52 categories: 後端開發 tags: Django 信號 松耦合 觀察者 擴展 安全 性能 第一部分：Django信號基礎 Djan ...
  • Django3.2安裝源碼xadmin2步驟以及遇到的問題
    使用xadmin2遇到的問題&解決 環境配置： 使用的模塊版本： 關聯的包 Django 3.2.15 mysqlclient 2.2.4 xadmin 2.0.1 django-crispy-forms >= 1.6.0 django-import-export >= 0.5.1 django-r ...
  • 原創->CommonsCollections1-DefaultMap鏈
    今天我打算整點兒不一樣的內容，通過之前學習的TransformerMap和LazyMap鏈，想搞點不一樣的，所以我關註了另外一條鏈DefaultedMap鏈，主要調用鏈為： 調用鏈詳細描述： ObjectInputStream.readObject() DefaultedMap.readObject ...
  • 05-應用級開發者 AI 時代破局點
    後端應用級開發者該如何擁抱 AI GC？就是在這樣的一個大的浪潮下，我們的傳統的應用級開發者。我們該如何選擇職業或者是如何去快速轉型，跟上這樣的一個行業的一個浪潮? 0 AI金字塔模型 越往上它的整個難度就是職業機會也好，或者說是整個的這個運作也好,它的難度會越大,然後越往下機會就會越多,所以這是一 ...
  • Java面試題：讓依賴註入變得簡單，面對@Autowired和@Resource，該如何選擇？
    @Autowired是Spring框架提供的註解，@Resource是Java EE 5規範提供的註解。 @Autowired預設按照類型自動裝配，而@Resource預設按照名稱自動裝配。 @Autowired支持@Qualifier註解來指定裝配哪一個具有相同類型的bean，而@Resourc... ...
所有分類