Application Integration - 3.2 English

The following figure shows example code to show how an HDMI 1.4/2.0 TX Subsystem can be used in your application.

To integrate and use the HDMI 1.4/2.0 TX Subsystem driver in your application, the following steps must be followed:

1. Include the subsystem header file xv_hdmitxss.h that defines the subsystem object.
2. Declare and allocate space for the subsystem instance in your application code. For example:

   XV_HdmiTxSs HdmiTxSs;

3. In the subsystem driver instance, there is a metadata structure to store the subsystem hardware configuration. Declare a pointer variable in the application code to point to the instance:

   XV_HdmiTxSs_Config *XV_HdmiTxSs_ConfigPtr;

4. For each subsystem instance, the data structures declared in the previous two steps need to be initialized based on its hardware configuration, which is passed through metadata structure from xparameters.h uniquely identified by device ID.

   To initialize the subsystem, call the following two API functions:

   XV_HdmiTxSs_Config* XV_HdmiTxSs_LookupConfig(u32 DeviceId);
   int XV_HdmiTxSs_CfgInitialize(XV_HdmiTxSs *InstancePtr, 
                                 XV_HdmiTxSs_Config *CfgPtr, 
                                 u32 EffectiveAddr);

   The Device ID can be found in xparameters.h:

   XPAR_[HDMI TX Subsystem Instance Name in IPI]_DEVICE_ID

5. Each interrupt source has an associated ISR defined in the subsystem. Register the ISR with the system interrupt controller and enable the interrupt.

   int XIntc_Connect(XIntc *InstancePtr,
                     u8 Id,
                     XInterruptHandler Handler,
                     void *CallBackRef);
   void XIntc_Enable(XIntc *InstancePtr,
                     u8 Id);

   where ID can be found in xparameters.h.