Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

These functions require that all FPAs are opened using the Multi API-DLL function F_OpenInstancesAndFPAs and each API-DLL instance is correctly initialized using Generic Functions. If not already included in configuration settings, the code being programmed by each FPA to its target device can be set using Data Buffer Functions.

Encapsulated functions use the following sequence:

...

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

Syntax

Code Block
languagecpp
INT_X F_AutoProgram( INT_X mode = 0 );

...

Erase memory specified in configuration options. Depending on settings, this operation will erase all or part of target device’s memory contents. Use Retain Data settings to preserve calibration or custom data. Retain Data settings only apply to https://elprotronic.atlassian.net/wiki/spaces/FPGPARMFPGPM/pages/5777041496734882/Encapsulated+Functions#F_AutoProgram and this function. Custom writes using Data Buffer Functions or Sequential Functions will not retain data. This function has some exclusive GangPro-ARM return values.

...

Write contents of Code Buffer to target device’s memory. The Code Buffer is usually written from a code file using F_ReadCodeFile, but can be modified with Data Buffer Functions. An enabled configuration option, https://elprotronic.atlassian.net/wiki/spaces/FPGPARMFPGPM/pages/5780285796734622/General+Configuration#CodeFileReload, will cause this function to always reload code file before proceeding. This setting can be useful if code file is frequently modified, but it can cause issues if custom instructions are used to modify the code buffer before programming, as their modifications will be discarded. This function has some exclusive GangPro-ARM return values.

...

Verify target device’s memory contents against Code Buffer. The memory used for verification depends on configuration settings, and is identical to sections of memory being programmed using https://elprotronic.atlassian.net/wiki/spaces/FPGPARMFPGPM/pages/5777041496734882/Encapsulated+Functions#F_Memory_Write. For common behavior, do not modify settings between calling https://elprotronic.atlassian.net/wiki/spaces/FPGPARMFPGPM/pages/5777041496734882/Encapsulated+Functions#F_Memory_Write and this function. This function has some exclusive GangPro-ARM return values.

...

...

This function can write memory protection bits and disable debug access. Performs the functions Sequential Functions F_Write_Locking_Registers and F_Write_Debug_Register together. If the former fails, the latter will not execute (locking bits are verified first before debug access is disabled). If https://elprotronic.atlassian.net/wiki/spaces/FPGPARMFPGPM/pages/5777023996734671/Memory+Protection+Overview#WriteLockingBitsEnConfiguration#WriteLockingBitsEn is not enabled this function will not perform any action.

...