jf-open-pro-smart-doorlock-control - 杰峰智能门锁设备控制技能（开发版）

技能描述

支持杰峰智能门锁设备的远程控制功能：

• 查询设备是否支持开锁 - 查询设备能力集，确认是否支持门锁功能
• 登录设备 - 对门锁设备进行登录认证
• 获取设备接口访问令牌 - 获取 deviceToken 用于后续操作
• 远程一键开锁 - 远程发送开锁指令，控制门锁开启

适用场景：

• 远程给家人或访客开锁
• 确认设备是否支持门锁功能
• 设备登录与令牌管理

触发词

• 查询设备是否支持开锁 / 设备支持门锁吗
• 查询门锁配置 / 获取门锁配置
• 远程开锁 / 一键开锁 / 开锁
• 登录设备 / 设备登录
• 获取设备 Token

前置条件

硬件要求

1. 智能门锁 - 设备需为杰峰智能门锁设备

必需配置

1. 签名算法 - 使用杰峰官方移位加密算法生成 signature
2. 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
3. 设备绑定 - 设备需先绑定到开放平台账号

环境变量

API 接口

核心功能

1. 查询设备是否支持开锁

API: POST /gwp/v3/rtc/device/getability/{deviceToken}

Name: DoorFunction

说明： 查询设备能力集，确认设备是否支持门锁功能及相关特性。

响应参数：

2. 获取门锁配置

API: POST /gwp/v3/rtc/device/doorLockTransparent/{deviceToken}

请求参数：

请求示例：

{
  "Name": "OPDoorLockProCmd",
  "OPDoorLockProCmd": {
    "Cmd": "GetDoorConfig"
  }
}

响应参数：

3. 登录设备

API: POST /gwp/v3/rtc/device/login/{deviceToken}

请求参数：

响应参数：

说明： 设备默认 1 分钟无操作自动断开连接，若需保持长时间连接可设置 KeepaliveTime 进行保活。

3. 获取设备接口访问令牌

API: POST /gwp/v3/rtc/device/token

说明： 获取 deviceToken，用于后续的门锁操作。Token 有效期 24 小时。

4. 远程一键开锁

API: POST /gwp/v3/rtc/device/doorLockRemoteUnlock/{deviceToken}

请求参数：

说明： 支持两种开锁方式。提供密码时使用密码开锁，不提供密码时使用无密码一键开锁。

使用示例

环境准备

# 设置环境变量（使用占位符，请替换为实际值）
export JF_UUID="uuidxxxx"
export JF_APP_KEY="appkeyxxxx"
export JF_APP_SECRET="appsecretxxxx"
export JF_MOVE_CARD="2"
export JF_DEVICE_SN="snxxx1"
export JF_DEVICE_TOKEN="NTQ0NzQ3YmE3MXwyYzFk..."
export JF_ENDPOINT="api-cn.jftechws.com"

1. 查询设备是否支持开锁

cd ~/.qoderwork/skills/jf-open-pro-smart-doorlock-control/scripts

python3 doorlock_control.py --action check-support

2. 获取门锁配置

python3 doorlock_control.py --action get-config

3. 登录设备

# 使用默认用户名 admin 登录
python3 doorlock_control.py --action login --username "admin" --password "123456"

# 设置保活时长为 10 分钟
python3 doorlock_control.py --action login --username "admin" --password "123456" --keepalive-time 600

4. 获取设备 Token

python3 doorlock_control.py --action get-token --device-sn "snxxx1"

5. 远程一键开锁

# 无密码一键开锁
python3 doorlock_control.py --action unlock

# 使用密码开锁
python3 doorlock_control.py --action unlock --password "123456"

状态码

平台状态码

设备状态码（Ret）

注意事项

1. 设备要求 - 仅智能门锁设备支持此功能
2. deviceToken 有效期 - 24 小时，过期需重新获取
3. 设备在线要求 - 远程开锁需要设备在线
4. 安全性 - 远程开锁涉及物理安全，请谨慎操作
5. 登录要求 - 部分设备可能需要先登录才能执行开锁操作

相关文件

参考文档

• 杰峰开放平台