RDK-B
MTA HAL APIs

Description

Data Structures

struct  _MTAMGMT_PROVISIONING_PARAMS
 

Macros

#define MTA_DHCPOPTION122SUBOPTION1_MAX   4
 
#define MTA_DHCPOPTION122SUBOPTION2_MAX   4
 
#define MTA_DHCPOPTION122CCCV6DSSID1_MAX   32
 
#define MTA_DHCPOPTION122CCCV6DSSID2_MAX   32
 

Typedefs

typedef struct _MTAMGMT_PROVISIONING_PARAMS MTAMGMT_PROVISIONING_PARAMS
 
typedef struct _MTAMGMT_PROVISIONING_PARAMSPMTAMGMT_MTA_PROVISIONING_PARAMS
 
typedef int(* mta_hal_getLineRegisterStatus_callback) (MTAMGMT_MTA_STATUS *output_status_array, int array_size)
 

Enumerations

enum  MTAMGMT_MTA_PROV_IP_MODE { MTA_IPV4 =0, MTA_IPV6 =1, MTA_DUAL_STACK =2 }
 

Functions

int mta_hal_InitDB (void)
 
int mta_hal_GetDHCPInfo (PMTAMGMT_MTA_DHCP_INFO pInfo)
 
int mta_hal_GetDHCPV6Info (PMTAMGMT_MTA_DHCPv6_INFO pInfo)
 
unsigned long mta_hal_LineTableGetNumberOfEntries (void)
 
int mta_hal_LineTableGetEntry (unsigned long Index, PMTAMGMT_MTA_LINETABLE_INFO pEntry)
 
int mta_hal_TriggerDiagnostics (unsigned long Index)
 
int mta_hal_GetServiceFlow (unsigned long *Count, PMTAMGMT_MTA_SERVICE_FLOW *ppCfg)
 
int mta_hal_DectGetEnable (unsigned char *pBool)
 
int mta_hal_DectSetEnable (unsigned char bBool)
 
int mta_hal_DectGetRegistrationMode (unsigned char *pBool)
 
int mta_hal_DectSetRegistrationMode (unsigned char bBool)
 
int mta_hal_DectDeregisterDectHandset (unsigned long uValue)
 
int mta_hal_GetDect (PMTAMGMT_MTA_DECT pDect)
 
int mta_hal_GetDectPIN (char *pPINString)
 
int mta_hal_SetDectPIN (char *pPINString)
 
int mta_hal_GetHandsets (unsigned long *pulCount, PMTAMGMT_MTA_HANDSETS_INFO *ppHandsets)
 
int mta_hal_GetCalls (unsigned long InstanceNumber, unsigned long *Count, PMTAMGMT_MTA_CALLS *ppCfg)
 
int mta_hal_GetCALLP (unsigned long LineNumber, PMTAMGMT_MTA_CALLP pCallp)
 
int mta_hal_GetDSXLogs (unsigned long *Count, PMTAMGMT_MTA_DSXLOG *ppDSXLog)
 
int mta_hal_GetDSXLogEnable (unsigned char *pBool)
 
int mta_hal_SetDSXLogEnable (unsigned char Bool)
 
int mta_hal_ClearDSXLog (unsigned char Bool)
 
int mta_hal_GetCallSignallingLogEnable (unsigned char *pBool)
 
int mta_hal_SetCallSignallingLogEnable (unsigned char Bool)
 
int mta_hal_ClearCallSignallingLog (unsigned char Bool)
 
int mta_hal_GetMtaLog (unsigned long *Count, PMTAMGMT_MTA_MTALOG_FULL *ppCfg)
 
int mta_hal_BatteryGetInstalled (unsigned char *Val)
 
int mta_hal_BatteryGetTotalCapacity (unsigned long *Val)
 
int mta_hal_BatteryGetActualCapacity (unsigned long *Val)
 
int mta_hal_BatteryGetRemainingCharge (unsigned long *Val)
 
int mta_hal_BatteryGetRemainingTime (unsigned long *Val)
 
int mta_hal_BatteryGetNumberofCycles (unsigned long *Val)
 
int mta_hal_BatteryGetPowerStatus (char *Val, unsigned long *len)
 
int mta_hal_BatteryGetCondition (char *Val, unsigned long *len)
 
int mta_hal_BatteryGetStatus (char *Val, unsigned long *len)
 
int mta_hal_BatteryGetLife (char *Val, unsigned long *len)
 
