主题
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）布局，包含以下标签：
- 基本信息：设备的基础信息
- 数据点：设备的实时数据和历史数据
- 历史数据：数据历史记录和图表
- 告警信息：设备相关的告警列表
- 自动化：设备的自动化规则配置
3.3.2 基本信息标签
设备信息卡片
显示设备的基本信息：
- 设备名称
- 设备编码
- 设备型号
- 产品名称
- 设备状态：在线/离线（标签显示）
- 所属网关：网关名称和 UID（可点击查看网关详情）
- 安装地址
- 区域信息：省/市/区
- 创建时间
- 最后心跳时间
权限说明：如果你没有
device:info:view权限，设备信息区域会显示"未授权"提示。
关联用户卡片
显示与设备关联的用户信息：
- 用户列表：显示有权限访问该设备的用户
- 用户角色：显示用户在设备上的角色
- 权限信息：显示用户对设备的权限
权限说明：需要
device:user:view权限才能查看。
设备位置卡片
- 地图显示：在地图上显示设备位置（如已设置地址）
- 地址信息：显示设备的详细地址
设备档案卡片
- 设备档案信息：设备的档案资料（如有）
3.3.3 数据点标签
权限要求：需要 device:data:view 权限
实时数据
显示设备的实时数据点：
- 数据点列表：显示所有数据点及其当前值
- 数据点类型：属性、事件、服务等
- 数据更新时间：最后更新时间
- 数据单位：数据的单位（如有）
数据点操作
- 刷新数据：点击刷新按钮更新实时数据
- 查看历史：点击数据点可查看历史数据（跳转到历史数据标签）
3.3.4 历史数据标签
权限要求：需要 device:data:view 权限
数据历史记录
- 选择数据点：从下拉列表选择要查看的数据点
- 选择时间范围：选择要查看的时间范围
- 数据图表：以图表形式展示数据变化趋势
- 数据表格：以表格形式展示详细数据
数据导出
- 支持导出历史数据为 Excel 或 CSV 格式
- 点击"导出"按钮选择格式
3.3.5 告警信息标签
权限要求：需要 device:alarm:view 权限
告警列表
显示设备相关的告警信息：
- 告警名称
- 告警级别：严重/警告/提示
- 告警状态：活跃/已解除
- 告警时间
- 告警描述
告警操作
- 查看详情：点击告警查看详细信息
- 处理告警：处理或确认告警（如有权限）
3.3.6 自动化标签
权限要求：需要 device:automation:view 权限
自动化规则
显示设备相关的自动化规则：
- 规则名称
- 触发条件
- 执行动作
- 规则状态：启用/禁用
自动化操作
- 新增规则：创建新的自动化规则（需要
device:automation:create权限） - 编辑规则：修改现有规则（需要
device:automation:edit权限） - 删除规则：删除规则（需要
device:automation:delete权限）
3.3.7 设备控制
权限要求：需要 device:control:command 权限
如果设备支持远程控制，可以在设备详情页面执行控制命令：
- 选择要执行的服务或命令
- 输入命令参数（如有）
- 点击"执行"发送命令
- 查看执行结果
注意：
- 只有在线设备才能执行控制命令
- 部分命令可能需要确认
- 命令执行结果会显示在操作记录中
3.3.8 操作记录
权限要求：需要 device:log:view 权限
点击页面右上角的 "操作记录" 按钮，可以查看设备的所有操作记录：
- 操作类型：新增、编辑、删除、控制等
- 操作人员：执行操作的用户
- 操作时间：操作发生的时间
- 操作详情：操作的详细内容
3.4 设备权限说明
设备管理功能采用细粒度的权限控制：
3.4.1 菜单权限
device:overview:view：查看设备总览device:list:view：查看设备列表
3.4.2 操作权限
device:info:create：新增设备device:info:edit：编辑设备device:info:delete：删除设备device:info:view：查看设备信息device:data:view：查看设备数据device:alarm:view：查看设备告警device:automation:view：查看自动化规则device:automation:create：创建自动化规则device:automation:edit：编辑自动化规则device:automation:delete：删除自动化规则device:control:command：执行设备控制命令device:log:view：查看操作记录device:user:view：查看关联用户
重要：如果你看不到某些功能或按钮，通常是权限未开通。请联系管理员开通相应权限。
3.5 常见问题
Q: 设备显示为离线，但实际在线？
A: 可能的原因：
- 设备心跳超时：检查设备的网络连接
- 网关离线：检查设备所属的网关是否在线
- 时间同步问题：检查系统时间是否准确
Q: 无法新增设备？
A: 检查：
- 是否有
device:info:create权限 - 是否选择了有效的产品型号和网关
- 设备编码是否已存在（需唯一）
Q: 看不到设备数据？
A: 检查：
- 是否有
device:data:view权限 - 设备是否在线
- 设备是否已上报数据
Q: 无法执行设备控制命令？
A: 检查：
- 是否有
device:control:command权限 - 设备是否在线
- 设备是否支持该控制命令
下一步：了解了设备管理后，可以学习 网关管理 来管理网关设备。