MSP430 DLL API Documentation
3.14.0.0
|
This file contains the DLL function headers and definitions to maintain the MSP-FET430UIF (TI USB FET) hardware and firmware. More...
Go to the source code of this file.
Typedefs | |
typedef void(* | DLL430_FET_NOTIFY_FUNC) (uint32_t MsgId, uint32_t wParam, uint32_t lParam, int32_t clientHandle) |
Type definition for a callback function which could handle notify messages sent by the DLL to the calling application during USB FET firmware update. A handle to the callback function is passed to the DLL by calling MSP430_FET_FwUpdate(). See enumeration UPDATE_STATUS_MESSAGES for details on possible notify messages. More... | |
typedef enum UPDATE_STATUS_MESSAGES | UPDATE_STATUS_MESSAGES_t |
Status messages during USB FET firmware update. More... | |
Enumerations | |
enum | UPDATE_STATUS_MESSAGES { BL_INIT = 0, BL_ERASE_INT_VECTORS = 1, BL_ERASE_FIRMWARE = 2, BL_PROGRAM_FIRMWARE = 3, BL_DATA_BLOCK_PROGRAMMED = 4, BL_EXIT = 5, BL_UPDATE_DONE = 6, BL_UPDATE_ERROR = 7, BL_WAIT_FOR_TIMEOUT = 8 } |
Status messages during USB FET firmware update. More... | |
Functions | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_SelfTest (int32_t count, uint8_t *buffer) |
Call the hardware self test function of the USB JTAG adaptor. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_SetSignals (int32_t SigMask, int32_t SigState) |
This function is only meant for testing. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_Reset (void) |
Perform a reset of the USB JTAG adaptor's firmware. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_I2C (int32_t address, uint8_t *buffer, int32_t count, int32_t rw) |
Read and write to EEPROM via I2C. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_EnterBootloader (void) |
Enter the bootloader. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_ExitBootloader (void) |
Exit the bootloader. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_GetFwVersion (int32_t *version) |
Returns the version number of the MSP430-FET430UIF USB FET firmware. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_GetHwVersion (uint8_t **version, int32_t *count) |
Returns the version number of the MSP430-FET430UIF USB FET hardware. More... | |
DLL430_SYMBOL STATUS_T WINAPI | MSP430_FET_FwUpdate (const char *lpszFileName, DLL430_FET_NOTIFY_FUNC callback, int32_t clientHandle) |
Synchronizes the firmware version of the MSP-FET430UIF (TI USB FET) with the version of the Dll. More... | |
This file contains the DLL function headers and definitions to maintain the MSP-FET430UIF (TI USB FET) hardware and firmware.
typedef void(* DLL430_FET_NOTIFY_FUNC) (uint32_t MsgId, uint32_t wParam, uint32_t lParam, int32_t clientHandle) |
Type definition for a callback function which could handle notify messages sent by the DLL to the calling application during USB FET firmware update. A handle to the callback function is passed to the DLL by calling MSP430_FET_FwUpdate(). See enumeration UPDATE_STATUS_MESSAGES for details on possible notify messages.
typedef enum UPDATE_STATUS_MESSAGES UPDATE_STATUS_MESSAGES_t |
Status messages during USB FET firmware update.
Status messages during USB FET firmware update.
STATUS_T MSP430_FET_SelfTest | ( | int32_t | count, |
uint8_t * | buffer | ||
) |
Call the hardware self test function of the USB JTAG adaptor.
count | size of the buffer in bytes. |
buffer | pointer to a memory buffer of at least count bytes. |
STATUS_T MSP430_FET_SetSignals | ( | int32_t | SigMask, |
int32_t | SigState | ||
) |
This function is only meant for testing.
SigMask | mask of which signal to set/reset. |
SigState | mask of the corresponding signal states. |
STATUS_T MSP430_FET_Reset | ( | void | ) |
Perform a reset of the USB JTAG adaptor's firmware.
STATUS_T MSP430_FET_I2C | ( | int32_t | address, |
uint8_t * | buffer, | ||
int32_t | count, | ||
int32_t | rw | ||
) |
Read and write to EEPROM via I2C.
address | The starting address of the EEPROM memory to be read or written. |
buffer | The buffer into which EEPROM memory is read, or from which EEPROM memory is written. |
count | The number of bytes of EEPROM memory read or written. |
rw | Specify a read (READ) or write (WRITE) operation. |
STATUS_T MSP430_FET_EnterBootloader | ( | void | ) |
Enter the bootloader.
STATUS_T MSP430_FET_ExitBootloader | ( | void | ) |
Exit the bootloader.
STATUS_T MSP430_FET_GetFwVersion | ( | int32_t * | version | ) |
Returns the version number of the MSP430-FET430UIF USB FET firmware.
version | The version number of the MSP430-FET430UIF firmware is returned. |
STATUS_T WINAPI MSP430_FET_GetHwVersion | ( | uint8_t ** | version, |
int32_t * | count | ||
) |
Returns the version number of the MSP430-FET430UIF USB FET hardware.
version | Pointer to version number buffer of the MSP430-FET430UIF is returned. |
count | Number of valid bytes in the version number buffer is returned. |
STATUS_T MSP430_FET_FwUpdate | ( | const char * | lpszFileName, |
DLL430_FET_NOTIFY_FUNC | callback, | ||
int32_t | clientHandle | ||
) |
Synchronizes the firmware version of the MSP-FET430UIF (TI USB FET) with the version of the Dll.
lpszFileName | Pointer to a file of TI TXT or INTEL HEX format. It is recommended to call MSP430_FET_FwUpdate() with paramter lpszFileName set to NULL. In that case an internally stored firmware image will be used by MSP430.dll to perform the update. By following this recommondation you make sure that the MSP-FET430UIF interface gets updated with the correct firmware matching version number and features of the currently used MSP430.dll Library. |
callback | Pointer to a callback function of the type DLL430_FET_NOTIFY_FUNC that might handle notify messages send by the DLL during firmware update. This parameter can be set to NULL if one does not want to use the callback mechanism. |
clientHandle | Handle of the calling application. Can be set to FALSE in case the callback mechanism is not applied and parameter callback is set to NULL. |