beautypg.com

2 events and status service, Events and status service, M1966_rng_get – Maxim Integrated 73M1866B/73M1966B Reference Driver User Manual

Page 39: Table 2: fxo line status services

background image

UG_1x66B_015

73M1866B/73M1966B Reference Driver User Guide

Rev. 2.7

39

6.2 Events and Status Service

The driver can be queried for a variety of current status of the FXO line via IOCTLs. Table 2 summarizes
these services.

Table 2: FXO Line Status Services

Events and Status

Description

Descriptor

M1966_RNG_GET

FXO line ring status commands.

Channel

M1966_POL_GET

FXO line polarity status commands.

Channel

M1966_BAT_GET

FXO line battery status command.

Channel

M1966_POH_GET

FXO line POH status command.

Channel

M1966_EVENT_GET

Event retrieval command.

Device

M1966_ERROR_CODE_GET Retrieve last error code command.

Device/Channel

6.2.1 M1966_RNG_GET

Description

Gets the current ring status of the FXO line. The current ring status is maintained in the driver internal
variable. This variable is being retrieved by use application using this command.

#define M1966_RNG_GET _IOWR(0xA4,0xB8,unsigned int)

Prototype

int ioctl (

int chan_fd,

int M1966_RNG_GET,

unsigned long param );


Parameters

Data Type

Name

Description

int

chan_fd

Channel descriptor.

int

M1966_RNG_GET

I/O control identifier for this operation.

unsigned long

param

N/A.


Return Values

Data Type

Description

int

The return value can be either of the following:
0 – No ring signal occurred on the FXO line.
1 – The FXO line is ringing, signaling of incoming call.