一、 HTTP 协议 (GET 方法 )

1. 获取系统config参数

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=Camera.Menu.*

参数说明

参数 值
action get:获取
property 使用通配Camera.Menu.*类型获取系统config信息
value -

返回值

0
OK
Usage ./CGI_PROCESS.sh {no this parameter}
Camera.Menu.VideoRes=1080P30fps        //视频录像分辨率  Camera.Menu.LoopingVideo=1MIN    //视频分段 
Camera.Menu.GSensor=MID    //感应效果
Camera.Menu.FWversion=DY301    //固件版本号
Camera.Menu.SoundRecord=ON    //录音开关 
Camera.Menu.VideoQuality=NORMAL  //录音质量
Camera.Menu.ADAS=ON            //ADAS标定
Camera.Menu.WarningTone=ON     //警告音
Camera.Menu.DateLogoStamp=ON //时间水印开关 
Camera.Menu.SentinelMode=ON // 哨兵模式
0
OK

2. 获取设置列表(根据app需要选择是否取用 xml)

http://192.72.1.1:80/cdv/cammenu.xml

返回值

<?xml version="1.0"?>
<camera xmlns="urn:schemas-ait-dvr:device-1-0">
    ...
    ...
    ...
    <menu title="DateLogoStamp" id="DateLogoStamp">
    <!-- 时间水印 -->
    <item id="DATE">DATE</item>
    <item id="OFF">OFF</item>
    </menu>
    <menu title="SentinelMode" id="SentinelMode">
        <!-- 哨兵模式 -->
        <item id="ON">ON</item>
        <item id="OFF">OFF</item>
    </menu>
    <!-- 查看 wifi 信息、设置新的 ssid 和密码时 GET/SET 都是这两个字段 -->
    <menu title="WIFI SSID" id="Net.WIFI_AP.SSID">
    <!-- wifi ssid -->


    </menu>
    <menu title="WIFI PASSWD" id="Net.WIFI_AP.CryptoKey">
    <!-- wifi passwd -->


    </menu>
    <!-- 信息更新后重启 wifi 的指令:    action=set property=Net value=reset -->
    <menu title="TFCARD INFO" id="Camera.Menu.CardInfo.*">
    <!-- 显示 TF 卡容量 -->

    </menu>
    <menu title="FactoryReset" id="FactoryReset">
    <!-- 恢复出厂设置 -->

    </menu>
    <menu title="Version" id="FWversion">
    <!-- 固件版本号由编译生成，app 显示即可 -->

    </menu>
</camera>

备注: 返回 xml 内容，id 值对应设置项请求的 property

3. 获取系统状态

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=Camera.Preview.MJPEG.status.*

参数说明

参数 值
action get:获取
property 通配获取Camera.Preview.MJPEG.status.*系统状态
value -

返回值 

0
OK
Camera.Preview.MJPEG.status.record=Recording
Camera.Preview.MJPEG.status.MovieAudio=OFF
Camera.Preview.MJPEG.status.mode=Videomode
Camera.Preview.MJPEG.status.recordTime=10

备注: 此接口适用部分机型mode/MovieAudio接口在 32X/33X机器上未维护record：recording正在录制， standby停止录制

4.设置系统时间

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=TimeSettings&value=2021$03$29$09$44$53

参数说明

参数 值
action set:设置
property TimeSettings:设置系统时间
value 2021$03$29$09$44$53:设置的系统时间值

返回值

0
OK

5.获取 SD卡信息

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=Camera.Menu.CardInfo.*

参数说明

参数 值
action get:获取
property 通配Camera.Menu.CardInfo.*获取sd卡信息
value -

返回值

0
OK
Camera.Menu.CardInfo.LifeTimeTotal=29.8G 
Camera.Menu.CardInfo.RemainLifeTime=22.8G
0
OK

备注 :如上返回为 32G卡存储信息

6.停止/开始录像

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Video&value=recordoff

参数说明

参数 值
action set:设置
property video:视频录制
value recordoff:暂停录制，recordon:开始录制

返回值 

0
OK

7.设置录像分辨率（360P/720P/1080P）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Videores&value=720P30fps

参数说明

参数 值
action set:设置
property Videores:录像分辨率
value 360P30fps:360p 录像30fps，720P30fps:720p录像 30fps，1080P30fps:1080p录像 30fps

返回值 

0
OK

8.(操作 app)进入/退出设置界面

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Setting&value=enter

参数说明

参数 值
action set:设置
property setting:用户进入设置界面
value enter:进入设置，exit:退出设置

