VoIP-Info.jp - 利用者の投稿記録 [ja]

Fax for Asterisk

2011-05-23T01:19:00Z

Junichi.yamazaki: /* FAXを送る */

{{Template:書きかけ}}
Fax for Asterisk 
Digium純正のAsterisk用FAXチャネル。 
:http://www.digium.com/en/products/software/faxforasterisk.php 
価格: Digium オンラインショップで $39/チャネル。ただし1chは無料。
==要件==
Asterisk 1.4 
Asterisk 1.6.(0,1,2) 
Asterisk 1.8 
==購入==
エンドユーザの場合には、Digiumのオンラインショップで購入します。 
:http://store.digium.com/ 
購入すると、ダウンロードURLと登録キーが送られてきます。1chのみならば無料なので無料版を利用する場合には、無料版を「購入」します。価格は$0なので、そのままチェックアウトすればライセンスキーが送られてきますので、そのキーを使って登録します。 
なお、Digiumの他のチャネル系プロダクトと同様に、このチャネル数は回線数ではなく同一のAsterisk内で同時に使用するチャネル数のことです。 
==インストール==
===プロダクトの登録===
まず、登録用のソフトregisterをダウンロードします。登録は使用するマシンのNICに基づいて行われるため、使用するAsteriskをインストールしたマシン上で行います。Linuxの場合には、wgetなどで入手するかと思いますが、その際にはchmod +x registerして./registerを実行してください。この時に、購入時に送られてきたキーが必要となります。 
Digiumの他のプロダクトもそうですが、ライセンスキーは /var/lib/asterisk/licenses/ に保存されます。このファイルは 
:F4A-xxxxxxxxxxxx.lic
のようなファイル名で、F4Aがプロダクト(Fax4Asterisk)です。 
このファイルは'''大切な'''ライセンスファイルなので、バックアップしておくことをお勧めします。 
===インストール===
まず最初にベンチマーク・ソフトをダウンロードし実行します。これにより、そのシステムに最適な選択肢が表示されますので、結果にしたがって本体のダウンロードを行います。 
ドキュメントを注意深く読み、必要なモジュールをダウンロードします。32/64bit版の他、CPUのアーキテクチャによってもモジュールが異なるので注意してください。一般的にはres_fax.soかres_fax_digium.soのどちらかのファイル名になります。バイナリ配布ですので32/64bit版またはアーキテクチャを間違えると正しく動作しないので注意してください。 
インストールは基本的にこのモジュールを/usr/lib/asterisk/modulesへコピーするだけです。 
コピーしたならばAsteriskを再起動するか、module load res_fax.so(またはres_fax_digium.so)を実行することでFAXが使用可能になります。 
==使用例==
===受信したFAXをメールで送る===
Fax for Asteriskは基本的にSendFAX()とReceiveFAX()のアプリケーションが提供されるだけなので、あとはexten内で記述します。ここではAsteriskでFAXを受信し、そのFAXをメールで送る例を記述してみます。 
受信したFAXはTIFFで保存されますので、これをPDF化してメールで送付するスクリプトを記述します。
*受信処理
ひかり電話ホーム(RT-200NEの場合)で、複数番号を契約しており、FAX番号を専用で持っている場合には着信番号別に処理を分岐します。
[hikari-in]

exten => s,1,Set(DESTNUM=${SIP_HEADER(To)})
exten => s,n,NoOp(${DESTNUM})
exten => s,n,Set(DESTNUM=${DESTNUM:1:10})
exten => s,n,NoOp(${DESTNUM})
exten => s,n,Goto(${DESTNUM},1)

exten => _03xxxxyyya,1,Dial(SIP/201) <--音声の着信の場合普通にSIP端末を呼びます

exten => _03xxxxyyyb,1,Goto(faxrec,receive,1) <--FAXの着信の場合受信処理に飛びます

受信処理は以下のようなコンテキストを記述します

