《TW68XX系列SDK说明》由会员分享，可在线阅读，更多相关《TW68XX系列SDK说明（13页珍藏版）》请在金锄头文库上搜索。
1、TW68XX系列SDK说明1. SDK功能概述SDK提供以下功能：(1) 获取板卡信息，包括板卡个数、位置、包含的设备个数等；(2) 获取设备信息，包括设备个数、索引、能力描述等；(3) 获取通道信息，包括通道个数、索引、能力描述等；(4) 提供设备能力设置接口，包括Input Source，采集通道数等；(5) 提供设备I2C接口，用于加密等；(6) 提供设备GPIO接口，用于IO报警等；(7) 提供视频属性设置接口，包括制式、亮度等、像素格式、图像大小等；(8) 提供视频原始数据；(9) 提供音频原始数据；2. 更新说明l 版本1.0.0.1(1) 支持TW6802、TW6802B、TW6
2、805芯片；(2) 支持实时和非实时切换模式；(3) 仅支持YUY2（YUV 4:2:2 Packet）格式；(4) 音频仅支持8 khz，8 bit，单声道PCM格式；l 版本1.0.1.1(1) 支持TW6864芯片；(2) 暂不支持非实时切换模式；(3) 视频数据固定为YUY2（YUV 4:2:2 Packet）；(4) 音频数据固定为8 khz，8 bit，单声道PCM格式；l 版本1.0.1.4支持非实时切换模式，但TW2865上通道必须使用同样的分辨率和亮度、对比度等值。l 版本1.0.1.5支持Y41P(YUV411 packet)、RGB555、RGB565格式。l 版本1.1
3、.0.2支持TW6868 16路卡。l 版本1.1.0.3支持TW6816/TW6815卡。l 版本1.1.0.4(1) 修正TW686x读写GPIO异常的错误。(2) 修正TW681x读写音频寄存器无效的错误。(3) 支持TW680x、TW681x的Y41P,RGB15,RGB16格式采集。l 版本1.1.0.5支持每个通道图像位置微调（图像左移或右移，调整左边或者右边垂直黑边）。l 保留3. SDK接口和功能详述3.1. 初始化和反初始化l BOOL TwInitSDK()功能：初始化SDK参数：无返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码l V
4、OID TwUninitSDK()功能：反初始化SDK，释放设备和内存资源参数：无返回：无3.2. 板卡信息l int TwGetBoardCount()功能：获取板卡数量参数：无返回：成功返回板卡数，否则返回-1，调用TwGetLastError获取错误码l HANDLE TwGetBoardHandle(int nBoard)功能：获取板卡句柄参数：innBoard，板卡索引，从0到TwGetBoardCount()获取的板卡数减1返回：成功返回板卡句柄，否则返回NULL，调用TwGetLastError获取错误码l BOOL TwGetBoardDetail(HANDLE hBoard,
5、 TBoardDesc *pBoardDesc)功能：获取板卡信息参数：inhBoard，板卡句柄，从TwGetBoardHandle()获取 outpBoardDesc,板卡描述指针返回：成功返回TRUE，pBoardDesc中包含详细板卡信息；失败返回FALSE，调用TwGetLastError获取错误码3.3. 设备信息和能力l int TwGetDeviceCount()功能：获取设备个数参数：无返回：成功返回设备个数，否则返回-1，调用TwGetLastError获取错误码l HANDLE TwGetDeviceHandle(int nDevice)功能：获取设备句柄参数：innDe
6、vice，设备索引号，从0到TwGetDeviceCount获取的设备数减1返回：成功返回设备句柄，否则返回NULL，调用TwGetLastError获取错误码l BOOL TwGetDeviceDetail(HANDLE hDevice, TDeviceDesc *pDevDesc)功能：获取设备详细信息参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 outpDevDesc，设备描述指针返回：成功返回TRUE，pDevDesc包含设备详细描述信息；失败返回FALSE，调用TwGetLastError获取错误码l BOOL TwGetDeviceRegBYTE(H
7、ANDLE hDevice, ULONG uReg, BYTE* value)功能：读取指定设备的寄存器（字节）参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 inuReg，寄存器地址 outvalue，返回寄存器值返回：成功返回TRUE，value包含指定寄存器的值；失败返回FALSE，调用TwGetLastError 获取错误码l BOOL TwGetDeviceRegWORD(HANDLE hDevice, ULONG uReg, USHORT* value)功能：读取指定设备的寄存器（字）参数：inhDevice，设备句柄，从TwGetDeviceHand
8、le获取 inuReg，寄存器地址 outvalue，返回寄存器值返回：成功返回TRUE，value包含指定寄存器的值；失败返回FALSE，调用TwGetLastError 获取错误码l BOOL TwGetDeviceRegDWORD(HANDLE hDevice, ULONG uReg, DWORD* value)功能：读取指定设备的寄存器（双字）参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 inuReg，寄存器地址 outvalue，返回寄存器值返回：成功返回TRUE，value包含指定寄存器的值；失败返回FALSE，调用TwGetLastError 获取
9、错误码l BOOL TwSetDeviceRegBYTE(HANDLE hDevice, ULONG uReg, BYTE value)功能：设置指定设备的寄存器（字节）参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 inuReg，寄存器地址 invalue，寄存器值返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码l BOOL TwSetDeviceRegWORD(HANDLE hDevice, ULONG uReg, WORD value)功能：设置指定设备的寄存器（字）参数：inhDevice，设备句柄，从TwGetDev
10、iceHandle获取 inuReg，寄存器地址 invalue，寄存器值返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码l BOOL TwSetDeviceRegDWORD(HANDLE hDevice, ULONG uReg, WORD value)功能：设置指定设备的寄存器（双字）参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 inuReg，寄存器地址 invalue，寄存器值返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码l BOOL TwGetDevicePciConfigSpa
11、ce(HANDLE hDevice, int nOffset, int nBytes, BYTE* pData)功能：读取指定设备的PCI配置空间参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 innOffset，要读取的配置空间偏移地址 innBytes，要读取的字节数 outpData，返回值返回：成功返回TRUE，pData包含指定配置空间值；失败返回FALSE，调用TwGetLastError 获取错误码l BOOL TwSetDevicePciConfigSpace(HANDLE hDevice, int nOffset, int nBytes, BYT
12、E* pData)功能：读取指定设备的PCI配置空间参数：inhDevice，设备句柄，从TwGetDeviceHandle获取 innOffset，要读取的配置空间偏移地址 innBytes，要读取的字节数 inpData，要写入的值返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码l int TwGetSubDeviceCount()功能：获取子设备个数参数：无返回：成功返回子设备个数，否则返回-1，调用TwGetLastError获取错误码l HANDLE TwGetSubDeviceHandle(int nSubDevice)功能：获取设备句柄参数：
13、innSubDevice，子设备索引，从0到TwGetSubDeviceCount获取的设备数减1返回：成功返回子设备句柄，否则返回NULL，调用TwGetLastError获取错误码l BOOL TwGetSubDeviceDetail(HANDLE hSubDevice, TSubDeviceDesc *pSubDevDesc)功能：获取设备详细信息参数：inhSubDevice，子设备句柄，从TwGetSubDeviceHandle获取 outpSubDevDesc，子设备描述指针返回：成功返回TRUE，pSubDevDesc包含子设备详细描述信息；失败返回FALSE，调用 TwGetL
14、astError获取错误码l BOOL TwEnableVideoInput(HANDLE hSubDevice, TVideoInput vInput, BOOL bEnable)功能：是否允许视频源输入（默认允许的视频源输入为mux 0）参数：inhSubDevice，子设备句柄，从TwGetSubDeviceHandle获取 invInput，视频输入源 inbEnable，TRUE为允许，否则不允许返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码l BOOL TwTwEnableVideoField2(HANDLE hSubDevice, BOOL bEnable)功能：允许奇偶场分开采集（默认值是不分开采集）参数：inhSubDevice，子设备句柄，从TwGetSubDeviceHandle获取 inbEnable，TRUE为允许，否则不允许返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码说明：奇偶场分开采集的情况下，设置的视频采集高度不能大过CIF的高度3.4. 通道信息l int TwGetChannelCount()功能：
