callerid.h File Reference

CallerID (and other GR30) management and generation Includes code and algorithms from the Zapata library. More...

#include "asterisk/format.h"

Include dependency graph for callerid.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	AST_LIN2X(a)   ((ast_format_cmp(codec, ast_format_alaw) == AST_FORMAT_CMP_EQUAL) ? (AST_LIN2A(a)) : (AST_LIN2MU(a)))
#define	AST_PRES_ALLOWED   0x00
#define	AST_PRES_ALLOWED_NETWORK_NUMBER    (AST_PRES_ALLOWED | AST_PRES_NETWORK_NUMBER)
#define	AST_PRES_ALLOWED_USER_NUMBER_FAILED_SCREEN    (AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_FAILED_SCREEN)
#define	AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED    (AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_UNSCREENED)
#define	AST_PRES_ALLOWED_USER_NUMBER_PASSED_SCREEN    (AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_PASSED_SCREEN)
#define	AST_PRES_NETWORK_NUMBER   0x03
#define	AST_PRES_NUMBER_NOT_AVAILABLE    (AST_PRES_UNAVAILABLE | AST_PRES_NETWORK_NUMBER)
#define	AST_PRES_NUMBER_TYPE   0x03
#define	AST_PRES_PROHIB_NETWORK_NUMBER    (AST_PRES_RESTRICTED | AST_PRES_NETWORK_NUMBER)
#define	AST_PRES_PROHIB_USER_NUMBER_FAILED_SCREEN    (AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_FAILED_SCREEN)
#define	AST_PRES_PROHIB_USER_NUMBER_NOT_SCREENED    (AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_UNSCREENED)
#define	AST_PRES_PROHIB_USER_NUMBER_PASSED_SCREEN    (AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_PASSED_SCREEN)
#define	AST_PRES_RESERVED   0x60
#define	AST_PRES_RESTRICTED   0x20
#define	AST_PRES_RESTRICTION   0x60
#define	AST_PRES_UNAVAILABLE   0x40
#define	AST_PRES_USER_NUMBER_FAILED_SCREEN   0x02
#define	AST_PRES_USER_NUMBER_PASSED_SCREEN   0x01
#define	AST_PRES_USER_NUMBER_UNSCREENED   0x00
#define	AST_XLAW(a)   ((ast_format_cmp(codec, ast_format_alaw) == AST_FORMAT_CMP_EQUAL) ? (AST_ALAW(a)) : (AST_MULAW(a)))
#define	CID_MSGWAITING   (1 << 4)
#define	CID_MWI_TYPE_MDMF   0x01
#define	CID_MWI_TYPE_MDMF_FULL   0x02
#define	CID_MWI_TYPE_SDMF   0x00
#define	CID_NOMSGWAITING   (1 << 5)
#define	CID_PRIVATE_NAME   (1 << 0)
#define	CID_PRIVATE_NUMBER   (1 << 1)
#define	CID_QUALIFIER   (1 << 6)
#define	CID_SIG_BELL   1
#define	CID_SIG_DTMF   3
#define	CID_SIG_SMDI   5
#define	CID_SIG_V23   2
#define	CID_SIG_V23_JP   4
#define	CID_START_DTMF_NOALERT   4
#define	CID_START_POLARITY   2
#define	CID_START_POLARITY_IN   3
#define	CID_START_RING   1
#define	CID_TYPE_MDMF   0x01
#define	CID_TYPE_SDMF   0x00
#define	CID_UNKNOWN_NAME   (1 << 2)
#define	CID_UNKNOWN_NUMBER   (1 << 3)
#define	MAX_CALLERID_SIZE   32000
#define	PUT_AUDIO_SAMPLE(y)
#define	PUT_BYTE(a)
#define	PUT_CLID(byte)
#define	PUT_CLID_BAUD(bit)
#define	PUT_CLID_MARKMS

Typedefs
typedef struct callerid_state	CIDSTATE

Enumerations
enum	AST_CONNECTED_LINE_UPDATE_SOURCE {   AST_CONNECTED_LINE_UPDATE_SOURCE_UNKNOWN , AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER , AST_CONNECTED_LINE_UPDATE_SOURCE_DIVERSION , AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER ,   AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER_ALERTING }
	Connected line update source code. More...
enum	AST_REDIRECTING_REASON {   AST_REDIRECTING_REASON_UNKNOWN , AST_REDIRECTING_REASON_USER_BUSY , AST_REDIRECTING_REASON_NO_ANSWER , AST_REDIRECTING_REASON_UNAVAILABLE ,   AST_REDIRECTING_REASON_UNCONDITIONAL , AST_REDIRECTING_REASON_TIME_OF_DAY , AST_REDIRECTING_REASON_DO_NOT_DISTURB , AST_REDIRECTING_REASON_DEFLECTION ,   AST_REDIRECTING_REASON_FOLLOW_ME , AST_REDIRECTING_REASON_OUT_OF_ORDER , AST_REDIRECTING_REASON_AWAY , AST_REDIRECTING_REASON_CALL_FWD_DTE ,   AST_REDIRECTING_REASON_SEND_TO_VM }
	redirecting reason codes. More...

Functions
int	ast_callerid_callwaiting_full_generate (unsigned char *buf, const char *name, const char *number, const char *ddn, int redirecting, int pres, int qualifier, struct ast_format *codec)
	Generate Caller-ID spill but in a format suitable for Call Waiting(tm)'s Caller*ID(tm) More...
int	ast_callerid_callwaiting_full_tz_generate (unsigned char *buf, const char *name, const char *number, const char *ddn, int redirecting, int pres, int qualifier, struct ast_format *codec, const char *tz)
	Generate Caller-ID spill but in a format suitable for Call Waiting(tm)'s Caller*ID(tm) More...
int	ast_callerid_callwaiting_generate (unsigned char *buf, const char *name, const char *number, struct ast_format *codec)
	Generate Caller-ID spill but in a format suitable for Call Waiting(tm)'s Caller*ID(tm) More...
int	ast_callerid_full_generate (unsigned char *buf, const char *name, const char *number, const char *ddn, int redirecting, int pres, int qualifier, int format, struct ast_format *codec)
	Generate Caller-ID spill from the "callerid" field of asterisk (in e-mail address like format) More...
int	ast_callerid_full_tz_generate (unsigned char *buf, const char *name, const char *number, const char *ddn, int redirecting, int pres, int qualifier, int format, struct ast_format *codec, const char *tz)
	Generate Caller-ID spill from the "callerid" field of asterisk (in e-mail address like format) More...
int	ast_callerid_generate (unsigned char *buf, const char *name, const char *number, struct ast_format *codec)
	Generate Caller-ID spill from the "callerid" field of asterisk (in e-mail address like format) More...
char *	ast_callerid_merge (char *buf, int bufsiz, const char *name, const char *num, const char *unknown)
int	ast_callerid_parse (char *instr, char **name, char **location)
	Destructively parse inbuf into name and location (or number) More...
int	ast_callerid_split (const char *src, char *name, int namelen, char *num, int numlen)
int	ast_callerid_vmwi_generate (unsigned char *buf, int active, int type, struct ast_format *codec, const char *name, const char *number, int flags)
	Generate message waiting indicator. More...
const char *	ast_connected_line_source_describe (int data)
	Convert connected line update source value to explanatory string. More...
const char *	ast_connected_line_source_name (int data)
	Convert connected line update source value to text code. More...
int	ast_connected_line_source_parse (const char *data)
	Convert connected line update source text code to value (used in config file parsing) More...
const char *	ast_describe_caller_presentation (int data)
	Convert caller ID pres value to explanatory string. More...
int	ast_gen_cas (unsigned char *outbuf, int sas, int len, struct ast_format *codec)
	Generate a CAS (CPE Alert Signal) tone for 'n' samples. More...
int	ast_is_shrinkable_phonenumber (const char *exten)
	Check if a string consists only of digits and + # ( ) - . (meaning it can be cleaned with ast_shrink_phone_number) More...
int	ast_isphonenumber (const char *n)
	Check if a string consists only of digits and + #. More...
const char *	ast_named_caller_presentation (int data)
	Convert caller ID pres value to text code. More...
int	ast_parse_caller_presentation (const char *data)
	Convert caller ID text code to value (used in config file parsing) More...
const char *	ast_party_name_charset_describe (int data)
	Convert ast_party_name.char_set value to explanatory string. More...
int	ast_party_name_charset_parse (const char *data)
	Convert ast_party_name.char_set text code to value (used in config file parsing) More...
const char *	ast_party_name_charset_str (int data)
	Convert ast_party_name.char_set value to text code. More...
const char *	ast_redirecting_reason_describe (int data)
	Convert redirecting reason value to explanatory string. More...
const char *	ast_redirecting_reason_name (const struct ast_party_redirecting_reason *data)
	Convert redirecting reason value to text code. More...
int	ast_redirecting_reason_parse (const char *data)
	Convert redirecting reason text code to value (used in config file parsing) More...
