yu.dong | c33b307 | 2024-08-21 23:14:49 -0700 | [diff] [blame^] | 1 | /***************************************************************************** |
| 2 | * Copyright Statement: |
| 3 | * -------------------- |
| 4 | * This software is protected by Copyright and the information contained |
| 5 | * herein is confidential. The software may not be copied and the information |
| 6 | * contained herein may not be used or disclosed except with the written |
| 7 | * permission of MediaTek Inc. (C) 2016 |
| 8 | * |
| 9 | * BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES |
| 10 | * THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS (""MEDIATEK SOFTWARE"") |
| 11 | * RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON |
| 12 | * AN ""AS-IS"" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES, |
| 13 | * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF |
| 14 | * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. |
| 15 | * NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE |
| 16 | * SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR |
| 17 | * SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH |
| 18 | * THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO |
| 19 | * NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S |
| 20 | * SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM. |
| 21 | * |
| 22 | * BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE |
| 23 | * LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE, |
| 24 | * AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE, |
| 25 | * OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO |
| 26 | * MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. |
| 27 | * |
| 28 | * THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE |
| 29 | * WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF |
| 30 | * LAWS PRINCIPLES. ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND |
| 31 | * RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER |
| 32 | * THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC). |
| 33 | * |
| 34 | *****************************************************************************/ |
| 35 | /************************************************************* |
| 36 | * |
| 37 | * This Software is the property of VIA Telecom, Inc. and may only be used pursuant to a license from VIA Telecom, Inc. |
| 38 | * |
| 39 | * Any unauthorized use inconsistent with the terms of such license is strictly prohibited. |
| 40 | * |
| 41 | * Copyright (c) 2007-2010 VIA Telecom, Inc. All rights reserved. |
| 42 | * |
| 43 | *************************************************************/ |
| 44 | #ifndef VALDBMAPI_H |
| 45 | #define VALDBMAPI_H |
| 46 | /************************************************************************************************* |
| 47 | * |
| 48 | * FILE NAME : valdbmapi.h |
| 49 | * |
| 50 | * DESCRIPTION : This file contains the declarations, definitions |
| 51 | * and data structures used to interface to the |
| 52 | * VAL for the DBM API. |
| 53 | * |
| 54 | * |
| 55 | * HISTORY : |
| 56 | * See Log at end of file |
| 57 | * |
| 58 | **************************************************************************************************/ |
| 59 | #include "sysdefs.h" |
| 60 | #include "pswapi.h" |
| 61 | #include "cssapi.h" |
| 62 | #include "uimapi.h" |
| 63 | #include "do_clcapi.h" |
| 64 | #include "hlpapi.h" |
| 65 | #include "sysapi.h" |
| 66 | |
| 67 | #include "valapi.h" |
| 68 | |
| 69 | #define VAL_DBM_MAX_REG_TASK 2 |
| 70 | |
| 71 | #define DUMMY_REGID_COPY_DATA 0xFF /* Reg Id used in Set/Get when data has to be copied into the message buffer */ |
| 72 | #define DUMMY_REGID_USE_DATAPTR 0xFE /* Reg Id used in Set/Get when valid data pointer is supplied (i.e. data does not need to be copied in message buffer) */ |
| 73 | |
| 74 | /* Messages sent between VAL and tasks managing parameters */ |
| 75 | /* that can be requested through VAL */ |
| 76 | /* Request from VAL ---> PSW, or CSS, or HLP, or CLC, etc... */ |
| 77 | typedef struct |
| 78 | { |
| 79 | ExeRspMsgT RspInfo; /* Response routing information */ |
| 80 | RegIdT RegId; /* RegId of the requester */ |
| 81 | kal_uint8 ParmId; |
| 82 | kal_uint8 opType; |
| 83 | kal_uint32 length; |
| 84 | kal_uint8* dataPtr; |
| 85 | #ifdef MTK_PLT_ON_PC_UT |
| 86 | union { |
| 87 | Css1xBsrTimerDuration_APIStruct bsr1xTimerDuration; |
| 88 | Css1xAvoidanceTimerDuration_APIStruct avoidance1xTimerDuration; |
| 89 | CssDOBsrTimerDuration_APIStruct bsrDOTimerDuration; |
| 90 | Css1xManualAvoidSid_APIStruct manual1xAvoidSid; |
| 91 | CssSetMruChannel_APIStruct mruChannel; |
| 92 | CssSetChannleLockInfo_APIStruct channleLockInfo; |
| 93 | CssTimerDuration_APIStruct timerDuration; |
| 94 | HlpAkaPassword_APIStruct akaPsd; |
| 95 | HlpAkaProfileData_APIStruct akaProfileData; |
| 96 | } data; |
| 97 | #endif |
| 98 | } ValGenericSetParmMsgT; |
| 99 | |
| 100 | typedef struct |
| 101 | { |
| 102 | ExeRspMsgT RspInfo; /*Response routing information */ |
| 103 | RegIdT RegId; /* RegId of the requester */ |
| 104 | kal_uint8 ParmId; |
| 105 | kal_uint8 opType; |
| 106 | kal_uint32 length; |
| 107 | kal_bool allocBuffer; /* If true, the data will be within the response, otherwise that will be written at address pointed to by dataPtr */ |
| 108 | kal_uint8* dataPtr; |
| 109 | #ifdef MTK_PLT_ON_PC_UT |
| 110 | union { |
| 111 | Css1xBsrTimerDuration_APIStruct bsr1xTimerDuration; |
| 112 | Css1xAvoidanceTimerDuration_APIStruct avoidance1xTimerDuration; |
| 113 | CssDOBsrTimerDuration_APIStruct bsrDOTimerDuration; |
| 114 | Css1xManualAvoidSid_APIStruct manual1xAvoidSid; |
| 115 | CssGetMruChannel_APIStruct mruChannel; |
| 116 | } data; |
| 117 | #endif |
| 118 | } ValGenericGetParmMsgT; |
| 119 | |
| 120 | /* Response from PSW, CSS, HLP, CLC, etc... ---> VAL */ |
| 121 | typedef struct |
| 122 | { |
| 123 | ExeRspMsgT RspInfo; /* Response routing information */ |
| 124 | RegIdT RegId; /* RegId of the requester (echo from the request message) */ |
| 125 | kal_uint8 ParmId; |
| 126 | kal_uint8 result; |
| 127 | kal_uint32 length; |
| 128 | kal_uint8* dataPtr; |
| 129 | #ifdef MTK_PLT_ON_PC_UT |
| 130 | union { |
| 131 | Css1xBsrTimerDuration_APIStruct bsr1xTimerDuration; |
| 132 | Css1xAvoidanceTimerDuration_APIStruct avoidance1xTimerDuration; |
| 133 | CssDOBsrTimerDuration_APIStruct bsrDOTimerDuration; |
| 134 | Css1xManualAvoidSid_APIStruct manual1xAvoidSid; |
| 135 | CssGetMruChannel_APIStruct mruChannel; |
| 136 | cssChannleLockInfo channleLockInfo; |
| 137 | CssTimerDuration_APIStruct timerDuration; |
| 138 | } data; |
| 139 | #endif |
| 140 | } ValGenericGetParmRspMsgT; |
| 141 | |
| 142 | typedef struct |
| 143 | { |
| 144 | ExeRspMsgT RspInfo; /* Response routing information */ |
| 145 | RegIdT RegId; /* RegId of the requester (echo from the request message) */ |
| 146 | kal_uint8 ParmId; |
| 147 | kal_uint8 result; |
| 148 | } ValGenericSetParmRspMsgT; |
| 149 | |
| 150 | |
| 151 | /* Messages sent between VAL and other tasks requesting parameters */ |
| 152 | /* for example between VAL and ETS */ |
| 153 | /* To VAL */ |
| 154 | typedef struct |
| 155 | { |
| 156 | ExeRspMsgT rspInfo; |
| 157 | kal_uint8 OperationId; |
| 158 | kal_uint8 OperationType; |
| 159 | kal_uint8 data; |
| 160 | } ValDbmApiSetParmMsgT; |
| 161 | |
| 162 | typedef struct |
| 163 | { |
| 164 | ExeRspMsgT rspInfo; |
| 165 | kal_uint8 OperationId; |
| 166 | kal_uint8 OperationType; |
| 167 | kal_uint8 data; |
| 168 | } ValDbmApiGetParmMsgT; |
| 169 | |
| 170 | /* From VAL */ |
| 171 | typedef struct |
| 172 | { |
| 173 | kal_uint8 ParmId; |
| 174 | kal_uint8 result; |
| 175 | } ValDbmApiSetParmRspMsgT; |
| 176 | |
| 177 | typedef struct |
| 178 | { |
| 179 | kal_uint8 ParmId; |
| 180 | kal_uint8 result; |
| 181 | kal_uint32 length; |
| 182 | kal_uint8 data; |
| 183 | } ValDbmApiGetParmRspMsgT, ValDbmEtsGetParmRspMsgT; |
| 184 | |
| 185 | typedef struct |
| 186 | { |
| 187 | kal_uint8 ParmId; |
| 188 | kal_uint8 result; |
| 189 | kal_uint8 data; |
| 190 | } ValDbmEtsGetParmNoLengthRspMsgT; |
| 191 | |
| 192 | typedef enum |
| 193 | { |
| 194 | VAL_DBM_GET_HPSD_SEG_MSG, |
| 195 | VAL_PSW_EVT_GET_MS_PARM_RSP, |
| 196 | VAL_PSW_EVT_SET_MS_PARM_RSP, |
| 197 | VAL_HL_EVT_GET_MS_PARM_RSP, |
| 198 | VAL_HL_EVT_SET_MS_PARM_RSP, |
| 199 | VAL_CLC_EVT_GET_DO_PARM_RSP, |
| 200 | VAL_CLC_EVT_SET_DO_PARM_RSP, |
| 201 | VAL_UI_EVT_SET_PARM_RSP, |
| 202 | VAL_CLC_EVT_SET_DO_PARM_NORSP, |
| 203 | VAL_UICC_EVT_SET_PARM_RSP, |
| 204 | VAL_UICC_EVT_GET_PARM_RSP, |
| 205 | VAL_CSS_EVT_GET_PARM_RSP, |
| 206 | VAL_CSS_EVT_SET_PARM_RSP, |
| 207 | VAL_DBM_EVENT_END_LIST |
| 208 | } ValDbmEventIdT; |
| 209 | |
| 210 | |
| 211 | /*=========================================================================== |
| 212 | SYS Set and Get Parm Defines |
| 213 | ===========================================================================*/ |
| 214 | typedef enum |
| 215 | { |
| 216 | SYS_PARM_SET_BAND_CLASS, |
| 217 | SYS_PARM_GET_BAND_CLASS, |
| 218 | SYS_PARM_SET_SUB_CLASS, |
| 219 | SYS_PARM_GET_SUB_CLASS, |
| 220 | SYS_PARM_OPERATION_ID_END_LIST |
| 221 | } SysParmOperationId; |
| 222 | |
| 223 | typedef enum |
| 224 | { |
| 225 | SYS_PARM_MIN_VALUE, |
| 226 | SYS_PARM_MAX_VALUE, |
| 227 | SYS_PARM_DEFAULT_VALUE, |
| 228 | SYS_PARM_CUSTOM_VALUE, |
| 229 | SYS_PARM_OP_TYPE_LIST_END |
| 230 | } SysParmOperationType; |
| 231 | |
| 232 | typedef enum |
| 233 | { |
| 234 | SYS_PARM_OPERATION_SUCCESS, |
| 235 | SYS_PARM_OPERATION_FAIL_READ_NOT_ALLOWED, |
| 236 | SYS_PARM_OPERATION_FAIL_WRITE_NOT_ALLOWED, |
| 237 | SYS_PARM_OPERATION_FAIL_VALUE_OUT_OF_RANGE, |
| 238 | SYS_PARM_OPERATION_GENERAL_FAILURE, |
| 239 | SYS_PARM_OPERATION_FAIL_OP_TYPE_NOT_SUPPORTED, |
| 240 | SYS_PARM_OPERATION_NOT_SUPPORTED_BAND_CLASS, |
| 241 | SYS_PARM_OPERATION_NOT_SUPPORTED_SUB_CLASS, |
| 242 | SYS_PARM_OPERATION_RESULT_END_LIST |
| 243 | } SysParmAccessResultCode; |
| 244 | |
| 245 | typedef struct |
| 246 | { |
| 247 | ExeRspMsgT rspInfo; |
| 248 | SysParmOperationId OperationId; |
| 249 | SysParmOperationType OperationType; |
| 250 | kal_uint8 data; |
| 251 | } ValDbmSysSetParmETSMsgT; |
| 252 | |
| 253 | typedef struct |
| 254 | { |
| 255 | ExeRspMsgT rspInfo; |
| 256 | SysParmOperationId OperationId; |
| 257 | SysParmOperationType OperationType; |
| 258 | kal_uint8 *data; |
| 259 | } ValDbmSysGetParmETSMsgT; |
| 260 | |
| 261 | typedef struct |
| 262 | { |
| 263 | SysParmAccessResultCode result; |
| 264 | } ValDbmSysSetBandClassParmRspMsgT; |
| 265 | |
| 266 | typedef struct |
| 267 | { |
| 268 | kal_uint8 BandClass; |
| 269 | kal_uint8 Supported; |
| 270 | } SysSetBandClassParmT; |
| 271 | |
| 272 | typedef struct |
| 273 | { |
| 274 | SysParmAccessResultCode result; |
| 275 | } ValDbmSysSetSubClassParmRspMsgT; |
| 276 | |
| 277 | typedef struct |
| 278 | { |
| 279 | kal_uint8 BandClass; |
| 280 | kal_uint8 SubClass; |
| 281 | kal_uint8 Status; |
| 282 | } SysSetSubClassParmT; |
| 283 | |
| 284 | typedef struct |
| 285 | { |
| 286 | kal_uint8 BandClass; |
| 287 | } ValDbmSysGetBandClassParmT; |
| 288 | |
| 289 | typedef struct |
| 290 | { |
| 291 | kal_uint8 BandClass; |
| 292 | kal_uint8 Supported; |
| 293 | } ValBandClassRecordT; |
| 294 | |
| 295 | typedef struct |
| 296 | { |
| 297 | kal_uint8 NumberRecords; |
| 298 | ValBandClassRecordT Record[1]; |
| 299 | } ValDbmSysGetBandClassParmRspMsgT; |
| 300 | |
| 301 | typedef struct |
| 302 | { |
| 303 | kal_uint8 BandClass; |
| 304 | } ValDbmSysGetSubClassParmT; |
| 305 | |
| 306 | |
| 307 | #ifdef __cplusplus |
| 308 | extern "C" { |
| 309 | #endif /* __cplusplus */ |
| 310 | |
| 311 | /*=========================================================================== |
| 312 | |
| 313 | FUNCTION ValDbmInit() |
| 314 | |
| 315 | DESCRIPTION Initialize the Dbm Val Module |
| 316 | |
| 317 | PARAMETERS None |
| 318 | |
| 319 | RETURN VALUE None |
| 320 | |
| 321 | ===========================================================================*/ |
| 322 | void ValDbmInit( void ); |
| 323 | |
| 324 | /*=========================================================================== |
| 325 | |
| 326 | FUNCTION: ValDbmProcessEvent |
| 327 | |
| 328 | DESCRIPTION: This function processes the event received and calls the |
| 329 | registered call back. |
| 330 | |
| 331 | PARAMETERS: ValLbsEventIdT EventId, void *EventMsgP |
| 332 | |
| 333 | RETURN VALUE: None |
| 334 | |
| 335 | ===========================================================================*/ |
| 336 | void ValDbmProcessEvent( ValDbmEventIdT EventId, void* EventMsgP ); |
| 337 | |
| 338 | /*************************************************************************** |
| 339 | |
| 340 | FUNCTION ValDbmRegister |
| 341 | |
| 342 | DESCRIPTION This function registers a callback for all Dbm related events. |
| 343 | |
| 344 | PARAMETERS Callback - The callback function to be called for the notification of LBS |
| 345 | services events. |
| 346 | |
| 347 | RETURN VALUE The assigned registration ID of the subscriber. |
| 348 | |
| 349 | *****************************************************************************/ |
| 350 | RegIdT ValDbmRegister( ValEventFunc Callback ); |
| 351 | |
| 352 | /*************************************************************************** |
| 353 | |
| 354 | FUNCTION ValDbmUnregister |
| 355 | |
| 356 | DESCRIPTION This function unregisters the given client so that it won't receive additional |
| 357 | Dbm services related events. |
| 358 | |
| 359 | PARAMETERS RegId - The assigned registration ID of the subscriber. |
| 360 | |
| 361 | RETURN VALUE None |
| 362 | |
| 363 | *****************************************************************************/ |
| 364 | void ValLbsUnregister( RegIdT RegId ); |
| 365 | |
| 366 | |
| 367 | /***************************************************************************** |
| 368 | * PSW SET/GET PARAMETERS API * |
| 369 | *****************************************************************************/ |
| 370 | /*---------------------------------------------------------------------------- |
| 371 | FUNCTION NAME: ValDbmSetPswParameter |
| 372 | DESCRIPTION: Process a request to set a parameter maintained by PSW. |
| 373 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 374 | ExeRspMsgT*: routing info for the response |
| 375 | PswParmOperationalId: Parameter that is being requested |
| 376 | void*: Memory allocated for PSW to retrieve contents |
| 377 | kal_uint32: length of valid data in dataPtr |
| 378 | ------------------------------------------------------------------------------*/ |
| 379 | void ValDbmSetPswParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, PswParmOperationId parm_op_id, |
| 380 | PswParmOperationType opType,void* dataPtr, kal_uint32 length); |
| 381 | /*---------------------------------------------------------------------------- |
| 382 | FUNCTION NAME: ValDbmSetPswParm |
| 383 | DESCRIPTION: Deprecated version of ValDbmSetPswParameter |
| 384 | ------------------------------------------------------------------------------*/ |
| 385 | void ValDbmSetPswParm(RegIdT RegId, PswParmOperationId parm_op_id, |
| 386 | PswParmOperationType opType,void* dataPtr, kal_uint32* length); |
| 387 | |
| 388 | void ValDbmSetPswParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 389 | |
| 390 | /*---------------------------------------------------------------------------- |
| 391 | FUNCTION NAME: ValDbmGetPswParameter |
| 392 | DESCRIPTION: Process a request to get a parameter maintained by PSW. |
| 393 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 394 | ExeRspMsgT*: routing info for the response |
| 395 | PswParmOperationalId: Parameter that is being requested |
| 396 | void*: Memory allocated for PSW to put contents |
| 397 | kal_uint32: length of data expected to be populated in dataPtr |
| 398 | ------------------------------------------------------------------------------*/ |
| 399 | void ValDbmGetPswParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, PswParmOperationId parm_op_id, |
| 400 | PswParmOperationType opType, void* dataPtr, kal_uint32 length); |
| 401 | /*---------------------------------------------------------------------------- |
| 402 | FUNCTION NAME: ValDbmGetPswParm |
| 403 | DESCRIPTION: Deprecated version of ValDbmGetPswParameter |
| 404 | ------------------------------------------------------------------------------*/ |
| 405 | void ValDbmGetPswParm(RegIdT RegId, PswParmOperationId parm_op_id, |
| 406 | PswParmOperationType opType,void* dataPtr, kal_uint32* length); |
| 407 | |
| 408 | void ValDbmGetPswParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 409 | |
| 410 | |
| 411 | /***************************************************************************** |
| 412 | * CSS SET/GET PARAMETERS API * |
| 413 | *****************************************************************************/ |
| 414 | /*---------------------------------------------------------------------------- |
| 415 | FUNCTION NAME: ValDbmSetCssParameter |
| 416 | DESCRIPTION: Process a request to set a parameter maintained by CSS task. |
| 417 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 418 | ExeRspMsgT*: routing info for the response |
| 419 | PswParmOperationalId: Parameter that is being requested |
| 420 | void*: Memory allocated for PSW to retrieve contents |
| 421 | kal_uint32: length of valid data in dataPtr |
| 422 | ------------------------------------------------------------------------------*/ |
| 423 | void ValDbmSetCssParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, CssParmOperationId parm_op_id, |
| 424 | CssParmOperationType opType, void* dataPtr, kal_uint32 length); |
| 425 | /*---------------------------------------------------------------------------- |
| 426 | FUNCTION NAME: ValDbmSetCssParm |
| 427 | DESCRIPTION: Deprecated version of ValDbmSetCssParameter |
| 428 | ------------------------------------------------------------------------------*/ |
| 429 | void ValDbmSetCssParm(RegIdT RegId, CssParmOperationId parm_op_id, |
| 430 | CssParmOperationType opType,void* dataPtr, kal_uint32* length); |
| 431 | |
| 432 | void ValDbmSetCssParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 433 | |
| 434 | /*---------------------------------------------------------------------------- |
| 435 | FUNCTION NAME: ValDbmGetCssParameter |
| 436 | DESCRIPTION: Process a request to get a parameter maintained by CSS. |
| 437 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 438 | ExeRspMsgT*: routing info for the response |
| 439 | PswParmOperationalId: Parameter that is being requested |
| 440 | void*: Memory allocated for PSW to put contents |
| 441 | kal_uint32: length of data expected to be populated in dataPtr |
| 442 | ------------------------------------------------------------------------------*/ |
| 443 | void ValDbmGetCssParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, CssParmOperationId parm_op_id, |
| 444 | CssParmOperationType opType, void* dataPtr, kal_uint32 length); |
| 445 | /*---------------------------------------------------------------------------- |
| 446 | FUNCTION NAME: ValDbmGetCssParm |
| 447 | DESCRIPTION: Deprecated version of ValDbmGetCssParameter |
| 448 | ------------------------------------------------------------------------------*/ |
| 449 | void ValDbmGetCssParm(RegIdT RegId, CssParmOperationId parm_op_id, |
| 450 | CssParmOperationType opType,void* dataPtr, kal_uint32* length); |
| 451 | |
| 452 | void ValDbmGetCssParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 453 | |
| 454 | |
| 455 | /***************************************************************************** |
| 456 | * UIM SET/GET PARAMETERS API * |
| 457 | *****************************************************************************/ |
| 458 | /*---------------------------------------------------------------------------- |
| 459 | FUNCTION NAME: ValDbmSetUiccParameter |
| 460 | DESCRIPTION: Process a request to set a parameter maintained by UIM task. |
| 461 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 462 | ExeRspMsgT*: routing info for the response |
| 463 | PswParmOperationalId: Parameter that is being requested |
| 464 | void*: Memory allocated for PSW to retrieve contents |
| 465 | kal_uint32: length of valid data in dataPtr |
| 466 | ------------------------------------------------------------------------------*/ |
| 467 | void ValDbmSetUiccParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, UiccParmOperationId parm_op_id, |
| 468 | UiccParmOperationType opType,void* dataPtr, kal_uint32 length); |
| 469 | /*---------------------------------------------------------------------------- |
| 470 | FUNCTION NAME: ValDbmSetUiccParm |
| 471 | DESCRIPTION: Deprecated version of ValDbmSetUiccParameter |
| 472 | ------------------------------------------------------------------------------*/ |
| 473 | void ValDbmSetUiccParm(RegIdT RegId, UiccParmOperationId parm_op_id, |
| 474 | UiccParmOperationType opType,void* dataPtr, kal_uint32* length); |
| 475 | |
| 476 | void ValDbmSetUiccParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 477 | /*---------------------------------------------------------------------------- |
| 478 | FUNCTION NAME: ValDbmGetUiccParameter |
| 479 | DESCRIPTION: Process a request to get a parameter maintained by UIM task. |
| 480 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 481 | ExeRspMsgT*: routing info for the response |
| 482 | PswParmOperationalId: Parameter that is being requested |
| 483 | void*: Memory allocated for PSW to put contents |
| 484 | kal_uint32: length of data expected to be populated in dataPtr |
| 485 | ------------------------------------------------------------------------------*/ |
| 486 | void ValDbmGetUiccParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, UiccParmOperationId parm_op_id, |
| 487 | UiccParmOperationType opType,void* dataPtr, kal_uint32 length); |
| 488 | /*---------------------------------------------------------------------------- |
| 489 | FUNCTION NAME: ValDbmGetUiccParm |
| 490 | DESCRIPTION: Deprecated version of ValDbmGetUiccParameter() |
| 491 | ------------------------------------------------------------------------------*/ |
| 492 | void ValDbmGetUiccParm(RegIdT RegId, UiccParmOperationId parm_op_id, |
| 493 | UiccParmOperationType opType,void* dataPtr, kal_uint32* length); |
| 494 | |
| 495 | void ValDbmGetUiccParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 496 | |
| 497 | |
| 498 | /***************************************************************************** |
| 499 | * CLC SET/GET PARAMETERS API * |
| 500 | *****************************************************************************/ |
| 501 | /*---------------------------------------------------------------------------- |
| 502 | FUNCTION NAME: ValDbmSetDoParameter |
| 503 | DESCRIPTION: Process a request to set a parameter maintained by PSW. |
| 504 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 505 | ExeRspMsgT*: routing info for the response |
| 506 | PswParmOperationalId: Parameter that is being requested |
| 507 | void*: Memory allocated for PSW to retrieve contents |
| 508 | kal_uint32: length of valid data in dataPtr |
| 509 | ------------------------------------------------------------------------------*/ |
| 510 | void ValDbmSetDoParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, DoParmOperationId parm_op_id, |
| 511 | DoParmOperationType opType, void* dataPtr, kal_uint32 length); |
| 512 | /*---------------------------------------------------------------------------- |
| 513 | FUNCTION NAME: ValDbmSetDoParm |
| 514 | DESCRIPTION: Deprecated version of ValDbmSetDoParameter() |
| 515 | ------------------------------------------------------------------------------*/ |
| 516 | void ValDbmSetDoParm(RegIdT RegId, DoParmOperationId parm_op_id, void* dataPtr, kal_uint32* length); |
| 517 | |
| 518 | void ValDbmSetDoParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 519 | #ifdef MTK_CBP |
| 520 | kal_uint16 valTransformValCustomizedParaDataPackedType(kal_uint8* srcData,kal_uint8* desData); |
| 521 | void valTransformValCustomizedParaDataType(kal_uint8* srcData ,kal_uint8* desData); |
| 522 | kal_uint16 valGetCustomizedParmNumBytes(); |
| 523 | #endif |
| 524 | |
| 525 | /*---------------------------------------------------------------------------- |
| 526 | FUNCTION NAME: ValDbmGetDoParameter |
| 527 | DESCRIPTION: Process a request to get a parameter maintained by CLC task. |
| 528 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 529 | ExeRspMsgT*: routing info for the response |
| 530 | PswParmOperationalId: Parameter that is being requested |
| 531 | void*: Memory allocated for PSW to put contents |
| 532 | kal_uint32: length of data expected to be populated in dataPtr |
| 533 | ------------------------------------------------------------------------------*/ |
| 534 | void ValDbmGetDoParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, DoParmOperationId parm_op_id, |
| 535 | DoParmOperationType opType,void* dataPtr, kal_uint32 length); |
| 536 | /*---------------------------------------------------------------------------- |
| 537 | FUNCTION NAME: ValDbmGetDoParm |
| 538 | DESCRIPTION: Deprecated version of ValDbmGetDoParameter() |
| 539 | ------------------------------------------------------------------------------*/ |
| 540 | void ValDbmGetDoParm(RegIdT RegId, DoParmOperationId parm_op_id, void *paramPtr, kal_uint32 *len, void* dataPtr, kal_uint32* length); |
| 541 | |
| 542 | void ValDbmGetDoParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 543 | |
| 544 | |
| 545 | /***************************************************************************** |
| 546 | * HLP SET/GET PARAMETERS API * |
| 547 | *****************************************************************************/ |
| 548 | /*---------------------------------------------------------------------------- |
| 549 | FUNCTION NAME: ValDbmSetHlpParameter |
| 550 | DESCRIPTION: Process a request to set a parameter maintained by PSW. |
| 551 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 552 | ExeRspMsgT*: routing info for the response |
| 553 | PswParmOperationalId: Parameter that is being requested |
| 554 | void*: Memory allocated for PSW to retrieve contents |
| 555 | kal_uint32: length of valid data in dataPtr |
| 556 | ------------------------------------------------------------------------------*/ |
| 557 | void ValDbmSetHlpParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, HlpParmOperationId parm_op_id, |
| 558 | HlpParmOperationType opType, void* dataPtr, kal_uint32 length); |
| 559 | /*---------------------------------------------------------------------------- |
| 560 | FUNCTION NAME: ValSetHlpParm |
| 561 | DESCRIPTION: Deprecated version of ValDbmSetHlpParameter |
| 562 | ------------------------------------------------------------------------------*/ |
| 563 | void ValSetHlpParm(RegIdT RegId, HlpParmOperationId parm_op_id, HlpParmOperationType opType, |
| 564 | kal_uint8* dataPtr, kal_uint32* length); |
| 565 | |
| 566 | void ValDbmSetHlpParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 567 | /*---------------------------------------------------------------------------- |
| 568 | FUNCTION NAME: ValDbmGetHlpParameter |
| 569 | DESCRIPTION: Process a request to get a parameter maintained by PSW. |
| 570 | PARAMETERS: RegIdT: Identifier of registered application requesting service |
| 571 | ExeRspMsgT*: routing info for the response |
| 572 | PswParmOperationalId: Parameter that is being requested |
| 573 | void*: Memory allocated for PSW to put contents |
| 574 | kal_uint32: length of data expected to be populated in dataPtr |
| 575 | ------------------------------------------------------------------------------*/ |
| 576 | void ValDbmGetHlpParameter(RegIdT RegId, ExeRspMsgT* pRspInfo, HlpParmOperationId parm_op_id, |
| 577 | HlpParmOperationType opType, void* dataPtr, kal_uint32 length); |
| 578 | /*---------------------------------------------------------------------------- |
| 579 | FUNCTION NAME: ValGetHlpParm |
| 580 | DESCRIPTION: Deprecated version of ValDbmGetHlpParameter() |
| 581 | ------------------------------------------------------------------------------*/ |
| 582 | void ValGetHlpParm(RegIdT RegId, HlpParmOperationId parm_op_id, |
| 583 | HlpParmOperationType opType, void* dataPtr, kal_uint32* length); |
| 584 | |
| 585 | void ValDbmGetHlpParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 586 | |
| 587 | |
| 588 | /***************************************************************************** |
| 589 | *****************************************************************************/ |
| 590 | |
| 591 | void ValDbmAllDataInit(ValAllDataInitMsgT *MsgP); |
| 592 | /*=========================================================================== |
| 593 | FUNCTION: ValDbmSetUiParmMsg |
| 594 | DESCRIPTION: This function processes a message to change a NV UI parameter |
| 595 | PARAMETERS: MsgDataP, MsgSize |
| 596 | RETURN VALUE: None |
| 597 | ===========================================================================*/ |
| 598 | void ValDbmSetUiParmMsg(void *MsgDataP, kal_uint32 MsgSize ); |
| 599 | |
| 600 | /*=========================================================================== |
| 601 | FUNCTION: ValDbmGetUiParmMsg |
| 602 | DESCRIPTION: This function processes a message to change a NV UI parameter |
| 603 | PARAMETERS: MsgDataP, MsgSize |
| 604 | RETURN VALUE: None |
| 605 | ===========================================================================*/ |
| 606 | void ValDbmGetUiParmMsg(void *MsgDataP, kal_uint32 MsgSize ); |
| 607 | |
| 608 | /*=========================================================================== |
| 609 | FUNCTION: ValDbmMDNUpdated |
| 610 | DESCRIPTION: This function processes a message from PSW that the MDN has been updated |
| 611 | PARAMETERS: MsgDataP, MsgSize |
| 612 | RETURN VALUE: None |
| 613 | ===========================================================================*/ |
| 614 | void ValDbmMDNUpdated(void *MsgDataP, kal_uint32 MsgSize ); |
| 615 | |
| 616 | /*=========================================================================== |
| 617 | FUNCTION: ValDbmESNUpdated |
| 618 | DESCRIPTION: This function processes a message from PSW that the ESN has been updated |
| 619 | PARAMETERS: MsgDataP, MsgSize |
| 620 | RETURN VALUE: None |
| 621 | ===========================================================================*/ |
| 622 | void ValDbmESNUpdated(void *MsgDataP, kal_uint32 MsgSize ); |
| 623 | |
| 624 | /*========================================================================== |
| 625 | FUNCTION: ValDbmHlpSegInitRsp() |
| 626 | DESCRIPTION: This function passes HLP Set Parm results from valhspdapi |
| 627 | to valdbm. |
| 628 | PARAMETERS: ValDbmApiSetParmRspMsgT result |
| 629 | RETURN VALUE: void |
| 630 | ===========================================================================*/ |
| 631 | void ValDbmHlpSegInitRsp(ValDbmApiSetParmRspMsgT* MsgP); |
| 632 | |
| 633 | |
| 634 | /*=========================================================================== |
| 635 | |
| 636 | FUNCTION: ValDbmSetSysParmMsg |
| 637 | |
| 638 | DESCRIPTION: This function processes an ETS Message and |
| 639 | |
| 640 | PARAMETERS: MsgDataP, MsgSize |
| 641 | |
| 642 | RETURN VALUE: None |
| 643 | |
| 644 | ===========================================================================*/ |
| 645 | extern void ValDbmSetSysParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 646 | |
| 647 | /*=========================================================================== |
| 648 | |
| 649 | FUNCTION: ValDbmGetSysParmMsg |
| 650 | |
| 651 | DESCRIPTION: This function processes an ETS Message |
| 652 | |
| 653 | PARAMETERS: MsgDataP, MsgSize |
| 654 | |
| 655 | RETURN VALUE: None |
| 656 | |
| 657 | ===========================================================================*/ |
| 658 | extern void ValDbmGetSysParmMsg(void *MsgDataP, kal_uint32 MsgSize); |
| 659 | |
| 660 | /***************************************************************************** |
| 661 | FUNCTION NAME: HwdDbmSetBandClassSupportTable |
| 662 | |
| 663 | DESCRIPTION: Set Band Class |
| 664 | |
| 665 | PARAMETERS: Message Pointer |
| 666 | |
| 667 | RETURNS: SysParmAccessResultCode |
| 668 | *****************************************************************************/ |
| 669 | extern SysParmAccessResultCode HwdDbmSetBandClassSupportTable(ValDbmSysSetParmETSMsgT *MsgDataP); |
| 670 | |
| 671 | /***************************************************************************** |
| 672 | FUNCTION NAME: HwdDbmSetSubClass |
| 673 | |
| 674 | DESCRIPTION: Set Sub Class for Specified Band Class |
| 675 | |
| 676 | PARAMETERS: Message Pointer |
| 677 | |
| 678 | RETURNS: SysParmAccessResultCode |
| 679 | *****************************************************************************/ |
| 680 | extern SysParmAccessResultCode HwdDbmSetSubClass(ValDbmSysSetParmETSMsgT *MsgDataP); |
| 681 | |
| 682 | /***************************************************************************** |
| 683 | FUNCTION NAME: HwdDbmGetBandClassSupportTable |
| 684 | |
| 685 | DESCRIPTION: Get Band Class |
| 686 | |
| 687 | PARAMETERS: Message Pointer |
| 688 | |
| 689 | RETURNS: |
| 690 | *****************************************************************************/ |
| 691 | extern void HwdDbmGetBandClassSupportTable(ValDbmSysGetParmETSMsgT *MsgDataP); |
| 692 | |
| 693 | /***************************************************************************** |
| 694 | FUNCTION NAME: HwdDbmGetSubClass |
| 695 | |
| 696 | DESCRIPTION: Get Sub Class for Specified Band Class |
| 697 | |
| 698 | PARAMETERS: Message Pointer |
| 699 | |
| 700 | RETURNS: |
| 701 | *****************************************************************************/ |
| 702 | extern void HwdDbmGetSubClassSupport(ValDbmSysGetParmETSMsgT *MsgDataP); |
| 703 | |
| 704 | |
| 705 | #ifdef __cplusplus |
| 706 | } |
| 707 | #endif |
| 708 | |
| 709 | #endif /*__VAL_DBM_H__*/ |
| 710 | |
| 711 | /***************************************************************************** |
| 712 | * End of File |
| 713 | *****************************************************************************/ |
| 714 | |
| 715 | |