主题
3. 设备管理
设备管理是系统的核心功能模块，用于管理 IoT 设备，包括设备总览、设备列表、设备详情等。
3.1 设备总览
菜单路径：设备管理/设备总览
设备总览页面提供设备的整体统计和可视化展示。
3.1.1 统计信息
- 设备总数：系统中所有设备数量
- 在线设备数：当前在线的设备数量
- 离线设备数：当前离线的设备数量
- 告警设备数：当前有告警的设备数量
3.1.2 可视化展示
- 设备分布地图：在地图上显示设备位置和分布
- 设备状态图表：设备状态分布饼图或柱状图
- 设备趋势图：设备数量变化趋势
3.2 设备列表
菜单路径：设备管理/设备列表
设备列表是管理设备的主要入口，支持查看、搜索、筛选、新增、编辑、删除等操作。
3.2.1 视图模式
设备列表支持两种视图模式：
列表视图（默认）
以表格形式展示设备信息，包含以下列：
- 设备名称：设备的名称和别名
- 产品名称：设备所属的产品型号
- 设备标识符/条码：设备的唯一标识
- 网关：设备所属的网关
- 地址：设备的安装地址
- 状态：在线/离线状态（标签显示）
- 心跳时间：最后心跳时间
- 操作：编辑、删除等操作按钮
卡片视图
以卡片形式展示设备，每个卡片显示：
- 设备名称和别名
- 设备状态标签（在线/离线）
- 设备缩略图（如有）
- 产品名称
- 设备条码
- 所属网关
- 安装地址
- 最后心跳时间
切换视图：点击页面右上角的列表/卡片切换按钮。
3.2.2 搜索和筛选
搜索功能
在搜索框输入关键词，支持搜索：
- 设备名称
- 设备标识符/条码
- 产品名称
筛选功能
支持按以下条件筛选：
- 产品型号：选择特定产品型号
- 设备状态：在线/离线
- 所属网关：选择特定网关
- 区域：按省/市/区筛选
- 选择省份后，可进一步选择城市
- 选择城市后，可进一步选择区县
- 时间范围：按创建时间或心跳时间筛选
应用筛选：设置筛选条件后，点击"搜索"按钮应用筛选。
重置筛选：点击"重置"按钮清除所有筛选条件。
3.2.3 新增设备
权限要求：需要 device:info:create 权限
操作步骤：
- 点击页面右上角的 "新增" 按钮
- 在弹出的对话框中填写设备信息：
- 设备名称（必填）
- 产品型号（必填，从下拉列表选择）
- 设备标识符/条码（可选）
- 所属网关（必填，从下拉列表选择）
- 安装地址（可选）
- 区域信息（省/市/区，可选）
- 其他信息（根据产品型号可能有所不同）
- 点击"确认"保存设备
注意：
- 设备标识符/条码必须唯一
- 确保选择的网关在线且可用
- 部分字段可能根据产品型号动态显示
3.2.4 编辑设备
权限要求：需要 device:info:edit 权限
操作步骤：
- 在设备列表中，点击设备行的 "编辑" 按钮
- 在弹出的对话框中修改设备信息
- 点击"确认"保存修改
注意：部分字段（如设备标识符）可能不允许修改。
3.2.5 删除设备
权限要求：需要 device:info:delete 权限
单个删除
- 在设备列表中，点击设备行的 "删除" 按钮
- 确认删除操作
批量删除
- 勾选需要删除的设备（支持多选）
- 点击页面右上角的 "删除" 按钮
- 确认批量删除操作
警告：删除设备是不可逆操作，请谨慎操作。删除后，设备的历史数据可能也会被删除。
3.2.6 查看设备详情
方式一：点击设备列表中的设备行（整行可点击）
方式二：点击设备行的"详情"按钮（如有）
点击后会跳转到设备详情页面。
3.2.7 分页和排序
- 分页：列表支持分页，可调整每页显示数量
- 排序：部分列支持排序（点击列标题）
3.3 设备详情
访问方式：从设备列表点击设备进入详情页面
设备详情页面提供设备的完整信息和管理功能。
3.3.1 页面布局
设备详情页面采用标签页（Tabs）布局，包含以下标签（部分标签需相应设备级权限才可见）：
- 数据点：实时数据点列表（
device:datapoint:realtime） - 告警：设备活跃告警与历史（
device:alarm:active/device:alarm:history） - 历史曲线：数据点历史趋势（
device:datapoint:history） - 自动化：自动化规则配置（
device:automation:view） - 售后服务：维保合同与关联工单（需售后查看权限）
- 视频：关联摄像头预览（
device:video:view） - 设备面板：产品可视化控制面板（
device:panel:view，兼容旧码device:visualization:view）
页面顶部 基本信息区 展示设备信息、档案、位置、关联用户等卡片（分别受 device:info:view、device:profile:view 等权限控制）。
3.3.2 基本信息标签
设备信息卡片
显示设备的基本信息：
- 设备名称
- 设备标识符
- 设备型号
- 产品名称
- 设备状态：在线/离线（标签显示）
- 所属网关：网关名称和 UID（可点击查看网关详情）
- 安装地址
- 区域信息：省/市/区
- 创建时间
- 最后心跳时间
权限说明：如果你没有
device:info:view权限，设备信息区域会显示"未授权"提示。
关联用户卡片
显示与设备关联的用户信息：
- 用户列表：显示有权限访问该设备的用户
- 用户角色：显示用户在设备上的角色
- 权限信息：显示用户对设备的权限
权限说明：需要
device:user:view权限才能查看。
设备位置卡片
- 地图显示：在地图上显示设备位置（如已设置地址）
- 地址信息：显示设备的详细地址
设备档案卡片
- 设备档案信息：设备的档案资料（如有）
3.3.3 数据点标签
权限要求：需要 device:datapoint:realtime 权限
实时数据
显示设备的实时数据点：
- 数据点列表：显示所有数据点及其当前值
- 数据点类型：属性、事件、服务等
- 数据更新时间：最后更新时间
- 数据单位：数据的单位（如有）
数据点操作
- 刷新数据：点击刷新按钮更新实时数据
- 查看历史：点击数据点可查看历史数据（跳转到历史数据标签）
3.3.4 历史曲线标签
权限要求：需要 device:datapoint:history 权限
数据历史记录
- 选择数据点：从下拉列表选择要查看的数据点
- 选择时间范围：选择要查看的时间范围
- 数据图表：以图表形式展示数据变化趋势
- 数据表格：以表格形式展示详细数据
数据导出
- 支持导出历史数据（需
device:datapoint:export权限） - 点击「导出」按钮选择格式
3.3.5 告警信息标签
权限要求：查看活跃告警需 device:alarm:active；查看历史需 device:alarm:history
告警列表
显示设备相关的告警信息：
- 告警名称
- 告警级别：严重/警告/提示
- 告警状态：活跃/已解除
- 告警时间
- 告警描述
告警操作
- 查看详情：点击告警查看详细信息
- 确认/处理告警：需
device:alarm:acknowledge或device:alarm:handle权限
3.3.6 自动化标签
权限要求：查看需 device:automation:view；编辑需 device:automation:edit
自动化规则
显示设备相关的自动化规则：
- 规则名称
- 触发条件
- 执行动作
- 规则状态：启用/禁用
自动化操作
- 新增/编辑规则：需
device:automation:edit权限 - 启用/禁用规则：在规则列表中切换状态
3.3.7 设备面板
权限要求：需要 device:panel:view 权限（兼容旧码 device:visualization:view）
设备面板是产品对应的可视化控制界面，内嵌在设备详情页中，用于：
- 实时监控：查看设备当前运行状态与关键指标
- 远程操作：对支持的控制项进行点击操作（需
device:control:command等权限） - 贴牌展示：若已配置设备白标，面板可显示定制贴牌图
面板 模板与数据点映射 在 系统设置/产品型号 → 产品详情 → 设备面板配置 中维护，详见 设备面板配置。
说明：
3.3.8 设备控制
权限要求：需要 device:control:command 权限
如果设备支持远程控制，可以在设备详情页面执行控制命令：
- 选择要执行的服务或命令
- 输入命令参数（如有）
- 点击"执行"发送命令
- 查看执行结果
注意：
- 只有在线设备才能执行控制命令
- 部分命令可能需要确认
- 命令执行结果会显示在操作记录中
3.3.9 操作记录
权限要求：需要 device:log:view 权限
点击页面右上角的 "操作记录" 按钮，可以查看设备的所有操作记录：
- 操作类型：新增、编辑、删除、控制等
- 操作人员：执行操作的用户
- 操作时间：操作发生的时间
- 操作详情：操作的详细内容
3.4 设备白标
菜单路径：设备管理/设备白标
权限要求：查看需 device:whitelabel:view；管理模板需 device:whitelabel:manage；批量应用需 device:whitelabel:apply
设备白标用于管理设备面板贴牌图片模板，并批量将贴牌图写入设备档案，适用于 OEM/白标场景。
3.4.1 模板列表
模板列表显示所有白标模板，包含：
- 模板名称
- 关联产品：可绑定特定产品，也可作为通用模板
- 贴牌图片预览
- 状态：启用/禁用
- 备注
- 操作：编辑、删除、应用等
3.4.2 模板操作
新建模板
- 点击 「新建模板」
- 填写模板信息：
- 模板名称（必填）
- 贴牌图片（必填，支持 JPG、PNG 等）
- 关联产品（可选，不选则为通用模板）
- 备注（可选）
- 保存模板
编辑/删除模板
在列表中点击对应操作按钮。删除前请确认无设备正在使用该模板。
批量应用贴牌
- 在模板行点击 「应用」
- 按产品、网关或设备范围选择目标设备
- 确认后执行批量写入，系统会显示成功/失败统计
批量清除贴牌
- 点击 「清除贴牌」
- 选择目标设备范围
- 确认后清除设备档案中的贴牌图
3.5 设备权限说明
设备管理包含 系统菜单权限（控制能否进入设备列表等）和 设备级权限（控制单个设备详情页各 Tab 与操作，由设备角色分配）。以下列出常用权限点。
3.5.1 菜单权限
device:overview:view：查看设备总览device:list:view：查看设备列表device:whitelabel:view：查看设备白标
3.5.2 列表操作权限
device:info:create：新增设备device:info:edit：编辑设备device:info:delete：删除设备
3.5.3 设备详情权限（设备级，常用）
| 权限代码 | 说明 |
|---|---|
device:info:view | 查看设备基本信息 |
device:datapoint:realtime | 查看数据点实时数据 |
device:datapoint:history | 查看历史曲线 |
device:datapoint:export | 导出数据点数据 |
device:alarm:active | 查看活跃告警 |
device:alarm:history | 查看告警历史 |
device:automation:view | 查看自动化规则 |
device:automation:edit | 编辑自动化规则 |
device:panel:view | 查看设备面板 |
device:control:command | 远程控制命令 |
device:video:view | 查看设备视频 |
device:log:view | 查看操作记录 |
device:user:view | 查看关联用户 |
device:whitelabel:manage | 管理白标模板（菜单级） |
device:whitelabel:apply | 批量应用/清除贴牌（菜单级） |
重要：设备详情页的 Tab 由设备角色权限控制，与系统菜单权限独立。看不到某个 Tab 时，请联系管理员检查你在该设备上的角色权限。
3.6 常见问题
Q: 设备显示为离线，但实际在线？
A: 可能的原因：
- 设备心跳超时：检查设备的网络连接
- 网关离线：检查设备所属的网关是否在线
- 时间同步问题：检查系统时间是否准确
Q: 无法新增设备？
A: 检查：
- 是否有
device:info:create权限 - 是否选择了有效的产品型号和网关
- 设备标识符是否已存在（需唯一）
Q: 看不到设备数据或设备面板？
A: 检查：
- 是否有
device:datapoint:realtime（数据点）或device:panel:view（设备面板）等设备级权限 - 是否被分配了该设备的设备角色
- 设备是否在线、是否已上报数据
- 设备面板专项：设备是否已关联产品；产品详情是否已 配置设备面板模板；热泵类产品是否已保存数据点映射
Q: 无法执行设备控制命令？
A: 检查：
- 是否有
device:control:command权限 - 设备是否在线
- 设备是否支持该控制命令
更多跨模块问题见 常见问题索引。
下一步：了解了设备管理后，可以学习 网关管理 来管理网关设备。