void	ast_shrink_phone_number (char *n)
	Shrink a phone number in place to just digits (more accurately it just removes ()'s, .'s, and -'s... More...
int	callerid_feed (struct callerid_state *cid, unsigned char *ubuf, int samples, struct ast_format *codec)
	Read samples into the state machine. More...
int	callerid_feed_jp (struct callerid_state *cid, unsigned char *ubuf, int samples, struct ast_format *codec)
	Read samples into the state machine. More...
void	callerid_free (struct callerid_state *cid)
	This function frees callerid_state cid. More...
int	callerid_full_generate (unsigned char *buf, const char *number, const char *name, const char *ddn, int redirecting, int flags, int format, int callwaiting, struct ast_format *codec)
	Generates a CallerID FSK stream in ulaw format suitable for transmission. More...
int	callerid_full_tz_generate (unsigned char *buf, const char *number, const char *name, const char *ddn, int redirecting, int flags, int format, int callwaiting, struct ast_format *codec, const char *tz)
	Generates a CallerID FSK stream in ulaw format suitable for transmission. More...
int	callerid_generate (unsigned char *buf, const char *number, const char *name, int flags, int callwaiting, struct ast_format *codec)
	Generates a CallerID FSK stream in ulaw format suitable for transmission. More...
void	callerid_get (struct callerid_state *cid, char **number, char **name, int *flags)
	Extract info out of callerID state machine. Flags are listed above. More...
void	callerid_get_dtmf (char *cidstring, char *number, int *flags)
	Get and parse DTMF-based callerid. More...
void	callerid_get_with_redirecting (struct callerid_state *cid, char **name, char **number, int *flags, int *redirecting)
	Extract info out of callerID state machine. Flags are listed above. More...
static float	callerid_getcarrier (float *cr, float *ci, int bit)
void	callerid_init (void)
	CallerID Initialization. More...
struct callerid_state *	callerid_new (int cid_signalling)
	Create a callerID state machine. More...

Variables
float	cid_di [4]
float	cid_dr [4]
float	clidsb

Detailed Description

CallerID (and other GR30) management and generation Includes code and algorithms from the Zapata library.

Caller ID names and numbers

Definition in file callerid.h.

Macro Definition Documentation

AST_LIN2X

#define AST_LIN2X

(

a

)

((ast_format_cmp(codec, ast_format_alaw) == AST_FORMAT_CMP_EQUAL) ? (AST_LIN2A(a)) : (AST_LIN2MU(a)))

Definition at line 85 of file callerid.h.

AST_PRES_ALLOWED

#define AST_PRES_ALLOWED   0x00

Definition at line 432 of file callerid.h.

AST_PRES_ALLOWED_NETWORK_NUMBER

#define AST_PRES_ALLOWED_NETWORK_NUMBER    (AST_PRES_ALLOWED | AST_PRES_NETWORK_NUMBER)

Definition at line 446 of file callerid.h.

AST_PRES_ALLOWED_USER_NUMBER_FAILED_SCREEN

#define AST_PRES_ALLOWED_USER_NUMBER_FAILED_SCREEN    (AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_FAILED_SCREEN)

Definition at line 443 of file callerid.h.

AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED

#define AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED    (AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_UNSCREENED)

Definition at line 437 of file callerid.h.

AST_PRES_ALLOWED_USER_NUMBER_PASSED_SCREEN

#define AST_PRES_ALLOWED_USER_NUMBER_PASSED_SCREEN    (AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_PASSED_SCREEN)

Definition at line 440 of file callerid.h.

AST_PRES_NETWORK_NUMBER

#define AST_PRES_NETWORK_NUMBER   0x03

Definition at line 429 of file callerid.h.

AST_PRES_NUMBER_NOT_AVAILABLE

#define AST_PRES_NUMBER_NOT_AVAILABLE    (AST_PRES_UNAVAILABLE | AST_PRES_NETWORK_NUMBER)

Definition at line 461 of file callerid.h.

AST_PRES_NUMBER_TYPE

#define AST_PRES_NUMBER_TYPE   0x03

Definition at line 425 of file callerid.h.

AST_PRES_PROHIB_NETWORK_NUMBER

#define AST_PRES_PROHIB_NETWORK_NUMBER    (AST_PRES_RESTRICTED | AST_PRES_NETWORK_NUMBER)

Definition at line 458 of file callerid.h.

AST_PRES_PROHIB_USER_NUMBER_FAILED_SCREEN

#define AST_PRES_PROHIB_USER_NUMBER_FAILED_SCREEN    (AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_FAILED_SCREEN)

Definition at line 455 of file callerid.h.

AST_PRES_PROHIB_USER_NUMBER_NOT_SCREENED

#define AST_PRES_PROHIB_USER_NUMBER_NOT_SCREENED    (AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_UNSCREENED)

Definition at line 449 of file callerid.h.

AST_PRES_PROHIB_USER_NUMBER_PASSED_SCREEN

#define AST_PRES_PROHIB_USER_NUMBER_PASSED_SCREEN    (AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_PASSED_SCREEN)

Definition at line 452 of file callerid.h.

AST_PRES_RESERVED

#define AST_PRES_RESERVED   0x60

Definition at line 435 of file callerid.h.

AST_PRES_RESTRICTED

#define AST_PRES_RESTRICTED   0x20

Definition at line 433 of file callerid.h.

AST_PRES_RESTRICTION

#define AST_PRES_RESTRICTION   0x60

Definition at line 431 of file callerid.h.

AST_PRES_UNAVAILABLE

#define AST_PRES_UNAVAILABLE   0x40

Definition at line 434 of file callerid.h.

AST_PRES_USER_NUMBER_FAILED_SCREEN

#define AST_PRES_USER_NUMBER_FAILED_SCREEN   0x02

Definition at line 428 of file callerid.h.

AST_PRES_USER_NUMBER_PASSED_SCREEN

#define AST_PRES_USER_NUMBER_PASSED_SCREEN   0x01

Definition at line 427 of file callerid.h.

AST_PRES_USER_NUMBER_UNSCREENED

#define AST_PRES_USER_NUMBER_UNSCREENED   0x00

Definition at line 426 of file callerid.h.

AST_XLAW

#define AST_XLAW

(

a

)

((ast_format_cmp(codec, ast_format_alaw) == AST_FORMAT_CMP_EQUAL) ? (AST_ALAW(a)) : (AST_MULAW(a)))

Definition at line 86 of file callerid.h.

CID_MSGWAITING

#define CID_MSGWAITING   (1 << 4)

Definition at line 56 of file callerid.h.

CID_MWI_TYPE_MDMF

#define CID_MWI_TYPE_MDMF   0x01

MWI MDMF format – generate only MWI field

Definition at line 81 of file callerid.h.

CID_MWI_TYPE_MDMF_FULL

#define CID_MWI_TYPE_MDMF_FULL   0x02

MWI MDMF format – generate name, callerid, date and MWI fields

Definition at line 83 of file callerid.h.

CID_MWI_TYPE_SDMF

#define CID_MWI_TYPE_SDMF   0x00

MWI SDMF format

Definition at line 79 of file callerid.h.

CID_NOMSGWAITING

#define CID_NOMSGWAITING   (1 << 5)

Definition at line 57 of file callerid.h.

CID_PRIVATE_NAME

#define CID_PRIVATE_NAME   (1 << 0)

Definition at line 52 of file callerid.h.

CID_PRIVATE_NUMBER

#define CID_PRIVATE_NUMBER   (1 << 1)

Definition at line 53 of file callerid.h.

CID_QUALIFIER

#define CID_QUALIFIER   (1 << 6)

Definition at line 58 of file callerid.h.

CID_SIG_BELL

#define CID_SIG_BELL   1

Definition at line 60 of file callerid.h.

CID_SIG_DTMF

#define CID_SIG_DTMF   3

Definition at line 62 of file callerid.h.

CID_SIG_SMDI

#define CID_SIG_SMDI   5

Definition at line 64 of file callerid.h.

CID_SIG_V23

#define CID_SIG_V23   2

Definition at line 61 of file callerid.h.

CID_SIG_V23_JP

#define CID_SIG_V23_JP   4

Definition at line 63 of file callerid.h.

CID_START_DTMF_NOALERT

#define CID_START_DTMF_NOALERT   4

Definition at line 69 of file callerid.h.

CID_START_POLARITY

#define CID_START_POLARITY   2

Definition at line 67 of file callerid.h.

CID_START_POLARITY_IN

#define CID_START_POLARITY_IN   3

Definition at line 68 of file callerid.h.

CID_START_RING

#define CID_START_RING   1

Definition at line 66 of file callerid.h.

CID_TYPE_MDMF

#define CID_TYPE_MDMF   0x01

MDMF - name, number, etc.

Definition at line 75 of file callerid.h.

CID_TYPE_SDMF

#define CID_TYPE_SDMF   0x00

SDMF - number only

Definition at line 73 of file callerid.h.

CID_UNKNOWN_NAME

#define CID_UNKNOWN_NAME   (1 << 2)

Definition at line 54 of file callerid.h.

CID_UNKNOWN_NUMBER

#define CID_UNKNOWN_NUMBER   (1 << 3)

Definition at line 55 of file callerid.h.

MAX_CALLERID_SIZE

#define MAX_CALLERID_SIZE   32000

Definition at line 50 of file callerid.h.

PUT_AUDIO_SAMPLE

#define PUT_AUDIO_SAMPLE

(

y

)

Value:

    do { \
    int __sample_idx = (short)(rint(8192.0 * (y))); \
    *(buf++) = AST_LIN2X(__sample_idx); \
    bytes++; \
} while(0)

Definition at line 391 of file callerid.h.

PUT_BYTE

#define PUT_BYTE

(

a

)

Value:

    do { \
    *(buf++) = (a); \
    bytes++; \
} while(0)

Definition at line 386 of file callerid.h.

PUT_CLID

#define PUT_CLID

(

byte

)

Definition at line 412 of file callerid.h.

PUT_CLID_BAUD

#define PUT_CLID_BAUD

(

bit

)

Definition at line 403 of file callerid.h.

PUT_CLID_MARKMS

#define PUT_CLID_MARKMS

Value:

    do { \
    int __clid_x; \
    for (__clid_x=0;__clid_x<8;__clid_x++) \
        PUT_AUDIO_SAMPLE(callerid_getcarrier(&cr, &ci, 1)); \
} while(0)

Definition at line 397 of file callerid.h.

Typedef Documentation

CIDSTATE

typedef struct callerid_state CIDSTATE

Definition at line 90 of file callerid.h.

Enumeration Type Documentation

AST_CONNECTED_LINE_UPDATE_SOURCE

enum AST_CONNECTED_LINE_UPDATE_SOURCE

Connected line update source code.

Enumerator
AST_CONNECTED_LINE_UPDATE_SOURCE_UNKNOWN	Update for unknown reason (May be interpreted to mean from answer)
AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER	Update from normal call answering
AST_CONNECTED_LINE_UPDATE_SOURCE_DIVERSION	Update from call diversion (Deprecated, use REDIRECTING updates instead.)
AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER	Update from call transfer(active) (Party has already answered)
AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER_ALERTING	Update from call transfer(alerting) (Party has not answered yet)

Definition at line 550 of file callerid.h.

                                      {
    /*! Update for unknown reason (May be interpreted to mean from answer) */
    AST_CONNECTED_LINE_UPDATE_SOURCE_UNKNOWN,
    /*! Update from normal call answering */
    AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER,
    /*! Update from call diversion (Deprecated, use REDIRECTING updates instead.) */
    AST_CONNECTED_LINE_UPDATE_SOURCE_DIVERSION,
    /*! Update from call transfer(active) (Party has already answered) */
    AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER,
    /*! Update from call transfer(alerting) (Party has not answered yet) */
    AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER_ALERTING
};

AST_REDIRECTING_REASON

enum AST_REDIRECTING_REASON

redirecting reason codes.

This list attempts to encompass redirecting reasons as defined by several channel technologies.

Enumerator
AST_REDIRECTING_REASON_UNKNOWN
AST_REDIRECTING_REASON_USER_BUSY
AST_REDIRECTING_REASON_NO_ANSWER
AST_REDIRECTING_REASON_UNAVAILABLE
AST_REDIRECTING_REASON_UNCONDITIONAL
AST_REDIRECTING_REASON_TIME_OF_DAY
AST_REDIRECTING_REASON_DO_NOT_DISTURB
AST_REDIRECTING_REASON_DEFLECTION
AST_REDIRECTING_REASON_FOLLOW_ME
AST_REDIRECTING_REASON_OUT_OF_ORDER
AST_REDIRECTING_REASON_AWAY
AST_REDIRECTING_REASON_CALL_FWD_DTE
AST_REDIRECTING_REASON_SEND_TO_VM

Definition at line 498 of file callerid.h.

                            {
    AST_REDIRECTING_REASON_UNKNOWN,
    AST_REDIRECTING_REASON_USER_BUSY,
    AST_REDIRECTING_REASON_NO_ANSWER,
    AST_REDIRECTING_REASON_UNAVAILABLE,
    AST_REDIRECTING_REASON_UNCONDITIONAL,
    AST_REDIRECTING_REASON_TIME_OF_DAY,
    AST_REDIRECTING_REASON_DO_NOT_DISTURB,
    AST_REDIRECTING_REASON_DEFLECTION,
    AST_REDIRECTING_REASON_FOLLOW_ME,
    AST_REDIRECTING_REASON_OUT_OF_ORDER,
    AST_REDIRECTING_REASON_AWAY,
    AST_REDIRECTING_REASON_CALL_FWD_DTE,           /* This is something defined in Q.931, and no I don't know what it means */
    AST_REDIRECTING_REASON_SEND_TO_VM,
};

Function Documentation

ast_callerid_callwaiting_full_generate()

int ast_callerid_callwaiting_full_generate	(	unsigned char *	buf,
		const char *	name,
		const char *	number,
		const char *	ddn,
		int	redirecting,
		int	pres,
		int	qualifier,
		struct ast_format *	codec
	)

Generate Caller-ID spill but in a format suitable for Call Waiting(tm)'s Caller*ID(tm)

See also

ast_callerid_generate() for other details

Definition at line 1253 of file callerid.c.

{
    /* Type II Caller ID (CWCID) only uses MDMF, so format isn't an argument */
    return __ast_callerid_generate(buf, name, number, ddn, redirecting, pres, qualifier, CID_TYPE_MDMF, 1, codec, NULL);
}

References __ast_callerid_generate(), buf, CID_TYPE_MDMF, name, and NULL.

Referenced by my_send_callerid().

ast_callerid_callwaiting_full_tz_generate()

int ast_callerid_callwaiting_full_tz_generate	(	unsigned char *	buf,
		const char *	name,
		const char *	number,
		const char *	ddn,
		int	redirecting,
		int	pres,
		int	qualifier,
		struct ast_format *	codec,
		const char *	tz
	)

Generate Caller-ID spill but in a format suitable for Call Waiting(tm)'s Caller*ID(tm)

Parameters

tz	TZ-format time zone for date/time (NULL for system default)

See also

ast_callerid_generate() for other details

Definition at line 1266 of file callerid.c.

{
    /* Type II Caller ID (CWCID) only uses MDMF, so format isn't an argument */
    return __ast_callerid_generate(buf, name, number, ddn, redirecting, pres, qualifier, CID_TYPE_MDMF, 1, codec, tz);
}

References __ast_callerid_generate(), buf, CID_TYPE_MDMF, name, and tz.

ast_callerid_callwaiting_generate()

int ast_callerid_callwaiting_generate	(	unsigned char *	buf,
		const char *	name,
		const char *	number,
		struct ast_format *	codec
	)

Generate Caller-ID spill but in a format suitable for Call Waiting(tm)'s Caller*ID(tm)

See also

ast_callerid_generate() for other details

Definition at line 1242 of file callerid.c.

{
    return __ast_callerid_generate(buf, name, number, "", -1, 0, 0, CID_TYPE_MDMF, 1, codec, NULL);
}

References __ast_callerid_generate(), buf, CID_TYPE_MDMF, name, and NULL.

Referenced by send_cwcidspill().

ast_callerid_full_generate()

int ast_callerid_full_generate	(	unsigned char *	buf,
		const char *	name,
		const char *	number,
		const char *	ddn,
		int	redirecting,
		int	pres,
		int	qualifier,
		int	format,
		struct ast_format *	codec
	)

Generate Caller-ID spill from the "callerid" field of asterisk (in e-mail address like format)

Parameters

buf	buffer for output samples. See callerid_generate() for details regarding buffer.
name	Caller-ID Name
number	Caller-ID Number
ddn	Dialable Directory Number (or NULL)
redirecting	Redirecting Reason (-1 if N/A)
pres	Presentation (0 for default)
qualifier	Call Qualifier (0 for no, 1 for yes)
format	Message Format
codec	Asterisk codec (either AST_FORMAT_ALAW or AST_FORMAT_ULAW)

Like ast_callerid_generate but with additional parameters.

Definition at line 1247 of file callerid.c.

{
    return __ast_callerid_generate(buf, name, number, ddn, redirecting, pres, qualifier, format, 0, codec, NULL);
}

References __ast_callerid_generate(), buf, name, and NULL.

Referenced by my_send_callerid().

ast_callerid_full_tz_generate()

int ast_callerid_full_tz_generate	(	unsigned char *	buf,
		const char *	name,
		const char *	number,
		const char *	ddn,
		int	redirecting,
		int	pres,
		int	qualifier,
		int	format,
		struct ast_format *	codec,
		const char *	tz
	)

Generate Caller-ID spill from the "callerid" field of asterisk (in e-mail address like format)

Parameters

buf	buffer for output samples. See callerid_generate() for details regarding buffer.
name	Caller-ID Name
number	Caller-ID Number
ddn	Dialable Directory Number (or NULL)
redirecting	Redirecting Reason (-1 if N/A)
pres	Presentation (0 for default)
qualifier	Call Qualifier (0 for no, 1 for yes)
format	Message Format
codec	Asterisk codec (either AST_FORMAT_ALAW or AST_FORMAT_ULAW)
tz	TZ-format time zone name to use for date/time (NULL for system default)

Like ast_callerid_generate but with additional parameters.

Definition at line 1260 of file callerid.c.

{
    return __ast_callerid_generate(buf, name, number, ddn, redirecting, pres, qualifier, format, 0, codec, tz);
}

References __ast_callerid_generate(), buf, name, and tz.

ast_callerid_generate()

int ast_callerid_generate	(	unsigned char *	buf,
		const char *	name,
		const char *	number,
		struct ast_format *	codec
	)

Generate Caller-ID spill from the "callerid" field of asterisk (in e-mail address like format)

Parameters

buf	buffer for output samples. See callerid_generate() for details regarding buffer.
name	Caller-ID Name
number	Caller-ID Number
codec	Asterisk codec (either AST_FORMAT_ALAW or AST_FORMAT_ULAW)

Acts like callerid_generate except uses an asterisk format callerid string.

Definition at line 1237 of file callerid.c.

{
    return __ast_callerid_generate(buf, name, number, "", -1, 0, 0, CID_TYPE_MDMF, 0, codec, NULL);
}

References __ast_callerid_generate(), buf, CID_TYPE_MDMF, name, and NULL.

ast_callerid_merge()

char * ast_callerid_merge	(	char *	buf,
		int	bufsiz,
		const char *	name,
		const char *	num,
		const char *	unknown
	)

Definition at line 1273 of file callerid.c.

{
    if (!unknown)
        unknown = "<unknown>";
    if (name && num) {
        char name_buf[128];
 
        ast_escape_quoted(name, name_buf, sizeof(name_buf));
        snprintf(buf, bufsiz, "\"%s\" <%s>", name_buf, num);
    } else if (name) {
        ast_copy_string(buf, name, bufsiz);
    } else if (num) {
        ast_copy_string(buf, num, bufsiz);
    } else {
        ast_copy_string(buf, unknown, bufsiz);
    }
    return buf;
}

References ast_copy_string(), ast_escape_quoted(), buf, name, and unknown.

Referenced by caller_id_to_str(), cdr_object_create_public_records(), cdr_object_format_property(), cli_show_channel(), cli_show_subscriptions_detail(), handle_cli_iax2_show_peer(), launch_monitor_thread(), leave_voicemail(), prep_email_sub_vars(), and sip_subscription_to_ami().

ast_callerid_parse()

int ast_callerid_parse	(	char *	instr,
		char **	name,
		char **	location
	)

Destructively parse inbuf into name and location (or number)

Parses callerid stream from inbuf and changes into useable form, outputted in name and location.

Parameters

instr	buffer of callerid stream (in audio form) to be parsed. Warning, data in buffer is changed.
name	address of a pointer-to-char for the name value of the stream.
location	address of a pointer-to-char for the phone number value of the stream.

Note

XXX 'name' is not parsed consistently e.g. we have input location name " foo bar " <123> 123 ' foo bar ' (with spaces around) " foo bar " NULL 'foo bar' (without spaces around) The parsing of leading and trailing space/quotes should be more consistent.

Return values

0	on success
-1	on failure

Definition at line 1162 of file callerid.c.

{
    char *ls;
    char *le;
    char *name_start;
    char *instr;
    int quotes_stripped = 0;
 
    /* Handle surrounding quotes */
    input_str = ast_strip(input_str);
    instr = ast_strip_quoted(input_str, "\"", "\"");
    if (instr != input_str) {
        quotes_stripped = 1;
    }
 
    /* Try "name" <location> format or name <location> format or with a missing > */
    if ((ls = strrchr(instr, '<'))) {
        if ((le = strrchr(ls, '>'))) {
            *le = '\0'; /* location found, trim off the brackets */
        }
        *ls = '\0';
        *location = ls + 1; /* and this is the result */
 
        name_start = ast_strip_quoted(instr, "\"", "\"");
    } else {    /* no valid brackets */
        char tmp[256];
 
        ast_copy_string(tmp, instr, sizeof(tmp));
        ast_shrink_phone_number(tmp);
        if (!quotes_stripped && ast_isphonenumber(tmp)) {   /* Assume it's just a location */
            name_start = NULL;
            strcpy(instr, tmp); /* safe, because tmp will always be the same size or smaller than instr */
            *location = instr;
        } else { /* Assume it's just a name. */
            *location = NULL;
            name_start = ast_strip_quoted(instr, "\"", "\"");
        }
    }
 
    if (name_start) {
        ast_unescape_quoted(name_start);
    }
    *name = name_start;
    return 0;
}

References ast_copy_string(), ast_isphonenumber(), ast_shrink_phone_number(), ast_strip(), ast_strip_quoted(), ast_unescape_quoted(), name, NULL, and tmp().

Referenced by action_originate(), adsi_message(), advanced_options(), ari_channels_handle_originate_with_id(), ast_callerid_split(), ast_privacy_check(), ast_privacy_set(), AST_TEST_DEFINE(), dial_exec_full(), handle_setcallerid(), play_message_callerid(), and unistim_new().

ast_callerid_split()

int ast_callerid_split	(	const char *	src,
		char *	name,
		int	namelen,
		char *	num,
		int	numlen
	)

Definition at line 1292 of file callerid.c.

{
    char *tmp;
    char *l = NULL, *n = NULL;
 
    tmp = ast_strdupa(buf);
    ast_callerid_parse(tmp, &n, &l);
    if (n)
        ast_copy_string(name, n, namelen);
    else
        name[0] = '\0';
    if (l) {
        ast_shrink_phone_number(l);
        ast_copy_string(num, l, numlen);
    } else
        num[0] = '\0';
    return 0;
}

References ast_callerid_parse(), ast_copy_string(), ast_shrink_phone_number(), ast_strdupa, buf, name, NULL, and tmp().

Referenced by build_peer(), build_user(), caller_id_handler(), callerid_read(), disa_exec(), msg_create_from_file(), parse_line(), party_id_write(), prep_email_sub_vars(), process_dahdi(), and store_callerid().

ast_callerid_vmwi_generate()

int ast_callerid_vmwi_generate	(	unsigned char *	buf,
		int	active,
		int	type,
		struct ast_format *	codec,
		const char *	name,
		const char *	number,
		int	flags
	)

Generate message waiting indicator.

Parameters

buf
active	The message indicator state – either 0 no messages in mailbox or 1 messages in mailbox
type	Format of message (any of CID_MWI_TYPE_*)
codec
name
number
flags

See also

callerid_generate() for more info as it uses the same encoding

Version

1.6.1 changed mdmf parameter to type, added name, number and flags for caller id message generation

Definition at line 952 of file callerid.c.

{
    char msg[256];
    int len = 0;
    int sum;
    int x;
    int bytes = 0;
    float cr = 1.0;
    float ci = 0.0;
    float scont = 0.0;
 
    if (type == CID_MWI_TYPE_MDMF_FULL) {
        /* MDMF Message waiting with date, number, name and MWI parameter */
        msg[0] = 0x82;
 
        /* put date, number info at the right place */
        len = callerid_genmsg(msg+2, sizeof(msg)-2, number, name, flags, CID_TYPE_MDMF, "", -1, NULL);
 
        /* length of MDMF CLI plus Message Waiting Structure */
        msg[1] = len+3;
 
        /* Go to the position to write to */
        len = len+2;
 
        /* "Message Waiting Parameter" */
        msg[len++] = 0x0b;
        /* Length of IE is one */
        msg[len++] = 1;
        /* Active or not */
        if (active)
            msg[len++] = 0xff;
        else
            msg[len++] = 0x00;
 
    } else if (type == CID_MWI_TYPE_MDMF) {
        /* MDMF Message waiting only */
        /* same as above except that the we only put MWI parameter */
        msg[len++] = 0x82;
        /* Length is 3 */
        msg[len++] = 3;
        /* IE is "Message Waiting Parameter" */
        msg[len++] = 0x0b;
        /* Length of IE is one */
        msg[len++] = 1;
        /* Active or not */
        if (active)
            msg[len++] = 0xff;
        else
            msg[len++] = 0x00;
    } else {
        /* SDMF Message waiting */
        msg[len++] = 0x6;
        /* Length is 3 */
        msg[len++] = 3;
        if (active) {
            msg[len++] = 0x42;
            msg[len++] = 0x42;
            msg[len++] = 0x42;
        } else {
            msg[len++] = 0x6f;
            msg[len++] = 0x6f;
            msg[len++] = 0x6f;
        }
    }
    sum = 0;
    for (x = 0; x < len; x++)
        sum += msg[x];
    sum = (256 - (sum & 255));
    msg[len++] = sum;
    /* Wait a half a second */
    for (x = 0; x < 4000; x++)
        PUT_BYTE(0x7f);
    /* Transmit 30 0x55's (looks like a square wave) for channel seizure */
    for (x = 0; x < 30; x++)
        PUT_CLID(0x55);
    /* Send 170ms of callerid marks */
    for (x = 0; x < 170; x++)
        PUT_CLID_MARKMS;
    for (x = 0; x < len; x++) {
        PUT_CLID(msg[x]);
    }
    /* Send 50 more ms of marks */
    for (x = 0; x < 50; x++)
        PUT_CLID_MARKMS;
    return bytes;
}

References callerid_genmsg(), CID_MWI_TYPE_MDMF, CID_MWI_TYPE_MDMF_FULL, CID_TYPE_MDMF, len(), name, NULL, PUT_BYTE, PUT_CLID, PUT_CLID_MARKMS, and type.

Referenced by mwi_send_init().

ast_connected_line_source_describe()

const char * ast_connected_line_source_describe

(

int

data

)

Convert connected line update source value to explanatory string.

Since

1.8

Parameters

data	AST_CONNECTED_LINE_UPDATE_SOURCE from callerid.h

Returns

string for human presentation

Definition at line 1492 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(connected_line_source_types); ++index) {
        if (connected_line_source_types[index].value == data) {
            return connected_line_source_types[index].description;
        }
    }
 
    return "not-known";
}

