slau358q.pdf - 第118页
MSP-GANG.dll Description www.ti.com 118 SLAU358Q – September 2011 – Revised October 2019 Submit Documentation Feedback Copyright © 2011–2019, Texas Instruments Incorporated Dynamic Link Library for MSP-GANG Programmer BY…
www.ti.com
MSP-GANG.dll Description
117
SLAU358Q–September 2011–Revised October 2019
Submit Documentation Feedback
Copyright © 2011–2019, Texas Instruments Incorporated
Dynamic Link Library for MSP-GANG Programmer
4.2.42 MSPGANG_GetProgressStatus
MSPGANG_GetProgressStatus gets progress status from MSP-GANG. The data received contains a
Gang Mask of all processes done in the previous function. Each bit in the Gang mask represents one
targeted device:
bit 0 → Target 1, bit 1 → Target 2, ... bit 7 → Target 8
For example, when connected_gang_mask is 0x7A, then targets 2, 4, 5, 6, and 7 are detected, and
communication with these targets is established. The cumulative mask contains the final result for all
targets.
Syntax
LONG MSPGANG_GetProgressStatus(void *lpData)
Arguments
void *lpData Pointer to structure below
Result
LONG Error code
#define SCRIPT_TEXT_SIZE 16
union GANG_PROGRESS_STATUS
{
BYTE bytes[PROGRESS_STATUS_SIZE+4];
struct
{
BYTE header;
BYTE ctr;
WORD task_ctr;
WORD chunk_ctr;
BYTE run;
BYTE ack;
WORD Finished_tasks_mask;
//--- task mask bits ----
// CONNECT_TASK_BIT 0x0001
// ERASE_TASK_BIT 0x0002
// BLANKCHECK_TASK_BIT 0x0004
// PROGRAM_TASK_BIT 0x0008
// VERIFY_TASK_BIT 0x0010
// SECURE_TASK_BIT 0x0020
// DCO_CAL_TASK_BIT 0x0040
// spare 0x0080 to 0x4000
// RST_AND_START_FW_BIT 0x8000
BYTE cumulative;
//target masks
// TARGET_1_MASK 0x01
// TARGET_2_MASK 0x02
// TARGET_3_MASK 0x04
// TARGET_4_MASK 0x08
// TARGET_5_MASK 0x10
// TARGET_6_MASK 0x20
// TARGET_7_MASK 0x40
// TARGET_8_MASK 0x80
BYTE Rq_gang_mask;
BYTE Connected_gang_mask;
BYTE Erased_gang_mask;
BYTE BlankCheck_gang_mask;
BYTE Programmed_gang_mask;
BYTE Verified_gang_mask;
MSP-GANG.dll Description
www.ti.com
118
SLAU358Q–September 2011–Revised October 2019
Submit Documentation Feedback
Copyright © 2011–2019, Texas Instruments Incorporated
Dynamic Link Library for MSP-GANG Programmer
BYTE Secured_gang_mask;
BYTE spare[6];
BYTE error_no;
BYTE VTIO_32mV;
BYTE VccSt_LOW;
BYTE VccSt_HI;
// VccSt_LOW, VccSt_HI provide 2 bits to each target.
// Bit A for each target and bit B for each target.
// Bits B A
// 0 0 Vcc below 0.7 V
// 0 1 Vcc below Vcc min ( 0.7 V < Vcc < Vcc min)
// 1 0 Vcc over Vcc min (OK status)
// 1 1 Vcc over 3.8 V
BYTE VccErr;
// current Vcc below min
BYTE VccErr_Cumulative;
// Cumulative (during programming) Vcc below min
BYTE JTAG_init_err_mask;
BYTE JTAG_Fuse_already_blown_mask;
BYTE Wrong_MCU_ID_mask;
BYTE Progress_bar;
// 0...100%
char comment[SCRIPT_TEXT_SIZE];
}st;
};
www.ti.com
MSP-GANG.dll Description
119
SLAU358Q–September 2011–Revised October 2019
Submit Documentation Feedback
Copyright © 2011–2019, Texas Instruments Incorporated
Dynamic Link Library for MSP-GANG Programmer
4.2.43 MSPGANG_GetAPIStatus
MSPGANG_GetAPIStatus gets the selected status or results from the MSP-Gang programmer. The
following numbers (no) are available:
GET_APP_FLAGS 10
GET_LAST_STATUS 12
GET_LAST_ERROR_NO 14
Syntax
LONG MSPGANG_GetAPIStatus (LONG no, BYTE *data)
Arguments
LONG no Status type
BYTE *data Pointer to status results. See below.
Result
LONG Error code
no = GET_APP_FLAGS (10)
response:
Byte-0
b0 (LSB) Hardware rev-0
b1 initialization finished (after power-up)
b2 access key CRC error
b3 invalid access key
b4 running from SD card
b5 File in SD card found
b6 target secure device in process
b7 keypad enabled
Byte-1
b0 key pressed
b1..b7 spare
Byte-2 spare
Byte-3 spare
no = GET_LAST_STATUS (12)
response:
Byte-0 Error number in the last execute transaction
Byte-1 targets connection mask
Byte-2 active targets mask
Byte-3 targets error mask
Byte-4..7 spare
no = GET_LAST_ERROR_NO (14)
Byte-0 last error number from MSP-GANG for any command
error numbers 1...255 - see error list numbers