int mta_hal_BatteryGetInfo (PMTAMGMT_MTA_BATTERY_INFO pInfo)
 
int mta_hal_BatteryGetPowerSavingModeStatus (unsigned long *pValue)
 
int mta_hal_Get_MTAResetCount (unsigned long *resetcnt)
 
int mta_hal_Get_LineResetCount (unsigned long *resetcnt)
 
int mta_hal_ClearCalls (unsigned long InstanceNumber)
 
int mta_hal_getDhcpStatus (MTAMGMT_MTA_STATUS *output_pIpv4status, MTAMGMT_MTA_STATUS *output_pIpv6status)
 
int mta_hal_getConfigFileStatus (MTAMGMT_MTA_STATUS *poutput_status)
 
int mta_hal_getLineRegisterStatus (MTAMGMT_MTA_STATUS *output_status_array, int array_size)
 
int mta_hal_devResetNow (unsigned char bResetValue)
 
int mta_hal_getMtaOperationalStatus (MTAMGMT_MTA_STATUS *operationalStatus)
 
int mta_hal_getMtaProvisioningStatus (MTAMGMT_MTA_PROVISION_STATUS *provisionStatus)
 
int mta_hal_start_provisioning (PMTAMGMT_MTA_PROVISIONING_PARAMS pParameters)
 
void mta_hal_LineRegisterStatus_callback_register (mta_hal_getLineRegisterStatus_callback callback_proc)
 

Data Structure Documentation

◆ _MTAMGMT_PROVISIONING_PARAMS

struct _MTAMGMT_PROVISIONING_PARAMS

Definition at line 1333 of file mta_hal.h.

Collaboration diagram for _MTAMGMT_PROVISIONING_PARAMS:
Collaboration graph

Data Fields

int MtaIPMode
 
int DhcpOption2171CccV6DssID1Len
 
int DhcpOption2171CccV6DssID2Len
 
char DhcpOption122Suboption1 [4+1]
 
char DhcpOption122Suboption2 [4+1]
 
char DhcpOption2171CccV6DssID1 [32+1]
 
char DhcpOption2171CccV6DssID2 [32+1]
 

Field Documentation

◆ MtaIPMode

int _MTAMGMT_PROVISIONING_PARAMS::MtaIPMode

Definition at line 1336 of file mta_hal.h.

◆ DhcpOption2171CccV6DssID1Len

int _MTAMGMT_PROVISIONING_PARAMS::DhcpOption2171CccV6DssID1Len

Definition at line 1337 of file mta_hal.h.

◆ DhcpOption2171CccV6DssID2Len

int _MTAMGMT_PROVISIONING_PARAMS::DhcpOption2171CccV6DssID2Len

Definition at line 1338 of file mta_hal.h.

◆ DhcpOption122Suboption1

char _MTAMGMT_PROVISIONING_PARAMS::DhcpOption122Suboption1[4+1]

Definition at line 1339 of file mta_hal.h.

◆ DhcpOption122Suboption2

char _MTAMGMT_PROVISIONING_PARAMS::DhcpOption122Suboption2[4+1]

Definition at line 1340 of file mta_hal.h.

◆ DhcpOption2171CccV6DssID1

char _MTAMGMT_PROVISIONING_PARAMS::DhcpOption2171CccV6DssID1[32+1]

Definition at line 1341 of file mta_hal.h.

◆ DhcpOption2171CccV6DssID2

char _MTAMGMT_PROVISIONING_PARAMS::DhcpOption2171CccV6DssID2[32+1]

Definition at line 1342 of file mta_hal.h.

Macro Definition Documentation

◆ MTA_DHCPOPTION122SUBOPTION1_MAX

#define MTA_DHCPOPTION122SUBOPTION1_MAX   4

Definition at line 1320 of file mta_hal.h.

◆ MTA_DHCPOPTION122SUBOPTION2_MAX

#define MTA_DHCPOPTION122SUBOPTION2_MAX   4

Definition at line 1321 of file mta_hal.h.

◆ MTA_DHCPOPTION122CCCV6DSSID1_MAX

#define MTA_DHCPOPTION122CCCV6DSSID1_MAX   32

Definition at line 1322 of file mta_hal.h.

◆ MTA_DHCPOPTION122CCCV6DSSID2_MAX

#define MTA_DHCPOPTION122CCCV6DSSID2_MAX   32

Definition at line 1323 of file mta_hal.h.

Typedef Documentation

◆ MTAMGMT_PROVISIONING_PARAMS

◆ PMTAMGMT_MTA_PROVISIONING_PARAMS