References ARRAY_LEN, connected_line_source_types, ast_value_translation::description, and value.

ast_connected_line_source_name()

const char * ast_connected_line_source_name

(

int

data

)

Convert connected line update source value to text code.

Since

1.8

Parameters

data	AST_CONNECTED_LINE_UPDATE_SOURCE from callerid.h

Returns

string for config file

Definition at line 1505 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(connected_line_source_types); ++index) {
        if (connected_line_source_types[index].value == data) {
            return connected_line_source_types[index].name;
        }
    }
 
    return "not-known";
}

References ARRAY_LEN, connected_line_source_types, ast_value_translation::name, and value.

Referenced by connectedline_read().

ast_connected_line_source_parse()

int ast_connected_line_source_parse

(

const char *

data

)

Convert connected line update source text code to value (used in config file parsing)

Since

1.8

Parameters

data	text string from config file

Return values

AST_CONNECTED_LINE_UPDATE_SOURCE	from callerid.h
-1	if not in table

Definition at line 1479 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(connected_line_source_types); ++index) {
        if (!strcasecmp(connected_line_source_types[index].name, data)) {
            return connected_line_source_types[index].value;
        }
    }
 
    return -1;
}

References ARRAY_LEN, connected_line_source_types, name, and ast_value_translation::value.

