//**************************************************************************
// WriteFT4232HEEPROM
//**************************************************************************
// Intellisense comments
/// <summary>
/// Writes the specified values to the EEPROM of an FT4232H device.
/// Calls FT_EE_Program in FTD2XX DLL
/// </summary>
/// <returns>FT_STATUS value from FT_EE_Program in FTD2XX DLL</returns>
/// <param name="ee4232h">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 WriteFT4232HEEPROM(FT4232H_EEPROM_STRUCTURE ee4232h)
{
// 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 FT4232H that we are trying to write
GetDeviceType(ref DeviceType);
if (DeviceType != FT_DEVICE.FT_DEVICE_4232H)
{
// If it is not, throw an exception
ftErrorCondition = FT_ERROR.FT_INCORRECT_DEVICE;
ErrorHandler(ftStatus, ftErrorCondition);
}
// Check for VID and PID of 0x0000
if ((ee4232h.VendorID == 0x0000) | (ee4232h.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 = 4;
// 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 (ee4232h.Manufacturer.Length > 32)
ee4232h.Manufacturer = ee4232h.Manufacturer.Substring(0, 32);
if (ee4232h.ManufacturerID.Length > 16)
ee4232h.ManufacturerID = ee4232h.ManufacturerID.Substring(0, 16);
if (ee4232h.Description.Length > 64)
ee4232h.Description = ee4232h.Description.Substring(0, 64);
if (ee4232h.SerialNumber.Length > 16)
ee4232h.SerialNumber = ee4232h.SerialNumber.Substring(0, 16);
// Set string values
eedata.Manufacturer = Marshal.StringToHGlobalAnsi(ee4232h.Manufacturer);
eedata.ManufacturerID = Marshal.StringToHGlobalAnsi(ee4232h.ManufacturerID);
eedata.Description = Marshal.StringToHGlobalAnsi(ee4232h.Description);
eedata.SerialNumber = Marshal.StringToHGlobalAnsi(ee4232h.SerialNumber);
// Map non-string elements to structure
// Standard elements
eedata.VendorID = ee4232h.VendorID;
eedata.ProductID = ee4232h.ProductID;
eedata.MaxPower = ee4232h.MaxPower;
eedata.SelfPowered = Convert.ToUInt16(ee4232h.SelfPowered);
eedata.RemoteWakeup = Convert.ToUInt16(ee4232h.RemoteWakeup);
// 4232H specific fields
eedata.PullDownEnable8 = Convert.ToByte(ee4232h.PullDownEnable);
eedata.SerNumEnable8 = Convert.ToByte(ee4232h.SerNumEnable);
eedata.ASlowSlew = Convert.ToByte(ee4232h.ASlowSlew);
eedata.ASchmittInput = Convert.ToByte(ee4232h.ASchmittInput);
eedata.ADriveCurrent = ee4232h.ADriveCurrent;
eedata.BSlowSlew = Convert.ToByte(ee4232h.BSlowSlew);
eedata.BSchmittInput = Convert.ToByte(ee4232h.BSchmittInput);
eedata.BDriveCurrent = ee4232h.BDriveCurrent;
eedata.CSlowSlew = Convert.ToByte(ee4232h.CSlowSlew);
eedata.CSchmittInput = Convert.ToByte(ee4232h.CSchmittInput);
eedata.CDriveCurrent = ee4232h.CDriveCurrent;
eedata.DSlowSlew = Convert.ToByte(ee4232h.DSlowSlew);
eedata.DSchmittInput = Convert.ToByte(ee4232h.DSchmittInput);
eedata.DDriveCurrent = ee4232h.DDriveCurrent;
eedata.ARIIsTXDEN = Convert.ToByte(ee4232h.ARIIsTXDEN);
eedata.BRIIsTXDEN = Convert.ToByte(ee4232h.BRIIsTXDEN);
eedata.CRIIsTXDEN = Convert.ToByte(ee4232h.CRIIsTXDEN);
eedata.DRIIsTXDEN = Convert.ToByte(ee4232h.DRIIsTXDEN);
eedata.AIsVCP8 = Convert.ToByte(ee4232h.AIsVCP);
eedata.BIsVCP8 = Convert.ToByte(ee4232h.BIsVCP);
eedata.CIsVCP8 = Convert.ToByte(ee4232h.CIsVCP);
eedata.DIsVCP8 = Convert.ToByte(ee4232h.DIsVCP);
// 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;
}
//**************************************************************************
// ReadFT4232HEEPROM
//**************************************************************************
// Intellisense comments
/// <summary>
/// Reads the EEPROM contents of an FT4232H device.
/// </summary>
/// <returns>FT_STATUS value from FT_EE_Read in FTD2XX DLL</returns>
/// <param name="ee4232h">An FT4232H_EEPROM_STRUCTURE which contains only the relevant information for an FT4232H device.</param>
/// <exception cref="FT_EXCEPTION">Thrown when the current device does not match the type required by this method.</exception>
public FT_STATUS ReadFT4232HEEPROM(FT4232H_EEPROM_STRUCTURE ee4232h)
{
// 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 FT4232H that we are trying to read
GetDeviceType(ref DeviceType);
if (DeviceType != FT_DEVICE.FT_DEVICE_4232H)
{
// 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 = 4;
// 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
ee4232h.Manufacturer = Marshal.PtrToStringAnsi(eedata.Manufacturer);
ee4232h.ManufacturerID = Marshal.PtrToStringAnsi(eedata.ManufacturerID);
ee4232h.Description = Marshal.PtrToStringAnsi(eedata.Description);
ee4232h.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
ee4232h.VendorID = eedata.VendorID;
ee4232h.ProductID = eedata.ProductID;
ee4232h.MaxPower = eedata.MaxPower;
ee4232h.SelfPowered = Convert.ToBoolean(eedata.SelfPowered);
ee4232h.RemoteWakeup = Convert.ToBoolean(eedata.RemoteWakeup);
// 4232H specific fields
ee4232h.PullDownEnable = Convert.ToBoolean(eedata.PullDownEnable8);
ee4232h.SerNumEnable = Convert.ToBoolean(eedata.SerNumEnable8);
ee4232h.ASlowSlew = Convert.ToBoolean(eedata.ASlowSlew);
ee4232h.ASchmittInput = Convert.ToBoolean(eedata.ASchmittInput);
ee4232h.ADriveCurrent = eedata.ADriveCurrent;
ee4232h.BSlowSlew = Convert.ToBoolean(eedata.BSlowSlew);
ee4232h.BSchmittInput = Convert.ToBoolean(eedata.BSchmittInput);
ee4232h.BDriveCurrent = eedata.BDriveCurrent;
ee4232h.CSlowSlew = Convert.ToBoolean(eedata.CSlowSlew);
ee4232h.CSchmittInput = Convert.ToBoolean(eedata.CSchmittInput);
ee4232h.CDriveCurrent = eedata.CDriveCurrent;
ee4232h.DSlowSlew = Convert.ToBoolean(eedata.DSlowSlew);
ee4232h.DSchmittInput = Convert.ToBoolean(eedata.DSchmittInput);
ee4232h.DDriveCurrent = eedata.DDriveCurrent;
ee4232h.ARIIsTXDEN = Convert.ToBoolean(eedata.ARIIsTXDEN);
ee4232h.BRIIsTXDEN = Convert.ToBoolean(eedata.BRIIsTXDEN);
ee4232h.CRIIsTXDEN = Convert.ToBoolean(eedata.CRIIsTXDEN);
ee4232h.DRIIsTXDEN = Convert.ToBoolean(eedata.DRIIsTXDEN);
ee4232h.AIsVCP = Convert.ToBoolean(eedata.AIsVCP8);
ee4232h.BIsVCP = Convert.ToBoolean(eedata.BIsVCP8);
ee4232h.CIsVCP = Convert.ToBoolean(eedata.CIsVCP8);
ee4232h.DIsVCP = Convert.ToBoolean(eedata.DIsVCP8);
}
}
else
{
if (pFT_EE_Read == IntPtr.Zero)
{
MessageBox.Show("Failed to load function FT_EE_Read.");
}
}
return ftStatus;
}
