2024年5月8日发(作者：)

TW68XX系列SDK说明

1. SDK功能概述

SDK提供以下功能：

(1) 获取板卡信息，包括板卡个数、位置、包含的设备个数等；

(2) 获取设备信息，包括设备个数、索引、能力描述等；

(3) 获取通道信息，包括通道个数、索引、能力描述等；

(4) 提供设备能力设置接口，包括Input Source，采集通道数等；

(5) 提供设备I2C接口，用于加密等；

(6) 提供设备GPIO接口，用于IO报警等；

(7) 提供视频属性设置接口，包括制式、亮度等、像素格式、图像大小等；

(8) 提供视频原始数据；

(9) 提供音频原始数据；

2. 更新说明

 版本1.0.0.1

(1)支持TW6802、TW6802B、TW6805芯片；

(2)支持实时和非实时切换模式；

(3)仅支持YUY2（YUV 4:2:2 Packet）格式；

(4)音频仅支持8 khz，8 bit，单声道PCM格式；

 版本1.0.1.1

(1)支持TW6864芯片；

(2)暂不支持非实时切换模式；

(3)视频数据固定为YUY2（YUV 4:2:2 Packet）；

(4)音频数据固定为8 khz，8 bit，单声道PCM格式；

 版本1.0.1.4

支持非实时切换模式，但TW2865上通道必须使用同样的分辨率和亮度、对比度等值。

 版本1.0.1.5

支持Y41P(YUV411 packet)、RGB555、RGB565格式。

 版本1.1.0.2

支持TW6868 16路卡。

 版本1.1.0.3

支持TW6816/TW6815卡。

 版本1.1.0.4

(1) 修正TW686x读写GPIO异常的错误。

(2) 修正TW681x读写音频寄存器无效的错误。

(3) 支持TW680x、TW681x的Y41P,RGB15,RGB16格式采集。

 版本1.1.0.5

支持每个通道图像位置微调（图像左移或右移，调整左边或者右边垂直黑边）。

 保留

3. SDK接口和功能详述

3.1. 初始化和反初始化

 BOOL TwInitSDK()

功能：初始化SDK

参数：无

返回：成功返回TRUE；失败返回FALSE，调用TwGetLastError获取错误码

 VOID TwUninitSDK()

功能：反初始化SDK，释放设备和内存资源

参数：无

返回：无

3.2. 板卡信息

 int TwGetBoardCount()

功能：获取板卡数量

参数：无

返回：成功返回板卡数，否则返回-1，调用TwGetLastError获取错误码

 HANDLE TwGetBoardHandle(int nBoard)

功能：获取板卡句柄

参数：[in]nBoard，板卡索引，从0到TwGetBoardCount()获取的板卡数减1

返回：成功返回板卡句柄，否则返回NULL，调用TwGetLastError获取错误码

 BOOL TwGetBoardDetail(HANDLE hBoard, TBoardDesc *pBoardDesc)

功能：获取板卡信息

参数：[in]hBoard，板卡句柄，从TwGetBoardHandle()获取

[out]pBoardDesc,板卡描述指针

返回：成功返回TRUE，pBoardDesc中包含详细板卡信息；失败返回FALSE，调用

TwGetLastError获取错误码

3.3. 设备信息和能力