Referenced by connectedline_write().

ast_describe_caller_presentation()

const char * ast_describe_caller_presentation

(

int

data

)

Convert caller ID pres value to explanatory string.

Parameters

data	AST_PRES_ value from callerid.h

Returns

string for human presentation

Definition at line 1364 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(pres_types); ++index) {
        if (pres_types[index].value == data) {
            return pres_types[index].description;
        }
    }
 
    return "unknown";
}

References ARRAY_LEN, ast_value_translation::description, pres_types, and value.

Referenced by ast_json_party_id(), channel_callerid(), channel_new_callerid(), json_party_name(), and json_party_number().

ast_gen_cas()

int ast_gen_cas	(	unsigned char *	outbuf,
		int	sas,
		int	len,
		struct ast_format *	codec
	)

Generate a CAS (CPE Alert Signal) tone for 'n' samples.

Parameters

outbuf	Allocated buffer for data. Must be at least 2400 bytes unless no SAS is desired
sas	Non-zero if CAS should be preceeded by SAS
len	How many samples to generate.
codec	Which codec (AST_FORMAT_ALAW or AST_FORMAT_ULAW)

Return values

-1	on error (if len is less than 2400)
0	on success

Definition at line 271 of file callerid.c.

{
    int pos = 0;
    int saslen = 2400;
    float cr1 = 1.0;
    float ci1 = 0.0;
    float cr2 = 1.0;
    float ci2 = 0.0;
 
    if (sendsas) {
        if (len < saslen)
            return -1;
        gen_tone(outbuf, saslen, codec, sasdr, sasdi, &cr1, &ci1);
        len -= saslen;
        pos += saslen;
        cr2 = cr1;
        ci2 = ci1;
    }
    gen_tones(outbuf + pos, len, codec, casdr1, casdi1, casdr2, casdi2, &cr1, &ci1, &cr2, &ci2);
    return 0;
}

References casdi1, casdi2, casdr1, casdr2, gen_tone(), gen_tones(), len(), callerid_state::pos, sasdi, and sasdr.

Referenced by __adsi_transmit_messages(), dahdi_callwait(), and my_callwait().

ast_is_shrinkable_phonenumber()

int ast_is_shrinkable_phonenumber

(

const char *

exten

)

Check if a string consists only of digits and + # ( ) - . (meaning it can be cleaned with ast_shrink_phone_number)

Parameters

exten

The extension (or URI) to be checked.

Return values

1	if exten is valid AST shrinkable phone number
0	if not

Definition at line 1157 of file callerid.c.

{
    return ast_is_valid_string(exten, "0123456789*#+()-.");
}

References ast_is_valid_string().

Referenced by ari_channels_handle_originate_with_id().

ast_isphonenumber()

int ast_isphonenumber

(

const char *

n

)

Check if a string consists only of digits and + #.

Parameters

n	number to be checked.

Return values

0	if n is a number
1	if not

Definition at line 1152 of file callerid.c.

{
    return ast_is_valid_string(n, "0123456789*#+");
}

References ast_is_valid_string().

Referenced by ast_callerid_parse(), and hfp_parse_clip().

ast_named_caller_presentation()

const char * ast_named_caller_presentation

(

int

data

)

Convert caller ID pres value to text code.

Parameters

data	AST_PRES_ value from callerid.h

Returns

string for config file

Definition at line 1382 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(pres_types); ++index) {
        if (pres_types[index].value == data) {
            return pres_types[index].name;
        }
    }
 
    return "unknown";
}

References ARRAY_LEN, ast_value_translation::name, pres_types, and value.

Referenced by __ast_callerid_generate(), caller_id_privacy_to_str(), party_id_read(), party_name_read(), party_number_read(), and redirecting_read().

ast_parse_caller_presentation()

int ast_parse_caller_presentation

(

const char *

data

)

Convert caller ID text code to value (used in config file parsing)

Parameters

data	text string from config file

Return values

value	AST_PRES_ from callerid.h
-1	if not in table

Definition at line 1343 of file callerid.c.

{
    int index;
    if (!data) {
        return -1;
    }
 
    for (index = 0; index < ARRAY_LEN(pres_types); ++index) {
        if (!strcasecmp(pres_types[index].name, data)) {
            return pres_types[index].value;
        }
    }
 
    return -1;
}

References ARRAY_LEN, name, pres_types, and ast_value_translation::value.

Referenced by caller_id_privacy_handler(), dial_exec_full(), party_id_write(), party_name_write(), party_number_write(), and redirecting_write().

ast_party_name_charset_describe()

const char * ast_party_name_charset_describe

(

int

data

)

Convert ast_party_name.char_set value to explanatory string.

Since

1.8

Parameters

data	AST_PARTY_CHAR_SET from channel.h

Returns

string for human presentation

