下载文档原格式
海康威视DS-4000HC、HCS、HC+、HF、MD系列板卡SDK说明书(For Windows 2000/XP)Version 4.22006-07-26目录1.板卡介绍篇 (5)2.SDK版本更新说明篇 (6)3.SDK数据类型及数据结构定义篇 (13)4.SDK使用的错误代号定义及说明篇 (15)5.SDK函数篇 (16)5.1 API函数调用顺序 (16)5.2板卡初始化及卸载 (18)5001. 初始化DSP：InitDSPs() (18)5002. 卸载DSP：DeInitDSPs() (18)5.3通道打开及关闭 (18)5003. 打开通道：ChannelOpen() (18)5004. 关闭通道：ChannelClose() (18)5.4取得板卡相关信息 (18)5005. 获取总的编码通道个数：GetTotalChannels() (18)5006. 获取系统内正确安装的编码通道个数：GetTotalDSPs() (19)5007. 获取系统中板卡的个数：GetBoardCount() (19)5008. 获取系统中DSP个数：GetDspCount() (19)5009. 获取板卡的详细信息：GetBoardDetail() (19)5010. 获取DSP的详细信息：GetDspDetail() (19)5011. 获取系统中所有的编码通道个数：GetEncodeChannelCount() (20)5012. 获取系统中所有的解码通道个数：GetDecodeChannelCount() (20)5013. 获取系统中所有显示通道(视频输出)个数：GetDisplayChannelCount() (20)5014. 获取板卡的型号和序列号：GetBoardInfo() (20)5015. 获取板卡的特殊功能信息：GetCapability() (21)5.5设置视频预览模式及启停视频预览 (21)5016. 设置视频预览模式：SetPreviewOverlayMode() (21)5017. 启动视频图像预览：StartVideoPreview() (22)5018. 停止视频图像预览：StopVideoPreview() (22)5.6设置及获取视频参数 (22)5019. 设置视频参数：SetVideoPara() (22)5020. 获取视频参数：GetVideoPara() (22)5.7获取SDK信息 (23)5021. 获取SDK版本号：GetSDKVersion() (23)5022. 获取SDK及DSP错误报告：GetLastErrorNum() (23)5.8设置及获取编码流类型 (23)5023. 设置主通道编码流类型：SetStreamType() (23)5024. 获取主通道编码流类型：GetStreamType() (23)5025. 设置子通道编码流类型：SetSubStreamType() (24)5026. 获取子通道编码流类型：GetSubStreamType () (24)5.9启动及停止录像 (24)5027. 启动主通道数据截取：StartVideoCapture() (24)5028. 停止主通道数据截取：StopVideoCapture() (24)5029. 启动子通道数据截取：StartSubVideoCapture() (24)5030. 停止子通道数据截取：StopSubVideoCapture() (24)5.10编码数据流的读取 (25)5031. 注册数据流直接读取回调：RegisterStreamDirectReadCallback() (25)5032. 设定读消息阀值：SetupNotifyThreshold() (25)5033. 注册读取码流消息函数：RegisterMessageNotifyHandle() (25)5034. 读取音视频数据流函数：ReadStreamData() (25)5035. 另一个注册数据流读取函数：RegisterStreamReadCallback() (26)5.11设置编码图像质量及编码帧结构、帧率 (26)5036. 设置图像质量：SetDefaultQuant() (26)5037. 设置编码帧结构、帧率：SetIBPMode() (26)5.12设置编码的分辨率格式 (27)5038. 设置主通道的编码分辨率格式：SetEncoderPictureFormat() (27)5039. 设置子通道的编码分辨率格式：SetSubEncoderPictureFormat() (27)5.13设置码流及码流控制模式 (27)5040. 设置码流的最大比特率：SetupBitrateControl() (27)5041. 设置码流控制模式：SetBitrateControlMode() (27)5.14设置Overlay关键色及恢复Overlay表面 (28)5042. 设置Overlay关键色：SetOverlayColorKey() (28)5043. 恢复Overlay表面：RestoreOverlay() (28)5.15设置及获取视频信号制式、状况、视频信号输入位置调整 (28)5044. 设置视频标准：SetVideoStandard() (28)5045. 设置默认的视频制式：SetDefaultVideoStandard() (28)5046. 设置视频信号的灵敏度：SetVideoDetectPrecision() (28)5047. 获取视频信号输入情况：GetVideoSignal() (29)5048. 调整视频信号输入位置：SetInputVideoPosition() (29)5.16设置OSD、LOGO及视频遮挡 (29)5049. 设置OSD显示模式：SetOsdDisplayMode() (29)5050. 设置OSD显示模式(扩展)：SetOsdDisplayModeEx () (30)5051. 设置OSD显示与否：SetOsd() (31)5052. 设置OSD时间(用于网络校时)：SetupDateTime() (31)5053. 将24位bmp 文件转成yuv格式的数据：LoadYUVFromBmpFile() (31)5054. 设置LOGO图像位置及数据：SetLogo() (32)5055. 设置LOGO显示模式：SetLogoDisplayMode() (32)5056. 停止LOGO显示：StopLogo() (32)5057. 设置屏幕遮挡：SetupMask() (32)5058. 停止屏幕遮挡：StopMask() (32)5.17 Offscreen方式预览时的画图回调函数 (33)5059. 注册画图回调函数：RegisterDrawFun() (33)5060. 停止画图回调函数：StopRegisterDrawFun() (33)5.18移动侦测 (33)5061. 设置移动侦测灵敏度：AdjustMotionDetectPrecision() (33)5062. 设置移动侦测区域及个数：SetupMotionDetection() (34)5063. 启动移动侦测：StartMotionDetection() (34)5064. 移动侦测分析：MotionAnalyzer() (34)5065. 停止移动侦测：StopMotionDetection() (34)5066. 设置移动侦测(扩展)：SetupMotionDetectionEx() (34)5.19设置现场音频监听及获取现场声音音量幅度 (35)5067. 设置现场声音监听与否：SetAudioPreview() (35)5068. 获取现场声音音量幅度：GetSoundLevel() (36)5.20启动及停止获取原始图像数据流 (36)5069. 注册获取原始图像数据流的回调函数：RegisterImageStreamCallback() (36)5070. 启动及停止获取原始图像数据流：SetImageStream() (36)5.21抓图及图像保存函数 (36)5071. 获取原始图像：GetOriginalImage() (36)5072. 图像保存：SaveYUVToBmpFile() (37)5073. 抓取JPEG格式图像：GetJpegImage() (37)5.22 双编码 (37)5074. 主通道及子通道的切换：SetupSubChannel() (37)5075. 获取双编码时的数据流类型：GetSubChannelStreamType() (37)5.23获取帧统计信息 (38)5076. 获取帧统计信息：GetFramesStatistics() (38)5.24强制设定I帧 (38)5077. 强制设定I帧：CaptureIFrame() (38)5.25设置反隔行变换及强度 (38)5078. 设置反隔行变换与否及反隔行强度：SetDeInterlace() (38)5.26复位DSP (39)5079. 复位DSP：ResetDSP () (39)5.27 设置看门狗 (39)5080. 设置看门狗：SetWatchDog() (39)5.28 MD卡：设置视频输出通道的视频制式 (39)5081. 设置视频输出通道的视频制式：SetDisplayStandard() (39)5.29 MD卡：设置、改变、填充、清空显示区域 (40)5082. 设置显示通道的区域个数及参数：SetDisplayRegion() (40)5083. 改变某个显示区域的位置：SetDisplayRegionPosition() (40)5084. 用自定义的图像填充显示区域：FillDisplayRegion() (41)5085. 清空显示区域：ClearDisplayRegion() (41)5.30 MD卡：设置编码通道的视频外部输出（矩阵输出） (41)5086. 设置编码通道的视频外部输出(矩阵输出）：SetEncoderVideoExtOutput() (41)5.31 MD卡：设置解码音视频输出 (42)5087. 设置解码通道的音频输出：SetDecoderAudioOutput() (42)5088. 设置解码通道的视频输出(MD卡内部输出)：SetDecoderVideoOutput() (42)5089. 设置解码通道的视频外部输出(矩阵输出）：SetDecoderVideoExtOutput() (42)5.32 码流CRC校验 (43)5090. 设置主通道的CRC校验：SetChannelStreamCRC () (43)5091. 设置子通道的CRC校验：SetSubChannelStreamCRC () (43)1.板卡介绍篇海康威视DS-4000HC是面向数字监控行业而推出的专用板卡，采用了高性能的视频压缩技术标准H.264及OggV orbis(相当于G.722)的音频编码标准，完全依靠硬件实现了视频及音频的实时编码（CIF格式25帧PAL / 30帧NTSC）并精确同步，实现了动态码率、可控帧率、帧模式选择、动态图像质量控制，音频预览、视频丢失报警、能独立调整各通道参数，性能稳定而且可靠。
DS4000存储操作手册版本 v1.2 final二〇〇八年十二月神州数码 (中国技有限公司文档控制更改记录版本创建 /修改时间编制 /修改者文件 /修改内容审批人贾志锋创建文档贾志锋调整扩容部分内容审阅姓名职位发布姓名职位目录目录 ........................................................................................................................................... .......3 1. DS4000概述 ......................................................................................................................5 1.1、DS4000产品介绍 ...............................................................................................5 1.1.1、IBM System storage server DS4200 Express..................................5 1.1.2、 IBM System storage server DS4700 Express..................................5 1.1.3、 IBM System storageDS4800 storage server..................................6 1.2、 DS4000硬件介绍 ...............................................................................................6 1.2.1、 DS4700 硬件 ...........................................................................................6 1.2.1.1、 DS4700 前视图 ............................................................................6 1.2.1.2、 DS4700-70A 后视图 ...................................................................7 1.2.1.3、 DS4700-72A 后视图 ...................................................................7 1.2.2、 DS4800 硬件 ...........................................................................................8 1.2.2.1、 DS4800 前视图 ............................................................................8 1.2.2.2、 DS4800 后视图 ............................................................................8 1.2.3、 EXP810扩展柜 .........................................................................................9 1.2.3.1、 EXP810前视图 (9)1.2.3.2、 EXP810后视图 (10)2. DS4000配置管理 ............................................................................................................10 2.1、 DS4000管理概述 .............................................................................................10 2.2、安装DS4000 Storage Manager....................................................................12 2.3、对DS4000存储进行管理 .................................................................................14 2.3.1、 DS4000存储服务器基本概念 ..............................................................14 2.3.2、开始使用DS4000 Storage Manager.................................................15 2.3.2.1、准备安装,配置管理客户端 .......................................................16 2.3.2.2、双击DS4700,管理DS4700存储服务器 ................................17 2.3.2.3、使用存储分区 ...............................................................................20 2.3.2.4、在AIX系统中识别磁盘 ................................................................24 2.3.3、安装主机端RDAC ...................................................................................24 2.3.3.1、 AIX操作系统 ................................................................................24 2.3.3.2、 Windows操作系统 (26)2.3.3.3、 Linux操作系统 (26)3. DS4000扩展柜连接 ........................................................................................................27 3.1、 DS4700扩展柜连接 .........................................................................................27 3.1.1、一个DS4700连接一个存储扩展柜 ......................................................27 3.1.2、一个DS4700连接两个存储扩展柜 (28)3.1.3、一个DS4700连接三个存储扩展柜 (28)3.1.4、一个DS4700连接四个存储扩展柜 ......................................................29 3.1.5、一个DS4700连接六个存储扩展柜 ......................................................29 3.2、 DS4800扩展柜连接 .........................................................................................29 3.2.1、一个DS4800连接一个存储扩展柜 ......................................................30 3.2.2、一个DS4800连接两个存储扩展柜 ......................................................30 3.2.3、一个DS4800连接四个存储扩展柜 ......................................................31 3.2.4、一个DS4800连接八个存储扩展柜 (32)3.2.5、一个DS4800连接十四个存储扩展柜 (32)4. DS4000扩容 ....................................................................................................................33 4.1、添加硬盘 . (33)4.2、添加扩展柜 (34)5. 微码升级 (37)1.DS4000概述IBM TotalStorage DS4000存储服务器是一种为多种工业应用提供高可用性、高性能的存储解决方案而设计的存储服务器。
DS4000存储安装手册安装前根据需要准备以下内容：1、Controller firmware2、ESM & HDD firmware3、Storage Manager4、FAStT HBA BIOS5、FAStT HBA Drivers6、FC 8 - Brocade BootCode/BIOS7、FC 8 - Brocade Drivers8、FC 8/4/2 - Emulex BIOS9、FC 8/4/2 - Emulex Drivers10、FC 8/4/2 - QLogic BIOS11、FC 8/4/2 - QLogic Drivers12、Tools下载链接：/systems/support/>选择“System Storage”>选择“Disk System”>选择相应的存储设备型号>在选项右侧“Support & Downloads”栏中选择“Download”>新的页面中包含以上列出的项目下载列表Notes：DS4000可以被AIX V5.1 ML09版本支持；DS4000可以被HACMP V4.4.1版本支持。
DS4000的管理方式1、Host agent (in-band) management method这种管理方式需要在服务器端安装Storage Manager agent (SMagent) package，即存储管理软件，通过Fibre Channel I/O path连接。
2、Direct (out-of-band) management method这种管理方式需要在Mangement Workstation端安装存储管理软件，并通过IP网络与存储控制器连接。
NOTES：本文档主要在Direct (out-of-band)方式和AIX & Windows环境下做描述，其他OS下的配置请参考IBM相关REDBOOKS。
DS4000 DS5000热备盘配置方法对于Stoarage Manager 10，定义热备盘有两种方法：自动分配(Automatic assign)和手工分配(Manua l assign)。
注意：1)从Storage Manager 10.10开始，全局热备盘不再有数量限制。
2)热备盘的容量要大于或等于存储子系统中其他磁盘的容量3)在包含大量磁盘的配置中，由于重建时间较长，有必要定义多个热备盘4)如果DS4000中包含FC和SATA硬盘，需要考虑定义FC和SATA作为热备盘，因为FC硬盘不能保护SATA盘创建的Raid组，反之亦然。
自动分配(Automatic assign)自动分配热备盘步骤如下：11. 选择Drive →Hot Spare Coverage 如图图12. 这里打开Hot Spare Drive Options对话框，如图2。
选择Automatically assign drives，每30块相同类型的磁盘(FC或SATA)自动定义一块热备盘。
图2手动分配(Manual assign)手动分配热备盘步骤如下：1. 用鼠标左键单击选中需要设置热备的硬盘，然后选择图1中的下拉菜单Drive →Hot Spare Coverag e2. 打开Hot Spare Drive Options对话框，如图2，选择Manually assign individual drives。
如果D S4000中任何一个阵列(Array)中的硬盘容量大于当前选定的热备盘，会出现警告信息，说明不是所有的阵列(A rray)都被保护3. 解除(unassign)热备盘可以将该盘置为可用(free)状态，用鼠标左键单击选中该盘，选择Drive →Hot Spare Coverage(如图1), 然后在图2中选择Manually unassign individual drives option查看/更改热备盘(View/change hot spare coverage)配置热备盘后，可以通过以下步骤查看或修改1. 在Storage Manager Client中，选择下拉菜单Drive →Hot Spare Coverage(如图1)2. 在图2中选择View/Change current hot spare coverage再点击OK，弹出对话框如图3所示图3实例中，只分配了一块SATA的热备盘，如图3所示该热备盘只能对data阵列(array)保护，而另外两个阵列(array)得不到保护。
DS5000___安装配置手册v1.0DS5000安装配置手册v1.0目录一、DS5000磁阵配置 (3)1.磁盘规划 (3)2.连接磁盘阵列 (3)3.使用存储管理软件系统 (5)4.创建Array和LUN (11)5.创建第一个LUN (15)6.增加LUN (21)7.创建hotspare (21)二、将LUN映射给主机 (25)1.将磁盘柜与主机正确连接 (25)2.Lun与主机映射步骤： (26)3.在主机上使用lun创建VG，LV，FS (35)4.参数调整 (36)附录 (36)附录一：条带化建议 (36)附录二：-e’x’选项与-S选项说明 (37)本文档仅供研发内部使用，如需在生产环境使用，请先对指导书各步骤进行验证。
一、DS5000磁阵配置1.磁盘规划本次磁阵配置为16块硬盘的DS5020，采用RAID5建两个Array。
每个array包含8个盘。
每个array上建一个lun，分别是Omc1和Omc2。
在主机上分别对应为hdisk2、hdisk3。
分别将Omc1和Omc2分配到控制器A、B，以分担负荷。
2.连接磁盘阵列DS5020后板示意图其中Ethernet ports （以太网口）用于跟PC 连接，配置磁盘Serial port 串口Ethernet ports 以太网口Dual-port drive channel 扩展柜接口Fibre Channel host channels 主机接口DS5020有两个控制器：ControllerA 和ControllerB 。
每个控制器有一个网口，ControllerA的网口默认IP地址为192.168.128.101/255.255.255.0，ControllerB 的网口默认IP 地址为192.168.128.102/255.255.255.0。
控制台需要配置和DS5020控制器同一网段的IP 地址，用来连接DS502，此网段要求是一个独立的网络，不要加入其它的机器,以免IP 地址变更。
DS4000/DS5000 如何建立Array和Lun（Array级别，磁盘类型 容量 转速，segment size，优先路径）解答：在IBM Storage manager管理软件中的 “Logical/Physical View”中，选择相应类型磁盘的“unconfigured capacity”来创建新的Array。
FC和SATA类型的磁盘不能在混用在同一Array中。
输入Array的名字，并且可以选择自动方式或手动方式创建Array。
在自动方式下，Storage manager会根据选择的RAID级别自动列出相应的磁盘的数量。
在手动创建方式下，用户需要手动选择RAID级别，并根据RAID级别的要求选择磁盘数量，容量与转速。
RAID5最少需要3块磁盘，RAID1需要偶数埠磁盘，并且当达到4块盘以上时，会按照RAID10或RAID0+1方式进行创建。
只有创建完Array之后，才可以创建LUN。
DS4000/DS5000支持将Array中的所有空余容量分配给一个LUN，也支持在一个Array中划分出多个LUN。
输入LUN的名字并且可以按推荐方式或自定义方式选择LUN的IO特性。
可以按照LUN的用途为其设置segment size的值。
Segment size的设置对于存储的性能发挥有重要的作用。
对于IOPS的应用环境，可以把segment size值设置较小。
对于Throughput 的应用环境，可以把segment size值设置较大一些。
IBM Storage manager管理软件默认的segment size值为64K，对于Database的应用，建议设置范围为32K-128K之间为宜。
对于Multimedia及CAD的大文件环境，建议设置范围为128K。
对于web server, 文件或打印服器，建议设置范围为16-64K。
用户也可以自定义segment size值以获得最佳性能，segment size值有8 KB, 16 KB, 32 KB, 64 KB, 128 KB, 256 KB和 512 KB多种选择。
DS4000/DS5000 如何创建、应用FlashCopy/VolumeCopy 解答：
Flashcopy的创建方式：
1.查看是否有Flashcopy license,然后在需要做快照的LUN上点击右键，选择Create FlashCopy Logical Drive
2.选择Advanced，下一步，显示出Flashcopy原卷名称以及快照卷名称，
3.选择盘阵中的空闲空间，下一步；快照卷变化数据量存储空间，默认为原卷的20%，可以按照具体应用需求更改这个容量大小
4.Mapping方式选择自动或者手动映射
50%为报警阀值，当FlashCopy存放数据变化的LUN存储空间超过50%的时候，DS4000阵列会报警，提醒用户注意，这个值可以按照用户需求更改
假如FlashCopy存放数据变化的LUN存储空间被写满，会有两种处理方式：
●Fail flashcopy logical drive:使这个快照失效，数据在原卷的写入不受影响
●Fail writes to base logical drive:快照停止写入，原卷被锁定，禁止数据在原卷的
写入，直到快照被重建或扩展数据变化存储空间
Disable/Re-create等操作
1.查看是否有VolumeCopy license,然后在需要做快照的LUN上点击右键，选择Create copy
2.在如下左图中选择VolumeCopy 源卷，下一步，在所示界面中选择目标卷，界面中会把系统中所有容量大于等于原卷的LUN都显示出来，在选择目标卷时不要选错，VolumeCopy一
旦开始，会覆盖所选择目标卷上的数据。
3.输入yes完成VolumeCopy设置，开始数据复制
4.在VolumeCopy目标卷上点击右键，选择Copy Manager，在弹出的Copy Manager窗口中可以对拷贝卷过程进行监控，以及对目标卷读写方式等进行更改。
参考文档 :
《IBM System Storage DS4000 and Storage Manager V10.30》
下载地址: /redbooks/pdfs/sg247010.pdf
《IBM TotalStorage DS4000 Storage Manager 复制服务用户指南》
下载地址 :
/systems/support/supportsite.wss/docdisplay?lndocid=MIGR-61173&brandind=5000028。
