点位类型

点位类型用于告诉平台一个点位代表什么数据或控制对象，例如温度、湿度、GPS、开关、电机等。

平台会根据点位类型决定默认单位、图标、展示方式以及部分控制行为。

类型来源

平台支持两类点位类型：

类型	说明
共享点位类型	平台预定义，所有组织可用
组织点位类型	当前组织自定义，仅组织内可用

优先使用共享点位类型。只有共享类型无法表达业务含义时，再创建组织点位类型。

类型值

每个点位类型都有一个类型值。

类型范围	含义
1 - 999	平台共享类型
>= 1000	组织自定义类型

类型值用于数据展示、API 识别和外部系统集成。创建组织类型后，不建议频繁修改其含义。

常见类型分类

分类	示例
空气与气象	温度、湿度、气压、CO2、PM2.5、风速、风向、雨量、光照
土壤	土壤温度、土壤湿度、土壤 EC、土壤 pH、氮磷钾
水质	水温、溶解氧、浊度、电导率、盐度、pH、ORP、氨氮
环境风险	可燃气体、有毒气体、烟雾、明火
位置与姿态	GPS、速度、海拔、倾角、振动、液位
控制类	继电器、阀门、水泵、风机、电机、断路器
状态类	在线状态、运行模式、故障状态、计数状态

组织自定义类型

组织自定义类型适合以下情况：

• 业务中有特殊传感器，平台共享类型没有覆盖。
• 需要自定义单位、图标或名称。
• 需要让外部系统通过固定类型值识别业务数据。

创建自定义类型时，应填写：

字段	建议
中文名称	使用用户能理解的业务名称
英文名称	需要多语言或 API 对接时填写
单位	使用标准单位，如 ℃、%RH、ppm、m/s
值类型	根据数据格式选择 Float、Integer 等
图标	选择能表达点位含义的图标

【配图占位：创建组织点位类型弹窗截图】

使用建议

• 不要为同一种业务含义创建多个不同类型。
• 单位应与传感器说明书和数据换算结果一致。
• 控制类点位应选择控制类型，不要用普通传感器类型代替。
• 自定义类型创建后，应在团队内部保持命名和类型值稳定。