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

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

User Manual For Cyclone LC Programmers 83
8.2.4.5.8 setPropertyValue
bool setPropertyValue(uint32_t cycloneHandle, uint32_t resourceOrImageId, char *
categoryName, char *propertyName, char * newValue);
This function changes the property of the Cyclone to the value specified. Only certain properties
can be changed using this call. This function will return false if the property was not changed.
Refer to the header file for a list of valid category and property names. The function getPropertyList
will return a list of valid properties for each category.
8.2.4.5.9 getPropertyList
char *getPropertyList(uint32_t cycloneHandle, uint32_t resourceOrImageId, char
*categoryName);
This function returns a list of valid category and property names that can be used with the
“getPropertyValue” and “setPropertyValue” functions. Refer to the header file for a list of valid
category and property names.
8.2.4.6 Features Calls
8.2.4.6.1 getFirmwareVersion
char *getFirmwareVersion(uint32_t cycloneHandle);
@parameter cycloneHandle The handle of the Cyclone from which to read the property.
@parameter resourceOrImageId
The id for image properties is the image id on the Cyclone.
The id for Cyclone or Network properties is 0.
@parameter categoryName
A pointer to a null-terminated character string that contains
the category of the property that will be modified.
@parameter propertyName
A pointer to a null-terminated character string that contains
the name of the property that will be modified.
@parameter newValue
A pointer to a null-terminated character string that contains
the new value of the property.
@returnvalue
True if the data was successfully set
False otherwise
@parameter cycloneHandle The handle of the Cyclone that will return the property list.
@parameter resourceOrImageId
The id for image properties is the image id on the Cyclone.
The id for Cyclone or Network properties is 0.
@parameter categoryName
A pointer to a null-terminated character string that contains
the category of the property list.
@returnvalue
A pointer to a null-terminated character string that contains
a list of property names.