[faxrec]
exten => receive,1,NoOp(**** SETTING FAXOPT ****)
exten => receive,n,Set(FAXOPT(ecm)=yes)
exten => receive,n,Set(FAXOPT(headerinfo)=NAME HERE)
exten => receive,n,Set(FAXOPT(localstationid)=813xxxxyyyb)
exten => receive,n,Set(FAXOPT(maxrate)=14400)
exten => receive,n,Set(FAXOPT(minrate)=2400)
exten => receive,n,Set(FAXFILE=${EPOCH}.tif) <--ファイル名はUNIXTIME
exten => receive,n,NoOp(**** RECEIVING FAX : ${FAXFILE} ****)
exten => receive,n,ReceiveFAX(/var/spool/asterisk/faxin/${FAXFILE}) <--受信処理

exten => h,1,System(/var/lib/asterisk/fax2mail.sh ${FAXFILE}) <--FAXをメールにするスクリプト
exten => h,n,Hangup

シェルスクリプトは以下のように記述します

#!/bin/sh

SENDTO="someone@somedomain.tld"
FROMADDR="asterisk@somedomain.tld"
DATE=`date`
SUBJECT="Fax recieved at $DATE"
SENDMAIL="sendmail -t"

FAXDIR=/var/spool/asterisk/faxin
PDFDIR=/var/spool/asterisk/faxpdf
UUE=uuencode
TIF=$FAXDIR/$1
PDF=`echo $1|sed s/\.tif/\.pdf/`
PDF=$PDFDIR/$PDF
TMP=`echo $1|sed s/\.tif/\.tmp/`
TMP=$FAXDIR/$TMP

if [ -f $TIF ] ; then
#Convert tif to pdf
tiff2pdf -o$PDF $TIF

#build envelop
echo "From: $FROMADDR" > $TMP
echo "To: $SENDTO" >> $TMP
echo "Subject: $SUBJECT" >> $TMP
echo "" >> $TMP

#Encode pdf and send it to recipent
uuencode $PDF < $PDF >> $TMP
cat $TMP | $SENDMAIL

rm -f $TMP
else
exit
fi

このような感じで処理すればFAX(TIFF)をPDF化してメールで送ることができます。

===FAXを送る===

FAX送信はDigiumのPDFマニュアルに従って、extensions.confに[fax-tx]のコンテクストを作って、以下のようなコマンドをCLIで打てば予め作っておいたTIFFファイルを送信できます。

CLI> originate DAHDI/4/03xxxxxxx extension send@fax-tx

Fax for Asterisk

2011-05-21T14:06:26Z

Junichi.yamazaki: /* 受信したFAXをメールで送る */

Fax for Asterisk

2011-05-21T14:02:32Z

Junichi.yamazaki: /* 受信したFAXをメールで送る */

