chan_sebi (1) Que, como y por que

Hola.

Ahora que parece que lo de chan_sebi ya está más o menos controlado voy a comentar un poco como y por que surgió la idea de trabajar en este ámbito.

Primero explicar que es chan_sebi. Pues es un canal para Asterisk, que utiliza modems Huawei para proveer de gateways gsm de voz y/o  sms.

En principio se ha hecho pensando en los E169/K3520 de Huawei, modems estos que tienen capacidades de llamada de voz. Internamente utilizan un chipset de Qualcomm (de la serie MSM7200). Con un modem usb de estos modelos tenemos un gateway de voz que además no tiene que hacer conversiones de audio como las que se hacen con un FXO analogico ni los problemas de señalización inherentes a los canales analógicos, ya que toda la gestión de audio y de señalización se hace de forma digital (bien a través del canal de audio, bien a través del canal de datos), pudiendo ser comparado a un router RDSI=>GSM de un puerto

La idea surge de la posibilidad de aprovechar las capacidades de voz de estos modems para tener un gateway gsm a un costo muy economico. La mayor parte de los operadores los dan a costo cero cumpliendo unos mínimos de permanencia o consumo, como cualquier otro terminal telefónico.

Técnicamente estos modems son vistos por el S.O. como un “hub” usb con varios dispositivos. En principio tres puertos seriales y un puerto de almacenamiento con dos dispositivos (un cd y un lector de memoria). Asi los subid 00,01 y 02 serán los puertos de comunicacion, cada uno con distintas funciones (audio, datos y gestion general) y el subid 03 que nos dará control sobre el cd virtual y el lector de tarjetas.

A partir de esta base se construye un controlador de canal que toma como punto de partida el chan_mobile que ya existe para Asterisk.

El firmware para los E169 K3520 que yo uso está disponible aqui http://www.vodafone.de/downloadarea/FW_Update_K3520_11.314.12.02.00.zip

Para descargar asterisk-addons con chan_sebi svn export http://asterisk-es-rsp.irontec.com/svn/team/Odicha/asterisk-addons-1.4.7 asterisk-addons 

Y pasamos ya a lo que es instalacion y configuracion de chan_sebi

A nivel de descarga e instalación comentar cuales son sus prerequisitos. El S.O. debe ser capaz de montar los subid 00, 01 y 02 del modem huawei como usbTTYx. Los kernels antiguos (por debajo de 2.6.20 generalmente) no son capaces de hacerlo automaticamente por lo que habrá que modificar algunas cosas para que se detecten de la forma adecuada y sean cargados por usbserial. Normalmente es suficiente con /sbin/modprobe usbserial vendor=0x12d1 product=0×1003  o bien /sbin/modprobe usbserial vendor=0x12d1 product=0×1001 dependiendo de si el modem es 1001 (169,k3520,e270,etc…) o es 1003 (e220…). A veces también entran en conflicto con el driver de option resolviendose añadiendo al blacklist el modulo ”option”. Si aun asi sigue intentando cargar puede intentar resolverse eliminando el fichero option.ko y ejecutando un depmod despues.

Los puertos ttyUSBx que se crean al conectar el modem tienen que tener permiso de lectura y escritura para el usuario que ejecuta Asterisk, si no es así no será posible que Asterisk se comunique con el modem. Si no se ejecuta asterisk como root lo mejor es agregar el usuario que corre asterisk al grupo propietario de los puertos que en funcion de distros y kernels puede variar (en Fedora es uucp, por ej.). Algo como esto por ej.

chmod 660 /dev/ttyUSB*
chown asterisk:uucp /dev/ttyUSB*
echo ‘KERNEL==”ttyUSB[0-9*]“, MODE=”0660″, OWNER=”asterisk”, GROUP=”uucp”‘  >>  /etc/udev/rules.d/92-sebi.rules

Cumpliendo esto podremos instalar asterisk-addons sobre nuestro asterisk 1.4.x con chan_sebi incluido.

Si lo instalamos y arrancamos, si tenemos todo correcto, el canal analizará los dispositivos usb que tenemos conectados y generará un fichero /etc/asterisk/sebi_devices.conf que contendrá algo similar a esto:

[2-1]
data = /dev/ttyUSB2
voice = /dev/ttyUSB1
imei = 35413702XXXXXXX

 A partir de aqui sabemos que el modem está siendo detectado correctamente y pasaremos a generar el fichero de configuración /etc/asterisk/sebi.conf. Si hicimos un make samples al instalar asterisk-addons ya tendremos un fichero sebi.conf que tendremos que adaptar.

[huawei1]
imei=35XXXXXXXXXXX  ; imei of modem
;pin=1234   ; pin (use only if sim card has pin request enabled)
csca=+34607003110  ; SMS centre number (Vodafone ES – example)
sms=yes    ; Enable sms send/receive
voice=yes   ; Enable voice for calls
context=from-pstn  ; dialplan context for incoming calls
group=1    ; this phone is in channel group 1
volume=5   ; Modem Volume (1-5)
language=es   ; Channel language
;nocallsetup=yes  ; set this only if you want override call status notifications

El campo imei del canal es el que combina la información de configuración del modem con el equipo físico. No olviden que el numero de puerto ttyUSB depende del orden en que se cargan o de la cantidad de dispositivos usb que están conectados en cada momento. Los demas campos de configuracion creo que están claros, practicamente se describen solos. Es interesante hacer notar que el nombre del canal lo asignamos nosotros libremente en el identificador de seccion (en el ejemplo [huawei1])

Si reiniciamos asterisk y todo ha ido bien tras cargar ejecutaremos el comando sebi show devices y obtendremos algo parecido a esto:

CentOS-5*CLI> sebi show devices

ID                      IMEI                 Group           Provider        Connected State Voice SMS
huawei1         3541370xxxxxxxx   1    Vodafone ES               Yes       Free  Yes    Yes

CentOS-5*CLI>

A partir de aquí podemos usar el modem como una canal de voz realizando y recibiendo llamadas y como gateway sms. Cabe observar que en los modelos que no soporten voz el resultado será como este:

CentOS-5*CLI> sebi show devices

ID                      IMEI                 Group           Provider        Connected State Voice SMS
huawei1         3541370xxxxxxxx   1    Vodafone ES               Yes       Free  No    Yes

CentOS-5*CLI>

Nos dirá que no tenemos servicios de voz en ese dispositivo, y lo usaremos solo como gateway sms.

Para enviar y recibir sms, usaremos convenciones muy similares a las de chan_mobile. Para recibir un sms y guardarlo en la base de datos tendremos las instruccciones correspondientes en el dialplan (por cierto, solo procesa sms recibidos mientras está activo, por el momento)

[from-pstn]
exten => sms,1,Verbose(Incoming SMS from ${SMSSRC} ${SMSTXT})
exten => sms,n,Set(DB(SMS/${SMSSRC})=${SMSTXT})      
exten => sms,n,Hangup

 Para enviar un sms:

originate sip/109 application SebiSendSMS huawei1|647324xxx|”texto de prueba del sms”

Para revisar si el canal está libre antes de enviar el sms tenemos la aplicación correspondiente

SebiStatus(Device,Variable)
Device – Id del dispositivo en sebi.conf
Variable – Variable donde almacenamos el estado (1-3) 1-Desconectado, 2-Disponible, 3-Ocupado

Y en principio no tiene más complejidades. En un próximo post intentaré analizar un poco el código, para los que deseen modificar cosas puedan ir a “tiro hecho”.