接口字段定义

最新推荐文章于 2025-10-21 13:50:14 发布

原创最新推荐文章于 2025-10-21 13:50:14 发布 · 8k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#python #树莓派 #云服务器 #接口

智能家居框架专栏收录该内容

4 篇文章

订阅专栏

本文介绍了HTTP接口中用于设置（set）和获取（get）数据库状态的字段定义。设置指令通过`set?msg=instructions&type=number`传输，其中指令存储在Redis的1号库instructions_queue队列。获取状态则使用`get?msg=no`，设备状态存储在Redis的2号库中，定义了特定的命名规则。

HTTP 接口字段定义

格式

用来传输指令或者修改数据库状态
set?msg=instructions&type=number

用来获取数据库状态
get?msg=no

instructions 指令集
type 操作类型
no 设备编号[不传则返回所有状态]

所有 instructions 指令均在redis数据库1号库的 instructions_queue 队列中;

所有设备状态均在redis数据库2号库中命名规则见下表#define

define

设备代码

流通代码 : redis数据库命名       : 实际含义
    1   : light1            : 1号灯
    2   : light2            : 2号灯
    3   : light3            : 3号灯
    4   : door1             : 1号门
    5   : door2             : 2号门
    6   : infrared1         : 1号红外
    7   : infrared2         : 2号红外
    8   : infrared3         : 3号红外
    9   : music             : 音乐
    10  : camera            : 摄像头
    99  : all               : 所有设备

操作代码

    0   : 关闭
    1   : 打开

set

type

type == 1  # 此操作为写入操作， 主要是写状态到数据库
type == 2  # 此操作为推送操作， 主要是将指令推送到开发板

instructions

type == 1
发送格式: S~2~1~S
解释: S~S为内容封装，所有请求都存在这个格式
2 为设备代码 1 为打开状态

type == 2
发送格式: A~2~1~A
解释: A~A为内容封装，所有请求都存在这个格式
2 为设备代码 1 为打开操作

第一位 为设备代码
第二位 为 操作或状态

1: 开 / 触发
0: 关 / 停止

get

若不传no：
return : 1010001101
对应: 1:1号灯|2:2号灯|3:3号灯|4:1号门|5:2号门|6:1号红外|7:2号红外|8:3号红外|9:音乐|10:摄像头|11~16预留

若传no：
return : 1
对应相关设备状态