1.1. Hardware Requirements 1.2. Numbering Plan 1.3. Address Mapping This module provides a way of communication between SIP network (via SIP MESSAGE) and GSM networks (via ShortMessageService). Communication is possible from SIP to SMS and vice versa. The module provides facilities like SMS confirmation--the gateway can confirm to the SIP user if his message really reached its destination as a SMS--or multi-part messages--if a SIP messages is too long it will be split and sent as multiple SMS. Errors occurred because of an invalid number or a too long message or because of an internal modem malfunction are reported back to the SIP user via a SIP message containing explanations regarding the error. 1.1. Hardware Requirements The SMS module needs a GSM modem to be able to send/receive the SMS messages. Usually, this kind of modems are externals, linked to the machine via serial cable. The modem can be a dedicated one (as the ones provided by FALCOM) or can be a GSM telephone that has an internal modem (as the latest mobile phones from NOKIA and ERICSSON). 1.2. Numbering Plan The gateway accepts and advertises phone numbers in international format, more specific like: +(international code)(area code)(number). Ex: Germany, D1 = +49 170 5678181 Romania, Connex = +40 722 123456 A number in this format is expected to be placed as username into RURI or in the To header. If RURI misses the username, the To header will be considered. Also, the gateway will advertise in this format the
| Parámetro | Tipo | Descripción |
|---|---|---|
| modems | string | 3.2. networks (string) 3.3. links (string) 3.4. default_net (string) 3.5. max_sms_parts (integer) 3.6. domain (string) 3.7. use_contact (integer) 3.8. sms_report_type (integer) |
| networks | string | 3.3. links (string) 3.4. default_net (string) 3.5. max_sms_parts (integer) 3.6. domain (string) 3.7. use_contact (integer) 3.8. sms_report_type (integer) |
| links | string | 3.4. default_net (string) 3.5. max_sms_parts (integer) 3.6. domain (string) 3.7. use_contact (integer) 3.8. sms_report_type (integer) |
| default_net | string | 3.5. max_sms_parts (integer) 3.6. domain (string) 3.7. use_contact (integer) 3.8. sms_report_type (integer) |
| max_sms_parts | integer | 3.6. domain (string) 3.7. use_contact (integer) 3.8. sms_report_type (integer) |
| domain | string | 3.7. use_contact (integer) 3.8. sms_report_type (integer) |
| use_contact | integer | 3.8. sms_report_type (integer) |
| sms_report_type | integer | 3.1. modems (string) |
| modems | string | Define and configure one or more GSM modems. modems_value = modem_definition *( ";" modem_definition ) modem_definition = modem_name "[" list_of_params "]" list_of_params = modem_param *( ";" modem_pa |
| networks | string | Define and configure used GSM networks. networks_value = net_definition *( ";" net_definition ) net_definition = net_name "[" list_of_params "]" list_of_params = set_param *( ";" set_param ) set_param |
| links | string | Define from which network each modem should send SMS. links_value = modem_assoc *( ";" modem_assoc ) modem_assoc = modem_name "[" list_of_networks "]" list_of_networks = network *( ";" network ) |
| default_net | string | The default network to use. If no one specified, the first defined network is used. This parameter is useful only if the "sms_send_msg" exported function is used (see Section 4, “Functions”). |
| max_sms_parts | integer | Shows in how many parts (SMS messages) a SIP message can be split. If exceeded, the SIP message will be sent truncated and the SIP user will get back another message containing the unsent part. |
| domain | string | Specify a fake domain name to be used by the gateway. The Contact headers and the From header from the request will be constructed based on this fake domain name. It's useful when the gateway is trans |
| use_contact | integer | If a contact header should be added to the outgoing SIP messages. Even if the SIP draft forbids this, some UAS require it. |
| sms_report_type | integer | If the modem should ask for SMS confirmation from the SMS Center. If the SMSC reply with an error code, the gateway will send back to SIP user a SIP message containing the text (or part of it) that co |
4.2. sms_send_msg()
4.1. sms_send_msg_to_net(network_name)
Put the SIP msg in the specified network queue. The function return error if the number encapsulated into SIP message is malformed, if the content_type is incorrect or because of some internal failures.
The same as the previous one, but use the default network queue.
Copyright © 2003 FhG FOKUS
