VSM2.0视频告警模块详细设计说明书

1、VMS 2.0视频告警模块详细设计说明书文件状态：文件标识：V 草稿当前版本：1.0 正式发布所属产品VMS 2.0 正在修改作者：赵云完成日期：厂ent修订历史记录版本日期操作修订者说明1.007/12/2011A赵云初稿2.009/27/2011M蒋兴杰补充（A-添加，M-修改，D-删除）1. 引言4.1.1目的 41.2背景41.3范围42. 使用说明5.2.1需求概述52.2目标读者53. 功能说明5.3.1 VIDEOMON模块示意图 53.2功能概述63.3告警等级划分63.4告警策略73.5主线程流程图 74. 数据结构124.1全局变量 125. 接口说明135.1告警接口 1

2、35.2视频质量接口 145.3 MDI 接口 145.4 TR101290 接口 155.5内容层接口 151.引言1.1目的该模块主要接收VQMorService （分析视频质量模块）和CAnalyze Servie（内容层分析模块）发过来的视频质量参数，从而判断是否有视频流告警事件发生，如果有，则根据 告警策略处理告警事件。1.2背景IPTV使用MPEG TS传输码流在IP网络上承载和传送视频基本流（ES）, TS码流中包含了各种用于视频流解码所必须的信息内容。由于MPEG TS流的损伤会直接影响机顶盒的正常解码和视频质量，因此TS流的健康状况监测对保障IPTV用户体验质量十分重要。MD

3、I （ df和mlr ）、TR101290、静帧、彩条、马赛克等都是对视频流质量的监控本模块通过对告警划分等级，优先级高的告警抑制优先级低的告警，同时为了减少告警的频繁上报，采用了计数和抑制时间方法。1.3范围该文档对VMS 2.0视频告警模块的内容功能、数据结构和接口方面进行了详细描述， 供后继开发维护人员使用。CTtustNet赛特网科2. 使用说明2.1需求概述IPTV视频分析设备IPTV质量保障系统技术建议书2.2目标读者公司内部后继开发维护人员。3. 功能说明3.1 videomon 模块示意图CAnaljwSmiteServiceAPPIfigiadtF-diibr_d7-kl2S

4、etvive L iyeF i kSI i PTIMi%ner A&straci I iy (DA L) Ar!RAWDriverf HTTP 1DriverVMSfi蚪淞典国Videomon模块是一个独立进程，里面包含很多服务模块。Video Service:负责视频流的转发和 http通信。Alarm Service:负责接收视频质量参数，判断告警和视频录制功能。VQMon Service:负责接收视频流，产生视频质量参数。CAnalyze Service:负责接收Video Service转发的视频流，并产生内容层视频质量参数。DAccess Service:负责和QCS进行通信，还有下

5、发配置信息，比如频道信息。3.2功能概述本模块运行于 VSM2.0里面的（VideoMon ）模块中，VideoMon是一个独立的进程， 当VideoMon启动时，会自动加载 Alarm Servie模块。Alarm Service模块初始化的时候， 会注册两个线程，一个是视频质量接收线程，一个是检测断流线程（每隔5s检测一次）。视频质量接收线程，主要负责接收其它服务模块发过来的视频质量参数，然后对这些数据进行处理，比如（达标率统计，滑动窗口处理），判断是否有告警事件发生，如果有，则根据告警类型，获得相应的告警策略，处理告警事件。检测断流线程，主要定时检测（每隔5s检测一次）是否有频道断流事件

6、，判断断流的方法是（当前时间-上次窗口时间 3个滑动窗口时间），如果有断流时间发生，就发送断流告警给 DAccess Service模块。3.3告警类型传输层告警：DF、MLR、传输质量、编码质量内容层告警：静帧、黑屏、彩条、BLOCKNESS、语法错误、LOSS_CHROMA、LUMI、RGB、马赛克TR101290 告警断流告警以下是具体告警类型，红色为 1级告警，紫色为2级告警，蓝色为3级告警，其它待定=0,=0x00000001,=0x00000002,=0x00000004,=0x00000008,=0x00000010,=0x00000020,=0x00000040,=0x0000

7、0080,=0x00000100,=0x00000200,=0x00000400,=0x00000800,=0x00001000,=0x00002000,CHANNEL_ALARM_TYPE_UNKNOWCHANNEL_ALARM_TYPE_NOSTREAMCHANNEL_ALARM_TYPE_RECUR_STREAMCHANNEL_ALARM_TYPE_TRANS_ERRCHANNEL_ALARM_TYPE_MEDIARA TE_ASTATICISMCHANNEL_ALARM_TYPE_PAT_ERRCHANNEL_ALARM_TYPE_CONT_ERRCHANNEL_ALARM_TYPE_

