Cyclone Automated Control Package
27
4.4.2 START_dynamic_program_bytes
function START_dynamic_program_bytes(cyclonepromaxhandle :
longword; target_address : longword; data_length : word;
buffer : pointer) : boolean;
bool START_dynamic_program_bytes(
unsigned
long
cyclonepromaxhandle,
unsigned
long
target_address, unsigned short data_length, char *buffer);
bool START_dynamic_program_bytes(UInt32 cyclonepromaxhandle,
UInt32 target_address, UInt16 data_length, byte[ ] buffer);
Sometimes, in addition to the large amount of static data being
programmed into a target from the Cyclone, it is advantageous for the
calling application to program small sections of unique data dynamically.
Examples of this include date/time, serial number, MAC addresses, and
lot numbers. This routine allows the user to program such dynamic data.
This function is valid to be called only after a programming image has
been programmed into the target (once START_execute_all_commands
has completed). Call the
“check_STARTED_cyclonepromax_status”
function to wait for completion. If the target is reset after programming the
image, START_dynamic_program_bytes will fail. The workaround to this
is to execute a second blank image that will re-load the algorithm before
you call START_dynamic_program_bytes.
@param
cyclonepromaxhandle
The handle of the Cyclone unit to begin
dynamic programming.
@param target_address
The first memory address of the target
processor where the dynamic data should
be written.
@param data_length
The total number of bytes to be written.
This parameter cannot be greater than
255.
@param buffer
Pointer to the array which holds the data
to be written.
@returnvalue
True if the programming process has
started successfully.
False otherwise.
