From c4a347b28704169d417bdc120241d7a3eb41df40 Mon Sep 17 00:00:00 2001 From: "WIN-20230613SRA\\Administrator" <871066422@qq.com> Date: Thu, 2 Jul 2026 16:07:26 +0800 Subject: [PATCH] first commit --- .gitignore | 16 ++ API_DOCUMENTATION.md | 328 ++++++++++++++++++++++++++ InStructTemplate.mat | Bin 0 -> 69521 bytes README_DEPLOY.md | 229 ++++++++++++++++++ __init__.py | 0 build.bat | 76 ++++++ build.ps1 | 97 ++++++++ compute_service.py | 542 +++++++++++++++++++++++++++++++++++++++++++ config.py | 165 +++++++++++++ config_template.json | 31 +++ cpy_server.py | 277 ++++++++++++++++++++++ file_handler.py | 364 +++++++++++++++++++++++++++++ main.py | 85 +++++++ mqtt_client.py | 341 +++++++++++++++++++++++++++ requirements.txt | Bin 0 -> 544 bytes udp_handler.py | 341 +++++++++++++++++++++++++++ version.py | 32 +++ 17 files changed, 2924 insertions(+) create mode 100644 .gitignore create mode 100644 API_DOCUMENTATION.md create mode 100644 InStructTemplate.mat create mode 100644 README_DEPLOY.md create mode 100644 __init__.py create mode 100644 build.bat create mode 100644 build.ps1 create mode 100644 compute_service.py create mode 100644 config.py create mode 100644 config_template.json create mode 100644 cpy_server.py create mode 100644 file_handler.py create mode 100644 main.py create mode 100644 mqtt_client.py create mode 100644 requirements.txt create mode 100644 udp_handler.py create mode 100644 version.py diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..84b2419 --- /dev/null +++ b/.gitignore @@ -0,0 +1,16 @@ +# Ignore files +**/.DS_Store +**/__pycache__ +/.idea +/logFile +/logFile/* +/dataFile +/dataFile/* +/build +/dist +/env +/venv +/datas +*.db +*.log +.vscode \ No newline at end of file diff --git a/API_DOCUMENTATION.md b/API_DOCUMENTATION.md new file mode 100644 index 0000000..21688fb --- /dev/null +++ b/API_DOCUMENTATION.md @@ -0,0 +1,328 @@ +# Python Gateway HTTP API 接口文档 + +## 概述 + +Python Gateway HTTP Server 提供RESTful API接口,用于文件上传、计算处理、设备管理和状态查询。 + +**服务器地址**: `http://:` +**默认端口**: `5000` +**当前版本**: `1.0.0` (在version.py中管理) +**Content-Type**: `application/json` 或 `multipart/form-data` + +--- + +## API 接口列表 + +### 1. 上传数据并计算 + +**接口地址**: `/api/data` +**请求方法**: `POST` +**Content-Type**: `multipart/form-data` + +#### 请求参数 + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| file | File | 是 | 要上传的文件(CSV格式) | +| dev_id | String | 否 | 设备ID,默认为'default' | +| init | Integer | 否 | 初始化标志(0或1),默认为0 | +| device_name | String | 否 | 设备名称,用于设置文件根目录 | +| file_type | String | 否 | 文件类型,默认为'raw' | +| compress | String | 否 | 压缩类型('none'或'gz'),默认为'none' | +| scale | Float | 否 | 数据缩放因子,默认为1.0 | +| offset | Float | 否 | 数据偏移量,默认为0.0 | +| row_count | Integer | 否 | 行数限制,默认为0(不限制) | + +#### 请求示例 + +```bash +curl -X POST http://localhost:5000/api/data \ + -F "file=@data.csv" \ + -F "dev_id=device1" \ + -F "init=0" \ + -F "device_name=TGX-08-0005" +``` + +#### 响应格式 + +成功响应(200 OK): +```json +{ + "WtOSC": [1.234, 2.345, 3.456, 4.567, 5.678, 6.789, 7.890, 8.901], + "WtINS": [2.345, 3.456, 4.567, 5.678, 6.789, 7.890, 8.901, 9.012], + "WtISC": [3.456, 4.567, 5.678, 6.789, 7.890, 8.901, 9.012, 10.123], + "WtALL": [4.567, 5.678, 6.789, 7.890, 8.901, 9.012, 10.123, 11.234], + "AngOSC": [95.5, 185.3, 275.1], + "AngINS": [105.2, 195.0, 284.8], + "AngISC": [115.1, 204.9, 294.7], + "AngALL": [125.0, 214.8, 304.6], + "DmCORE": [100.5, 101.2, 102.3], + "DmALL": [120.5, 121.2, 122.3], + "EccentricityINS": 2.5, + "EccentricityOSC": 3.2, + "EccentricityISC": 1.8, + "Volatility": [0.05, 0.08, 0.12], + "EdgesA": [10.5, 20.3, 30.1, 40.9, 50.7, 60.5, 70.3, 80.1], + "EdgesB": [15.5, 25.3, 35.1, 45.9, 55.7, 65.5, 75.3, 85.1] +} +``` + +错误响应(400 Bad Request): +```json +{ + "error": "No file provided" +} +``` + +或 + +```json +{ + "error": "Failed to process file" +} +``` + +或 + +```json +{ + "error": "ComputeService not initialized for dev_id device1" +} +``` + +#### 响应字段说明 + +| 字段名 | 类型 | 说明 | +|--------|------|------| +| WtOSC | Array[Float] | 外屏层壁厚(8个测量点) | +| WtINS | Array[Float] | 绝缘层壁厚(8个测量点) | +| WtISC | Array[Float] | 内屏层壁厚(8个测量点) | +| WtALL | Array[Float] | 总壁厚(8个测量点) | +| AngOSC | Array[Float] | 外屏层角度(3个角度值) | +| AngINS | Array[Float] | 绝缘层角度(3个角度值) | +| AngISC | Array[Float] | 内屏层角度(3个角度值) | +| AngALL | Array[Float] | 总壁厚角度(3个角度值) | +| DmCORE | Array[Float] | 核心直径(3个测量值) | +| DmALL | Array[Float] | 总直径(3个测量值) | +| EccentricityINS | Float | 绝缘层偏心率(百分比) | +| EccentricityOSC | Float | 外屏层偏心率(百分比) | +| EccentricityISC | Float | 内屏层偏心率(百分比) | +| Volatility | Array[Float] | 波动性[设备1标准差, 设备2标准差, 总体标准差] | +| EdgesA | Array[Float] | A边边缘位置(8个点) | +| EdgesB | Array[Float] | B边边缘位置(8个点) | + +--- + +### 2. 获取服务器状态 + +**接口地址**: `/api/status` +**请求方法**: `GET` + +#### 请求参数 + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| dev_id | String | 否 | 设备ID,如果不提供则返回服务器基本状态 | + +#### 请求示例 + +示例1:获取服务器基本状态 +```bash +curl -X GET http://localhost:5000/api/status +``` + +示例2:获取特定设备状态 +```bash +curl -X GET "http://localhost:5000/api/status?dev_id=device1" +``` + +#### 响应格式 + +成功响应 - 基本状态(200 OK): +```json +{ + "running": "true", + "mqtt_connected": true, + "version": "1.0.0" +} +``` + +或 + +```json +{ + "running": "false", + "mqtt_connected": false, + "version": "1.0.0" +} +``` + +成功响应 - 设备状态(200 OK): +```json +{ + "running": true, + "mqtt_connected": true, + "compute_status": true, + "version": "1.0.0" +} +``` + +或 + +```json +{ + "running": true, + "mqtt_connected": true, + "compute_status": false, + "version": "1.0.0" +} +``` + +#### 响应字段说明 + +| 字段名 | 类型 | 说明 | +|--------|------|------| +| running | String/Boolean | 服务器运行状态(不带dev_id时为字符串"true"/"false",带dev_id时为布尔值) | +| mqtt_connected | Boolean | MQTT连接状态 | +| compute_status | Boolean | 计算服务可用状态(仅当提供dev_id时返回) | +| version | String | 软件版本号 | + +--- + +### 3. 注册设备 + +**接口地址**: `/api/register` +**请求方法**: `POST` +**Content-Type**: `application/json` + +#### 请求参数 + +| 参数名 | 类型 | 必填 | 说明 | +|--------|------|------|------| +| dev_id | String | 是 | 设备ID | + +#### 请求示例 + +```bash +curl -X POST http://localhost:5000/api/register \ + -H "Content-Type: application/json" \ + -d '{"dev_id": "device1"}' +``` + +#### 响应格式 + +成功响应(200 OK): +```json +{ + "message": "Device registered successfully" +} +``` + +错误响应(400 Bad Request): +```json +{ + "error": "dev_id is required" +} +``` + +或 + +```json +{ + "error": "Failed to initialize ComputeService: ..." +} +``` + +--- + +## 错误码说明 + +| HTTP状态码 | 说明 | +|-----------|------| +| 200 | 请求成功 | +| 400 | 请求参数错误 | +| 500 | 服务器内部错误 | + +--- + +## 使用场景示例 + +### 场景1:首次上传数据并计算 + +```bash +# 上传CSV文件并计算 +curl -X POST http://localhost:5000/api/data \ + -F "file=@measurement_data.csv" \ + -F "dev_id=device1" \ + -F "init=1" \ + -F "device_name=TGX-08-0005" +``` + +### 场景2:连续上传数据 + +```bash +# 后续上传,init=0 +curl -X POST http://localhost:5000/api/data \ + -F "file=@measurement_data_002.csv" \ + -F "dev_id=device1" \ + -F "init=0" +``` + +### 场景3:检查服务器状态 + +```bash +# 查询服务器状态 +curl -X GET http://localhost:5000/api/status +``` + +### 场景4:注册新设备 + +```bash +# 注册新设备 +curl -X POST http://localhost:5000/api/register \ + -H "Content-Type: application/json" \ + -d '{"dev_id": "device2"}' +``` + +--- + +## 注意事项 + +1. **文件格式**: 上传的文件应为CSV格式,包含CH1和CH2两列数据 +2. **设备ID**: 每个设备需要先通过`/api/register`接口注册,才能进行计算 +3. **初始化**: 首次上传数据时建议设置`init=1`,后续上传设置`init=0` +4. **文件大小**: 建议单次上传文件不超过10MB +5. **并发处理**: 服务器支持多线程并发处理请求 +6. **MQTT发布**: 计算结果会自动发布到MQTT主题(如果MQTT已启用) + +--- + +## 配置说明 + +服务器配置存储在`config.json`文件中,主要配置项: + +```json +{ + "http": { + "host": "0.0.0.0", + "port": 5000 + }, + "mqtt": { + "enable": true, + "broker": "123.57.81.127", + "port": 1883, + "username": "test", + "password": "test" + }, + "file_root": "D:\\CPY_DTAT", + "template_path": "D:\\Python\\CPY_Server\\InStructTemplate.mat" +} +``` + +--- + +## 版本历史 + +| 版本 | 日期 | 说明 | +|------|------|------| +| 1.0.0 | 2026-01-05 | 初始版本,支持数据上传、计算和设备管理 | diff --git a/InStructTemplate.mat b/InStructTemplate.mat new file mode 100644 index 0000000000000000000000000000000000000000..df880ecab8db94ec8b38fb4eedf687816476c9cc GIT binary patch literal 69521 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
)9T0z6*T16A=LP0`_pryo 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 d`zWJpv5OFVB7N4b@{ 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 属性 -> 安全,添加用户权限。 + +### 4. MATLAB相关错误 + +如果程序需要与MATLAB网关通信: +- 确保MATLAB网关程序正在运行 +- 确保UDP端口配置正确 +- 检查防火墙是否阻止了UDP通信 + +### 5. MQTT连接失败 + +检查 `config.json` 中的MQTT配置: +- 确认broker地址正确 +- 确认端口正确(默认1883) +- 确认用户名和密码正确 +- 确认网络可以访问MQTT服务器 + +## 日志查看 + +程序运行日志保存在 `cpy_server.log` 文件中,位于exe文件同级目录。 + +如果遇到问题,请查看日志文件获取详细错误信息。 + +## 卸载 + +要卸载程序: + +1. 停止程序(如果正在运行) +2. 删除程序文件夹 +3. 删除数据目录(如果需要) + +## 更新 + +要更新程序: + +1. 停止旧版本程序 +2. 备份 `config.json` 文件 +3. 用新版本的 `CpyGateway.exe` 替换旧版本 +4. 恢复 `config.json` 文件 +5. 启动新版本程序 + +## 性能优化建议 + +1. **关闭控制台窗口**:如果不需要看到控制台输出,可以修改 `CpyGateway.spec` 文件: + ```python + console=False, # 改为False + ``` + 然后重新打包。 + +2. **启用UPX压缩**:spec文件中已启用UPX压缩,可以减小exe文件大小。 + +3. **日志级别调整**:在生产环境中,可以将日志级别改为 `WARNING` 或 `ERROR`: + ```json + "logging": { + "level": "WARNING", + "file": "cpy_server.log" + } + ``` + +## 技术支持 + +如遇到问题,请: +1. 查看日志文件 `cpy_server.log` +2. 检查配置文件 `config.json` +3. 参考API文档 `API_DOCUMENTATION.md` +4. 联系技术支持 + +## 版本信息 + +- 版本:1.0.0 +- 打包日期:2026-01-05 +- Python版本:3.11 diff --git a/__init__.py b/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/build.bat b/build.bat new file mode 100644 index 0000000..ee2c70a --- /dev/null +++ b/build.bat @@ -0,0 +1,76 @@ +@echo off +chcp 65001 >nul +echo ======================================== +echo CpyGateway 打包脚本 +echo ======================================== +echo. + +REM 检查Python环境 +python --version >nul 2>&1 +if errorlevel 1 ( + echo [错误] 未找到Python,请先安装Python + pause + exit /b 1 +) + +echo [1/5] 检查Python环境... +python --version +echo. + +REM 检查pip +pip --version >nul 2>&1 +if errorlevel 1 ( + echo [错误] 未找到pip + pause + exit /b 1 +) + +echo [2/5] 安装/更新PyInstaller... +pip install --upgrade pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple +if errorlevel 1 ( + echo [错误] PyInstaller安装失败 + pause + exit /b 1 +) +echo. + +echo [3/5] 安装项目依赖... +pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple +if errorlevel 1 ( + echo [错误] 依赖安装失败 + pause + exit /b 1 +) +echo. + +echo [4/5] 清理旧的构建文件... +if exist "build" rmdir /s /q "build" +if exist "dist" rmdir /s /q "dist" +echo 清理完成 +echo. + +echo [5/5] 开始打包... +pyinstaller CpyGateway.spec +if errorlevel 1 ( + echo [错误] 打包失败 + pause + exit /b 1 +) +echo. + +REM 获取版本号 +for /f "delims=" %%i in ('python -c "from version import get_version; print(get_version())"') do set VERSION=%%i + +echo ======================================== +echo 打包完成! +echo ======================================== +echo. +echo 可执行文件位置: dist\CpyGateway_v%VERSION%.exe +echo. +echo 部署说明: +echo 1. 将 dist 文件夹复制到目标电脑 +echo 2. 确保目标电脑已安装MATLAB Runtime (如果需要) +echo 3. 根据需要修改 config.json 配置文件 +echo 4. 双击运行 CpyGateway_v%VERSION%.exe +echo. +pause diff --git a/build.ps1 b/build.ps1 new file mode 100644 index 0000000..e93650a --- /dev/null +++ b/build.ps1 @@ -0,0 +1,97 @@ +# CpyGateway PowerShell Build Script + +$ErrorActionPreference = "Stop" + +Write-Host "========================================" -ForegroundColor Cyan +Write-Host "CpyGateway Build Script" -ForegroundColor Cyan +Write-Host "========================================" -ForegroundColor Cyan +Write-Host "" + +# Check Python +Write-Host "[1/6] Checking Python..." -ForegroundColor Yellow +try { + $pythonVersion = python --version 2>&1 + Write-Host "Python version: $pythonVersion" -ForegroundColor Green +} catch { + Write-Host "[ERROR] Python not found. Please install Python first." -ForegroundColor Red + Read-Host "Press Enter to exit" + exit 1 +} +Write-Host "" + +# Check pip +Write-Host "[2/6] Checking pip..." -ForegroundColor Yellow +try { + $pipVersion = pip --version 2>&1 + Write-Host "pip version: $pipVersion" -ForegroundColor Green +} catch { + Write-Host "[ERROR] pip not found" -ForegroundColor Red + Read-Host "Press Enter to exit" + exit 1 +} +Write-Host "" + +# Install/Update PyInstaller +Write-Host "[3/6] Installing/Updating PyInstaller..." -ForegroundColor Yellow +try { + pip install --upgrade pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple + Write-Host "PyInstaller installed/updated successfully" -ForegroundColor Green +} catch { + Write-Host "[ERROR] Failed to install PyInstaller" -ForegroundColor Red + Read-Host "Press Enter to exit" + exit 1 +} +Write-Host "" + +# Install dependencies +Write-Host "[4/6] Installing dependencies..." -ForegroundColor Yellow +try { + pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple + Write-Host "Dependencies installed successfully" -ForegroundColor Green +} catch { + Write-Host "[ERROR] Failed to install dependencies" -ForegroundColor Red + Read-Host "Press Enter to exit" + exit 1 +} +Write-Host "" + +# Clean old build files +Write-Host "[5/6] Cleaning old build files..." -ForegroundColor Yellow +if (Test-Path "build") { + Remove-Item -Path "build" -Recurse -Force + Write-Host "Removed build directory" -ForegroundColor Gray +} +if (Test-Path "dist") { + Remove-Item -Path "dist" -Recurse -Force + Write-Host "Removed dist directory" -ForegroundColor Gray +} +Write-Host "Cleanup completed" -ForegroundColor Green +Write-Host "" + +# Build +Write-Host "[6/6] Building..." -ForegroundColor Yellow +try { + # 读取版本号 + $version = python -c "from version import get_version; print(get_version())" + pyinstaller CpyGateway.spec + Write-Host "Build successful" -ForegroundColor Green +} catch { + Write-Host "[ERROR] Build failed" -ForegroundColor Red + Read-Host "Press Enter to exit" + exit 1 +} +Write-Host "" + +Write-Host "========================================" -ForegroundColor Cyan +Write-Host "Build completed!" -ForegroundColor Green +Write-Host "========================================" -ForegroundColor Cyan +Write-Host "" +Write-Host "Executable location: dist\CpyGateway_v$version.exe" -ForegroundColor White +Write-Host "" +Write-Host "Deployment instructions:" -ForegroundColor Yellow +Write-Host "1. Copy dist folder to target computer" -ForegroundColor White +Write-Host "2. Ensure MATLAB Runtime is installed (if needed)" -ForegroundColor White +Write-Host "3. Modify config.json as needed" -ForegroundColor White +Write-Host "4. Double-click CpyGateway_v$version.exe to run" -ForegroundColor White +Write-Host "" +Read-Host "Press Enter to exit" diff --git a/compute_service.py b/compute_service.py new file mode 100644 index 0000000..ecfcb60 --- /dev/null +++ b/compute_service.py @@ -0,0 +1,542 @@ +import os +import json +import logging +from unittest import result +import pandas as pd +import numpy as np +from scipy.io import savemat, loadmat +from typing import Dict, Any, Optional, Tuple +from datetime import datetime + +from werkzeug.wrappers import response + +from udp_handler import UdpHandler + +from config import config_manager + +logger = logging.getLogger(__name__) + +class CustomFloatEncoder(json.JSONEncoder): + """自定义浮点数编码器""" + + def encode(self, o): + if isinstance(o, float): + return format(o, '.3f') + if isinstance(o, dict): + return "{" + ", ".join(f"{json.dumps(k)}: {self.encode(v)}" for k, v in o.items()) + "}" + if isinstance(o, list): + return "[" + ", ".join(self.encode(v) for v in o) + "]" + return super().encode(o) + +class ComputeService: + """计算服务""" + + def __init__(self, dev_id: str): + """初始化计算服务 + + Args: + udp_handler: UDP处理器实例 + template_path: MAT模板文件路径 + """ + + self.template_path = config_manager.get('template_path', + r'D:\Python\CPY_Server\InStructTemplate.mat') + + port = config_manager.get('udp_map', {}).get(dev_id, None) + if port is None: + logger.error(f"UDP port not found for dev_id: {dev_id}") + port = 15000 + + self.udp_handler = UdpHandler(port, + config_manager.get('udp.host', '127.0.0.1')) + + if not self.udp_handler.search_for_available_udp_port(): + logger.error("ComputeService is not available") + self.available = False + raise Exception("ComputeService is not available") + + self.available = True + + self.dev_id = dev_id + + # 数据缓冲区 + self.dm_buffer = { + 'X': [], + 'Y': [], + 'X_std': 0, + 'Y_std': 0, + 'dev1': [], + 'dev2': [], + 'dev1_std': 0, + 'dev2_std': 0, + 'all_std': 0 + } + + # 服务状态 + self.available = False + + # 统计信息 + self.cal_count = 0 + self.last_result = None + + logger.info(f"ComputeService initialized with template: {self.template_path}") + + + + def reset_buffer(self): + """重置数据缓冲区""" + self.dm_buffer = { + 'X': [], + 'Y': [], + 'X_std': 0, + 'Y_std': 0, + 'dev1': [], + 'dev2': [], + 'dev1_std': 0, + 'dev2_std': 0, + 'all_std': 0 + } + logger.info("Data buffer reset") + + def csv_to_mat(self, csv_path: str, init: int = 0) -> Optional[str]: + """将CSV文件转换为MAT文件 + + Args: + csv_path: CSV文件路径 + init: 是否初始化(1表示初始化) + + Returns: + str: MAT文件路径,失败返回None + """ + try: + # 读取CSV文件 + df = pd.read_csv(csv_path, nrows=8000) + + # 取CH1和CH2两列的数据 + df = df[['CH1', 'CH2']] + + # 交换CH1和CH2 + df = df[['CH2', 'CH1']] + + # 检查df['CH1']每一行,如果有小于0的,就置为0 + df['CH1'] = df['CH1'].apply(lambda x: x if x > 0 else 0) + + # 检查df['CH2']每一行,如果有小于0的,就置为0 + df['CH2'] = df['CH2'].apply(lambda x: x if x > 0 else 0) + + # 判断最大值,如果最大值大于100000,则除以5,小于10000,则乘以5 + max_val = df['CH1'].max() + if max_val > 100000: + df['CH1'] = df['CH1'].divide(5) + df['CH2'] = df['CH2'].divide(5) + elif max_val > 60000: + df['CH1'] = df['CH1'].divide(3) + df['CH2'] = df['CH2'].divide(3) + elif max_val < 10000: + df['CH1'] = df['CH1'].multiply(3) + df['CH2'] = df['CH2'].multiply(3) + + # 舍弃小数位,只保留整数 + df = df.astype(int) + + # 如果是direction_1,逆序 + if 'direction_1' in csv_path or 'UP' in csv_path: + df = df.iloc[::-1] + + # 读取模板MAT文件 + mat_data = loadmat(self.template_path) + + # 替换InStruct.iIntensX和InStruct.iIntensY的值 + mat_data['InStruct']['iIntensX'][0, 0] = df['CH1'].values.astype(np.uint16) + mat_data['InStruct']['iIntensY'][0, 0] = df['CH2'].values.astype(np.uint16) + + # 设置设备类型 + if 'device1' in csv_path or 'Scanner1' in csv_path : + mat_data['InStruct']['Settings'][0, 0][0, 0] = 5 + elif 'device2' in csv_path or 'Scanner2' in csv_path: + mat_data['InStruct']['Settings'][0, 0][0, 0] = 4 + + # 设置其他参数 + mat_data['InStruct']['Settings'][0, 0][0, 2] = 1.1 + mat_data['InStruct']['Settings'][0, 0][0, 3] = 10.5 + mat_data['InStruct']['Settings'][0, 0][0, 4] = 1.1 + mat_data['InStruct']['Settings'][0, 0][0, 5] = 46 + mat_data['InStruct']['Settings'][0, 0][0, 6] = 20.5 + + # 设置初始化标志 + if init: + mat_data['InStruct']['Settings'][0, 0][0, 9] = 1 + else: + mat_data['InStruct']['Settings'][0, 0][0, 9] = 0 + + # 删除不需要的字段 + try: + del mat_data['OutStruct'] + del mat_data['MatlabGateway_TimeStamp'] + del mat_data['mem'] + del mat_data['__globals__'] + except: + pass + + # 生成输出文件名 + mat_path = csv_path.replace('.csv', '_in.mat') + + # 保存MAT文件 + savemat(mat_path, mat_data, appendmat=False) + logger.info(f"Converted CSV to MAT: {csv_path} -> {mat_path}") + + return mat_path + + except Exception as e: + logger.error(f"Failed to convert CSV to MAT: {e}") + return None + + def _update_buffer(self, result_data: Dict[str, Any], out_path: str): + """更新数据缓冲区 + + Args: + result_data: 结果数据 + out_path: 输出文件路径 + """ + try: + XEdgeLeft = result_data['XEdgeLeft'] + XEdgeRight = result_data['XEdgeRight'] + YEdgeLeft = result_data['YEdgeLeft'] + YEdgeRight = result_data['YEdgeRight'] + + # 更新X缓冲区 + if XEdgeRight[0] > 0.1 and XEdgeLeft[0] > 0.1: + XEdgeDist = XEdgeRight[0] - XEdgeLeft[0] + self.dm_buffer['X'].append(XEdgeDist) + if len(self.dm_buffer['X']) > 10: + self.dm_buffer['X'].pop(0) + self.dm_buffer['X_std'] = np.std(self.dm_buffer['X']) + + # 更新Y缓冲区 + if YEdgeRight[0] > 0.1 and YEdgeLeft[0] > 0.1: + YEdgeDist = YEdgeRight[0] - YEdgeLeft[0] + self.dm_buffer['Y'].append(YEdgeDist) + if len(self.dm_buffer['Y']) > 10: + self.dm_buffer['Y'].pop(0) + self.dm_buffer['Y_std'] = np.std(self.dm_buffer['Y']) + + # 更新设备1缓冲区 + if 'device1' in out_path or 'Scanner1' in out_path: + if XEdgeRight[0] > 0.1 and XEdgeLeft[0] > 0.1: + XEdgeDist = XEdgeRight[0] - XEdgeLeft[0] + self.dm_buffer['dev1'].append(XEdgeDist) + if len(self.dm_buffer['dev1']) > 10: + self.dm_buffer['dev1'].pop(0) + self.dm_buffer['dev1_std'] = np.std(self.dm_buffer['dev1']) + if YEdgeRight[0] > 0.1 and YEdgeLeft[0] > 0.1: + YEdgeDist = YEdgeRight[0] - YEdgeLeft[0] + self.dm_buffer['dev1'].append(YEdgeDist) + if len(self.dm_buffer['dev1']) > 10: + self.dm_buffer['dev1'].pop(0) + self.dm_buffer['dev1_std'] = np.std(self.dm_buffer['dev1']) + + # 更新设备2缓冲区 + elif 'device2' in out_path or 'Scanner2' in out_path: + if XEdgeRight[0] > 0.1 and XEdgeLeft[0] > 0.1: + XEdgeDist = XEdgeRight[0] - XEdgeLeft[0] + self.dm_buffer['dev2'].append(XEdgeDist) + if len(self.dm_buffer['dev2']) > 10: + self.dm_buffer['dev2'].pop(0) + self.dm_buffer['dev2_std'] = np.std(self.dm_buffer['dev2']) + if YEdgeRight[0] > 0.1 and YEdgeLeft[0] > 0.1: + YEdgeDist = YEdgeRight[0] - YEdgeLeft[0] + self.dm_buffer['dev2'].append(YEdgeDist) + if len(self.dm_buffer['dev2']) > 10: + self.dm_buffer['dev2'].pop(0) + self.dm_buffer['dev2_std'] = np.std(self.dm_buffer['dev2']) + + # 更新总体标准差 + if len(self.dm_buffer['dev1']) >= 10 or len(self.dm_buffer['dev2']) >= 10: + self.dm_buffer['all_std'] = np.std(self.dm_buffer['dev1'] + self.dm_buffer['dev2']) + + except Exception as e: + logger.error(f"Failed to update buffer: {e}") + + def _process_result(self, mat_data: Dict[str, Any], out_path: str) -> Dict[str, Any]: + """处理计算结果 + + Args: + mat_data: MAT文件数据 + out_path: 输出文件路径 + + Returns: + dict: 处理后的结果 + """ + try: + ret = {} + + # 提取边缘数据 + XEdgeLeft = mat_data['OutStruct']['EdgesLeftX'][0, 0].flatten().tolist() + XEdgeRight = mat_data['OutStruct']['EdgesRightX'][0, 0].flatten().tolist() + YEdgeLeft = mat_data['OutStruct']['EdgesLeftY'][0, 0].flatten().tolist() + YEdgeRight = mat_data['OutStruct']['EdgesRightY'][0, 0].flatten().tolist() + + # 更新缓冲区 + self._update_buffer({ + 'XEdgeLeft': XEdgeLeft, + 'XEdgeRight': XEdgeRight, + 'YEdgeLeft': YEdgeLeft, + 'YEdgeRight': YEdgeRight + }, out_path) + + # 提取重量数据 + WtISC = mat_data['OutStruct']['WtISC'][0, 0].flatten().tolist() + WtOSC = mat_data['OutStruct']['WtOSC'][0, 0].flatten().tolist() + WtINS = mat_data['OutStruct']['WtINS'][0, 0].flatten().tolist() + WtALL = mat_data['OutStruct']['WtALL'][0, 0].flatten().tolist() + + vals = mat_data['OutStruct']['WtBis'][0, 0].flatten().tolist() + + # 外屏层 + ret['WtOSC'] = [0 for _ in range(8)] + ret['WtOSC'][0] = vals[2] + ret['WtOSC'][1] = WtOSC[0] + ret['WtOSC'][2] = vals[3] + ret['WtOSC'][3] = WtOSC[2] + ret['WtOSC'][4] = vals[0] + ret['WtOSC'][5] = WtOSC[1] + ret['WtOSC'][6] = vals[1] + ret['WtOSC'][7] = WtOSC[3] + + # 绝缘层 + ret['WtINS'] = [0 for _ in range(8)] + ret['WtINS'][0] = vals[6] + ret['WtINS'][1] = WtINS[0] + ret['WtINS'][2] = vals[7] + ret['WtINS'][3] = WtINS[2] + ret['WtINS'][4] = vals[4] + ret['WtINS'][5] = WtINS[1] + ret['WtINS'][6] = vals[5] + ret['WtINS'][7] = WtINS[3] + + # 内屏层 + ret['WtISC'] = [0 for _ in range(8)] + ret['WtISC'][0] = vals[10] + ret['WtISC'][1] = WtISC[0] + ret['WtISC'][2] = vals[11] + ret['WtISC'][3] = WtISC[2] + ret['WtISC'][4] = vals[8] + ret['WtISC'][5] = WtISC[1] + ret['WtISC'][6] = vals[9] + ret['WtISC'][7] = WtISC[3] + + # 总壁厚 + ret['WtALL'] = [0 for _ in range(8)] + ret['WtALL'][0] = vals[14] + ret['WtALL'][1] = WtALL[0] + ret['WtALL'][2] = vals[15] + ret['WtALL'][3] = WtALL[2] + ret['WtALL'][4] = vals[12] + ret['WtALL'][5] = WtALL[1] + ret['WtALL'][6] = vals[13] + ret['WtALL'][7] = WtALL[3] + + # 提取角度数据 + mmang = mat_data['OutStruct']['MMAng'][0, 0].flatten().tolist() + + ret['AngOSC'] = [90 + val for val in mmang[0:2]] + ret['AngOSC'].append(90 + WtOSC[10]) + for i in range(len(ret['AngOSC'])): + if ret['AngOSC'][i] >= 360: + ret['AngOSC'][i] = ret['AngOSC'][i] - 360 + + ret['AngINS'] = [90 + val for val in mmang[2:4]] + ret['AngINS'].append(90 + WtINS[10]) + for i in range(len(ret['AngINS'])): + if ret['AngINS'][i] >= 360: + ret['AngINS'][i] = ret['AngINS'][i] - 360 + + ret['AngISC'] = [90 + val for val in mmang[4:6]] + ret['AngISC'].append(90 + WtISC[10]) + for i in range(len(ret['AngISC'])): + if ret['AngISC'][i] >= 360: + ret['AngISC'][i] = ret['AngISC'][i] - 360 + + ret['AngALL'] = [90 + val for val in mmang[6:8]] + ret['AngALL'].append(90 + WtALL[10]) + for i in range(len(ret['AngALL'])): + if ret['AngALL'][i] >= 360: + ret['AngALL'][i] = ret['AngALL'][i] - 360 + + # 提取直径数据 + ret['DmCORE'] = mat_data['OutStruct']['DmCORE'][0, 0].flatten().tolist()[0:3] + ret['DmCORE'] = [val - 0.2 for val in ret['DmCORE']] + ret['DmALL'] = mat_data['OutStruct']['DmALL'][0, 0].flatten().tolist()[0:3] + ret['DmALL'] = [val - 0.2 for val in ret['DmALL']] + + # 计算偏心率 + err = max(ret['WtINS']) - min(ret['WtINS']) + if max(ret['WtINS']) < 0.1: + ret['EccentricityINS'] = 0 + else: + ret['EccentricityINS'] = err * 100.0 / max(ret['WtINS']) + + err = max(ret['WtOSC']) - min(ret['WtOSC']) + if max(ret['WtOSC']) < 0.1: + ret['EccentricityOSC'] = 0 + else: + ret['EccentricityOSC'] = err * 100.0 / max(ret['WtOSC']) + + err = max(ret['WtISC']) - min(ret['WtISC']) + if max(ret['WtISC']) < 0.1: + ret['EccentricityISC'] = 0 + else: + ret['EccentricityISC'] = err * 100.0 / max(ret['WtISC']) + + # 波动性 + ret['Volatility'] = [self.dm_buffer['dev1_std'], self.dm_buffer['dev2_std'], self.dm_buffer['all_std']] + + # 边缘数据 + ret['EdgesB'] = XEdgeLeft[0:4] + XEdgeRight[0:4][::-1] + ret['EdgesA'] = YEdgeLeft[0:4] + YEdgeRight[0:4][::-1] + ret['EdgesA'].sort() + ret['EdgesB'].sort() + + # 如果是direction_1,需要反转边缘数据 + if 'direction_1' in out_path: + rawDataLen = len(mat_data['OutStruct']['NormVideoX'][0, 0].flatten().tolist()) + width = rawDataLen * 0.04 + for i in range(len(ret['EdgesB'])): + if ret['EdgesB'][i] > 0.1: + ret['EdgesB'][i] = width - ret['EdgesB'][i] + if ret['EdgesA'][i] > 0.1: + ret['EdgesA'][i] = width - ret['EdgesA'][i] + + return ret + + except Exception as e: + logger.error(f"Failed to process result: {e}") + return {} + + def compute(self, mat_path: str, timeout: float = 2.0) -> Tuple[Optional[str], Optional[Dict[str, Any]]]: + """执行计算 + + Args: + mat_path: MAT文件路径 + timeout: 超时时间(秒) + + Returns: + tuple: (输出文件路径, 结果字典) + """ + try: + # 通过UDP发送计算命令 + start_time = datetime.now() + out_path = self.udp_handler.compute(mat_path, timeout) + end_time = datetime.now() + logger.info(f"---------------Computing used time: {end_time - start_time}---------------") + + if not out_path: + logger.error("Compute failed: no output path returned") + self.available = False + return None, None + + # 检查输出文件是否存在 + if not os.path.exists(out_path): + logger.error(f"Output file not found: {out_path}") + return None, None + + # 读取结果文件 + mat_data = loadmat(out_path) + + # 处理结果 + result = self._process_result(mat_data, out_path) + + logger.info(f"Compute completed: {out_path}") + + return out_path, result + + except Exception as e: + logger.error(f"Compute failed: {e}") + return None, None + + def compute_file(self, csv_path: str, init: int = 0) -> Optional[str]: + """计算CSV文件 + + Args: + csv_path: CSV文件路径 + init: 是否初始化 + + Returns: + str: JSON格式的结果,失败返回None + """ + try: + start_time = datetime.now() + + # 如果是初始化,重置缓冲区 + if init: + self.reset_buffer() + + # 转换CSV到MAT + mat_path = self.csv_to_mat(csv_path, init) + + if not mat_path: + return json.dumps({'error': 'Failed to convert CSV to MAT'}) + + # 执行计算 + out_path, result = self.compute(mat_path) + + if not out_path or not result: + return json.dumps({'error': 'Compute failed'}) + + # 删除输出文件 + try: + os.remove(out_path) + except: + pass + + # 转换为JSON + result_json = json.dumps(result, cls=CustomFloatEncoder) + + # 更新统计 + self.cal_count += 1 + self.last_result = result_json + + end_time = datetime.now() + logger.info(f"Compute completed in {end_time - start_time}") + + return result_json + + except Exception as e: + logger.error(f"Failed to compute file: {e}") + return json.dumps({'error': str(e)}) + + def get_status(self) -> Dict[str, Any]: + """获取服务状态 + + Returns: + dict: 状态信息 + """ + return { + 'available': self.available, + 'cal_count': self.cal_count, + 'buffer_size': { + 'X': len(self.dm_buffer['X']), + 'Y': len(self.dm_buffer['Y']), + 'dev1': len(self.dm_buffer['dev1']), + 'dev2': len(self.dm_buffer['dev2']) + }, + 'buffer_std': { + 'X_std': self.dm_buffer['X_std'], + 'Y_std': self.dm_buffer['Y_std'], + 'dev1_std': self.dm_buffer['dev1_std'], + 'dev2_std': self.dm_buffer['dev2_std'], + 'all_std': self.dm_buffer['all_std'] + } + } + + def is_available(self) -> bool: + """检查服务是否可用 + + Returns: + bool: 是否可用 + """ + return self.udp_handler.is_available() + + def close(self): + """关闭服务""" + self.udp_handler.close() diff --git a/config.py b/config.py new file mode 100644 index 0000000..b1728dd --- /dev/null +++ b/config.py @@ -0,0 +1,165 @@ +""" +配置管理模块 +负责读取和管理配置文件 +""" +import json +import os +import logging + +logger = logging.getLogger(__name__) + +# 配置文件路径 +DEFAULT_CONFIG_PATH = r"C:\CPY\Config\config.json" +DEFAULT_FILE_ROOT = r'C:\CPY\DTAT' +DEFAULT_SERVER_ID = '1' +DEFAULT_MQTT_HOST = "172.16.0.126" +DEFAULT_MQTT_PORT = 8883 +DEFAULT_MQTT_USERNAME = "cpy_algrithm_server" +DEFAULT_MQTT_PASSWORD = "Tgzz2026" +DEFAULT_MQTT_USE_SSL = True +DEFAULT_MQTT_USE_CA = False +DEFAULT_MQTT_CA_FILE = "./ca.cert" +DEFAULT_MQTT_ENABLE = False +DEFAULT_HTTP_HOST = "0.0.0.0" +DEFAULT_HTTP_PORT = 5000 +DEFAULT_UDP_SERVER = ("127.0.0.1", 15000) +DEFAULT_UDP_PORT_NUM = 10 + +class ConfigManager: + """配置管理器""" + + def __init__(self, config_path=None): + """ + 初始化配置管理器 + + Args: + config_path: 配置文件路径,默认为 DEFAULT_CONFIG_PATH + """ + self.config_path = config_path or DEFAULT_CONFIG_PATH + self.settings = {} + self._load_config() + + def _load_config(self): + """从文件加载配置""" + try: + if os.path.exists(self.config_path): + with open(self.config_path, 'r', encoding='utf-8') as f: + self.settings = json.load(f) + logger.info(f"Loaded configuration from {self.config_path}") + else: + logger.warning(f"Config file not found: {self.config_path}, using defaults") + self._set_defaults() + except Exception as e: + logger.error(f"Failed to load configuration: {e}") + self._set_defaults() + + def _set_defaults(self): + """设置默认配置""" + self.settings = { + 'server_id' : DEFAULT_SERVER_ID, + 'file_root': DEFAULT_FILE_ROOT, + 'mqtt': { + 'host': DEFAULT_MQTT_HOST, + 'port': DEFAULT_MQTT_PORT, + 'username': DEFAULT_MQTT_USERNAME, + 'password': DEFAULT_MQTT_PASSWORD, + 'use_ssl' : DEFAULT_MQTT_USE_SSL, + 'use_ca' : DEFAULT_MQTT_USE_CA, + 'ca_file' : DEFAULT_MQTT_CA_FILE, + 'enable' : DEFAULT_MQTT_ENABLE + }, + 'http': { + 'host': DEFAULT_HTTP_HOST, + 'port': DEFAULT_HTTP_PORT + }, + 'udp': { + 'host': DEFAULT_UDP_SERVER[0], + 'port': DEFAULT_UDP_SERVER[1], + 'num': DEFAULT_UDP_PORT_NUM + }, + 'udp_map': { + + } + } + + def get(self, key, default=None): + """ + 获取配置值 + + Args: + key: 配置键 + default: 默认值 + + Returns: + 配置值 + """ + keys = key.split('.') + value = self.settings + for k in keys: + if isinstance(value, dict) and k in value: + value = value[k] + else: + value = None + break + + return value if value is not None else default + + def set(self, key, value): + """ + 设置配置值 + + Args: + key: 配置键 + value: 配置值 + """ + keys = key.split('.') + current = self.settings + for i, k in enumerate(keys[:-1]): + if k not in current: + current[k] = {} + current = current[k] + + current[keys[-1]] = value + self._save_config() + + def _save_config(self): + """保存配置到文件""" + try: + os.makedirs(os.path.dirname(self.config_path), exist_ok=True) + with open(self.config_path, 'w', encoding='utf-8') as f: + json.dump(self.settings, f, indent=4, ensure_ascii=False) + logger.info(f"Saved configuration to {self.config_path}") + except Exception as e: + logger.error(f"Failed to save configuration: {e}") + + def get_file_root(self): + """获取文件根目录""" + return self.get('file_root', DEFAULT_FILE_ROOT) + + def get_mqtt_config(self): + """获取MQTT配置""" + return self.get('mqtt', {}) + + def get_http_config(self): + """获取HTTP配置""" + return self.get('http', {}) + + def get_udp_config(self): + """获取UDP配置""" + return self.get('udp', {}) + + def get_udp_map(self): + """获取UDP映射配置""" + return self.get('udp_map', {}) + + def del_udp_map(self, key): + if key in self.get_udp_map(): + try: + del self.settings['udp_map'][key] + self._save_config() + except: + pass + + +# 全局配置实例 +config_manager = ConfigManager() diff --git a/config_template.json b/config_template.json new file mode 100644 index 0000000..6b6bca7 --- /dev/null +++ b/config_template.json @@ -0,0 +1,31 @@ +{ + "server_id": "1", + "file_root": "C:\\CPY\\Data", + "template_path": "C:\\CPY\\Resource\\InStructTemplate.mat", + "http": { + "host": "0.0.0.0", + "port": 5000 + }, + "mqtt": { + "broker": "172.16.0.126", + "port": 8883, + "username": "cpy_algrithm_server", + "password": "TgCpyServer2026.", + "keepalive": 60, + "topic_prefix": "v1/cpy/server/", + "enable": true + }, + "udp": { + "host": "127.0.0.1", + "port": 15000, + "num": 10 + }, + "logging": { + "level": "INFO", + "file": "cpy_server.log" + }, + "udp_map": { + "TGX08-2601-0008-210836834": 15001, + "TGX08-2601-0009-058131800": 15000 + } +} \ No newline at end of file diff --git a/cpy_server.py b/cpy_server.py new file mode 100644 index 0000000..e3db3bd --- /dev/null +++ b/cpy_server.py @@ -0,0 +1,277 @@ +import logging +import json +import threading +from typing import Dict, Any, Optional + +import base64 + +from config import ConfigManager +from mqtt_client import MqttClient +from file_handler import FileHandler +from compute_service import ComputeService +from version import get_version + +from config import config_manager + +logger = logging.getLogger(__name__) + + +class CpyServer: + def __init__(self): + + # 服务器状态 + self.running = False + self.host = config_manager.get('http.host', '0.0.0.0') + self.port = config_manager.get('http.port', 5000) + self.server_thread = None + + # 初始化各个模块 + self._init_modules() + + def _init_modules(self): + """初始化各个功能模块""" + try: + # 初始化MQTT客户端 + if config_manager.get('mqtt.enable', False): + self.mqtt_client = MqttClient() + self.mqtt_client.set_callbacks(on_message = self.mqtt_msg_handler) + else: + self.mqtt_client = None + + # 初始化文件处理器 + file_root = config_manager.get("file_root", r"C:\\CPY\\Data") + self.file_handler = FileHandler(file_root) + + # 初始化计算服务 + self.compute_services = {} + + for dev_id in config_manager.get('udp.udp_map', {}).keys(): + try: + compute_service = ComputeService(dev_id) + logger.info(f"ComputeService initialized for dev_id: {dev_id}, udp port {compute_service.udp_handler.port}") + if compute_service.udp_handler.port != config_manager.get(f'udp_map.{dev_id}', 0): + config_manager.set(f'udp_map.{dev_id}', compute_service.udp_handler.port) + + + self.compute_services[dev_id] = compute_service + except Exception as e: + logger.error(f"Failed to initialize ComputeService for dev_id {dev_id}: {e}") + + logger.info("All modules initialized successfully") + + except Exception as e: + logger.error(f"Failed to initialize modules: {e}") + raise + + def mqtt_ack(self, cmd, dev_id, result, error = 200, uuid = None): + topic = f"v1/cpy/{dev_id}" + rsp = { + 'ack' : cmd, + 'error' : error, + 'result' : result + } + if uuid: + rsp['uuid'] = uuid + self.mqtt_client.publish(topic, rsp, 1) + + def mqtt_msg_handler(self, client, userdata, msg): + try: + payload = json.loads(msg.payload.decode()) + logger.info(f"Received message on topic {msg.topic}: ") + + cmd = payload.get("cmd", None) + if not cmd: + return + if cmd == 'status': + self.get_status(payload) + elif cmd == 'register': + self.register_device(payload) + elif cmd == 'calculate': + self.handle_data(payload) + + except json.JSONDecodeError: + logger.error(f"Failed to decode JSON from message on topic {msg.topic}") + + def handle_data(self, metadata): + """处理数据上传请求""" + try: + dev_id = metadata.get('dev_id', None) + msg_uuid = metadata.get('uuid', None) + file_name = metadata.get('file_name', None) + file_content = metadata.get('data', None) + scanner = metadata.get('scanner', None) + + if file_name is None or \ + file_content is None or\ + dev_id is None or\ + msg_uuid is None: + return + + try: + file_content = base64.b64decode(file_content) + except: + self.mqtt_ack('calculate', dev_id, "failed to decode data", 400, msg_uuid) + return + + # 处理文件上传 + processed_filename = self.file_handler.process_file_upload( + file_name, file_content, metadata + ) + + if not processed_filename: + self.mqtt_ack('calculate', dev_id, 'Failed to process file', 400, msg_uuid) + return + + # 获取计算参数 + init = int(metadata.get('init', 0)) + + # 执行计算 + file_path = processed_filename + compute_service = self.compute_services.get(dev_id) + if not compute_service: + self.mqtt_ack('calculate', dev_id, f'ComputeService not initialized for dev_id {dev_id}', 400, msg_uuid) + return + + try: + result_json = compute_service.compute_file(file_path, init) + except Exception as e: + self.mqtt_ack('calculate', dev_id, f'ComputeService error: {e}', 400, msg_uuid) + return + + # 返回结果 + try: + rsp = json.loads(result_json) + except: + rsp = result_json + + self.mqtt_ack('calculate', dev_id, rsp, uuid = msg_uuid) + + except Exception as e: + logger.error(f"Error handling data request: {e}") + return json.dumps({'error': str(e)}) + + def get_status(self, data): + """获取服务器状态""" + try: + # 获取MQTT连接状态 + mqtt_connected = self.mqtt_client.is_connected() if self.mqtt_client else False + # 获取版本号 + version = get_version() + #检查是否传入dev_id + dev_id = data.get('dev_id', None) + if not dev_id: + rsp = json.dumps({ + 'running': 'true' if self.running else 'false', + 'mqtt_connected': mqtt_connected, + 'version': version + }) + return + + try: + compute_status = self.compute_services.get(dev_id).is_available() + except: + compute_status = False + rsp = { + 'running': self.running, + 'mqtt_connected': mqtt_connected, + 'compute_status': compute_status, + 'version': version + } + self.mqtt_ack('status', dev_id, rsp) + + except Exception as e: + logger.error(f"Error getting status: {e}") + return json.dumps({'error': str(e)}) + + def register_device(self, data): + """注册设备""" + try: + dev_id = data.get('dev_id') + print('register msg from', dev_id) + if not dev_id: + return json.dumps({'error': 'dev_id is required'}) + + if dev_id in self.compute_services: + try: + if self.compute_services[dev_id].is_available(): + self.mqtt_ack('register', \ + dev_id, \ + {'message': 'Device registered successfully'},\ + 200) + return + except: + pass + + try: + self.compute_services[dev_id].close() + del self.compute_services[dev_id] + except: + pass + + # 初始化计算服务 + try: + compute_service = ComputeService(dev_id) + except Exception as e: + logger.error(f"Failed to initialize ComputeService for dev_id {dev_id}: {e}") + self.mqtt_ack('register', dev_id, {'error': f'Failed to initialize ComputeService: {e}'}, 500) + return + + self.compute_services[dev_id] = compute_service + if compute_service.udp_handler.port != config_manager.get(f'udp_map.{dev_id}', 0): + config_manager.set(f'udp_map.{dev_id}', compute_service.udp_handler.port) + + + self.mqtt_ack('register', dev_id, {'message': 'Device registered successfully'}) + + except Exception as e: + logger.error(f"Error registering device: {e}") + return json.dumps({'error': str(e)}) + + def start(self): + """启动HTTP服务器""" + if self.running: + logger.warning("Server is already running") + return + + self.running = True + logger.info(f"Starting HTTP server on {self.host}:{self.port}") + + # 启动MQTT客户端 + if self.mqtt_client: + self.mqtt_client.connect() + + + logger.info("HTTP server started") + + def stop(self): + """停止HTTP服务器""" + if not self.running: + logger.warning("Server is not running") + return + + self.running = False + logger.info("Stopping HTTP server") + + # 断开MQTT连接 + if self.mqtt_client: + self.mqtt_client.disconnect() + + # 关闭所有计算服务 + for dev_id in list(self.compute_services.keys()): + try: + self.compute_services[dev_id].close() + except: + pass + + try: + del self.compute_services[dev_id] + except: + pass + + # Flask会在新线程中运行,需要特殊处理 + # 这里只是标记状态,实际停止需要更复杂的处理 + logger.info("HTTP server stopped") + + def is_running(self) -> bool: + """检查服务器是否在运行""" + return self.running diff --git a/file_handler.py b/file_handler.py new file mode 100644 index 0000000..1909514 --- /dev/null +++ b/file_handler.py @@ -0,0 +1,364 @@ +import os +import gzip +import logging +import pandas as pd +import numpy as np +from typing import Optional, Dict, Any, Tuple + +logger = logging.getLogger(__name__) + + +class FileHandler: + """文件处理器""" + + def __init__(self, file_root: str): + """初始化文件处理器 + + Args: + file_root: 文件根目录 + """ + self.file_root = file_root + logger.info(f"FileHandler initialized with root: {file_root}") + + def set_file_root(self, file_root: str): + """设置文件根目录 + + Args: + file_root: 新的文件根目录 + """ + self.file_root = file_root + logger.info(f"File root changed to: {file_root}") + + def get_file_path(self, filename: str) -> str: + """获取文件的完整路径 + + Args: + filename: 文件名 + + Returns: + str: 文件完整路径 + """ + # 解析文件名,获取日期和小时 + dir_parts = filename.split('_') + if len(dir_parts) >= 2: + date = dir_parts[0] + hour = dir_parts[1][0:2] + dir_path = os.path.join(self.file_root, date, hour) + else: + dir_path = self.file_root + + return os.path.join(dir_path, filename) + + def ensure_directory(self, filename: str, dev_id: str = None) -> str: + """确保文件目录存在,如果不存在则创建 + + Args: + filename: 文件名 + dev_id: 设备ID + + Returns: + str: 目录路径 + """ + + root_dir = self.file_root if dev_id is None else os.path.join(self.file_root, dev_id) + # 解析文件名,获取日期和小时 + dir_parts = filename.split('_') + if len(dir_parts) >= 2: + date = dir_parts[0] + hour = dir_parts[1][0:2] + dir_path = os.path.join(root_dir, date, hour) + else: + dir_path = root_dir + + # 创建目录 + if not os.path.exists(dir_path): + os.makedirs(dir_path) + logger.info(f"Created directory: {dir_path}") + + return dir_path + + def file_exists(self, filename: str, dev_id: str = None) -> bool: + """检查文件是否存在 + + Args: + filename: 文件名 + dev_id: 设备ID + + Returns: + bool: 文件是否存在 + """ + file_path = self.get_file_path(filename, dev_id) + return os.path.exists(file_path) + + def save_raw_data(self, filename: str, file_content: bytes, + scale: float = 1.0, offset: float = 0.0, + row_count: int = 0, dev_id: str = None) -> Optional[str]: + """保存原始数据为CSV文件 + + Args: + filename: 文件名 + file_content: 文件内容(字节数据) + scale: 缩放因子 + offset: 偏移量 + row_count: 行数限制(0表示不限制) + + Returns: + str: 保存的文件名,失败返回None + """ + try: + # 确保目录存在 + dir_path = self.ensure_directory(filename, dev_id) + file_path = os.path.join(dir_path, filename) + + # 处理数据 + data = np.frombuffer(file_content, dtype=np.float32) + + # 应用缩放和偏移 + if scale != 1.0: + data = data * scale + if offset != 0.0: + data = data + offset + + # 限制行数 + if row_count > 0 and len(data) > row_count: + data = data[:row_count] + + # 保存为CSV文件 + df = pd.DataFrame({ + 'CH1': data[::2], # 偶数索引 + 'CH2': data[1::2] # 奇数索引 + }) + + df.to_csv(file_path, index=False) + logger.info(f"Saved raw data to {file_path}") + + return file_path + + except Exception as e: + logger.error(f"Failed to save raw data: {e}") + return None + + def save_gz_data(self, filename: str, file_content: bytes, dev_id: str = None) -> Optional[str]: + """解压并保存GZ压缩数据 + + Args: + filename: 文件名 + file_content: GZ压缩的文件内容 + dev_id: 设备ID + + Returns: + str: 保存的文件名,失败返回None + """ + try: + # 解压数据 + decompressed = gzip.decompress(file_content) + + # 保存解压后的数据 + filename = filename.replace('.gz', '') + return self.save_raw_data(filename, decompressed, scale=1.0, offset=0.0, row_count=0, dev_id=dev_id) + + except Exception as e: + logger.error(f"Failed to save GZ data: {e}") + return None + + def delete_file(self, filename: str, dev_id: str = None) -> bool: + """删除文件 + + Args: + filename: 文件名 + dev_id: 设备ID + + Returns: + bool: 删除是否成功 + """ + try: + file_path = self.get_file_path(filename, dev_id) + + if os.path.exists(file_path): + os.remove(file_path) + logger.info(f"Deleted file: {file_path}") + return True + else: + logger.warning(f"File not found: {file_path}") + return False + + except Exception as e: + logger.error(f"Failed to delete file {filename}: {e}") + return False + + def get_file_info(self, filename: str, dev_id: str = None) -> Optional[Dict[str, Any]]: + """获取文件信息 + + Args: + filename: 文件名 + dev_id: 设备ID + + Returns: + dict: 文件信息字典,失败返回None + """ + try: + file_path = self.get_file_path(filename, dev_id) + + if not os.path.exists(file_path): + return None + + stat = os.stat(file_path) + + return { + 'filename': filename, + 'path': file_path, + 'size': stat.st_size, + 'created': stat.st_ctime, + 'modified': stat.st_mtime, + 'exists': True + } + + except Exception as e: + logger.error(f"Failed to get file info for {filename}: {e}") + return None + + def list_files(self, date: Optional[str] = None, + hour: Optional[str] = None, dev_id: str = None) -> list: + """列出文件 + + Args: + date: 日期(可选) + hour: 小时(可选) + dev_id: 设备ID + + Returns: + list: 文件列表 + """ + try: + # 构建目录路径 + if dev_id: + dir_path = os.path.join(self.file_root, dev_id) + else: + dir_path = self.file_root + + if date and hour: + dir_path = os.path.join(dir_path, date, hour) + elif date: + dir_path = os.path.join(dir_path, date) + + if not os.path.exists(dir_path): + return [] + + # 列出文件 + files = [] + for item in os.listdir(dir_path): + item_path = os.path.join(dir_path, item) + if os.path.isfile(item_path): + files.append(item) + + logger.info(f"Found {len(files)} files in {dir_path}") + return files + + except Exception as e: + logger.error(f"Failed to list files: {e}") + return [] + + def process_file_upload(self, filename: str, file_content: bytes, + metadata: Dict[str, Any]) -> Optional[str]: + """处理文件上传 + + Args: + filename: 文件名 + file_content: 文件内容 + metadata: 元数据字典 + + Returns: + str: 处理后的文件名,失败返回None + """ + try: + # 获取参数 + file_type = metadata.get('file_type', 'raw') + compress = metadata.get('compress', 'none') + scale = float(metadata.get('scale', 1.0)) + offset = float(metadata.get('offset', 0.0)) + row_count = int(metadata.get('row_count', 0)) + dev_id = metadata.get('dev_id', None) + + # 根据文件类型处理 + if file_type == 'raw': + if compress == 'none': + return self.save_raw_data(filename, file_content, scale, offset, row_count, dev_id) + elif compress == 'gz': + return self.save_gz_data(filename, file_content, dev_id) + else: + logger.error(f"Unsupported compression type: {compress}") + return None + else: + logger.error(f"Unsupported file type: {file_type}") + return None + + except Exception as e: + logger.error(f"Failed to process file upload: {e}") + return None + + def read_csv(self, filename: str, dev_id: str = None, nrows: Optional[int] = None) -> Optional[pd.DataFrame]: + """读取CSV文件 + + Args: + filename: 文件名 + dev_id: 设备ID + nrows: 读取的行数(None表示全部) + + Returns: + DataFrame: 数据框,失败返回None + """ + try: + file_path = self.get_file_path(filename, dev_id) + + if not os.path.exists(file_path): + logger.error(f"File not found: {file_path}") + return None + + if nrows: + df = pd.read_csv(file_path, nrows=nrows) + else: + df = pd.read_csv(file_path) + + logger.info(f"Read CSV file: {file_path}, shape: {df.shape}") + return df + + except Exception as e: + logger.error(f"Failed to read CSV file {filename}: {e}") + return None + + def clean_old_files(self, days: int = 7) -> int: + """清理旧文件 + + Args: + days: 保留天数 + + Returns: + int: 删除的文件数量 + """ + try: + import time + current_time = time.time() + cutoff_time = current_time - (days * 24 * 60 * 60) + + deleted_count = 0 + + # 遍历所有文件 + for root, dirs, files in os.walk(self.file_root): + for file in files: + file_path = os.path.join(root, file) + file_mtime = os.path.getmtime(file_path) + + if file_mtime < cutoff_time: + try: + os.remove(file_path) + deleted_count += 1 + logger.info(f"Deleted old file: {file_path}") + except Exception as e: + logger.error(f"Failed to delete {file_path}: {e}") + + logger.info(f"Cleaned {deleted_count} old files") + return deleted_count + + except Exception as e: + logger.error(f"Failed to clean old files: {e}") + return 0 diff --git a/main.py b/main.py new file mode 100644 index 0000000..b5d41e6 --- /dev/null +++ b/main.py @@ -0,0 +1,85 @@ +import logging +import signal +import sys +import time + +from config import config_manager +from cpy_server import CpyServer + +logging.basicConfig( + level=logging.INFO, + stream=sys.stdout # 输出到stdout,被nssm捕获写入日志文件 +) + +logger = logging.getLogger() + + +def setup_logging(): + """设置日志配置 + + Args: + config_manager: 配置管理器实例 + """ + log_level = config_manager.get('logging.level', 'INFO') + log_file = config_manager.get('logging.file', 'cpy_server.log') + + logging.basicConfig( + level=getattr(logging, log_level), + format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', + handlers=[ + logging.FileHandler(log_file, encoding='utf-8'), + logging.StreamHandler(sys.stdout) + ] + ) + + logger.info(f"Logging configured: level={log_level}, file={log_file}") + + +def signal_handler(signum, frame): + """信号处理函数 + + Args: + signum: 信号编号 + frame: 当前栈帧 + """ + logger.info(f"Received signal {signum}, shutting down...") + sys.exit(0) + + +def main(): + """主函数""" + try: + # 设置日志 + setup_logging() + logger.info("Starting Cpy Gateway Server...") + + # 设置信号处理 + signal.signal(signal.SIGINT, signal_handler) + signal.signal(signal.SIGTERM, signal_handler) + + # 创建Cpy服务器 + cpy_server = CpyServer() + + # 启动服务器 + cpy_server.start() + + # 保持主线程运行 + logger.info("Server is running. Press Ctrl+C to stop.") + try: + while cpy_server.is_running(): + time.sleep(1) + except KeyboardInterrupt: + logger.info("Received keyboard interrupt") + finally: + # 清理资源 + logger.info("Shutting down...") + cpy_server.stop() + logger.info("Server stopped") + + except Exception as e: + logger.error(f"Fatal error: {e}", exc_info=True) + sys.exit(1) + + +if __name__ == '__main__': + main() diff --git a/mqtt_client.py b/mqtt_client.py new file mode 100644 index 0000000..75122c0 --- /dev/null +++ b/mqtt_client.py @@ -0,0 +1,341 @@ +import paho.mqtt.client as mqtt +from paho.mqtt.enums import CallbackAPIVersion +import logging +import json +import ssl +from typing import Callable, Optional, Dict, Any +import threading + +from config import config_manager + +logger = logging.getLogger(__name__) + + +class MqttClient: + """MQTT客户端封装类""" + + def __init__(self): + """初始化MQTT客户端 + + """ + self.client = None + self.connected = False + self.device_id = None + + # 回调函数 + self.on_connect_callback = None + self.on_message_callback = None + self.on_disconnect_callback = None + + # 订阅的主题列表 + self.subscribed_topics = set() + + # 初始化客户端 + self._init_client() + + def _init_client(self): + """初始化MQTT客户端""" + try: + # 获取配置 + broker = config_manager.get('mqtt.broker', '127.0.0.1') + port = config_manager.get('mqtt.port', 1883) + username = config_manager.get('mqtt.username', '') + password = config_manager.get('mqtt.password', '') + use_ssl = config_manager.get('mqtt.use_ssl', True) + use_ca = config_manager.get('mqtt.use_ca', False) + logger.info(f"use_ssl {use_ssl}, use_ca {use_ca}") + server_id = config_manager.get('server_id', '3') + + #读取本机ip地址 + import socket + device_name = socket.gethostbyname(socket.gethostname()) + + # 创建客户端 + self.client = mqtt.Client(client_id=f"cpy_gateway_{server_id}_{device_name}", \ + callback_api_version=CallbackAPIVersion.VERSION2, clean_session=True) + logger.info(f"cpy_gateway_{server_id}_{device_name}") + + # 设置用户名和密码 + if username and password: + self.client.username_pw_set(username, password) + + if use_ca: + ca_file = config_manager.get('mqtt.ca_file', '.ca.cert') + self.client.tls_set(cert_reqs=ca_file) + self.client.tls_insecure_set(False) + elif use_ssl: + # 使用默认系统CA证书 + logger.info(f"use mqtts without ca") + self.client.tls_set(cert_reqs=ssl.CERT_NONE) + self.client.tls_insecure_set(True) + + # 设置回调 + self.client.on_connect = self._on_connect + self.client.on_message = self._on_message + self.client.on_disconnect = self._on_disconnect + + logger.info(f"MQTT client initialized for broker {broker}:{port}") + + except Exception as e: + logger.error(f"Failed to initialize MQTT client: {e}") + raise + + def connect(self) -> bool: + """连接到MQTT代理 + + Returns: + bool: 连接是否成功 + """ + try: + broker = config_manager.get('mqtt.broker', '127.0.0.1') + port = config_manager.get('mqtt.port', 1883) + keepalive = config_manager.get('mqtt.keepalive', 60) + + logger.info(f"Connecting to MQTT broker {broker}:{port}...") + self.client.connect(broker, port, keepalive) + self.client.loop_start() + + return True + + except Exception as e: + logger.error(f"Failed to connect to MQTT broker: {e}") + return False + + def disconnect(self): + """断开MQTT连接""" + try: + if self.client: + self.client.loop_stop() + self.client.disconnect() + self.connected = False + logger.info("Disconnected from MQTT broker") + except Exception as e: + logger.error(f"Error disconnecting from MQTT broker: {e}") + + def publish(self, topic: str, payload: Any, qos: int = 0, retain: bool = False) -> bool: + """发布消息到指定主题 + + Args: + topic: 主题名称 + payload: 消息内容(可以是字符串、字典等) + qos: 服务质量等级(0, 1, 2) + retain: 是否保留消息 + + Returns: + bool: 发布是否成功 + """ + try: + if not self.connected: + logger.warning("MQTT client not connected, cannot publish") + return False + + # 如果payload是字典,转换为JSON字符串 + if isinstance(payload, dict): + payload = json.dumps(payload) + + result = self.client.publish(topic, payload, qos, retain) + + if result.rc == mqtt.MQTT_ERR_SUCCESS: + logger.debug(f"Published to {topic}: {payload}") + return True + else: + logger.error(f"Failed to publish to {topic}, rc={result.rc}") + return False + + except Exception as e: + logger.error(f"Error publishing to {topic}: {e}") + return False + + def subscribe(self, topic: str, qos: int = 0) -> bool: + """订阅主题 + + Args: + topic: 主题名称(支持通配符) + qos: 服务质量等级 + + Returns: + bool: 订阅是否成功 + """ + try: + if not self.connected: + logger.warning("MQTT client not connected, cannot subscribe") + return False + + result = self.client.subscribe(topic, qos) + + if result[0] == mqtt.MQTT_ERR_SUCCESS: + self.subscribed_topics.add(topic) + logger.info(f"Subscribed to {topic}") + return True + else: + logger.error(f"Failed to subscribe to {topic}, rc={result[0]}") + return False + + except Exception as e: + logger.error(f"Error subscribing to {topic}: {e}") + return False + + def unsubscribe(self, topic: str) -> bool: + """取消订阅主题 + + Args: + topic: 主题名称 + + Returns: + bool: 取消订阅是否成功 + """ + try: + if not self.connected: + logger.warning("MQTT client not connected, cannot unsubscribe") + return False + + result = self.client.unsubscribe(topic) + + if result[0] == mqtt.MQTT_ERR_SUCCESS: + self.subscribed_topics.discard(topic) + logger.info(f"Unsubscribed from {topic}") + return True + else: + logger.error(f"Failed to unsubscribe from {topic}, rc={result[0]}") + return False + + except Exception as e: + logger.error(f"Error unsubscribing from {topic}: {e}") + return False + + def _on_connect(self, client, userdata, flags, rc, props): + """连接回调函数""" + if rc == 0: + self.connected = True + logger.info(f"Connected to MQTT broker with result code {rc}") + + # 订阅默认主题 + self._subscribe_default_topics() + + # 调用外部回调 + if self.on_connect_callback: + self.on_connect_callback(client, userdata, flags, rc) + else: + self.connected = False + logger.error(f"Failed to connect to MQTT broker, result code {rc}") + + def _on_message(self, client, userdata, msg): + """消息接收回调函数""" + try: + topic = msg.topic + payload = msg.payload.decode() + + logger.debug(f"Received message on {topic}: {payload}") + + # 调用外部回调 + if self.on_message_callback: + #在新线程中调用外部回调 + thread = threading.Thread(target=self.on_message_callback, args=(client, userdata, msg)) + thread.start() + + except Exception as e: + logger.error(f"Error processing message: {e}") + + def _on_disconnect(self, client, userdata, rc, props, flags): + """断开连接回调函数""" + self.connected = False + logger.info(f"Disconnected from MQTT broker with result code {rc}") + + # 调用外部回调 + if self.on_disconnect_callback: + self.on_disconnect_callback(client, userdata, rc) + + def _subscribe_default_topics(self): + """订阅默认主题""" + try: + topic_prefix = config_manager.get('mqtt.topic_prefix', 'v1/cpycal/') + server_id = config_manager.get('server_id', '1') + + # 订阅控制主题 + control_topic = f"{topic_prefix}{server_id}" + self.subscribe(control_topic) + + logger.info(f"Subscribed to default topics for device {server_id}") + + except Exception as e: + logger.error(f"Error subscribing to default topics: {e}") + + def get_status_topic(self) -> str: + """获取状态主题 + + Returns: + str: 状态主题名称 + """ + topic_prefix = config_manager.get('mqtt.topic_prefix', 'v1/cpycal/') + server_id = config_manager.get('server_id', '1') + return f"{topic_prefix}{server_id}/status" + + def get_control_topic(self) -> str: + """获取控制主题 + + Returns: + str: 控制主题名称 + """ + topic_prefix = config_manager.get('mqtt.topic_prefix', 'v1/cpycal/') + server_id = config_manager.get('server_id', '1') + return f"{topic_prefix}{server_id}/control" + + def get_data_topic(self) -> str: + """获取数据主题 + + Returns: + str: 数据主题名称 + """ + topic_prefix = config_manager.get('mqtt.topic_prefix', 'v1/cpycal/') + server_id = config_manager.get('server_id', '1') + return f"{topic_prefix}{server_id}/data" + + def publish_status(self, status: Dict[str, Any]) -> bool: + """发布状态消息 + + Args: + status: 状态字典 + + Returns: + bool: 发布是否成功 + """ + topic = self.get_status_topic() + return self.publish(topic, status, qos=1, retain=True) + + def publish_data(self, data: Dict[str, Any]) -> bool: + """发布数据消息 + + Args: + data: 数据字典 + + Returns: + bool: 发布是否成功 + """ + topic = self.get_data_topic() + return self.publish(topic, data, qos=0, retain=False) + + def set_callbacks(self, + on_connect: Optional[Callable] = None, + on_message: Optional[Callable] = None, + on_disconnect: Optional[Callable] = None): + """设置回调函数 + + Args: + on_connect: 连接回调函数 + on_message: 消息回调函数 + on_disconnect: 断开连接回调函数 + """ + if on_connect: + self.on_connect_callback = on_connect + if on_message: + self.on_message_callback = on_message + if on_disconnect: + self.on_disconnect_callback = on_disconnect + + def is_connected(self) -> bool: + """检查是否已连接 + + Returns: + bool: 是否已连接 + """ + return self.connected diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000000000000000000000000000000000000..e1c57fa407db8d1c5c4163dce7d2ae441dec394d GIT binary patch literal 544 zcmZ9Jy-veG5QL|W#G_!v7s5|LOMyg1K^+1FljI!ivmiV?;oCi*3lwb>-OSF+PENni z+Nn|0R2qBj5+89bLosb@Rj;;J8xDB zjx|akFW^xdcW*WDVk!Xzo1Ed^6Mn!9juxHl@xXhB!=Qs6`Td5LX&B4WEZi-E?_nGr zGi^(m?>Mma&K>74K1r1(j&+eU7$7qnzEU;IT1>$oFHKlWNu=YQbITi>E%SvT%d Ix?Or}e@_KXlK=n! literal 0 HcmV?d00001 diff --git a/udp_handler.py b/udp_handler.py new file mode 100644 index 0000000..2ce8766 --- /dev/null +++ b/udp_handler.py @@ -0,0 +1,341 @@ +import socket +import json +import logging +from typing import Optional, Dict, Any, Tuple + +logger = logging.getLogger(__name__) + +from config import config_manager + +class UdpHandler: + """UDP通信处理器""" + + def __init__(self, remote_port: int, remote_host: str = 'localhost'): + """初始化UDP处理器 + + Args: + remote_port: 远程端口号 + """ + self.remote_address = (remote_host, remote_port) + + self.sock = None + self.connected = False + + # 初始化socket + self._init_socket() + + def set_remote_port(self, remote_port: int): + """设置远程端口号 + + Args: + remote_port: 远程端口号 + """ + self.remote_address = (self.remote_address[0], remote_port) + + # 重新初始化socket + self._init_socket() + + @property + def port(self) -> int: + """本地端口号""" + return self.remote_address[1] + + def _init_socket(self): + """初始化UDP socket""" + try: + # 关闭旧socket + if self.sock: + self.sock.close() + + self.sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) + # self.sock.bind((self.remote_address[0], self.remote_address[1] + 10000)) + self.connected = True + logger.info(f"UDP socket initialized, local port: {self.remote_address[1] + 10000}, remote: {self.remote_address}") + except Exception as e: + logger.error(f"Failed to initialize UDP socket: {e}") + raise + + def send_command(self, command: Dict[str, Any]) -> bool: + """发送命令到MATLAB网关 + + Args: + command: 命令字典 + + Returns: + bool: 发送是否成功 + """ + try: + if not self.sock: + logger.error("UDP socket not initialized") + return False + + message = json.dumps(command) + self.sock.sendto(message.encode(), self.remote_address) + logger.debug(f"Sent command to {self.remote_address}: {command}") + return True + + except Exception as e: + logger.error(f"Failed to send command: {e}") + return False + + def send_status_cmd(self): + """发送状态查询命令""" + command = { + 'command': 'status' + } + return self.send_command(command) + + def send_compute_cmd(self, file_path: str) -> bool: + """发送计算命令 + + Args: + file_path: .mat文件路径 + + Returns: + bool: 发送是否成功 + """ + command = { + 'command': 'compute', + 'file_path': file_path + } + return self.send_command(command) + + def send_start_cmd(self, cfg_path: str) -> bool: + """发送启动命令 + + Args: + cfg_path: 配置文件路径 + + Returns: + bool: 发送是否成功 + """ + command = { + 'command': 'start', + 'cfg_path': cfg_path + } + return self.send_command(command) + + def send_stop_cmd(self) -> bool: + """发送停止命令 + + Returns: + bool: 发送是否成功 + """ + command = { + 'command': 'stop' + } + return self.send_command(command) + + def receive_data(self, timeout: float = 2.0) -> Optional[Any]: + """接收数据 + + Args: + timeout: 超时时间(秒) + + Returns: + 接收到的数据,如果失败或超时返回None + """ + try: + if not self.sock: + logger.error("UDP socket not initialized") + return None + + self.sock.settimeout(timeout) + + try: + data, addr = self.sock.recvfrom(10240) + self.sock.settimeout(None) + + logger.debug(f"Received data from {addr}: {len(data)} bytes") + + # 解码数据 + if not isinstance(data, str): + data = data.decode() + + # 解析JSON + msg = json.loads(data) + + return msg + + except socket.timeout: + logger.warning(f"Timeout waiting for response after {timeout} seconds") + return None + + except json.JSONDecodeError as e: + logger.error(f"Failed to parse JSON response: {e}") + logger.debug(f"Raw data: {data}") + return None + except Exception as e: + logger.error(f"Failed to receive data: {e}") + return None + + def compute(self, mat_file_path: str, timeout: float = 2.0) -> Optional[str]: + """执行计算操作 + + Args: + mat_file_path: .mat文件路径 + timeout: 超时时间(秒) + + Returns: + 输出文件路径,如果失败返回None + """ + try: + # 清空接收缓冲区 + self.receive_data(timeout=0.001) + + # 发送计算命令 + if not self.send_compute_cmd(mat_file_path): + logger.error("Failed to send compute command") + return None + + # 接收结果 + result = self.receive_data(timeout=timeout) + if result is not None and 'result' in result: + result = result['result'] + logger.info(f"Compute result: {result}") + return result + + except Exception as e: + logger.error(f"Compute operation failed: {e}") + return None + + def status(self, timeout: float = 2.0) -> Optional[Dict[str, Any]]: + """查询状态 + + Args: + timeout: 超时时间(秒) + + Returns: + 状态信息字典,如果失败返回None + """ + try: + # 清空接收缓冲区 + self.receive_data(timeout=0.001) + + # 发送状态查询命令 + if not self.send_status_cmd(): + logger.error("Failed to send status command") + return None + + # 接收结果 + result = self.receive_data(timeout=timeout) + + print() + print(result) + print() + + logger.info(f"Status result: {result}") + return result + + except Exception as e: + logger.error(f"Status query failed: {e}") + return None + + def _udp_status_available(self, response) -> bool: + if not response: + return False + try: + status = response['result'] + idle_time = response['idle_time'] + run_time = response['run_time'] + compute_count = response['compute_count'] + if idle_time > 3600: + return True + if compute_count == 0: + return True + except Exception as e: + logger.error(f"Failed to parse UDP status response: {e}") + return False + return True + + def is_udp_port_in_use(self, port): + maps = config_manager.get_udp_map() + if not maps: + return False + for dev_id, _port in maps.items(): + if _port == port: + return True + return False + + def search_for_available_udp_port(self) -> bool: + """搜索可用的UDP端口 + + Returns: + bool: 是否找到可用端口 + """ + + #先检查当前端口是否可用 + response = self.status() + logger.info(f"UDP port {self.port} status: {response}") + + if self._udp_status_available(response): + logger.info(f"UDP port {self.port} is available") + self.available = True + return True + + # 检查其他端口 + self.available = False + port = config_manager.get('udp.port', 15000) + num = config_manager.get('udp.num', 10) + for i in range(num): + self.set_remote_port(port + i) + response = self.status() + logger.info(f"UDP port {self.port} status: {response}") + if self._udp_status_available(response) and not self.is_udp_port_in_use(port + i): + logger.info(f"UDP port {self.port} is available") + self.available = True + break + + return self.available + + def is_available(self) -> bool: + """检查端口是否可用 + + Returns: + bool: 是否可用 + """ + response = self.status() + logger.info(f"UDP port {self.port} status: {response}") + if self._udp_status_available(response): + logger.info(f"UDP port {self.port} is available") + self.available = True + else: + logger.info(f"UDP port {self.port} is not available") + self.available = False + + return self.available + + def remove_dev_by_port(self,port) -> bool: + maps = config_manager.get_udp_map() + for dev_id, _port in maps.items(): + if _port == port: + config_manager.del_udp_map(dev_id) + return True + return False + + def close(self): + """关闭UDP socket""" + try: + if self.sock: + self.sock.close() + self.sock = None + self.connected = False + logger.info("UDP socket closed") + except Exception as e: + logger.error(f"Error closing UDP socket: {e}") + + def is_connected(self) -> bool: + """检查是否已连接 + + Returns: + bool: 是否已连接 + """ + return self.connected + + def __enter__(self): + """上下文管理器入口""" + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + """上下文管理器出口""" + self.close() diff --git a/version.py b/version.py new file mode 100644 index 0000000..d43b809 --- /dev/null +++ b/version.py @@ -0,0 +1,32 @@ +""" +版本信息模块 +管理软件版本号 +""" + +__version__ = "1.0.3" +__author__ = "CpyGateway Team" +__date__ = "2026-01-14" + + +def get_version(): + """ + 获取当前版本号 + + Returns: + str: 版本号字符串 + """ + return __version__ + + +def get_version_info(): + """ + 获取完整的版本信息 + + Returns: + dict: 包含版本信息的字典 + """ + return { + 'version': __version__, + 'author': __author__, + 'date': __date__ + }