返回值

0
OK

备注: 通知设备 app进入设置界面，设备停止录像

8.设置视频分段（1分钟/3分钟/5分钟）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=LoopingVideo&value=3MIN

参数说明

参数 值
action set:设置
property LoopingVide:设置视频分段
value 3MIN:循环录像单个视频时长固定为 3分钟

返回值

0
OK

9.设置录像质量（一般/中等/较好）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=VideoQuality&value=NORAML

参数说明

参数 值
action set:设置
property VideoQuality:设置录像质量
value 一般:NORMAL/中等:FINE/较好:SUPERFINE

返回值

0
OK

10.设置录音开关

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=SoundRecord&value=OFF

参数说明

参数 值
action set:设置
property SoundRecord:录制声音
value OFF:关闭录音，ON:开启录音

返回值

0
OK

备注: 录音设置不同 app可能字段有差异，可以视情况做兼容

11.设置时间水印（开、关）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=DateLogoStamp&value=OFF

参数说明

参数 值
action set:设置
property DateLogoStamp:时间日期logo水印开关
value ON:打开水印 OFF:关闭水印

返回值

0
OK

12.设置ADAS标定（开、关）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=ADAS&value=ON

参数说明

参数 值
action set:设置
property ADAS:ADAS标定开关
value ON:打开OFF:关闭

返回值

0
OK

12.设置警报音（开关）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=WarningTone&value=OFF

参数说明

参数 值
action set:设置
property WarningTone:警报音开关
value ON:打开OFF:关闭

返回值

0
OK

13.设置感应效果（高/中/低）

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=GSensor&value=HIGH

参数说明

参数 值
action set:设置
property Gsensor:设置感应效果
value HIGH:高 MID: 中LOW: 低

返回值

0
OK

14.修改设备WiFi-Fi名称

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Net.WIFI_AP.SSID&value=Whost

参数说明

参数 值
action set:设置
property Net.WIFI_AP.SSID:设置 wifi名称
value Whost:设置新的wifi名称

返回值

0
OK

15.修改设备WiFi-Fi密码

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Net.WIFI_AP.CryptoKey&value=0987654321

参数说明

参数 值
action set:设置
property Net.WIFI_AP.CryptoKey:设置 wifi密码
value 0987654321:设置新的wifi密码

返回值

0
OK

16.重启wifi指令

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Net&value=reset

参数说明

参数 值
action set:设置
property Net:设置wifi
value reset:重启 wif

返回值

0
OK

17.格式化记录仪存储卡

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=SD0&value=format

参数说明

参数 值
action set:设置
property SD0:操作SD卡
value format:格式化 sd卡

返回值

0
OK

18.重置出厂设置

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=FactoryReset&value=FactoryReset

参数说明

参数 值
action set:设置
property FactoryReset:重置出厂设置
value FactoryReset:重置出厂设置

返回值

0
OK

备注: 重置出厂设置机器会自动重启

18.(操作app)进入/退出回放界面

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=Playback&value=enter

参数 值
action set:设置
property Playback:回放界面
value enter:进入回放界面，exit:离开回放界面

返回值

0
OK

备注: 离开回放界面会自动开启录像

18.获取文件列表

http://192.72.1.1:80/cgi-bin/Config.cgi?action=dir&property=Normal&format=all&count=20&from=0&backward=

参数说明

action dir:获取文件路径
property Normal:普通录像文件路径，(Normal/Event/Photo)
format all:通配路径下所有文件格式(包括.xxx隐藏文件)，并排序返回
count 当前指令希望获取的文件信息个数
from 从文件序号x开始返回文件信息
backward 向后计数

返回值

<?xml version="1.0" encoding="UTF-8" ?>
<Normal>
    <file>
    <name>/mnt/mmc/Normal/REC20210329-174127-0.ts</name>
    <format>ts</format>
    <size>81583916</size>
    <attr>RW</attr>
    <time>2021-03-29 17:42:26</time>
    </file>
    <file>
    <name>/mnt/mmc/Normal/.sstar.format</name>
    <format>format</format>
    <size>0</size>
    <attr>RW</attr>
    <time>2021-03-29 17:41:24</time>
    </file>
    <amount>2</amount>
</Normal>

备注:
Normal -> /mnt/mmc/Normal/xxxx.ts / 普通录像文件 /
Event -> /mnt/mmc/Event/xxxx.ts / 紧急录像文件 /
Photo -> /mnt/mmc/Photo/xxxx.jpg / 照片文件 / .xxx 文件建议 app 这边选择类型名过滤

