//**************************************************************************
// WriteFT232BEEPROM
//**************************************************************************
// Intellisense comments
/// <summary>
/// Writes the specified values to the EEPROM of an FT232B or FT245B device.
/// </summary>
/// <returns>FT_STATUS value from FT_EE_Program in FTD2XX DLL</returns>
/// <param name="ee232b">The EEPROM settings to be written to the device</param>
/// <remarks>If the strings are too long, they will be truncated to their maximum permitted lengths</remarks>
/// <exception cref="FT_EXCEPTION">Thrown when the current device does not match the type required by this method.</exception>
public FT_STATUS WriteFT232BEEPROM(FT232B_EEPROM_STRUCTURE ee232b)
{
// Initialise ftStatus to something other than FT_OK
FT_STATUS ftStatus = FT_STATUS.FT_OTHER_ERROR;
FT_ERROR ftErrorCondition = FT_ERROR.FT_NO_ERROR;
// If the DLL hasn't been loaded, just return here
if (hFTD2XXDLL == IntPtr.Zero)
return ftStatus;
// Check for our required function pointers being set up
if (pFT_EE_Program != IntPtr.Zero)
{
tFT_EE_Program FT_EE_Program = (tFT_EE_Program)Marshal.GetDelegateForFunctionPointer(pFT_EE_Program, typeof(tFT_EE_Program));
if (ftHandle != IntPtr.Zero)
{
FT_DEVICE DeviceType = FT_DEVICE.FT_DEVICE_UNKNOWN;
// Check that it is an FT232B or FT245B that we are trying to write
GetDeviceType(ref DeviceType);
if (DeviceType != FT_DEVICE.FT_DEVICE_BM)
{
// If it is not, throw an exception
ftErrorCondition = FT_ERROR.FT_INCORRECT_DEVICE;
ErrorHandler(ftStatus, ftErrorCondition);
}
// Check for VID and PID of 0x0000
if ((ee232b.VendorID == 0x0000) | (ee232b.ProductID == 0x0000))
{
// Do not allow users to program the device with VID or PID of 0x0000
return FT_STATUS.FT_INVALID_PARAMETER;
}
FT_PROGRAM_DATA eedata = new FT_PROGRAM_DATA();
// Set up structure headers
eedata.Signature1 = 0x00000000;
eedata.Signature2 = 0xFFFFFFFF;
eedata.Version = 2;
// Allocate space from unmanaged heap
eedata.Manufacturer = Marshal.AllocHGlobal(32);
eedata.ManufacturerID = Marshal.AllocHGlobal(16);
eedata.Description = Marshal.AllocHGlobal(64);
eedata.SerialNumber = Marshal.AllocHGlobal(16);
// Check lengths of strings to make sure that they are within our limits
// If not, trim them to make them our maximum length
if (ee232b.Manufacturer.Length > 32)
ee232b.Manufacturer = ee232b.Manufacturer.Substring(0, 32);
if (ee232b.ManufacturerID.Length > 16)
ee232b.ManufacturerID = ee232b.ManufacturerID.Substring(0, 16);
if (ee232b.Description.Length > 64)
ee232b.Description = ee232b.Description.Substring(0, 64);
if (ee232b.SerialNumber.Length > 16)
ee232b.SerialNumber = ee232b.SerialNumber.Substring(0, 16);
// Set string values
eedata.Manufacturer = Marshal.StringToHGlobalAnsi(ee232b.Manufacturer);
eedata.ManufacturerID = Marshal.StringToHGlobalAnsi(ee232b.ManufacturerID);
eedata.Description = Marshal.StringToHGlobalAnsi(ee232b.Description);
eedata.SerialNumber = Marshal.StringToHGlobalAnsi(ee232b.SerialNumber);
// Map non-string elements to structure
// Standard elements
eedata.VendorID = ee232b.VendorID;
eedata.ProductID = ee232b.ProductID;
eedata.MaxPower = ee232b.MaxPower;
eedata.SelfPowered = Convert.ToUInt16(ee232b.SelfPowered);
eedata.RemoteWakeup = Convert.ToUInt16(ee232b.RemoteWakeup);
// B specific fields
eedata.Rev4 = Convert.ToByte(true);
eedata.PullDownEnable = Convert.ToByte(ee232b.PullDownEnable);
eedata.SerNumEnable = Convert.ToByte(ee232b.SerNumEnable);
eedata.USBVersionEnable = Convert.ToByte(ee232b.USBVersionEnable);
eedata.USBVersion = ee232b.USBVersion;
// Call FT_EE_Program
ftStatus = FT_EE_Program(ftHandle, eedata);
// Free unmanaged buffers
Marshal.FreeHGlobal(eedata.Manufacturer);
Marshal.FreeHGlobal(eedata.ManufacturerID);
Marshal.FreeHGlobal(eedata.Description);
Marshal.FreeHGlobal(eedata.SerialNumber);
}
}
else
{
if (pFT_EE_Program == IntPtr.Zero)
{
MessageBox.Show("Failed to load function FT_EE_Program.");
}
}
return ftStatus;
}
//**************************************************************************
// ReadFT232BEEPROM
//**************************************************************************
// Intellisense comments
/// <summary>
/// Reads the EEPROM contents of an FT232B or FT245B device.
/// </summary>
/// <returns>FT_STATUS value from FT_EE_Read in FTD2XX DLL</returns>
/// <param name="ee232b">An FT232B_EEPROM_STRUCTURE which contains only the relevant information for an FT232B and FT245B device.</param>
/// <exception cref="FT_EXCEPTION">Thrown when the current device does not match the type required by this method.</exception>
public FT_STATUS ReadFT232BEEPROM(FT232B_EEPROM_STRUCTURE ee232b)
{
// Initialise ftStatus to something other than FT_OK
FT_STATUS ftStatus = FT_STATUS.FT_OTHER_ERROR;
FT_ERROR ftErrorCondition = FT_ERROR.FT_NO_ERROR;
// If the DLL hasn't been loaded, just return here
if (hFTD2XXDLL == IntPtr.Zero)
return ftStatus;
// Check for our required function pointers being set up
if (pFT_EE_Read != IntPtr.Zero)
{
tFT_EE_Read FT_EE_Read = (tFT_EE_Read)Marshal.GetDelegateForFunctionPointer(pFT_EE_Read, typeof(tFT_EE_Read));
if (ftHandle != IntPtr.Zero)
{
FT_DEVICE DeviceType = FT_DEVICE.FT_DEVICE_UNKNOWN;
// Check that it is an FT232B or FT245B that we are trying to read
GetDeviceType(ref DeviceType);
if (DeviceType != FT_DEVICE.FT_DEVICE_BM)
{
// If it is not, throw an exception
ftErrorCondition = FT_ERROR.FT_INCORRECT_DEVICE;
ErrorHandler(ftStatus, ftErrorCondition);
}
FT_PROGRAM_DATA eedata = new FT_PROGRAM_DATA();
// Set up structure headers
eedata.Signature1 = 0x00000000;
eedata.Signature2 = 0xFFFFFFFF;
eedata.Version = 2;
// Allocate space from unmanaged heap
eedata.Manufacturer = Marshal.AllocHGlobal(32);
eedata.ManufacturerID = Marshal.AllocHGlobal(16);
eedata.Description = Marshal.AllocHGlobal(64);
eedata.SerialNumber = Marshal.AllocHGlobal(16);
// Call FT_EE_Read
ftStatus = FT_EE_Read(ftHandle, eedata);
// Retrieve string values
ee232b.Manufacturer = Marshal.PtrToStringAnsi(eedata.Manufacturer);
ee232b.ManufacturerID = Marshal.PtrToStringAnsi(eedata.ManufacturerID);
ee232b.Description = Marshal.PtrToStringAnsi(eedata.Description);
ee232b.SerialNumber = Marshal.PtrToStringAnsi(eedata.SerialNumber);
// Free unmanaged buffers
Marshal.FreeHGlobal(eedata.Manufacturer);
Marshal.FreeHGlobal(eedata.ManufacturerID);
Marshal.FreeHGlobal(eedata.Description);
Marshal.FreeHGlobal(eedata.SerialNumber);
// Map non-string elements to structure to be returned
// Standard elements
ee232b.VendorID = eedata.VendorID;
ee232b.ProductID = eedata.ProductID;
ee232b.MaxPower = eedata.MaxPower;
ee232b.SelfPowered = Convert.ToBoolean(eedata.SelfPowered);
ee232b.RemoteWakeup = Convert.ToBoolean(eedata.RemoteWakeup);
// B specific fields
ee232b.PullDownEnable = Convert.ToBoolean(eedata.PullDownEnable);
ee232b.SerNumEnable = Convert.ToBoolean(eedata.SerNumEnable);
ee232b.USBVersionEnable = Convert.ToBoolean(eedata.USBVersionEnable);
ee232b.USBVersion = eedata.USBVersion;
}
}
else
{
if (pFT_EE_Read == IntPtr.Zero)
{
MessageBox.Show("Failed to load function FT_EE_Read.");
}
}
return ftStatus;
}
