nanoFramework.System.Device.Wifi 1.5.91

文档语言：英语 | 简体中文

欢迎使用 .NET nanoFramework System.Device.Wifi 库代码库

此代码库包含 nanoFramework System.Device.Wifi 类库。

构建状态

组件	构建状态	NuGet软件包
System.Device.Wifi

WifiNetworkHelper 使用

WifiNetworkHelper主要用于帮助您自动连接到Wi-Fi网络。换句话说，它还可以用来检查您是否拥有有效的IP地址和日期，包括在以太网上。

首选使用

以下代码可使您自动连接，等待具有特定凭据的有效IP地址和日期

const string Ssid = "YourSSID";
const string Password = "YourWifiPassword";
// Give 60 seconds to the wifi join to happen
CancellationTokenSource cs = new(60000);
var success = WifiNetworkHelper.ConnectDhcp(Ssid, Password, requiresDateTime: true, token: cs.Token);
if (!success)
{
    // Something went wrong, you can get details with the ConnectionError property:
    Debug.WriteLine($"Can't connect to the network, error: {WifiNetworkHelper.Status}");
    if (WifiNetworkHelper.HelperException != null)
    {
        Debug.WriteLine($"ex: {WifiNetworkHelper.HelperException}");
    }
}
// Otherwise, you are connected and have a valid IP and date

请注意，此函数将在设备上存储网络凭据。

使用存储的凭证

您还可以根据您的设备类型连接到设备上预先存储的凭据的网络。请检查您的设备是否恰当地支持此功能。

// The wifi credentials are already stored on the device
 // Give 60 seconds to the wifi join to happen
CancellationTokenSource cs = new(60000);
var success = WifiNetworkHelper.Reconnect(requiresDateTime: true, token: cs.Token);
if (!success)
{
    // Something went wrong, you can get details with the ConnectionError property:
    Debug.WriteLine($"Can't connect to the network, error: {WifiNetworkHelper.Status}");
    if (WifiNetworkHelper.HelperException != null)
    {
        Debug.WriteLine($"ex: {WifiNetworkHelper.HelperException}");
    }
}
// Otherwise, you are connected and have a valid IP and date

扫描和加入

您可以通过强制扫描网络然后加入网络。在某些特定条件下，这种情况可能会有所帮助。请注意，您可能需要使用此方法并结合以前的某种方法，具体取决于在已连接的情况下是否支持重新扫描。

const string Ssid = "YourSSID";
const string Password = "YourWifiPassword";
// Give 60 seconds to the wifi join to happen
CancellationTokenSource cs = new(60000);
var success = WifiNetworkHelper.ScanAndConnectDhcp(Ssid, Password, requiresDateTime: true, token: cs.Token);
if (!success)
{
    // Something went wrong, you can get details with the ConnectionError property:
    Debug.WriteLine($"Can't connect to the network, error: {WifiNetworkHelper.Status}");
    if (WifiNetworkHelper.HelperException != null)
    {
        Debug.WriteLine($"ex: {WifiNetworkHelper.HelperException}");
    }
}
// Otherwise, you are connected and have a valid IP and date

请注意，此函数将在设备上存储网络凭据。

使用静态IP地址连接

使用静态IP地址连接WiFi网络

const string Ssid = "YourSSID";
const string Password = "YourWifiPassword";
// Give 60 seconds to the wifi join to happen
CancellationTokenSource cs = new(60000);
var success = WifiNetworkHelper.ConnectFixAddress(Ssid, Password, new IPConfiguration("192.168.1.7", "255.255.255.0", "192.168.1.1"), requiresDateTime: true, token: cs.Token);

检查有效的IP地址和日期

WifiNetworkHelper提供了几个函数来检查您的IP地址、日期时间的有效性以及帮助设置它们

var success = IsValidDateTime();
// if success is true, you have a valid DateTime
success = IsValidIpAddress(NetworkInterfaceType.Wireless80211);
// if success is true, you have a valid IP address on the Wireless adapter
// Be aware that a local address like 127.0.0.1 is considered as a valid address for ethernet

您也可以等待有效的IP地址和日期时间

// Give 60 seconds to check if we have a valid IP and a valid DateTime
CancellationTokenSource cs = new(60000);
var success = WaitForValidIPAndDate(true, NetworkInterfaceType.Ethernet, cs.Token);
// if success is true then you are connected

反馈和文档

有关文档、提供反馈、问题以及了解如何贡献的信息，请参考主仓库。

加入我们的Discord社区这里。

致谢

此项目的贡献者名单可在CONTRIBUTORS找到。

许可协议

nanoFramework类库采用MIT许可协议。

行为准则

本项目采用贡献者协议定义的行为准则，以明确我们社区中期望的行为。更多信息请参阅.NET Foundation行为准则。

.NET Foundation

本项目由.NET Foundation支持。