Curso Asterisk Mayo 2014

Asterisk y los FAX

Enviar/recibir FAX

Modulo app_fax (deprecated)

Modulos res_fax y res_fax_spandsp

IAXmodem/Hylafax

03/06/14

Curso Asterisk

Prerequisitos modulo FAX

Las libreras libtiff y libjpeg y relativos devel

La libreria SpanDSP (digital signal processing)

03/06/14

Curso Asterisk

Modulo res_fax

Desactivar y activar el modulo

Se activan dos aplicaciones:

SendFAX
ReceiveFAX

03/06/14

Curso Asterisk

SendFAX
Sintaxis comando:
SendFAX(filename[,options])
Problema: Cmo hago para enviar un fax si no puedo indicar en la
linea del comando el numero de telfono del destinatario?
Solucin: tengo que apoyarme a una funcionalidad de Asterisk
llamada callfiles o trabajar con la AMI

03/06/14

Curso Asterisk

SendFAX - II
El callfile es una archivo de texto donde se indican los
comando que Asterisk debe ejecutar secuencialmente.
Para enviar un fax un ejemplo podra ser:
Channel: SIP/voztovoice/005712345678
Callerid: "FAX"
WaitTime: 30
Maxretries:3
RetryTime: 300
Account: 1000
Application: SendFax
Data: /tmp/pruebafax.tif

Una vez creado el archivo hay que moverlo en la carpeta

/var/spool/asterisk/outgoing con el comando Linux mv:
03/06/14

Curso Asterisk

ReceiveFAX
Sintaxis:
ReceiveFAX(filename[,options])
Ejemplo:
exten => s,1,ReceiveFax(/tmp/${UNIQUEID}.tif)
La variable ${UNIQUEID} contiene un numero unico que se
asigna a cada llamada..
Truco: Si queremos volver los archivos visibles en una pagina
web, guardamos los FAX recibidos en una carpeta accesible
al servidor www (tipo /var/www/html)

03/06/14

Curso Asterisk

IAXmodem - Hylafax
IAXmodem Mdem software escrito en C que utiliza
un canal IAX en lugar de una linea telefnica y se apoya
a un DSPsoftware (SpanDSP) en lugar de un DSP
hardware
Hylafax Es un programa cliente-servidor que permite
gestionar los faxes configurados en un sistema Linux
(los faxes pueden ser tarjetas instaladas en el servidor
o, come es el caso di IAXmodem, fax software)

03/06/14

Curso Asterisk

IAXmodem Hylafax Envo

Flujo de una llamada cuando se inva un fax utilizzando
IAXmodem + Hylafax
Comando sendfax del programa hylafax:
sendfax -n -d 005712345678 /tmp/pruebafax.txt
Hylafax usa il primer modem disponible para efectuar el envo
(IAXmodem - ttyIAX)
IAXmodem est conectado a Asterisk come si fuera un interno y
tiene configurado un determinado contexto
En el dialplan, para el contexto configurado en el iax.conf se
utiliza un proveedor VoIP/Linea telefnica para efectuar la llamada
Cuando el destinatario contesta, empieza el envo del fax
03/06/14

Curso Asterisk

IAXmodem Hylafax Recepcin

Se configura un numero geografico en Asterisk
Al numero geografico se associa un contexto.
En el contexto asociado (ej. from-did) se ponen las siguientes lineas:
[from-did]
exten => s,1,dial(IAX2/iaxmodem1)
exten => s,s,Hangup
De esta forma la llamada entrante va a la extensin iaxmodem que
corresponde al fax configurado con IAXmodem.
El programa faxgetty (parte de Hylafax) se hace cargo de contestar la
llamada
Empieza la recepcin del FAX
03/06/14

Curso Asterisk

10

Configuracin de Asterisk
Para activar el protocolo T.38:
sip.conf:
t38pt_udptl = yes,fec,maxdatagram=400
udptl.conf (protocolo de transporte de los paquetes T38)
[general]
udptlstart=4000
udptlend=4099
udptlchecksums=yes
udptlfecentries = 3
udptlfecspan = 3
use_even_ports = no

03/06/14

Curso Asterisk

11

Configuracin de Asterisk II
Para reconocer si la llamada entrante es un fax:
Parte general del sip.conf:
faxdetect = yes
Habilita el reconocimiento fax para el protocolo T30 y T38
faxdetect = cng
Habilita el reconocimiento fax solamente para el protocolo T30
faxdetect = t38
Habilita el reconocimiento fax solamente para el protocolo T38

03/06/14

Curso Asterisk

12

Configuracin de Asterisk III

En el Dialplan:
Si Asterisk reconoce que la llamada entrante procede de un
fax, utilizar la extensin especial fax
Ejempio:
[from-did]
exten => s,1,Answer
exten => s,n,Wait(4)
exten => s,n,dial(SIP/1000)
exten => s,s,Hangup
exten => fax,1,dial(IAX2/iaxmodem1)
exten => fax,n,Hangup
PS. Se aaden el answer y el wait para dar tiempo a Asterisk de reconocer el
tipo de llamada
03/06/14

Curso Asterisk

13

FAX e Protocolos

T30 El protocolo utilizado por los FAX

tradicionales

03/06/14

T38 FAX VoIP

Curso Asterisk

14

T38 - I

03/06/14

Curso Asterisk

15

T38 - II
Los datos enviados desde el terminal fax se analizan e manipulan para
ser luego paquetizados y enviados a travs de la red Internet. Para el
transporte de los paquetes (llamados IFP) se puede utilizar distintos
protocolos de transporte: UDPTL, TCP o RTP. Ser tarea de los
gateway T.38 negociar el tipo de transporte

03/06/14

Curso Asterisk

16

T38 - III
En Asterisk el nico protocolo de transporte posible es:
UDPTL

03/06/14

Curso Asterisk

17

Preguntas?

FIN

03/06/14

Curso Asterisk

18