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
用户名<管理者>