1 /*
2 * Copyright (c) 2020-2022, Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 */
22 
23 //!
24 //! \file     media_scalability_singlepipe.cpp
25 //! \brief    Defines the common interface for media scalability singlepipe mode.
26 //! \details  The media scalability singlepipe interface is further sub-divided by component,
27 //!           this file is for the base interface which is shared by all components.
28 //!
29 
30 #include <memory>
31 #include "mos_os.h"
32 #include "media_scalability_defs.h"
33 #include "media_scalability_singlepipe.h"
34 #include "mos_os_virtualengine.h"
35 #include "media_scalability_option.h"
36 #include "mhw_mi.h"
37 #include "media_packet.h"
38 
39 class MediaContext;
40 class MediaScalabilityOption;
41 
MediaScalabilitySinglePipe(void * hwInterface,MediaContext * mediaContext,uint8_t componentType)42 MediaScalabilitySinglePipe::MediaScalabilitySinglePipe(void *hwInterface, MediaContext *mediaContext, uint8_t componentType) :
43     MediaScalabilitySinglePipeNext(hwInterface, mediaContext, componentType)
44 {
45 }
46 
Initialize(const MediaScalabilityOption & option)47 MOS_STATUS MediaScalabilitySinglePipe::Initialize(const MediaScalabilityOption &option)
48 {
49     SCALABILITY_CHK_NULL_RETURN(m_osInterface);
50 
51 #if !EMUL
52     if (MOS_VE_SUPPORTED(m_osInterface))
53     {
54         MOS_VIRTUALENGINE_INIT_PARAMS VEInitParams;
55         MOS_ZeroMemory(&VEInitParams, sizeof(VEInitParams));
56         VEInitParams.bScalabilitySupported = false;
57 
58         SCALABILITY_CHK_STATUS_RETURN(m_osInterface->pfnVirtualEngineInit(m_osInterface, &m_veHitParams, VEInitParams));
59         if (m_osInterface->apoMosEnabled)
60         {
61             SCALABILITY_CHK_NULL_RETURN(m_osInterface->osStreamState);
62             m_veState = m_osInterface->osStreamState->virtualEngineInterface;
63             SCALABILITY_CHK_NULL_RETURN(m_veState);
64             SCALABILITY_CHK_NULL_RETURN(m_veHitParams);
65         }
66         else
67         {
68             m_veInterface = m_osInterface->pVEInterf;
69             SCALABILITY_CHK_NULL_RETURN(m_veInterface);
70             if (m_veInterface->pfnVEGetHintParams != nullptr)
71             {
72                 SCALABILITY_CHK_NULL_RETURN(m_veHitParams);
73             }
74         }
75     }
76 #endif
77     PMOS_GPUCTX_CREATOPTIONS_ENHANCED gpuCtxCreateOption = MOS_New(MOS_GPUCTX_CREATOPTIONS_ENHANCED);
78     SCALABILITY_CHK_NULL_RETURN(gpuCtxCreateOption);
79 
80     gpuCtxCreateOption->RAMode      = option.GetRAMode();
81     gpuCtxCreateOption->ProtectMode = option.GetProtectMode();
82     gpuCtxCreateOption->LRCACount   = 1;
83     // This setting is only for encode, please override it in decode/vpp
84     gpuCtxCreateOption->UsingSFC = false;
85 #if (_DEBUG || _RELEASE_INTERNAL) && !EMUL
86     if (m_osInterface->bEnableDbgOvrdInVE)
87     {
88         gpuCtxCreateOption->DebugOverride = true;
89         if (m_osInterface->apoMosEnabled)
90         {
91             SCALABILITY_ASSERT(m_osInterface->pfnGetVeEngineCount(m_osInterface->osStreamState) == 1);
92             gpuCtxCreateOption->EngineInstance[0] = m_osInterface->pfnGetEngineLogicIdByIdx(m_osInterface->osStreamState, 0);
93         }
94         else
95         {
96             SCALABILITY_ASSERT(m_veInterface->ucEngineCount == 1);
97             gpuCtxCreateOption->EngineInstance[0] = m_veInterface->EngineLogicId[0];
98         }
99     }
100 #endif
101     m_gpuCtxCreateOption = (PMOS_GPUCTX_CREATOPTIONS)gpuCtxCreateOption;
102 
103     return MOS_STATUS_SUCCESS;
104 }
105 
SubmitCmdBuffer(PMOS_COMMAND_BUFFER cmdBuffer)106 MOS_STATUS MediaScalabilitySinglePipe::SubmitCmdBuffer(PMOS_COMMAND_BUFFER cmdBuffer)
107 {
108     SCALABILITY_FUNCTION_ENTER;
109     SCALABILITY_CHK_NULL_RETURN(m_osInterface);
110     SCALABILITY_CHK_NULL_RETURN(cmdBuffer);
111 
112     SCALABILITY_CHK_STATUS_RETURN(GetCmdBuffer(cmdBuffer));
113 
114     if (!m_osInterface->pfnIsMismatchOrderProgrammingSupported())
115     {
116         if (m_miItf)
117         {
118             SCALABILITY_CHK_STATUS_RETURN(m_miItf->AddMiBatchBufferEnd(cmdBuffer, nullptr));
119         }
120         else
121         {
122             SCALABILITY_CHK_STATUS_RETURN(m_miInterface->AddMiBatchBufferEnd(cmdBuffer, nullptr));
123         }
124     }
125 
126     SCALABILITY_CHK_STATUS_RETURN(Oca1stLevelBBEnd(*cmdBuffer));
127 
128     SCALABILITY_CHK_STATUS_RETURN(ReturnCmdBuffer(cmdBuffer));
129 
130     if (MOS_VE_SUPPORTED(m_osInterface))
131     {
132         SCALABILITY_CHK_STATUS_RETURN(SetHintParams());
133         if(cmdBuffer && m_veHitParams)
134         {
135             SCALABILITY_CHK_STATUS_RETURN(PopulateHintParams(cmdBuffer));
136         }
137     }
138 
139     m_attrReady = false;
140     return m_osInterface->pfnSubmitCommandBuffer(m_osInterface, cmdBuffer, false);
141 }
142 
SetHintParams()143 MOS_STATUS MediaScalabilitySinglePipe::SetHintParams()
144 {
145     SCALABILITY_FUNCTION_ENTER;
146 
147     SCALABILITY_CHK_NULL_RETURN(m_osInterface);
148     if (m_osInterface->apoMosEnabled)
149     {
150         SCALABILITY_CHK_NULL_RETURN(m_osInterface->osStreamState);
151     }
152     else
153     {
154         SCALABILITY_CHK_NULL_RETURN(m_veInterface);
155     }
156 
157     MOS_STATUS                   eStatus = MOS_STATUS_SUCCESS;
158     MOS_VIRTUALENGINE_SET_PARAMS veParams;
159     MOS_ZeroMemory(&veParams, sizeof(veParams));
160 
161     veParams.ucScalablePipeNum = 1;
162     veParams.bScalableMode     = false;
163 
164     if (!MOS_VE_CTXBASEDSCHEDULING_SUPPORTED(m_osInterface))
165     {
166         //not used by VE2.0
167         veParams.bNeedSyncWithPrevious       = true;
168         veParams.bSameEngineAsLastSubmission = false;
169         veParams.bSFCInUse                   = false;
170     }
171 
172     SCALABILITY_CHK_STATUS_RETURN(m_osInterface->pfnSetHintParams(m_osInterface, &veParams));
173 
174     return eStatus;
175 }
176 
Destroy()177 MOS_STATUS MediaScalabilitySinglePipe::Destroy()
178 {
179     SCALABILITY_FUNCTION_ENTER;
180 
181     SCALABILITY_CHK_STATUS_RETURN(MediaScalabilitySinglePipeNext::Destroy());
182 
183     if (m_veInterface)
184     {
185         if (m_veInterface->pfnVEDestroy)
186         {
187             m_veInterface->pfnVEDestroy(m_veInterface);
188         }
189         MOS_FreeMemAndSetNull(m_veInterface);
190     }
191     else
192     {
193         if (!m_osInterface->apoMosEnabled)
194         {
195             // For VE not enabled/supported case, such as vp vebox on some platform, m_veInterface is nullptr.
196             // MOS_STATUS_SUCCESS should be returned for such case.
197             if (MOS_VE_SUPPORTED(m_osInterface))
198             {
199                 SCALABILITY_CHK_NULL_RETURN(m_veInterface);
200             }
201         }
202     }
203 
204     return MOS_STATUS_SUCCESS;
205 }
206