FTDI D3xx编程指南：API接口与安全警示

需积分: 19 8 浏览量更新于2024-07-09 收藏 1.11MB PDF 举报

本资源是一份名为"AN_379-D3xx-Programmers-Guide-1.pdf"的FTDI编程指南，由Future Technology Devices International Limited (FTDI)发布。这份文档专为D3xx系列设备设计，提供了详细的软件开发者接口（Software Development Kit, SDK）信息，特别是针对SuperSpeed USB驱动的API（Application Programming Interface）。该指南适用于那些希望在生命支持和/或安全应用中使用FTDI设备的开发者，但必须明确，用户自行承担风险，并同意保护、赔偿FTDI免受因此类使用导致的任何损害、索赔、诉讼或费用。文档主要分为两个部分： 1. **介绍**： - 简要概述了FTDI提供的DLL（Dynamic Link Library）应用程序接口，这是一种与超级速度USB驱动交互的工具，旨在简化开发者与FTD3XX功能库的集成过程。 2. **D3XX FT60X函数**： - **FT_CreateDeviceInfoList**：这个函数用于创建设备列表，帮助开发者枚举系统上可用的FTDI设备，以便进行后续操作。 - **FT_GetDeviceInfoList**：获取设备详细信息，包括设备ID、描述和其他关键属性，这对于开发者理解和管理设备至关重要。 - **FT_GetDeviceInfoDetail**：进一步获取特定设备的详细配置和特性信息，以支持定制化的应用程序开发。 - **FT_ListDevices**：列出已连接的设备及其状态，便于监控和控制。文档还包含了版权信息、发行日期（2018年3月28日）、联系信息（地址、电话和网址）以及文档参考号和审查编号。开发者在使用这些API时，应遵循版权条款，并在遇到问题时通过产品页面或提供反馈以获取支持。这份FTDI D3xx编程指南为开发人员提供了一个全面的工具集，以高效地利用FTDI高速USB设备，同时强调了用户在将这些技术应用于高风险领域时的责任和义务。

Application Note

AN_379 D3XX Programmers Guide

Version 1.7

Document Reference No.: FT_001196 Clearance No.: FTDI#456

Product Page

Figure 2 - Device with Default String Descriptors

Open a device with serial number “000000000001”

FT_STATUS ftStatus;

FT_HANDLE ftHandle;

ftStatus = FT_Create("000000000001", FT_OPEN_BY_SERIAL_NUMBER, &ftHandle);

Open a device with product description “FTDI SuperSpeed-FIFO Bridge”

FT_STATUS ftStatus;

FT_HANDLE ftHandle;

ftStatus = FT_Create("FTDI SuperSpeed-FIFO Bridge", FT_OPEN_BY_DESCRIPTION, &ftHandle);

Figure 3 - Device with Customized String Descriptors

Open a device with serial number “1234567890ABCde”

FT_STATUS ftStatus;

FT_HANDLE ftHandle;

ftStatus = FT_Create("1234567890ABCde", FT_OPEN_BY_SERIAL_NUMBER, &ftHandle);

Open a device with product description “This is My Product Description”

FT_STATUS ftStatus;

FT_HANDLE ftHandle;

ftStatus = FT_Create("This is My Product Description", FT_OPEN_BY_DESCRIPTION, &ftHandle);

Application Note

AN_379 D3XX Programmers Guide

Version 1.7

Document Reference No.: FT_001196 Clearance No.: FTDI#456

Product Page

2.7 FT_WritePipe

FT_STATUS

FT_WritePipe(

FT_HANDLE ftHandle,

UCHAR ucPipeID,

PUCHAR pucBuffer,

ULONG ulBufferLength,

PULONG pulBytesTransferred,

LPOVERLAPPED pOverlapped

)

Summary

Write data to pipe.

Parameters

ftHandle A handle to the device

ucPipeID Corresponds to the bEndpointAddress field in the endpoint

descriptor. In the bEndpointAddress field, Bit 7 indicates

the direction of the endpoint: 0 for OUT; 1 for IN.

pucBuffer Buffer that contains the data to write.

ulBufferLength The number of bytes to write. This number must be less

than or equal to the size, in bytes, of the Buffer.

pulBytesTransferred A pointer to a ULONG variable that receives the actual

number of bytes written to the pipe.

pOverlapped An optional pointer to an OVERLAPPED structure,

used for asynchronous operations.

Return Value

FT_OK if successful, otherwise the return value is an FT error code.

If lpOverlapped is NULL, FT_WritePipe operates synchronously, that is, it returns only when

