slau358q.pdf - 第87页
www.ti.com MSP-GANG.dll Description 87 SLAU358Q – September 2011 – Revised October 2019 Submit Documentation Feedback Copyright © 2011–2019, Texas Instruments Incorporated Dynamic Link Library for MSP-GANG Programmer 4.2…
MSP-GANG.dll Description
www.ti.com
86
SLAU358Q–September 2011–Revised October 2019
Submit Documentation Feedback
Copyright © 2011–2019, Texas Instruments Incorporated
Dynamic Link Library for MSP-GANG Programmer
4.2.13 MSPGANG_Interactive_Close_Target_Device
MSPGANG_Interactive_Close_Target_Device is used in the interactive mode and in closing access to
target devices.
Syntax
LONG MSPGANG_Interactive_Close_Target_Device(void)
Result
LONG Error code
4.2.14 MSPGANG_Interactive_DefReadTargets
The target device must be opened first if not open yet (see MSPGANG_Interactive_Open_Target_Device,
Section 4.2.12).
MSPGANG_Interactive_DefReadTargets reads the contents of the selected target devices (one to eight
targets) simultaneously from Start_addr to the End_addr and saves it in the internal data buffer (see
DATA_BUFFERS dat; structure for details).
Syntax
LONG MSPGANG_Interactive_DefReadTargets(BYTE mask, BYTE bar_min, BYTE bar_max, LONG
Start_addr, LONG End_addr)
Arguments
BYTE mask Mask of the target devices that data should be read from
BYTE bar_min Beginning progress bar value displayed on the LCD display (valid values are 0 to 100).
BYTE bar_max Ending —,,,---
LONG Start_addr Data read from Start_addr location
LONG End_addr Data read up to the End_addr location
Result
LONG Error code
Example
Get data from the info memory for the F2xx from each 8 target devices
DATA_BUFFERS *DBuf;
void *temp;
MSPGANG_GetDataBuffers_ptr((&temp));
DBuf = (DATA_BUFFERS *)temp;
long baddr, MCU_addr;
.................
//read data from all targets and save it in the internal DATA_BUFFERS
MSPGANG_Interactive_DefReadTargets( 0xFF, 0, 100, 0x10C0, 0x10FF);
//get the base address of data in the DATA_BUFFERS
baddr = MSPGANG_Convert_Address( MCU_TO_DATABUF, 0x10C0 );
if( baddr >= 0 )
.........
//data at the MCU_addr 0x10C0 to 0x10FF), target -> 1..8
data = DBuf->GangRx[ baddr + (MCU_addr-0x10C0)][target-1];
//get data for each target from internal buffer
.........
www.ti.com
MSP-GANG.dll Description
87
SLAU358Q–September 2011–Revised October 2019
Submit Documentation Feedback
Copyright © 2011–2019, Texas Instruments Incorporated
Dynamic Link Library for MSP-GANG Programmer
4.2.15 MSPGANG_Interactive_ReadTargets
The target device must be opened first if not open yet (see MSPGANG_Interactive_Open_Target_Device,
Section 4.2.12).
MSPGANG_Interactive_ReadTargets reads the contents of the selected target devices (one to eight
targets) simultaneously from the locations specified in the configuration memory (see configuration setup
for details) and saves it in the internal data buffer (see DATA_BUFFERS dat; structure for details).
Syntax
LONG MSPGANG_Interactive_ReadTargets(BYTE mask)
Arguments
BYTE mask Mask of the target devices that data should be read from
Result
LONG Error code
Example
MSP-GANG.dll Description
www.ti.com
88
SLAU358Q–September 2011–Revised October 2019
Submit Documentation Feedback
Copyright © 2011–2019, Texas Instruments Incorporated
Dynamic Link Library for MSP-GANG Programmer
Get data from each of the 8 target devices
DATA_BUFFERS *DBuf;
void *temp;
MSPGANG_GetDataBuffers_ptr((&temp));
DBuf = (DATA_BUFFERS *)temp;
long baddr, MCU_addr;
.................
//read data from all targets and save it in the internal DATA_BUFFERS
MSPGANG_Interactive_DefReadTargets( 0xFF, 0, 100, 0x10C0, 0x10FF);
//get the base address of data in the DATA_BUFFERS
baddr = MSPGANG_Convert_Address( MCU_TO_DATABUF, 0x10C0 );
if( baddr >= 0 )
.........
//data at the MCU_addr 0x10C0 to 0x10FF), target -> 1..8
data = DBuf->GangRx[ baddr + (MCU_addr-0x10C0)][target-1];
//get data for each target from internal buffer
.........
4.2.16 MSPGANG_Interactive_ReadBytes
Note: The target device must be opened first if not open yet (see
MSPGANG_Interactive_Open_Target_Device, Section 4.2.12).
MSPGANG_Interactive_ReadBytes reads contents from one selected target device and saves it in the
desired data buffer.
Syntax
LONG MSPGANG_Interactive_ReadBytes(BYTE target_no, LONG addr, LONG size, BYTE *data)
Arguments
BYTE target_no Target number (one to eight) of the desired target device
LONG addr Start address from read data
LONG size Number of read bytes
BYTE *data Pointer to buffer where data would be saved
Result
LONG Error code
4.2.17 MSPGANG_Interactive_WriteWord_to_RAM
Note: The target device must be opened first if not open yet (see
MSPGANG_Interactive_Open_Target_Device, Section 4.2.12).
MSPGANG_Interactive_WriteWord_to_RAM writes one word (16 bits) to any RAM or I/O location. The
address must be even.
Syntax
LONG MSPGANG_Interactive_WriteWord_to_RAM(LONG addr, LONG data)
Arguments
LONG addr RAM address location
BYTE data Data (16 bits)
Result
LONG Error code