WifiConfig_NetworkDiagnostics 構造体

[アーティクル]
08/09/2023

ヘッダー: applibs </wificonfig.h #include>

ネットワークに接続するための最新のエラーに関する情報。

メモ

これは、バージョン管理された構造体のエイリアスです。このエイリアスを使用するWIFICONFIG_STRUCTS_VERSIONを定義します。

typedef struct WifiConfig_NetworkDiagnostics {

    uint8_t isEnabled;
    uint8_t isConnected;
    int32_t error;
    time_t timestamp;
    int32_t certError;
    int32_t certDepth;
    CertStore_SubjectName certSubject;
} WifiConfig_NetworkDiagnostics;

メンバー

isEnabled uint8_t

ネットワークが有効かどうかを示します。有効な場合は値は 1、有効でない場合は 0 です。このフィールドは、構成の状態ではなく、ネットワークの現在の状態を示します。ネットワークが一時的に無効になっている場合、値は 0 になります。

uint8_t isConnected

ネットワークが接続されているかどうかを示します。接続されている場合は値は 1、接続されていない場合は 0 です。

int32_t エラー

このネットワークに接続できない最新の理由。使用可能な値:

型	値	意味
ConnectionFailed	1	接続に失敗した場合の汎用エラーメッセージ。 EAP-TLS ネットワークの場合、このエラーは、RADIUS サーバーに到達できないか、RADIUS サーバーが認識しないクライアント ID を使用することによって発生する可能性があります。
NetworkNotFound	2	ネットワークが見つかりませんでした。
NoPskIncluded	3	ネットワークパスワードがありません。
WrongKey	4	ネットワークで正しくないパスワードが使用されています。
AuthenticationFailed	5	認証に失敗しました。このエラーは EAP-TLS ネットワークにのみ適用されます。
SecurityTypeMismatch	6	保存されているネットワークのセキュリティの種類が、使用可能なネットワークと一致しません。
NetworkFrequencyNotAllowed	7	ネットワーク周波数は許可されません。
NetworkNotEssPbssMbss	8	拡張サービスセット (ESS)、Personal Basic Service Set (PBSS)、または最小ベースラインセキュリティ標準 (MBSS) が検出されていないため、ネットワークはサポートされていません。
NetworkNotSupported	9	ネットワークはサポートされていません。
NetworkNonWpa	10	ネットワークが WPA2PSK、WPA2EAP、または Open ではありません。

time_tタイムスタンプ

エラーが記録された OS 時刻。

int32_t certError

証明書エラー。AuthenticationFailed を示す場合 error にのみ意味があります。注: エラーが certError 返されない場合があります。

使用可能な値:

   ERRID                          Potential Problem
   Unspecified = 0:               Generic error message when certificate validation fails.
   Certificate Not Found = 100:   This could be due to an incorrect certificate specified when configuring the EAP-TLS network, or ReloadConfig() was not called after loading   the certificates onto the device.
   Invalid Root CA= 101:          Root CA incorrect due to expiry, invalid chain, or other issues verifying the server certificate.
   Invalid client authentication  Invalid client certificate or using a valid client identity but incorrectly associated with client certificate.
   =102:

型	値	意味
ConnectionFailed	0	証明書の検証が失敗した場合の汎用エラーメッセージ。
証明書が見つかりません	100	EAP-TLS ネットワークを構成するときに指定された証明書が正しくないか `ReloadConfig()` 、デバイスに証明書を読み込んだ後に呼び出されませんでした。
無効なルート CA	101	有効期限切れ、無効なチェーン、またはサーバー証明書の検証に関するその他の問題が原因で、ルート CA が正しくありません。
無効なクライアント認証	102	1) サーバーによって認識されないクライアント証明書、またはエラーが含まれているクライアント証明書、または 2) クライアント証明書に正しく関連付けられていない有効なクライアント ID (たとえば、別のユーザーのパスワードを持つ既知のユーザー名)。
不明なクライアント ID	103	クライアント ID が認証サーバーによって認識されませんでした。

int32_t certDepth

証明書チェーン内の証明書の位置。 AuthenticationFailed を示し、certDepth非負 (0 または正) の数値である場合errorにのみ意味があります。

CertStore_SubjectName certSubject

証明書のサブジェクト。 AuthenticationFailed を示す場合 error にのみ意味があります。

次の方法で共有