{{Template:書きかけ}}
Fax for Asterisk 
Digium純正のAsterisk用FAXチャネル。 
:http://www.digium.com/en/products/software/faxforasterisk.php 
価格: Digium オンラインショップで $39/チャネル。ただし1chは無料。
==要件==
Asterisk 1.4 
Asterisk 1.6.(0,1,2) 
Asterisk 1.8 
==購入==
エンドユーザの場合には、Digiumのオンラインショップで購入します。 
:http://store.digium.com/ 
購入すると、ダウンロードURLと登録キーが送られてきます。1chのみならば無料なので無料版を利用する場合には、無料版を「購入」します。価格は$0なので、そのままチェックアウトすればライセンスキーが送られてきますので、そのキーを使って登録します。 
なお、Digiumの他のチャネル系プロダクトと同様に、このチャネル数は回線数ではなく同一のAsterisk内で同時に使用するチャネル数のことです。 
==インストール==
===プロダクトの登録===
まず、登録用のソフトregisterをダウンロードします。登録は使用するマシンのNICに基づいて行われるため、使用するAsteriskをインストールしたマシン上で行います。Linuxの場合には、wgetなどで入手するかと思いますが、その際にはchmod +x registerして./registerを実行してください。この時に、購入時に送られてきたキーが必要となります。 
Digiumの他のプロダクトもそうですが、ライセンスキーは /var/lib/asterisk/licenses/ に保存されます。このファイルは 
:F4A-xxxxxxxxxxxx.lic
のようなファイル名で、F4Aがプロダクト(Fax4Asterisk)です。 
このファイルは'''大切な'''ライセンスファイルなので、バックアップしておくことをお勧めします。 
===インストール===
まず最初にベンチマーク・ソフトをダウンロードし実行します。これにより、そのシステムに最適な選択肢が表示されますので、結果にしたがって本体のダウンロードを行います。 
ドキュメントを注意深く読み、必要なモジュールをダウンロードします。32/64bit版の他、CPUのアーキテクチャによってもモジュールが異なるので注意してください。一般的にはres_fax.soかres_fax_digium.soのどちらかのファイル名になります。バイナリ配布ですので32/64bit版またはアーキテクチャを間違えると正しく動作しないので注意してください。 
インストールは基本的にこのモジュールを/usr/lib/asterisk/modulesへコピーするだけです。 
コピーしたならばAsteriskを再起動するか、module load res_fax.so(またはres_fax_digium.so)を実行することでFAXが使用可能になります。 
==使用例==
===受信したFAXをメールで送る===
Fax for Asteriskは基本的にSendFAX()とReceiveFAX()のアプリケーションが提供されるだけなので、あとはexten内で記述します。ここではAsteriskでFAXを受信し、そのFAXをメールで送る例を記述してみます。 
受信したFAXはTIFFで保存されますので、これをPDF化してメールで送付するスクリプトを記述します。
*受信処理
ひかり電話ホーム(RT-200NEの場合)で、複数番号を契約しており、FAX番号を専用で持っている場合には着信番号別に処理を分岐します。
[hikari-in]

exten => s,1,Set(DESTNUM=${SIP_HEADER(To)})
exten => s,n,NoOp(${DESTNUM})
exten => s,n,Set(DESTNUM=${DESTNUM:1:10})
exten => s,n,NoOp(${DESTNUM})
exten => s,n,Goto(${DESTNUM},1)

exten => _03xxxxyyya,1,Dial(SIP/201) <--音声の着信の場合普通にSIP端末を呼びます

exten => _03xxxxyyyb,1,Goto(faxrec,receive,1) <--FAXの着信の場合受信処理に飛びます

受信処理は以下のようなコンテキストを記述します

[faxrec]
exten => receive,1,NoOp(**** SETTING FAXOPT ****)
exten => receive,n,Set(FAXOPT(ecm)=yes)
exten => receive,n,Set(FAXOPT(headerinfo)=NAME HERE)
exten => receive,n,Set(FAXOPT(localstationid)=813xxxxyyyb)
exten => receive,n,Set(FAXOPT(maxrate)=14400)
exten => receive,n,Set(FAXOPT(minrate)=2400)
exten => receive,n,Set(FAXFILE=${EPOCH}.tif) <--ファイル名はUNIXTIME
exten => receive,n,NoOp(**** RECEIVING FAX : ${FAXFILE} ****)
exten => receive,n,ReceiveFAX(/var/spool/asterisk/faxin/${FAXFILE}) <--受信処理

exten => h,1,System(/var/lib/asterisk/fax2mail.sh ${FAXFILE}) <--FAXをメールにするスクリプト
exten => h,n,Hangup

シェルスクリプトは以下のように記述します

#!/bin/sh

SENDTO="someone@somedomain.tld"
FROMADDR="asterisk@somedomain.tld"
DATE=`date`
SUBJECT="Fax recieved at $DATE"
SENDMAIL="sendmail -t"

FAXDIR=/var/spool/asterisk/faxin
PDFDIR=/var/spool/asterisk/faxpdf
UUE=uuencode
TIF=$FAXDIR/$1
PDF=`echo $1|sed s/\.tif/\.pdf/`
PDF=$PDFDIR/$PDF
TMP=`echo $1|sed s/\.tif/\.tmp/`
TMP=$FAXDIR/$TMP

if [ -f $TIF ] ; then
#Convert tif to pdf
tiff2pdf -o$PDF $TIF

#build envelop
echo "From: $FROMADDR" > $TMP
echo "To: $SENDTO" >> $TMP
echo "Subject: $SUBJECT" >> $TMP
echo "" >> $TMP

