LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected]
LV-C4AG2GSM Manual de Usuario
Linknet® GSM Card LV-C4AG2GSM
Manual de Usuario
Version: 2.0
LV-C4AG2GSM Manual de Usuario
Contenido
Capítulo 1 Introducción de la tarjeta LV-C4AG2GSM .................................................................... 1
Capítulo 2 Introducción del Hardware .............................................................................................. 3
Capítulo 3 Prueba de entorno ................................................................................................................ 4
Capítulo 4 Instalación del Software .................................................................................................. 5
Capítulo 5 Configuración del Software ............................................................................................. 7
Capítulo 6 Prueba ............................................................................................................................ 12
Capítulo 7 Enviando y recibiendo SMS ......................................................................................... 15
Capítulo 8 Referencia ..................................................................................................................... 17
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 1
Capítulo 1 Introducción
Visión general de la tarjeta LV-C4AG2GSM
La tarjeta LV-C4AG2GSM Asterisk es un dispositivo híbrido, el cual soporta 2 canales GSM y 4
puertos analógicos FXO/FXS. Utilizando la tarjetaLV-C4AG2GSM, una PBX de código
abierto Asterisk y un computador personal, los usuarios pueden crear una solución de telefonía
SOHO la cual incluye todas las características sofisticadas de la PBX tradicional, así como
características extendidas en la IP PBX, tales como mensajes de voz, transferencia de llamadas,
retención de llamadas, capturas de llamadas, direccionamiento de llamadas, envío grupal de
SMS, recepción de SMS, etc. Utilizando el puerto GSM SIM del soporte, los usuarios no
necesitan abrir el servidor cuando sea necesario cambiar una tarjeta SIM.
Características
Dos canales GSM y cuatro puertos analógicos Bulk
Envío de SMS
Recepción y almacenamiento SMS
Contenido multilenguaje para SMS
Desbloqueo por número de PIN de la tarjeta SIM
Eco cancelación por Hardware del módulo GSM
Monitoreo de recepción de señal GSM por comando e iluminación LED
Monitoreo del estatus de la comunicación por línea de comando
Envío de SMS por Asterisk CLI, y plan de discado
Detección precisa de contestación de llamadas
Frecuencia GSM quadband (850/900/1800/1900MHz)
Detección DTMF
Soporte de comandos AT
Adecuado para ranuras de 3.3 voltios PCI-E slots
Ranura PCI o conectores de 4-pin para
alimentación de poder
Soporta Elastix 2.4.0, Trixbox 2.8.0.4
Aplicaciones
Conectividad GSM y analógica para PBX Móvil y PBX analógica.
Entrada VoIP GSM y analógica
Entrada SMS
Servicio GSM de devolución de llamadas
Sistema de facturación
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 2
Requerimientos de Hardware
500-Mhz Pentium III
64MB RAM
Ranura 3.3V PCI-E 2.2
Dimensiones y Peso
Caja interna 221 * 142 * 62mm
G.W./unidad 0.25kg
Tamaño de la tarjeta 175mm *106 mm
Empaque
Item Cantidad
LV-C4AG2GSM tarjeta madre 1
Módulo GSM (LV-MGSM1) 1-2
Módulo analógico de puertos duales 1-2
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 3
Capítulo 2 Introducción del Hardware
LV-MGSM1: Módulo GSM, un LV-MGSM1 soporta un canal GSM.
LV-MFXS2: Módulo FXS, soporta dos puertos FXS.
LV-MFXO2: Módulo FXO, soporta dos puertos FXO.
CON1: Conector de poder de 4 pines.
JP4: Selecciona la vía de alimentación de poder, Se encontrará posicionado a la derecha por defecto.
Hole: Utilizado para fijar la línea que conecta la LV-MGSM1 con la antena.
Antenna: La antena en la ilustración anterior es omnidireccional, el modelo es TS01
Atención: Con el fin de incrementar la señal GSM en entornos de difícil acceso, además de la
antena de la ilustración anterior, LINKNET puede proveer otra antena (TL01) la cual
posee un cable más extenso(aproximadamente 1 metro) y puede ser conectada desde
afuera.
RJ45: Utilizado para conectar el divisor (splitter) a la tarjeta, el divisor soporta cuatro puertos RJ11
y un puerto RJ45.
LED-A: Utilizado para chequear si el módulo FXS/FXO es detectado. Cuando los puertos
FXS/FXO son detectados correctamente, el LED estará encendido.
LED-G: Utilizado para chequear si el módulo GSM es detectado. Cuando los puertos GSM son
detectados correctamente, el LED estará encendido.
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 4
Capítulo 3 Prueba de entorno
Test Environment:
dahdi-linux-complete-2.6.2+2.6.2 (download from Linknet website)
asterisk-1.8.7.0 (download from Linknet website)
libgsm-1.1.0 (download from Linknet website)
Centos6.0 (kernel version: 2.6.18-348.3.1.el5)
LV-C4AG2GSM+2*LV-MGSM1+1*LV-MFXS2+1*LV-MFXO2
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 5
Capítulo 4 Instalación del Software
Luego de insertar la tarjeta en la ranura PCI-E y reiniciar el servidor, por favor introduzca el
comando “lspci” para chequear la compatibilidad del bus PCI-E. Desde la salida correcta, los
usuarios podrán observar la siguiente línea:
----------------------------------------------------------------------------------------------------------------------
02:00.0 Communication controller: Digium, Inc. Device b200 (rev 02)
----------------------------------------------------------------------------------------------------------------------
Si no puede observar el mensaje anterior, por favor apague el servidor y pruebe otra ranura PCI-E.
Si el problema persiste, por favor contactar [email protected].
1. Para instalar asterisk y dahdi, Los usuarios deben utilizar el comando “yum” para instalar
los siguientes paquetes requeridos:
yum install -y bison bison-devel zlib zlib-devel openssl openssl-devel gnutls-devel gcc
gcc-c++ libxml2 libxml2-devel ncurses ncurses-devel
yum install update
yum install bison openssl gcc libxml2 libxml2-dev ncurses-dev gawk
yum install sqlite3 libsqlite3-dev
2. Descargar los paquetes de dahdi y asterisk.
Atención:
Es necesario descargar los últimos paquetes de dahdi y asterisk para la tarjeta LV-
CE4GSM/LV-C4AG2GSM desde el sitio web de Linknet: http://www.linknet-usa.com
[root@localhost src]# wget
http://www.linknet-usa.com/main/drivers/libgsm-current/libgsm-current.tar.gz
[root@localhost src]# wget
http://www.linknet-usa.com/main/drivers/dahdi-linux-complete/dahdi-linux-complete-
2.6.2+2.6.2.tar.gz
[root@localhost src]# wget
http://www.linknet-usa.com/main/drivers/asterisk/asterisk-1.8-current.tar.gz
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 6
3. Instalar los paquetes completos de dahdi-linux:
1) [root@localhost src]# tar -xvzf dahdi-linux-complete-2.6.2+2.6.2.tar.gz
2) [root@localhost dahdi-linux-complete-2.6.2+2.6.2]# make
3) [root@localhost dahdi-linux-complete-2.6.2+2.6.2]# make install
4) [root@localhost dahdi-linux-complete-2.6.2+2.6.2]# make config
4. Instalar el paquete libgsm:
1) [root@localhost src]# tar -xvzf libgsm.tar.gz
2) [root@localhost libgsm]# make
3) [root@localhost libgsm]# make install
5. Instalar asterisk
1) [root@localhost src]# tar -xvzf asterisk-1.8.7.0.tar.gz
2) [root@localhost asterisk-1.8.7.0]# ./configure
3) [root@localhost asterisk-1.8.7.0]# make
4) [root@localhost asterisk-1.8.7.0]# make install
5) [root@localhost asterisk-1.8.7.0]# make samples
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 7
Capítulo 5 Configuración del Software
1. Por favor introducir el comando: “cat /proc/interrupts” para chequear si el driver de LV-
C4AG2GSM ha sido cargado satisfactoriamente. Los usuarios obtendrán un mensaje con
axe4gn como sigue:
16: 42079 10824611 IO-APIC-fasteoi axe4gn
Si no se obtiene el mensaje anterior, por favor apague el servidor e inserte nuevamente la
tarjeta asterisk en otra ranura PCI-E.
2. Por favor ejecute el archivo “dahdi_genconf” para introducir la configuración
“/etc/dahdi/system.conf” y genere el archivo “/etc/asterisk/dahdi-channels.conf”.
[root@localhost ~]# dahdi_genconf
No se mostrará ningún mensaje si el comando fue introducido satisfactoriamente. Luego el
archivo “/etc/dahdi/system.conf” será creado con la siguiente configuración.
# Autogenerated by /usr/sbin/dahdi_genconf on
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
# This file is parsed by the Dahdi Configurator, dahdi_cfg
# Span 1: WCTDM/6 "LINKNET AXFSO Board 7" (MASTER)
fxoks=1
echocanceller=mg2,1
fxoks=2
echocanceller=mg2,2
fxsks=3
echocanceller=mg2,3
fxsks=4
echocanceller=mg2,4
# Span 2: AXGSM/0/2 "LINKNET GSM/WCDMA 0"
#gsmspan=2,1,0,ccs,ami
# termtype: gsm
bchan=3
hardhdlc=4
echocanceller=mg2,1
# Span 3: AXGSM/0/3 "LINKNET GSM/WCDMA 0"
#gsmspan=3,1,0,ccs,ami
# termtype: gsm
bchan=5
hardhdlc=6
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 8
echocanceller=mg2,1
# Global data
loadzone = us
defaultzone = us
Luego de ejecutar dahdi_genconf satisfactoriamente, el archivo “dahdi-channels.conf”
obtendrá la siguiente configuración:
; Span 1: AXGSM "LINKNET AXFSO Board 7" (MASTER)
;;; line="1 AXGSM/0/1 AXFSO (In use) (SWEC: MG2)"
signalling=fxo_ks
callerid=asreceived
group=5
context=from-pstn
channel => 1
callerid=
group=
context=default
;;; line="2 AXGSM/0/2 FXSKS (In use) (SWEC: MG2)"
signalling=fxo_ks
callerid=asreceived
group=5
context=from-pstn
channel => 2
callerid=
group=
context=default
;;; line="5 WCTDM/6/4 FXSKS (In use) (SWEC: MG2)"
signalling=fxs_ks
callerid=asreceived
group=0
context=from-pstn
channel => 3
callerid=
group=
context=default
;;; line="5 WCTDM/6/4 FXSKS (In use) (SWEC: MG2)"
signalling=fxs_ks
callerid=asreceived
group=0
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com Email: [email protected] 9
context=from-pstn
channel => 4
callerid=
group=
context=default
Luego de ejecutar el archivo dahdi_genconf satisfactoriamente, el archivo “gcom-
channels.conf” obtendrá la siguiente configuración.
; Span 2: AXGSM/0/2 "LINKNET GSM/WCDMA 0"
group=12 context=from-
gsm signalling = gsm
;pinnum=1234
channel => 3
context =
group =
; Span 3: AXGSM/0/3 "LINKNET GSM/WCDMA 0" (MASTER)
group=13 context=from-
gsm signalling = gsm
;pinnum=1234
channel => 5
context =
group =
Por favor ejecute el comando dahdi_cfg –vv.
[root@localhost asterisk]# dahdi_cfg -vv
DAHDI Tools Version - 2.6.2
DAHDI Version: 2.6.2
Echo Canceller(s): MG2
Configuration
======================
Setting echocan for channel 1 to mg2
Setting echocan for channel 2 to mg2
Setting echocan for channel 3 to mg2
Setting echocan for channel 4 to mg2
Setting echocan for channel 5 to mg2
Setting echocan for channel 6 to mg2
Setting echocan for channel 7 to mg2
Setting echocan for channel 8 to mg2
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 10
Chan Extension Context Language MOH Interpret State
pseudo default default In Service
1 from-internal default In Service
2 from-internal default In Service
3 from-pstn default In Service
4 from-pstn default In Service
3. Por favor agregue la siguiente línea al final del archivo “/etc/asterisk/chan_dahdi.conf”.
Los usuarios pueden ejecutar el siguiente comando en CLI.
[root@localhost ~]# echo #include dahdi-channels.conf >>/etc/asterisk/chan_dahdi.conf
[root@localhost ~]# echo #include gcom-channels.conf >>/etc/asterisk/chan_gcom.conf
4. Si se quiere ejecutar asterisk, se puede introducir el siguiente comando:
[root@localhost ~]# asterisk –vvgc
5. Por favor ejecute el comando para validar los canales dahdi o gsm.
Se deben obtener 4 canales analógicos y 2 canales GSM como sigue:
localhost*CLI> dahdi show channels
localhost*CLI> gsm show spans
SPANNO STATUS ACTIVE
1 UP ACTIVE
2 UP ACTIVE
6. Por favor agregue el modo codificado para recibir mensajes en el archivo “chan_dahdi.conf”
Si las versiones de los módulos GSM son 0x41 o posterior y los usuarios necesitan recibir
mensajes vía módulos GSM, por favor siga los siguientes parámetros.
[channels]
;
; Default language
;
;language=en
sms_language=en
Por ejemplo, los usuarios pueden agregar sistemas de lenguaje como: weur, utilizado para
Europa Occidental; eeur: utilizado para Europa Oriental y cn: para Chino.
Para modificar el lenguaje que se muestra en pantalla, por favor edite el siguiente archivo:
/root/.bash_profile.
Por ejemplo, el lenguaje del sistema por defecto es Ingles como sigue: LANG=es_ES.
Los usuarios pueden cambiar por ejemplo a Chino como sigue: LANG=zh_CN.
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 11
7. Establecer sistema de facturación
Se puede abrir el CRBT (Color Ring Back Tone), cuando el usuario habilita el siguiente
parámetro: “prematuremedia=no” en el archivo: ”/etc/asterisk/sip.conf”.
Si se quiere establecer el sistema de facturación, se puede editar el siguiente archivo:
“/etc/asterisk/chan_dahdi.conf” y deshabilitar los siguientes parámetros:
answeronpolarityswitch=yes, polarityonanswerdelay= 300.
Luego es necesario añadir dos líneas de comando al archivo “/etc/asterisk/gcom-channels.conf”
como sigue:
The GSM channels configure
; Span 2: AXGSM/0/2 "LINKNET GSM/WCDMA 0"
group=12 context=from-
gsm
answeronpolarityswitch=yes
polarityonanswerdelay= 300
signalling = gsm
;pinnum=1234
channel => 3
context =
group =
... ... ...
... ... ...
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 12
Capítulo 6 Prueba
1. Por favor inserte la tarjeta SIM en la ranura SIM. Luego chequear la señal de la red GSM
ejecutando el siguiente comando en el CLI.
terminal*CLI> gsm show span csq <span>
Usage: gsm show span <span>
Displays GSM Information on a given GSM span
El siguiente mensaje aparecerá en la pantalla:
centos6*CLI> gsm show span csq 1
gsm spanno: 1: csq: 22
Si el número es 0 o 99 significa que no hay señal del módulo GSM. Para el resto de los
números, entre mas alto el número más fuerte será la señal GSM.
Si el valor se encuentra por debajo de 10 en algunas áreas, esto puede cause baja calidad de
voz. Si este es el caso, por favor contacte al proveedor del servicio. De igual manera, el
usuario puede mover el Sistema a otra área con mejor recepción.
2. Chequear la versión de la tarjeta LV-MGSM1:[root@localhost~]# dmesg
Module 0: Installed -- AUTO GSM(version 0x11)
read car0 small board timeslot =0
axgcom_init_GSM CARD:2
VoiceGSM System:0a
read small board version =11
Module 1: Installed -- AUTO GSM(version 0x11)
read car2 small board timeslot =8
axgcom_init_GSM CARD:4
VoiceGSM System:0a
read small board version =11
... ...
... ...
Nota:
El mensaje “version 0x11” indica la versión del firmware relacionado al hardware GSM
3. Introducir el número de PIN para la tarjeta SIM.
El usuario puede agregar la siguiente línea roja en el archivo “/etc/asterisk/gcom-
channels.conf”. Luego del ajuste, por favor reinicie asterisk para hacer efectivos los cambios.
; Span 2: AXGSM/0/2 "LINKNET GSM/WCDMA 0"
group=12
context=from-gsm
signalling = gsm
pinnum=1234
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 13
channel => 3
context =
group =
4. Utilice el siguiente comando para leer el número IMEI de la tarjeta LV-MGSM1:
centos6*CLI> gsm show span info <span>
Usage: gsm show span info <span>
Show span sim information
Por ejemplo:
centos6*CLI> gsm show span info 1
VERSION: M50AR01A06W64
IMEI : 863092010178526
IMSI : 460008362997291
SMSC : +8613800755500
5. Chequear los mensajes de los canales GSM:
[root@centos6 dahdi]# lsdahdi
### Span 2: AXGSM/0/2 "LINKNET GSM/WCDMA 0" (MASTER)
1 unknown Clear (In use) (EC: MG2 - INACTIVE)
2 unknown Hardware-assisted HDLC (In use)
... ...
... ...
Los usuarios pueden realizar el siguiente comando para revisar los mensajes GSM: “lsdahdi”.
El canal 1 puede utilizarse para marcar o recibir llamadas. El canal 2 es el D-channel.
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 14
6. Editar plan de discado para llamadas.
Los usuarios pueden editar el plan de discado en el archivo “/etc/asterisk/extensions.conf”.
El siguiente plan de discado puede ser utilizado como referencia.
[from-internal]
exten=>_1.,1,Dial(gcom/1/${EXTEN:1}) ;Dial-out via GSM module 1;
exten=>_1.,2,Hangup()
exten=>_2.,1,Dial(gcom/3/${EXTEN:1}) ;Dial-out via GSM module 2;
exten=>_2.,2,Hangup()
... ...
... ...
exten=>_9.,1,Dial(dahdi/g0/${EXTEN:1}) ;Dial-out via FXO channels;
exten=>_9.,2,Hangup()
[from-pstn]
exten=>s,1,Answer()
exten=>s,2,Dial(sip/500)
exten=>s,3,hangup()
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 15
Capítulo 7 Enviando y Recibiendo SMS
Existen dos maneras de enviar SMS.
1. Enviando SMS por asterisk directamente a través de un comando CLI.
En el siguiente ejemplo, se envía un mensaje a 13743211234 utilizando el primer
canal:
centos6*CLI> gsm send sms 1 13743211234 Welcome to LINKNET
Usage: gsm send sms <span> <number> <sms>
Send a sms on <span> <number> <sms>
El usuario puede utilizar los canales 1, 3, 5, or 7.
2. Enviando SMS en masa
Antes de enviar los SMS, por favor inicie Asterisk. El usuario puede editar el archivo *.xml
utilizando el archivo “/var/spool/asterisk/” como en el siguiente formato, y luego copiar el
contenido en el archivo saliente. Posteriormente, el SMS será enviado.
bulksms.xml
---------------------------------------------------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<sms>
<receiver>15012871900</receiver>
<receiver>13728731752</receiver>
<channel>1</channel>
<content>
hello! welcome to LINKNET!
</content>
</sms>
-----------------------------------------------------------------------------------------------------------------
Por favor copier el contenido de bulksms.xml al archive saliente y corer el comando: cp
bulksms.xml
/var/spool/asterisk/xmlsms/
3. Darle formato al archivo *.xml
*.xml file name: el usuario puede renombrar
el archivo.
Receiver: Añadir el número telefónico de destino; una línea por cada número telefónico, el
ejemplo anterior añade dos número telefónicos de destino.
Channel: Escoger el canal GSM por el cual el sistema enviará el SMS.
Content: Introducir o copiar el contenido del SMS que será enviado.
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 16
4. Chequear el SMS resultante
1) El usuario puede obtener el siguiente resultado de salida en el asterisk CLI.
Si el usuario puede ver los caracteres: “result=1”, significa que el SMS ha sido enviado
satisfactoriamente; si el usuario obtiene “result=-1”, significa que el envío del SMS ha fallado.
Por ejemplo:
localhost*CLI>
[Sep 9 16:08:23] NOTICE[3593]: pbx_spool.c:166 apply_sms_outgoing: pbx_spool find called
name=15012871900
[Sep 9 16:08:23] NOTICE[3593]: pbx_spool.c:166 apply_sms_outgoing: pbx_spool find called
name=13728731752
-- Attempting call on sms/ for application queuesms(dahdi/1,15012871900&13728731752,hello! welcome
to LINKNET!) (Retry 1)
-- Launching queuesms(dahdi/1,15012871900&13728731752,hello! welcome to LINKNET!) on type/data-
00000001
[Sep 9 16:08:23] NOTICE[3823]: pbx_spool.c:531 attempt_thread: Call completed to sms/
-- Launching DoSms(15012871900&13728731752 hello! welcome to LINKNET!) on DAHDI/1-
1 [Sep 9 16:08:27] NOTICE[3825]: chan_dahdi.c:18205 sms_queue_send: sessionid=1315555703.3
channum=1 time=2011/09/09 16:08:27 send to called=15012871900 result=1
[Sep 9 16:08:31] NOTICE[3825]: chan_dahdi.c:18205 sms_queue_send: sessionid=1315555703.3
channum=1 time=2011/09/09 16:08:31 send to called=13728731752 result=1
-- Hungup 'DAHDI/1-1'
2) Chequear el resultado del SMS con el archivo de registro.
El usuario también puede visualizar el resultado SMS revisando el directorio
“/var/log/asterisk/sms/sendsms”. El sistema va a generar un archivo de registro cada día si el
SMS es enviado satisfactoriamente o no.
Por ejemplo,
sendsms_2013-12-02.log
Esto es creado el 2 de Diciembre, 2013, lo cual registra todos los resultados del SMS para dicha
fecha.
5. Recibiendo SMS
Cuando un SMS es recibido, el Sistema genera un archive para guarder el SMS bajo el directorio
“/var/log/asterisk/sms/recvsms”.
El formato del nombre del archivo: recvsms_channel number_time_+cell phone number.log
El formato del contenido SMS: channo:channel >>date time|+cell phone number| SMS content
LV-C4AG2GSM Manual de Usuario
www.linknet-usa.com
Email: [email protected] 17
Capítulo 8 Referencias
http://www.asteriskguru.com/
http://www.asterisk.org/downloads
http://www.openippbx.org/index.php?title=Main_Page
http://www.linknet-usa.com/