设备注册

设备需要进行注册后才能认证接入希沃物联平台。注册分为静态注册和动态注册两种方式,具体区别见下文。

1 设备三元信息

设备三元信息为:产品Key,设备ID、设备密钥。

2 静态注册

指设备端无需调用注册服务接口向云端获取设备的三元信息。一般为云端通过手动添加或自动导入等方式将设备的三元信息预先添加到了希沃物联平台。

设备端在出厂时已经将三元信息存储到固件内,启动时从固件内读取到设备的三元信息,无须进行注册,即可连接到希沃物联平台。

3 动态注册

指云端没有设备的三元信息,设备需要通过注册服务接口获取自身的三元信息,才可以连接到希沃物联平台。

3.1 动态注册接口

  • 设备认证前通过注册服务接口获取到设备的三元信息(产品Key,设备ID、设备密钥)。

  • 设备动态注册时需要携带设备本地的唯一标识(如UID、SN等)以区分不同的设备,该标识在本地唯一且不可作改变。

3.1.1 SDK接口(C++)

  • 添加设备本地的唯一标识
    /**
    * @brief    添加设备的唯一标识符,存在多个标识唯一标识符可多次调用
    * @param    type   类型,默认有IDEN_ANDROID_SN等定义,也可自定义
    * @param    values 标识符值集(有多个时,如mac列表)
    *
    * @return   无
    */
    void AddIdentifier(const std::string &type, const std::list<std::string> &values);
  • 注册
    /**
    * @brief    设备注册
    * @param    [in]  product 产品认证信息
    * @param    [out] device  设备认证信息
    *
    * @return   true-成功 false-失败
    */
    bool DeviceRegister(const ProductAuth &product, DeviceAuth &device);

3.1.2 SDK接口(Android)

详见:设备SDK使用说明(Android)