#Encode pdf and send it to recipent
uuencode $PDF < $PDF >> $TMP
cat $TMP | $SENDMAIL

rm -f $TMP
else
exit
fi

このような感じで処理すればFAX(TIFF)をPDF化してメールで送ることができます。

FAX送信はDigiumのPDFマニュアルに従って、extensions.confに[fax-tx]のコンテクストを作って、以下のようなコマンドをCLIで打てば予め作っておいたTIFFファイルを送信できます。

CLI> originate SIP/03xxxxxxx@fusion1 extension send@fax-tx

YAMAHA RT57i

2010-10-05T10:26:02Z

Junichi.yamazaki: /* RT57i設定 */

RT57iには、局線収容できるISDN(FXO)が１ポート付いていますが、このポートをSIPにつなげることは現在のファームではできないようです。（おそらく今後のバージョンでも無理）AsteriskにISDNを収容せずに、RT57iにつないだ、アナログ電話機にISDNを着信させることはできます。イメージは下記の通りです。

+------+
| ISDN |
+------+
↑
+--------+ +-------+
|Asterisk| <--Regist-- | RT57i |TEL1--- アナログ電話機(201)
+--------+ +-------+TEL2--- アナログ電話機(202)
ナンバーディスプレイのアナログ電話機にも対応しています。 
===設定例===
YAMAHA系のルーターでVoIP機能付きであれば、ほぼ同じ設定でいけるでしょう。 
sip.conf
[general]
context=internal
bindport=5060
bindaddr=0.0.0.0
srvlookup=yes
disallow=all
allow=ulaw
allow=alaw
allow=gsm
allow=ilbc
language=jp

[201]
type=friend
username=201
secret=pass
canreinvite=no
host=dynamic
callgroup=1
pickupgroup=1
mailbox=201
dtmfmode=inband
context=internal

[202]
type=friend
username=202
secret=pass
canreinvite=no
host=dynamic
callgroup=1
pickupgroup=1
mailbox=202
dtmfmode=inband
context=internal
===RT57i設定===
analog device type 1 tel
analog sip arrive permit 1 myname
analog sip call myname 1 sip:201
analog sip call display name 1 201
analog arrive number display 1 on
analog device type 2 tel
analog sip arrive permit 2 myname
analog sip call myname 2 sip:202
analog sip call display name 2 202
analog arrive number display 2 on
analog extension other-dial-tone off
analog extension dial prefix port=1 sip server=1
analog extension dial prefix port=2 sip server=2
sip use on
sip server 1 [Asterisk IP] register udp sip:201@[Asterisk IP] 201 pass name=ASTERISK
sip server 2 [Asterisk IP] register udp sip:202@[Asterisk IP] 202 pass name=ASTERISK

Grandstream HT286

2009-12-03T07:30:19Z

Junichi.yamazaki:

http://www.grandstream.com/products/ht_series/ht286/ht286.html

問題なく、Asterisk 1.4.26.2と動作しました。
DHCPで受け取った、IPアドレスは、内蔵IVRで確認できます（英語が聞き取りにくい）。
あとは、Webで設定するだけです。
FAXも問題なく通りました。

Telephonydepotで$28.95で売っていました(2009/12/1)。

アナログ電話機の接続

2009-12-03T07:23:25Z

Junichi.yamazaki: /* ATA(Analog Telephone Adapter) */

Asteriskと普通のアナログ電話機を接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]
==ATA(Analog Telephone Adapter)==
*[[Linksys SPA3102]]
*[[Linksys PAP2T]]
*[[Digium IAXy]]
*[[Grandstream HT286]]

==VoIPルータ==
*[[ICOM SR-5200]]　(メーカー製造中止)
*[[YAMAHA RT57i|YAMAHA RT57i/RT58i]]
*[[YAMAHA RTV700]]

==VoIPゲートウェイ==
*[[Quintum]]
*Grandstream GXW4004,GXW4008,GXW4024（FXSタイプ）
*Grandstream GXW4104,GXW4108（FXOタイプ）
*MultiTech MultiVOIP210
*MultiTech MultiVOIP410
*MultiTech MultiVOIP810
==変なアナログ電話機==
*[[STP1960]]

