blob: 24a504a97af597bc735d3bf87a8528aa5dc83203 [file] [log] [blame]
yu.dongc33b3072024-08-21 23:14:49 -07001/*****************************************************************************
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... */
77typedef 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
100typedef 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 */
121typedef 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
142typedef 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 */
154typedef struct
155{
156 ExeRspMsgT rspInfo;
157 kal_uint8 OperationId;
158 kal_uint8 OperationType;
159 kal_uint8 data;
160} ValDbmApiSetParmMsgT;
161
162typedef struct
163{
164 ExeRspMsgT rspInfo;
165 kal_uint8 OperationId;
166 kal_uint8 OperationType;
167 kal_uint8 data;
168} ValDbmApiGetParmMsgT;
169
170/* From VAL */
171typedef struct
172{
173 kal_uint8 ParmId;
174 kal_uint8 result;
175} ValDbmApiSetParmRspMsgT;
176
177typedef struct
178{
179 kal_uint8 ParmId;
180 kal_uint8 result;
181 kal_uint32 length;
182 kal_uint8 data;
183} ValDbmApiGetParmRspMsgT, ValDbmEtsGetParmRspMsgT;
184
185typedef struct
186{
187 kal_uint8 ParmId;
188 kal_uint8 result;
189 kal_uint8 data;
190} ValDbmEtsGetParmNoLengthRspMsgT;
191
192typedef 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===========================================================================*/
214typedef 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
223typedef 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
232typedef 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
245typedef struct
246{
247 ExeRspMsgT rspInfo;
248 SysParmOperationId OperationId;
249 SysParmOperationType OperationType;
250 kal_uint8 data;
251} ValDbmSysSetParmETSMsgT;
252
253typedef struct
254{
255 ExeRspMsgT rspInfo;
256 SysParmOperationId OperationId;
257 SysParmOperationType OperationType;
258 kal_uint8 *data;
259} ValDbmSysGetParmETSMsgT;
260
261typedef struct
262{
263 SysParmAccessResultCode result;
264} ValDbmSysSetBandClassParmRspMsgT;
265
266typedef struct
267{
268 kal_uint8 BandClass;
269 kal_uint8 Supported;
270} SysSetBandClassParmT;
271
272typedef struct
273{
274 SysParmAccessResultCode result;
275} ValDbmSysSetSubClassParmRspMsgT;
276
277typedef struct
278{
279 kal_uint8 BandClass;
280 kal_uint8 SubClass;
281 kal_uint8 Status;
282} SysSetSubClassParmT;
283
284typedef struct
285{
286 kal_uint8 BandClass;
287} ValDbmSysGetBandClassParmT;
288
289typedef struct
290{
291 kal_uint8 BandClass;
292 kal_uint8 Supported;
293} ValBandClassRecordT;
294
295typedef struct
296{
297 kal_uint8 NumberRecords;
298 ValBandClassRecordT Record[1];
299} ValDbmSysGetBandClassParmRspMsgT;
300
301typedef struct
302{
303 kal_uint8 BandClass;
304} ValDbmSysGetSubClassParmT;
305
306
307#ifdef __cplusplus
308extern "C" {
309#endif /* __cplusplus */
310
311/*===========================================================================
312
313FUNCTION ValDbmInit()
314
315DESCRIPTION Initialize the Dbm Val Module
316
317PARAMETERS None
318
319RETURN VALUE None
320
321===========================================================================*/
322void ValDbmInit( void );
323
324/*===========================================================================
325
326FUNCTION: ValDbmProcessEvent
327
328DESCRIPTION: This function processes the event received and calls the
329 registered call back.
330
331PARAMETERS: ValLbsEventIdT EventId, void *EventMsgP
332
333RETURN VALUE: None
334
335===========================================================================*/
336void ValDbmProcessEvent( ValDbmEventIdT EventId, void* EventMsgP );
337
338/***************************************************************************
339
340FUNCTION ValDbmRegister
341
342DESCRIPTION This function registers a callback for all Dbm related events.
343
344PARAMETERS Callback - The callback function to be called for the notification of LBS
345 services events.
346
347RETURN VALUE The assigned registration ID of the subscriber.
348
349*****************************************************************************/
350RegIdT ValDbmRegister( ValEventFunc Callback );
351
352/***************************************************************************
353
354FUNCTION ValDbmUnregister
355
356DESCRIPTION This function unregisters the given client so that it won't receive additional
357 Dbm services related events.
358
359PARAMETERS RegId - The assigned registration ID of the subscriber.
360
361RETURN VALUE None
362
363*****************************************************************************/
364void 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------------------------------------------------------------------------------*/
379void 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------------------------------------------------------------------------------*/
385void ValDbmSetPswParm(RegIdT RegId, PswParmOperationId parm_op_id,
386 PswParmOperationType opType,void* dataPtr, kal_uint32* length);
387
388void 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------------------------------------------------------------------------------*/
399void 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------------------------------------------------------------------------------*/
405void ValDbmGetPswParm(RegIdT RegId, PswParmOperationId parm_op_id,
406 PswParmOperationType opType,void* dataPtr, kal_uint32* length);
407
408void 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------------------------------------------------------------------------------*/
423void 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------------------------------------------------------------------------------*/
429void ValDbmSetCssParm(RegIdT RegId, CssParmOperationId parm_op_id,
430 CssParmOperationType opType,void* dataPtr, kal_uint32* length);
431
432void 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------------------------------------------------------------------------------*/
443void 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------------------------------------------------------------------------------*/
449void ValDbmGetCssParm(RegIdT RegId, CssParmOperationId parm_op_id,
450 CssParmOperationType opType,void* dataPtr, kal_uint32* length);
451
452void 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------------------------------------------------------------------------------*/
467void 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------------------------------------------------------------------------------*/
473void ValDbmSetUiccParm(RegIdT RegId, UiccParmOperationId parm_op_id,
474 UiccParmOperationType opType,void* dataPtr, kal_uint32* length);
475
476void 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------------------------------------------------------------------------------*/
486void 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------------------------------------------------------------------------------*/
492void ValDbmGetUiccParm(RegIdT RegId, UiccParmOperationId parm_op_id,
493 UiccParmOperationType opType,void* dataPtr, kal_uint32* length);
494
495void 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------------------------------------------------------------------------------*/
510void 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------------------------------------------------------------------------------*/
516void ValDbmSetDoParm(RegIdT RegId, DoParmOperationId parm_op_id, void* dataPtr, kal_uint32* length);
517
518void ValDbmSetDoParmMsg(void *MsgDataP, kal_uint32 MsgSize);
519#ifdef MTK_CBP
520kal_uint16 valTransformValCustomizedParaDataPackedType(kal_uint8* srcData,kal_uint8* desData);
521void valTransformValCustomizedParaDataType(kal_uint8* srcData ,kal_uint8* desData);
522kal_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------------------------------------------------------------------------------*/
534void 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------------------------------------------------------------------------------*/
540void ValDbmGetDoParm(RegIdT RegId, DoParmOperationId parm_op_id, void *paramPtr, kal_uint32 *len, void* dataPtr, kal_uint32* length);
541
542void 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------------------------------------------------------------------------------*/
557void 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------------------------------------------------------------------------------*/
563void ValSetHlpParm(RegIdT RegId, HlpParmOperationId parm_op_id, HlpParmOperationType opType,
564 kal_uint8* dataPtr, kal_uint32* length);
565
566void 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------------------------------------------------------------------------------*/
576void 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------------------------------------------------------------------------------*/
582void ValGetHlpParm(RegIdT RegId, HlpParmOperationId parm_op_id,
583 HlpParmOperationType opType, void* dataPtr, kal_uint32* length);
584
585void ValDbmGetHlpParmMsg(void *MsgDataP, kal_uint32 MsgSize);
586
587
588/*****************************************************************************
589 *****************************************************************************/
590
591void ValDbmAllDataInit(ValAllDataInitMsgT *MsgP);
592/*===========================================================================
593FUNCTION: ValDbmSetUiParmMsg
594DESCRIPTION: This function processes a message to change a NV UI parameter
595PARAMETERS: MsgDataP, MsgSize
596RETURN VALUE: None
597===========================================================================*/
598void ValDbmSetUiParmMsg(void *MsgDataP, kal_uint32 MsgSize );
599
600/*===========================================================================
601FUNCTION: ValDbmGetUiParmMsg
602DESCRIPTION: This function processes a message to change a NV UI parameter
603PARAMETERS: MsgDataP, MsgSize
604RETURN VALUE: None
605===========================================================================*/
606void ValDbmGetUiParmMsg(void *MsgDataP, kal_uint32 MsgSize );
607
608/*===========================================================================
609FUNCTION: ValDbmMDNUpdated
610DESCRIPTION: This function processes a message from PSW that the MDN has been updated
611PARAMETERS: MsgDataP, MsgSize
612RETURN VALUE: None
613===========================================================================*/
614void ValDbmMDNUpdated(void *MsgDataP, kal_uint32 MsgSize );
615
616/*===========================================================================
617FUNCTION: ValDbmESNUpdated
618DESCRIPTION: This function processes a message from PSW that the ESN has been updated
619PARAMETERS: MsgDataP, MsgSize
620RETURN VALUE: None
621===========================================================================*/
622void ValDbmESNUpdated(void *MsgDataP, kal_uint32 MsgSize );
623
624/*==========================================================================
625FUNCTION: ValDbmHlpSegInitRsp()
626DESCRIPTION: This function passes HLP Set Parm results from valhspdapi
627 to valdbm.
628PARAMETERS: ValDbmApiSetParmRspMsgT result
629RETURN VALUE: void
630===========================================================================*/
631void ValDbmHlpSegInitRsp(ValDbmApiSetParmRspMsgT* MsgP);
632
633
634/*===========================================================================
635
636FUNCTION: ValDbmSetSysParmMsg
637
638DESCRIPTION: This function processes an ETS Message and
639
640PARAMETERS: MsgDataP, MsgSize
641
642RETURN VALUE: None
643
644===========================================================================*/
645extern void ValDbmSetSysParmMsg(void *MsgDataP, kal_uint32 MsgSize);
646
647/*===========================================================================
648
649FUNCTION: ValDbmGetSysParmMsg
650
651DESCRIPTION: This function processes an ETS Message
652
653PARAMETERS: MsgDataP, MsgSize
654
655RETURN VALUE: None
656
657===========================================================================*/
658extern 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*****************************************************************************/
669extern 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*****************************************************************************/
680extern 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*****************************************************************************/
691extern 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*****************************************************************************/
702extern 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