研几科技 · 文档中心

Appearance

数据模型基础 ​

本文介绍研几 IoT 云平台的四个核心概念：组织、项目、设备和数据点。适合首次使用的用户阅读，无需技术背景。

为什么需要了解这些概念 ​

  • 随着设备规模扩大，保持数据有序管理。
  • 控制不同成员对数据的查看和编辑权限。
  • 传感器接入一次，数据即可在仪表盘、告警和导出中复用。

层级结构一览 ​

组织（Organization）
  └── 项目（Project）   — 按站点或场景划分
        └── 设备（Device）  — 每台网关或控制器对应一个设备
              └── 数据点（Point）  — 每个采集通道对应一个数据点

每条传感器数据都属于一个数据点，数据点挂载在设备下，设备属于项目，项目归属于组织。

组织 ​

  • 组织是你的公司或团队工作空间。
  • 每个用户可以属于一个或多个组织，组织管理员负责邀请成员和管理权限。
  • 组织级别的设置（如 Access Token、数据转发配置）对其下所有项目生效。

项目 ​

  • 项目是设备的逻辑容器，用于归组同一站点或业务场景下的设备（如「温室大棚 A」、「冷链仓储 3 号」）。
  • 用项目区分不同地点、客户或业务线的数据，避免混淆。
  • 每个项目有唯一的 project_id，出现在 URL 和 API 调用中。

设备 ​

  • 设备代表一台向云端发送数据的物理网关、控制器或传感器节点。
  • 每台设备有 serial_number（硬件序列号，印在设备上）和 agri_id（平台分配的字符串，用于 API 调用和数据路由）。
  • 设备归属于项目；将设备移至其他项目后，后续数据将出现在新项目中。

数据点 ​

  • 数据点是设备上的单个采集通道，例如：1 号通道采集温度、2 号通道采集湿度、继电器输出状态等。
  • 每个数据点对应一个 Modbus 寄存器（从站 ID + 寄存器地址），并定义原始寄存器值转换为工程单位的方式（通过 data_scale 和 data_delta）。
  • 数据点还携带类型（the_type），用于告知平台显示哪种图标、单位和告警逻辑。
  • 每个数据点有自己的 agri_id，格式如 d-1000-abcd-1-000，用于遥测上报和 API 路径。

数据流向（简要） ​

物理传感器
  → 设备读取 Modbus 寄存器
  → 网关将数据上报至研几 IoT 云
  → 平台通过 agri_id 匹配到对应数据点
  → 数据存储并显示在项目仪表盘
  → 可选转发至你自己的系统（MQTT、HTTP、InfluxDB 等）

典型配置步骤 ​

  1. 创建组织 — 你的工作空间，之后再邀请团队成员。
  2. 创建项目 — 每个站点或客户一个项目。
  3. 绑定设备 — 输入序列号和安全码，将硬件绑定到项目。
  4. 配置数据点 — 定义每个采集通道：寄存器地址、数据类型、缩放系数和名称。
  5. 查看数据 — 打开项目仪表盘，查看实时数据和历史记录。

新手使用建议 ​

  • 名称尽量简洁易读，如「北区网关」、「室内温度通道1」。
  • 每个物理站点使用一个项目，避免数据混淆。
  • 绑定设备后立即配置数据点，这样图表显示的是友好名称而非原始寄存器地址。
  • 想把数据推送到自己的系统？在组织设置中使用转发配置，创建 Webhook、MQTT 或数据库导出。

在哪里管理 ​

研几 IoT 云 Web 端：

  • 组织设置 → 成员权限、Access Token、转发配置。
  • 项目视图 → 设备列表、图表、告警规则、数据下载。
  • 设备详情 → 数据点列表、实时数据、历史记录、控制指令。

如需帮助，请发邮件至 hi@yengear.com。