| /***************************************************************************** |
| * Copyright Statement: |
| * -------------------- |
| * This software is protected by Copyright and the information contained |
| * herein is confidential. The software may not be copied and the information |
| * contained herein may not be used or disclosed except with the written |
| * permission of MediaTek Inc. (C) 2012 |
| * |
| * BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES |
| * THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE") |
| * RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON |
| * AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES, |
| * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF |
| * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. |
| * NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE |
| * SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR |
| * SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH |
| * THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO |
| * NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S |
| * SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM. |
| * |
| * BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE |
| * LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE, |
| * AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE, |
| * OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO |
| * MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. |
| * |
| * THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE |
| * WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF |
| * LAWS PRINCIPLES. ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND |
| * RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER |
| * THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC). |
| * |
| *****************************************************************************/ |
| |
| /***************************************************************************** |
| * |
| * Filename: |
| * --------- |
| * el2_api.h |
| * |
| * Project: |
| * -------- |
| * MOLY |
| * |
| * Description: |
| * ------------ |
| * prototypes of EL2 export function |
| * |
| * Author: |
| * ------- |
| * ------- |
| * |
| * ========================================================================== |
| * $Log$ |
| * |
| * 01 11 2018 jia-shi.lin |
| * [MOLY00301451] [SMO release][93/95]EL1 relative interface |
| * emac/el1 interface re-arch |
| * |
| * 08 03 2017 wen-jiunn.liu |
| * [MOLY00268551] Task batch scheduling for LTE Low power |
| * [EL2] Task Rescheduling for Low Power Polling Tick Change |
| * |
| * 08 03 2017 wen-jiunn.liu |
| * [MOLY00268551] Task batch scheduling for LTE Low power |
| * [EL2] Task Rescheduling for Low Power Polling Tick Change |
| * |
| * 04 07 2017 steve.kao |
| * [MOLY00230062] [UMOLYA] M-PS related interface changes for UPCM, RATDM, and EPDCP |
| * |
| * [UMOLYA][TRUNK] |
| * |
| * [UPCM][M-PS] Code changes |
| * 1. Duplicating UPCM contexts, |
| * 2. Use protocol_idx in UL/DL callback/ILM interfaces, |
| * 3. Check protocol_idx in LHIF PIT entries, |
| * 4. Fix test mode UL data processing flow, |
| * 5. Allowing test mode on protocol 2/3/4, |
| * 6. Wrap interfaces with RATDM with __MULTIPLE_PS__, |
| * |
| * [EPDCP][L+L] Code changes |
| * |
| * [RATDM][L+L] Code changes |
| * |
| * 09 26 2016 slifer.hsueh |
| * [MOLY00205085] [MT6293][EL2] ERLC source codes integration from DEV to TRUNK |
| * ERLC source codes integration from DEV to TRUNK |
| * |
| * 01 12 2016 kathie.ho |
| * [MOLY00156229] [MT6292] Code sync from MT6291: AuDRX |
| * CodeSync from LR11 (from 2015/09/21~11/15, exclude TSTM, MBMS)PART4 |
| * CL 1800644[MT6291]Autonomous DRX |
| * |
| * 09 07 2015 nienteh.hsu |
| * [MOLY00140671] [6292] ERLC code sync from LR11 to UMOLY (August) |
| * . |
| * |
| * 09 04 2015 nienteh.hsu |
| * . |
| * |
| * 09 04 2015 nienteh.hsu |
| * Code sync from LR11 to UMOLY. |
| * CL1542770: DL & UL print SDU raw data. |
| * CL1582626: Fix of DL print SDU raw data. |
| * CL1590595: ERLC build warning fix. |
| * CL1525169: EM HO duration reporting. ERLC-UL part is merged. |
| * CL1546539: Backup SIT head and tail index when copro power off. |
| * CL1564394: Avoid early return in sched_grant_main function and not trigger poll re-TX. |
| * CL1586893: Fix of EM HO duration reporting. |
| * |
| * 12 04 2014 shengyi.ho |
| * [MOLY00083854] [TK6291] eL2 development checkin CR |
| * 1) fix erlc gtest ut case HWB leakage |
| * 2) rename am/um var reset macro with ERLCUL/ERLCDL prefix |
| * 3) fix HWB C-model function of get UL/DL alloc hwb num |
| * |
| * 11 11 2014 yiting.cheng |
| * [MOLY00084042] [UMOLY] merge UMOLY_DEV to UMOLY trunk |
| * . |
| * |
| * 10 27 2014 sh.yang |
| * [MOLY00082211] [MT6291_DEV] EMBMS check-in |
| * embms check-in |
| * |
| * 10 08 2014 shengyi.ho |
| * [MOLY00077592] [TK6291] emac/erlc development check-in - 1) tti bundle/msg3 collide rv setting. 2) sr prohibit check. 3) add emac ut framework for tx req. 4) remove unused function in MT6291 |
| * . |
| * |
| * 07 31 2014 yiting.cheng |
| * [MOLY00073830] [MT6291_DEV] check-in MT6291 modification |
| * for fix potential target build error |
| * |
| * 07 30 2014 yiting.cheng |
| * [MOLY00073830] [MT6291_DEV] check-in MT6291 modification |
| * MT6291 modification, using temp interface with EL1 |
| * |
| * 01 15 2014 slifer.hsueh |
| * [MOLY00053104] [MT6290E2][NAS RTD][MM][FDD] Assert fail: driver/l2copro/cipher/src/cipher_common.c 196 - L2COPRO |
| * Merge codes related to L2 copro delay power off back to MOLY TRUNK in LTE domain |
| * |
| * 01 09 2014 moja.hsu |
| * [MOLY00052975] Fine tune RAR/EAR 1ms protection to prevent false alarm. |
| * . |
| * |
| * 12 03 2013 timothy.yao |
| * [MOLY00048832] power down/on in EL2 task context and refine the flow |
| * 1. power-off/on L2 copro in EL2 task context. |
| * 2. refine the flow betwwen EL1 & EL2. |
| * |
| * 09 27 2013 steve.kao |
| * [MOLY00039195] [MT6290] [Low Power] LTE L2 copro power down in LTE flight mode |
| * Unshelved from pending changelist '272199': |
| * |
| * Fix link error |
| * |
| * 08 20 2013 mf.jhang |
| * [MOLY00034292] [MT6290E1] Move PHR to SW |
| * Move PHR report to SW |
| * |
| * 07 23 2013 mf.jhang |
| * [MOLY00030911] [MT6290E1][EMAC] EMAC code enhancement |
| * Register UL LMAC error interrupt handler |
| * Update some trace |
| * |
| * 06 10 2013 mf.jhang |
| * [MOLY00025349] [MT6290E1][GCF][MD8430][LTE][TC 7.1.5.4] Assert fail driverl2coprolmacsrcl2lmac_drv.c 268 - L2COPRO |
| * Add EL2 API for DL LMAC handler |
| * |
| * 05 16 2013 moja.hsu |
| * [MOLY00007625] Maintain code |
| * fix edyn compile warning. |
| ****************************************************************************/ |
| |
| /** |
| * @date 2012/1/10 |
| */ |
| |
| #ifndef EL2_EXPORT_API |
| #define EL2_EXPORT_API |
| |
| //#include "drv/drv_lmac.h" |
| //#include "el1_enum.h" |
| #include "kal_public_api.h" |
| //#include "el2_def.h" |
| #include "lte_time_common.h" |
| |
| /* EL2 constructor */ |
| void el2_init(); |
| |
| // EL2 Tick Source Handler |
| void el2_tick_source_dispatch_tick(); |
| |
| /* EMAC export API */ |
| kal_bool emac_drx_is_drx_sleep(); // query whether EMAC DRX sleep or not |
| void emac_rcv_ilm(ilm_struct *pIlm); ///< EMAC message handler |
| void emac_el2task_rcv_ilm(ilm_struct *p_ilm); ///< EMAC message handler on EL2 task |
| void emac_ctrl_data_rcv(); ///< control data receiving handler TO_BE_REMOVE: please use emac_ctrl_data_check(). |
| void emac_ctrl_data_check(); ///< check DL control swo bits |
| void emac_early_protect_cancel_reg(void(*func)(void)); //Register early protect cancel callback |
| void emac_rar_protect_cancel_reg(void(*func)(void)); //Register rar protect cancel callback |
| #if MBMS_SUPPORT |
| void emac_mch_data_check(); ///< check MCH swo bits |
| #endif |
| |
| #if EL2_SBP_ON_AUDRX |
| void emac_audrx_rrc_cmd(kal_uint32 time); |
| void emac_audrx_nas_cmd(kal_uint32 time); |
| void emac_epdcp_audrx_timer_timeout(void); |
| void emac_epdcp_audrx_timer_restart(void); |
| kal_uint32 emac_audrx_rrc_sleep_report(void); |
| #endif |
| |
| /** |
| * @brief emac_check_rar_protect |
| * Check if we need to RAR 1ms protection. |
| * Prevent False alarm of frame boundary |
| * |
| * @return KAL_TRUE: Need to protection. |
| * KAL_FALSE: No need to do protection. |
| */ |
| //kal_bool emac_check_rar_protect(void); |
| |
| /** |
| * @brief emac_check_ear_protect |
| * Check if we need to RAR 1ms protection. |
| * Prevent False alarm of frame boundary |
| * |
| * @param vect SWO bit to indicate which HT contain EAR LCID |
| * |
| * @return KAL_TRUE: Need to protection. |
| * KAL_FALSE: No need to do protection. |
| */ |
| //kal_bool emac_check_ear_protect(ht_ear_vect *vect); |
| kal_int32 _lte_dl_lmac_err_hndlr(kal_uint32 vect, void *ptr); //DL LMAC error interrupt callback |
| kal_int32 _lte_ul_lmac_err_hndlr(kal_uint32 vect, void *ptr); //UL LMAC error interrupt callback |
| |
| /* ERLC export API */ |
| void erlcul_rcv_ilm(ilm_struct *pIlm); ///< ERLC-UL message handler |
| void erlcdl_rcv_ilm(ilm_struct *pIlm); ///< ERLC-DL message handler |
| void erlcul_poll(); ///< ERLC-UL polling |
| void erlcdl_poll(); ///< ERLC-DL polling |
| void erlcul_reset(); ///< ERLC-UL reset |
| void erlcdl_reset(); ///< ERLC-DL reset |
| |
| kal_uint32 erlcul_query_sleep_allow(); ///< ERLC-UL sees if we can sleep copro |
| void erlcul_copro_power_down_backup(); ///back up info used when copro power off |
| |
| #endif |