HUST_Wireless_login_by_socket 项目使用教程

HUST_Wireless_login_by_socket 项目使用教程

1. 项目介绍

HUST_Wireless_login_by_socket 是一个用于华中科技大学（HUST）校园网认证的开源项目。该项目通过使用Socket模拟浏览器进行校园网认证，使得ESP32等设备也能联网。项目支持C、C#和Python语言，提供了登录和登出功能。

主要功能：

• 使用Socket模拟浏览器进行校园网认证。
• 支持ESP32等设备的联网。
• 提供C、C#和Python版本的实现。
• 支持登录和登出功能。

2. 项目快速启动

2.1 环境准备

• Python 3.x
• Git

2.2 克隆项目

git clone https://github.com/HuXioAn/HUST_Wireless_login_by_socket.git
cd HUST_Wireless_login_by_socket

2.3 安装依赖

pip install -r requirements.txt

2.4 运行示例代码

以下是一个简单的Python示例代码，用于登录校园网：

import socket
import json

def login(username, password):
    login_data = {
        "username": username,
        "password": password
    }
    login_json = json.dumps(login_data)
    
    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    s.connect(("login.hust.edu.cn", 80))
    s.sendall(login_json.encode())
    response = s.recv(1024)
    s.close()
    
    print(response.decode())

if __name__ == "__main__":
    username = "your_username"
    password = "your_password"
    login(username, password)

2.5 运行C#版本

如果你选择使用C#版本，可以参考以下步骤：

1. 打开C#项目文件。
2. 编译并运行项目。
3. 使用命令行参数进行登录和登出操作。

dotnet run -- -u your_username -p your_password

3. 应用案例和最佳实践

3.1 在ESP32上使用

该项目特别适用于需要在ESP32等嵌入式设备上进行校园网认证的场景。通过将代码移植到ESP32的MicroPython环境中，可以实现设备的自动联网。

3.2 自动化脚本

你可以将该项目集成到自动化脚本中，实现定时登录和登出，确保设备始终在线。

4. 典型生态项目

4.1 ESP32开发板

ESP32是一款低成本、低功耗的Wi-Fi和蓝牙双模芯片，广泛应用于物联网设备。该项目与ESP32结合，可以实现设备的自动联网功能。

4.2 MicroPython

MicroPython是Python 3的一个精简版本，专为嵌入式设备设计。通过在ESP32上运行MicroPython，可以轻松实现校园网认证功能。

4.3 其他校园网认证项目

如果你需要更多的校园网认证解决方案，可以参考其他开源项目，如CampusNetLogin等。

通过以上步骤，你可以快速上手并使用HUST_Wireless_login_by_socket项目，实现校园网认证功能。