PocketIO 使用手册

# PocketIO

轻量级 PLC 联调工具 · 开箱即用 · 手机扫码即可监控

始于 2021
1

## 运行环境安装

### 📦 必备运行环境

PocketIO 基于 .NET 8.0 开发，首次运行前请确保已安装对应运行时：

组件 | 版本要求 | 下载地址
--- | --- | ---
ASP.NET Core Runtime | >= 8.0 | dotnet.microsoft.com
.NET Desktop Runtime | >= 8.0（可选） | 同上

💡
安装要点：下载页面选择 `ASP.NET Core Runtime 8.0.x`（Windows x64），下载 Hosting Bundle 安装包，双击安装即可。安装完成后无需重启。

### 🌐 推荐浏览器

浏览器 | 推荐等级 | 说明
--- | --- | ---
Microsoft Edge | ⭐⭐⭐ 强烈推荐 | Windows 自带，兼容性最佳，功能完整
Google Chrome | ⭐⭐⭐ 推荐 | 同为 Chromium 内核，体验一致
Firefox | ⭐⭐ 可用 | 基本功能正常
华为浏览器 | ⚠️ 不推荐 | 存在长按弹出菜单等兼容问题
UC / QQ 浏览器 | ⚠️ 不推荐 | 可能存在兼容性问题

⛔
华为浏览器已知问题：长按 IO 点或按钮时会弹出系统菜单，严重影响操作体验。
解决方案：手机端请使用 Edge 移动版（应用商店搜索 "Microsoft Edge" 安装）。
2

## 快速开始

1

#### 安装运行环境

参照上一节安装 `ASP.NET Core Runtime 8.0`。

2

#### 启动 PocketIO

双击 `PocketIO.exe` 即可启动。程序会自动打开浏览器访问 `http://127.0.0.1:90`。

3

#### 配置 PLC 连接

点击右上角菜单 → 设置，选择 PLC 类型（西门子、三菱、欧姆龙等），填写 IP 地址，点击 "连接测试"。

4

#### 配置 IO / 模拟量 / 轴

在设置页面的各个 Tab 中添加需要监控的 IO 点、模拟量通道或轴参数。

5

#### 返回主页开始联调

返回主页即可实时查看 IO 状态、模拟量数值和轴信息。

3

## 功能说明

🔌

#### 多品牌 PLC 支持

支持西门子、三菱、欧姆龙、基恩士、松下、台达、汇川等主流 PLC。

📟

#### IO 实时监控

实时读取并显示 IO 输入/输出状态，支持分组管理和点位监控。

📊

#### 模拟量监控

支持 Int16、Float 等类型的模拟量数据读取与显示。

⚙️

#### 轴控制

支持伺服轴的参数显示。

📱

#### 手机扫码连接

同一局域网内，手机扫码即可远程监控 PLC 状态。

🔧

#### 通信调试

内置通信调试面板，可直接读取指定地址数据，快速排查问题。

📁

#### 多配置管理

支持创建、切换、复制、删除多个 PLC 配置档案。

🔊

#### IO 音效反馈

支持 9 种音效风格，IO 变化时播放提示音。

4

## 激活授权

### 🔑 激活流程

1

#### 获取设备 ID

菜单 → 关于 页面，复制 "本机唯一设备凭证 (ID)"。

2

#### 赞助并联系开发者

通过关于页面的微信/支付宝二维码赞助（￥99/永久），并将设备 ID 发送给开发者。

3

#### 输入激活码

收到密钥后，点击 "输入密钥激活应用" 按钮，粘贴密钥后点击确认即可完成激活。

⚠️
体验版限制：未激活状态下为体验版，30 分钟后数据读取将停止。激活后解锁永久离线使用，无任何功能限制。
📞
联系方式：
微信/电话：`17602350505`（易工）
QQ 交流群：`581765275`
5

## 手机扫码连接

### 📱 连接步骤

1

#### 确保网络相通

手机和运行 PocketIO 的电脑必须在同一局域网内（连接同一个路由器/Wi-Fi）。

2

#### 打开连接页面

菜单 → 连接，选择正确的网卡和 IP 地址，页面会生成二维码。

3

#### 手机扫码访问

使用手机浏览器扫描二维码（推荐 Edge 移动版），即可在手机上实时监控。

✅
小技巧：如果扫码无法访问，请检查电脑防火墙是否放行了 `90` 端口（或你自定义的端口）。可在 Windows 防火墙中添加入站规则。
6

## 常见问题

### ❓ 启动后浏览器没有自动打开？

手动打开浏览器，访问 `http://127.0.0.1:90`。如修改过端口，请使用对应端口号。

### ❓ 提示端口被占用怎么办？

修改程序目录下 `appsettings.json` 中的 `"Urls"` 字段，将端口号改为其他值（如 `http://*:8090`），重启程序。

### ❓ 连接 PLC 失败？

① 确认 PLC 的 IP 地址正确；② 确认电脑和 PLC 网络连通（可用 `ping` 命令测试）；③ 三菱 PLC 需确认端口号正确；④ 确认 PLC 通信协议与所选类型匹配。

### ❓ 手机扫码无法访问？

① 确认手机与电脑在同一局域网；② 检查 Windows 防火墙是否拦截；③ 确认 "连接" 页面选择了正确的网卡和 IP。

7

## 注意事项

🚫
浏览器兼容性：强烈推荐使用 Microsoft Edge 或 Google Chrome。华为浏览器存在长按弹出系统菜单的问题，会干扰 IO 操作，请勿使用。
⚠️
防火墙配置：首次启动时 Windows 可能弹出防火墙提示，请点击 "允许访问"。否则手机端将无法连接。若错过弹窗，可手动在 Windows Defender 防火墙 → 入站规则中放行 PocketIO。
⚠️
配置文件：PLC 配置存储于 `config/` 目录下，请勿手动修改 JSON 文件格式。如需备份，可直接复制整个 `config` 文件夹。
💡
激活绑定：每个激活码与设备 CPU ID 绑定，更换电脑需要重新获取激活码。请妥善保管您的激活密钥。
✅
性能建议：避免同时配置过多 IO 点（建议单配置不超过 2000 点），以保证刷新流畅度。如有大量点位需求，可使用分组功能分批查看。

### 📋 快速检查清单

检查项 | 状态
--- | ---
已安装 ASP.NET Core Runtime 8.0 | ☐
使用 Edge / Chrome 浏览器 | ☐
防火墙已放行 PocketIO 端口 | ☐
PLC 与电脑网络连通 | ☐
手机与电脑在同一局域网 | ☐
手机浏览器使用 Edge 移动版 | ☐