8f5f051b92
Signed-off-by: Shaun Ruffell <sruffell@digium.com> git-svn-id: http://svn.asterisk.org/svn/dahdi/linux/trunk@9928 a0bf4364-ded3-4de4-8d8a-66a801d63aff
1458 lines
46 KiB
C
1458 lines
46 KiB
C
/*
|
|
* DAHDI Telephony Interface
|
|
*
|
|
* Written by Mark Spencer <markster@digium.com>
|
|
* Based on previous works, designs, and architectures conceived and
|
|
* written by Jim Dixon <jim@lambdatel.com>.
|
|
*
|
|
* Copyright (C) 2001 Jim Dixon / Zapata Telephony.
|
|
* Copyright (C) 2001 - 2010 Digium, Inc.
|
|
*
|
|
* All rights reserved.
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2 as published by the
|
|
* Free Software Foundation. See the LICENSE file included with
|
|
* this program for more details.
|
|
*/
|
|
|
|
/*!
|
|
* \file
|
|
* \brief DAHDI kernel interface definitions
|
|
*/
|
|
|
|
#ifndef _DAHDI_KERNEL_H
|
|
#define _DAHDI_KERNEL_H
|
|
|
|
#include <dahdi/user.h>
|
|
#include <dahdi/fasthdlc.h>
|
|
|
|
#include <dahdi/dahdi_config.h>
|
|
#include <linux/version.h>
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2,6,18)
|
|
#include <linux/config.h>
|
|
#endif
|
|
#include <linux/fs.h>
|
|
#include <linux/kobject.h>
|
|
#include <linux/ioctl.h>
|
|
|
|
#ifdef CONFIG_DAHDI_NET
|
|
#include <linux/hdlc.h>
|
|
#endif
|
|
|
|
#ifdef CONFIG_DAHDI_PPP
|
|
#include <linux/ppp_channel.h>
|
|
#include <linux/skbuff.h>
|
|
#include <linux/interrupt.h>
|
|
#endif
|
|
|
|
#include <linux/poll.h>
|
|
|
|
#if LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,10)
|
|
#define dahdi_pci_module pci_register_driver
|
|
#else
|
|
#define dahdi_pci_module pci_module_init
|
|
#endif
|
|
|
|
#if LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,19)
|
|
#define DAHDI_IRQ_HANDLER(a) static irqreturn_t a(int irq, void *dev_id)
|
|
#else
|
|
#define DAHDI_IRQ_HANDLER(a) static irqreturn_t a(int irq, void *dev_id, struct pt_regs *regs)
|
|
#endif
|
|
|
|
#if LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,18)
|
|
#define DAHDI_IRQ_SHARED IRQF_SHARED
|
|
#define DAHDI_IRQ_DISABLED IRQF_DISABLED
|
|
#define DAHDI_IRQ_SHARED_DISABLED IRQF_SHARED | IRQF_DISABLED
|
|
#else
|
|
#define DAHDI_IRQ_SHARED SA_SHIRQ
|
|
#define DAHDI_IRQ_DISABLED SA_INTERRUPT
|
|
#define DAHDI_IRQ_SHARED_DISABLED SA_SHIRQ | SA_INTERRUPT
|
|
#endif
|
|
|
|
#if LINUX_VERSION_CODE <= KERNEL_VERSION(2,6,16)
|
|
#ifndef dev_notice
|
|
#define dev_notice(dev, format, arg...) \
|
|
dev_printk(KERN_NOTICE , dev , format , ## arg)
|
|
#endif
|
|
#endif
|
|
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2,6,26)
|
|
# ifdef RHEL_RELEASE_VERSION
|
|
# if RHEL_RELEASE_CODE < RHEL_RELEASE_VERSION(5, 6)
|
|
#define dev_name(dev) ((dev)->bus_id)
|
|
# endif
|
|
# else
|
|
#define dev_name(dev) ((dev)->bus_id)
|
|
# endif
|
|
#define dev_set_name(dev, format, ...) \
|
|
snprintf((dev)->bus_id, BUS_ID_SIZE, format, ## __VA_ARGS__);
|
|
#endif
|
|
|
|
/*! Default chunk size for conferences and such -- static right now, might make
|
|
variable sometime. 8 samples = 1 ms = most frequent service interval possible
|
|
for a USB device */
|
|
#define DAHDI_CHUNKSIZE 8
|
|
#define DAHDI_MIN_CHUNKSIZE DAHDI_CHUNKSIZE
|
|
#define DAHDI_DEFAULT_CHUNKSIZE DAHDI_CHUNKSIZE
|
|
#define DAHDI_MAX_CHUNKSIZE DAHDI_CHUNKSIZE
|
|
#define DAHDI_CB_SIZE 2
|
|
|
|
/* DAHDI operates at 8Khz by default */
|
|
#define DAHDI_MS_TO_SAMPLES(ms) ((ms) * 8)
|
|
|
|
#define DAHDI_MSECS_PER_CHUNK (DAHDI_CHUNKSIZE/DAHDI_MS_TO_SAMPLES(1))
|
|
|
|
#define RING_DEBOUNCE_TIME 2000 /*!< 2000 ms ring debounce time */
|
|
|
|
typedef struct
|
|
{
|
|
int32_t gain;
|
|
int32_t a1;
|
|
int32_t a2;
|
|
int32_t b1;
|
|
int32_t b2;
|
|
|
|
int32_t z1;
|
|
int32_t z2;
|
|
} biquad2_state_t;
|
|
|
|
typedef struct
|
|
{
|
|
biquad2_state_t notch;
|
|
int notch_level;
|
|
int channel_level;
|
|
int tone_present;
|
|
int tone_cycle_duration;
|
|
int good_cycles;
|
|
int hit;
|
|
} echo_can_disable_detector_state_t;
|
|
|
|
struct sf_detect_state {
|
|
long x1;
|
|
long x2;
|
|
long y1;
|
|
long y2;
|
|
long e1;
|
|
long e2;
|
|
int samps;
|
|
int lastdetect;
|
|
};
|
|
|
|
struct dahdi_tone_state {
|
|
int v1_1;
|
|
int v2_1;
|
|
int v3_1;
|
|
int v1_2;
|
|
int v2_2;
|
|
int v3_2;
|
|
int modulate;
|
|
};
|
|
|
|
/*! \brief Conference queue structure */
|
|
struct confq {
|
|
u_char buffer[DAHDI_CHUNKSIZE * DAHDI_CB_SIZE];
|
|
u_char *buf[DAHDI_CB_SIZE];
|
|
int inbuf;
|
|
int outbuf;
|
|
};
|
|
|
|
struct dahdi_chan;
|
|
struct dahdi_echocan_state;
|
|
|
|
/*! Features a DAHDI echo canceler (software or hardware) can provide to the DAHDI core. */
|
|
struct dahdi_echocan_features {
|
|
|
|
/*! Able to detect CED tone (2100 Hz with phase reversals) in the transmit direction.
|
|
* If the echocan can detect this tone, it may report it it as an event (see
|
|
* the events.CED_tx_detected field of dahdi_echocan_state), and if it will automatically
|
|
* disable itself or its non-linear processor, then the NLP_automatic feature flag should also
|
|
* be set so that the DAHDI core doesn't bother trying to do so.
|
|
*/
|
|
u32 CED_tx_detect:1;
|
|
|
|
/*! Able to detect CED tone (2100 Hz with phase reversals) in the receive direction.
|
|
* If the echocan can detect this tone, it may report it it as an event (see
|
|
* the events.CED_rx_detected field of dahdi_echocan_state), and if it will automatically
|
|
* disable itself or its non-linear processor, then the NLP_automatic flag feature should also
|
|
* be set so that the DAHDI core doesn't bother trying to do so.
|
|
*/
|
|
u32 CED_rx_detect:1;
|
|
|
|
/*! Able to detect CNG tone (1100 Hz) in the transmit direction. */
|
|
u32 CNG_tx_detect:1;
|
|
|
|
/*! Able to detect CNG tone (1100 Hz) in the receive direction. */
|
|
u32 CNG_rx_detect:1;
|
|
|
|
/*! If the echocan's NLP can be enabled and disabled without requiring destruction
|
|
* and recreation of the state structure, this feature flag should be set and the
|
|
* echocan_NLP_toggle field of the dahdi_echocan_ops structure should be filled with a
|
|
* pointer to the function to perform that operation.
|
|
*/
|
|
u32 NLP_toggle:1;
|
|
|
|
/*! If the echocan will automatically disable itself (or even just its NLP) based on
|
|
* detection of a CED tone in either direction, this feature flag should be set (along
|
|
* with the tone detection feature flags).
|
|
*/
|
|
u32 NLP_automatic:1;
|
|
};
|
|
|
|
/*! Operations (methods) that can be performed on a DAHDI echo canceler instance (state
|
|
* structure) after it has been created, by either a software or hardware echo canceller.
|
|
* The echo canceler must populate the owner field of the dahdi_echocan_state structure
|
|
* with a pointer to the relevant operations structure for that instance.
|
|
*/
|
|
struct dahdi_echocan_ops {
|
|
|
|
/*! \brief Free an echocan state structure.
|
|
* \param[in,out] ec Pointer to the state structure to free.
|
|
*
|
|
* \return Nothing.
|
|
*/
|
|
void (*echocan_free)(struct dahdi_chan *chan, struct dahdi_echocan_state *ec);
|
|
|
|
/*! \brief Process an array of audio samples through the echocan.
|
|
* \param[in,out] ec Pointer to the state structure.
|
|
* \param[in,out] isig The receive direction data (will be modified).
|
|
* \param[in] iref The transmit direction data.
|
|
* \param[in] size The number of elements in the isig and iref arrays.
|
|
*
|
|
* Note: This function can also return events in the events field of the
|
|
* dahdi_echocan_state structure. If it can do so, then the echocan does
|
|
* not need to provide the echocan_events function.
|
|
*
|
|
* \return Nothing.
|
|
*/
|
|
void (*echocan_process)(struct dahdi_echocan_state *ec, short *isig, const short *iref, u32 size);
|
|
|
|
/*! \brief Retrieve events from the echocan.
|
|
* \param[in,out] ec Pointer to the state structure.
|
|
*
|
|
*
|
|
* If any events have occurred, the events field of the dahdi_echocan_state
|
|
* structure should be updated to include them.
|
|
*
|
|
* \return Nothing.
|
|
*/
|
|
void (*echocan_events)(struct dahdi_echocan_state *ec);
|
|
|
|
/*! \brief Feed a sample (and its position) for echocan training.
|
|
* \param[in,out] ec Pointer to the state structure.
|
|
* \param[in] pos The tap position to be 'trained'.
|
|
* \param[in] val The receive direction sample for the specified tap position.
|
|
*
|
|
* \retval Zero if training should continue.
|
|
* \retval Non-zero if training is complete.
|
|
*/
|
|
int (*echocan_traintap)(struct dahdi_echocan_state *ec, int pos, short val);
|
|
|
|
/*! \brief Enable or disable non-linear processing (NLP) in the echocan.
|
|
* \param[in,out] ec Pointer to the state structure.
|
|
* \param[in] enable Zero to disable, non-zero to enable.
|
|
*
|
|
* \return Nothing.
|
|
*/
|
|
void (*echocan_NLP_toggle)(struct dahdi_echocan_state *ec, unsigned int enable);
|
|
|
|
#ifdef CONFIG_DAHDI_ECHOCAN_PROCESS_TX
|
|
/*! \brief Process an array of TX audio samples.
|
|
*
|
|
* \return Nothing.
|
|
*/
|
|
void (*echocan_process_tx)(struct dahdi_echocan_state *ec,
|
|
short *tx, u32 size);
|
|
#endif
|
|
};
|
|
|
|
/*! A factory for creating instances of software echo cancelers to be used on DAHDI channels. */
|
|
struct dahdi_echocan_factory {
|
|
|
|
/*! Get the name of the factory. */
|
|
const char *(*get_name)(const struct dahdi_chan *chan);
|
|
|
|
/*! Pointer to the module that owns this factory; the module's reference count will be
|
|
* incremented/decremented by the DAHDI core as needed.
|
|
*/
|
|
struct module *owner;
|
|
|
|
/*! \brief Function to create an instance of the echocan.
|
|
* \param[in] ecp Structure defining parameters to be used for the instance creation.
|
|
* \param[in] p Pointer to the beginning of an (optional) array of user-defined parameters.
|
|
* \param[out] ec Pointer to the state structure that is created, if any.
|
|
*
|
|
* \retval Zero on success.
|
|
* \retval Non-zero on failure (return value will be returned to userspace so it should be a
|
|
* standard error number).
|
|
*/
|
|
int (*echocan_create)(struct dahdi_chan *chan, struct dahdi_echocanparams *ecp,
|
|
struct dahdi_echocanparam *p, struct dahdi_echocan_state **ec);
|
|
};
|
|
|
|
/*! \brief Register an echo canceler factory with the DAHDI core.
|
|
* \param[in] ec Pointer to the dahdi_echocan_factory structure to be registered.
|
|
*
|
|
* \retval Zero on success.
|
|
* \retval Non-zero on failure (return value will be a standard error number).
|
|
*/
|
|
int dahdi_register_echocan_factory(const struct dahdi_echocan_factory *ec);
|
|
|
|
/*! \brief Unregister a previously-registered echo canceler factory from the DAHDI core.
|
|
* \param[in] ec Pointer to the dahdi_echocan_factory structure to be unregistered.
|
|
*
|
|
* \return Nothing.
|
|
*/
|
|
void dahdi_unregister_echocan_factory(const struct dahdi_echocan_factory *ec);
|
|
|
|
enum dahdi_echocan_mode {
|
|
__ECHO_MODE_MUTE = 1 << 8,
|
|
ECHO_MODE_IDLE = 0,
|
|
ECHO_MODE_PRETRAINING = 1 | __ECHO_MODE_MUTE,
|
|
ECHO_MODE_STARTTRAINING = 2 | __ECHO_MODE_MUTE,
|
|
ECHO_MODE_AWAITINGECHO = 3 | __ECHO_MODE_MUTE,
|
|
ECHO_MODE_TRAINING = 4 | __ECHO_MODE_MUTE,
|
|
ECHO_MODE_ACTIVE = 5,
|
|
ECHO_MODE_FAX = 6,
|
|
};
|
|
|
|
/*! An instance of a DAHDI echo canceler (software or hardware). */
|
|
struct dahdi_echocan_state {
|
|
|
|
/*! Pointer to a dahdi_echocan_ops structure of operations that can be
|
|
* performed on this instance.
|
|
*/
|
|
const struct dahdi_echocan_ops *ops;
|
|
|
|
/*! State data used by the DAHDI core's CED detector for the transmit
|
|
* direction, if needed.
|
|
*/
|
|
echo_can_disable_detector_state_t txecdis;
|
|
|
|
/*! State data used by the DAHDI core's CED detector for the receive
|
|
* direction, if needed.
|
|
*/
|
|
echo_can_disable_detector_state_t rxecdis;
|
|
|
|
/*! Features offered by the echo canceler that provided this instance. */
|
|
struct dahdi_echocan_features features;
|
|
|
|
struct {
|
|
/*! The mode the echocan is currently in. */
|
|
enum dahdi_echocan_mode mode;
|
|
|
|
/*! The last tap position that was fed to the echocan's training function. */
|
|
u32 last_train_tap;
|
|
|
|
/*! How many samples to wait before beginning the training operation. */
|
|
u32 pretrain_timer;
|
|
} status;
|
|
|
|
/*! This structure contains event flags, allowing the echocan to report
|
|
* events that occurred as it processed the transmit and receive streams
|
|
* of samples. Each call to the echocan_process operation for this
|
|
* instance may report events, so the structure should be cleared before
|
|
* calling that operation.
|
|
*/
|
|
union dahdi_echocan_events {
|
|
u32 all;
|
|
struct {
|
|
/*! CED tone was detected in the transmit direction. If the
|
|
* echocan automatically disables its NLP when this occurs,
|
|
* it must also signal the NLP_auto_disabled event during the *same*
|
|
* call to echocan_process that reports the CED detection.
|
|
*/
|
|
u32 CED_tx_detected:1;
|
|
|
|
/*! CED tone was detected in the receive direction. If the
|
|
* echocan automatically disables its NLP when this occurs,
|
|
* it must also signal the NLP_auto_disabled event during the *same*
|
|
* call to echocan_process that reports the CED detection.
|
|
*/
|
|
u32 CED_rx_detected:1;
|
|
|
|
/*! CNG tone was detected in the transmit direction. */
|
|
u32 CNG_tx_detected:1;
|
|
|
|
/*! CNG tone was detected in the receive direction. */
|
|
u32 CNG_rx_detected:1;
|
|
|
|
/*! The echocan disabled its NLP automatically.
|
|
*/
|
|
u32 NLP_auto_disabled:1;
|
|
|
|
/*! The echocan enabled its NLP automatically.
|
|
*/
|
|
u32 NLP_auto_enabled:1;
|
|
} bit;
|
|
} events;
|
|
};
|
|
|
|
struct dahdi_chan {
|
|
#ifdef CONFIG_DAHDI_NET
|
|
/*! \note Must be first */
|
|
struct dahdi_hdlc *hdlcnetdev;
|
|
#endif
|
|
#ifdef CONFIG_DAHDI_PPP
|
|
struct ppp_channel *ppp;
|
|
struct tasklet_struct ppp_calls;
|
|
int do_ppp_wakeup;
|
|
int do_ppp_error;
|
|
struct sk_buff_head ppp_rq;
|
|
#endif
|
|
#ifdef BUFFER_DEBUG
|
|
int statcount;
|
|
int lastnumbufs;
|
|
#endif
|
|
spinlock_t lock;
|
|
char name[40];
|
|
/* Specified by DAHDI */
|
|
/*! \brief DAHDI channel number */
|
|
int channo;
|
|
int chanpos;
|
|
unsigned long flags;
|
|
long rxp1;
|
|
long rxp2;
|
|
long rxp3;
|
|
int txtone;
|
|
int tx_v2;
|
|
int tx_v3;
|
|
int v1_1;
|
|
int v2_1;
|
|
int v3_1;
|
|
int toneflags;
|
|
struct sf_detect_state rd;
|
|
|
|
struct dahdi_chan *master; /*!< Our Master channel (could be us) */
|
|
/*! \brief Next slave (if appropriate) */
|
|
struct dahdi_chan *nextslave;
|
|
|
|
u_char *writechunk; /*!< Actual place to write to */
|
|
u_char swritechunk[DAHDI_MAX_CHUNKSIZE]; /*!< Buffer to be written */
|
|
u_char *readchunk; /*!< Actual place to read from */
|
|
u_char sreadchunk[DAHDI_MAX_CHUNKSIZE]; /*!< Preallocated static area */
|
|
short *readchunkpreec;
|
|
|
|
/* Channel from which to read when DACSed. */
|
|
struct dahdi_chan *dacs_chan;
|
|
|
|
/*! Pointer to tx and rx gain tables */
|
|
const u_char *rxgain;
|
|
const u_char *txgain;
|
|
|
|
/* Specified by driver, readable by DAHDI */
|
|
void *pvt; /*!< Private channel data */
|
|
struct file *file; /*!< File structure */
|
|
|
|
|
|
#ifdef CONFIG_DAHDI_MIRROR
|
|
struct dahdi_chan *rxmirror; /*!< channel we mirror reads to */
|
|
struct dahdi_chan *txmirror; /*!< channel we mirror writes to */
|
|
struct dahdi_chan *srcmirror; /*!< channel we mirror from */
|
|
#endif /* CONFIG_DAHDI_MIRROR */
|
|
struct dahdi_span *span; /*!< Span we're a member of */
|
|
int sig; /*!< Signalling */
|
|
int sigcap; /*!< Capability for signalling */
|
|
__u32 chan_alarms; /*!< alarms status */
|
|
|
|
wait_queue_head_t waitq;
|
|
|
|
/* Used only by DAHDI -- NO DRIVER SERVICEABLE PARTS BELOW */
|
|
/* Buffer declarations */
|
|
u_char *readbuf[DAHDI_MAX_NUM_BUFS]; /*!< read buffer */
|
|
int inreadbuf;
|
|
int outreadbuf;
|
|
|
|
u_char *writebuf[DAHDI_MAX_NUM_BUFS]; /*!< write buffers */
|
|
int inwritebuf;
|
|
int outwritebuf;
|
|
|
|
int blocksize; /*!< Block size */
|
|
|
|
int eventinidx; /*!< out index in event buf (circular) */
|
|
int eventoutidx; /*!< in index in event buf (circular) */
|
|
unsigned int eventbuf[DAHDI_MAX_EVENTSIZE]; /*!< event circ. buffer */
|
|
|
|
int readn[DAHDI_MAX_NUM_BUFS]; /*!< # of bytes ready in read buf */
|
|
int readidx[DAHDI_MAX_NUM_BUFS]; /*!< current read pointer */
|
|
int writen[DAHDI_MAX_NUM_BUFS]; /*!< # of bytes ready in write buf */
|
|
int writeidx[DAHDI_MAX_NUM_BUFS]; /*!< current write pointer */
|
|
|
|
int numbufs; /*!< How many buffers in channel */
|
|
int txbufpolicy; /*!< Buffer policy */
|
|
int rxbufpolicy; /*!< Buffer policy */
|
|
int txdisable; /*!< Disable transmitter */
|
|
int rxdisable; /*!< Disable receiver */
|
|
|
|
|
|
/* Tone zone stuff */
|
|
struct dahdi_zone *curzone; /*!< Zone for selecting tones */
|
|
struct dahdi_tone *curtone; /*!< Current tone we're playing (if any) */
|
|
int tonep; /*!< Current position in tone */
|
|
struct dahdi_tone_state ts; /*!< Tone state */
|
|
|
|
/* Pulse dial stuff */
|
|
int pdialcount; /*!< pulse dial count */
|
|
|
|
/*! Ring cadence */
|
|
int ringcadence[DAHDI_MAX_CADENCE];
|
|
int firstcadencepos; /*!< Where to restart ring cadence */
|
|
|
|
/* Digit string dialing stuff */
|
|
int digitmode; /*!< What kind of tones are we sending? */
|
|
char txdialbuf[DAHDI_MAX_DTMF_BUF];
|
|
int dialing;
|
|
int afterdialingtimer;
|
|
int cadencepos; /*!< Where in the cadence we are */
|
|
|
|
/* I/O Mask */
|
|
unsigned int iomask; /*! I/O Mux signal mask */
|
|
|
|
/* HDLC state machines */
|
|
struct fasthdlc_state txhdlc;
|
|
struct fasthdlc_state rxhdlc;
|
|
int infcs;
|
|
|
|
/* Conferencing stuff */
|
|
int confna; /*! conference number (alias) */
|
|
int _confn; /*! Actual conference number */
|
|
int confmode; /*! conference mode */
|
|
int confmute; /*! conference mute mode */
|
|
struct dahdi_chan *conf_chan;
|
|
|
|
/* Incoming and outgoing conference chunk queues for
|
|
communicating between DAHDI master time and
|
|
other boards */
|
|
struct confq confin;
|
|
struct confq confout;
|
|
|
|
short getlin[DAHDI_MAX_CHUNKSIZE]; /*!< Last transmitted samples */
|
|
unsigned char getraw[DAHDI_MAX_CHUNKSIZE]; /*!< Last received raw data */
|
|
short getlin_lastchunk[DAHDI_MAX_CHUNKSIZE]; /*!< Last transmitted samples from last chunk */
|
|
short putlin[DAHDI_MAX_CHUNKSIZE]; /*!< Last received samples */
|
|
unsigned char putraw[DAHDI_MAX_CHUNKSIZE]; /*!< Last received raw data */
|
|
short conflast[DAHDI_MAX_CHUNKSIZE]; /*!< Last conference sample -- base part of channel */
|
|
short conflast1[DAHDI_MAX_CHUNKSIZE]; /*!< Last conference sample -- pseudo part of channel */
|
|
short conflast2[DAHDI_MAX_CHUNKSIZE]; /*!< Previous last conference sample -- pseudo part of channel */
|
|
|
|
|
|
/*! The echo canceler module that should be used to create an
|
|
instance when this channel needs one */
|
|
const struct dahdi_echocan_factory *ec_factory;
|
|
/*! The echo canceler module that owns the instance currently
|
|
on this channel, if one is present */
|
|
const struct dahdi_echocan_factory *ec_current;
|
|
/*! The state data of the echo canceler instance in use */
|
|
struct dahdi_echocan_state *ec_state;
|
|
|
|
/* RBS timings */
|
|
int prewinktime; /*!< pre-wink time (ms) */
|
|
int preflashtime; /*!< pre-flash time (ms) */
|
|
int winktime; /*!< wink time (ms) */
|
|
int flashtime; /*!< flash time (ms) */
|
|
int starttime; /*!< start time (ms) */
|
|
int rxwinktime; /*!< rx wink time (ms) */
|
|
int rxflashtime; /*!< rx flash time (ms) */
|
|
int debouncetime; /*!< FXS GS sig debounce time (ms) */
|
|
int pulsebreaktime; /*!< pulse line open time (ms) */
|
|
int pulsemaketime; /*!< pulse line closed time (ms) */
|
|
int pulseaftertime; /*!< pulse time between digits (ms) */
|
|
|
|
/*! RING debounce timer */
|
|
int ringdebtimer;
|
|
|
|
/*! RING trailing detector to make sure a RING is really over */
|
|
int ringtrailer;
|
|
|
|
/* PULSE digit receiver stuff */
|
|
int pulsecount;
|
|
int pulsetimer;
|
|
|
|
/* RBS timers */
|
|
int itimerset; /*!< what the itimer was set to last */
|
|
int itimer;
|
|
int otimer;
|
|
|
|
/* RBS state */
|
|
int gotgs;
|
|
int txstate;
|
|
int rxsig;
|
|
int txsig;
|
|
int rxsigstate;
|
|
|
|
/* non-RBS rx state */
|
|
int rxhooksig;
|
|
int txhooksig;
|
|
int kewlonhook;
|
|
|
|
/*! Idle signalling if CAS signalling */
|
|
int idlebits;
|
|
|
|
int deflaw; /*! 1 = mulaw, 2=alaw, 0=undefined */
|
|
short *xlaw;
|
|
#ifdef OPTIMIZE_CHANMUTE
|
|
int chanmute; /*!< no need for PCM data */
|
|
#endif
|
|
#ifdef CONFIG_CALC_XLAW
|
|
unsigned char (*lineartoxlaw)(short a);
|
|
#else
|
|
unsigned char *lin2x;
|
|
#endif
|
|
};
|
|
|
|
#ifdef CONFIG_DAHDI_NET
|
|
struct dahdi_hdlc {
|
|
struct net_device *netdev;
|
|
struct dahdi_chan *chan;
|
|
};
|
|
#endif
|
|
|
|
/*! Define the maximum block size */
|
|
#define DAHDI_MAX_BLOCKSIZE 8192
|
|
|
|
|
|
#define DAHDI_DEFAULT_WINKTIME 150 /*!< 150 ms default wink time */
|
|
#define DAHDI_DEFAULT_FLASHTIME 750 /*!< 750 ms default flash time */
|
|
|
|
#define DAHDI_DEFAULT_PREWINKTIME 50 /*!< 50 ms before wink */
|
|
#define DAHDI_DEFAULT_PREFLASHTIME 50 /*!< 50 ms before flash */
|
|
#define DAHDI_DEFAULT_STARTTIME 1500 /*!< 1500 ms of start */
|
|
#define DAHDI_DEFAULT_RINGTIME 2000 /*!< 2000 ms of ring on (start, FXO) */
|
|
#if 0
|
|
#define DAHDI_DEFAULT_RXWINKTIME 250 /*!< 250ms longest rx wink */
|
|
#endif
|
|
#define DAHDI_DEFAULT_RXWINKTIME 300 /*!< 300ms longest rx wink (to work with the Atlas) */
|
|
#define DAHDI_DEFAULT_RXFLASHTIME 1250 /*!< 1250ms longest rx flash */
|
|
#define DAHDI_DEFAULT_DEBOUNCETIME 600 /*!< 600ms of FXS GS signalling debounce */
|
|
#define DAHDI_DEFAULT_PULSEMAKETIME 50 /*!< 50 ms of line closed when dial pulsing */
|
|
#define DAHDI_DEFAULT_PULSEBREAKTIME 50 /*!< 50 ms of line open when dial pulsing */
|
|
#define DAHDI_DEFAULT_PULSEAFTERTIME 750 /*!< 750ms between dial pulse digits */
|
|
|
|
#define DAHDI_MINPULSETIME (15 * 8) /*!< 15 ms minimum */
|
|
|
|
#ifdef SHORT_FLASH_TIME
|
|
#define DAHDI_MAXPULSETIME (80 * 8) /*!< we need 80 ms, not 200ms, as we have a short flash */
|
|
#else
|
|
#define DAHDI_MAXPULSETIME (200 * 8) /*!< 200 ms maximum */
|
|
#endif
|
|
|
|
#define DAHDI_PULSETIMEOUT ((DAHDI_MAXPULSETIME / 8) + 50)
|
|
|
|
#define DAHDI_RINGTRAILER (50 * 8) /*!< Don't consider a ring "over" until it's been gone at least this
|
|
much time */
|
|
|
|
#define DAHDI_LOOPCODE_TIME 10000 /*!< send loop codes for 10 secs */
|
|
#define DAHDI_ALARMSETTLE_TIME 5000 /*!< allow alarms to settle for 5 secs */
|
|
#define DAHDI_AFTERSTART_TIME 500 /*!< 500ms after start */
|
|
|
|
#define DAHDI_RINGOFFTIME 4000 /*!< Turn off ringer for 4000 ms */
|
|
#define DAHDI_KEWLTIME 500 /*!< 500ms for kewl pulse */
|
|
#define DAHDI_AFTERKEWLTIME 300 /*!< 300ms after kewl pulse */
|
|
|
|
#define DAHDI_MAX_PRETRAINING 1000 /*!< 1000ms max pretraining time */
|
|
|
|
#ifdef FXSFLASH
|
|
#define DAHDI_FXSFLASHMINTIME 450 /*!< min 450ms */
|
|
#define DAHDI_FXSFLASHMAXTIME 550 /*!< max 550ms */
|
|
#endif
|
|
|
|
|
|
struct dahdi_chardev {
|
|
const char *name;
|
|
__u8 minor;
|
|
};
|
|
|
|
int dahdi_register_chardev(struct dahdi_chardev *dev);
|
|
int dahdi_unregister_chardev(struct dahdi_chardev *dev);
|
|
|
|
/*! \brief defines for transmit signalling */
|
|
enum dahdi_txsig {
|
|
DAHDI_TXSIG_ONHOOK, /*!< On hook */
|
|
DAHDI_TXSIG_OFFHOOK, /*!< Off hook */
|
|
DAHDI_TXSIG_START, /*!< Start / Ring */
|
|
DAHDI_TXSIG_KEWL, /*!< Drop battery if possible */
|
|
/*! Leave this as the last entry */
|
|
DAHDI_TXSIG_TOTAL,
|
|
};
|
|
|
|
enum dahdi_rxsig {
|
|
DAHDI_RXSIG_ONHOOK,
|
|
DAHDI_RXSIG_OFFHOOK,
|
|
DAHDI_RXSIG_START,
|
|
DAHDI_RXSIG_RING,
|
|
DAHDI_RXSIG_INITIAL
|
|
};
|
|
|
|
enum {
|
|
/* Span flags */
|
|
DAHDI_FLAGBIT_REGISTERED= 0,
|
|
DAHDI_FLAGBIT_RUNNING = 1,
|
|
DAHDI_FLAGBIT_RBS = 12, /*!< Span uses RBS signalling */
|
|
|
|
/* Channel flags */
|
|
DAHDI_FLAGBIT_DTMFDECODE= 2, /*!< Channel supports native DTMF decode */
|
|
DAHDI_FLAGBIT_MFDECODE = 3, /*!< Channel supports native MFr2 decode */
|
|
DAHDI_FLAGBIT_ECHOCANCEL= 4, /*!< Channel supports native echo cancellation */
|
|
DAHDI_FLAGBIT_HDLC = 5, /*!< Perform HDLC */
|
|
#ifdef CONFIG_DAHDI_NET
|
|
DAHDI_FLAGBIT_NETDEV = 6, /*!< Send to network */
|
|
#endif
|
|
DAHDI_FLAGBIT_CLEAR = 8, /*!< Clear channel */
|
|
DAHDI_FLAGBIT_AUDIO = 9, /*!< Audio mode channel */
|
|
DAHDI_FLAGBIT_OPEN = 10, /*!< Channel is open */
|
|
DAHDI_FLAGBIT_FCS = 11, /*!< Calculate FCS */
|
|
/* Reserve 12 for uniqueness with span flags */
|
|
DAHDI_FLAGBIT_LINEAR = 13, /*!< Talk to user space in linear */
|
|
DAHDI_FLAGBIT_PPP = 14, /*!< PPP is available */
|
|
DAHDI_FLAGBIT_T1PPP = 15,
|
|
DAHDI_FLAGBIT_SIGFREEZE = 16, /*!< Freeze signalling */
|
|
DAHDI_FLAGBIT_NOSTDTXRX = 17, /*!< Do NOT do standard transmit and receive on every interrupt */
|
|
DAHDI_FLAGBIT_LOOPED = 18, /*!< Loopback the receive data from the channel to the transmit */
|
|
DAHDI_FLAGBIT_MTP2 = 19, /*!< Repeats last message in buffer and also discards repeating messages sent to us */
|
|
DAHDI_FLAGBIT_HDLC56 = 20, /*!< Sets the given channel (if in HDLC mode) to use 56K HDLC instead of 64K */
|
|
DAHDI_FLAGBIT_BUFEVENTS = 21, /*!< Report buffer events */
|
|
DAHDI_FLAGBIT_TXUNDERRUN = 22, /*!< Transmit underrun condition */
|
|
DAHDI_FLAGBIT_RXOVERRUN = 23, /*!< Receive overrun condition */
|
|
DAHDI_FLAGBIT_DEVFILE = 25, /*!< Channel has a sysfs dev file */
|
|
};
|
|
|
|
#ifdef CONFIG_DAHDI_NET
|
|
/**
|
|
* have_netdev() - Return true if a channel has an associated network device.
|
|
* @chan: Then channel to check.
|
|
*
|
|
*/
|
|
static inline int dahdi_have_netdev(const struct dahdi_chan *chan)
|
|
{
|
|
return test_bit(DAHDI_FLAGBIT_NETDEV, &chan->flags);
|
|
}
|
|
#else
|
|
static inline int dahdi_have_netdev(const struct dahdi_chan *chan) { return 0; }
|
|
#endif
|
|
|
|
struct dahdi_count {
|
|
__u32 fe; /*!< Framing error counter */
|
|
__u32 cv; /*!< Coding violations counter */
|
|
__u32 bpv; /*!< Bipolar Violation counter */
|
|
__u32 crc4; /*!< CRC4 error counter */
|
|
__u32 ebit; /*!< current E-bit error count */
|
|
__u32 fas; /*!< current FAS error count */
|
|
__u32 be; /*!< current bit error count */
|
|
__u32 prbs; /*!< current PRBS detected pattern */
|
|
__u32 errsec; /*!< errored seconds */
|
|
};
|
|
|
|
/* map flagbits to flag masks */
|
|
#define DAHDI_FLAG(x) (1 << (DAHDI_FLAGBIT_ ## x))
|
|
|
|
/*! This is a redefinition of the flags from above to allow use of the
|
|
* legacy drivers that do not use the kernel atomic bit testing and
|
|
* changing routines.
|
|
*
|
|
* See the above descriptions for DAHDI_FLAGBIT_.... for documentation
|
|
* about function. */
|
|
/* Span flags */
|
|
#define DAHDI_FLAG_REGISTERED DAHDI_FLAG(REGISTERED)
|
|
#define DAHDI_FLAG_RUNNING DAHDI_FLAG(RUNNING)
|
|
#define DAHDI_FLAG_RBS DAHDI_FLAG(RBS)
|
|
|
|
/* Channel flags */
|
|
#define DAHDI_FLAG_DTMFDECODE DAHDI_FLAG(DTMFDECODE)
|
|
#define DAHDI_FLAG_MFDECODE DAHDI_FLAG(MFDECODE)
|
|
#define DAHDI_FLAG_ECHOCANCEL DAHDI_FLAG(ECHOCANCEL)
|
|
|
|
#define DAHDI_FLAG_HDLC DAHDI_FLAG(HDLC)
|
|
/* #define DAHDI_FLAG_NETDEV DAHDI_FLAG(NETDEV) */
|
|
#define DAHDI_FLAG_CLEAR DAHDI_FLAG(CLEAR)
|
|
#define DAHDI_FLAG_AUDIO DAHDI_FLAG(AUDIO)
|
|
|
|
#define DAHDI_FLAG_OPEN DAHDI_FLAG(OPEN)
|
|
#define DAHDI_FLAG_FCS DAHDI_FLAG(FCS)
|
|
/* Reserve 12 for uniqueness with span flags */
|
|
#define DAHDI_FLAG_LINEAR DAHDI_FLAG(LINEAR)
|
|
#define DAHDI_FLAG_PPP DAHDI_FLAG(PPP)
|
|
#define DAHDI_FLAG_T1PPP DAHDI_FLAG(T1PPP)
|
|
#define DAHDI_FLAG_SIGFREEZE DAHDI_FLAG(SIGFREEZE)
|
|
#define DAHDI_FLAG_NOSTDTXRX DAHDI_FLAG(NOSTDTXRX)
|
|
#define DAHDI_FLAG_LOOPED DAHDI_FLAG(LOOPED)
|
|
#define DAHDI_FLAG_MTP2 DAHDI_FLAG(MTP2)
|
|
#define DAHDI_FLAG_HDLC56 DAHDI_FLAG(HDLC56)
|
|
#define DAHDI_FLAG_BUFEVENTS DAHDI_FLAG(BUFEVENTS)
|
|
#define DAHDI_FLAG_TXUNDERRUN DAHDI_FLAG(TXUNDERRUN)
|
|
#define DAHDI_FLAG_RXOVERRUN DAHDI_FLAG(RXOVERRUN)
|
|
|
|
struct dahdi_span_ops {
|
|
struct module *owner; /*!< Which module is exporting this span. */
|
|
|
|
/* ==== Span Callback Operations ==== */
|
|
/*! Req: Set the requested chunk size. This is the unit in which you must
|
|
report results for conferencing, etc */
|
|
int (*setchunksize)(struct dahdi_span *span, int chunksize);
|
|
|
|
/*! Opt: Configure the span (if appropriate) */
|
|
int (*spanconfig)(struct dahdi_span *span, struct dahdi_lineconfig *lc);
|
|
|
|
/*! Opt: Start the span */
|
|
int (*startup)(struct dahdi_span *span);
|
|
|
|
/*! Opt: Shutdown the span */
|
|
int (*shutdown)(struct dahdi_span *span);
|
|
|
|
/*! Opt: Enable maintenance modes */
|
|
int (*maint)(struct dahdi_span *span, int mode);
|
|
|
|
#ifdef DAHDI_SYNC_TICK
|
|
/*! Opt: send sync to spans. Called in hard_irq context with chan_lock
|
|
* held.*/
|
|
void (*sync_tick)(struct dahdi_span *span, int is_master);
|
|
#endif
|
|
/* ==== Channel Callback Operations ==== */
|
|
/*! Opt: Set signalling type (if appropriate) */
|
|
int (*chanconfig)(struct dahdi_chan *chan, int sigtype);
|
|
|
|
/*! Opt: Prepare a channel for I/O */
|
|
int (*open)(struct dahdi_chan *chan);
|
|
|
|
/*! Opt: Close channel for I/O */
|
|
int (*close)(struct dahdi_chan *chan);
|
|
|
|
/*! Opt: IOCTL */
|
|
int (*ioctl)(struct dahdi_chan *chan, unsigned int cmd, unsigned long data);
|
|
|
|
/* Okay, now we get to the signalling. You have several options: */
|
|
|
|
/* Option 1: If you're a T1 like interface, you can just provide a
|
|
rbsbits function and we'll assert robbed bits for you. Be sure to
|
|
set the DAHDI_FLAG_RBS in this case. */
|
|
|
|
/*! Opt: If the span uses A/B bits, set them here */
|
|
int (*rbsbits)(struct dahdi_chan *chan, int bits);
|
|
|
|
/*! Option 2: If you don't know about sig bits, but do have their
|
|
equivalents (i.e. you can disconnect battery, detect off hook,
|
|
generate ring, etc directly) then you can just specify a
|
|
sethook function, and we'll call you with appropriate hook states
|
|
to set. Still set the DAHDI_FLAG_RBS in this case as well */
|
|
int (*hooksig)(struct dahdi_chan *chan, enum dahdi_txsig hookstate);
|
|
|
|
/*! Option 3: If you can't use sig bits, you can write a function
|
|
which handles the individual hook states */
|
|
int (*sethook)(struct dahdi_chan *chan, int hookstate);
|
|
|
|
/*! Opt: Used to tell an onboard HDLC controller that there is data ready to transmit */
|
|
void (*hdlc_hard_xmit)(struct dahdi_chan *chan);
|
|
|
|
/*! If the watchdog detects no received data, it will call the
|
|
watchdog routine */
|
|
int (*watchdog)(struct dahdi_span *span, int cause);
|
|
|
|
#ifdef DAHDI_AUDIO_NOTIFY
|
|
/*! Opt: audio is used, don't optimize out */
|
|
int (*audio_notify)(struct dahdi_chan *chan, int yes);
|
|
#endif
|
|
|
|
/*! Opt: Dacs the contents of chan2 into chan1 if possible */
|
|
int (*dacs)(struct dahdi_chan *chan1, struct dahdi_chan *chan2);
|
|
|
|
/*! Opt: Provide echo cancellation on a channel */
|
|
int (*echocan_create)(struct dahdi_chan *chan,
|
|
struct dahdi_echocanparams *ecp,
|
|
struct dahdi_echocanparam *p,
|
|
struct dahdi_echocan_state **ec);
|
|
|
|
/*! Opt: Provide the name of the echo canceller on a channel */
|
|
const char *(*echocan_name)(const struct dahdi_chan *chan);
|
|
};
|
|
|
|
struct dahdi_span {
|
|
spinlock_t lock;
|
|
char name[40]; /*!< Span name */
|
|
char desc[80]; /*!< Span description */
|
|
const char *spantype; /*!< span type in text form */
|
|
const char *manufacturer; /*!< span's device manufacturer */
|
|
char devicetype[80]; /*!< span's device type */
|
|
char location[40]; /*!< span device's location in system */
|
|
int deflaw; /*!< Default law (DAHDI_MULAW or DAHDI_ALAW) */
|
|
int alarms; /*!< Pending alarms on span */
|
|
unsigned long flags;
|
|
u8 cannot_provide_timing:1;
|
|
int irq; /*!< IRQ for this span's hardware */
|
|
int lbo; /*!< Span Line-Buildout */
|
|
int lineconfig; /*!< Span line configuration */
|
|
int linecompat; /*!< Span line compatibility (0 for
|
|
analog spans)*/
|
|
int channels; /*!< Number of channels in span */
|
|
int txlevel; /*!< Tx level */
|
|
int rxlevel; /*!< Rx level */
|
|
int syncsrc; /*!< current sync src (gets copied here) */
|
|
struct dahdi_count count; /*!< Performance and Error counters */
|
|
|
|
enum dahdi_maint_mode maintstat; /*!< Maintenance state */
|
|
int mainttimer; /*!< Maintenance timer */
|
|
|
|
int irqmisses; /*!< Interrupt misses */
|
|
int timingslips; /*!< Clock slips */
|
|
|
|
struct dahdi_chan **chans; /*!< Member channel structures */
|
|
|
|
const struct dahdi_span_ops *ops; /*!< span callbacks. */
|
|
|
|
/* Used by DAHDI only -- no user servicable parts inside */
|
|
int spanno; /*!< Span number for DAHDI */
|
|
int offset; /*!< Offset within a given card */
|
|
int lastalarms; /*!< Previous alarms */
|
|
|
|
#ifdef CONFIG_DAHDI_WATCHDOG
|
|
int watchcounter;
|
|
int watchstate;
|
|
#endif
|
|
|
|
#ifdef CONFIG_PROC_FS
|
|
struct proc_dir_entry *proc_entry;
|
|
#endif
|
|
struct list_head node;
|
|
};
|
|
|
|
struct dahdi_transcoder_channel {
|
|
void *pvt;
|
|
struct dahdi_transcoder *parent;
|
|
wait_queue_head_t ready;
|
|
__u32 built_fmts;
|
|
#define DAHDI_TC_FLAG_BUSY 1
|
|
#define DAHDI_TC_FLAG_CHAN_BUILT 2
|
|
#define DAHDI_TC_FLAG_NONBLOCK 3
|
|
#define DAHDI_TC_FLAG_DATA_WAITING 4
|
|
unsigned long flags;
|
|
u32 dstfmt;
|
|
u32 srcfmt;
|
|
};
|
|
|
|
static inline int
|
|
dahdi_tc_is_built(struct dahdi_transcoder_channel *dtc) {
|
|
return test_bit(DAHDI_TC_FLAG_CHAN_BUILT, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_set_built(struct dahdi_transcoder_channel *dtc) {
|
|
set_bit(DAHDI_TC_FLAG_CHAN_BUILT, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_clear_built(struct dahdi_transcoder_channel *dtc) {
|
|
clear_bit(DAHDI_TC_FLAG_CHAN_BUILT, &dtc->flags);
|
|
}
|
|
static inline int
|
|
dahdi_tc_is_nonblock(struct dahdi_transcoder_channel *dtc) {
|
|
return test_bit(DAHDI_TC_FLAG_NONBLOCK, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_set_nonblock(struct dahdi_transcoder_channel *dtc) {
|
|
set_bit(DAHDI_TC_FLAG_NONBLOCK, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_clear_nonblock(struct dahdi_transcoder_channel *dtc) {
|
|
clear_bit(DAHDI_TC_FLAG_NONBLOCK, &dtc->flags);
|
|
}
|
|
static inline int
|
|
dahdi_tc_is_data_waiting(struct dahdi_transcoder_channel *dtc) {
|
|
return test_bit(DAHDI_TC_FLAG_DATA_WAITING, &dtc->flags);
|
|
}
|
|
static inline int
|
|
dahdi_tc_is_busy(struct dahdi_transcoder_channel *dtc) {
|
|
return test_bit(DAHDI_TC_FLAG_BUSY, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_set_busy(struct dahdi_transcoder_channel *dtc) {
|
|
set_bit(DAHDI_TC_FLAG_BUSY, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_clear_busy(struct dahdi_transcoder_channel *dtc) {
|
|
clear_bit(DAHDI_TC_FLAG_BUSY, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_set_data_waiting(struct dahdi_transcoder_channel *dtc) {
|
|
set_bit(DAHDI_TC_FLAG_DATA_WAITING, &dtc->flags);
|
|
}
|
|
static inline void
|
|
dahdi_tc_clear_data_waiting(struct dahdi_transcoder_channel *dtc) {
|
|
clear_bit(DAHDI_TC_FLAG_DATA_WAITING, &dtc->flags);
|
|
}
|
|
|
|
struct dahdi_transcoder {
|
|
struct list_head active_list_node;
|
|
struct list_head registration_list_node;
|
|
char name[80];
|
|
int numchannels;
|
|
unsigned int srcfmts;
|
|
unsigned int dstfmts;
|
|
struct file_operations fops;
|
|
int (*allocate)(struct dahdi_transcoder_channel *channel);
|
|
int (*release)(struct dahdi_transcoder_channel *channel);
|
|
/* Transcoder channels */
|
|
struct dahdi_transcoder_channel channels[0];
|
|
};
|
|
|
|
#define DAHDI_WATCHDOG_NOINTS (1 << 0)
|
|
|
|
#define DAHDI_WATCHDOG_INIT 1000
|
|
|
|
#define DAHDI_WATCHSTATE_UNKNOWN 0
|
|
#define DAHDI_WATCHSTATE_OK 1
|
|
#define DAHDI_WATCHSTATE_RECOVERING 2
|
|
#define DAHDI_WATCHSTATE_FAILED 3
|
|
|
|
|
|
struct dahdi_dynamic {
|
|
char addr[40];
|
|
char dname[20];
|
|
int err;
|
|
struct kref kref;
|
|
long rxjif;
|
|
unsigned short txcnt;
|
|
unsigned short rxcnt;
|
|
struct dahdi_span span;
|
|
struct dahdi_chan *chans[256];
|
|
struct dahdi_dynamic_driver *driver;
|
|
void *pvt;
|
|
int timing;
|
|
int master;
|
|
unsigned char *msgbuf;
|
|
|
|
struct list_head list;
|
|
};
|
|
|
|
struct dahdi_dynamic_driver {
|
|
/*! Driver name (e.g. Eth) */
|
|
const char *name;
|
|
|
|
/*! Driver description */
|
|
const char *desc;
|
|
|
|
/*! Create a new transmission pipe */
|
|
int (*create)(struct dahdi_dynamic *d, const char *address);
|
|
|
|
/*! Destroy a created transmission pipe */
|
|
void (*destroy)(struct dahdi_dynamic *d);
|
|
|
|
/*! Transmit a given message */
|
|
void (*transmit)(struct dahdi_dynamic *d, u8 *msg, size_t msglen);
|
|
|
|
/*! Flush any pending messages */
|
|
int (*flush)(void);
|
|
|
|
struct list_head list;
|
|
struct module *owner;
|
|
};
|
|
|
|
/*! \brief Receive a dynamic span message */
|
|
void dahdi_dynamic_receive(struct dahdi_span *span, unsigned char *msg, int msglen);
|
|
|
|
/*! \brief Register a dynamic driver */
|
|
int dahdi_dynamic_register_driver(struct dahdi_dynamic_driver *driver);
|
|
|
|
/*! \brief Unregister a dynamic driver */
|
|
void dahdi_dynamic_unregister_driver(struct dahdi_dynamic_driver *driver);
|
|
|
|
int _dahdi_receive(struct dahdi_span *span);
|
|
|
|
/*! Receive on a span. The DAHDI interface will handle all the calculations for
|
|
all member channels of the span, pulling the data from the readchunk buffer */
|
|
static inline int dahdi_receive(struct dahdi_span *span)
|
|
{
|
|
unsigned long flags;
|
|
int ret;
|
|
local_irq_save(flags);
|
|
ret = _dahdi_receive(span);
|
|
local_irq_restore(flags);
|
|
return ret;
|
|
}
|
|
|
|
int _dahdi_transmit(struct dahdi_span *span);
|
|
|
|
/*! Prepare writechunk buffers on all channels for this span */
|
|
static inline int dahdi_transmit(struct dahdi_span *span)
|
|
{
|
|
unsigned long flags;
|
|
int ret;
|
|
local_irq_save(flags);
|
|
ret = _dahdi_transmit(span);
|
|
local_irq_restore(flags);
|
|
return ret;
|
|
}
|
|
|
|
/*! Abort the buffer currently being receive with event "event" */
|
|
void dahdi_hdlc_abort(struct dahdi_chan *ss, int event);
|
|
|
|
/*! Indicate to DAHDI that the end of frame was received and rotate buffers */
|
|
void dahdi_hdlc_finish(struct dahdi_chan *ss);
|
|
|
|
/*! Put a chunk of data into the current receive buffer */
|
|
void dahdi_hdlc_putbuf(struct dahdi_chan *ss, unsigned char *rxb, int bytes);
|
|
|
|
/*! Get a chunk of data from the current transmit buffer. Returns -1 if no data
|
|
* is left to send, 0 if there is data remaining in the current message to be sent
|
|
* and 1 if the currently transmitted message is now done */
|
|
int dahdi_hdlc_getbuf(struct dahdi_chan *ss, unsigned char *bufptr, unsigned int *size);
|
|
|
|
|
|
/*! Register a span. Returns 0 on success, -1 on failure. Pref-master is non-zero if
|
|
we should have preference in being the master device */
|
|
int dahdi_register(struct dahdi_span *span, int prefmaster);
|
|
|
|
/*! Allocate / free memory for a transcoder */
|
|
struct dahdi_transcoder *dahdi_transcoder_alloc(int numchans);
|
|
void dahdi_transcoder_free(struct dahdi_transcoder *ztc);
|
|
|
|
/*! \brief Register a transcoder */
|
|
int dahdi_transcoder_register(struct dahdi_transcoder *tc);
|
|
|
|
/*! \brief Unregister a transcoder */
|
|
int dahdi_transcoder_unregister(struct dahdi_transcoder *tc);
|
|
|
|
/*! \brief Alert a transcoder */
|
|
int dahdi_transcoder_alert(struct dahdi_transcoder_channel *ztc);
|
|
|
|
/*! \brief Unregister a span */
|
|
int dahdi_unregister(struct dahdi_span *span);
|
|
|
|
/*! \brief Gives a name to an LBO */
|
|
const char *dahdi_lboname(int lbo);
|
|
|
|
/*! \brief Tell DAHDI about changes in received rbs bits */
|
|
void dahdi_rbsbits(struct dahdi_chan *chan, int bits);
|
|
|
|
/*! \brief Tell DAHDI abou changes in received signalling */
|
|
void dahdi_hooksig(struct dahdi_chan *chan, enum dahdi_rxsig rxsig);
|
|
|
|
/*! \brief Queue an event on a channel */
|
|
void dahdi_qevent_nolock(struct dahdi_chan *chan, int event);
|
|
|
|
/*! \brief Queue an event on a channel, locking it first */
|
|
void dahdi_qevent_lock(struct dahdi_chan *chan, int event);
|
|
|
|
/*! \brief Notify a change possible change in alarm status on a channel */
|
|
void dahdi_alarm_channel(struct dahdi_chan *chan, int alarms);
|
|
|
|
/*! \brief Notify a change possible change in alarm status on a span */
|
|
void dahdi_alarm_notify(struct dahdi_span *span);
|
|
|
|
/*! \brief Initialize a tone state */
|
|
void dahdi_init_tone_state(struct dahdi_tone_state *ts, struct dahdi_tone *zt);
|
|
|
|
/*! \brief Get a given MF tone struct, suitable for dahdi_tone_nextsample. */
|
|
struct dahdi_tone *dahdi_mf_tone(const struct dahdi_chan *chan, char digit, int digitmode);
|
|
|
|
/* Echo cancel a receive and transmit chunk for a given channel. This
|
|
should be called by the low-level driver as close to the interface
|
|
as possible. ECHO CANCELLATION IS NO LONGER AUTOMATICALLY DONE
|
|
AT THE DAHDI LEVEL. dahdi_ec_chunk will not echo cancel if it should
|
|
not be doing so. rxchunk is modified in-place */
|
|
void _dahdi_ec_chunk(struct dahdi_chan *chan, unsigned char *rxchunk,
|
|
const unsigned char *txchunk);
|
|
|
|
static inline void dahdi_ec_chunk(struct dahdi_chan *ss, unsigned char *rxchunk,
|
|
const unsigned char *txchunk)
|
|
{
|
|
unsigned long flags;
|
|
local_irq_save(flags);
|
|
_dahdi_ec_chunk(ss, rxchunk, txchunk);
|
|
local_irq_restore(flags);
|
|
}
|
|
|
|
void _dahdi_ec_span(struct dahdi_span *span);
|
|
static inline void dahdi_ec_span(struct dahdi_span *span)
|
|
{
|
|
unsigned long flags;
|
|
local_irq_save(flags);
|
|
_dahdi_ec_span(span);
|
|
local_irq_restore(flags);
|
|
}
|
|
|
|
extern struct file_operations *dahdi_transcode_fops;
|
|
|
|
/* Don't use these directly -- they're not guaranteed to
|
|
be there. */
|
|
extern short __dahdi_mulaw[256];
|
|
extern short __dahdi_alaw[256];
|
|
#ifdef CONFIG_CALC_XLAW
|
|
u_char __dahdi_lineartoulaw(short a);
|
|
u_char __dahdi_lineartoalaw(short a);
|
|
#else
|
|
extern u_char __dahdi_lin2mu[16384];
|
|
extern u_char __dahdi_lin2a[16384];
|
|
#endif
|
|
|
|
/*! \brief Used by dynamic DAHDI -- don't use directly */
|
|
void dahdi_set_dynamic_ioctl(int (*func)(unsigned int cmd, unsigned long data));
|
|
|
|
/*! \brief Used by DAHDI HPEC module -- don't use directly */
|
|
void dahdi_set_hpec_ioctl(int (*func)(unsigned int cmd, unsigned long data));
|
|
|
|
/*! \brief Used privately by DAHDI. Avoid touching directly */
|
|
struct dahdi_tone {
|
|
int fac1;
|
|
int init_v2_1;
|
|
int init_v3_1;
|
|
|
|
int fac2;
|
|
int init_v2_2;
|
|
int init_v3_2;
|
|
|
|
int tonesamples; /*!< How long to play this tone before
|
|
going to the next (in samples) */
|
|
struct dahdi_tone *next; /* Next tone in this sequence */
|
|
|
|
int modulate;
|
|
};
|
|
|
|
static inline short dahdi_tone_nextsample(struct dahdi_tone_state *ts, struct dahdi_tone *zt)
|
|
{
|
|
/* follow the curves, return the sum */
|
|
|
|
int p;
|
|
|
|
ts->v1_1 = ts->v2_1;
|
|
ts->v2_1 = ts->v3_1;
|
|
ts->v3_1 = (zt->fac1 * ts->v2_1 >> 15) - ts->v1_1;
|
|
|
|
ts->v1_2 = ts->v2_2;
|
|
ts->v2_2 = ts->v3_2;
|
|
ts->v3_2 = (zt->fac2 * ts->v2_2 >> 15) - ts->v1_2;
|
|
|
|
/* Return top 16 bits */
|
|
if (!ts->modulate) return ts->v3_1 + ts->v3_2;
|
|
/* we are modulating */
|
|
p = ts->v3_2 - 32768;
|
|
if (p < 0) p = -p;
|
|
p = ((p * 9) / 10) + 1;
|
|
return (ts->v3_1 * p) >> 15;
|
|
|
|
}
|
|
|
|
static inline short dahdi_txtone_nextsample(struct dahdi_chan *ss)
|
|
{
|
|
/* follow the curves, return the sum */
|
|
|
|
ss->v1_1 = ss->v2_1;
|
|
ss->v2_1 = ss->v3_1;
|
|
ss->v3_1 = (ss->txtone * ss->v2_1 >> 15) - ss->v1_1;
|
|
return ss->v3_1;
|
|
}
|
|
|
|
/* These are the right functions to use. */
|
|
|
|
#define DAHDI_MULAW(a) (__dahdi_mulaw[(a)])
|
|
#define DAHDI_ALAW(a) (__dahdi_alaw[(a)])
|
|
#define DAHDI_XLAW(a,c) (c->xlaw[(a)])
|
|
|
|
#ifdef CONFIG_CALC_XLAW
|
|
#define DAHDI_LIN2MU(a) (__dahdi_lineartoulaw((a)))
|
|
#define DAHDI_LIN2A(a) (__dahdi_lineartoalaw((a)))
|
|
|
|
#define DAHDI_LIN2X(a,c) ((c)->lineartoxlaw((a)))
|
|
|
|
#else
|
|
/* Use tables */
|
|
#define DAHDI_LIN2MU(a) (__dahdi_lin2mu[((unsigned short)(a)) >> 2])
|
|
#define DAHDI_LIN2A(a) (__dahdi_lin2a[((unsigned short)(a)) >> 2])
|
|
|
|
/* Manipulate as appropriate for x-law */
|
|
#define DAHDI_LIN2X(a,c) ((c)->lin2x[((unsigned short)(a)) >> 2])
|
|
|
|
#endif /* CONFIG_CALC_XLAW */
|
|
|
|
/* Data formats for capabilities and frames alike (from Asterisk) */
|
|
/*! G.723.1 compression */
|
|
#define DAHDI_FORMAT_G723_1 (1 << 0)
|
|
/*! GSM compression */
|
|
#define DAHDI_FORMAT_GSM (1 << 1)
|
|
/*! Raw mu-law data (G.711) */
|
|
#define DAHDI_FORMAT_ULAW (1 << 2)
|
|
/*! Raw A-law data (G.711) */
|
|
#define DAHDI_FORMAT_ALAW (1 << 3)
|
|
/*! ADPCM (G.726, 32kbps) */
|
|
#define DAHDI_FORMAT_G726 (1 << 4)
|
|
/*! ADPCM (IMA) */
|
|
#define DAHDI_FORMAT_ADPCM (1 << 5)
|
|
/*! Raw 16-bit Signed Linear (8000 Hz) PCM */
|
|
#define DAHDI_FORMAT_SLINEAR (1 << 6)
|
|
/*! LPC10, 180 samples/frame */
|
|
#define DAHDI_FORMAT_LPC10 (1 << 7)
|
|
/*! G.729A audio */
|
|
#define DAHDI_FORMAT_G729A (1 << 8)
|
|
/*! SpeeX Free Compression */
|
|
#define DAHDI_FORMAT_SPEEX (1 << 9)
|
|
/*! iLBC Free Compression */
|
|
#define DAHDI_FORMAT_ILBC (1 << 10)
|
|
/*! Maximum audio format */
|
|
#define DAHDI_FORMAT_MAX_AUDIO (1 << 15)
|
|
/*! Maximum audio mask */
|
|
#define DAHDI_FORMAT_AUDIO_MASK ((1 << 16) - 1)
|
|
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 31)
|
|
#define KERN_CONT ""
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 26)
|
|
#ifndef clamp
|
|
#define clamp(x, low, high) min(max(low, x), high)
|
|
#endif
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 25)
|
|
|
|
/* Some distributions backported fatal_signal_pending so we'll use a macro to
|
|
* override the inline function definition. */
|
|
#define fatal_signal_pending(p) \
|
|
(signal_pending((p)) && sigismember(&(p)->pending.signal, SIGKILL))
|
|
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 22)
|
|
#include <linux/ctype.h>
|
|
/* A define of 'clamp_val' happened to be added in the patch
|
|
* linux-2.6-sata-prep-work-for-rhel5-3.patch kernel-2.6.spec that also
|
|
* backported support for strcasecmp to some later RHEL/Centos kernels.
|
|
* If you have an older kernel that breaks because strcasecmp is already
|
|
* defined, somebody out-smarted us. In that case, replace the line below
|
|
* with '#if 0' to get the code building, and file a bug report at
|
|
* https://issues.asterisk.org/ .
|
|
*/
|
|
#ifndef clamp_val
|
|
static inline int strcasecmp(const char *s1, const char *s2)
|
|
{
|
|
int c1, c2;
|
|
|
|
do {
|
|
c1 = tolower(*s1++);
|
|
c2 = tolower(*s2++);
|
|
} while (c1 == c2 && c1 != 0);
|
|
return c1 - c2;
|
|
}
|
|
#endif /* clamp_val */
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 18)
|
|
static inline void list_replace(struct list_head *old, struct list_head *new)
|
|
{
|
|
new->next = old->next;
|
|
new->next->prev = new;
|
|
new->prev = old->prev;
|
|
new->prev->next = new;
|
|
}
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 14)
|
|
#define kzalloc(a, b) kcalloc(1, a, b)
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 12)
|
|
#define synchronize_rcu() synchronize_kernel()
|
|
#define kasprintf dahdi_kasprintf
|
|
char *dahdi_kasprintf(gfp_t gfp, const char *fmt, ...);
|
|
#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 11)
|
|
#if !defined(HAVE_WAIT_FOR_COMPLETION_TIMEOUT)
|
|
static inline unsigned long
|
|
wait_for_completion_interruptible_timeout(struct completion *x,
|
|
unsigned long timeout)
|
|
{
|
|
/* There is a race condition here. If x->done is reset to 0
|
|
* before the call to wait_for_completion after this thread wakes.
|
|
*/
|
|
timeout = wait_event_interruptible_timeout(x->wait, x->done, timeout);
|
|
if (timeout)
|
|
wait_for_completion(x);
|
|
|
|
return timeout;
|
|
}
|
|
#endif
|
|
typedef u32 __bitwise pm_message_t;
|
|
#endif /* 2.6.11 */
|
|
#endif /* 2.6.12 */
|
|
#endif /* 2.6.14 */
|
|
#endif /* 2.6.18 */
|
|
#endif /* 2.6.22 */
|
|
#endif /* 2.6.25 */
|
|
#endif /* 2.6.26 */
|
|
#endif /* 2.6.31 */
|
|
|
|
#ifndef DEFINE_SPINLOCK
|
|
#define DEFINE_SPINLOCK(x) spinlock_t x = SPIN_LOCK_UNLOCKED
|
|
#endif
|
|
|
|
#ifndef DEFINE_SEMAPHORE
|
|
#define DEFINE_SEMAPHORE(name) \
|
|
struct semaphore name = __SEMAPHORE_INITIALIZER(name, 1)
|
|
#endif
|
|
|
|
#ifndef DEFINE_MUTEX
|
|
#define DEFINE_MUTEX DEFINE_SEMAPHORE
|
|
#define mutex_lock(_x) down(_x)
|
|
#define mutex_unlock(_x) up(_x)
|
|
#endif
|
|
|
|
#ifndef DEFINE_PCI_DEVICE_TABLE
|
|
#define DEFINE_PCI_DEVICE_TABLE(_x) \
|
|
const struct pci_device_id _x[] __devinitdata
|
|
#endif
|
|
|
|
#ifndef DMA_BIT_MASK
|
|
#define DMA_BIT_MASK(n) (((n) == 64) ? ~0ULL : ((1ULL<<(n))-1))
|
|
#endif
|
|
|
|
/* WARN_ONCE first showed up in the kernel in 2.6.27 but it may have been
|
|
* backported. */
|
|
#ifndef WARN_ONCE
|
|
#define WARN_ONCE(condition, format...) WARN_ON_ONCE(condition)
|
|
#endif
|
|
|
|
#define DAHDI_CTL 0
|
|
#define DAHDI_TRANSCODE 250
|
|
#define DAHDI_TIMER 253
|
|
#define DAHDI_CHANNEL 254
|
|
#define DAHDI_PSEUDO 255
|
|
|
|
/* prink-wrapper macros */
|
|
#define DAHDI_PRINTK(level, category, fmt, ...) \
|
|
printk(KERN_ ## level "%s%s-%s: " fmt, #level, category, \
|
|
THIS_MODULE->name, ## __VA_ARGS__)
|
|
#define span_printk(level, category, span, fmt, ...) \
|
|
printk(KERN_ ## level "%s%s-%s: span-%d: " fmt, #level, \
|
|
category, THIS_MODULE->name, (span)->spanno, ## __VA_ARGS__)
|
|
#define chan_printk(level, category, chan, fmt, ...) \
|
|
printk(KERN_ ## level "%s%s-%s: %d: " fmt, #level, \
|
|
category, THIS_MODULE->name, (chan)->channo, ## __VA_ARGS__)
|
|
#define dahdi_err(fmt, ...) DAHDI_PRINTK(ERR, "", fmt, ## __VA_ARGS__)
|
|
#define span_info(span, fmt, ...) span_printk(INFO, "", span, fmt, \
|
|
## __VA_ARGS__)
|
|
#define span_notice(span, fmt, ...) span_printk(NOTICE, "", span, fmt, \
|
|
## __VA_ARGS__)
|
|
#define span_err(span, fmt, ...) span_printk(ERR, "", span, fmt, \
|
|
## __VA_ARGS__)
|
|
#define chan_notice(chan, fmt, ...) chan_printk(NOTICE, "", chan, fmt, \
|
|
## __VA_ARGS__)
|
|
#define chan_err(chan, fmt, ...) chan_printk(ERR, "", chan, fmt, \
|
|
## __VA_ARGS__)
|
|
|
|
/* The dbg_* ones use a magical variable 'debug' and the user should be
|
|
* aware of that.
|
|
*/
|
|
#ifdef DAHDI_PRINK_MACROS_USE_debug
|
|
#ifndef BIT /* added in 2.6.24 */
|
|
#define BIT(i) (1UL << (i))
|
|
#endif
|
|
/* Standard debug bit values. Any module may define others. They must
|
|
* be of the form DAHDI_DBG_*
|
|
*/
|
|
#define DAHDI_DBG_GENERAL BIT(0)
|
|
#define DAHDI_DBG_DEVICES BIT(7) /* instantiation/destruction etc. */
|
|
#define dahdi_dbg(bits, fmt, ...) \
|
|
((void)((debug & (DAHDI_DBG_ ## bits)) && DAHDI_PRINTK(DEBUG, \
|
|
"-" #bits, "%s: " fmt, __func__, ## __VA_ARGS__)))
|
|
#define span_dbg(bits, span, fmt, ...) \
|
|
((void)((debug & (DAHDI_DBG_ ## bits)) && \
|
|
span_printk(DEBUG, "-" #bits, span, "%s: " \
|
|
fmt, __func__, ## __VA_ARGS__)))
|
|
#define chan_dbg(bits, chan, fmt, ...) \
|
|
((void)((debug & (DAHDI_DBG_ ## bits)) && \
|
|
chan_printk(DEBUG, "-" #bits, chan, \
|
|
"%s: " fmt, __func__, ## __VA_ARGS__)))
|
|
#endif /* DAHDI_PRINK_MACROS_USE_debug */
|
|
|
|
#endif /* _DAHDI_KERNEL_H */
|