slau358q.pdf - 第28页

Programming MSP Flash Devices Using the MSP Gang Programmer www.ti.com 28 SLAU358Q – September 2011 – Revised October 2019 Submit Documentation Feedback Copyright © 2011–2019, Texas Instruments Incorporated Operation F_R…

www.ti.com

Programming MSP Flash Devices Using the MSP Gang Programmer

SLAU358Q–September 2011–Revised October 2019

Submit Documentation Feedback

Operation

IF condition operation – Test condition and if true then perform operation. The condition can be one of

the following:

• BUTTONOK – OK button is pressed in the message box.

• BUTTONYES – YES button is pressed in the message box.

• BUTTONNO – NO button is pressed in the message box.

• BUTTONCANCEL – CANCEL button is pressed in the message box.

• DONE – Previous process (for example, GO or Read File) finished successfully.

• FAILED – Previous process (for example, GO or Read File) failed.

The operation can be one of the following:

• GOTO label

• CALL label SLEEP number – Pause a number of milliseconds, between 1 and 100000.

F_LOADCFGFILE filename – Load configuration file. Provide a full path and filename.

F_LOADCODEFILE filename – Load code file. Provide a full path and filename.

F_APPENDCODEFILE filename – Append code file. Provide a full path and file name.

F_VCCOFF – Turn V

OFF from programming adapter to target device.

F_VCCON – Turn V

ON from programming adapter to target device.

NOTE: V

from FPA must be enabled first using configuration file.

F_VCCINMV – Set V

in mV, between 1800 to 3600 in steps of 100 mV.

F_RESET – Perform RESET function from main dialog screen.

F_GO – Perform GO function from main dialog screen.

F_ERASEFLASH – Perform ERASE FLASH function from main dialog screen.

F_BLANKCHECK – Perform BLANK CHECK function from main dialog screen.

F_WRITEFLASH – Perform WRITE FLASH function from main dialog screen.

F_VERIFYFLASH – Perform VERIFY FLASH function from main dialog screen.

F_BLOWFUSE – Perform BLOW FUSE function from main dialog screen.

NOTE: Blows fuse regardless of enable option.

If the BLOW FUSE command is used, then the security fuse is blown even if the Blow

Security Fuse enable option is disabled.

F_SETIMAGENUMBER number – Choose image number between 1 and 96 from MSP Gang

Programmer internal memory.

F_INTERACTIVEMODE – Switch to Interactive mode.

NOTE: The execution result can be saved in the result file. Contents of the file can be used by the

application software if required. The result can be saved in the new file or append to the

existing file. Following script line commands can be used for specifying the result file:

F_NEWRESULTFILENAME – Provide a full path and name of the result file.

F_APPENDRESULTFILENAME – Provide a full path and name of the file where the result should be

appended.

F_COMMENTTOFILE – Add a comment at the beginning of the result stream.

Programming MSP Flash Devices Using the MSP Gang Programmer

www.ti.com

SLAU358Q–September 2011–Revised October 2019

Submit Documentation Feedback

Operation

F_RESULTTOFILE – Save result to the result file specified by F_NEWRESULTFILENAME or

F_APPENDRESULTFILENAME. The following data is saved:

Finished task mask: HHHH (16 bits task mask)

Cumulative target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Requested target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Connected target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Erased target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Blank Check target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Programmed target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Verified target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Secured target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

error_no: error number

VTIO in mV: VTio in mV

Vcc Error target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Vcc Cumulative Err mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

JTAG Init target mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Already Secured mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

Wrong MCU ID mask: HH (8 bits target mask - 0x01-target-1,.. 0x80-target-8);

TRACEOFF – Disable tracing.

TRACEON – Enable tracing and log to the Trace-Scr.txt file in the current working directory. This option is

useful for debugging. The trace file contains the sequence of all executed commands from the script file

annotated with line numbers. Line numbers are counted without empty lines and without lines containing

only comments.

END – End of script.

www.ti.com

Programming MSP Flash Devices Using the MSP Gang Programmer

SLAU358Q–September 2011–Revised October 2019

Submit Documentation Feedback

Operation

The following example script executes this sequence of commands:

1. Label START is created.

2. V

from programmer to target device is turned OFF.

3. Message box notifies the user of V

setting and asks for permission to proceed with buttons OK and

CANCEL. The program halts here until a button is pressed.

4. If CANCEL was pressed then GOTO finish label (ends the script).

5. If CANCEL was not pressed (in this case this implies that OK was pressed) then load configuration file

test-A.g430cfg to the MSP Gang Programmer. Configuration file test-A.cfg should be prepared before

running this script using Interactive mode.

6. Message box asks the user to proceed. The program halts until OK is pressed.

7. The MSP Gang Programmer programs the target device using the GO function.

8. Message box asks the user if the test succeeded giving a YES or NO choice.

9. If NO was pressed then GOTO START label (start of script).

10. If NO was not pressed (in this case this implies that YES was pressed) then load configuration file

finalcode.g430cfg to the MSP Gang Programmer.

11. The MSP Gang Programmer programs the target device using the GO function. The new configuration

changes the code file.

12. Script jumps to the beginning using GOTO START. This can be used to wait for the next target device

to be connected.

13. Label finish is created.

14. Script ends.

;=====================================================

; Script file - demo program

;-----------------------------------------------------

>START

F_VCCOFF

MESSAGEBOX OKCANCEL

"VCC if OFF now. Connect the test board."

"When ready press the button:"

" "

"OK - to test the board"

"CANCEL - to exit from program"

IF BUTTONCANCEL GOTO finish

; use file name and FULL PATH or relative path to MSP-Gang.dll file location

F_LOADCFGFILE Examples\Script\test.mspgangproj

MESSAGEBOX OK

"Press OK to download the test program."

F_GO

MESSAGEBOX YESNO

"Press YES when the test finished successfully."

"Press NO when the test failed."

IF BUTTONNO GOTO START

; use file name and FULL PATH or relative path to MSP-Gang.dll file location

F_LOADCFGFILE Examples\Script\finalcode.mspgangproj

F_GO

; wait min 0.5 s before turning Vcc ON again

SLEEP 500