本文将介绍如何使用ESP32硬件制作一个开机棒,通过.Net nanoFramework实现WOL(Wake-on-LAN)功能,发送WOL数据包来唤醒远程计算机。
1. 背景
在之前的文章中,我们介绍了如何使用.Net nanoFramework相关的库来实现一些功能,比如读取传感器数据、控制LED灯、OLED显示等。也介绍了通过.NET实现WOL(Wake-on-LAN)功能,并在NAS或通过ASP.NET进行部署。可以能有的小伙伴没有NAS或者服务器,但是有ESP32硬件,那么我们可以使用ESP32硬件制作一个开机棒,通过发送WOL数据包来唤醒远程计算机。在这篇文章中,我们将介绍如何使用.Net nanoFramework实现WOL(Wake-on-LAN)功能,通过发送WOL数据包来唤醒远程计算机。
相关文章:
- 使用.NET实现WOL唤醒远程开机
- ASP.NET版本WOL服务的使用
- 在NAS上部署.NET版本的WOL远程开机服务
- 快速入门 .NET nanoFramework 开发 ESP32-Pico 应用
- 解决ESP32板载WS2812B LED反色问题及工作状态灯的应用
以上的文章包含了基本的WOL相关实现和介绍以及.Net nanoFramework基础开发知识,如果你对.Net nanoFramework不熟悉,建议先阅读这些文章,可以帮助你更好的读懂本文的内容。
2. 实现方法
在工作状态灯的应用文章中,我们介绍了一个 ProjectImprovWifi
的示例项目,这个示例包含了基本的工作状态灯控制,我们可以基于这个项目框架来快速实现WOL功能。
WOL的实现原理是通过网络发送一个特定的数据包(Magic Packet)到目标计算机的MAC地址,目标计算机就会被唤醒。在.Net nanoFramework中,我们可以使用 nanoFramework.System.Net.Sockets.UdpClient
库来实现UDP数据包的发送。
下面的代码示例演示了如何使用.Net nanoFramework实现WOL功能,这里需要注意的是,因为环境的限制,UdpClient
的使用,以及没有Replace
方法等问题,需要我们对之前.NET的代码进行一些修改:
csharp
using System;
using System.Net;
using System.Net.Sockets;
namespace WakeOnLan_ESP32
{
internal class WakeOnLan
{
internal static void Send(string macAddress)
{
byte[] magicPacket = CreateMagicPacket(macAddress);
SendMagicPacket(magicPacket);
}
static byte[] CreateMagicPacket(string macAddress)
{
byte[] macBytes = ParseMacAddress(macAddress);
byte[] magicPacket = new byte[6 + (6 * 16)];
for (int i = 0; i < 6; i++)
{
magicPacket[i] = 0xFF;
}
for (int i = 6; i < magicPacket.Length; i += 6)
{
Array.Copy(macBytes, 0, magicPacket, i, 6);
}
return magicPacket;
}
static byte[] ParseMacAddress(string macAddress)
{
if (macAddress.Length == 17)
{
macAddress = macAddress.Substring(0, 2) + macAddress.Substring(3, 2) + macAddress.Substring(6, 2) + macAddress.Substring(9, 2) + macAddress.Substring(12, 2) + macAddress.Substring(15, 2);
}
if (macAddress.Length != 12)
{
throw new ArgumentException("Invalid MAC address.");
}
byte[] macBytes = new byte[6];
for (int i = 0; i < 6; i++)
{
macBytes[i] = Convert.ToByte(macAddress.Substring(i * 2, 2), 16);
}
return macBytes;
}
static void SendMagicPacket(byte[] magicPacket)
{
UdpClient udpClient = new UdpClient();
udpClient.Connect(IPAddress.Broadcast, 9);
udpClient.Send(magicPacket);
udpClient.Close();
Console.WriteLine("Magic packet sent.");
}
}
}
在这个示例中,我们定义了一个 WakeOnLan
类,其中包含了 Send
方法,用于发送WOL数据包。在 Send
方法中,我们首先调用 CreateMagicPacket
方法创建一个Magic Packet,然后调用 SendMagicPacket
方法发送数据包。
3. 页面设计
完成了核心的唤醒代码后,我们需要让用户输入目标计算机的MAC地址,然后点击按钮发送WOL数据包。这里我们可以使用OLED显示屏来显示提示信息和用户输入的MAC地址。这里可以使用 ESP32 创建一个Web服务器,通过浏览器输入MAC地址,然后发送WOL数据包。
这里我们需要用到nanoFramework.System.Net.Http
库,这个库可以用来创建一个简单的Web服务器,接收用户的输入,然后发送WOL数据包。
csharp
string responseString =
"<HTML><HEAD>" +
"<meta name='viewport' content='width=device-width, initial-scale=1'>" +
"<style>" +
"body { font-family: Arial, sans-serif; margin: 20px;text-align: center;}" +
"h2 { color: #333; }" +
"form { margin-top: 20px; }" +
"input[type='text'] { padding: 10px; border: 1px solid #ccc; border-radius:4px 0 0 4px; width: 250px; }" +
"input[type='submit'] { padding: 10px 20px; border: none; border-radius:0 4px 4px 0; background-color: #4CAF50; color: white; cursor: pointer; }" +
"input[type='submit']:hover { background-color: #45a049; }" +
"p { line-height: 1.6; }" +
"a { color: #1E90FF; text-decoration: none; }" +
"a:hover { text-decoration: underline; }" +
"#mac-list { margin: 20px auto; background: white; padding: 20px; border-radius: 8px; box-shadow: 0 0 10px rgba(0, 0, 0, 0.1); width: 100%; max-width: 350px; }" +
"#mac-list ul { list-style-type: none; padding: 0; }" +
"#mac-list li { padding: 5px 0; border-bottom: 1px solid #ccc; }" +
"</style>" +
"</HEAD><BODY>" +
"<h2>ESP32 WakeOnLan</h2>" +
"<p>Click the button to send a Wake On LAN packet.</p>" +
"<form method='get' action='/wol' οnsubmit='return validateAndFormatMac()'>" +
"<input type='text' id='mac' name='mac' value='' />" +
"<input type='submit' value='Wake On LAN' />" +
"</form>" +
"<div id='mac-list'>" +
"<h3>Stored MAC Addresses</h3>" +
"<ul id='list'></ul>" +
"</div>" +
"<script>" +
"function validateAndFormatMac() {" +
" var macInput = document.getElementById('mac');" +
" var mac = macInput.value;" +
" var macRegex = /^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$/;" +
" if (!macRegex.test(mac)) {" +
" alert('Invalid MAC address format. Please use XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX.');" +
" return false;" +
" }" +
" mac = mac.replace(/[:-]/g, '');" +
" macInput.value = mac;" +
" storeMac(mac);" +
" return true;" +
"}" +
"function storeMac(mac) {" +
" var macs = JSON.parse(localStorage.getItem('macs')) || [];" +
" macs.push(mac);" +
" localStorage.setItem('macs', JSON.stringify(macs));" +
" displayMacs();" +
"}" +
"function displayMacs() {" +
" var macs = JSON.parse(localStorage.getItem('macs')) || [];" +
" var list = document.getElementById('list');" +
" list.innerHTML = '';" +
" macs.forEach(function(mac) {" +
" var li = document.createElement('li');" +
" var a = document.createElement('a'); " +
" a.href = '/wol?mac=' + mac;" +
" a.textContent = mac;" +
" li.appendChild(a);" +
" list.appendChild(li);" +
" });" +
"}" +
"document.addEventListener('DOMContentLoaded', displayMacs);" +
"</script>" +
"</BODY></HTML>";
byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
HttpListener listener = new("http", 80);
listener.Start();
这里的网页内容是硬编码在代码中的,我们可以通过 HttpListener
类来创建一个简单的Web服务器,然后监听用户的输入。用户输入的MAC地址会被存储在本地存储中,然后显示在页面的底部。用户可以点击列表中的MAC地址来发送WOL数据包。
启动服务后,我们简单的使用一个死循环来监听用户的请求,通过判断URL是否包含/wol?mac=
来发送WOL数据包,然后返回一个JSON格式的响应。
csharp
while (true)
{
try
{
HttpListenerContext context = listener.GetContext();
var url = context.Request.RawUrl;
HttpListenerResponse response = context.Response;
if (url.StartsWith("/wol?mac="))
{
var macAddress = url.Substring(9);
Console.WriteLine($"WOL packet sent to {macAddress}");
WakeOnLan.Send(macAddress);
// 输出json格式
response.ContentType = "application/json";
var json = System.Text.Encoding.UTF8.GetBytes("{\"status\":\"ok\"}");
response.ContentLength64 = json.Length;
response.OutputStream.Write(json, 0, json.Length);
}
else
{
// 输出默认页面
response.ContentLength64 = buffer.Length;
response.OutputStream.Write(buffer, 0, buffer.Length);
}
context.Response.Close();
Console.WriteLine("Web response sent");
context.Close();
}
catch (Exception ex)
{
Console.WriteLine("* Error getting context: " + ex.Message + "\r\nSack = " + ex.StackTrace);
}
}
4. 使用方法
在完成了代码的编写后,我们可以将代码部署到ESP32上。首次使用需要先完成 Improv 蓝牙配网,这里可以通过"Improv 蓝牙配网"微信小程序或者 Improv 官网来完成。建议是使用小程序,这样可以在配网成功后,可以直接显示ESP32的IP地址。
然后通过浏览器访问ESP32的IP地址,即可看到硬件的 Web 服务,可以在页面上输入MAC地址,然后点击按钮发送WOL数据包。
5. 总结
在这篇文章中,我们介绍了如何使用.Net nanoFramework实现WOL功能,通过发送WOL数据包来唤醒远程计算机。我们首先实现了核心的WOL代码,然后通过Web服务器来接收用户的输入,最后发送WOL数据包。这样可以方便我们通过浏览器来发送WOL数据包,实现远程开机的功能。
文章介绍的相关代码已开源在GitHub,欢迎查看和收藏。希望这篇文章对你有所帮助,如果有任何问题或建议,欢迎在评论区留言。
如果你对ESP32版本的WOL感兴趣,可以关注"桑榆肖物",回复"网络唤醒"获取完整源码。
Github 主页:https://github.com/sangyuxiaowu?WT.mc_id=DT-MVP-5005195