Definition at line 1547 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(party_name_charset_tbl); ++index) {
        if (party_name_charset_tbl[index].value == data) {
            return party_name_charset_tbl[index].description;
        }
    }
 
    return "not-known";
}

References ARRAY_LEN, ast_value_translation::description, party_name_charset_tbl, and value.

Referenced by json_party_name().

ast_party_name_charset_parse()

int ast_party_name_charset_parse

(

const char *

data

)

Convert ast_party_name.char_set text code to value (used in config file parsing)

Since

1.8

Parameters

data	text string from config file

Return values

AST_PARTY_CHAR_SET	from channel.h
-1	if not in table

Definition at line 1534 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(party_name_charset_tbl); ++index) {
        if (!strcasecmp(party_name_charset_tbl[index].name, data)) {
            return party_name_charset_tbl[index].value;
        }
    }
 
    return -1;
}

References ARRAY_LEN, name, party_name_charset_tbl, and ast_value_translation::value.

Referenced by party_name_write().

ast_party_name_charset_str()

const char * ast_party_name_charset_str

(

int

data

)

Convert ast_party_name.char_set value to text code.

Since

1.8

Parameters

data	AST_PARTY_CHAR_SET from channel.h

Returns

string for config file

Definition at line 1560 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(party_name_charset_tbl); ++index) {
        if (party_name_charset_tbl[index].value == data) {
            return party_name_charset_tbl[index].name;
        }
    }
 
    return "not-known";
}

References ARRAY_LEN, ast_value_translation::name, party_name_charset_tbl, and value.

Referenced by party_name_read().

ast_redirecting_reason_describe()

const char * ast_redirecting_reason_describe

(

int

data

)

Convert redirecting reason value to explanatory string.

Since

1.8

Parameters

data	Q931_REDIRECTING_REASON from callerid.h

Returns

string for human presentation

Definition at line 1436 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(redirecting_reason_types); ++index) {
        if (redirecting_reason_types[index].value == data) {
            return redirecting_reason_types[index].description ?: "Redirecting reason alias-bug";
        }
    }
 
    return "not-known";
}

References ARRAY_LEN, ast_value_translation::description, redirecting_reason_types, and value.

Referenced by __ast_callerid_generate().

ast_redirecting_reason_name()

const char * ast_redirecting_reason_name

(

const struct ast_party_redirecting_reason *

data

)

Convert redirecting reason value to text code.

Since

1.8

Parameters

data	ast_party_redirecting_reason structure from channel.h

Returns

string for config file

Definition at line 1449 of file callerid.c.

{
    int index;
 
    if (!ast_strlen_zero(data->str)) {
        /* Use this string if it has been set. Otherwise, use the table. */
        return data->str;
    }
 
    for (index = 0; index < ARRAY_LEN(redirecting_reason_types); ++index) {
        if (redirecting_reason_types[index].value == data->code) {
            return redirecting_reason_types[index].name;
        }
    }
 
    return "not-known";
}

References ARRAY_LEN, ast_strlen_zero(), ast_party_redirecting_reason::code, ast_value_translation::name, redirecting_reason_types, ast_party_redirecting_reason::str, and value.

Referenced by my_get_callerid(), and redirecting_read().

ast_redirecting_reason_parse()

int ast_redirecting_reason_parse

(

const char *

data

)

Convert redirecting reason text code to value (used in config file parsing)

Since

1.8

Parameters

data	text string from config file

Return values

Q931_REDIRECTING_REASON	from callerid.h
-1	if not in table

Definition at line 1423 of file callerid.c.

{
    int index;
 
    for (index = 0; index < ARRAY_LEN(redirecting_reason_types); ++index) {
        if (!strcasecmp(redirecting_reason_types[index].name, data)) {
            return redirecting_reason_types[index].value;
        }
    }
 
    return -1;
}

References ARRAY_LEN, name, redirecting_reason_types, and ast_value_translation::value.

Referenced by redirecting_write(), and set_redirecting_reason().

ast_shrink_phone_number()

void ast_shrink_phone_number

(

char *

n

)

