OPENCRAB / 文档与支持

接入前有准备,每一步有依据。

资料清单、接入说明与现场验证规则集中在这里。已经开始操作?可以直接打开操作指南。

产品下载

01

注册与企业空间

使用现有 OpenCrab 企业账号登录;尚未开通接入功能的企业,按页面提示提交开通申请。新企业在注册页填写企业信息与联系人,按审核和激活提示完成账号开通。

自己生产产品的企业填写生产厂家简称;仅做集成或代理的企业按实际业务填写。导入本企业产品前,请核对厂家信息。

  • 企业管理员:企业与成员管理、入库申请,以及授权范围内的接入工作。
  • 产品工程师:提交资料、确认产品、补充信息与现场测试。
  • 只读成员:查看资料、任务进度和产品。具体可操作项以账号权限为准。
02

接入资料清单

优先准备通信协议、命令表或寄存器表,再附产品说明书。宣传图片可以帮助了解外观,但无法代替通信资料。

  • 产品身份:厂家、型号、固件版本、按键与通道数量。
  • 通信参数:总线或无线方案、地址、波特率、校验方式、配网或入网步骤。
  • 协议定义:地址基准、数据类型、字节序、倍率、单位、数值范围与命令应答。
  • 功能反馈:哪些状态可以查询,哪些只提供事件或发送命令。
  • 测试材料:样机、供电与接线说明;有条件时提供请求、应答与主动上报样例。
03

产品确认与资料缺口

提交后核对平台整理的产品结构、功能数量和参数范围。资料冲突时,补充适用于该型号和固件版本的依据。

资料中没有的地址、命令或回读规则保持待确认。接入助手可以帮助整理回答,关键内容仍由你核对。

参照已有型号派生时,要确认同一协议与固件系列。型号差异和变化功能需要重新验证,不能直接沿用全部实测结论。

04

产品库与公开范围

产品按功能和参数组织,便于在项目中比较不同厂家型号。功能相似时,还需要比较电压、负载、安装条件、协议和验证范围。

产品库包含本企业的产品以及其他企业已公开的产品。对外公开需单独选择或申请;产品公开不等于开放原始协议资料和测试记录。

05

测试网关与现场验证

使用独立测试环境,把样机按接线说明连接到匹配的测试网关。在接入中心绑定网关后,再按任务提示开展验证。

  • 静默基线:先记录设备空闲时的周期上报。
  • 操作示教:按提示操作按键或传感器,同一功能采集两次并核对一致性。
  • 动作测试:继电器、阀门、电机等动作必须先确认现场条件。
  • 结果核实:区分“已发送”“协议已应答”“真实状态已确认”,没有回读证据时不写执行成功。
打开测试网关
06

入库、版本与项目使用

资料与参数补齐后,由有权限的成员申请入库。根据审核结果完成修正,再查看该型号的可用能力和验证状态。

需要更新产品时,通过接入任务建立并审核新版本。已安装现场设备的配置不能因产品资料更新而被静默改动。

用于 App、AI、场景与 Matter Bridge 的能力,以对应型号、版本和目标生态的验证结果为准。产品入库并不自动代表所有目标生态功能已验证。

常见问题

资料不完整,还能开始吗?

可以先整理已有资料和报文,明确缺口。平台会要求补充关键参数,或先评估适配;不会凭品类猜测协议。

产品入库后,就能进入所有生态吗?

需要分别确认设备现场接入、标准能力映射与目标生态支持情况,不能把入库当作全部功能通过验证。

可以先不连接真实设备吗?

可以先完成资料整理和产品定义。涉及实际控制、回读或示教的能力,仍需在测试环境完成验证。

公开产品,会公开我的协议资料吗?

产品公开范围与企业原始资料分开管理。确认公开字段后再申请,企业资料和测试记录遵循账号权限。

有账号但进不了接入中心怎么办?

先确认账号所属企业是否已开通接入,以及当前成员权限;按页面提示提交开通申请,或联系平台处理。

从一个型号开始

准备好接入第一款产品了吗?

已有企业账号可直接开始接入;新企业先注册,按平台提示完成开通。