xref: /utopia/UTPA2-700.0.x/modules/sem/hal/maserati/sem/halSEM.c (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1*53ee8cc1Swenshuai.xi //<MStar Software>
2*53ee8cc1Swenshuai.xi //******************************************************************************
3*53ee8cc1Swenshuai.xi // MStar Software
4*53ee8cc1Swenshuai.xi // Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
5*53ee8cc1Swenshuai.xi // All software, firmware and related documentation herein ("MStar Software") are
6*53ee8cc1Swenshuai.xi // intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
7*53ee8cc1Swenshuai.xi // law, including, but not limited to, copyright law and international treaties.
8*53ee8cc1Swenshuai.xi // Any use, modification, reproduction, retransmission, or republication of all
9*53ee8cc1Swenshuai.xi // or part of MStar Software is expressly prohibited, unless prior written
10*53ee8cc1Swenshuai.xi // permission has been granted by MStar.
11*53ee8cc1Swenshuai.xi //
12*53ee8cc1Swenshuai.xi // By accessing, browsing and/or using MStar Software, you acknowledge that you
13*53ee8cc1Swenshuai.xi // have read, understood, and agree, to be bound by below terms ("Terms") and to
14*53ee8cc1Swenshuai.xi // comply with all applicable laws and regulations:
15*53ee8cc1Swenshuai.xi //
16*53ee8cc1Swenshuai.xi // 1. MStar shall retain any and all right, ownership and interest to MStar
17*53ee8cc1Swenshuai.xi //    Software and any modification/derivatives thereof.
18*53ee8cc1Swenshuai.xi //    No right, ownership, or interest to MStar Software and any
19*53ee8cc1Swenshuai.xi //    modification/derivatives thereof is transferred to you under Terms.
20*53ee8cc1Swenshuai.xi //
21*53ee8cc1Swenshuai.xi // 2. You understand that MStar Software might include, incorporate or be
22*53ee8cc1Swenshuai.xi //    supplied together with third party`s software and the use of MStar
23*53ee8cc1Swenshuai.xi //    Software may require additional licenses from third parties.
24*53ee8cc1Swenshuai.xi //    Therefore, you hereby agree it is your sole responsibility to separately
25*53ee8cc1Swenshuai.xi //    obtain any and all third party right and license necessary for your use of
26*53ee8cc1Swenshuai.xi //    such third party`s software.
27*53ee8cc1Swenshuai.xi //
28*53ee8cc1Swenshuai.xi // 3. MStar Software and any modification/derivatives thereof shall be deemed as
29*53ee8cc1Swenshuai.xi //    MStar`s confidential information and you agree to keep MStar`s
30*53ee8cc1Swenshuai.xi //    confidential information in strictest confidence and not disclose to any
31*53ee8cc1Swenshuai.xi //    third party.
32*53ee8cc1Swenshuai.xi //
33*53ee8cc1Swenshuai.xi // 4. MStar Software is provided on an "AS IS" basis without warranties of any
34*53ee8cc1Swenshuai.xi //    kind. Any warranties are hereby expressly disclaimed by MStar, including
35*53ee8cc1Swenshuai.xi //    without limitation, any warranties of merchantability, non-infringement of
36*53ee8cc1Swenshuai.xi //    intellectual property rights, fitness for a particular purpose, error free
37*53ee8cc1Swenshuai.xi //    and in conformity with any international standard.  You agree to waive any
38*53ee8cc1Swenshuai.xi //    claim against MStar for any loss, damage, cost or expense that you may
39*53ee8cc1Swenshuai.xi //    incur related to your use of MStar Software.
40*53ee8cc1Swenshuai.xi //    In no event shall MStar be liable for any direct, indirect, incidental or
41*53ee8cc1Swenshuai.xi //    consequential damages, including without limitation, lost of profit or
42*53ee8cc1Swenshuai.xi //    revenues, lost or damage of data, and unauthorized system use.
43*53ee8cc1Swenshuai.xi //    You agree that this Section 4 shall still apply without being affected
44*53ee8cc1Swenshuai.xi //    even if MStar Software has been modified by MStar in accordance with your
45*53ee8cc1Swenshuai.xi //    request or instruction for your use, except otherwise agreed by both
46*53ee8cc1Swenshuai.xi //    parties in writing.
47*53ee8cc1Swenshuai.xi //
48*53ee8cc1Swenshuai.xi // 5. If requested, MStar may from time to time provide technical supports or
49*53ee8cc1Swenshuai.xi //    services in relation with MStar Software to you for your use of
50*53ee8cc1Swenshuai.xi //    MStar Software in conjunction with your or your customer`s product
51*53ee8cc1Swenshuai.xi //    ("Services").
52*53ee8cc1Swenshuai.xi //    You understand and agree that, except otherwise agreed by both parties in
53*53ee8cc1Swenshuai.xi //    writing, Services are provided on an "AS IS" basis and the warranty
54*53ee8cc1Swenshuai.xi //    disclaimer set forth in Section 4 above shall apply.
55*53ee8cc1Swenshuai.xi //
56*53ee8cc1Swenshuai.xi // 6. Nothing contained herein shall be construed as by implication, estoppels
57*53ee8cc1Swenshuai.xi //    or otherwise:
58*53ee8cc1Swenshuai.xi //    (a) conferring any license or right to use MStar name, trademark, service
59*53ee8cc1Swenshuai.xi //        mark, symbol or any other identification;
60*53ee8cc1Swenshuai.xi //    (b) obligating MStar or any of its affiliates to furnish any person,
61*53ee8cc1Swenshuai.xi //        including without limitation, you and your customers, any assistance
62*53ee8cc1Swenshuai.xi //        of any kind whatsoever, or any information; or
63*53ee8cc1Swenshuai.xi //    (c) conferring any license or right under any intellectual property right.
64*53ee8cc1Swenshuai.xi //
65*53ee8cc1Swenshuai.xi // 7. These terms shall be governed by and construed in accordance with the laws
66*53ee8cc1Swenshuai.xi //    of Taiwan, R.O.C., excluding its conflict of law rules.
67*53ee8cc1Swenshuai.xi //    Any and all dispute arising out hereof or related hereto shall be finally
68*53ee8cc1Swenshuai.xi //    settled by arbitration referred to the Chinese Arbitration Association,
69*53ee8cc1Swenshuai.xi //    Taipei in accordance with the ROC Arbitration Law and the Arbitration
70*53ee8cc1Swenshuai.xi //    Rules of the Association by three (3) arbitrators appointed in accordance
71*53ee8cc1Swenshuai.xi //    with the said Rules.
72*53ee8cc1Swenshuai.xi //    The place of arbitration shall be in Taipei, Taiwan and the language shall
73*53ee8cc1Swenshuai.xi //    be English.
74*53ee8cc1Swenshuai.xi //    The arbitration award shall be final and binding to both parties.
75*53ee8cc1Swenshuai.xi //
76*53ee8cc1Swenshuai.xi //******************************************************************************
77*53ee8cc1Swenshuai.xi //<MStar Software>
78*53ee8cc1Swenshuai.xi 
79*53ee8cc1Swenshuai.xi #include "MsCommon.h"
80*53ee8cc1Swenshuai.xi #include "regSEM.h"
81*53ee8cc1Swenshuai.xi #include "halSEM.h"
82*53ee8cc1Swenshuai.xi 
83*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
84*53ee8cc1Swenshuai.xi //  Local Defines
85*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
86*53ee8cc1Swenshuai.xi #define REG16(addr)     *((volatile MS_U16*)((_u32RegBase+ ((addr)<< 2))))
87*53ee8cc1Swenshuai.xi 
88*53ee8cc1Swenshuai.xi #define SEM_ID_GP0  \
89*53ee8cc1Swenshuai.xi     E_SEM_DUMMY, \
90*53ee8cc1Swenshuai.xi     E_SEM_GE0, \
91*53ee8cc1Swenshuai.xi     E_SEM_GE1, \
92*53ee8cc1Swenshuai.xi     E_SEM_BDMA,\
93*53ee8cc1Swenshuai.xi     E_SEM_PM,\
94*53ee8cc1Swenshuai.xi     E_SEM_TEE, \
95*53ee8cc1Swenshuai.xi     E_SEM_MBX_RECV,\
96*53ee8cc1Swenshuai.xi     E_SEM_MBX_SEND, \
97*53ee8cc1Swenshuai.xi     E_SEM_USER0, \
98*53ee8cc1Swenshuai.xi     E_SEM_USER1, \
99*53ee8cc1Swenshuai.xi     E_SEM_USER2, \
100*53ee8cc1Swenshuai.xi     E_SEM_USER3, \
101*53ee8cc1Swenshuai.xi     E_SEM_CA, \
102*53ee8cc1Swenshuai.xi     E_SEM_IIC, \
103*53ee8cc1Swenshuai.xi     E_SEM_DUMMY, \
104*53ee8cc1Swenshuai.xi     E_SEM_DUMMY
105*53ee8cc1Swenshuai.xi 
106*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
107*53ee8cc1Swenshuai.xi //  Local Variables
108*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
109*53ee8cc1Swenshuai.xi static MS_VIRT           _u32RegBase = 0;
110*53ee8cc1Swenshuai.xi 
111*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
112*53ee8cc1Swenshuai.xi //  Local Structures
113*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
114*53ee8cc1Swenshuai.xi const eSemId SemIdTbl[SEM_MAX_GP_CLIENT] =
115*53ee8cc1Swenshuai.xi {
116*53ee8cc1Swenshuai.xi     SEM_ID_GP0
117*53ee8cc1Swenshuai.xi };
118*53ee8cc1Swenshuai.xi 
HAL_SEM_GetSemId(eSemId eSemId)119*53ee8cc1Swenshuai.xi MS_S16 HAL_SEM_GetSemId(eSemId eSemId)
120*53ee8cc1Swenshuai.xi {
121*53ee8cc1Swenshuai.xi     MS_U8 idx;
122*53ee8cc1Swenshuai.xi 
123*53ee8cc1Swenshuai.xi     for (idx = 0; idx < SEM_MAX_GP_CLIENT; idx++)
124*53ee8cc1Swenshuai.xi         if (eSemId == SemIdTbl[idx])
125*53ee8cc1Swenshuai.xi             return idx;
126*53ee8cc1Swenshuai.xi     return (-1);
127*53ee8cc1Swenshuai.xi }
128*53ee8cc1Swenshuai.xi 
HAL_SEM_SetBank(MS_VIRT u32BaseAddr)129*53ee8cc1Swenshuai.xi MS_BOOL HAL_SEM_SetBank(MS_VIRT u32BaseAddr)
130*53ee8cc1Swenshuai.xi {
131*53ee8cc1Swenshuai.xi     _u32RegBase = u32BaseAddr;
132*53ee8cc1Swenshuai.xi     return TRUE;
133*53ee8cc1Swenshuai.xi }
134*53ee8cc1Swenshuai.xi 
HAL_SEM_Get_Num(void)135*53ee8cc1Swenshuai.xi MS_U32 HAL_SEM_Get_Num(void)
136*53ee8cc1Swenshuai.xi {
137*53ee8cc1Swenshuai.xi     return REG_SEM_MAX_NUM;
138*53ee8cc1Swenshuai.xi }
139*53ee8cc1Swenshuai.xi 
HAL_SEM_Get_Resource(MS_U8 u8SemID,MS_U16 u16ResId)140*53ee8cc1Swenshuai.xi MS_BOOL HAL_SEM_Get_Resource(MS_U8 u8SemID, MS_U16 u16ResId)
141*53ee8cc1Swenshuai.xi {
142*53ee8cc1Swenshuai.xi     if(u8SemID> REG_SEM_MAX_NUM)
143*53ee8cc1Swenshuai.xi         return FALSE;
144*53ee8cc1Swenshuai.xi     REG16(REG_SEM_ID0+ u8SemID)= u16ResId;
145*53ee8cc1Swenshuai.xi     return (u16ResId == REG16(REG_SEM_ID0+ u8SemID))? TRUE: FALSE;
146*53ee8cc1Swenshuai.xi }
147*53ee8cc1Swenshuai.xi 
HAL_SEM_Free_Resource(MS_U8 u8SemID,MS_U16 u16ResId)148*53ee8cc1Swenshuai.xi MS_BOOL HAL_SEM_Free_Resource(MS_U8 u8SemID, MS_U16 u16ResId)
149*53ee8cc1Swenshuai.xi {
150*53ee8cc1Swenshuai.xi     if(u8SemID> REG_SEM_MAX_NUM)
151*53ee8cc1Swenshuai.xi         return FALSE;
152*53ee8cc1Swenshuai.xi 
153*53ee8cc1Swenshuai.xi     if (u16ResId != REG16(REG_SEM_ID0+ u8SemID))
154*53ee8cc1Swenshuai.xi     {
155*53ee8cc1Swenshuai.xi         return FALSE;
156*53ee8cc1Swenshuai.xi     }
157*53ee8cc1Swenshuai.xi     REG16(REG_SEM_ID0+ u8SemID)= 0x00;
158*53ee8cc1Swenshuai.xi     return TRUE;
159*53ee8cc1Swenshuai.xi }
160*53ee8cc1Swenshuai.xi 
161*53ee8cc1Swenshuai.xi 
HAL_SEM_Reset_Resource(MS_U8 u8SemID)162*53ee8cc1Swenshuai.xi MS_BOOL HAL_SEM_Reset_Resource(MS_U8 u8SemID)
163*53ee8cc1Swenshuai.xi {
164*53ee8cc1Swenshuai.xi     if(u8SemID> REG_SEM_MAX_NUM)
165*53ee8cc1Swenshuai.xi         return FALSE;
166*53ee8cc1Swenshuai.xi     REG16(REG_SEM_ID0+ u8SemID)= 0x00;
167*53ee8cc1Swenshuai.xi     return TRUE;
168*53ee8cc1Swenshuai.xi }
169*53ee8cc1Swenshuai.xi 
170*53ee8cc1Swenshuai.xi 
HAL_SEM_Get_ResourceID(MS_U8 u8SemID,MS_U16 * pu16ResId)171*53ee8cc1Swenshuai.xi MS_BOOL HAL_SEM_Get_ResourceID(MS_U8 u8SemID, MS_U16* pu16ResId)
172*53ee8cc1Swenshuai.xi {
173*53ee8cc1Swenshuai.xi     if(u8SemID> REG_SEM_MAX_NUM)
174*53ee8cc1Swenshuai.xi         return FALSE;
175*53ee8cc1Swenshuai.xi     *pu16ResId = REG16(REG_SEM_ID0+ u8SemID);
176*53ee8cc1Swenshuai.xi     return TRUE;
177*53ee8cc1Swenshuai.xi }
178*53ee8cc1Swenshuai.xi 
179