8、PMT_ERRCHANNEL_ALARM_TYPE_PID_ERRCHANNEL_ALARM_TYPE_CRC_ERRCHANNEL_ALARM_TYPE_PCR_ERRCHANNEL_ALARM_TYPE_PTS_ERRCHANNEL_ALARM_TYPE_CAT_ERRCHANNEL_ALARM_TYPE_MDIDF_ERRCHANNEL_ALARM_TYPE_MDIMLR_ERR=0x00004000,=0x00008000,=0x00010000,=0x00020000,=0x00040000,=0x00080000,=0x00100000,=0x00200000,=0x0040000

9、0,=0x00800000,=0x01000000,=0x10000000,=0x80000000,=0xffffffffCHANNEL_ALARM_TYPE_FROZEN_FRAME CHANNEL_ALARM_TYPE_BLACK_SCREEN CHANNEL_ALARM_TYPE_COLOR_BAR CHANNEL_ALARM_TYPE_BLOCKNESS CHANNEL_ALARM_TYPE_UNICAST_START CHANNEL_ALARM_TYPE_UNICAST_END CHANNEL_ALARM_TYPE_SYNTAX_ERROR CHANNEL_ALARM_TYPE_LO

10、SS_CHROMA CHANNEL_ALARM_TYPE_LUMI_ERROR CHANNEL_ALARM_TYPE_RGB_ERROR CHANNEL_ALARM_TYPE_MOSAIC_ERROR CHANNEL_ALARM_TYPE_OTHER_CODEC_ERR CHANNEL_ALARM_TYPE_LAST CHANNEL_ALARM_TYPE_DEFAULT3.4告警策略告警主要采用以下几个策略：1：一种或者几种告警类型，可以配置成一种告警策略，告警策略里面可以配置告警否 录制，录制时长，告警抑制时间，告警抑制计数。2:不包含在告警策略里面的告警，组成一个默认告警策略3:告警恢复，

11、也是单独一种告警策略，用来恢复告警4:所有告警策略组成一个告警列表，某种告警通过告警列表，处理告警。3.5流程图3.5.1 MSG_NOTIFY_EXTERN 消息流程图初始i = 0 ;MSG_NOTIFY_EXTERN 消息里面会判断视频是否已经衰减和在衰减时间内，如果在,就衰减视频质量的 mos和codecQuant,否则就恢复ca_flag衰减标志和衰减时间。3.5.1 MSG_NOTIFY_EXTERN 消息流程图厂ent3.5.2 MSG_NOTIFY_TR101290 消息流程图NO3.5.2 MSG_NOTIFY_TR101290 消息流程图3.5.3 MSG_NOTIFY_C

12、A_QUAL 消息流程图MessageJStartJ1FGet StreamKeyNodeExsit?1rCreatNodetarNO1YESFGetNodeUseNum二SlideWin dowSize?NOYESYESGetAlarmType1r.-AlarmType=U nknow?SetDefaultAlarmTypeca_flag = FALSE?NOWeake nM OSa hn dCODECiSet ca_falg二TRUEYESMOSThreshHold?NOYESDoStategy3.5.3 MSG_NOTIFY_CA_QUAL 消息流程图备注：MSG_NOTIFY_EXTE

13、RN 消息里面会判断视频是否已经衰减和在衰减时间内，如果在,就衰减视频质量的 mos和codecQuant,否则就恢复ca_flag衰减标志和衰减时间。3.5.4告警策略流程图3.541告警策略流程图4. 数据结构4.1全局变量#defi ne MAX_VIDEO_RECORD_BUF_LEN2*1024*1024/ 2M typedef structbool isalarm;ACE_UINT32 alarm_level;ACE_UINT32 cou nt;time_ttime;time_tlasttime;VQMo nAlarm;typedef structACE_Thread_Mutex

14、mylock_;NotifSlideWi ndowCell n otifSWListSLIDE_WINDOW_SIZE;ACE_UINT32 sWCurPoi nter ;ACE_UINT32 sWUseNum ;time_t lastMetricsGetTime;time_t stattime;ACE_UINT32 exist; /stream flagVideoQualityNotif n otifVal;VQMo nStatisticstatI nfo;double lastMediaRate2;Tr101290 tr;bool isTRI nit;ACE_INET_Addr src_a

