lv-c4ag2gsm manual de usuario -...

LV-C4AG2GSM Manual de Usuario

www.linknet-usa.com Email: [email protected]


Linknet® GSM Card LV-C4AG2GSM

Manual de Usuario

Version: 2.0


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


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



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



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.



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



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


http://www.linknet-usa.com/main/drivers/dahdi-linux-complete/dahdi-linux-complete-

2.6.2+2.6.2.tar.gz


http://www.linknet-usa.com/main/drivers/asterisk/asterisk-1.8-current.tar.gz

mailto:[email protected].

http://www.linknet-usa.com/main/drivers/libgsm-current/libgsm-current.tar.gz

http://www.linknet-usa.com/main/drivers/dahdi-linux-complete/dahdi-linux-complete-2.6.2+2.6.2.tar.gz

http://www.linknet-usa.com/main/drivers/dahdi-linux-complete/dahdi-linux-complete-2.6.2+2.6.2.tar.gz

http://www.linknet-usa.com/main/drivers/asterisk/asterisk-1.8-current.tar.gz



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



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



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



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)


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









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.


www.linknet-usa.com


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



gsm

answeronpolarityswitch=yes

polarityonanswerdelay= 300

signalling = gsm

;pinnum=1234

channel => 3

context =

group =

... ... ...

... ... ...

www.linknet-usa.com


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 

Usage: gsm show 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.


group=12

context=from-gsm

signalling = gsm

pinnum=1234

www.linknet-usa.com


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 

Usage: gsm show span info 

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.


www.linknet-usa.com


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=>_9.,1,Dial(dahdi/g0/${EXTEN:1}) ;Dial-out via FXO channels;


[from-pstn]

exten=>s,1,Answer()

exten=>s,2,Dial(sip/500)

exten=>s,3,hangup()

www.linknet-usa.com


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 <number> <sms>

Send a sms on <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.


www.linknet-usa.com


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


www.linknet-usa.com


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/

http://www.asteriskguru.com/

http://www.asterisk.org/downloads

http://www.openippbx.org/index.php?title=Main_Page

http://www.linknet-usa.com/

lv-c4ag2gsm manual de usuario -...

Documents