# ksAdapter

**Repository Path**: lammork/ks-adapter

## Basic Information

- **Project Name**: ksAdapter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-22
- **Last Updated**: 2025-11-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UDP服务器程序

这是一个Python实现的UDP服务器程序，满足以下功能要求：

## 功能特性

1. ✅ 创建UDP服务器，监听端口7272
2. ✅ 当有客户端连接时，每秒发送8字节数据（数据每秒加1）
3. ✅ 实时监听客户端数据并以十六进制格式打印

## 文件说明

- `main.py` - UDP服务器主程序（包含完整的服务器实现）
- `requirements.txt` - 项目依赖文件

## 工程结构

```
ks-adapter/
├── main.py          # UDP服务器主程序
├── README.md        # 项目说明文档
└── requirements.txt # 项目依赖
```

## 快速开始

### 1. 启动UDP服务器

```bash
python3 main.py
```

服务器启动后，你将看到类似以下输出：
```
UDP服务器启动成功，监听端口: 7272
等待客户端连接...
```

### 2. 测试服务器功能

由于当前工程只包含服务器程序，你可以使用以下方法测试：

**方法一：使用netcat工具测试**
```bash
# 在一个终端启动服务器
python3 main.py

# 在另一个终端使用netcat发送测试数据
echo "测试数据" | nc -u 127.0.0.1 7272
```

**方法二：使用Python交互式环境测试**
```python
import socket
import time

# 创建UDP客户端
client_socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

# 发送测试数据
client_socket.sendto(b"Hello Server", ('127.0.0.1', 7272))

# 接收服务器响应
data, addr = client_socket.recvfrom(1024)
print(f"收到服务器数据: {data.hex()}")

client_socket.close()
```

### 3. 观察运行效果

**服务器端输出示例：**
```
UDP服务器启动成功，监听端口: 7272
等待客户端连接...
新客户端连接: ('127.0.0.1', 54321)
[2024-01-15 10:30:01] 发送数据到 ('127.0.0.1', 54321): 0000000000000001 (计数器: 1)
[2024-01-15 10:30:01] 来自 ('127.0.0.1', 54321) 的数据 (十六进制): e6b58be8af95e695b0e68dae2031
[2024-01-15 10:30:01] ASCII格式: 测试数据 1
[2024-01-15 10:30:02] 发送数据到 ('127.0.0.1', 54321): 0000000000000002 (计数器: 2)
```

**客户端输出示例：**
```
UDP客户端启动成功，连接服务器: 127.0.0.1:7272
[2024-01-15 10:30:01] 收到服务器数据: 0000000000000001 (计数器值: 1)
[2024-01-15 10:30:01] 发送测试数据: 测试数据 1
[2024-01-15 10:30:02] 收到服务器数据: 0000000000000002 (计数器值: 2)
```

## 技术细节

### 服务器功能

- **端口监听**: 在7272端口监听UDP连接
- **数据发送**: 每秒发送8字节数据，使用大端字节序的无符号长整型
- **数据接收**: 实时接收客户端数据并以十六进制格式显示
- **多线程**: 使用独立线程处理发送和接收，避免阻塞
- **客户端管理**: 自动跟踪连接的客户端地址

### 数据格式

**服务器发送的数据**:
- 8字节大端字节序的无符号长整型
- 每秒自动加1
- 示例: 计数器为1时发送 `0000000000000001`

**客户端发送的数据**:
- 可以是任意长度的数据
- 服务器会以十六进制格式显示

## 自定义使用

### 修改服务器配置

在 `main.py` 中修改：
```python
# 修改监听地址和端口
server = UDPServer(host='0.0.0.0', port=7272)
```

### 客户端配置说明

当前工程只包含服务器程序。如果需要客户端功能，可以参考前面提供的测试方法或自行实现客户端程序。

### 发送自定义数据

可以使用客户端程序的 `send_custom_data` 方法：
```python
client.send_custom_data("Hello Server")
client.send_custom_data(b'\x01\x02\x03\x04')  # 发送二进制数据
```

## 停止程序

使用 `Ctrl+C` 快捷键可以安全停止服务器或客户端程序。

## 依赖要求

- Python 3.6+
- 仅使用Python标准库，无需额外安装包

## 故障排除

1. **端口被占用**: 确保7272端口没有被其他程序使用
2. **防火墙阻止**: 检查防火墙设置，允许UDP通信
3. **权限问题**: 在Linux系统上可能需要sudo权限绑定端口

## 扩展建议

- 添加日志记录功能
- 实现数据持久化
- 添加配置文件支持
- 实现更复杂的协议处理