From abcc3e0b5e6b67fb14bcb889531ce36d6405c077 Mon Sep 17 00:00:00 2001 From: Valentin Boulanger Date: Sat, 1 Nov 2025 12:23:22 +0100 Subject: [PATCH] resolved: activating/deactivating peripherals --- hardware/FTDIFinder.go | 170 +- hardware/FTDIPeripheral.go | 96 +- hardware/cpp/generate.bat | 7 +- hardware/cpp/include/detectFTDIBridge.h | 19 + hardware/cpp/include/dmxSenderBridge.h | 23 +- hardware/cpp/src/detectFTDI.cpp | 91 + hardware/cpp/src/detectFTDI.h | 14 + hardware/cpp/src/dmxSender.cpp | 149 +- hardware/cpp/src/dmxSender.h | 28 +- hardware/cpp/test/detectFTDI_test.cpp | 14 + hardware/cpp/test/dmxSender_test.cpp | 122 ++ hardware/interfaces.go | 5 +- hardware/third-party/ftdi/detectFTDI.cpp | 44 - hardware/third-party/ftdi/detectFTDI.manifest | 12 - hardware/third-party/ftdi/include/ftd2xx.h | 1667 ----------------- hardware/third-party/ftdi/lib/ftd2xx.lib | Bin 20260 -> 0 bytes peripherals.go | 2 +- 17 files changed, 559 insertions(+), 1904 deletions(-) create mode 100644 hardware/cpp/include/detectFTDIBridge.h create mode 100644 hardware/cpp/src/detectFTDI.cpp create mode 100644 hardware/cpp/src/detectFTDI.h create mode 100644 hardware/cpp/test/detectFTDI_test.cpp create mode 100644 hardware/cpp/test/dmxSender_test.cpp delete mode 100644 hardware/third-party/ftdi/detectFTDI.cpp delete mode 100644 hardware/third-party/ftdi/detectFTDI.manifest delete mode 100644 hardware/third-party/ftdi/include/ftd2xx.h delete mode 100644 hardware/third-party/ftdi/lib/ftd2xx.lib diff --git a/hardware/FTDIFinder.go b/hardware/FTDIFinder.go index 966ba0e..fea6588 100644 --- a/hardware/FTDIFinder.go +++ b/hardware/FTDIFinder.go @@ -1,34 +1,31 @@ package hardware import ( - "bufio" "context" _ "embed" "fmt" - "os" - "os/exec" - "path/filepath" goRuntime "runtime" - "strconv" - "strings" "sync" "time" + "unsafe" "github.com/rs/zerolog/log" - "github.com/wailsapp/wails/v2/pkg/runtime" ) -const ( - ftdiFinderExecutableName = "FTDI_finder.exe" -) +/* +#include +#cgo LDFLAGS: -L${SRCDIR}/../build/bin -ldetectFTDI +#include "cpp/include/detectFTDIBridge.h" +*/ +import "C" // FTDIFinder represents how the protocol is defined type FTDIFinder struct { - findTicker time.Ticker // Peripherals find ticker - foundPeripherals map[string]PeripheralInfo // The list of peripherals handled by this finder - registeredPeripherals map[string]FTDIPeripheral // The list of found peripherals - scanChannel chan struct{} // The channel to trigger a scan event - goWait sync.WaitGroup // Check goroutines execution + findTicker time.Ticker // Peripherals find ticker + foundPeripherals map[string]PeripheralInfo // The list of peripherals handled by this finder + registeredPeripherals map[string]*FTDIPeripheral // The list of found peripherals + scanChannel chan struct{} // The channel to trigger a scan event + goWait sync.WaitGroup // Check goroutines execution } // NewFTDIFinder creates a new FTDI finder @@ -37,7 +34,7 @@ func NewFTDIFinder(findPeriod time.Duration) *FTDIFinder { return &FTDIFinder{ findTicker: *time.NewTicker(findPeriod), foundPeripherals: make(map[string]PeripheralInfo), - registeredPeripherals: make(map[string]FTDIPeripheral), + registeredPeripherals: make(map[string]*FTDIPeripheral), scanChannel: make(chan struct{}), } } @@ -48,16 +45,33 @@ func (f *FTDIFinder) RegisterPeripheral(ctx context.Context, peripheralData Peri if err != nil { return "", fmt.Errorf("unable to create the FTDI peripheral: %v", err) } - f.registeredPeripherals[peripheralData.SerialNumber] = *ftdiPeripheral + f.registeredPeripherals[peripheralData.SerialNumber] = ftdiPeripheral log.Trace().Any("periph", &ftdiPeripheral).Str("file", "FTDIFinder").Str("peripheralName", peripheralData.Name).Msg("FTDI peripheral has been created") + // Peripheral created, connect it + err = ftdiPeripheral.Connect(ctx) + if err != nil { + log.Err(err).Str("file", "FTDIFinder").Str("peripheralSN", peripheralData.SerialNumber).Msg("unable to connect the peripheral") + } + // Peripheral connected, activate it + err = ftdiPeripheral.Activate(ctx) + if err != nil { + log.Err(err).Str("file", "FTDIFinder").Str("peripheralSN", peripheralData.SerialNumber).Msg("unable to activate the peripheral") + } + // Peripheral activated return peripheralData.SerialNumber, nil } // UnregisterPeripheral unregisters an existing peripheral -func (f *FTDIFinder) UnregisterPeripheral(peripheralID string) error { +func (f *FTDIFinder) UnregisterPeripheral(ctx context.Context, peripheralID string) error { peripheral, registered := f.registeredPeripherals[peripheralID] if registered { - err := peripheral.Disconnect() + // Deactivating peripheral + err := peripheral.Deactivate(ctx) + if err != nil { + return err + } + // Disconnecting peripheral + err = peripheral.Disconnect(ctx) if err != nil { return err } @@ -66,9 +80,6 @@ func (f *FTDIFinder) UnregisterPeripheral(peripheralID string) error { return nil } -//go:embed third-party/ftdi/detectFTDI.exe -var finderExe []byte - // Initialize initializes the FTDI finder func (f *FTDIFinder) Initialize() error { // Check platform @@ -76,34 +87,10 @@ func (f *FTDIFinder) Initialize() error { log.Error().Str("file", "FTDIFinder").Str("platform", goRuntime.GOOS).Msg("FTDI finder not compatible with your platform") return fmt.Errorf("the FTDI finder is not compatible with your platform yet (%s)", goRuntime.GOOS) } - // Create the FTDI executables - err := createExecutable(ftdiFinderExecutableName, finderExe) - if err != nil { - return err - } log.Trace().Str("file", "FTDIFinder").Msg("FTDI finder initialized") return nil } -// createExecutable creates and writes an executable to the temporary directory of the system -func createExecutable(fileName string, storedFile []byte) error { - tempFile, err := os.Create(filepath.Join(os.TempDir(), fileName)) - if err != nil { - log.Err(err).Str("file", "FTDIFinder").Str("fileName", fileName).Msg("unable to create an FTDI executable") - return err - } - log.Trace().Str("file", "FTDIFinder").Str("filePath", tempFile.Name()).Msg("FTDI executable created") - - // Write the embedded executable to the temp file - if _, err := tempFile.Write(storedFile); err != nil { - log.Err(err).Str("file", "FTDIFinder").Str("fileName", fileName).Msg("unable to write the content to an FTDI executable") - return err - } - tempFile.Close() - log.Trace().Str("file", "FTDIPeripheral").Str("fileName", fileName).Msg("FTDI executable written") - return nil -} - // Start starts the finder and search for peripherals func (f *FTDIFinder) Start(ctx context.Context) error { f.goWait.Add(1) @@ -143,12 +130,6 @@ func (f *FTDIFinder) Stop() error { f.goWait.Wait() // Stop the ticker f.findTicker.Stop() - // Delete the FTDI executable files - fileToDelete := filepath.Join(os.TempDir(), ftdiFinderExecutableName) - err := os.Remove(fileToDelete) - if err != nil { - log.Warn().Str("file", "FTDIFinder").Str("fileName", fileToDelete).AnErr("error", err).Msg("unable to remove the executable file") - } log.Trace().Str("file", "FTDIFinder").Msg("FTDI finder stopped") return nil } @@ -184,78 +165,49 @@ func (f *FTDIFinder) SetPeripheralSettings(peripheralID string, settings map[str // scanPeripherals scans the FTDI peripherals func (f *FTDIFinder) scanPeripherals(ctx context.Context) error { - detectionCtx, cancel := context.WithCancel(ctx) - defer cancel() - log.Trace().Str("file", "FTDIFinder").Msg("FTDI scan triggered") - finder := exec.CommandContext(detectionCtx, filepath.Join(os.TempDir(), ftdiFinderExecutableName)) - log.Trace().Str("file", "FTDIFinder").Msg("has executed the FIND executable") + count := int(C.get_peripherals_number()) - stdout, err := finder.StdoutPipe() - if err != nil { - return fmt.Errorf("unable to create the stdout pipe: %s", err) - } - defer stdout.Close() + log.Info().Int("number", count).Msg("number of FTDI devices connected") - stderr, err := finder.StderrPipe() - if err != nil { - return fmt.Errorf("unable to create the stderr pipe: %s", err) - } - defer stderr.Close() + // Alloue un tableau de structures côté C + size := C.size_t(count) * C.size_t(unsafe.Sizeof(C.FTDIPeripheralC{})) + devicesPtr := C.malloc(size) + defer C.free(devicesPtr) - err = finder.Start() - if err != nil { - return fmt.Errorf("unable to find FTDI peripherals: %s", err) + devices := (*[1 << 30]C.FTDIPeripheralC)(devicesPtr)[:count:count] + + type device struct { + SerialNumber string + Description string + IsOpen bool } - scannerErr := bufio.NewScanner(stderr) - for scannerErr.Scan() { - return fmt.Errorf("unable to find FTDI peripherals: %s", scannerErr.Text()) - } + C.get_ftdi_devices((*C.FTDIPeripheralC)(devicesPtr), C.int(count)) temporaryPeripherals := make(map[string]PeripheralInfo) - scanner := bufio.NewScanner(stdout) - for scanner.Scan() { - peripheralString := scanner.Text() - // The program output is like '0:1:2:3' where 0 is the location, 1 is the S/N, 2 is the name and 3 is the open flag [O/C] - peripheralInfo := strings.Split(peripheralString, ":") + for i := 0; i < count; i++ { + d := devices[i] - log.Trace().Str("file", "FTDIFinder").Str("scannedString", peripheralString).Str("peripheralOpenFlag", peripheralInfo[3]).Str("peripheralName", peripheralInfo[2]).Str("peripheralSN", peripheralInfo[1]).Msg("new FTDI peripheral detected") - // Convert the location to an integer - location, err := strconv.Atoi(peripheralInfo[0]) - if err != nil { - log.Warn().Str("file", "FTDIFinder").Str("peripheralName", peripheralInfo[2]).Msg("no location provided for this FTDI peripheral") - location = -1 - } - // Add the peripheral info to the found list - temporaryPeripherals[peripheralInfo[1]] = PeripheralInfo{ - Name: peripheralInfo[2], - SerialNumber: peripheralInfo[1], - IsOpen: peripheralInfo[3] == "O", + sn := C.GoString(d.serialNumber) + desc := C.GoString(d.description) + isOpen := d.isOpen != 0 + + temporaryPeripherals[sn] = PeripheralInfo{ + SerialNumber: sn, + Name: desc, + IsOpen: isOpen, ProtocolName: "FTDI", } - // If this peripheral is already registered, connect it and activate it - peripheral, registered := f.registeredPeripherals[peripheralInfo[1]] - if registered { - runtime.EventsEmit(ctx, string(PeripheralStatus), peripheral.info, "connecting") - err := peripheral.Connect(ctx, location) - if err != nil { - log.Err(err).Str("file", "FTDIFinder").Str("peripheralSN", peripheralInfo[1]).Msg("unable to connect the peripheral") - } - runtime.EventsEmit(ctx, string(PeripheralStatus), peripheral.info, "deactivated") - time.Sleep(2 * time.Second) - err = peripheral.Activate(ctx) - if err != nil { - log.Err(err).Str("file", "FTDIFinder").Str("peripheralSN", peripheralInfo[1]).Msg("unable to activate the peripheral") - } - runtime.EventsEmit(ctx, string(PeripheralStatus), peripheral.info, "activated") - } - - log.Trace().Any("periph", temporaryPeripherals).Str("file", "FTDIFinder").Str("peripheralName", peripheralInfo[2]).Msg("successfully added the FTDI peripheral to the finder") + // Libération mémoire allouée côté C + C.free_ftdi_device(&d) } + + log.Info().Any("peripherals", temporaryPeripherals).Msg("available FTDI peripherals") + // Emit the peripherals changes to the front emitPeripheralsChanges(ctx, f.foundPeripherals, temporaryPeripherals) // Store the new peripherals list diff --git a/hardware/FTDIPeripheral.go b/hardware/FTDIPeripheral.go index daa7657..a69e523 100644 --- a/hardware/FTDIPeripheral.go +++ b/hardware/FTDIPeripheral.go @@ -3,12 +3,13 @@ package hardware import ( "context" _ "embed" - "io" + "sync" "unsafe" "github.com/pkg/errors" "github.com/rs/zerolog/log" + "github.com/wailsapp/wails/v2/pkg/runtime" ) /* @@ -19,14 +20,11 @@ import "C" // FTDIPeripheral contains the data of an FTDI peripheral type FTDIPeripheral struct { - info PeripheralInfo // The peripheral basic data - settings map[string]interface{} // The settings of the peripheral - dmxDevice unsafe.Pointer // The command object for piloting the DMX ouptut - stdin io.WriteCloser // For writing in the DMX sender - stdout io.ReadCloser // For reading from the DMX sender - stderr io.ReadCloser // For reading the errors - disconnectChan chan struct{} // Channel to cancel the connection - errorsChan chan error // Channel to get the errors + info PeripheralInfo // The peripheral basic data + settings map[string]interface{} // The settings of the peripheral + dmxSender unsafe.Pointer // The command object for piloting the DMX ouptut + waitGroup sync.WaitGroup // Waitgroup to wait goroutines + isConnected bool // If the FTDI is connected or not } // NewFTDIPeripheral creates a new FTDI peripheral @@ -34,57 +32,83 @@ func NewFTDIPeripheral(info PeripheralInfo) (*FTDIPeripheral, error) { log.Info().Str("file", "FTDIPeripheral").Str("name", info.Name).Str("s/n", info.SerialNumber).Msg("FTDI peripheral created") settings := make(map[string]interface{}) return &FTDIPeripheral{ - info: info, - dmxDevice: C.dmx_create(), - settings: settings, - disconnectChan: make(chan struct{}), - errorsChan: make(chan error, 1), + info: info, + dmxSender: nil, + settings: settings, + isConnected: false, }, nil } // Connect connects the FTDI peripheral -func (p *FTDIPeripheral) Connect(ctx context.Context, location int) error { +func (p *FTDIPeripheral) Connect(ctx context.Context) error { + runtime.EventsEmit(ctx, string(PeripheralStatus), p.info, "connecting") + // Check if the device has already been created - if p.dmxDevice == nil { - return errors.Errorf("the DMX device has not been created!") + if p.dmxSender != nil { + return errors.Errorf("the DMX device has already been created!") } + // Create the DMX sender + p.dmxSender = C.dmx_create() + // Connect the peripheral log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("connecting FTDI peripheral...") - err := C.dmx_connect(p.dmxDevice) - if err { - log.Error().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("unable to connect the DMX device") + err := C.dmx_connect(p.dmxSender, C.CString(p.info.SerialNumber)) + if err != C.DMX_OK { + log.Error().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Any("err", err).Msg("unable to connect the DMX device") return errors.Errorf("Unable to connect the DMX Device on the specified port") } - //TODO: Destroy the object when context is done to avoid memory loss + p.waitGroup.Add(1) + go func() { + defer p.waitGroup.Done() + <-ctx.Done() + p.Disconnect(ctx) + }() + + p.isConnected = true + runtime.EventsEmit(ctx, string(PeripheralStatus), p.info, "deactivated") log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("DMX device connected successfully") return nil } // Disconnect disconnects the FTDI peripheral -func (p *FTDIPeripheral) Disconnect() error { +func (p *FTDIPeripheral) Disconnect(ctx context.Context) error { // Check if the device has already been created - if p.dmxDevice == nil { - return errors.Errorf("the DMX device has not been created!") + if p.dmxSender == nil { + return errors.Errorf("the DMX device has not been connected!") } - //TODO: What actions for disconnecting the DMX device? - + // Destroy the dmx sender + C.dmx_destroy(p.dmxSender) + p.isConnected = false return nil } +// IsConnected returns if the FTDI is connected or not +func (p *FTDIPeripheral) IsConnected() bool { + return p.isConnected +} + // Activate activates the FTDI peripheral func (p *FTDIPeripheral) Activate(ctx context.Context) error { // Check if the device has already been created - if p.dmxDevice == nil { - return errors.Errorf("the DMX device has not been created!") + if p.dmxSender == nil { + return errors.Errorf("the DMX sender has not been created!") } log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("activating FTDI peripheral...") - C.dmx_activate(p.dmxDevice) + err := C.dmx_activate(p.dmxSender) + if err != C.DMX_OK { + return errors.Errorf("unable to activate the DMX sender!") + } + + C.dmx_setValue(p.dmxSender, C.uint16_t(1), C.uint8_t(255)) + C.dmx_setValue(p.dmxSender, C.uint16_t(5), C.uint8_t(255)) + + runtime.EventsEmit(ctx, string(PeripheralStatus), p.info, "activated") log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("DMX device activated successfully") @@ -94,13 +118,16 @@ func (p *FTDIPeripheral) Activate(ctx context.Context) error { // Deactivate deactivates the FTDI peripheral func (p *FTDIPeripheral) Deactivate(ctx context.Context) error { // Check if the device has already been created - if p.dmxDevice == nil { + if p.dmxSender == nil { return errors.Errorf("the DMX device has not been created!") } log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("deactivating FTDI peripheral...") - C.dmx_deactivate(p.dmxDevice) + err := C.dmx_deactivate(p.dmxSender) + if err != C.DMX_OK { + return errors.Errorf("unable to deactivate the DMX sender!") + } log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("DMX device deactivated successfully") @@ -116,13 +143,16 @@ func (p *FTDIPeripheral) SetSettings(settings map[string]interface{}) error { // SetDeviceProperty sends a command to the specified device func (p *FTDIPeripheral) SetDeviceProperty(ctx context.Context, channelNumber uint32, channelValue byte) error { // Check if the device has already been created - if p.dmxDevice == nil { + if p.dmxSender == nil { return errors.Errorf("the DMX device has not been created!") } log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("setting device property on FTDI peripheral...") - C.dmx_setValue(p.dmxDevice, C.int(channelNumber), C.int(channelValue)) + err := C.dmx_setValue(p.dmxSender, C.uint16_t(channelNumber), C.uint8_t(channelValue)) + if err != C.DMX_OK { + return errors.Errorf("unable to update the channel value!") + } log.Trace().Str("file", "FTDIPeripheral").Str("s/n", p.info.SerialNumber).Msg("device property set on FTDI peripheral successfully") diff --git a/hardware/cpp/generate.bat b/hardware/cpp/generate.bat index a7613fb..4deba9c 100644 --- a/hardware/cpp/generate.bat +++ b/hardware/cpp/generate.bat @@ -13,9 +13,10 @@ @REM g++ -shared -o ../../build/bin/libdmxSender.dll src/dmxSender.cpp -fPIC -Wl,--out-implib,../../build/bin/libdmxSender.dll.a -L"lib" -lftd2xx +@REM Compiling DETECTFTDI library +g++ -shared -o ../../build/bin/libdetectFTDI.dll src/detectFTDI.cpp -fPIC -Wl,--out-implib,../../build/bin/libdetectFTDI.dll.a -L"lib" -lftd2xx -mwindows + @REM Compiling DMXSENDER library - -g++ -shared -o ../../build/bin/libdmxSender.dll src/dmxSender.cpp -fPIC -L"lib" -lftd2xx - +g++ -shared -o ../../build/bin/libdmxSender.dll src/dmxSender.cpp -fPIC -Wl,--out-implib,../../build/bin/libdmxSender.dll.a -L"lib" -lftd2xx -mwindows @REM g++ -shared -o libdmxSender.so dmxSender.cpp -fPIC -I"include" -L"lib" -lftd2xx -mwindows \ No newline at end of file diff --git a/hardware/cpp/include/detectFTDIBridge.h b/hardware/cpp/include/detectFTDIBridge.h new file mode 100644 index 0000000..8cab84c --- /dev/null +++ b/hardware/cpp/include/detectFTDIBridge.h @@ -0,0 +1,19 @@ +#pragma once + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct { + char* serialNumber; + char* description; + int isOpen; +} FTDIPeripheralC; + +int get_peripherals_number(); +void get_ftdi_devices(FTDIPeripheralC* devices, int count); +void free_ftdi_device(FTDIPeripheralC* device); + +#ifdef __cplusplus +} +#endif \ No newline at end of file diff --git a/hardware/cpp/include/dmxSenderBridge.h b/hardware/cpp/include/dmxSenderBridge.h index 08b1991..1cc9ed4 100644 --- a/hardware/cpp/include/dmxSenderBridge.h +++ b/hardware/cpp/include/dmxSenderBridge.h @@ -1,15 +1,30 @@ // Declare the C++ function from the shared library +#include + +typedef enum { + DMX_OK, + DMX_CHANNEL_TOO_LOW_ERROR, + DMX_CHANNEL_TOO_HIGH_ERROR, + DMX_VALUE_TOO_LOW_ERROR, + DMX_VALUE_TOO_HIGH_ERROR, + DMX_OPEN_ERROR, + DMX_SET_BAUDRATE_ERROR, + DMX_SET_DATA_CHARACTERISTICS_ERROR, + DMX_SET_FLOW_ERROR, + DMX_UNKNOWN_ERROR +} DMXError; + typedef void DMXDevice; extern DMXDevice* dmx_create(); extern void* dmx_destroy(DMXDevice* dev); -extern bool dmx_connect(DMXDevice* dev); +extern DMXError dmx_connect(DMXDevice* dev, char* serialNumber); -extern void dmx_activate(DMXDevice* dev); +extern DMXError dmx_activate(DMXDevice* dev); -extern void dmx_deactivate(DMXDevice* dev); +extern DMXError dmx_deactivate(DMXDevice* dev); -extern void dmx_setValue(DMXDevice* dev, int channel, int value); \ No newline at end of file +extern DMXError dmx_setValue(DMXDevice* dev, uint16_t channel, uint8_t value); \ No newline at end of file diff --git a/hardware/cpp/src/detectFTDI.cpp b/hardware/cpp/src/detectFTDI.cpp new file mode 100644 index 0000000..a6266ee --- /dev/null +++ b/hardware/cpp/src/detectFTDI.cpp @@ -0,0 +1,91 @@ +#include "../include/detectFTDIBridge.h" +#include "detectFTDI.h" +#include +#include +#include +#include + +int getFTDIPeripheralsNumber() { + DWORD numDevs = 0; + if (FT_CreateDeviceInfoList(&numDevs) != FT_OK) { + std::cerr << "Unable to get FTDI devices: create list error\n"; + } + return numDevs; +} + +std::vector scanFTDIPeripherals() { + DWORD numDevs = 0; + if (FT_CreateDeviceInfoList(&numDevs) != FT_OK) { + std::cerr << "Unable to get FTDI devices: create list error\n"; + return {}; + } + + if (numDevs == 0) { + return {}; + } + + std::vector devInfo(numDevs); + if (FT_GetDeviceInfoList(devInfo.data(), &numDevs) != FT_OK) { + std::cerr << "Unable to get FTDI devices: get list error\n"; + return {}; + } + + std::vector peripherals; + peripherals.reserve(numDevs); + + for (const auto& info : devInfo) { + if (info.SerialNumber[0] != '\0') { + peripherals.push_back({ + info.SerialNumber, + info.Description, + static_cast(info.Flags & FT_FLAGS_OPENED) + }); + } + } + + return peripherals; +} + +extern "C" { + +int get_peripherals_number() { + return getFTDIPeripheralsNumber(); +} + +void get_ftdi_devices(FTDIPeripheralC* devices, int count) { + if (!devices || count <= 0) { + return; + } + + auto list = scanFTDIPeripherals(); + int n = std::min(count, static_cast(list.size())); + + for (int i = 0; i < n; ++i) { + const auto& src = list[i]; + auto& dst = devices[i]; + + dst.serialNumber = static_cast(std::malloc(src.serialNumber.size() + 1)); + std::strcpy(dst.serialNumber, src.serialNumber.c_str()); + + dst.description = static_cast(std::malloc(src.description.size() + 1)); + std::strcpy(dst.description, src.description.c_str()); + + dst.isOpen = src.isOpen ? 1 : 0; + } +} + +void free_ftdi_device(FTDIPeripheralC* device) { + if (!device) return; + + if (device->serialNumber) { + std::free(device->serialNumber); + device->serialNumber = nullptr; + } + + if (device->description) { + std::free(device->description); + device->description = nullptr; + } +} + +} // extern "C" \ No newline at end of file diff --git a/hardware/cpp/src/detectFTDI.h b/hardware/cpp/src/detectFTDI.h new file mode 100644 index 0000000..d22d4fb --- /dev/null +++ b/hardware/cpp/src/detectFTDI.h @@ -0,0 +1,14 @@ +#pragma once + +#include "ftd2xx.h" +#include +#include + +struct FTDIPeripheral { + std::string serialNumber; + std::string description; + bool isOpen; +}; + +int getFTDIPeripheralsNumber(); +std::vector scanFTDIPeripherals(); \ No newline at end of file diff --git a/hardware/cpp/src/dmxSender.cpp b/hardware/cpp/src/dmxSender.cpp index 96685f1..9f372ca 100644 --- a/hardware/cpp/src/dmxSender.cpp +++ b/hardware/cpp/src/dmxSender.cpp @@ -1,6 +1,7 @@ //dmxSender.cpp #include "dmxSender.h" +#include #define DMX_START_CODE 0x00 #define BREAK_DURATION_US 110 @@ -11,61 +12,132 @@ // Initialize default values for starting the DMX device DMXDevice::DMXDevice(){ + std::cout << " [DMXSENDER] " << "Creating a new DMXDevice..." << std::endl; ftHandle = nullptr; isOutputActivated = false; + resetChannels(); + std::this_thread::sleep_for(std::chrono::milliseconds(100)); + std::cout << " [DMXSENDER] " << "DMXDevice created!" << std::endl; } // Properly close the DMX device DMXDevice::~DMXDevice(){ + std::cout << " [DMXSENDER] " << "Removing the DMXDevice..." << std::endl; + std::cout << " [DMXSENDER] " << "Deactivating the DMXDevice..." << std::endl; deactivate(); + std::cout << " [DMXSENDER] " << "DMXDevice deactivated!" << std::endl; + if (ftHandle != nullptr){ + std::cout << " [DMXSENDER] " << "ftHandle not null, closing it..." << std::endl; FT_Close(ftHandle); + std::cout << " [DMXSENDER] " << "FT_HANDLE closed!" << std::endl; ftHandle = nullptr; } + std::cout << " [DMXSENDER] " << "DMXDevice removed!" << std::endl; } // Connect the device on a specific port -bool DMXDevice::connect(int port){ - ftStatus = FT_Open(port, &ftHandle); +DMXError DMXDevice::connect(char* serialNumber){ + std::cout << " [DMXSENDER] " << "Connecting the DMXDevice..." << std::endl; + ftStatus = FT_OpenEx((PVOID)serialNumber, FT_OPEN_BY_SERIAL_NUMBER, &ftHandle); if (ftStatus != FT_OK) { - return true; + std::cout << " [DMXSENDER] " << "Error when connecting the DMXDevice..." << std::endl; + return DMX_OPEN_ERROR; } + std::cout << " [DMXSENDER] " << "DMXDevice connected, setting up..." << std::endl; + ftStatus = FT_SetBaudRate(ftHandle, 250000); + if (ftStatus != FT_OK) { + std::cout << " [DMXSENDER] " << "Error when setting the baudrate..." << std::endl; + FT_Close(ftHandle); + return DMX_SET_BAUDRATE_ERROR; + } ftStatus |= FT_SetDataCharacteristics(ftHandle, 8, FT_STOP_BITS_2, FT_PARITY_NONE); // 8 bits, no parity, 1 stop bit + if (ftStatus != FT_OK) { + std::cout << " [DMXSENDER] " << "Error when setting the data characteristics..." << std::endl; + FT_Close(ftHandle); + return DMX_SET_DATA_CHARACTERISTICS_ERROR; + } ftStatus |= FT_SetFlowControl(ftHandle, FT_FLOW_NONE, 0, 0); if (ftStatus != FT_OK) { + std::cout << " [DMXSENDER] " << "Error when trying to set up the flow control..." << std::endl; FT_Close(ftHandle); - return true; + return DMX_SET_FLOW_ERROR; } + std::cout << " [DMXSENDER] " << "DMXDevice set up!" << std::endl; + std::cout << " [DMXSENDER] " << "Preparing sending job..." << std::endl; + // Send the DMX frames std::thread updateThread([this]() { this->sendDMX(ftHandle); }); - return false; + + updateThread.detach(); + + std::cout << " [DMXSENDER] " << "Sending job executed!" << std::endl; + std::cout << " [DMXSENDER] " << "DMXDevice connected!" << std::endl; + return DMX_OK; } // Activate the DMX flow -void DMXDevice::activate(){ +DMXError DMXDevice::activate(){ + std::cout << " [DMXSENDER] " << "Activating the DMXDevice..." << std::endl; isOutputActivated.store(true); + std::cout << " [DMXSENDER] " << "DMXDevice activated!" << std::endl; + return DMX_OK; } // Deactivate the DMX flow -void DMXDevice::deactivate(){ +DMXError DMXDevice::deactivate(){ + std::cout << " [DMXSENDER] " << "Deactivating the DMXDevice..." << std::endl; + std::cout << " [DMXSENDER] " << "Resetting channels..." << std::endl; + resetChannels(); + std::cout << " [DMXSENDER] " << "Channels resetted!" << std::endl; isOutputActivated.store(false); + std::cout << " [DMXSENDER] " << "DMXDevice deactivated!" << std::endl; + return DMX_OK; } -// Set the value of a DMX channe -void DMXDevice::setValue(int channel, int value){ +// Set the value of a DMX channel +DMXError DMXDevice::setValue(uint16_t channel, uint8_t value){ + std::cout << " [DMXSENDER] " << "Setting a channel value..." << std::endl; + if (channel < 1) { + std::cout << " [DMXSENDER] " << "Unable to set channel value: channel number too low!" << std::endl; + return DMX_CHANNEL_TOO_LOW_ERROR; + } + if (channel > 512) { + std::cout << " [DMXSENDER] " << "Unable to set channel value: channel number too high!" << std::endl; + return DMX_CHANNEL_TOO_HIGH_ERROR; + } + if(value < 0) { + std::cout << " [DMXSENDER] " << "Unable to set channel value: channel value too low!" << std::endl; + return DMX_VALUE_TOO_LOW_ERROR; + } + if(value > 255) { + std::cout << " [DMXSENDER] " << "Unable to set channel value: channel value too high!" << std::endl; + return DMX_VALUE_TOO_HIGH_ERROR; + } dmxData[channel].store(value); + std::cout << " [DMXSENDER] " << "Channel value set!" << std::endl; + return DMX_OK; } // Send a break line -void DMXDevice::sendBreak(FT_HANDLE ftHandle) { - FT_SetBreakOn(ftHandle); // Set BREAK ON +FT_STATUS DMXDevice::sendBreak(FT_HANDLE ftHandle) { + ftStatus = FT_SetBreakOn(ftHandle); // Set BREAK ON + if (ftStatus != FT_OK) { + std::cout << " [DMXSENDER] " << "Unable to put break signal ON!" << std::endl; + return ftStatus; + } std::this_thread::sleep_for(std::chrono::microseconds(BREAK_DURATION_US)); - FT_SetBreakOff(ftHandle); // Set BREAK OFF + ftStatus = FT_SetBreakOff(ftHandle); // Set BREAK OFF + if (ftStatus != FT_OK) { + std::cout << " [DMXSENDER] " << "Unable to put break signal OFF!" << std::endl; + return ftStatus; + } + return ftStatus; } // Continuously send the DMX frame @@ -73,7 +145,12 @@ void DMXDevice::sendDMX(FT_HANDLE ftHandle) { while (true) { if(isOutputActivated){ // Send the BREAK - sendBreak(ftHandle); + ftStatus = sendBreak(ftHandle); + if (ftStatus != FT_OK) { + std::cout << " [DMXSENDER] " << "Unable to send break signal! Deactivating output..." << std::endl; + deactivate(); + continue; + } // Send the MAB std::this_thread::sleep_for(std::chrono::microseconds(MAB_DURATION_US)); @@ -81,8 +158,9 @@ void DMXDevice::sendDMX(FT_HANDLE ftHandle) { DWORD bytesWritten = 0; // Send the DMX frame - FT_STATUS status = FT_Write(ftHandle, dmxData, DMX_CHANNELS, &bytesWritten); - if (status != FT_OK || bytesWritten != DMX_CHANNELS) { // Error detected when trying to send the frame. Deactivate the line. + ftStatus = FT_Write(ftHandle, dmxData, DMX_CHANNELS, &bytesWritten); + if (ftStatus != FT_OK || bytesWritten != DMX_CHANNELS) { // Error detected when trying to send the frame. Deactivate the line. + std::cout << " [DMXSENDER] " << "Error when trying to send the DMX frame! Deactivating output..." << std::endl; deactivate(); continue; } @@ -93,6 +171,15 @@ void DMXDevice::sendDMX(FT_HANDLE ftHandle) { } } +// Resetting the DMX channels +void DMXDevice::resetChannels(){ + for (auto &v : dmxData) { + v.store(0); + } + dmxData[0].store(DMX_START_CODE); + std::this_thread::sleep_for(std::chrono::milliseconds(100)); +} + // Linkable functions from Golang extern "C" { // Create a new DMX device @@ -106,22 +193,38 @@ extern "C" { } // Connect a DMX device - bool dmx_connect(DMXDevice* dev, int port) { - return dev->connect(port); + DMXError dmx_connect(DMXDevice* dev, char* serialNumber) { + try{ + return dev->connect(serialNumber); + } catch (...) { + return DMX_UNKNOWN_ERROR; + } } // Activate a DMX device - void dmx_activate(DMXDevice* dev) { - dev->activate(); + DMXError dmx_activate(DMXDevice* dev) { + try{ + return dev->activate(); + } catch (...) { + return DMX_UNKNOWN_ERROR; + } } // Deactivate a DMX device - void dmx_deactivate(DMXDevice* dev) { - dev->deactivate(); + DMXError dmx_deactivate(DMXDevice* dev) { + try{ + return dev->activate(); + } catch (...) { + return DMX_UNKNOWN_ERROR; + } } // Set the channel value of a DMX device - void dmx_setValue(DMXDevice* dev, int channel, int value) { - dev->setValue(channel, value); + DMXError dmx_setValue(DMXDevice* dev, int channel, int value) { + try { + return dev->setValue(channel, value); + } catch (...) { + return DMX_UNKNOWN_ERROR; + } } } \ No newline at end of file diff --git a/hardware/cpp/src/dmxSender.h b/hardware/cpp/src/dmxSender.h index 70b7644..f0d3db1 100644 --- a/hardware/cpp/src/dmxSender.h +++ b/hardware/cpp/src/dmxSender.h @@ -15,6 +15,19 @@ #define FREQUENCY 44 #define INTERVAL (1000000 / FREQUENCY) +typedef enum { + DMX_OK, + DMX_CHANNEL_TOO_LOW_ERROR, + DMX_CHANNEL_TOO_HIGH_ERROR, + DMX_VALUE_TOO_LOW_ERROR, + DMX_VALUE_TOO_HIGH_ERROR, + DMX_OPEN_ERROR, + DMX_SET_BAUDRATE_ERROR, + DMX_SET_DATA_CHARACTERISTICS_ERROR, + DMX_SET_FLOW_ERROR, + DMX_UNKNOWN_ERROR +} DMXError; + class DMXDevice { public: // Initialize default values for starting the DMX device @@ -24,25 +37,28 @@ public: ~DMXDevice(); // Connect the device on a specific port - bool connect(int port); + DMXError connect(char* serialNumber); // Activate the DMX flow - void activate(); + DMXError activate(); // Deactivate the DMX flow - void deactivate(); + DMXError deactivate(); // Set the value of a DMX channel - void setValue(int channel, int value); + DMXError setValue(uint16_t channel, uint8_t value); + + // Resetting the DMX channels + void resetChannels(); private: FT_STATUS ftStatus; // FTDI peripheral status FT_HANDLE ftHandle = nullptr; // FTDI object - std::atomic dmxData[DMX_CHANNELS + 1]; // For storing dynamically the DMX data + std::atomic dmxData[DMX_CHANNELS + 1]; // For storing dynamically the DMX data std::atomic isOutputActivated = false; // Boolean to start/stop the DMX flow // Send a break line - void sendBreak(FT_HANDLE ftHandle); + FT_STATUS sendBreak(FT_HANDLE ftHandle); // Continuously send the DMX frame void sendDMX(FT_HANDLE ftHandle); diff --git a/hardware/cpp/test/detectFTDI_test.cpp b/hardware/cpp/test/detectFTDI_test.cpp new file mode 100644 index 0000000..181dded --- /dev/null +++ b/hardware/cpp/test/detectFTDI_test.cpp @@ -0,0 +1,14 @@ +#include "../src/detectFTDI.h" +#include + +int main(){ + int peripheralsNumber = getFTDIPeripheralsNumber(); + + + std::vector peripherals = scanFTDIPeripherals(); + + // for (const auto& peripheral : peripherals) { + // std::cout << peripheral.serialNumber << " (" << peripheral.description << ") -> IS OPEN: " << peripheral.isOpen << std::endl; + // } + +} \ No newline at end of file diff --git a/hardware/cpp/test/dmxSender_test.cpp b/hardware/cpp/test/dmxSender_test.cpp new file mode 100644 index 0000000..12e4e77 --- /dev/null +++ b/hardware/cpp/test/dmxSender_test.cpp @@ -0,0 +1,122 @@ +#include "../src/dmxSender.h" + +#include +#include +#include + +int main(){ + std::cout << "Debugging application DMXSENDER" << std::endl; + + DMXDevice* dev = nullptr; + try { + dev = new DMXDevice(); + } + catch(const std::exception &e){ + std::cout << "Unable to create a DMX device: " << e.what() << std::endl; + } + + if (!dev) { + std::cout << "Device not created, aborting." << std::endl; + return 1; + } + + try { + bool err = dev->connect(0); + + if (err == true) { + delete dev; + return 1; + } + } + catch (const std::exception &e){ + std::cout << "Unable to connect" << e.what() << std::endl; + delete dev; + return 1; + } + + try{ + dev->activate(); + } + catch(const std::exception &e){ + std::cout << "Unable to activate" << e.what() << std::endl; + delete dev; + return 1; + } + + try{ + dev->setValue(1, 100); + dev->setValue(2, 255); + } + catch(const std::exception &e){ + std::cout << "Unable to activate" << e.what() << std::endl; + delete dev; + return 1; + } + + Sleep(500); + + try{ + dev->setValue(2, 127); + dev->setValue(3, 255); + } + catch(const std::exception &e){ + std::cout << "Unable to activate" << e.what() << std::endl; + delete dev; + return 1; + } + + Sleep(500); + + try{ + dev->setValue(3, 127); + dev->setValue(4, 255); + } + catch(const std::exception &e){ + std::cout << "Unable to activate" << e.what() << std::endl; + delete dev; + return 1; + } + + Sleep(500); + + + try{ + dev->setValue(2, 0); + dev->setValue(3, 0); + dev->setValue(4, 0); + dev->setValue(5, 255); + } + catch(const std::exception &e){ + std::cout << "Unable to activate" << e.what() << std::endl; + delete dev; + return 1; + } + + Sleep(5000); + + + // try{ + // dev->setValue(3, 255); + // } + // catch(const std::exception &e){ + // std::cout << "Unable to activate" << e.what() << std::endl; + // delete dev; + // return 1; + // } + + // Sleep(5000); + + // try{ + // dev->setValue(4, 255); + // } + // catch(const std::exception &e){ + // std::cout << "Unable to activate" << e.what() << std::endl; + // delete dev; + // return 1; + // } + + // Sleep(5000); + + delete dev; + return 0; +} \ No newline at end of file diff --git a/hardware/interfaces.go b/hardware/interfaces.go index 09f568f..ec415ba 100644 --- a/hardware/interfaces.go +++ b/hardware/interfaces.go @@ -5,7 +5,8 @@ import "context" // Peripheral represents the methods used to manage a peripheral (input or output hardware) type Peripheral interface { Connect(context.Context) error // Connect the peripheral - Disconnect() error // Disconnect the peripheral + IsConnected() bool // Return if the peripheral is connected or not + Disconnect(context.Context) error // Disconnect the peripheral Activate(context.Context) error // Activate the peripheral Deactivate(context.Context) error // Deactivate the peripheral SetSettings(map[string]interface{}) error // Set a peripheral setting @@ -31,7 +32,7 @@ type PeripheralFinder interface { Stop() error // Stop the detection ForceScan() // Explicitly scans for peripherals RegisterPeripheral(context.Context, PeripheralInfo) (string, error) // Registers a new peripheral data - UnregisterPeripheral(string) error // Unregisters an existing peripheral + UnregisterPeripheral(context.Context, string) error // Unregisters an existing peripheral GetPeripheralSettings(string) (map[string]interface{}, error) // Gets the peripheral settings SetPeripheralSettings(string, map[string]interface{}) error // Sets the peripheral settings GetName() string // Get the name of the finder diff --git a/hardware/third-party/ftdi/detectFTDI.cpp b/hardware/third-party/ftdi/detectFTDI.cpp deleted file mode 100644 index d5c271f..0000000 --- a/hardware/third-party/ftdi/detectFTDI.cpp +++ /dev/null @@ -1,44 +0,0 @@ -#include -#include -#include -#include "ftd2xx.h" - -int main() { - FT_STATUS ftStatus; - FT_HANDLE ftHandle = nullptr; - FT_DEVICE_LIST_INFO_NODE *devInfo; - DWORD numDevs; - - // create the device information list - ftStatus = FT_CreateDeviceInfoList(&numDevs); - if (ftStatus != FT_OK) { - std::cerr << "Unable to get the FTDI devices : create list error" << std::endl; - return 1; - } - if (numDevs > 0) { - // allocate storage for list based on numDevs - devInfo = - (FT_DEVICE_LIST_INFO_NODE*)malloc(sizeof(FT_DEVICE_LIST_INFO_NODE)*numDevs); - // get the device information list - ftStatus = FT_GetDeviceInfoList(devInfo, &numDevs); - if (ftStatus != FT_OK) { - std::cerr << "Unable to get the FTDI devices : get list error" << std::endl; - return 1; - } - - for (int i = 0; i < numDevs; i++) { - if (devInfo[i].SerialNumber[0] != '\0') { - std::cout << i << ":" << devInfo[i].SerialNumber << ":" << devInfo[i].Description << ":"; - - // Add information about the hardware open state - if (devInfo[i].Flags & FT_FLAGS_OPENED) { - std::cout << "O" << std::endl; - } else { - std::cout << "C" << std::endl; - } - } - } - - free(devInfo); - } -} \ No newline at end of file diff --git a/hardware/third-party/ftdi/detectFTDI.manifest b/hardware/third-party/ftdi/detectFTDI.manifest deleted file mode 100644 index a048981..0000000 --- a/hardware/third-party/ftdi/detectFTDI.manifest +++ /dev/null @@ -1,12 +0,0 @@ - - - - Detect FTDI - - - - - - - - \ No newline at end of file diff --git a/hardware/third-party/ftdi/include/ftd2xx.h b/hardware/third-party/ftdi/include/ftd2xx.h deleted file mode 100644 index 71bc79b..0000000 --- a/hardware/third-party/ftdi/include/ftd2xx.h +++ /dev/null @@ -1,1667 +0,0 @@ -/*++ - -Copyright © 2001-2021 Future Technology Devices International Limited - -THIS SOFTWARE IS PROVIDED BY FUTURE TECHNOLOGY DEVICES INTERNATIONAL LIMITED "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL -FUTURE TECHNOLOGY DEVICES INTERNATIONAL LIMITED BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT -OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS OR BUSINESS INTERRUPTION) -HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR -TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, -EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -FTDI DRIVERS MAY BE USED ONLY IN CONJUNCTION WITH PRODUCTS BASED ON FTDI PARTS. - -FTDI DRIVERS MAY BE DISTRIBUTED IN ANY FORM AS LONG AS LICENSE INFORMATION IS NOT MODIFIED. - -IF A CUSTOM VENDOR ID AND/OR PRODUCT ID OR DESCRIPTION STRING ARE USED, IT IS THE -RESPONSIBILITY OF THE PRODUCT MANUFACTURER TO MAINTAIN ANY CHANGES AND SUBSEQUENT WHQL -RE-CERTIFICATION AS A RESULT OF MAKING THESE CHANGES. - - -Module Name: - -ftd2xx.h - -Abstract: - -Native USB device driver for FTDI FT232x, FT245x, FT2232x, FT4232x, FT2233H and FT4233H devices -FTD2XX library definitions - -Environment: - -kernel & user mode - - ---*/ - - -#ifndef FTD2XX_H -#define FTD2XX_H - -#ifdef _WIN32 -// Compiling on Windows -#include - -// The following ifdef block is the standard way of creating macros -// which make exporting from a DLL simpler. All files within this DLL -// are compiled with the FTD2XX_EXPORTS symbol defined on the command line. -// This symbol should not be defined on any project that uses this DLL. -// This way any other project whose source files include this file see -// FTD2XX_API functions as being imported from a DLL, whereas this DLL -// sees symbols defined with this macro as being exported. - -#ifdef FTD2XX_EXPORTS -#define FTD2XX_API __declspec(dllexport) -#elif defined(FTD2XX_STATIC) -// Avoid decorations when linking statically to D2XX. -#define FTD2XX_API -// Static D2XX depends on these Windows libs: -#pragma comment(lib, "setupapi.lib") -#pragma comment(lib, "advapi32.lib") -#pragma comment(lib, "user32.lib") -#else -#define FTD2XX_API __declspec(dllimport) -#endif - -#else // _WIN32 -// Compiling on non-Windows platform. -#include "WinTypes.h" -// No decorations needed. -#define FTD2XX_API - -#endif // _WIN32 - -typedef PVOID FT_HANDLE; -typedef ULONG FT_STATUS; - -// -// Device status -// -enum { - FT_OK, - FT_INVALID_HANDLE, - FT_DEVICE_NOT_FOUND, - FT_DEVICE_NOT_OPENED, - FT_IO_ERROR, - FT_INSUFFICIENT_RESOURCES, - FT_INVALID_PARAMETER, - FT_INVALID_BAUD_RATE, - - FT_DEVICE_NOT_OPENED_FOR_ERASE, - FT_DEVICE_NOT_OPENED_FOR_WRITE, - FT_FAILED_TO_WRITE_DEVICE, - FT_EEPROM_READ_FAILED, - FT_EEPROM_WRITE_FAILED, - FT_EEPROM_ERASE_FAILED, - FT_EEPROM_NOT_PRESENT, - FT_EEPROM_NOT_PROGRAMMED, - FT_INVALID_ARGS, - FT_NOT_SUPPORTED, - FT_OTHER_ERROR, - FT_DEVICE_LIST_NOT_READY, -}; - - -#define FT_SUCCESS(status) ((status) == FT_OK) - -// -// FT_OpenEx Flags -// - -#define FT_OPEN_BY_SERIAL_NUMBER 1 -#define FT_OPEN_BY_DESCRIPTION 2 -#define FT_OPEN_BY_LOCATION 4 - -#define FT_OPEN_MASK (FT_OPEN_BY_SERIAL_NUMBER | \ - FT_OPEN_BY_DESCRIPTION | \ - FT_OPEN_BY_LOCATION) - -// -// FT_ListDevices Flags (used in conjunction with FT_OpenEx Flags -// - -#define FT_LIST_NUMBER_ONLY 0x80000000 -#define FT_LIST_BY_INDEX 0x40000000 -#define FT_LIST_ALL 0x20000000 - -#define FT_LIST_MASK (FT_LIST_NUMBER_ONLY|FT_LIST_BY_INDEX|FT_LIST_ALL) - -// -// Baud Rates -// - -#define FT_BAUD_300 300 -#define FT_BAUD_600 600 -#define FT_BAUD_1200 1200 -#define FT_BAUD_2400 2400 -#define FT_BAUD_4800 4800 -#define FT_BAUD_9600 9600 -#define FT_BAUD_14400 14400 -#define FT_BAUD_19200 19200 -#define FT_BAUD_38400 38400 -#define FT_BAUD_57600 57600 -#define FT_BAUD_115200 115200 -#define FT_BAUD_230400 230400 -#define FT_BAUD_460800 460800 -#define FT_BAUD_921600 921600 - -// -// Word Lengths -// - -#define FT_BITS_8 (UCHAR) 8 -#define FT_BITS_7 (UCHAR) 7 - -// -// Stop Bits -// - -#define FT_STOP_BITS_1 (UCHAR) 0 -#define FT_STOP_BITS_2 (UCHAR) 2 - -// -// Parity -// - -#define FT_PARITY_NONE (UCHAR) 0 -#define FT_PARITY_ODD (UCHAR) 1 -#define FT_PARITY_EVEN (UCHAR) 2 -#define FT_PARITY_MARK (UCHAR) 3 -#define FT_PARITY_SPACE (UCHAR) 4 - -// -// Flow Control -// - -#define FT_FLOW_NONE 0x0000 -#define FT_FLOW_RTS_CTS 0x0100 -#define FT_FLOW_DTR_DSR 0x0200 -#define FT_FLOW_XON_XOFF 0x0400 - -// -// Purge rx and tx buffers -// -#define FT_PURGE_RX 1 -#define FT_PURGE_TX 2 - -// -// Events -// - -typedef void(*PFT_EVENT_HANDLER)(DWORD, DWORD); - -#define FT_EVENT_RXCHAR 1 -#define FT_EVENT_MODEM_STATUS 2 -#define FT_EVENT_LINE_STATUS 4 - -// -// Timeouts -// - -#define FT_DEFAULT_RX_TIMEOUT 300 -#define FT_DEFAULT_TX_TIMEOUT 300 - -// -// Device types -// - -typedef ULONG FT_DEVICE; - -enum { - FT_DEVICE_BM, - FT_DEVICE_AM, - FT_DEVICE_100AX, - FT_DEVICE_UNKNOWN, - FT_DEVICE_2232C, - FT_DEVICE_232R, - FT_DEVICE_2232H, - FT_DEVICE_4232H, - FT_DEVICE_232H, - FT_DEVICE_X_SERIES, - FT_DEVICE_4222H_0, - FT_DEVICE_4222H_1_2, - FT_DEVICE_4222H_3, - FT_DEVICE_4222_PROG, - FT_DEVICE_900, - FT_DEVICE_930, - FT_DEVICE_UMFTPD3A, - FT_DEVICE_2233HP, - FT_DEVICE_4233HP, - FT_DEVICE_2232HP, - FT_DEVICE_4232HP, - FT_DEVICE_233HP, - FT_DEVICE_232HP, - FT_DEVICE_2232HA, - FT_DEVICE_4232HA, - FT_DEVICE_232RN, -}; - -// -// Bit Modes -// - -#define FT_BITMODE_RESET 0x00 -#define FT_BITMODE_ASYNC_BITBANG 0x01 -#define FT_BITMODE_MPSSE 0x02 -#define FT_BITMODE_SYNC_BITBANG 0x04 -#define FT_BITMODE_MCU_HOST 0x08 -#define FT_BITMODE_FAST_SERIAL 0x10 -#define FT_BITMODE_CBUS_BITBANG 0x20 -#define FT_BITMODE_SYNC_FIFO 0x40 - -// -// FT232R CBUS Options EEPROM values -// - -#define FT_232R_CBUS_TXDEN 0x00 // Tx Data Enable -#define FT_232R_CBUS_PWRON 0x01 // Power On -#define FT_232R_CBUS_RXLED 0x02 // Rx LED -#define FT_232R_CBUS_TXLED 0x03 // Tx LED -#define FT_232R_CBUS_TXRXLED 0x04 // Tx and Rx LED -#define FT_232R_CBUS_SLEEP 0x05 // Sleep -#define FT_232R_CBUS_CLK48 0x06 // 48MHz clock -#define FT_232R_CBUS_CLK24 0x07 // 24MHz clock -#define FT_232R_CBUS_CLK12 0x08 // 12MHz clock -#define FT_232R_CBUS_CLK6 0x09 // 6MHz clock -#define FT_232R_CBUS_IOMODE 0x0A // IO Mode for CBUS bit-bang -#define FT_232R_CBUS_BITBANG_WR 0x0B // Bit-bang write strobe -#define FT_232R_CBUS_BITBANG_RD 0x0C // Bit-bang read strobe - -// -// FT232H CBUS Options EEPROM values -// - -#define FT_232H_CBUS_TRISTATE 0x00 // Tristate -#define FT_232H_CBUS_TXLED 0x01 // Tx LED -#define FT_232H_CBUS_RXLED 0x02 // Rx LED -#define FT_232H_CBUS_TXRXLED 0x03 // Tx and Rx LED -#define FT_232H_CBUS_PWREN 0x04 // Power Enable -#define FT_232H_CBUS_SLEEP 0x05 // Sleep -#define FT_232H_CBUS_DRIVE_0 0x06 // Drive pin to logic 0 -#define FT_232H_CBUS_DRIVE_1 0x07 // Drive pin to logic 1 -#define FT_232H_CBUS_IOMODE 0x08 // IO Mode for CBUS bit-bang -#define FT_232H_CBUS_TXDEN 0x09 // Tx Data Enable -#define FT_232H_CBUS_CLK30 0x0A // 30MHz clock -#define FT_232H_CBUS_CLK15 0x0B // 15MHz clock -#define FT_232H_CBUS_CLK7_5 0x0C // 7.5MHz clock - -// -// FT X Series CBUS Options EEPROM values -// - -#define FT_X_SERIES_CBUS_TRISTATE 0x00 // Tristate -#define FT_X_SERIES_CBUS_TXLED 0x01 // Tx LED -#define FT_X_SERIES_CBUS_RXLED 0x02 // Rx LED -#define FT_X_SERIES_CBUS_TXRXLED 0x03 // Tx and Rx LED -#define FT_X_SERIES_CBUS_PWREN 0x04 // Power Enable -#define FT_X_SERIES_CBUS_SLEEP 0x05 // Sleep -#define FT_X_SERIES_CBUS_DRIVE_0 0x06 // Drive pin to logic 0 -#define FT_X_SERIES_CBUS_DRIVE_1 0x07 // Drive pin to logic 1 -#define FT_X_SERIES_CBUS_IOMODE 0x08 // IO Mode for CBUS bit-bang -#define FT_X_SERIES_CBUS_TXDEN 0x09 // Tx Data Enable -#define FT_X_SERIES_CBUS_CLK24 0x0A // 24MHz clock -#define FT_X_SERIES_CBUS_CLK12 0x0B // 12MHz clock -#define FT_X_SERIES_CBUS_CLK6 0x0C // 6MHz clock -#define FT_X_SERIES_CBUS_BCD_CHARGER 0x0D // Battery charger detected -#define FT_X_SERIES_CBUS_BCD_CHARGER_N 0x0E // Battery charger detected inverted -#define FT_X_SERIES_CBUS_I2C_TXE 0x0F // I2C Tx empty -#define FT_X_SERIES_CBUS_I2C_RXF 0x10 // I2C Rx full -#define FT_X_SERIES_CBUS_VBUS_SENSE 0x11 // Detect VBUS -#define FT_X_SERIES_CBUS_BITBANG_WR 0x12 // Bit-bang write strobe -#define FT_X_SERIES_CBUS_BITBANG_RD 0x13 // Bit-bang read strobe -#define FT_X_SERIES_CBUS_TIMESTAMP 0x14 // Toggle output when a USB SOF token is received -#define FT_X_SERIES_CBUS_KEEP_AWAKE 0x15 // - - -// Driver types -#define FT_DRIVER_TYPE_D2XX 0 -#define FT_DRIVER_TYPE_VCP 1 - - - -#ifdef __cplusplus -extern "C" { -#endif - - -#ifdef FTD2XX_STATIC - FTD2XX_API - FT_STATUS WINAPI FT_Initialise( - void - ); - - FTD2XX_API - void WINAPI FT_Finalise( - void - ); -#endif // FTD2XX_STATIC - - FTD2XX_API - FT_STATUS WINAPI FT_Open( - int deviceNumber, - FT_HANDLE *pHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_OpenEx( - PVOID pArg1, - DWORD Flags, - FT_HANDLE *pHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ListDevices( - PVOID pArg1, - PVOID pArg2, - DWORD Flags - ); - - FTD2XX_API - FT_STATUS WINAPI FT_Close( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_Read( - FT_HANDLE ftHandle, - LPVOID lpBuffer, - DWORD dwBytesToRead, - LPDWORD lpBytesReturned - ); - - FTD2XX_API - FT_STATUS WINAPI FT_Write( - FT_HANDLE ftHandle, - LPVOID lpBuffer, - DWORD dwBytesToWrite, - LPDWORD lpBytesWritten - ); - - FTD2XX_API - FT_STATUS WINAPI FT_IoCtl( - FT_HANDLE ftHandle, - DWORD dwIoControlCode, - LPVOID lpInBuf, - DWORD nInBufSize, - LPVOID lpOutBuf, - DWORD nOutBufSize, - LPDWORD lpBytesReturned, - LPOVERLAPPED lpOverlapped - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetBaudRate( - FT_HANDLE ftHandle, - ULONG BaudRate - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetDivisor( - FT_HANDLE ftHandle, - USHORT Divisor - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetDataCharacteristics( - FT_HANDLE ftHandle, - UCHAR WordLength, - UCHAR StopBits, - UCHAR Parity - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetFlowControl( - FT_HANDLE ftHandle, - USHORT FlowControl, - UCHAR XonChar, - UCHAR XoffChar - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ResetDevice( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetDtr( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ClrDtr( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetRts( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ClrRts( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetModemStatus( - FT_HANDLE ftHandle, - ULONG *pModemStatus - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetChars( - FT_HANDLE ftHandle, - UCHAR EventChar, - UCHAR EventCharEnabled, - UCHAR ErrorChar, - UCHAR ErrorCharEnabled - ); - - FTD2XX_API - FT_STATUS WINAPI FT_Purge( - FT_HANDLE ftHandle, - ULONG Mask - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetTimeouts( - FT_HANDLE ftHandle, - ULONG ReadTimeout, - ULONG WriteTimeout - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetQueueStatus( - FT_HANDLE ftHandle, - DWORD *dwRxBytes - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetEventNotification( - FT_HANDLE ftHandle, - DWORD Mask, - PVOID Param - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetStatus( - FT_HANDLE ftHandle, - DWORD *dwRxBytes, - DWORD *dwTxBytes, - DWORD *dwEventDWord - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetBreakOn( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetBreakOff( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetWaitMask( - FT_HANDLE ftHandle, - DWORD Mask - ); - - FTD2XX_API - FT_STATUS WINAPI FT_WaitOnMask( - FT_HANDLE ftHandle, - DWORD *Mask - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetEventStatus( - FT_HANDLE ftHandle, - DWORD *dwEventDWord - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ReadEE( - FT_HANDLE ftHandle, - DWORD dwWordOffset, - LPWORD lpwValue - ); - - FTD2XX_API - FT_STATUS WINAPI FT_WriteEE( - FT_HANDLE ftHandle, - DWORD dwWordOffset, - WORD wValue - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EraseEE( - FT_HANDLE ftHandle - ); - - // - // structure to hold program data for FT_EE_Program, FT_EE_ProgramEx, FT_EE_Read - // and FT_EE_ReadEx functions - // - typedef struct ft_program_data { - - DWORD Signature1; // Header - must be 0x00000000 - DWORD Signature2; // Header - must be 0xffffffff - DWORD Version; // Header - FT_PROGRAM_DATA version - // 0 = original - // 1 = FT2232 extensions - // 2 = FT232R extensions - // 3 = FT2232H extensions - // 4 = FT4232H extensions - // 5 = FT232H extensions - - WORD VendorId; // 0x0403 - WORD ProductId; // 0x6001 - char *Manufacturer; // "FTDI" - char *ManufacturerId; // "FT" - char *Description; // "USB HS Serial Converter" - char *SerialNumber; // "FT000001" if fixed, or NULL - WORD MaxPower; // 0 < MaxPower <= 500 - WORD PnP; // 0 = disabled, 1 = enabled - WORD SelfPowered; // 0 = bus powered, 1 = self powered - WORD RemoteWakeup; // 0 = not capable, 1 = capable - // - // Rev4 (FT232B) extensions - // - UCHAR Rev4; // non-zero if Rev4 chip, zero otherwise - UCHAR IsoIn; // non-zero if in endpoint is isochronous - UCHAR IsoOut; // non-zero if out endpoint is isochronous - UCHAR PullDownEnable; // non-zero if pull down enabled - UCHAR SerNumEnable; // non-zero if serial number to be used - UCHAR USBVersionEnable; // non-zero if chip uses USBVersion - WORD USBVersion; // BCD (0x0200 => USB2) - // - // Rev 5 (FT2232) extensions - // - UCHAR Rev5; // non-zero if Rev5 chip, zero otherwise - UCHAR IsoInA; // non-zero if in endpoint is isochronous - UCHAR IsoInB; // non-zero if in endpoint is isochronous - UCHAR IsoOutA; // non-zero if out endpoint is isochronous - UCHAR IsoOutB; // non-zero if out endpoint is isochronous - UCHAR PullDownEnable5; // non-zero if pull down enabled - UCHAR SerNumEnable5; // non-zero if serial number to be used - UCHAR USBVersionEnable5; // non-zero if chip uses USBVersion - WORD USBVersion5; // BCD (0x0200 => USB2) - UCHAR AIsHighCurrent; // non-zero if interface is high current - UCHAR BIsHighCurrent; // non-zero if interface is high current - UCHAR IFAIsFifo; // non-zero if interface is 245 FIFO - UCHAR IFAIsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR IFAIsFastSer; // non-zero if interface is Fast serial - UCHAR AIsVCP; // non-zero if interface is to use VCP drivers - UCHAR IFBIsFifo; // non-zero if interface is 245 FIFO - UCHAR IFBIsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR IFBIsFastSer; // non-zero if interface is Fast serial - UCHAR BIsVCP; // non-zero if interface is to use VCP drivers - // - // Rev 6 (FT232R) extensions - // - UCHAR UseExtOsc; // Use External Oscillator - UCHAR HighDriveIOs; // High Drive I/Os - UCHAR EndpointSize; // Endpoint size - UCHAR PullDownEnableR; // non-zero if pull down enabled - UCHAR SerNumEnableR; // non-zero if serial number to be used - UCHAR InvertTXD; // non-zero if invert TXD - UCHAR InvertRXD; // non-zero if invert RXD - UCHAR InvertRTS; // non-zero if invert RTS - UCHAR InvertCTS; // non-zero if invert CTS - UCHAR InvertDTR; // non-zero if invert DTR - UCHAR InvertDSR; // non-zero if invert DSR - UCHAR InvertDCD; // non-zero if invert DCD - UCHAR InvertRI; // non-zero if invert RI - UCHAR Cbus0; // Cbus Mux control - UCHAR Cbus1; // Cbus Mux control - UCHAR Cbus2; // Cbus Mux control - UCHAR Cbus3; // Cbus Mux control - UCHAR Cbus4; // Cbus Mux control - UCHAR RIsD2XX; // non-zero if using D2XX driver - // - // Rev 7 (FT2232H) Extensions - // - UCHAR PullDownEnable7; // non-zero if pull down enabled - UCHAR SerNumEnable7; // non-zero if serial number to be used - UCHAR ALSlowSlew; // non-zero if AL pins have slow slew - UCHAR ALSchmittInput; // non-zero if AL pins are Schmitt input - UCHAR ALDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR AHSlowSlew; // non-zero if AH pins have slow slew - UCHAR AHSchmittInput; // non-zero if AH pins are Schmitt input - UCHAR AHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR BLSlowSlew; // non-zero if BL pins have slow slew - UCHAR BLSchmittInput; // non-zero if BL pins are Schmitt input - UCHAR BLDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR BHSlowSlew; // non-zero if BH pins have slow slew - UCHAR BHSchmittInput; // non-zero if BH pins are Schmitt input - UCHAR BHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR IFAIsFifo7; // non-zero if interface is 245 FIFO - UCHAR IFAIsFifoTar7; // non-zero if interface is 245 FIFO CPU target - UCHAR IFAIsFastSer7; // non-zero if interface is Fast serial - UCHAR AIsVCP7; // non-zero if interface is to use VCP drivers - UCHAR IFBIsFifo7; // non-zero if interface is 245 FIFO - UCHAR IFBIsFifoTar7; // non-zero if interface is 245 FIFO CPU target - UCHAR IFBIsFastSer7; // non-zero if interface is Fast serial - UCHAR BIsVCP7; // non-zero if interface is to use VCP drivers - UCHAR PowerSaveEnable; // non-zero if using BCBUS7 to save power for self-powered designs - // - // Rev 8 (FT4232H) Extensions - // - UCHAR PullDownEnable8; // non-zero if pull down enabled - UCHAR SerNumEnable8; // non-zero if serial number to be used - UCHAR ASlowSlew; // non-zero if A pins have slow slew - UCHAR ASchmittInput; // non-zero if A pins are Schmitt input - UCHAR ADriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR BSlowSlew; // non-zero if B pins have slow slew - UCHAR BSchmittInput; // non-zero if B pins are Schmitt input - UCHAR BDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR CSlowSlew; // non-zero if C pins have slow slew - UCHAR CSchmittInput; // non-zero if C pins are Schmitt input - UCHAR CDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR DSlowSlew; // non-zero if D pins have slow slew - UCHAR DSchmittInput; // non-zero if D pins are Schmitt input - UCHAR DDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR ARIIsTXDEN; // non-zero if port A uses RI as RS485 TXDEN - UCHAR BRIIsTXDEN; // non-zero if port B uses RI as RS485 TXDEN - UCHAR CRIIsTXDEN; // non-zero if port C uses RI as RS485 TXDEN - UCHAR DRIIsTXDEN; // non-zero if port D uses RI as RS485 TXDEN - UCHAR AIsVCP8; // non-zero if interface is to use VCP drivers - UCHAR BIsVCP8; // non-zero if interface is to use VCP drivers - UCHAR CIsVCP8; // non-zero if interface is to use VCP drivers - UCHAR DIsVCP8; // non-zero if interface is to use VCP drivers - // - // Rev 9 (FT232H) Extensions - // - UCHAR PullDownEnableH; // non-zero if pull down enabled - UCHAR SerNumEnableH; // non-zero if serial number to be used - UCHAR ACSlowSlewH; // non-zero if AC pins have slow slew - UCHAR ACSchmittInputH; // non-zero if AC pins are Schmitt input - UCHAR ACDriveCurrentH; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR ADSlowSlewH; // non-zero if AD pins have slow slew - UCHAR ADSchmittInputH; // non-zero if AD pins are Schmitt input - UCHAR ADDriveCurrentH; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR Cbus0H; // Cbus Mux control - UCHAR Cbus1H; // Cbus Mux control - UCHAR Cbus2H; // Cbus Mux control - UCHAR Cbus3H; // Cbus Mux control - UCHAR Cbus4H; // Cbus Mux control - UCHAR Cbus5H; // Cbus Mux control - UCHAR Cbus6H; // Cbus Mux control - UCHAR Cbus7H; // Cbus Mux control - UCHAR Cbus8H; // Cbus Mux control - UCHAR Cbus9H; // Cbus Mux control - UCHAR IsFifoH; // non-zero if interface is 245 FIFO - UCHAR IsFifoTarH; // non-zero if interface is 245 FIFO CPU target - UCHAR IsFastSerH; // non-zero if interface is Fast serial - UCHAR IsFT1248H; // non-zero if interface is FT1248 - UCHAR FT1248CpolH; // FT1248 clock polarity - clock idle high (1) or clock idle low (0) - UCHAR FT1248LsbH; // FT1248 data is LSB (1) or MSB (0) - UCHAR FT1248FlowControlH; // FT1248 flow control enable - UCHAR IsVCPH; // non-zero if interface is to use VCP drivers - UCHAR PowerSaveEnableH; // non-zero if using ACBUS7 to save power for self-powered designs - - } FT_PROGRAM_DATA, *PFT_PROGRAM_DATA; - - FTD2XX_API - FT_STATUS WINAPI FT_EE_Program( - FT_HANDLE ftHandle, - PFT_PROGRAM_DATA pData - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_ProgramEx( - FT_HANDLE ftHandle, - PFT_PROGRAM_DATA pData, - char *Manufacturer, - char *ManufacturerId, - char *Description, - char *SerialNumber - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_Read( - FT_HANDLE ftHandle, - PFT_PROGRAM_DATA pData - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_ReadEx( - FT_HANDLE ftHandle, - PFT_PROGRAM_DATA pData, - char *Manufacturer, - char *ManufacturerId, - char *Description, - char *SerialNumber - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_UASize( - FT_HANDLE ftHandle, - LPDWORD lpdwSize - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_UAWrite( - FT_HANDLE ftHandle, - PUCHAR pucData, - DWORD dwDataLen - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_UARead( - FT_HANDLE ftHandle, - PUCHAR pucData, - DWORD dwDataLen, - LPDWORD lpdwBytesRead - ); - - - typedef struct ft_eeprom_header { - FT_DEVICE deviceType; // FTxxxx device type to be programmed - // Device descriptor options - WORD VendorId; // 0x0403 - WORD ProductId; // 0x6001 - UCHAR SerNumEnable; // non-zero if serial number to be used - // Config descriptor options - WORD MaxPower; // 0 < MaxPower <= 500 - UCHAR SelfPowered; // 0 = bus powered, 1 = self powered - UCHAR RemoteWakeup; // 0 = not capable, 1 = capable - // Hardware options - UCHAR PullDownEnable; // non-zero if pull down in suspend enabled - } FT_EEPROM_HEADER, *PFT_EEPROM_HEADER; - - - // FT232B EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_232b { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - } FT_EEPROM_232B, *PFT_EEPROM_232B; - - - // FT2232 EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_2232 { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - // Drive options - UCHAR AIsHighCurrent; // non-zero if interface is high current - UCHAR BIsHighCurrent; // non-zero if interface is high current - // Hardware options - UCHAR AIsFifo; // non-zero if interface is 245 FIFO - UCHAR AIsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR AIsFastSer; // non-zero if interface is Fast serial - UCHAR BIsFifo; // non-zero if interface is 245 FIFO - UCHAR BIsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR BIsFastSer; // non-zero if interface is Fast serial - // Driver option - UCHAR ADriverType; // non-zero if interface is to use VCP drivers - UCHAR BDriverType; // non-zero if interface is to use VCP drivers - } FT_EEPROM_2232, *PFT_EEPROM_2232; - - - // FT232R EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_232r { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - // Drive options - UCHAR IsHighCurrent; // non-zero if interface is high current - // Hardware options - UCHAR UseExtOsc; // Use External Oscillator - UCHAR InvertTXD; // non-zero if invert TXD - UCHAR InvertRXD; // non-zero if invert RXD - UCHAR InvertRTS; // non-zero if invert RTS - UCHAR InvertCTS; // non-zero if invert CTS - UCHAR InvertDTR; // non-zero if invert DTR - UCHAR InvertDSR; // non-zero if invert DSR - UCHAR InvertDCD; // non-zero if invert DCD - UCHAR InvertRI; // non-zero if invert RI - UCHAR Cbus0; // Cbus Mux control - UCHAR Cbus1; // Cbus Mux control - UCHAR Cbus2; // Cbus Mux control - UCHAR Cbus3; // Cbus Mux control - UCHAR Cbus4; // Cbus Mux control - // Driver option - UCHAR DriverType; // non-zero if using D2XX driver - } FT_EEPROM_232R, *PFT_EEPROM_232R; - - - // FT2232H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_2232h { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - // Drive options - UCHAR ALSlowSlew; // non-zero if AL pins have slow slew - UCHAR ALSchmittInput; // non-zero if AL pins are Schmitt input - UCHAR ALDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR AHSlowSlew; // non-zero if AH pins have slow slew - UCHAR AHSchmittInput; // non-zero if AH pins are Schmitt input - UCHAR AHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR BLSlowSlew; // non-zero if BL pins have slow slew - UCHAR BLSchmittInput; // non-zero if BL pins are Schmitt input - UCHAR BLDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR BHSlowSlew; // non-zero if BH pins have slow slew - UCHAR BHSchmittInput; // non-zero if BH pins are Schmitt input - UCHAR BHDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - // Hardware options - UCHAR AIsFifo; // non-zero if interface is 245 FIFO - UCHAR AIsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR AIsFastSer; // non-zero if interface is Fast serial - UCHAR BIsFifo; // non-zero if interface is 245 FIFO - UCHAR BIsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR BIsFastSer; // non-zero if interface is Fast serial - UCHAR PowerSaveEnable; // non-zero if using BCBUS7 to save power for self-powered designs - // Driver option - UCHAR ADriverType; // non-zero if interface is to use VCP drivers - UCHAR BDriverType; // non-zero if interface is to use VCP drivers - } FT_EEPROM_2232H, *PFT_EEPROM_2232H; - - - // FT4232H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_4232h { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - // Drive options - UCHAR ASlowSlew; // non-zero if A pins have slow slew - UCHAR ASchmittInput; // non-zero if A pins are Schmitt input - UCHAR ADriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR BSlowSlew; // non-zero if B pins have slow slew - UCHAR BSchmittInput; // non-zero if B pins are Schmitt input - UCHAR BDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR CSlowSlew; // non-zero if C pins have slow slew - UCHAR CSchmittInput; // non-zero if C pins are Schmitt input - UCHAR CDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR DSlowSlew; // non-zero if D pins have slow slew - UCHAR DSchmittInput; // non-zero if D pins are Schmitt input - UCHAR DDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - // Hardware options - UCHAR ARIIsTXDEN; // non-zero if port A uses RI as RS485 TXDEN - UCHAR BRIIsTXDEN; // non-zero if port B uses RI as RS485 TXDEN - UCHAR CRIIsTXDEN; // non-zero if port C uses RI as RS485 TXDEN - UCHAR DRIIsTXDEN; // non-zero if port D uses RI as RS485 TXDEN - // Driver option - UCHAR ADriverType; // non-zero if interface is to use VCP drivers - UCHAR BDriverType; // non-zero if interface is to use VCP drivers - UCHAR CDriverType; // non-zero if interface is to use VCP drivers - UCHAR DDriverType; // non-zero if interface is to use VCP drivers - } FT_EEPROM_4232H, *PFT_EEPROM_4232H; - - - // FT232H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_232h { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - // Drive options - UCHAR ACSlowSlew; // non-zero if AC bus pins have slow slew - UCHAR ACSchmittInput; // non-zero if AC bus pins are Schmitt input - UCHAR ACDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR ADSlowSlew; // non-zero if AD bus pins have slow slew - UCHAR ADSchmittInput; // non-zero if AD bus pins are Schmitt input - UCHAR ADDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - // CBUS options - UCHAR Cbus0; // Cbus Mux control - UCHAR Cbus1; // Cbus Mux control - UCHAR Cbus2; // Cbus Mux control - UCHAR Cbus3; // Cbus Mux control - UCHAR Cbus4; // Cbus Mux control - UCHAR Cbus5; // Cbus Mux control - UCHAR Cbus6; // Cbus Mux control - UCHAR Cbus7; // Cbus Mux control - UCHAR Cbus8; // Cbus Mux control - UCHAR Cbus9; // Cbus Mux control - // FT1248 options - UCHAR FT1248Cpol; // FT1248 clock polarity - clock idle high (1) or clock idle low (0) - UCHAR FT1248Lsb; // FT1248 data is LSB (1) or MSB (0) - UCHAR FT1248FlowControl; // FT1248 flow control enable - // Hardware options - UCHAR IsFifo; // non-zero if interface is 245 FIFO - UCHAR IsFifoTar; // non-zero if interface is 245 FIFO CPU target - UCHAR IsFastSer; // non-zero if interface is Fast serial - UCHAR IsFT1248; // non-zero if interface is FT1248 - UCHAR PowerSaveEnable; // - // Driver option - UCHAR DriverType; // non-zero if interface is to use VCP drivers - } FT_EEPROM_232H, *PFT_EEPROM_232H; - - - // FT X Series EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_x_series { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - // Drive options - UCHAR ACSlowSlew; // non-zero if AC bus pins have slow slew - UCHAR ACSchmittInput; // non-zero if AC bus pins are Schmitt input - UCHAR ACDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR ADSlowSlew; // non-zero if AD bus pins have slow slew - UCHAR ADSchmittInput; // non-zero if AD bus pins are Schmitt input - UCHAR ADDriveCurrent; // valid values are 4mA, 8mA, 12mA, 16mA - // CBUS options - UCHAR Cbus0; // Cbus Mux control - UCHAR Cbus1; // Cbus Mux control - UCHAR Cbus2; // Cbus Mux control - UCHAR Cbus3; // Cbus Mux control - UCHAR Cbus4; // Cbus Mux control - UCHAR Cbus5; // Cbus Mux control - UCHAR Cbus6; // Cbus Mux control - // UART signal options - UCHAR InvertTXD; // non-zero if invert TXD - UCHAR InvertRXD; // non-zero if invert RXD - UCHAR InvertRTS; // non-zero if invert RTS - UCHAR InvertCTS; // non-zero if invert CTS - UCHAR InvertDTR; // non-zero if invert DTR - UCHAR InvertDSR; // non-zero if invert DSR - UCHAR InvertDCD; // non-zero if invert DCD - UCHAR InvertRI; // non-zero if invert RI - // Battery Charge Detect options - UCHAR BCDEnable; // Enable Battery Charger Detection - UCHAR BCDForceCbusPWREN; // asserts the power enable signal on CBUS when charging port detected - UCHAR BCDDisableSleep; // forces the device never to go into sleep mode - // I2C options - WORD I2CSlaveAddress; // I2C slave device address - DWORD I2CDeviceId; // I2C device ID - UCHAR I2CDisableSchmitt; // Disable I2C Schmitt trigger - // FT1248 options - UCHAR FT1248Cpol; // FT1248 clock polarity - clock idle high (1) or clock idle low (0) - UCHAR FT1248Lsb; // FT1248 data is LSB (1) or MSB (0) - UCHAR FT1248FlowControl; // FT1248 flow control enable - // Hardware options - UCHAR RS485EchoSuppress; // - UCHAR PowerSaveEnable; // - // Driver option - UCHAR DriverType; // non-zero if interface is to use VCP drivers - } FT_EEPROM_X_SERIES, *PFT_EEPROM_X_SERIES; - - - // FT4222H EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - typedef struct ft_eeprom_4222h { - // Common header - FT_EEPROM_HEADER common; // common elements for all device EEPROMs - CHAR Revision; // 'A', 'B', 'C', or 'D'. - UCHAR I2C_Slave_Address; - // Suspend - UCHAR SPISuspend; // 0 for "Disable SPI, tristate pins", 2 for "Keep SPI pin status", 3 for "Enable SPI pin control" - UCHAR SuspendOutPol; // 0 for negative, 1 for positive (not implemented on Rev A) - UCHAR EnableSuspendOut; // non-zero to enable (not implemented on Rev A) - // QSPI - UCHAR Clock_SlowSlew; // non-zero if clock pin has slow slew - UCHAR Clock_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR IO0_SlowSlew; // non-zero if IO0 pin has slow slew - UCHAR IO1_SlowSlew; // non-zero if IO1 pin has slow slew - UCHAR IO2_SlowSlew; // non-zero if IO2 pin has slow slew - UCHAR IO3_SlowSlew; // non-zero if IO3 pin has slow slew - UCHAR IO_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR SlaveSelect_PullUp; // non-zero to enable pull up - UCHAR SlaveSelect_PullDown; // non-zero to enable pull down - UCHAR SlaveSelect_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR SlaveSelect_SlowSlew; // non-zero if slave select pin has slow slew - UCHAR MISO_Suspend; // 2 for push-low, 3 for push high, 0 and 1 reserved - UCHAR SIMO_Suspend; // 2 for push-low, 3 for push high, 0 and 1 reserved - UCHAR IO2_IO3_Suspend; // 2 for push-low, 3 for push high, 0 and 1 reserved - UCHAR SlaveSelect_Suspend; // 0 for no-change (not implemented on Rev A), 2 for push-low, 3 for push high, 1 reserved - // GPIO - UCHAR GPIO0_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR GPIO1_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR GPIO2_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR GPIO3_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - UCHAR GPIO0_SlowSlew; // non-zero if IO0 pin has slow slew - UCHAR GPIO1_SlowSlew; // non-zero if IO0 pin has slow slew - UCHAR GPIO2_SlowSlew; // non-zero if IO0 pin has slow slew - UCHAR GPIO3_SlowSlew; // non-zero if IO0 pin has slow slew - UCHAR GPIO0_PullDown; // non-zero to enable pull down - UCHAR GPIO1_PullDown; // non-zero to enable pull down - UCHAR GPIO2_PullDown; // non-zero to enable pull down - UCHAR GPIO3_PullDown; // non-zero to enable pull down - UCHAR GPIO0_PullUp; // non-zero to enable pull up - UCHAR GPIO1_PullUp; // non-zero to enable pull up - UCHAR GPIO2_PullUp; // non-zero to enable pull up - UCHAR GPIO3_PullUp; // non-zero to enable pull up - UCHAR GPIO0_OpenDrain; // non-zero to enable open drain - UCHAR GPIO1_OpenDrain; // non-zero to enable open drain - UCHAR GPIO2_OpenDrain; // non-zero to enable open drain - UCHAR GPIO3_OpenDrain; // non-zero to enable open drain - UCHAR GPIO0_Suspend; // 0 for no-change, 1 for input (not implemented on Rev A), 2 for push-low, 3 for push high - UCHAR GPIO1_Suspend; // 0 for no-change, 1 for input (not implemented on Rev A), 2 for push-low, 3 for push high - UCHAR GPIO2_Suspend; // 0 for no-change, 1 for input (not implemented on Rev A), 2 for push-low, 3 for push high - UCHAR GPIO3_Suspend; // 0 for no-change, 1 for input (not implemented on Rev A), 2 for push-low, 3 for push high - UCHAR FallingEdge; // non-zero to change GPIO on falling edge - // BCD - UCHAR BCD_Disable; // non-zero to disable BCD - UCHAR BCD_OutputActiveLow; // non-zero to set BCD output active low - UCHAR BCD_Drive; // valid values are 4mA, 8mA, 12mA, 16mA - } FT_EEPROM_4222H, *PFT_EEPROM_4222H; - - - // Power Delivery structures for use with FT_EEPROM_Read and FT_EEPROM_Program - // PDO Configuration structure, mA supported values 0 to 10230mA, mV supported values 0 to 51100mV - // This is part of the FT_EEPROM_PD structure. - typedef struct ft_eeprom_PD_PDO_mv_ma { - USHORT PDO1ma; // PDO1 mA - USHORT PDO1mv; // PDO1 mV - USHORT PDO2ma; // PDO2 mA - USHORT PDO2mv; // PDO2 mV - USHORT PDO3ma; // PDO3 mA - USHORT PDO3mv; // PDO3 mV - USHORT PDO4ma; // PDO4 mA - USHORT PDO4mv; // PDO4 mV - USHORT PDO5ma; // PDO5 mA (FTx233HP only) - USHORT PDO5mv; // PDO5 mV (FTx233HP only) - USHORT PDO6ma; // PDO6 mA (FTx233HP only) - USHORT PDO6mv; // PDO6 mV (FTx233HP only) - USHORT PDO7ma; // PDO7 mA (FTx233HP only) - USHORT PDO7mv; // PDO7 mV (FTx233HP only) - } FT_EEPROM_PD_PDO_mv_ma; - - // PD EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // This is appended to the end of the base device structure. e_g. - // struct { - // FT_EEPROM_xxx base; - // FT_EEPROM_PD pd; - // }; - // Device GPIO values are: - // FTx233HP - 0 to 7, 15 for N/A - // FTx232HP - 0 to 3, 15 for N/A - typedef struct ft_eeprom_pd { - // Configuration - UCHAR srprs; // non-zero to enable Sink Request Power Role Swap - UCHAR sraprs; // non-zero to enable Sink Accept PR Swap - UCHAR srrprs; // non-zero to enable Source Request PR SWAP - UCHAR saprs; // non-zero to enable Source Accept PR SWAP - UCHAR vconns; // non-zero to enable vConn Swap - UCHAR passthru; // non-zero to enable Pass Through (FTx233HP only) - UCHAR extmcu; // non-zero to enable External MCU - UCHAR pd2en; // non-zero to enable PD2 (FTx233HP only) - UCHAR pd1autoclk; // non-zero to enable PD1 Auto Clock - UCHAR pd2autoclk; // non-zero to enable PD2 Auto Clock (FTx233HP only) - UCHAR useefuse; // non-zero to Use EFUSE - UCHAR extvconn; // non-zero to enable External vConn - - // GPIO Configuration - UCHAR count; // GPIO Count, supported values are 0 to 7 - UCHAR gpio1; // GPIO Number 1, supports device GPIO values - UCHAR gpio2; // GPIO Number 2, supports device GPIO values - UCHAR gpio3; // GPIO Number 3, supports device GPIO values - UCHAR gpio4; // GPIO Number 4, supports device GPIO values - UCHAR gpio5; // GPIO Number 5, supports device GPIO values (FTx233HP only) - UCHAR gpio6; // GPIO Number 6, supports device GPIO values (FTx233HP only) - UCHAR gpio7; // GPIO Number 7, supports device GPIO values (FTx233HP only) - UCHAR pd1lden; // PD1 Load Enable, supports device GPIO values - UCHAR pd2lden; // PD2 Load Enable, supports device GPIO values (FTx233HP only) - UCHAR dispin; // Discharge Pin, supports device GPIO values - UCHAR disenbm; // Discharge Enable BM, 0 for "Drive Hi", 1 for "Drive Low", 2 for "Input Mode", 3 for "Don't Care" - UCHAR disdisbm; // Discharge Disable BM, 0 for "Drive Hi", 1 for "Drive Low", 2 for "Input Mode", 3 for "Don't Care" - UCHAR ccselect; // CC Select Indicator, supports device GPIO values - - // ISET Configuration - UCHAR iset1; // ISET1, supports device GPIO values - UCHAR iset2; // ISET2, supports device GPIO values - UCHAR iset3; // ISET3, supports device GPIO values - UCHAR extiset; // non-zero to enable EXTEND_ISET - UCHAR isetpd2; // non-zero to enable ISET_PD2 - UCHAR iseten; // non-zero to set ISET_ENABLED - - // BM Configuration, 0 for "Drive Hi", 1 for "Drive Low", 2 for "Input Mode", 3 for "Don't Care" - UCHAR PDO1_GPIO[7]; // PDO1 GPIO1 to GPIO7 - UCHAR PDO2_GPIO[7]; // PDO2 GPIO1 to GPIO7 - UCHAR PDO3_GPIO[7]; // PDO3 GPIO1 to GPIO7 - UCHAR PDO4_GPIO[7]; // PDO4 GPIO1 to GPIO7 - UCHAR PDO5_GPIO[7]; // PDO5 GPIO1 to GPIO7 (FTx233HP only) - UCHAR PDO6_GPIO[7]; // PDO6 GPIO1 to GPIO7 (FTx233HP only) - UCHAR PDO7_GPIO[7]; // PDO7 GPIO1 to GPIO7 (FTx233HP only) - UCHAR VSET0V_GPIO[7]; // PDO7 GPIO1 to GPIO7 - UCHAR VSAFE5V_GPIO[7]; // PDO7 GPIO1 to GPIO7 - - FT_EEPROM_PD_PDO_mv_ma BM_PDO_Sink; - FT_EEPROM_PD_PDO_mv_ma BM_PDO_Source; - FT_EEPROM_PD_PDO_mv_ma BM_PDO_Sink_2; // (FTx233HP only) - - // PD Timers - UCHAR srt; // Sender Response Timer - UCHAR hrt; // Hard Reset Timer - UCHAR sct; // Source Capability Timer - UCHAR dit; // Discover Identity Timer - USHORT srcrt; // Source Recover Timer - USHORT trt; // Transition Timer - USHORT sofft; // Source off timer - USHORT nrt; // No Response Timer - USHORT swct; // Sink Wait Capability Timer - USHORT snkrt; // Sink Request Timer - UCHAR dt; // Discharge Timer - UCHAR cnst; // Chunk not supported timer - USHORT it; // Idle Timer - - // PD Control - UCHAR i2caddr; // I2C Address (hex) - UINT prou; // Power Reserved for OWN use - UINT trim1; // TRIM1 - UINT trim2; // TRIM2 - UCHAR extdc; // non-zero to enable ETERNAL_DC_POWER - } FT_EEPROM_PD, *PFT_EEPROM_PD; - - // FT2233HP EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // FT2232H with power delivery - typedef struct _ft_eeprom_2233hp - { - FT_EEPROM_2232H ft2232h; - FT_EEPROM_PD pd; - } FT_EEPROM_2233HP, *PFT_EEPROM_2233HP; - - // FT4233HP EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // FT4232H with power delivery - typedef struct _ft_eeprom_4233hp - { - FT_EEPROM_4232H ft4232h; - FT_EEPROM_PD pd; - } FT_EEPROM_4233HP, *PFT_EEPROM_4233HP; - - // FT2232HP EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // FT2232H with power delivery - typedef struct _ft_eeprom_2232hp - { - FT_EEPROM_2232H ft2232h; - FT_EEPROM_PD pd; - } FT_EEPROM_2232HP, *PFT_EEPROM_2232HP; - - // FT4232HP EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // FT4232H with power delivery - typedef struct _ft_eeprom_4232hp - { - FT_EEPROM_4232H ft4232h; - FT_EEPROM_PD pd; - } FT_EEPROM_4232HP, *PFT_EEPROM_4232HP; - - // FT233HP EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // FT233H with power delivery - typedef struct _ft_eeprom_233hp - { - FT_EEPROM_232H ft232h; - FT_EEPROM_PD pd; - } FT_EEPROM_233HP, *PFT_EEPROM_233HP; - - // FT232HP EEPROM structure for use with FT_EEPROM_Read and FT_EEPROM_Program - // FT232H with power delivery - typedef struct _ft_eeprom_232hp - { - FT_EEPROM_232H ft232h; - FT_EEPROM_PD pd; - } FT_EEPROM_232HP, *PFT_EEPROM_232HP; - - FTD2XX_API - FT_STATUS WINAPI FT_EEPROM_Read( - FT_HANDLE ftHandle, - void *eepromData, - DWORD eepromDataSize, - char *Manufacturer, - char *ManufacturerId, - char *Description, - char *SerialNumber - ); - - - FTD2XX_API - FT_STATUS WINAPI FT_EEPROM_Program( - FT_HANDLE ftHandle, - void *eepromData, - DWORD eepromDataSize, - char *Manufacturer, - char *ManufacturerId, - char *Description, - char *SerialNumber - ); - - - FTD2XX_API - FT_STATUS WINAPI FT_SetLatencyTimer( - FT_HANDLE ftHandle, - UCHAR ucLatency - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetLatencyTimer( - FT_HANDLE ftHandle, - PUCHAR pucLatency - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetBitMode( - FT_HANDLE ftHandle, - UCHAR ucMask, - UCHAR ucEnable - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetBitMode( - FT_HANDLE ftHandle, - PUCHAR pucMode - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetUSBParameters( - FT_HANDLE ftHandle, - ULONG ulInTransferSize, - ULONG ulOutTransferSize - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetDeadmanTimeout( - FT_HANDLE ftHandle, - ULONG ulDeadmanTimeout - ); - -#ifndef _WIN32 - // Extra functions for non-Windows platforms to compensate - // for lack of .INF file to specify Vendor and Product IDs. - - FTD2XX_API - FT_STATUS FT_SetVIDPID( - DWORD dwVID, - DWORD dwPID - ); - - FTD2XX_API - FT_STATUS FT_GetVIDPID( - DWORD * pdwVID, - DWORD * pdwPID - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetDeviceLocId( - FT_HANDLE ftHandle, - LPDWORD lpdwLocId - ); -#endif // _WIN32 - - FTD2XX_API - FT_STATUS WINAPI FT_GetDeviceInfo( - FT_HANDLE ftHandle, - FT_DEVICE *lpftDevice, - LPDWORD lpdwID, - PCHAR SerialNumber, - PCHAR Description, - LPVOID Dummy - ); - - FTD2XX_API - FT_STATUS WINAPI FT_StopInTask( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_RestartInTask( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_SetResetPipeRetryCount( - FT_HANDLE ftHandle, - DWORD dwCount - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ResetPort( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_CyclePort( - FT_HANDLE ftHandle - ); - - - // - // Win32-type functions - // - - FTD2XX_API - FT_HANDLE WINAPI FT_W32_CreateFile( - LPCTSTR lpszName, - DWORD dwAccess, - DWORD dwShareMode, - LPSECURITY_ATTRIBUTES lpSecurityAttributes, - DWORD dwCreate, - DWORD dwAttrsAndFlags, - HANDLE hTemplate - ); - - FTD2XX_API - BOOL WINAPI FT_W32_CloseHandle( - FT_HANDLE ftHandle - ); - - FTD2XX_API - BOOL WINAPI FT_W32_ReadFile( - FT_HANDLE ftHandle, - LPVOID lpBuffer, - DWORD nBufferSize, - LPDWORD lpBytesReturned, - LPOVERLAPPED lpOverlapped - ); - - FTD2XX_API - BOOL WINAPI FT_W32_WriteFile( - FT_HANDLE ftHandle, - LPVOID lpBuffer, - DWORD nBufferSize, - LPDWORD lpBytesWritten, - LPOVERLAPPED lpOverlapped - ); - - FTD2XX_API - DWORD WINAPI FT_W32_GetLastError( - FT_HANDLE ftHandle - ); - - FTD2XX_API - BOOL WINAPI FT_W32_GetOverlappedResult( - FT_HANDLE ftHandle, - LPOVERLAPPED lpOverlapped, - LPDWORD lpdwBytesTransferred, - BOOL bWait - ); - - FTD2XX_API - BOOL WINAPI FT_W32_CancelIo( - FT_HANDLE ftHandle - ); - - - // - // Win32 COMM API type functions - // - typedef struct _FTCOMSTAT { - DWORD fCtsHold : 1; - DWORD fDsrHold : 1; - DWORD fRlsdHold : 1; - DWORD fXoffHold : 1; - DWORD fXoffSent : 1; - DWORD fEof : 1; - DWORD fTxim : 1; - DWORD fReserved : 25; - DWORD cbInQue; - DWORD cbOutQue; - } FTCOMSTAT, *LPFTCOMSTAT; - - typedef struct _FTDCB { - DWORD DCBlength; /* sizeof(FTDCB) */ - DWORD BaudRate; /* Baudrate at which running */ - DWORD fBinary : 1; /* Binary Mode (skip EOF check) */ - DWORD fParity : 1; /* Enable parity checking */ - DWORD fOutxCtsFlow : 1; /* CTS handshaking on output */ - DWORD fOutxDsrFlow : 1; /* DSR handshaking on output */ - DWORD fDtrControl : 2; /* DTR Flow control */ - DWORD fDsrSensitivity : 1; /* DSR Sensitivity */ - DWORD fTXContinueOnXoff : 1; /* Continue TX when Xoff sent */ - DWORD fOutX : 1; /* Enable output X-ON/X-OFF */ - DWORD fInX : 1; /* Enable input X-ON/X-OFF */ - DWORD fErrorChar : 1; /* Enable Err Replacement */ - DWORD fNull : 1; /* Enable Null stripping */ - DWORD fRtsControl : 2; /* Rts Flow control */ - DWORD fAbortOnError : 1; /* Abort all reads and writes on Error */ - DWORD fDummy2 : 17; /* Reserved */ - WORD wReserved; /* Not currently used */ - WORD XonLim; /* Transmit X-ON threshold */ - WORD XoffLim; /* Transmit X-OFF threshold */ - BYTE ByteSize; /* Number of bits/byte, 4-8 */ - BYTE Parity; /* 0-4=None,Odd,Even,Mark,Space */ - BYTE StopBits; /* FT_STOP_BITS_1 or FT_STOP_BITS_2 */ - char XonChar; /* Tx and Rx X-ON character */ - char XoffChar; /* Tx and Rx X-OFF character */ - char ErrorChar; /* Error replacement char */ - char EofChar; /* End of Input character */ - char EvtChar; /* Received Event character */ - WORD wReserved1; /* Fill for now. */ - } FTDCB, *LPFTDCB; - - typedef struct _FTTIMEOUTS { - DWORD ReadIntervalTimeout; /* Maximum time between read chars. */ - DWORD ReadTotalTimeoutMultiplier; /* Multiplier of characters. */ - DWORD ReadTotalTimeoutConstant; /* Constant in milliseconds. */ - DWORD WriteTotalTimeoutMultiplier; /* Multiplier of characters. */ - DWORD WriteTotalTimeoutConstant; /* Constant in milliseconds. */ - } FTTIMEOUTS, *LPFTTIMEOUTS; - - - FTD2XX_API - BOOL WINAPI FT_W32_ClearCommBreak( - FT_HANDLE ftHandle - ); - - FTD2XX_API - BOOL WINAPI FT_W32_ClearCommError( - FT_HANDLE ftHandle, - LPDWORD lpdwErrors, - LPFTCOMSTAT lpftComstat - ); - - FTD2XX_API - BOOL WINAPI FT_W32_EscapeCommFunction( - FT_HANDLE ftHandle, - DWORD dwFunc - ); - - FTD2XX_API - BOOL WINAPI FT_W32_GetCommModemStatus( - FT_HANDLE ftHandle, - LPDWORD lpdwModemStatus - ); - - FTD2XX_API - BOOL WINAPI FT_W32_GetCommState( - FT_HANDLE ftHandle, - LPFTDCB lpftDcb - ); - - FTD2XX_API - BOOL WINAPI FT_W32_GetCommTimeouts( - FT_HANDLE ftHandle, - FTTIMEOUTS *pTimeouts - ); - - FTD2XX_API - BOOL WINAPI FT_W32_PurgeComm( - FT_HANDLE ftHandle, - DWORD dwMask - ); - - FTD2XX_API - BOOL WINAPI FT_W32_SetCommBreak( - FT_HANDLE ftHandle - ); - - FTD2XX_API - BOOL WINAPI FT_W32_SetCommMask( - FT_HANDLE ftHandle, - ULONG ulEventMask - ); - - FTD2XX_API - BOOL WINAPI FT_W32_GetCommMask( - FT_HANDLE ftHandle, - LPDWORD lpdwEventMask - ); - - FTD2XX_API - BOOL WINAPI FT_W32_SetCommState( - FT_HANDLE ftHandle, - LPFTDCB lpftDcb - ); - - FTD2XX_API - BOOL WINAPI FT_W32_SetCommTimeouts( - FT_HANDLE ftHandle, - FTTIMEOUTS *pTimeouts - ); - - FTD2XX_API - BOOL WINAPI FT_W32_SetupComm( - FT_HANDLE ftHandle, - DWORD dwReadBufferSize, - DWORD dwWriteBufferSize - ); - - FTD2XX_API - BOOL WINAPI FT_W32_WaitCommEvent( - FT_HANDLE ftHandle, - PULONG pulEvent, - LPOVERLAPPED lpOverlapped - ); - - - // - // Device information - // - - typedef struct _ft_device_list_info_node { - ULONG Flags; - ULONG Type; - ULONG ID; - DWORD LocId; - char SerialNumber[16]; - char Description[64]; - FT_HANDLE ftHandle; - } FT_DEVICE_LIST_INFO_NODE; - - // Device information flags - enum { - FT_FLAGS_OPENED = 1, - FT_FLAGS_HISPEED = 2 - }; - - - FTD2XX_API - FT_STATUS WINAPI FT_CreateDeviceInfoList( - LPDWORD lpdwNumDevs - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetDeviceInfoList( - FT_DEVICE_LIST_INFO_NODE *pDest, - LPDWORD lpdwNumDevs - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetDeviceInfoDetail( - DWORD dwIndex, - LPDWORD lpdwFlags, - LPDWORD lpdwType, - LPDWORD lpdwID, - LPDWORD lpdwLocId, - LPVOID lpSerialNumber, - LPVOID lpDescription, - FT_HANDLE *pftHandle - ); - - - // - // Version information - // - - FTD2XX_API - FT_STATUS WINAPI FT_GetDriverVersion( - FT_HANDLE ftHandle, - LPDWORD lpdwVersion - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetLibraryVersion( - LPDWORD lpdwVersion - ); - - - FTD2XX_API - FT_STATUS WINAPI FT_Rescan( - void - ); - - FTD2XX_API - FT_STATUS WINAPI FT_Reload( - WORD wVid, - WORD wPid - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetComPortNumber( - FT_HANDLE ftHandle, - LPLONG lpdwComPortNumber - ); - - - // - // FT232H additional EEPROM functions - // - - FTD2XX_API - FT_STATUS WINAPI FT_EE_ReadConfig( - FT_HANDLE ftHandle, - UCHAR ucAddress, - PUCHAR pucValue - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_WriteConfig( - FT_HANDLE ftHandle, - UCHAR ucAddress, - UCHAR ucValue - ); - - FTD2XX_API - FT_STATUS WINAPI FT_EE_ReadECC( - FT_HANDLE ftHandle, - UCHAR ucOption, - LPWORD lpwValue - ); - - FTD2XX_API - FT_STATUS WINAPI FT_GetQueueStatusEx( - FT_HANDLE ftHandle, - DWORD *dwRxBytes - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ComPortIdle( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_ComPortCancelIdle( - FT_HANDLE ftHandle - ); - - FTD2XX_API - FT_STATUS WINAPI FT_VendorCmdGet( - FT_HANDLE ftHandle, - UCHAR Request, - UCHAR *Buf, - USHORT Len - ); - - FTD2XX_API - FT_STATUS WINAPI FT_VendorCmdSet( - FT_HANDLE ftHandle, - UCHAR Request, - UCHAR *Buf, - USHORT Len - ); - - FTD2XX_API - FT_STATUS WINAPI FT_VendorCmdGetEx( - FT_HANDLE ftHandle, - USHORT wValue, - UCHAR *Buf, - USHORT Len - ); - - FTD2XX_API - FT_STATUS WINAPI FT_VendorCmdSetEx( - FT_HANDLE ftHandle, - USHORT wValue, - UCHAR *Buf, - USHORT Len - ); - -#ifdef __cplusplus -} -#endif - - -#endif /* FTD2XX_H */ \ No newline at end of file diff --git a/hardware/third-party/ftdi/lib/ftd2xx.lib b/hardware/third-party/ftdi/lib/ftd2xx.lib deleted file mode 100644 index 7b28fab0dbe62abcd38b6588f3702be7decbe218..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20260 zcmdU1OK)677CwX-m!^WxH)BCVt^KBs>PYu{+SB-EFnonF&G+ zLWtFfB}frM2(e(n56ET^LWl)I2q6|MW`S6-idZ0okOt;Eb?R1~y7%^_+wCl-rQ>_+ z)T#RFoO++C>j#e%YV*$@TfeU({O#}Q>dy7{_8jUB`JFbH%jN9r+G%gi$G#+D+A%HE|0@yGj>|&1 zSBRL7ZWik80S;&YIWXvf%k+Ce~a>iI^Px=_#F74eJDFq?{7jAA3=Z6Bfw?a{i@L3ZA6CNz?11`p%Lh2 zXd|AWM_&>ee+}gWjb0KO-b-ZYT|7Y}SA z`V3Fd7;I?>^)Ut--z2pE0uj^DCqjeo!)~C%>xBAIHl{w5k7@U2p*_%@X;)cj=PyJ| zT{A-azem2Hqdy6CeF{D(hcYsqSP(h{+Zsan5NQ8(Lc5^{)4n;OJ;;}-`)Q#^24Q#5 zu5W~P!q$fF#}kyl*%I=|GrcG@gglsfazdSWcIIYhN5`ior)Oq|hEM0GN2g{cr)NiI zhPuw3quJSsGh<`Pc>1RZNc7CfGZUv~hX!T_Xk=z~a;aEB!qVara*+_8`Eqr+=-Cnk zf4W#$@N5$T_iU|HSJDy$f3%vfm%X?IO)ksD`cUygXD|K!~TsOUjXQ_3!y=rCzJ5A|i$6Ta0=w%oAb6h5ol#L6RSBGgVRV%DD8$**WMI}i}Y#63d{8rE12#Y#aL-G zlrwHt@X}Raz=e7wff)`RYnVb-M=ff>5kaRclIEa$*+Z{ivvCoq#J+JY2*? zEDQ1Zi}U4Th~ilsU*mDjo0g|7Z{E~cqzcR)CP_xc<%f#(LP;&xf)q9qX<)e_Xtr3W z*v99Jm5j0&wGzg^$1#NkD;Wj|VnlkZ^lYtAyO<^(i-Now0Fu270NjqFUWRI%FQ_$* z4I`K7V!0Zwy-irkgDkkBCRP@o)e8j4T*W{dt$?c-E8p{_=e%7)w#b=TB1KU1eU8KV zd?GvMNeR{ZQ8zf0FpM$zO-)aZ%Ovf_jNxI=^fD=PzY&Z0khG>54dztM^fI>dr%9?P z$Uk1JEL3ax#RU}K>l|>k6xv*h6mzu{^3s;kxq+`Gkup_M_>df}lcfuu$8n+sr2h&y z>p+{4$9s_b7Wu#3N%T3=f4Pt7H{|sZ@IQQn=+)iu7VRZ^1N1ZKl@X$ipqCycdJXwq z8if~RnCM;574W}4AzqBjC$W1++y=<~06KSy=rd5y81w*bLfQ-ai9Q)3dLLz5hcdi| z@?3(xn}PY!9@t|S(JwoRX1a*JhwM+#^HaQUfQ}2m`TP)`pz9F#1JcZ)>@!IBH1r-s z*}p;hH<12*(9LM=Abj2V)SRanKsaq^aPF4NjgVoX$OtaPC89z=mhPe zM`$N>u4K2MpN`x8m2t0 zr-$fnx{Ef_4Kzmg(M`0OZln$xqFZPaJxuq|AU#EYqo?T^8lWyZKznHqCTw+nnNEx>rq`j-ad2+aJI3rU>!}1ob1@wAhIkJ<8AZQkI zCZ%4Xf`OUCIooW|dIoF=E%Jp)=QIi3EY9_WTpGLEVhb|KH}adTDu`I9BCWl&hZjy2$X!6lirFr3mrDMF=y&;f^XJ>9_ z!>ZzR!9=Ek^mL~A!QdD~G~U1J2~HAw1hJBs?$W>>P`V#wYfC(!Y11ToymgAKsWb6y2Sf zTfgx7wbb|D@8{NEL)hEPZ|_3!*_G!WK5c{W1rYr!3fN~qZ5Z5JTEI#B!|+weZxbG0 zfWDI;U5jTwb$)E+;ERyojd=V9`c8u8Z$EW>ybf=-!k@su^>RCbmD*0XZMYt+uS^7- z9C*I<%*OH3e66}%JzwwGF}<^6Y;*#Cm*kJJxExFb&jr8X`Ud<7{N_PW()sG*5{mlP zGuK@6`|mmhMB#y8iZt#gGNpY!;uzfo$I9eb28qbYbbAi-AK*Xs$GPKPjt%i+9Xu<9 zai;ZUvPLv9R* z$Ee2zC$<^)2zttF5-p?7&ID+@(oz+rUYkT}P-k}mWov{K`3O|*tI+9Sdh56cDET-N zR_txruR$N%44iEat8Lr4d(Yv>$D`|G0g82;D3$zc`}M@jL5#AI>)#v%xQ4!_Jqia` z8Y!rxmNm-gx!WC%JHK!WttHM5g=4RYtsW<%C*c6l+RdN3IH1;RC}S*|c1YTB=54l$ zew)#k9Fo)KJb~X!VaLF zNI{G*ELzquqxN_^E43Foc|FD|+GR$c=9RSIY1eT(Xwe;z_?jJ`H{b?Agcdjn6`X%< zvbAK?-IzxUz1$u|HPq(t-1azSt;Q}2v88sME3nr4T}I7qbZE-)uJmcWon(zFGihk; zuB00DbY5Tc?n`WG4-b?X{cDqTmN70rB;&t2k?^^d`8fv3}>( zAu#meiBiYEHfOg34O-uAK!M|sk?iFJr%dZDyunz=_0Ow!i_vaNi(H?vUdy8&`vrj# zU8-=ZtfjTsM+l7greIC2Wp={qE{IcPO;IKzP3%3BtAjETp_oHCUlXh7kr}<^I)~zp z`V^FZZLYUuc?$*=lD&H44A(MF##*f3;iyAN4}dlp!8WN=hV|Gvk2a0t5O>n)vu_|Twngxcz#_q!WbZjSD6d|V*2~a|y#*SnqAa!woicVfw>YHedX`hD z<&mMgfuDuFIqZWLjnYn~z3p1pF3YPq>QUjXQuq87pnq+@-q^EgwRB(gt=^tlUST-A zBP4ShZuKZxzEhsdMW5thzqecKb(XbG=CeM*)K>`FLCe~6uoqR()@;v_(F<_R+@hu3 zc4$Y(thU1EouXsACkR=q%Ud0aI~i9B`Pb%pS=MgjL5CDx_wX32XptFn8Sgm6e(n;9 zg7UA;X_m_v_m5j7e>27Bz6zZhv_xJxKOso&1`FSJX$z~tZh-sOQ%S6LSL_*@JsCs8 z66C6B_H+{KDr$xgShyVq_lVl5v+f4#0`6bbTp$9;TqMq3#R>qvP+hehp z$9^yn<-fM=^PtDFHx;9=BHF;q7)5&%c=n462iK}4v(|q2=rL+5R=ca)`|wd_3~w!Z zUsk(393Z-HP*!ivj5ClU9xJ?|>Z`2vevr}U@QG?vm*8l(j diff --git a/peripherals.go b/peripherals.go index d359f97..e128c1d 100644 --- a/peripherals.go +++ b/peripherals.go @@ -72,7 +72,7 @@ func (a *App) RemovePeripheral(protocolName string, peripheralID string) error { log.Err(err).Str("file", "peripherals").Str("protocolName", protocolName).Msg("unable to find the finder") return fmt.Errorf("unable to find the finder") } - err = f.UnregisterPeripheral(peripheralID) + err = f.UnregisterPeripheral(a.ctx, peripheralID) if err != nil { log.Err(err).Str("file", "peripherals").Str("peripheralID", peripheralID).Msg("unable to unregister this peripheral") return fmt.Errorf("unable to unregister this peripheral")