From 113c1b6325cc9791bb0fcd013355e8bb940d2526 Mon Sep 17 00:00:00 2001 From: eliel Date: Sun, 7 Dec 2008 22:43:46 +0000 Subject: Introduce SMS() application XML documentation. git-svn-id: http://svn.digium.com/svn/asterisk/trunk@161571 f38db490-d61c-443f-a65b-d21fe96a405b --- apps/app_sms.c | 78 +++++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 50 insertions(+), 28 deletions(-) (limited to 'apps/app_sms.c') diff --git a/apps/app_sms.c b/apps/app_sms.c index 6c99ad37a..0015cc842 100644 --- a/apps/app_sms.c +++ b/apps/app_sms.c @@ -53,6 +53,55 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") #include "asterisk/utils.h" #include "asterisk/app.h" +/*** DOCUMENTATION + + + Communicates with SMS service centres and SMS capable analogue phones. + + + + The name of the queue used in /var/spool/asterisk/sms + + + + + + + + + + + + + + + + SMS handles exchange of SMS data with a call to/from SMS capable phone or SMS PSTN service center. + Can send and/or receive SMS messages. Works to ETSI ES 201 912; compatible with BT SMS PSTN service in + UK and Telecom Italia in Italy. + Typical usage is to use to handle calls from the SMS service centre CLI, or to set up a call using + outgoing or manager interface to connect service centre to SMS(). + "Messages are processed as per text file message queues. smsq (a separate software) is a command to + generate message queues and send messages. + The protocol has tight delay bounds. Please use short frames and disable/keep short the + jitter buffer on the ATA to make sure that respones (ACK etc.) are received in time. + + + ***/ + /* #define OUTALAW */ /* enable this to output Alaw rather than linear */ /* ToDo */ @@ -68,33 +117,6 @@ static char log_file[255]; static char *app = "SMS"; -static char *synopsis = "Communicates with SMS service centres and SMS capable analogue phones"; - -static char *descrip = - " SMS(name,[a][s][t][p(d)][r][o],addr,body):\n" - "SMS handles exchange of SMS data with a call to/from SMS capable\n" - "phone or SMS PSTN service center. Can send and/or receive SMS messages.\n" - "Works to ETSI ES 201 912; compatible with BT SMS PSTN service in UK\n" - "and Telecom Italia in Italy.\n" - "Typical usage is to use to handle calls from the SMS service centre CLI,\n" - "or to set up a call using 'outgoing' or manager interface to connect\n" - "service centre to SMS()\n" - "name is the name of the queue used in /var/spool/asterisk/sms\n" - "Arguments:\n" - " a - answer, i.e. send initial FSK packet.\n" - " s - act as service centre talking to a phone.\n" - " t - use protocol 2 (default used is protocol 1).\n" - " p(N) - set the initial delay to N ms (default is 300).\n" - " addr and body are a deprecated format to send messages out.\n" - " r - set the Status Report Request (SRR) bit.\n" - " o - the body should be coded as octets not 7-bit symbols.\n" - "Messages are processed as per text file message queues.\n" - "smsq (a separate software) is a command to generate message\n" - "queues and send messages.\n" - "NOTE: the protocol has tight delay bounds. Please use short frames\n" - "and disable/keep short the jitter buffer on the ATA to make sure that\n" - "respones (ACK etc.) are received in time.\n"; - /* * 80 samples of a single period of the wave. At 8000 Hz, it means these * are the samples of a 100 Hz signal. @@ -2036,7 +2058,7 @@ static int load_module(void) } #endif snprintf(log_file, sizeof(log_file), "%s/sms", ast_config_AST_LOG_DIR); - return ast_register_application(app, sms_exec, synopsis, descrip); + return ast_register_application_xml(app, sms_exec); } AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "SMS/PSTN handler"); -- cgit v1.2.3