Page Comparison

...

INT_X : result of operation

• FALSE (0) : failed

• STATUS_FW_TYPE_ERR (525) - incorrect firmware present in target

• STATUS_FW_VERIFICATION_ERROR (526) - firmware download verification error

• FlashPro-ARM - TRUE (1) : succeeded

• GangPro-ARM - TRUE MASK (0x01..0x3F) : 0x01 - target 1, 0x02 - target 2, 0x04 - target 3, 0x08 - target
  4, 0x10 - target 5, 0x20 - target 6

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

...

INT_X : result of operation

• FALSE (0) : failed

• STATUS_FW_TYPE_ERR (525) - incorrect firmware present in target

• STATUS_FW_VERIFICATION_ERROR (526) - firmware download verification error

• TRUE MASK (0x01..0x3F) : 0x01 - target 1, 0x02 - target 2, 0x04 - target 3, 0x08 - target
  4, 0x10 - target 5, 0x20 - target 6

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

...

INT_X addr : first byte address to be read (byte addressable)
INT_X size : number of bytes to be read
BYTE *data : array of bytes that will be written with memory contents

...

This function has some exclusive GangPro-ARM return input values.

Syntax

INT_X F_Get_MCU_Data( INT_X type )

Input

INT_X type : select type of information to receive

• GET_MCU_ID (1) : connected MCU package identifier (MCU family and group, etc.), not a unique silicon ID

...

• GET_MCU_FLASH_SIZE (2) : connected MCU flash size, if available

• GET_MCU_RAM_SIZE (3) : connected MCU RAM size, if available

...

• GET_MCU_TARGET_1 (0x10) : read from target 1, OR with type of info. requested (GangPro-ARM only)

• GET_MCU_TARGET_2 (0x20) : read from target 2, OR with type of info. requested (GangPro-ARM only)

• GET_MCU_TARGET_3 (0x30) : read from target 3, OR with type of info. requested (GangPro-ARM only)

• GET_MCU_TARGET_4 (0x40) : read from target 4, OR with type of info. requested (GangPro-ARM only)

• GET_MCU_TARGET_5 (0x50) : read from target 5, OR with type of info. requested (GangPro-ARM only)

• GET_MCU_TARGET_6 (0x60) : read from target 6, OR with type of info. requested (GangPro-ARM only)

Select FPA to perform operation on using Multi API-DLL Functions | F_Set_FPA_index, index 1 to 64. Use index 0 to perform operation on all FPAs (if results differ, use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

• FALSE (0) : failed. No communication or incorrect parameters.

• any positive value : MCU ID, flash size, or RAM size

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

25. F_Capture_PC_Addr

General Description

Read program counter (PC) register using debug interface.

Syntax

INT_X F_Capture_PC_Addr( void )

Input

none.

Select FPA to perform operation on using Multi API-DLL Functions | F_Set_FPA_index, index 1 to 64. Use index 0 to perform operation on all FPAs (if results differ, use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

• FALSE (0) : failed

• any positive value : program counter

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

26. F_Synch_CPU_JTAG

General Description

Stop target device (debug enable and halt).

This function has some exclusive GangPro-ARM return values.

Syntax

INT_X F_Synch_CPU_JTAG()

Input

none.

Select FPA to perform operation on using Multi API-DLL Functions | F_Set_FPA_index, index 1 to 64. Use index 0 to perform operation on all FPAs (if results differ, use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

• FALSE (0) : failedTRUE (1) : succeeded

• FlashPro-ARM - TRUE (1) : succeeded

• GangPro-ARM - TRUE MASK (0x01..0x3F) : 0x01 - target 1, 0x02 - target 2, 0x04 - target 3, 0x08 - target
  4, 0x10 - target 5, 0x20 - target 6

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

27. F_Get_Targets_Result

Anchor
F_Get_Targets_Result F_

...

Get_

...

General Description

Read program counter (PC) register using debug interface.

Syntax

...

Targets_Result

(GangPro-ARM only)

General Description

Return per-target success result for encapsulated functions. An error mask can be produced by
subtracting F_Get_Targets_Result() from F_Get_Active_Targets_Mask().

Syntax

INT_X F_Get_Targets_Result( void )

Input

none.

Select FPA to perform operation on using Multi API-DLL Functions | F_Set_FPA_index, index 1 to 64. Use index 0 to perform operation on all FPAs (if results differ, use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

General Description

Stop target device (debug enable and halt).

Syntax

...

• FALSE (0) : failed

• TRUE (1) : succeededMASK (0x01..0x3F) : 0x01 - target 1, 0x02 - target 2, 0x04 - target 3, 0x08 - target
  4, 0x10 - target 5, 0x20 - target 6

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

...

• Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range

28. F_Get_Active_Targets_Mask

Anchor
F_Get_Active_Targets_Mask F_Get_Active_Targets_Mask

(GangPro-ARM only)

General Description

Return per-target active status. Set intended target mask using: Generic Functions | F_Set_Config_Value_By_Name. Value returned by this function is updated during communication initialization, after any encapsulated function or Sequential Functions | F_Open_Target_Device . An error mask can be produced by subtracting F_Get_Targets_Result() from F_Get_Active_Targets_Mask().

Syntax

INT_X F_Get_Active_Targets_Mask( void )

Input

none.

Select FPA to perform operation on using Multi API-DLL Functions | F_Set_FPA_index, index 1 to 64. Use index 0 to perform operation on all FPAs (if results differ, use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

• FALSE (0) : failed

• TRUE MASK (1) : succeeded0x01..0x3F) : 0x01 - target 1, 0x02 - target 2, 0x04 - target 3, 0x08 - target
  4, 0x10 - target 5, 0x20 - target 6

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to Multi API-DLL Functions | F_LastStatus

• FPA_INVALID_NO (-2 or 0xFFFFFFFE) : FPA not opened with Multi API-DLL Functions | F_OpenInstancesAndFPAs or index out of range