xil_device_set_value(3)

NAME

xil_device_set_value − stores device-initialization values in a device object

SYNOPSIS

#include <xil/xil.h>

void xil_device_set_value ( XilDevice deviceObj,

char ∗ attribute,
void ∗value);

DESCRIPTION

xil_device_set_value () stores attribute and value in the device object deviceObj. attribute is the name of the attribute you want to set and value is the attribute’s value. Attribute names and their possible values are defined by the group that writes the device handler. Only attributes the device understands should be set on the device object; otherwise an error is generated. You can store in the object as many attributes and values as needed to derive all required initialization attributes for the device. Make a separate function call for each attribute.

ERRORS

For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer’s Guide.

EXAMPLES

Create a device object and pass it as an argument on the function call that creates its associated device image:

XilSystemState State;
XilDevice deviceObj;
XilImage dev_image;
int new_value = 255;
deviceObj = xil_device_create (State, "device");
xil_device_set_value (deviceObj, "ATTRIBUTE_1",
(void∗) new_value);
xil_device_set_value (deviceObj, "ATTRIBUTE_2",
(void∗) new_value);
dev_image = xil_create_from_device (State, "device", deviceObj);

NOTES

Because attributes and their associated values may reference data in the application’s data space, any data associated with an XilDevice object must remain valid while the device object references it.

Museum

Related Articles