Grandstream HT286

2009-12-03T07:23:08Z

Junichi.yamazaki: 新しいページ: 'http://www.grandstream.com/products/ht_series/ht286/ht286.html'

http://www.grandstream.com/products/ht_series/ht286/ht286.html

RT-200KI

2009-09-30T14:04:17Z

Junichi.yamazaki: Asterisk 1.4ではinsecure=inviteがいいみたいです。

[[Category:Asterisk]]
[[Category:ひかり電話]]
[[Category:VoIPアダプタ]]

RT-200KIは、NTT東日本の「ひかり電話」サービスで貸与されるルータ兼VoIP TAです。
==RT-200KIの「内線番号」について==
RT-200KIは、自身がSIP Proxy機能を持っています。内線番号の割当ては以下の通りです。
1, 2: アナログ電話機ポート1, 2
3～7: IP電話機 1～5

ただし、同時に「有効」と設定できるのは最大5つまでです。（出荷時設定は1～5までが有効）
また、IP電話機について、認証用のユーザ名とパスワードを設定することが出来ます。（出荷時設定はユーザ名が内線番号4ケタ、パスワードはLAN側MACアドレス＋内線番号2ケタ）
==Asteriskの設定==
===sip.conf===
RT-200KIのIPアドレスを192.168.0.2としています。Asteriskで使うRT-200KIの内線番号は4です。

[general]
context=default
port=5060
bindaddr=0.0.0.0
srvlookup=no
disallow=all
allow=ulaw
allow=alaw
language=jp
defaultexpirey=3600
　
register => 4:<パスワード>:0004@192.168.0.2/<電話番号>
　
[ntttel]
type=friend
username=0004
secret=<パスワード>
host=192.168.0.2
canreinvite=no
dtmfmode=inband
disallow=all
allow=ulaw
allow=alaw
context=fromntttel
insecure=invite

RT-200KIは、Expiresが3600未満だとREGISTER時にエラーとするため、[general]に「defaultexpirey=3600」を設定してます。 
ナンバーディスプレイ未契約だと着信時のFrom:が「<sip:anonymous@anonymous.invalid>」になるのが悪いのか、着信出来なかったので「insecure=invite」を付けています。

===extensions.conf===
市街局番からダイヤルするか、1688をつけるとRT-200KI経由で通話できるようにしています。

[globals]
NTTNUMBER=<電話番号>
　
[default]
; 0 : NTT Hikari-denwa
exten => _0.,1,Macro(checkcallout)
exten => _0.,2,SetCallerId,4
exten => _0.,3,Dial(SIP/${EXTEN}@ntttel,60,r)
exten => _0.,4,Congestion
　
; 1688 : NTT Hikari-denwa
exten => _1688.,1,SetCallerId,4
exten => _1688.,2,Macro(checkcallout)
exten => _1688.,3,Dial(SIP/${EXTEN:4}@ntttel,60,r)
exten => _1688.,4,Congestion
　
[fromntttel]
exten => ${NTTNUMBER},1,Dial(SIP/203&SIP/205,30,tw)
exten => ${NTTNUMBER},2,Macro(rusuden)
exten => ${NTTNUMBER},3,HangUp
exten => ${NTTNUMBER},102,Macro(rusuden)
exten => ${NTTNUMBER},103,HangUp
　
;これより下と、上の「Macro」行は、RT-200KIには直接関係ないです。
　
[macro-checkcallout]
exten => s,1,SetGlobalVar(ORGNO=${ACCOUNTCODE})
exten => s,2,GotoIf($[${ORGNO} = 1]?10)
exten => s,3,PlayBack(privacy-unident)
exten => s,4,Busy
exten => s,10,NoOp
　
;Rusuban-voicemail
[macro-rusuden]
exten => s,1,Answer
exten => s,2,Wait(1)
exten => s,3,VoiceMail(201)
exten => s,4,HangUp

SetCallerIDでRT-200KIの内線番号を設定しないと発信できないようなので、「SetCallerId,4」を付けています。