15、ddr_;ACE_INET_Addr dst_addr_;VQMo nAlarm alarmVQMON_ALARM_SIZE; / alarm array/ List list;ACE_HANDLE hfile;void *deliver;bool record_flag_;/绑定计数/视频录制开始时间ACE_UINT32 bi nd_count;time_t recode_start_time;ACE_TCHAR record_file_ name_MAX_FILENAME_LEN+1;/ 视频录制文件名称ACE_UINT32 positio n;/视频录制缓冲区位置ACE_TCHAR re

16、cord_bufMAX_VIDEO_RECORD_BUF_LEN+1; /视频录制缓冲区StreamNode;#defi ne ALARM_LEVEL11#defi ne ALARM_LEVEL22#defi ne ALARM_LEVEL33#defi ne ALARM_TYPE1(CHANNEL_ALARM_TYPE_MDIDF_ERR |CHANNEL_ALARM_TYPE_MDIMLR_ERR |CHANNEL_ALARM_TYPE_NOSTREAM)#defi ne ALARM_TYPE2(CHANNEL_ALARM_TYPE_FROZEN_FRAME| CHANNEL_ALARM_T

17、YPE_BLACK_SCREEN| CHANNEL_ALARM_TYPE_COLOR_BAR| CHANNEL_ALARM_TYPE_BLOCKNESS| CHANNEL_ALARM_TYPE_SYNTAX_ERROR| CHANNEL_ALARM_TYPE_LOSS_CHROMA| CHANNEL_ALARM_TYPE_LUMI_ERROR| CHANNEL_ALARM_TYPE_RGB_ERROR)#defi ne ALARM_TYPE3(CHANNEL_ALARM_TYPE_PAT_ERR | CHANNEL_ALARM_TYPE_PCR_ERR | CHANNEL_ALARM_TYPE

18、_PID_ERR | CHANNEL_ALARM_TYPE_PMT_ERR | CHANNEL_ALARM_TYPE_PTS_ERR | CHANNEL_ALARM_TYPE_CRC_ERR | CHANNEL_ALARM_TYPE_CONT_ERR | CHANNEL_ALARM_TYPE_CAT_ERR | CHANNEL_ALARM_TYPE_TRANS_ERR | CHANNEL_ALARM_TYPE_OTHER_CODEC_ERR)5.接口说明5.1告警接口class VM_Message_Alarm_Notify : public VM_Message_Notify public:

19、VM_Message_Alarm_Notify(i nt type =VM_Message_Notify:MSG_NOTIFY_ALARM);ACE_UINT32 alarm_type_;ACE_UINT16 is_alarm_;ACE_UINT16 alarm_level_;ACE_TCHAR alarm_time_MAX_TIME_FORMA T_LEN;ALARM_DESC alarm_desc_;bool record_flag_;ACE_TCHAR record_file_ name_MAX_FILENAME_LEN;5.2视频质量接口class VM_Message_Extern_

20、Notify : public VM_Message_Notifypublic:VM_Message_Extern_Notify(i nt type =VM_Message_Notify:MSG_NOTIFY_EXTERN);/ External quality.ACE_INT32 mos_;ACE_UINT32 vstq_;ACE_UINT32 codec_;float loss_rate_;float mdi_df_;float mdi_mlr_;float media_rate_;5.3 Mdi 接口class VM_Message_Mdi_Notify : public VM_Mess

21、age_Notifypublic:struct Mdi_Qualfloat df_;float mlr_;ACE_UINT32 mr_; / media rate；VM_Message_Mdi_Notify(i nt type =VM_Message_Notify:MSG_NOTIFY_MDI);/ Mdi quality.ACE_UINT32 qual_sec_num_;Mdi_Qual qual_;Mdi_Qual qual_sec_2 * CONFIG_QUALITY_CALCULATE_INTERVACE_UINT32 mlt15_;ACE_UINT32 mlt24_;ACE_UINT

22、32 pkts_recv_;ACE_UINT32 pkts_lost_;ACE_UINT32 pkts_ooseq_;5.4 Tr101290 接口class VM_Message_TR101290_Notify : public VM_Message_Notifypublic:VM_Message_TR101290_Notify(i nt type =VM_Message_Notify:MSG_NOTIFY_TR101290);/ Video/Audio TR101290.vqmon_streammetrics_mp2tstr101290P1_t mp2ts_tr101290p1_;vqmon_streammetrics_