P&E Microcomputer Systems Cyclone LC Series, Руководство пользователя

Страница: 78 / 149

User Manual For Cyclone LC Programmers 78
Checks to see if the Cyclone has completed a programming operation started with either the
“startImageExecution” or “startDynamicDataProgram” functions.
After this function returns with completed value, “getLastErrorCode” should be called to determine
the programming result. A result of 0 will be returned even if a programming error has occurred or
if communication with the Cyclone is lost.
8.2.4.4.4 dynamicReadBytes
bool dynamicReadBytes(uint32_t cycloneHandle, uint32_t targetAddress, uint16_t
dataLength, char *buffer);
This function reads a specified number of bytes from a specified memory address of the target
processor. This call is only valid after first having made a call to the “startImageExecution” function
in the sequence of commands.
8.2.4.4.5 getNumberOfErrors
uint32_t getNumberOfErrors(uint32_t cycloneHandle);
This function returns a count of all the errors recorded in the DLL and in the Cyclone.
8.2.4.4.6 getErrorCode
uint32_t getErrorCode(uint32_t cycloneHandle, uint32_t errorNum);
This function returns the specified error code recorded in the DLL or in the Cyclone.
@parameter cycloneHandle The handle of the Cyclone to perform a status check on.
@returnvalue
1 = Currently programming
0 = Completed (with or without error)
@parameter cycloneHandle The handle of the Cyclone that will perform the dynamic read.
@parameter targetAddress
The first memory address of the target processor where the
data will be read.
@parameter dataLength The number of total bytes to read from the target processor
@parameter buffer
A pointer to the array where the data read will be stored. This
array must have been allocated prior to calling this function.
@returnvalue
True if the data was successfully read
False otherwise
@parameter cycloneHandle The handle of the Cyclone to get a count of the errors.
@returnvalue The number of errors in the DLL and in the Cyclone.
@parameter cycloneHandle The handle of the Cyclone to retrieve the error code.
@parameter errorNum
If getNumberOfErrors is greater than 1, this specifies the error
number.