the transfer has been completed.

If lpOverlapped is not NULL, FT_WritePipe operates asynchronously and immediately

returns FT_IO_PENDING. FT_GetOverlappedResult should be called to wait for the

completion of this asynchronous operation. When supplying the lpOverlapped to

FT_WritePipe, the event parameter of lpOverlapped should be initialized using

FT_InitializeOverlapped.

If an FT_WritePipe call fails with an error code (status other than FT_OK or

FT_IO_PENDING), an application should call FT_AbortPipe. To ensure that the pipe is in a

clean state it is recommended to follow the abort procedure mentioned in the section 3.2

of "AN_412_FT600_FT601 USB Bridge chips Integration”.

Application Note

AN_379 D3XX Programmers Guide

Version 1.7

Document Reference No.: FT_001196 Clearance No.: FTDI#456

Product Page

Synchronous write to pipe 0x02

UCHAR acBuf[BUFFER_SIZE] = {0xFF};

ULONG ulBytesTransferred = 0;

ftStatus = FT_WritePipe(ftHandle, 0x02, acBuf, BUFFER_SIZE &ulBytesTransferred, NULL);

Asynchronous write to pipe 0x02

OVERLAPPED vOverlapped = {0};

ftStatus = FT_InitializeOverlapped(ftHandle, &vOverlapped);

UCHAR acBuf[BUFFER_SIZE] = {0xFF};

ULONG ulBytesTransferred = 0;

ftStatus = FT_WritePipe(ftHandle, 0x02, acBuf, BUFFER_SIZE, &ulBytesTransferred, &vOverlapped);

if (ftStatus == FT_IO_PENDING)

{

ftStatus = FT_GetOverlappedResult(ftHandle, &vOverlapped, &ulBytesTransferred, TRUE);

}

FT_ReleaseOverlapped(ftHandle, &vOverlapped);

Triple buffering / 3 asynchronous write to pipe 0x02

#define NUM_BUFFERS 3

#define BUFFER_SIZE 8294400 // Full-HD: 1920 x 1080 x 4

UCHAR acBuf[NUM_BUFFERS][BUFFER_SIZE] = {0xFF};

ULONG ulBytesTransferred[NUM_BUFFERS] = 0;

OVERLAPPED vOverlapped[NUM_BUFFERS] = {0};

for (int i=0; i<NUM_BUFFERS; i++)

{

ftStatus = FT_InitializeOverlapped(ftHandle, &vOverlapped[i]);

}

// Queue up the initial batch of requests

for (int i=0; i<NUM_BUFFERS; i++)

{

ftStatus = FT_WritePipe(ftHandle, 0x02, &acBuf[i][0], BUFFER_SIZE, &ulBytesTransferred[i], &vOverlapped[i]);

}

int i=0;

// Infinite transfer loop

while (bKeepGoing)

{

// Wait for transfer to finish

ftStatus = FT_GetOverlappedResult(ftHandle, &vOverlapped[i], &ulBytesTransferred[i], TRUE);

// Re-submit to keep request full

ftStatus = FT_WritePipe(ftHandle, 0x02, &acBuf[i][0], BUFFER_SIZE, &ulBytesTransferred[i], &vOverlapped[i]);

// Roll-over

if (++i == NUM_BUFFERS)

{

i = 0;

}

for (int i=0; i<NUM_BUFFERS; i++)

{

FT_ReleaseOverlapped(ftHandle, &vOverlapped);

}

剩余75页未读，继续阅读

wwsinsh

粉丝: 6
资源: 4

FTDI D3xx编程指南：API接口与安全警示

AN_379 D3xx Programmers Guide.pdf

ONVIF_WG-APG-Application_Programmers_Guide-1.zip_ONVIF_onvif app

[深入理解计算机系统].（课后答案）Computer.Systems.-.A.Programmers.Perspective.-.Randal.Bryant,.David.O.Hallaron.-.1008.pages.High.Quality.-.2003.Prentice.Hall.djvu

Cython-A-guide-for-Python-programmers.pdf.pdf

McGraw.Hill.Android.A.Programmers.Guide.Jul.2008.eBook-DDU.pdf

JDK18-flight-recorder-api-programmers-guide.pdf

JDK19-flight-recorder-api-programmers-guide.pdf

JDK17-flight-recorder-api-programmers-guide.pdf

JDK16-flight-recorder-api-programmers-guide.pdf

JDK14-flight-recorder-api-programmers-guide.pdf

最新资源