◆ mta_hal_getLineRegisterStatus_callback

typedef int( * mta_hal_getLineRegisterStatus_callback) (MTAMGMT_MTA_STATUS *output_status_array, int array_size)

@description This call back will be invoked to returing MTA line

Parameters
MTAMGMT_MTA_STATUS*output_status_array - return array buffer for all line register status
intarray_size - buffer size (total line number)
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Asynchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

Definition at line 1382 of file mta_hal.h.

Enumeration Type Documentation

◆ MTAMGMT_MTA_PROV_IP_MODE

Enumerator
MTA_IPV4 
MTA_IPV6 
MTA_DUAL_STACK 

Definition at line 1326 of file mta_hal.h.

Function Documentation

◆ mta_hal_InitDB()

int mta_hal_InitDB ( void  )

@description Retrieves the global information for all shared DBs and makes them accessible locally.

Parameters
None
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetDHCPInfo()

int mta_hal_GetDHCPInfo ( PMTAMGMT_MTA_DHCP_INFO  pInfo)

@description Retrieve all the relevant DHCP info for MTA.

Parameters
PMTAMGMT_MTA_DHCP_INFOpInfo - all DHCP info for MTA, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetDHCPV6Info()

int mta_hal_GetDHCPV6Info ( PMTAMGMT_MTA_DHCPv6_INFO  pInfo)

◆ mta_hal_LineTableGetNumberOfEntries()

unsigned long mta_hal_LineTableGetNumberOfEntries ( void  )

@description Get number of entries in the line table.

Parameters
None
Returns
ULONG - number of entries
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_LineTableGetEntry()

int mta_hal_LineTableGetEntry ( unsigned long  Index,
PMTAMGMT_MTA_LINETABLE_INFO  pEntry 
)

@description Get entry of the line table at the given index

Parameters
INTIndex - index to the table entry
PMTAMGMT_MTA_LINETABLE_INFOpEntry - entry info, to be returned
Returns
The status of the operation
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_TriggerDiagnostics()

int mta_hal_TriggerDiagnostics ( unsigned long  Index)

@description Trigger GR909 Diagnostics

Parameters
INTIndex - line number to perform the GR909 diagnostics on
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetServiceFlow()

int mta_hal_GetServiceFlow ( unsigned long *  Count,
PMTAMGMT_MTA_SERVICE_FLOW ppCfg 
)

@description Get all the service flow info

Parameters
ULONG*Count - number of service flow entries, to be returned
PMTAMGMT_MTA_SERVICE_FLOW*ppCfg - service flow info, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_DectGetEnable()

int mta_hal_DectGetEnable ( unsigned char *  pBool)

@description Get info on if Dect is enabled

Parameters
BOOLEAN*pBool - boolean value for enabled or not, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_DectSetEnable()

int mta_hal_DectSetEnable ( unsigned char  bBool)

@description Set Dect to boolean value passed in

Parameters
BOOLEAN*bBool - boolean value for enabled or not, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_DectGetRegistrationMode()

int mta_hal_DectGetRegistrationMode ( unsigned char *  pBool)

@description Set Dect to boolean value passed in

Parameters
BOOLEAN*bBool - boolean value for enabled or not, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_DectSetRegistrationMode()

int mta_hal_DectSetRegistrationMode ( unsigned char  bBool)

@description Set Dect registration mode

Parameters
BOOLEAN*bBool - boolean value for enabled or not, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_DectDeregisterDectHandset()

int mta_hal_DectDeregisterDectHandset ( unsigned long  uValue)

@description Deregister Dect Handset

Parameters
ULONG*uValue - unsigned long value for
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetDect()

int mta_hal_GetDect ( PMTAMGMT_MTA_DECT  pDect)

@description Get Dect info

Parameters
PMTAMGMT_MTA_DECT*pDect - info of Dect
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetDectPIN()

int mta_hal_GetDectPIN ( char *  pPINString)

@description get Decr PIN

Parameters
char*pPINString - PIN value
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_SetDectPIN()

int mta_hal_SetDectPIN ( char *  pPINString)

@description Set Dect PIN

Parameters
char*pPINString - PIN value
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetHandsets()

int mta_hal_GetHandsets ( unsigned long *  pulCount,
PMTAMGMT_MTA_HANDSETS_INFO ppHandsets 
)

@description Get MTA handset info

Parameters
ULONG*pulCount - handset number
PMTAMGMT_MTA_HANDSETS_INFO*ppHandsets - Info of MTA handset
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetCalls()

