/******************************************************************************* * * Copyright (C) 2014 Xilinx, Inc. All rights reserved. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * Use of the Software is limited solely to applications: * (a) running on a Xilinx device, or * (b) that interact with a Xilinx device through a bus or interconnect. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * XILINX CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. * * Except as contained in this notice, the name of the Xilinx shall not be used * in advertising or otherwise to promote the sale, use or other dealings in * this Software without prior written authorization from Xilinx. * *******************************************************************************/ /******************************************************************************/ /** * * @file xdptx_mst_example.c * * Contains a design example using the XDptx driver in multi-stream transport * (MST) mode. * * @note When topology discovery is enabled, the required stack size will * be larger than the default that SDK sets of 0x400. Increase the * stack size if the ALLOCATE_FROM_SINKLIST option is used. Testing * was done with a stack size of 0x1000. * @note For this example to display output, the user will need to * implement initialization of the system (Dptx_PlatformInit) and, * after training is complete, implement configuration of the video * stream source in order to provide the DisplayPort core with * input. See XAPP1178 for reference. * @note The functions Dptx_PlatformInit and Dptx_StreamSrc* are declared * extern in xdptx_example_common.h and are left up to the user to * implement. * *
* MODIFICATION HISTORY: * * Ver Who Date Changes * ----- ---- -------- ----------------------------------------------- * 1.00a als 08/07/14 Initial creation. ** *******************************************************************************/ /******************************* Include Files ********************************/ #include "xdptx_example_common.h" /**************************** Constant Definitions ****************************/ /* The number of streams to enable. */ #define NUM_STREAMS 4 /* This enables topology discovery which will create a list of sinks in the * topology. If ALLOCATE_FROM_SINKLIST is defined, the streams will sent to * to the sinks with the corresponding index. See the function calls for * the XDptx_SetStreamSelectFromSinkList driver function below. */ #define ALLOCATE_FROM_SINKLIST #ifdef ALLOCATE_FROM_SINKLIST /* Define the mapping between sinks and streams. The sink numbers are in the * order that they are discovered by the XDptx_FindAccessibleDpDevices driver * function. */ #define STREAM1_USE_SINKNUM 0 #define STREAM2_USE_SINKNUM 1 #define STREAM3_USE_SINKNUM 2 #define STREAM4_USE_SINKNUM 3 #endif /* The video resolution from the display mode timings (DMT) table to use for * each stream. */ #define USE_VIDEO_MODE XDPTX_VM_1920x1080_60_P /* The color depth (bits per color component) to use for each stream. */ #define USE_BPC 8 /**************************** Function Prototypes *****************************/ u32 Dptx_MstExample(XDptx *InstancePtr, u16 DeviceId); /**************************** Function Definitions ****************************/ /******************************************************************************/ /** * This function is the main function of the XDptx multi-stream transport (MST) * example. * * @param None. * * @return * - XST_FAILURE if the MST example was unsuccessful - system * setup failed. * * @note Unless setup failed, main will never return since * Dptx_MstExample is blocking. * *******************************************************************************/ int main(void) { /* Run the XDptx MST example. */ Dptx_MstExample(&DptxInstance, DPTX_DEVICE_ID); return XST_FAILURE; } /******************************************************************************/ /** * The main entry point for the multi-stream transport (MST) example using the * XDptx driver. This function will either discover the topology and map streams * to the sinks in the sink list, or map streams to relative addresses. * * @param InstancePtr is a pointer to the XDptx instance. * @param DeviceId is the unique device ID of the DisplayPort TX core * instance. * * @return * - XST_FAILURE if the system setup failed. * - XST_SUCCESS should never return since this function, if setup * was successful, is blocking. * * @note If system setup was successful, this function is blocking. * *******************************************************************************/ u32 Dptx_MstExample(XDptx *InstancePtr, u16 DeviceId) { u32 Status; XDptx_VideoMode VideoMode = USE_VIDEO_MODE; u8 Bpc = USE_BPC; u32 MaskVal; /* Enable multi-stream transport (MST) mode for this example. */ XDptx_MstCfgModeEnable(InstancePtr); if (NUM_STREAMS >= 1) { XDptx_MstCfgStreamEnable(InstancePtr, XDPTX_STREAM_ID1); } if (NUM_STREAMS >= 2) { XDptx_MstCfgStreamEnable(InstancePtr, XDPTX_STREAM_ID2); } if (NUM_STREAMS >= 3) { XDptx_MstCfgStreamEnable(InstancePtr, XDPTX_STREAM_ID3); } if (NUM_STREAMS >= 4) { XDptx_MstCfgStreamEnable(InstancePtr, XDPTX_STREAM_ID4); } /* Do platform initialization here. This is hardware system specific - * it is up to the user to implement this function. */ Dptx_PlatformInit(); /******************/ Status = Dptx_SetupExample(InstancePtr, DeviceId); if (Status != XST_SUCCESS) { return XST_FAILURE; } /* A DisplayPort connection must exist at this point. See the interrupt * and polling examples for waiting for connection events. */ Status = Dptx_StartLink(InstancePtr); if (Status != XST_SUCCESS) { return XST_FAILURE; } XDptx_EnableTrainAdaptive(InstancePtr, TRAIN_ADAPTIVE); XDptx_SetHasRedriverInPath(InstancePtr, TRAIN_HAS_REDRIVER); XDptx_CfgMsaSetBpc(InstancePtr, XDPTX_STREAM_ID1, Bpc); XDptx_CfgMsaSetBpc(InstancePtr, XDPTX_STREAM_ID2, Bpc); XDptx_CfgMsaSetBpc(InstancePtr, XDPTX_STREAM_ID3, Bpc); XDptx_CfgMsaSetBpc(InstancePtr, XDPTX_STREAM_ID4, Bpc); Status = XDptx_GetRxCapabilities(InstancePtr); if (Status != XST_SUCCESS) { return XST_FAILURE; } #ifndef ALLOCATE_FROM_SINKLIST u8 Lct; u8 Rad[15]; if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { Lct = 2; Rad[0] = 8; XDptx_SetStreamSinkRad(InstancePtr, XDPTX_STREAM_ID1, Lct, Rad); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID2)) { Lct = 3; Rad[0] = 1; Rad[1] = 8; XDptx_SetStreamSinkRad(InstancePtr, XDPTX_STREAM_ID2, Lct, Rad); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID3)) { Lct = 4; Rad[0] = 1; Rad[1] = 1; Rad[2] = 8; XDptx_SetStreamSinkRad(InstancePtr, XDPTX_STREAM_ID3, Lct, Rad); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID4)) { Lct = 4; Rad[0] = 1; Rad[1] = 1; Rad[2] = 9; XDptx_SetStreamSinkRad(InstancePtr, XDPTX_STREAM_ID4, Lct, Rad); } #else xil_printf("Find topology >>>\n"); InstancePtr->Topology.NodeTotal = 0; InstancePtr->Topology.SinkTotal = 0; XDptx_FindAccessibleDpDevices(InstancePtr, 1, NULL); xil_printf("<<< Find topology DONE.\n"); if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { XDptx_SetStreamSelectFromSinkList(InstancePtr, XDPTX_STREAM_ID1, STREAM1_USE_SINKNUM); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { XDptx_SetStreamSelectFromSinkList(InstancePtr, XDPTX_STREAM_ID2, STREAM2_USE_SINKNUM); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { XDptx_SetStreamSelectFromSinkList(InstancePtr, XDPTX_STREAM_ID3, STREAM3_USE_SINKNUM); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { XDptx_SetStreamSelectFromSinkList(InstancePtr, XDPTX_STREAM_ID4, STREAM4_USE_SINKNUM); } #endif /* Disable MST for now. */ XDptx_MstDisable(InstancePtr); if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { XDptx_CfgMsaUseStandardVideoMode(InstancePtr, XDPTX_STREAM_ID1, VideoMode); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID2)) { XDptx_CfgMsaUseStandardVideoMode(InstancePtr, XDPTX_STREAM_ID2, VideoMode); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID3)) { XDptx_CfgMsaUseStandardVideoMode(InstancePtr, XDPTX_STREAM_ID3, VideoMode); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID4)) { XDptx_CfgMsaUseStandardVideoMode(InstancePtr, XDPTX_STREAM_ID4, VideoMode); } /* Disable main stream to force sending of IDLE patterns. */ XDptx_DisableMainLink(InstancePtr); /* Reset the transmitter. */ XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_SOFT_RESET, XDPTX_SOFT_RESET_VIDEO_STREAM_ALL_MASK); XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_SOFT_RESET, 0x0); /* Set the video modes for each stream. */ if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID1)) { XDptx_SetVideoMode(InstancePtr, XDPTX_STREAM_ID1); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID2)) { XDptx_SetVideoMode(InstancePtr, XDPTX_STREAM_ID2); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID3)) { XDptx_SetVideoMode(InstancePtr, XDPTX_STREAM_ID3); } if (XDptx_MstStreamIsEnabled(InstancePtr, XDPTX_STREAM_ID4)) { XDptx_SetVideoMode(InstancePtr, XDPTX_STREAM_ID4); } /* Configure video stream source or generator here. This function needs * to be implemented in order for video to be displayed and is hardware * system specific. It is up to the user to implement this function. */ Dptx_StreamSrcSetup(InstancePtr); Dptx_StreamSrcConfigure(InstancePtr); Dptx_StreamSrcSync(InstancePtr); //////////////////////////////////// /* Reset the transmitter. */ XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_SOFT_RESET, XDPTX_SOFT_RESET_VIDEO_STREAM_ALL_MASK); XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_SOFT_RESET, 0x0); /* Mask interrupts while allocating payloads. */ MaskVal = XDptx_ReadReg(InstancePtr->Config.BaseAddr, XDPTX_INTERRUPT_MASK); XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_INTERRUPT_MASK, 0x3F); /* Allocate payloads. */ XDptx_MstEnable(InstancePtr); XDptx_AllocatePayloadStreams(InstancePtr); /* Reset the transmitter. */ XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_SOFT_RESET, XDPTX_SOFT_RESET_VIDEO_STREAM_ALL_MASK); XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_SOFT_RESET, 0x0); /* Sync the stream source to the DisplayPort TX if needed. */ Dptx_StreamSrcSync(InstancePtr); //////////////////////////////////// /* Enable the main link. */ XDptx_EnableMainLink(InstancePtr); /* Unmask interrupts. */ XDptx_WriteReg(InstancePtr->Config.BaseAddr, XDPTX_INTERRUPT_MASK, MaskVal); /* Do not return. */ while (1); return XST_SUCCESS; }