Shrink a phone number in place to just digits (more accurately it just removes ()'s, .'s, and -'s...

Parameters

n	The number to be stripped/shrunk

Shrink a phone number in place to just digits (more accurately it just removes ()'s, .'s, and -'s...

Remove '(', ' ', ')', non-trailing '.', and '-' not in square brackets. Basically, remove anything that could be invalid in a pattern.

Definition at line 1101 of file callerid.c.

{
    int x, y = 0;
    int bracketed = 0;
 
    for (x = 0; n[x]; x++) {
        switch (n[x]) {
        case '[':
            bracketed++;
            n[y++] = n[x];
            break;
        case ']':
            bracketed--;
            n[y++] = n[x];
            break;
        case '-':
            if (bracketed)
                n[y++] = n[x];
            break;
        case '.':
            if (!n[x+1])
                n[y++] = n[x];
            break;
        default:
            /* ignore parenthesis and whitespace */
            if (!strchr("( )", n[x]))
                n[y++] = n[x];
        }
    }
    n[y] = '\0';
}

Referenced by __analog_ss_thread(), action_originate(), analog_ss_thread(), ari_channels_handle_originate_with_id(), ast_callerid_parse(), ast_callerid_split(), ast_privacy_check(), ast_privacy_set(), check_access(), handle_setcallerid(), pbx_load_config(), setup_privacy_args(), and write_metadata().

callerid_feed()

int callerid_feed	(	struct callerid_state *	cid,
		unsigned char *	ubuf,
		int	samples,
		struct ast_format *	codec
	)

Read samples into the state machine.

Parameters

cid	Which state machine to act upon
ubuf	containing your samples
samples	number of samples contained within the buffer.
codec	which codec (AST_FORMAT_ALAW or AST_FORMAT_ULAW)

Send received audio to the Caller*ID demodulator.

Return values

-1	on error
0	for "needs more samples"
1	if the CallerID spill reception is complete.

Definition at line 570 of file callerid.c.

{
    int mylen = len;
    int olen;
    int b = 'X';
    int res;
    int x;
    short *buf;
 
    buf = ast_alloca(2 * len + cid->oldlen);
 
    memcpy(buf, cid->oldstuff, cid->oldlen);
    mylen += cid->oldlen/2;
 
    for (x = 0; x < len; x++)
        buf[x+cid->oldlen/2] = AST_XLAW(ubuf[x]);
    while (mylen >= 160) {
        olen = mylen;
        res = fsk_serial(&cid->fskd, buf, &mylen, &b);
        if (mylen < 0) {
            ast_log(LOG_ERROR, "No start bit found in fsk data.\n");
            return -1;
        }
        buf += (olen - mylen);
        if (res < 0) {
            ast_log(LOG_NOTICE, "fsk_serial failed\n");
            return -1;
        }
        if (res == 1) {
            if (b > 0xff) {
                if (cid->sawflag != 5) {
                    /* Ignore invalid bytes */
                    continue;
                }
                /*
                 * We can tolerate an error on the checksum character since the
                 * checksum character is the last character in the message and
                 * it validates the message.
                 *
                 * Remove character error flags.
                 * Bit 8 : Parity error
                 * Bit 9 : Framing error
                 */
                b &= 0xff;
            }
            switch (cid->sawflag) {
            case 0: /* Look for flag */
                if (b == 'U')
                    cid->sawflag = 2;
                break;
            case 2: /* Get lead-in */
                if ((b == 0x04) || (b == 0x80) || (b == 0x06) || (b == 0x82)) {
                    cid->type = b;
                    cid->sawflag = 3;
                    cid->cksum = b;
                }
                break;
            case 3: /* Get length */
                /* Not a lead in.  We're ready  */
                cid->sawflag = 4;
                cid->len = b;
                cid->pos = 0;
                cid->cksum += b;
                break;
            case 4: /* Retrieve message */
                if (cid->pos >= 128) {
                    ast_log(LOG_WARNING, "Caller ID too long???\n");
                    return -1;
                }
                cid->rawdata[cid->pos++] = b;
                cid->len--;
                cid->cksum += b;
                if (!cid->len) {
                    cid->rawdata[cid->pos] = '\0';
                    cid->sawflag = 5;
                }
                break;
            case 5: /* Check checksum */
                if ((b + cid->cksum) & 0xff) {
                    ast_log(LOG_NOTICE, "Caller*ID failed checksum\n");
                    /* Try again */
                    cid->sawflag = 0;
                    break;
                }
 
                cid->number[0] = '\0';
                cid->name[0] = '\0';
                /* Update flags */
                cid->flags = 0;
                cid->redirecting = 0;
                /* If we get this far we're fine.  */
                if ((cid->type == 0x80) || (cid->type == 0x82)) {
                    /* MDMF */
                    ast_debug(6, "%s Caller*ID spill received\n", cid->type == 0x80 ? "MDMF" : "MDMF Message Waiting");
                    /* Go through each element and process */
                    for (x = 0; x < cid->pos;) {
                        int param = cid->rawdata[x++];
                        ast_debug(7, "Caller*ID parameter %d (%s), length %d\n", param, mdmf_param_name(param), cid->rawdata[x]);
                        switch (param) {
                        case 1:
                            /* Date/Time... in theory we could synchronize our time according to the Caller*ID,
                             * but it would be silly for a telephone switch to do that. */
                            break;
                        /* For MDMF spills, we would expect to get an "O" or a "P"
                         * for paramter 4 (or 8) as opposed to 2 (or 7) to indicate
                         * a blocked or out of area presentation.
                         * However, for SDMF, which doesn't have parameters,
                         * there is no differentiation, which is why the logic below
                         * just checks the number and name field and here, we use the same
                         * parsing logic for both parameters. Technically, it would be wrong
                         * to receive an 'O' or 'P' for parameters 2 or 7 and treat it as
                         * the reason for absence fields, but that is not likely to happen,
                         * and if it did, could possibly be buggy Caller ID generation we would
                         * want to treat the same way, anyways.
                         *
                         * The "Dialable Directory Number" is how the number would be called back.
                         * Asterisk doesn't really have a corresponding thing for this,
                         * so log it if we get it for debugging, but treat the same otherwise.
                         */
                        case 3: /* Dialable Directory Number / Number (for Zebble) */
                            ast_debug(3, "Caller*ID Dialable Directory Number: '%.*s'\n", cid->rawdata[x], cid->rawdata + x + 1);
                            /* Fall through */
                        case 2: /* Number */
                        case 4: /* Reason for Absence of Number. */
                            res = cid->rawdata[x];
                            if (res > 32) {
                                ast_log(LOG_NOTICE, "Truncating long caller ID number from %d bytes to 32\n", cid->rawdata[x]);
                                res = 32;
                            }
                            if (ast_strlen_zero(cid->number)) {
                                memcpy(cid->number, cid->rawdata + x + 1, res);
                                /* Null terminate */
                                cid->number[res] = '\0';
                            }
                            break;
                        case 5: /* Reason for Redirection */
                            res = cid->rawdata[x];
                            if (res != 1) {
                                ast_log(LOG_WARNING, "Redirecting parameter length is %d?\n", res);
                                break;
                            }
                            switch (*(cid->rawdata + x + 1)) {
                            case 0x1:
                                cid->redirecting = AST_REDIRECTING_REASON_USER_BUSY;
                                break;
                            case 0x2:
                                cid->redirecting = AST_REDIRECTING_REASON_NO_ANSWER;
                                break;
                            case 0x3:
                                cid->redirecting = AST_REDIRECTING_REASON_UNCONDITIONAL;
                                break;
                            case 0x4:
                                cid->redirecting = AST_REDIRECTING_REASON_CALL_FWD_DTE;
                                break;
                            case 0x5:
                                cid->redirecting = AST_REDIRECTING_REASON_DEFLECTION;
                                break;
                            default:
                                ast_log(LOG_WARNING, "Redirecting reason is %02x?\n", *(cid->rawdata + x + 1));
                                break;
                            }
                            break;
                        case 6: /* Stentor Call Qualifier (ie. Long Distance call) */
                            res = cid->rawdata[x];
                            if (res == 1 && *(cid->rawdata + x + 1) == 'L') {
                                cid->flags |= CID_QUALIFIER;
                            } else if (res >= 1) {
                                ast_debug(2, "Invalid value (len %d) received for Call Qualifier: '%c'\n", res, *(cid->rawdata + x + 1));
                            }
                            break;
                        case 7: /* Name */
                        case 8: /* Reason for Absence of Name */
                            res = cid->rawdata[x];
                            if (res > 32) {
                                ast_log(LOG_NOTICE, "Truncating long caller ID name from %d bytes to 32\n", cid->rawdata[x]);
                                res = 32;
                            }
                            memcpy(cid->name, cid->rawdata + x + 1, res);
                            cid->name[res] = '\0';
                            break;
                        case 11: /* Message Waiting */
                            res = cid->rawdata[x + 1];
                            if (res)
                                cid->flags |= CID_MSGWAITING;
                            else
                                cid->flags |= CID_NOMSGWAITING;
                            break;
                        case 17: /* UK: Call type, 1=Voice Call, 2=Ringback when free, 129=Message waiting  */
                        case 19: /* UK: Network message system status (Number of messages waiting) */
                        case 22: /* Something French */
                            break;
                        default:
                            ast_log(LOG_NOTICE, "Unknown IE %d\n", cid->rawdata[x - 1]);
                        }
                        res = cid->rawdata[x];
                        if (0 > res){   /* Negative offset in the CID Spill */
                            ast_log(LOG_NOTICE, "IE %d has bad field length of %d at offset %d\n", cid->rawdata[x-1], cid->rawdata[x], x);
                            /* Try again */
                            cid->sawflag = 0;
                            break;  /* Exit the loop */
                        }
                        x += cid->rawdata[x];
                        x++;
                    }
                } else if (cid->type == 0x6) {
                    /* VMWI SDMF */
                    ast_debug(6, "VMWI SDMF Caller*ID spill received\n");
                    if (cid->rawdata[2] == 0x42) {
                        cid->flags |= CID_MSGWAITING;
                    } else if (cid->rawdata[2] == 0x6f) {
                        cid->flags |= CID_NOMSGWAITING;
                    }
                } else {
                    /* SDMF */
                    ast_debug(6, "SDMF Caller*ID spill received\n");
                    ast_copy_string(cid->number, cid->rawdata + 8, sizeof(cid->number));
                }
                if (!strcmp(cid->number, "P")) {
                    ast_debug(6, "Caller*ID number is private\n");
                    strcpy(cid->number, "");
                    cid->flags |= CID_PRIVATE_NUMBER;
                } else if (!strcmp(cid->number, "O")) {
                    ast_debug(6, "Caller*ID number is out of area\n");
                    strcpy(cid->number, "");
                    cid->flags |= CID_UNKNOWN_NUMBER;
                } else if (ast_strlen_zero(cid->number)) {
                    ast_debug(6, "No Caller*ID number provided, and no reason provided for its absence\n");
                    strcpy(cid->number, "");
                    cid->flags |= CID_UNKNOWN_NUMBER;
                } else {
                    ast_debug(6, "Caller*ID number is '%s'\n", cid->number);
                }
                if (!strcmp(cid->name, "P")) {
                    ast_debug(6, "Caller*ID name is private\n");
                    strcpy(cid->name, "");
                    cid->flags |= CID_PRIVATE_NAME;
                } else if (!strcmp(cid->name, "O")) {
                    ast_debug(6, "Caller*ID name is out of area\n");
                    strcpy(cid->name, "");
                    cid->flags |= CID_UNKNOWN_NAME;
                } else if (ast_strlen_zero(cid->name)) {
                    ast_debug(6, "No Caller*ID name provided, and no reason provided for its absence\n");
                    strcpy(cid->name, "");
                    cid->flags |= CID_UNKNOWN_NAME;
                } else {
                    ast_debug(6, "Caller*ID name is '%s'\n", cid->name);
                }
                return 1;
                break;
            default:
                ast_log(LOG_ERROR, "Dunno what to do with a digit in sawflag %d\n", cid->sawflag);
            }
        }
    }
    if (mylen) {
        memcpy(cid->oldstuff, buf, mylen * 2);
        cid->oldlen = mylen * 2;
    } else
        cid->oldlen = 0;
 
    return 0;
}

References ast_alloca, ast_copy_string(), ast_debug, ast_log, AST_REDIRECTING_REASON_CALL_FWD_DTE, AST_REDIRECTING_REASON_DEFLECTION, AST_REDIRECTING_REASON_NO_ANSWER, AST_REDIRECTING_REASON_UNCONDITIONAL, AST_REDIRECTING_REASON_USER_BUSY, ast_strlen_zero(), AST_XLAW, b, buf, CID_MSGWAITING, CID_NOMSGWAITING, CID_PRIVATE_NAME, CID_PRIVATE_NUMBER, CID_QUALIFIER, CID_UNKNOWN_NAME, CID_UNKNOWN_NUMBER, callerid_state::cksum, callerid_state::flags, fsk_serial(), callerid_state::fskd, len(), callerid_state::len, LOG_ERROR, LOG_NOTICE, LOG_WARNING, mdmf_param_name(), callerid_state::name, callerid_state::number, callerid_state::oldlen, callerid_state::oldstuff, callerid_state::pos, callerid_state::rawdata, callerid_state::redirecting, callerid_state::sawflag, and callerid_state::type.

Referenced by analog_ss_thread(), mwi_thread(), and my_get_callerid().

callerid_feed_jp()

int callerid_feed_jp	(	struct callerid_state *	cid,
		unsigned char *	ubuf,
		int	samples,
		struct ast_format *	codec
	)

Read samples into the state machine.

Parameters

cid	Which state machine to act upon
ubuf	containing your samples
samples	number of samples contained within the buffer.
codec	which codec (AST_FORMAT_ALAW or AST_FORMAT_ULAW)

Send received audio to the Caller*ID demodulator (for japanese style lines).

Return values

-1	on error
0	for "needs more samples"
1	if the CallerID spill reception is complete.

Definition at line 316 of file callerid.c.

{
    int mylen = len;
    int olen;
    int b = 'X';
    int b2;
    int res;
    int x;
    short *buf;
 
    buf = ast_alloca(2 * len + cid->oldlen);
 
    memcpy(buf, cid->oldstuff, cid->oldlen);
    mylen += cid->oldlen / 2;
 
    for (x = 0; x < len; x++)
        buf[x+cid->oldlen/2] = AST_XLAW(ubuf[x]);
 
    while (mylen >= 160) {
        b = b2 = 0;
        olen = mylen;
        res = fsk_serial(&cid->fskd, buf, &mylen, &b);
 
        if (mylen < 0) {
            ast_log(LOG_ERROR, "No start bit found in fsk data.\n");
            return -1;
        }
 
        buf += (olen - mylen);
 
        if (res < 0) {
            ast_log(LOG_NOTICE, "fsk_serial failed\n");
            return -1;
        }
 
        if (res == 1) {
            b2 = b;
            b  &= 0x7f;
 
            /* crc checksum calculation */
            if (cid->sawflag > 1)
                cid->crc = calc_crc(cid->crc, (unsigned char) b2);
 
            /* Ignore invalid bytes */
            if (b > 0xff)
                continue;
 
            /* skip DLE if needed */
            if (cid->sawflag > 0) {
                if (cid->sawflag != 5 && cid->skipflag == 0 && b == 0x10) {
                    cid->skipflag = 1 ;
                    continue ;
                }
            }
            if (cid->skipflag == 1)
                cid->skipflag = 0 ;
 
            /* caller id retrieval */
            switch (cid->sawflag) {
            case 0: /* DLE */
                if (b == 0x10) {
                    cid->sawflag = 1;
                    cid->skipflag = 0;
                    cid->crc = 0;
                }
                break;
            case 1: /* SOH */
                if (b == 0x01)
                    cid->sawflag = 2;
                break ;
            case 2: /* HEADER */
                if (b == 0x07)
                    cid->sawflag = 3;
                break;
            case 3: /* STX */
                if (b == 0x02)
                    cid->sawflag = 4;
                break;
            case 4: /* SERVICE TYPE */
                if (b == 0x40)
                    cid->sawflag = 5;
                break;
            case 5: /* Frame Length */
                cid->sawflag = 6;
                break;
            case 6: /* NUMBER TYPE */
                cid->sawflag = 7;
                cid->pos = 0;
                cid->rawdata[cid->pos++] = b;
                break;
            case 7: /* NUMBER LENGTH */
                cid->sawflag = 8;
                cid->len = b;
                if ((cid->len+2) >= sizeof(cid->rawdata)) {
                    ast_log(LOG_WARNING, "too long caller id string\n") ;
                    return -1;
                }
                cid->rawdata[cid->pos++] = b;
                break;
            case 8: /* Retrieve message */
                cid->rawdata[cid->pos++] = b;
                cid->len--;
                if (cid->len<=0) {
                    cid->rawdata[cid->pos] = '\0';
                    cid->sawflag = 9;
                }
                break;
            case 9: /* ETX */
                cid->sawflag = 10;
                break;
            case 10: /* CRC Checksum 1 */
                cid->sawflag = 11;
                break;
            case 11: /* CRC Checksum 2 */
                cid->sawflag = 12;
                if (cid->crc != 0) {
                    ast_log(LOG_WARNING, "crc checksum error\n") ;
                    return -1;
                }
                /* extract caller id data */
                for (x = 0; x < cid->pos;) {
                    switch (cid->rawdata[x++]) {
                    case 0x02: /* caller id  number */
                        cid->number[0] = '\0';
                        cid->name[0] = '\0';
                        cid->flags = 0;
                        res = cid->rawdata[x++];
                        ast_copy_string(cid->number, &cid->rawdata[x], res+1);
                        x += res;
                        break;
                    case 0x21: /* additional information */
                        /* length */
                        x++;
                        /* number type */
                        switch (cid->rawdata[x]) {
                        case 0x00: /* unknown */
                        case 0x01: /* international number */
                        case 0x02: /* domestic number */
                        case 0x03: /* network */
                        case 0x04: /* local call */
                        case 0x06: /* short dial number */
                        case 0x07: /* reserved */
                        default:   /* reserved */
                            ast_debug(2, "cid info:#1=%X\n", (unsigned)cid->rawdata[x]);
                            break ;
                        }
                        x++;
                        /* numbering plan octed 4 */
                        x++;
                        /* numbering plan octed 5 */
                        switch (cid->rawdata[x]) {
                        case 0x00: /* unknown */
                        case 0x01: /* recommendation E.164 ISDN */
                        case 0x03: /* recommendation X.121 */
                        case 0x04: /* telex dial plan */
                        case 0x08: /* domestic dial plan */
                        case 0x09: /* private dial plan */
                        case 0x05: /* reserved */
                        default:   /* reserved */
                            ast_debug(2, "cid info:#2=%X\n", (unsigned)cid->rawdata[x]);
                            break ;
                        }
                        x++;
                        break ;
                    case 0x04: /* no callerid reason */
                        /* length */
                        x++;
                        /* no callerid reason code */
                        switch (cid->rawdata[x]) {
                        case 'P': /* caller id denied by user */
                        case 'O': /* service not available */
                        case 'C': /* pay phone */
                        case 'S': /* service congested */
                            cid->flags |= CID_UNKNOWN_NUMBER;
                            ast_debug(2, "no cid reason:%c\n", cid->rawdata[x]);
                            break ;
                        }
                        x++;
                        break ;
                    case 0x09: /* dialed number */
                        /* length */
                        res = cid->rawdata[x++];
                        /* dialed number */
                        x += res;
                        break ;
                    case 0x22: /* dialed number additional information */
                        /* length */
                        x++;
                        /* number type */
                        switch (cid->rawdata[x]) {
                        case 0x00: /* unknown */
                        case 0x01: /* international number */
                        case 0x02: /* domestic number */
                        case 0x03: /* network */
                        case 0x04: /* local call */
                        case 0x06: /* short dial number */
                        case 0x07: /* reserved */
                        default:   /* reserved */
                            if (DEBUG_ATLEAST(2))
                                ast_log(LOG_NOTICE, "did info:#1=%X\n", (unsigned)cid->rawdata[x]);
                            break ;
                        }
                        x++;
                        /* numbering plan octed 4 */
                        x++;
                        /* numbering plan octed 5 */
                        switch (cid->rawdata[x]) {
                        case 0x00: /* unknown */
                        case 0x01: /* recommendation E.164 ISDN */
                        case 0x03: /* recommendation X.121 */
                        case 0x04: /* telex dial plan */
                        case 0x08: /* domestic dial plan */
                        case 0x09: /* private dial plan */
                        case 0x05: /* reserved */
                        default:   /* reserved */
                            ast_debug(2, "did info:#2=%X\n", (unsigned)cid->rawdata[x]);
                            break ;
                        }
                        x++;
                        break ;
                    }
                }
                return 1;
                break;
            default:
                ast_log(LOG_ERROR, "invalid value in sawflag %d\n", cid->sawflag);
            }
        }
    }
    if (mylen) {
        memcpy(cid->oldstuff, buf, mylen * 2);
        cid->oldlen = mylen * 2;
    } else
        cid->oldlen = 0;
 
    return 0;
}

References ast_alloca, ast_copy_string(), ast_debug, ast_log, AST_XLAW, b, buf, calc_crc(), CID_UNKNOWN_NUMBER, callerid_state::crc, DEBUG_ATLEAST, callerid_state::flags, fsk_serial(), callerid_state::fskd, len(), callerid_state::len, LOG_ERROR, LOG_NOTICE, LOG_WARNING, callerid_state::name, callerid_state::number, callerid_state::oldlen, callerid_state::oldstuff, callerid_state::pos, callerid_state::rawdata, callerid_state::sawflag, and callerid_state::skipflag.

Referenced by analog_ss_thread(), and my_get_callerid().

callerid_free()

void callerid_free

(

struct callerid_state *

cid

)

This function frees callerid_state cid.

Parameters

cid	This is the callerid_state state machine to free

Definition at line 833 of file callerid.c.

{
    ast_free(cid);
}

References ast_free.

Referenced by analog_ss_thread(), mwi_thread(), and my_stop_cid_detect().

callerid_full_generate()

int callerid_full_generate	(	unsigned char *	buf,
		const char *	number,
		const char *	name,
		const char *	ddn,
		int	redirecting,
		int	flags,
		int	format,
		int	callwaiting,
		struct ast_format *	codec
	)

Generates a CallerID FSK stream in ulaw format suitable for transmission.

Parameters

buf	Buffer to use. If "buf" is supplied, it will use that buffer instead of allocating its own. "buf" must be at least 32000 bytes in size of you want to be sure you don't have an overrun.
number	Use NULL for no number or "P" for "private"
name	name to be used
ddn	Dialable Directory Number (or NULL)
redirecting	Redirecting reason
flags	passed flags
format	Message format
callwaiting	callwaiting flag
codec	– either AST_FORMAT_ULAW or AST_FORMAT_ALAW

This function creates a stream of callerid (a callerid spill) data in ulaw format.

Returns

It returns the size (in bytes) of the data (if it returns a size of 0, there is probably an error)

Definition at line 1044 of file callerid.c.

{
    /* Default time zone is NULL (system time zone) */
    return callerid_full_tz_generate(buf, number, name, ddn, redirecting, flags, format, callwaiting, codec, NULL);
}

References buf, callerid_full_tz_generate(), name, and NULL.

Referenced by callerid_generate().

callerid_full_tz_generate()

int callerid_full_tz_generate	(	unsigned char *	buf,
		const char *	number,
		const char *	name,
		const char *	ddn,
		int	redirecting,
		int	flags,
		int	format,
		int	callwaiting,
		struct ast_format *	codec,
		const char *	tz
	)

Generates a CallerID FSK stream in ulaw format suitable for transmission.

Parameters

buf	Buffer to use. If "buf" is supplied, it will use that buffer instead of allocating its own. "buf" must be at least 32000 bytes in size of you want to be sure you don't have an overrun.
number	Use NULL for no number or "P" for "private"
name	name to be used
ddn	Dialable Directory Number (or NULL)
redirecting	Redirecting reason
flags	passed flags
format	Message format
callwaiting	callwaiting flag
codec	– either AST_FORMAT_ULAW or AST_FORMAT_ALAW
tz	TZ-format time zone to use for date/time (NULL for system default)

This function creates a stream of callerid (a callerid spill) data in ulaw format.

Returns

It returns the size (in bytes) of the data (if it returns a size of 0, there is probably an error)

Definition at line 1051 of file callerid.c.

{
    int bytes = 0;
    int x, sum;
    int len;
 
    /* Initial carriers (real/imaginary) */
    float cr = 1.0;
    float ci = 0.0;
    float scont = 0.0;
    char msg[256];
    len = callerid_genmsg(msg, sizeof(msg), number, name, flags, format, ddn, redirecting, tz);
    if (!callwaiting) {
        /* Wait a half a second */
        for (x = 0; x < 4000; x++)
            PUT_BYTE(0x7f);
        /* Transmit 30 0x55's (looks like a square wave) for channel seizure */
        for (x = 0; x < 30; x++)
            PUT_CLID(0x55);
    }
    /* Send 150ms of callerid marks */
    for (x = 0; x < 150; x++)
        PUT_CLID_MARKMS;
    /* Send 0x80 indicating MDMF format */
    PUT_CLID(0x80);
    /* Put length of whole message */
    PUT_CLID(len);
    sum = 0x80 + strlen(msg);
    /* Put each character of message and update checksum */
    for (x = 0; x < len; x++) {
        PUT_CLID(msg[x]);
        sum += msg[x];
    }
    /* Send 2's compliment of sum */
    PUT_CLID(256 - (sum & 255));
 
    /* Send 50 more ms of marks */
    for (x = 0; x < 50; x++)
        PUT_CLID_MARKMS;
 
    return bytes;
}

References callerid_genmsg(), len(), name, PUT_BYTE, PUT_CLID, PUT_CLID_MARKMS, and tz.

Referenced by __ast_callerid_generate(), and callerid_full_generate().

callerid_generate()

int callerid_generate	(	unsigned char *	buf,
		const char *	number,
		const char *	name,
		int	flags,
		int	callwaiting,
		struct ast_format *	codec
	)

Generates a CallerID FSK stream in ulaw format suitable for transmission.

Parameters

buf	Buffer to use. If "buf" is supplied, it will use that buffer instead of allocating its own. "buf" must be at least 32000 bytes in size of you want to be sure you don't have an overrun.
number	Use NULL for no number or "P" for "private"
name	name to be used
flags	passed flags
callwaiting	callwaiting flag
codec	– either AST_FORMAT_ULAW or AST_FORMAT_ALAW

This function creates a stream of callerid (a callerid spill) data in ulaw format.

Returns

It returns the size (in bytes) of the data (if it returns a size of 0, there is probably an error)

Definition at line 1039 of file callerid.c.

{
    return callerid_full_generate(buf, number, name, NULL, -1, flags, CID_TYPE_MDMF, callwaiting, codec);
}

References buf, callerid_full_generate(), CID_TYPE_MDMF, name, and NULL.

callerid_get()

void callerid_get	(	struct callerid_state *	cid,
		char **	number,
		char **	name,
		int *	flags
	)

Extract info out of callerID state machine. Flags are listed above.

Parameters

cid	Callerid state machine to act upon
number	Pass the address of a pointer-to-char (will contain the phone number)
name	Pass the address of a pointer-to-char (will contain the name)
flags	Pass the address of an int variable (will contain the various callerid flags - presentation flags and call qualifier)

This function extracts a callerid string out of a callerid_state state machine. If no number is found, *number will be set to NULL. Likewise for the name. Flags can contain any of the following: CID_PRIVATE_NAME, CID_PRIVATE_NUMBER, CID_UNKNOWN_NAME, CID_UNKNOWN_NUMBER, CID_MSGWAITING, CID_NOMSGWAITING, CID_QUALIFIER

Definition at line 205 of file callerid.c.

{
    int redirecting;
    return callerid_get_with_redirecting(cid, name, number, flags, &redirecting);
}

References callerid_get_with_redirecting(), callerid_state::flags, name, and callerid_state::redirecting.

Referenced by analog_ss_thread(), and mwi_thread().

callerid_get_dtmf()

void callerid_get_dtmf	(	char *	cidstring,
		char *	number,
		int *	flags
	)

Get and parse DTMF-based callerid.

Parameters

cidstring	The actual transmitted string.
number	The cid number is returned here.
flags	The cid flags are returned here.

Definition at line 211 of file callerid.c.

{
    int i;
    int code;
 
    /* "Clear" the number-buffer. */
    number[0] = 0;
 
    if (strlen(cidstring) < 2) {
        ast_debug(1, "No cid detected\n");
        *flags = CID_UNKNOWN_NUMBER;
        return;
    }
 
    /* Detect protocol and special types */
    if (cidstring[0] == 'B') {
        /* Handle special codes */
        code = atoi(&cidstring[1]);
        if (code == 0)
            *flags = CID_UNKNOWN_NUMBER;
        else if (code == 10)
            *flags = CID_PRIVATE_NUMBER;
        else
            ast_debug(1, "Unknown DTMF code %d\n", code);
    } else if (cidstring[0] == 'D' && cidstring[2] == '#') {
        /* .DK special code */
        if (cidstring[1] == '1')
            *flags = CID_PRIVATE_NUMBER;
        if (cidstring[1] == '2' || cidstring[1] == '3')
            *flags = CID_UNKNOWN_NUMBER;
    } else if (cidstring[0] == 'D' || cidstring[0] == 'A') {
        /* "Standard" callerid */
        for (i = 1; i < strlen(cidstring); i++) {
            if (cidstring[i] == 'C' || cidstring[i] == '#')
                break;
            if (isdigit(cidstring[i]))
                number[i-1] = cidstring[i];
            else
                ast_debug(1, "Unknown CID digit '%c'\n",
                    cidstring[i]);
        }
        number[i-1] = 0;
    } else if (isdigit(cidstring[0])) {
        /* It begins with a digit, so we parse it as a number and hope
         * for the best */
        ast_log(LOG_WARNING, "Couldn't detect start-character. CID "
            "parsing might be unreliable\n");
        for (i = 0; i < strlen(cidstring); i++) {
            if (isdigit(cidstring[i]))
                number[i] = cidstring[i];
            else
                break;
        }
        number[i] = 0;
    } else {
        ast_debug(1, "Unknown CID protocol, start digit '%c'\n", cidstring[0]);
        *flags = CID_UNKNOWN_NUMBER;
    }
}

References ast_debug, ast_log, CID_PRIVATE_NUMBER, CID_UNKNOWN_NUMBER, callerid_state::flags, and LOG_WARNING.

Referenced by __analog_ss_thread(), and analog_ss_thread().

callerid_get_with_redirecting()

void callerid_get_with_redirecting	(	struct callerid_state *	cid,
		char **	name,
		char **	number,
		int *	flags,
		int *	redirecting
	)

Extract info out of callerID state machine. Flags are listed above.

Parameters

	cid	Callerid state machine to act upon
[out]	number	Pass the address of a pointer-to-char (will contain the phone number)
[out]	name	Pass the address of a pointer-to-char (will contain the name)
[out]	flags	Pass the address of an int variable (will contain the various callerid flags)
[out]	redirecting	Pass the address of an int variable (will contain the redirecting reason, if received - presentation flags and call qualifier)

This function extracts a callerid string out of a callerid_state state machine. If no number is found, *number will be set to NULL. Likewise for the name. Flags can contain any of the following: CID_PRIVATE_NAME, CID_PRIVATE_NUMBER, CID_UNKNOWN_NAME, CID_UNKNOWN_NUMBER, CID_MSGWAITING, CID_NOMSGWAITING, CID_QUALIFIER

Definition at line 189 of file callerid.c.

{
    *flags = cid->flags;
    if (cid->flags & (CID_UNKNOWN_NAME | CID_PRIVATE_NAME)) {
        *name = NULL;
    } else {
        *name = cid->name;
    }
    if (cid->flags & (CID_UNKNOWN_NUMBER | CID_PRIVATE_NUMBER)) {
        *number = NULL;
    } else {
        *number = cid->number;
    }
    *redirecting = cid->redirecting;
}

References CID_PRIVATE_NAME, CID_PRIVATE_NUMBER, CID_UNKNOWN_NAME, CID_UNKNOWN_NUMBER, callerid_state::flags, callerid_state::name, name, NULL, callerid_state::number, and callerid_state::redirecting.

Referenced by callerid_get(), and my_get_callerid().

callerid_getcarrier()

static float callerid_getcarrier ( float *  cr, float *  ci, int  bit  )

inlinestatic

Definition at line 372 of file callerid.h.

{
    /* Move along.  There's nothing to see here... */
    float t;
    t = *cr * cid_dr[bit] - *ci * cid_di[bit];
    *ci = *cr * cid_di[bit] + *ci * cid_dr[bit];
    *cr = t;
 
    t = 2.0 - (*cr * *cr + *ci * *ci);
    *cr *= t;
    *ci *= t;
    return *cr;
}

References cid_di, and cid_dr.

callerid_init()

void callerid_init

(

void

)

CallerID Initialization.

Initializes the callerid system. Mostly stuff for inverse FFT

CallerID Initialization.

Definition at line 116 of file callerid.c.

{
    cid_dr[0] = cos(CALLERID_SPACE * 2.0 * M_PI / 8000.0);
    cid_di[0] = sin(CALLERID_SPACE * 2.0 * M_PI / 8000.0);
    cid_dr[1] = cos(CALLERID_MARK * 2.0 * M_PI / 8000.0);
    cid_di[1] = sin(CALLERID_MARK * 2.0 * M_PI / 8000.0);
    sasdr = cos(SAS_FREQ * 2.0 * M_PI / 8000.0);
    sasdi = sin(SAS_FREQ * 2.0 * M_PI / 8000.0);
    casdr1 = cos(CAS_FREQ1 * 2.0 * M_PI / 8000.0);
    casdi1 = sin(CAS_FREQ1 * 2.0 * M_PI / 8000.0);
    casdr2 = cos(CAS_FREQ2 * 2.0 * M_PI / 8000.0);
    casdi2 = sin(CAS_FREQ2 * 2.0 * M_PI / 8000.0);
}

References CALLERID_MARK, CALLERID_SPACE, CAS_FREQ1, CAS_FREQ2, casdi1, casdi2, casdr1, casdr2, cid_di, cid_dr, cos, M_PI, SAS_FREQ, sasdi, and sasdr.

Referenced by asterisk_daemon().

callerid_new()

struct callerid_state * callerid_new

(

int

cid_signalling

)

Create a callerID state machine.

Parameters

cid_signalling

Type of signalling in use

This function returns a malloc'd instance of the callerid_state data structure.

Returns

Returns a pointer to a malloc'd callerid_state structure, or NULL on error.

Definition at line 130 of file callerid.c.

{
    struct callerid_state *cid;
 
    if ((cid = ast_calloc(1, sizeof(*cid)))) {
#ifdef INTEGER_CALLERID
        cid->fskd.ispb = 7;             /* 1200 baud */
        /* Set up for 1200 / 8000 freq *32 to allow ints */
        cid->fskd.pllispb  = (int)(8000 * 32  / 1200);
        cid->fskd.pllids   = cid->fskd.pllispb/32;
        cid->fskd.pllispb2 = cid->fskd.pllispb/2;
 
        cid->fskd.icont = 0;           /* PLL REset */
        /* cid->fskd.hdlc = 0; */       /* Async */
        cid->fskd.nbit = 8;             /* 8 bits */
        cid->fskd.instop = 1;           /* 1 stop bit */
        /* cid->fskd.paridad = 0; */    /* No parity */
        cid->fskd.bw = 1;               /* Filter 800 Hz */
        if (cid_signalling == 2) {      /* v23 signalling */
            cid->fskd.f_mark_idx  = 4;  /* 1300 Hz */
            cid->fskd.f_space_idx = 5;  /* 2100 Hz */
        } else {                        /* Bell 202 signalling as default */
            cid->fskd.f_mark_idx  = 2;  /* 1200 Hz */
            cid->fskd.f_space_idx = 3;  /* 2200 Hz */
        }
        /* cid->fskd.pcola = 0; */      /* No clue */
        /* cid->fskd.cont = 0.0; */     /* Digital PLL reset */
        /* cid->fskd.x0 = 0.0; */
        /* cid->fskd.state = 0; */
        cid->flags = CID_UNKNOWN_NAME | CID_UNKNOWN_NUMBER;
        /* cid->pos = 0; */
 
        fskmodem_init(&cid->fskd);
#else
        cid->fskd.spb = 7.0;            /* 1200 baud */
        /* cid->fskd.hdlc = 0; */       /* Async */
        cid->fskd.nbit = 8;             /* 8 bits */
        cid->fskd.nstop = 1.0;          /* 1 stop bit */
        /* cid->fskd.paridad = 0; */    /* No parity */
        cid->fskd.bw = 1;               /* Filter 800 Hz */
        if (cid_signalling == 2) {      /* v23 signalling */
            cid->fskd.f_mark_idx =  4;  /* 1300 Hz */
            cid->fskd.f_space_idx = 5;  /* 2100 Hz */
        } else {                        /* Bell 202 signalling as default */
            cid->fskd.f_mark_idx =  2;  /* 1200 Hz */
            cid->fskd.f_space_idx = 3;  /* 2200 Hz */
        }
        /* cid->fskd.pcola = 0; */      /* No clue */
        /* cid->fskd.cont = 0.0; */     /* Digital PLL reset */
        /* cid->fskd.x0 = 0.0; */
        /* cid->fskd.state = 0; */
        cid->flags = CID_UNKNOWN_NAME | CID_UNKNOWN_NUMBER;
        /* cid->pos = 0; */
#endif
    }
 
    return cid;
}

References ast_calloc, fsk_data::bw, CID_UNKNOWN_NAME, CID_UNKNOWN_NUMBER, fsk_data::f_mark_idx, fsk_data::f_space_idx, callerid_state::flags, callerid_state::fskd, fskmodem_init(), fsk_data::icont, fsk_data::instop, fsk_data::ispb, fsk_data::nbit, fsk_data::nstop, fsk_data::pllids, fsk_data::pllispb, fsk_data::pllispb2, and fsk_data::spb.

Referenced by analog_ss_thread(), mwi_thread(), and my_start_cid_detect().

Variable Documentation

cid_di

float cid_di[4]

extern

Definition at line 65 of file callerid.c.

Referenced by callerid_getcarrier(), and callerid_init().

cid_dr

float cid_dr[4]

extern

Definition at line 65 of file callerid.c.

Referenced by callerid_getcarrier(), and callerid_init().

clidsb

float clidsb

extern

Definition at line 66 of file callerid.c.