jf-open-pro-feed-control - 杰峰智能宠物喂食器设备控制技能（开发版）

技能描述

支持杰峰智能宠物喂食器设备的远程控制功能：

• 查询设备是否支持喂食 - 查询设备能力集，确认是否支持喂食功能
• 一键喂食 - 远程发送喂食指令，控制设备出粮
• 定时喂食计划 - 查询和设置设备的定时喂食计划
• 宠物检测 - 查询和设置设备端的宠物检测功能开关

适用场景：

• 远程给宠物喂食
• 设置定时自动喂食计划
• 配置宠物检测自动触发喂食

触发词

• 查询设备是否支持喂食 / 设备支持喂食吗
• 一键喂食 / 远程喂食 / 手动喂食 / 立即喂食
• 定时喂食计划 / 查询喂食计划 / 设置喂食计划
• 宠物检测开关 / 查询宠物检测 / 开启宠物检测 / 关闭宠物检测

前置条件

硬件要求

1. 智能宠物喂食器 - 设备需为杰峰智能宠物喂食器

必需配置

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

环境变量

API 接口

核心功能

1. 查询设备是否支持喂食（FeederAbility）

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

Name: FeederAbility

响应参数：

2. 一键喂食（Feed Control）

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

请求参数：

请求示例：

{
  "sn": "device-sn",
  "props": {
    "feed": 1
  }
}

3. 定时喂食计划（Feed Schedule）

查询/设置 API: POST /gwp/v3/rtc/device/iotPropSet/{deviceToken}

查询请求体：

{
  "sn": "设备序列号",
  "props": ["feedPlan"]
}

设置请求体：

{
  "sn": "设备序列号",
  "props": {
    "feedPlan": [
      {
        "enable": true,
        "cron": "0 31 10 * * 1,2,3,4,5,6,0",
        "action": {
          "feed": 1
        }
      }
    ]
  }
}

定时计划项（feedPlan）：

操作方法（method）：

4. 宠物检测开关（Pet Detection）

查询 API: POST /gwp/v3/rtc/device/petDetectionSwitchStatus/{deviceToken}

设置 API: POST /gwp/v3/rtc/device/petDetectionSwitchSetting/{deviceToken}

查询响应：

设置请求体：

{
  "Switch": "ON"
}

使用示例

环境准备

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

1. 查询设备是否支持喂食

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

python3 feed_control.py --action check-support

2. 一键喂食

# 喂食一次（默认 1 份）
python3 feed_control.py --action feed-once

# 喂食 2 份
python3 feed_control.py --action feed-once --portion 2

3. 定时喂食计划

# 查询当前定时喂食计划
python3 feed_control.py --action get-schedule

# 设置定时喂食计划（配置文件方式）
python3 feed_control.py --action set-schedule --schedule-file schedule.json

# 快速添加一条计划（每天 8:00 喂食 2 份）
python3 feed_control.py --action add-schedule \
  --hour 8 --minute 0 --portion 2 \
  --repeat "Mon,Tue,Wed,Thu,Fri,Sat,Sun"

4. 宠物检测

# 查询宠物检测开关状态
python3 feed_control.py --action get-pet-detect

# 开启宠物检测
python3 feed_control.py --action set-pet-detect --enable true

# 关闭宠物检测
python3 feed_control.py --action set-pet-detect --enable false

状态码

平台状态码

设备状态码（Ret）

注意事项

1. 设备要求 - 仅智能宠物喂食器设备支持此功能
2. deviceToken 有效期 - 24 小时，过期需重新获取
3. 设备在线要求 - 所有操作需要设备在线
4. 出粮份数 - 建议在设备支持的最小和最大份数范围内设置
5. 定时计划 - 最多支持 10 条定时计划
6. 重复周期 - 支持按星期重复，使用英文缩写：Mon, Tue, Wed, Thu, Fri, Sat, Sun

相关文件

参考文档

• 杰峰开放平台