Page Comparison

...

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).

...

• FALSE (0) : failed

• TRUE (1) : succeeded

• STATUS_OPEN_FILE_ERROR (535): could not open file

• STATUS_FILE_NAME_ERROR (536): format not supported

• 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

2. F_ReadCodeFile_BaseAddr

...

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).

...

• FALSE (0) : failed

• TRUE (1) : succeeded

• STATUS_OPEN_FILE_ERROR (535): could not open file

• STATUS_FILE_NAME_ERROR (536): format not supported

• 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

3. F_AppendCodeFile

Anchor
F_AppendCodeFile F_AppendCodeFile

...

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).

...

• FALSE (0) : failed

• TRUE (1) : succeeded

• STATUS_OPEN_FILE_ERROR (535): could not open file

• STATUS_FILE_NAME_ERROR (536): format not supported

• STATUS_MAX FILE_COUNT (557): total number of files exceeds MAX_FILE_INDEX (20)

• STATUS_DUPLICATE_FILE PATH (558): appending already existing file

• FPA_UNMATCHED_RESULTS (-1 or 0xFFFFFFFF) : Result of operation inconsistent across all selected FPAs, refer to F_ 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

4. F_AppendCodeFile_BaseAddr

...

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).

...

• FALSE (0) : failed

• TRUE (1) : succeeded

• STATUS_OPEN_FILE_ERROR (535): could not open file

• STATUS_FILE_NAME_ERROR (536): format not supported

• STATUS_MAX FILE_COUNT (557): total number of files exceeds MAX_FILE_INDEX (20)

• STATUS_DUPLICATE_FILE PATH (558): appending already existing file

• 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

5. F_Get_CodeCS

...

INT_X F_Get_CodeCS( INT_X dest )

Input

INT_X dest : choose operation

...

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 : checksum

• 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

6. F_Clr_Code_Buffer

...

Select FPA to perform operation on using F_ 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 (1) : succeeded

• 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

7. F_Put_Byte_to_Code_Buffer

Anchor
F_Put_Byte_to_Code_Buffer F_Put_Byte_to_Code_Buffer

...

INT_X  F_Put_Byte_to_Code_Buffer( INT_X addr, BYTE data );

Input

INT_X addr : valid flash address for target MCU

...

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 (1) : succeeded

• 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

8. F_Get_Byte_from_Code_Buffer

...

INT_X  F_Get_Byte_from_Code_Buffer( INT_X addr );

Input

INT_X addr : valid flash address for target MCU

...

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

• BYTE (0 to 0xFF) : byte from internal code buffer

• -1 : addr parameter out of flash range

• 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

9. F_Put_Byte_to_Buffer

...

Write byte to Write Buffer from FlashPro-ARM buffer https://elprotronic.atlassian.net/wiki/spaces/FPGPARM/pages/57704798/Data + Buffer +Functions#FlashProFunctions | FlashPro-ARM-buffers and GangPro-ARM buffer https://elprotronic.atlassian.net/wiki/spaces/FPGPARM/pages/57704798/Data + Buffer +Functions#GangProFunctions | GangPro-ARM-buffers.

Syntax

INT_X  F_Put_Byte_to_Buffer( INT_X  addr, BYTE data );	

Input

INT_X addr : valid flash address for target MCU

...

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 F_LastStatus to get individual results).

Output

INT X : result of operation

...

FALSE (0) : failed

...

, use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

• FALSE (0) : failed

• TRUE (1) : succeeded

• STATUS_TXBUF_SIZE_ERROR (559): Temporary buffer full (4k), program contents with F_Copy_Buffer_to_Flash. This buffer is flushed when F_Open_Target_Device is called, or when addr is set to -1. Call F_Put_Byte_to_Buffer(-1, 0xFF); to flush buffer.

• 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

Example

...

INT_X  F_Get_Byte_from_Buffer( INT_X addr );

Input

INT_X addr : valid flash address for target MCU

...

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 use Multi API-DLL Functions | F_LastStatus to get individual results).

Output

INT_X : result of operation

• BYTE (0 to 0xFF) : byte from temporary Write Data Buffer

• -1 : addr parameter out of flash range

• 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

11. F_Put_Byte_to_Gang_Buffer (GangPro-ARM only)

Anchor
F_Put_Byte_to_Gang_Buffer F_Put_Byte_to_Gang_Buffer

...

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 (1) : succeeded

• 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

Example

...

BYTE target_no : MCU target number 1 to 6

INT_X addr : valid flash address for target MCU

...

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

• BYTE (0 to 0xFF) : byte from Gang Read Buffer of one target (target_no)

• -1 : addr parameter out of flash range

• 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

Example

...