Setting - DCD msg.

This topic describes the following functions:

E6651_Get/Set BSHODCDTrigger

Declaration

int E6651_GetBSHODCDTrigger(BYTE MID, BYTE* Value);

int E6651_SetBSHODCDTrigger(BYTE MID, BYTE Value);

Parameter

MID [in]: User defined E6651A Machine ID

Value [out]: Currently selected DCD Trigger

Value [in]: Set the DCD Trigger

Range

0 - DCD Trigger #1
1 - DCD Trigger #2

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Retrieve and set the DCD Trigger that will be selected for call to the BS handover DCD trigger functions.

E6651_Get/Set BSHODCDTrigType

Declaration

int E6651_GetBSHODCDTrigType(BYTE MID, int* Value);

int E6651_SetBSHODCDTrigType(BYTE MID, int Value);

Parameter

MID [in]: User defined E6651A Machine ID

Value [out]: Current trigger type in the Downlink Channel Description (DCD) message.

Value [in]: Set the trigger type in the DCD message.

0 - CINR Metric
1 - RSSI Metric
2 - RTD Metric

Default

0, CINR Metric

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Retrieve and set the trigger type for the Downlink Channel Description (DCD) message.

E6651_Get/Set BSHODCDTrigFunc

Declaration

int E6651_GetBSHODCDTrigFunc(BYTE MID, int* Value);

int E6651_SetBSHODCDTrigFunc(BYTE MID, int Value);

Parameter

MID [in]: User defined E6651A Machine ID

Value [out]: Current trigger function in the Downlink Channel Description (DCD) message.

Value [in]: Set the trigger function in the DCD message.

0 - Serving less than  'Value'
1 - Neighbor greater than 'Value'
2 - Neighbor less than 'Value'
3 - Neighbor greater than Serving and 'Value'
4 - Neighbor less than Serving and 'Value'
5 - Serving greater than 'Value'

Default

0, Serving less than Value

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Retrieve and set the trigger function in the Downlink Channel Description (DCD) message. the 'value' is specified by Get_Set_BSHODCDTrigValue.

E6651_Get/Set BSHODCDTrigAction

Declaration

int E6651_GetBSHODCDTrigAction(BYTE MID, int* Value);

int E6651_SetBSHODCDTrigAction(BYTE MID, int Value);

Parameter

MID [in]: User defined E6651A Machine ID

Value [out]: Current the current trigger action.

Value [in]: Set the action to be performed when the trigger condition is met.

0 - Initial Scanning
1 - Perform Scanning
2 - Send MOB_SCN-REP
3 - Send MOB_MSHO-REQ

Default

0, Initial Scanning

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Retrieve and set the action to be performed when the trigger condition defined by Get/Set BSHODCDTrigAction has been reached.

E6651_Get/Set BSHODCDTrigValue

Declaration

int E6651_GetBSHODCDTrigValue(BYTE MID, int* Value);

int E6651_SetBSHODCDTrigValue(BYTE MID, int Value);

Parameter

MID [in]: User defined E6651A Machine ID

Value [out]: Current value to be used by the Get_Set_BSHODCDTrigFunc command.

Value [in]: Set the value to be used by the Get_Set_BSHODCDTrigFunc command.

0 to 255

Default

25

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Retrieve and set the trigger value for the trigger function command.

E6651_Get/Set BSHODCDTrigAverDuration

Declaration

int E6651_GetBSHODCDTrigAverDuration(BYTE MID, int* Value);

int E6651_SetBSHODCDTrigAverDuration(BYTE MID, int Value);

Parameter

MID [in]: User defined E6651A Machine ID

Value [out]: Current setting of the averaging duration.

Value [in]: Set the averaging required for the handover trigger.

0 to 255

Default

128

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Retrieve and set the averaging applied to the handover trigger.

E6651_BSHODCDMessageApply

Declaration

int E6651_BSHODCDMessageApply(BYTE MID);

Parameter

MID [in]: User defined E6651A Machine ID

Return Value

Success: STATE_SUCCESS(1)

Failure: STATE_ERROR(-1)

Description

Sent the configured DCD message to the MS.