int mta_hal_GetCalls ( unsigned long  InstanceNumber,
unsigned long *  Count,
PMTAMGMT_MTA_CALLS ppCfg 
)

@description Retrieve all call info for the given instance number of LineTable

Parameters
ULONGInstanceNumber - LineTable's instance number
ULONG*Count - number of entries(calls) for the call info array, to be returned
PMTAMGMT_MTA_CALLS*ppCfg - Array of call info, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetCALLP()

int mta_hal_GetCALLP ( unsigned long  LineNumber,
PMTAMGMT_MTA_CALLP  pCallp 
)

@description Retrieve the CALLP status info for the line number

Parameters
ULONGLineNumber - Line number for which to retrieve info on
PMTAMGMT_MTA_CALLPpCallp - CallP info, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetDSXLogs()

int mta_hal_GetDSXLogs ( unsigned long *  Count,
PMTAMGMT_MTA_DSXLOG ppDSXLog 
)

@description Retrieve all DSX log entries

Parameters
ULONG*Count - number of entries in the log, to be returned
PMTAMGMT_MTA_DSXLOG*ppDSXLog - array of log entries, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetDSXLogEnable()

int mta_hal_GetDSXLogEnable ( unsigned char *  pBool)

@description Get the value of if DSX log is enabled

Parameters
BOOLEAN* pBool - boolean value of enable, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_SetDSXLogEnable()

int mta_hal_SetDSXLogEnable ( unsigned char  Bool)

@description Set value of DSX enable to the value

Parameters
BOOLEANBool - value to set DSX log enable to
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_ClearDSXLog()

int mta_hal_ClearDSXLog ( unsigned char  Bool)

@description Set value of ClearDSXLog to the value

Parameters
BOOLEANBool - value to set to clear DSX log.
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetCallSignallingLogEnable()

int mta_hal_GetCallSignallingLogEnable ( unsigned char *  pBool)

@description Get the value of if CallSignalling log is enabled

Parameters
BOOLEAN* pBool - boolean value of enable, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_SetCallSignallingLogEnable()

int mta_hal_SetCallSignallingLogEnable ( unsigned char  Bool)

@description Set value of CallSignalling enable to the value

Parameters
BOOLEANBool - value to set CallSignalling log enable to
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_ClearCallSignallingLog()

int mta_hal_ClearCallSignallingLog ( unsigned char  Bool)

@description Set value of CallSignalling enable to the value

Parameters
BOOLEANBool - value to set to clear CallSignalling log.
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_GetMtaLog()

int mta_hal_GetMtaLog ( unsigned long *  Count,
PMTAMGMT_MTA_MTALOG_FULL ppCfg 
)

@description Get all log entries from the MTA Log

Parameters
ULONG*Count - number of entries in the log, to be returned
PMTAMGMT_MTA_MTALOG_FULL*ppCfg - array of log entries, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetInstalled()

int mta_hal_BatteryGetInstalled ( unsigned char *  Val)

@description Check to see if the battery is installed

Parameters
BOOLEAN*Val - TRUE/FALSE, value to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetTotalCapacity()

int mta_hal_BatteryGetTotalCapacity ( unsigned long *  Val)

@description Get the total capacity of the battery

Parameters
INT*Val - capacity in mAVHour, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetActualCapacity()

int mta_hal_BatteryGetActualCapacity ( unsigned long *  Val)

@description Retrieve the actual capacity of the battery

Parameters
INT*Val - capacity in mAVHour, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetRemainingCharge()

int mta_hal_BatteryGetRemainingCharge ( unsigned long *  Val)

@description Retrieve the current charge remain in the battery

Parameters
INT*Val - capacity in mAVHour, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetRemainingTime()

int mta_hal_BatteryGetRemainingTime ( unsigned long *  Val)

@description Get estimated battery remaining time if current usage continues

Parameters
INT*Val - Remaining time in minutes, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetNumberofCycles()

int mta_hal_BatteryGetNumberofCycles ( unsigned long *  Val)

@description Get max number of cycles the battery can be charge cycled

Parameters
INT*Val - Max number of cycles, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetPowerStatus()

int mta_hal_BatteryGetPowerStatus ( char *  Val,
unsigned long *  len 
)

@description Get power status of MTA

Parameters
CHAR*Val - Status of "AC", "Battery", or "Unknown", to be returned
ULONG*len - string length, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetCondition()

int mta_hal_BatteryGetCondition ( char *  Val,
unsigned long *  len 
)

