IP/WIRELES CAMERA CGI 命令手册
修改时间
修改内容
2016-03-25
在/decoder_control.cgi?command=，增加了 62~77 用于删除对应的
1 到 16 号预置位
2016-04-06
增加了透传协议中 2100 协议，用于宠物喂食器的定制
2016-04-23
增加了报警联动预置位和看守位的协议到文档
2016-04-23
增加了隐私位协议到文档
2016-05-09
增加了控制开锁的协议到文档，定制客户 XALYDZ 开锁使用
2016-05-16
增加了透传协议 2002、2003 协议中，0x0C 智能锁、0x0D 水浸探
头。
2016-05-16
修改控制开锁协议，增加开锁密码的传入验证
2016-05-16
增加了修改智能锁开锁密码的协议
2016-05-19
由于 0x0C 被用于防区报警，智能锁类型改为 0x0D，水浸探头改
为 0x0E
2016-05-27
把 C7833-x4 的变焦相关协议文档化
2016-05-30
把 record_chnl 字段加到 set_record.cgi 归入文档
2016-06-01
get_status.cgi 中的 externwifi 定义为 1 为有线，2 为无线，0 为未知
2016-06-27
增加获取畸变校正参数当前的状态
2016-08-16
增加了 check_user.cgi 的返回 current_users 当前在线数，
max_support_users 支持最大数，当前数超在线数，APP 提示
2016-08-16
增加了透传协议中 2005、2006 的 rzi 高级场景
2016-08-16
增加了 get_factory_param.cgi 中 alarmcenter_conf 字段，返回 0 表示
接警中心功能出厂关闭，返回 1 表示接警中心功能出厂开启。
2016-08-16
增加了 set_factory_param.cgi 中 alarmcenter_conf 字段，0 为关闭接
警中心，1 为开启接警中心。
一、简介
本文所列出的 cgi 是 ip camera 提供的一套与客户端进行通讯的协议子集；CGI 可以通过
2 种途径使用本文 CGI 进行通讯：一种是基于 HTTP，另外一种基于 P2P；基于 HTTP 的客户
端程序（可以是 web 浏览器上运行的网页或者其他的应用程序）可以通过 cgi 对设备进行各
种操作。基于 P2P 的客户端程序，使用我们提供的 SDK 之后可以进行通讯，SDK 包
含:Android/ios/windows 等三种 SDK。
1、CGI 的安全认证：
cgi 分为三种权限认证:
1>是 HTTP 的 Basic 认证方法，这种认证方法更多是 get 相关参数的 cgi；
2>认证方法是通过 CGI 带入用户及密码的方法，这种主要是 set 相关的 cgi；
3>支持 HTTPS 进行认证<部份机器支持>
2、POST 相关 CGI：
POST 的 CGI 是指 cgi 用 HTTP 的 post 方法。
使用 POST 的 CGI 只 有 两 个 升 级 的 CGI 供 使 用 ： upgrade_firmware.cgi 和
upgrade_htmls.cgi
Post 示例：
<form action=”upgrade_firmware.cgi?next_url=mail.htm” method=”post”
enctype=”multipart/form-data”> <input type=”file” name=”file” size=”20”> </form>
3、GET 相关 CGI：
获取设备状态和参数的 cgi，包括 get_status.cgi 和 get_params.cgi。它们返回包括设备状态
或参数的文本，具体格式类似 javascript 中的变量定义，将每个状态或参数定义为一个变量并
返回，如：
var alias="IPCAM";
var sys_ver="Apr 28 2011 00:18:03";
var id="00000000031729";
4、SET 相关 CGI：
进行配置设备参数的 cgi,每个 cgi 所需要的权限不一样。如：
http://ip:port/set_alias.cgi?loginuse=admin&loginpas=&alias=hdipcam
5、媒体流相关 CGI：
进行配置设备参数的 cgi,每个 cgi 所需要的权限不一样。 如：
http://ip:port/videostream.cgi?user=admin&pwd=
6、搜索协议：在局域网内查找相关的设备，请直接联系深圳市威视达康科技有限公司。
7、厂家及生产相关参数生产工具相关配置及对应版本号校难，请直接联系深圳市威视达康科
技有限公司
一、GET 相关 CGI
get_status.cgi：
功能：获取设备状态
权限要求：管理者
语法：/get_status.cgi[?user=&pwd=&loginuse=&loginpas=]
返回：
alias:表示设备别名，最大为 32 位
deviceid:设备 UID，最大 为 32 位
sys_ver:系统固件版本号
app_version:界面固件版本号
oem_id:OEM 客户代码
now:从 1970-1-1 0:0:0 到设备的当前时间所流逝的秒数。
alarm_status: 设备当前状态：
0 ->无报警；
1 ->移动监测报警；
2 ->输入报警
3 ->传感器报警
upnp_status：
当设备为 C7838-AR 时
deviceType：2138546911
其它设备，upnp 状态：
1->成功
255->失败
dnsenable：表示第三方 dns 是否启用：
0->未启用
1->启用
osdenable:表示 OSD 打开与否：
0->未启用
1->启用
syswifi_mode:表示系统 WIFI 状态：（没用参数）
0->Station 模式
1->AP 模式
mac: 有线 MAC 地址
wifimac: 无线 MAC 地址
sdstatus: TF 录像卡状态
record_sd_status:TF 录像卡状态
0->表示 TF 卡没有插入
1->SD 卡己经挂载
2->正在录像
3->TF 卡文件系统错误
4->TF 卡格式化之中
5->TF 卡没挂载
internet:网络状态
0->表示设备未连接到 internet
1->表示设备己经连接到 internet
p2pstatus:P2P 连接状态
0->表示设备心跳未到达到 P2P 服务器
1->表示设备心跳有到达到 P2P 服务器
devicetype:出厂定义设备功能类型，未使用
devicesubtype:出厂定义设备功能子类型，未使用
externwifi: 0->未知状态 1->有线状态 2->无线状态
encrypt:加密效验
0->加密校验成功
1->加密校验不成功
under:是否欠费，未使用
0->表示设备正常工作
1->表示此设备己经欠费
sdtotal:TF 卡总容量 MB
sdfree:TF 卡剩余容量
sdlevel:TF 卡剩余容量
audio_encoder_mode:
adpcm0 -> 设备端监听是否返回索引清零的音频数据
adpcm1 -> 设备端监听是否返回索引不清零的音频数据
get_params.cgi
功能：获取设备参数
权限要求：管理者
语法：/get_params.cgi[?user=&pwd=&loginuse=&loginpas=]
返回：
时间组参数
now
从 1970 过去的秒数
tz
设备当前时区设置和标准格林威治时间偏离的秒数
ntp_enable
0：禁止 ntp 校时
1：允许 ntp 校时
ntp_svr
NTP 服务器
网络参数组
dhcpen
0：关闭 DHCP
1：开启 DHCP
ip
摄像机 ip 地址
mask
摄像机子网掩码
gateway
摄像机网关
dns1
摄像机第一 dns 服务器
dns2
摄像机第二 dns 服务器
port
摄像机 HTTP 端口
多路设备相关参数
dev2_alias
第二路设备别名
dev2_host
第二路设备地址
dev2_port
第二路设备 HTTP 端口
dev2_user
第二路设备访问用户
dev2_pwd
第二路设备访问密码
……….
……….
dev9_alias
第九路设备别名
dev9_host
第九路设备地址
dev9_port
第九路设备 HTTP 端口
dev9_user
第九路设备访问用户
dev9_pwd
第九路设备访问密码
<以下参数需要管理者权限>
用户组
user1_name
用户名<访客>
user1_pwd
访客密码<访客>
user2_name
用户名<操作者>
user2_pwd
密码<操作者>
user3_name
用户名<管理者>