19.获取 jpg文件

http://192.72.1.1:80/mnt/mmc/Photo/IMG20210329-175130-1.jpg

19. 获取 thumb缩略图文件

http://192.72.1.1/thumb/mnt/mmc/Normal/IMG20210329-175130-1.ts

20.获取视频文件(视频回放)

http://192.72.1.1/mnt/mmc/Normal/REC20210329-180518-19.ts |

21. 删除文件

http://192.72.1.1:80/cgi-bin/Config.cgi?action=del&property=$mnt$mmc$Normal$REC20210329-200350-137.ts

参数说明

action del:删除
property $mnt$mmc$Normal$REC20210329-200350-137.ts:需要删除文件的绝对路径
value -

返回值 

0
OK

备注:
Normal -> /mnt/mmc/Normal/xxxx.ts / 普通录像文件 /
Event -> /mnt/mmc/Event/xxxx.ts / 紧急录像文件 /
Photo -> /mnt/mmc/Photo/xxxx.jpg / 照片文件 /

22.记录仪升级接口

http://192.72.1.1/cgi-bin/FWupload.cgi

参数说明 | action | /UploadFile | | --- | --- |

返回值 

0
OK

备注: 必须用 post方式来请求，且 content-type必须为："multipart/form-data"

23. 获取设备支持功能集

功能集定义

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=Camera.Func

参数说明

参数 值
action get:获取
property Camera.Func
value -

返回值

0
OK
Camera.Func=wifiname:0;wifipwd:1;
0
OK

24. 获取设备硬件识别码

硬件识别码定义

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=Camera.Menu.FWversion

参数说明

参数 值
action get:获取
property Camera.Menu.FWversion
value -

返回值

0
OK
Camera.Menu.FWversion=MS;ms8339;LS01;JJ20302;00;Z2014B;xx;xx;XX:XX:XX:XX
0
OK

25. 获取设备wifi信息

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=AP.WiFI.INFO.*

参数说明

参数 值
action get:获取
property AP.WiFI.INFO.*
value -

返回值

0
OK
AP.WiFI.INFO.WifiName=wifi_xxxxx
AP.WiFI.INFO.WifiPassWord=12345678
0
OK

26. 切换到投屏模式

http://192.72.1.1:80/cgi-bin/Config.cgi?action=set&property=p2p&value=enter

参数说明

参数 值
action set:设置
property p2p
value enter:进入投屏模式

返回值

0
OK

27. 心跳

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=Camera.Menu.HeartBeat

返回值

0
OK

28. 轮胎信息

http://192.72.1.1:80/cgi-bin/Config.cgi?action=get&property=TireInfo

返回值

0
OK
TireInfo.Pressure.Front=5.2
TireInfo.Pressure.Back=3.2
TireInfo.Temp.Front=30
TireInfo.Temp.Back=30
0
OK

备注：
胎压固定返回单位bar，温度固定返回摄氏度，方便做国际化换算

二、设备主动上报（socket）

1.tcp socket连接

tcp port: 2020

上报内容： {key}={value}

VideoRecord=ON/OFF
SoundRecord=ON/OFF
...

备注： socket上报一次上报一条数据

1.1 adas信息

ADAS={
     "appWarn": 0, // 是否需要app发出报警声 0 不需要，1 需要
     "fcw": 0, // 前车碰撞告警 0 正常 >=1 报警
     "pcw": 0, // 行人碰撞告警 0 正常 >=1 报警
     "ldw": 0, // 车道偏离告警 0 正常 >=1 报警
     "fmw": 0, // 是否前车启步 0 正常 >=1 前车起步
     "vds": [ // 车距显示列表
         {
             "value": 5, // 车距 单位m
             "x": 25,  // 左上角坐标点x
             "y": 25,  // 左上角坐标点y
             "w": 16,  // 宽
             "h": 12   // 高
         },
         {
             "value": 5, // 车距 单位m
             "x": 25,  // 左上角坐标点x
             "y": 25,  // 左上角坐标点y
             "w": 16,  // 宽
             "h": 12   // 高
         },
     ],
     "lane": ["1012,916","1546,916","2246,1438","312,1438"]  // 车道线坐标数组，左上解起点，顺时针，首尾相接
 }

备注： adas数据为一行内容，示例为方便阅读做了换行展示

Copyright © 智阳软件 2023修订时间： 2025-04-03 14:24:20

results matching ""

    No results matching ""