@description Get the battery condition

Parameters
CHAR*Val - Status of "Good" or "Bad", to be returned
ULONG*len - string length, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetStatus()

int mta_hal_BatteryGetStatus ( char *  Val,
unsigned long *  len 
)

@description Get the battery status

Parameters
CHAR*Val - Status of "Missing", "Idle", "Charging", "Discharging", or "Unknown", to be returned
ULONG*len - string length, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetLife()

int mta_hal_BatteryGetLife ( char *  Val,
unsigned long *  len 
)

@description Get the battery life status

Parameters
CHAR*Val - Values of "Need Replacement", or "Good", to be returned
ULONG*len - string length, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetInfo()

int mta_hal_BatteryGetInfo ( PMTAMGMT_MTA_BATTERY_INFO  pInfo)

@description Get the battery info

Parameters
PMTAMGMT_MTA_BATTERY_INFOpInfo - battery info, to be returned
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_BatteryGetPowerSavingModeStatus()

int mta_hal_BatteryGetPowerSavingModeStatus ( unsigned long *  pValue)

@description Get the battery Power Saving Mode Status

Parameters
ULONG*pValue- Values of 1 for Enabled, 2 for Disabled
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_Get_MTAResetCount()

int mta_hal_Get_MTAResetCount ( unsigned long *  resetcnt)

@description Get the reset count of MTA

Parameters
ULONG*pValue- count
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_Get_LineResetCount()

int mta_hal_Get_LineResetCount ( unsigned long *  resetcnt)

@description Get the reset count of MTA Lines

Parameters
ULONG*pValue- count
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_ClearCalls()

int mta_hal_ClearCalls ( unsigned long  InstanceNumber)

@description clear the VQM stats per line

Parameters
ULONGInstanceNumber - instance number
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_getDhcpStatus()

int mta_hal_getDhcpStatus ( MTAMGMT_MTA_STATUS output_pIpv4status,
MTAMGMT_MTA_STATUS output_pIpv6status 
)

@description Get the DHCP status for MTA

Parameters
MTAMGMT_MTA_STATUS*output_pIpv4status - ipv4 dhcp status
MTAMGMT_MTA_STATUS*output_pIpv6status - ipv6 dhcp status
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_getConfigFileStatus()

int mta_hal_getConfigFileStatus ( MTAMGMT_MTA_STATUS poutput_status)

@description Get the MTA config file status

Parameters
MTAMGMT_MTA_STATUS*poutput_status - config file status
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_getLineRegisterStatus()

int mta_hal_getLineRegisterStatus ( MTAMGMT_MTA_STATUS output_status_array,
int  array_size 
)

@description Get the register status for all lines

Parameters
MTAMGMT_MTA_STATUS*output_status_array - return array buffer for all line register status
intarray_size - buffer size (total line number)
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_devResetNow()

int mta_hal_devResetNow ( unsigned char  bResetValue)

@description Set boolean value passed to reset MTA device

Parameters
BOOLEANbResetValue - boolean value to reset the device
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_getMtaOperationalStatus()

int mta_hal_getMtaOperationalStatus ( MTAMGMT_MTA_STATUS operationalStatus)

@description Get the operational status of MTA

Parameters
MTAMGMT_MTA_STATUS*operationalStatus - return buffer for operational status
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_getMtaProvisioningStatus()

int mta_hal_getMtaProvisioningStatus ( MTAMGMT_MTA_PROVISION_STATUS provisionStatus)

@description Get the provisional status of MTA

Parameters
MTAMGMT_MTA_PROVISION_STATUS*provisionStatus - return buffer for provision status
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_start_provisioning()

int mta_hal_start_provisioning ( PMTAMGMT_MTA_PROVISIONING_PARAMS  pParameters)

@description This API call will start IP provisioning for all the lines for IPv4/IPv6 , or dual mode

Parameters
PMTAMGMT_MTA_PROVISIONINGpParameters - IP provisioning for all line register status
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.

◆ mta_hal_LineRegisterStatus_callback_register()

void mta_hal_LineRegisterStatus_callback_register ( mta_hal_getLineRegisterStatus_callback  callback_proc)

@description This call back will be invoked to returing MTA line

Parameters
mta_hal_getLineRegisterStatus_callbackcallback_proc - Callback registration function.
Returns
The status of the operation.
Return values
RETURN_OKif successful.
RETURN_ERRif any error is detected
Execution:\n Synchronous.
Side Effects:\n None.
Note
This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task.