Subsections


1.1 FAXRCV


1.1.1 OPT_FAXRCV - Receiving Faxes By the Help Of The AVM-Capi

This package enables fli4l to receive Faxes with a CAPI-capable ISDN Card. Read the documentation to learn which drivers are needed.

Cling to the following hints concerning your hardware:

Receiving Faxes with passive ISDN adapters will generate heavy CPU load. According to my experience a Pentium will work without problems.

FAXRCV_START_AT_BOOT
If this variable is set to 'yes' Fax receiving will be activated during boot. If set to 'no', Fax receiving has to be started on the Web GUI or console via 'faxrcv.sh start'.

Default Setting: FAXRCV_START_AT_BOOT='yes'

FAXRCV_N

Set the number of capifaxrcvd services to be configured here (on how many MSN's should Faxes be received). This is useful i.e. if separate MSN's and directories should be set for various users. If only one capifaxrcvd should be started, set '1' here.

Default Setting: FAXRCV_N='1'

FAXRCV_x_CSID

Specify the Station ID that the daemon should transmit to Fax callers. This should be your own Fax number. Keep in mind that capifaxrcvd is only able to handle digits and some special chars.

A CSID like this would make sense: (123-456).

Default Setting: FAXRCV_x_CSID='+49(00)00000'


Please don't use spaces, replace them by dashes!

FAXRCV_x_NUMBER

Specify the MSN on which the daemon should receive Faxes here. Usually this is your own number without area prefix.


Phone boxes may change this number in some cases!

If not sure make a call with your own Fax number and see which number appears in the telmond-log as the caller ID.

Default Setting: FAXRCV_x_NUMBER='0'

FAXRCV_x_DIRECTORY

Set the directory here to which capifaxrcvd should save received Faxes.

Default Setting: FAXRCV_x_DIRECTORY='/data/fax'

FAXRCV_x_NTFYCMD_N

How many Notify-commands should be executed (see below)?

Default Setting: FAXRCV_x_NTFYCMD_N='0'

FAXRCV_x_NTFYCMD_x

This command is executed if a Fax has arrived. As a parameter the absolute path including the name of the fax file and the MSN (FAXRCV_x_NUMBER) with which the Fax was received will be provided. You may leave this variable empty. SeeOPT_CAPIFAXBLINK in this context.

Default Setting: FAXRCV_x_NTFYCMD_x=''

FAXRCV_IMONC_LIST

Provide the numbers of FAXRCV_N that should be reached via imonc. If no list of received Faxes should be generated for imonc set '0' here. Entries have to be divided by spaces. Remeber that you will have to define their FAXRCV_IMONC_DIR.

Default Setting: FAXRCV_IMONC_LIST='1', e.g. the phone number defined by FAXRCV_1_NUMBER.

FAXRCV_IMONC_DIR

This variable is needed only if more than one MSN should be reachable via Imonc and has to be put in the config file manually. It should contain a directory where the logfile is present for Imonc. This directory must differ from all settings in FAXRCV_x_DIRECTORY and should be located on a permanent storage because otherwise access to all Faxes will be lost after a reboot.

Beispiel: FAXRCV_IMONC_DIR='/data/fax/imonc'

Default Setting: This variable is not contained in the standard config file.

FAXRCV_HTTPGUI
The package also provides a Web GUI for mini-httpd that may be activated with OPT_FAXRCV_HTTPGUI.

FAXRCV_HTTPGUI_CONVERT

Activate direct Fax viewing in the Web GUI here. This will install the program sff2misc on the router, which is used to convert sff-Faxfiles to JPEG files dynamically. To use this feature you will need some additional storage (about one MB for a Fax containing four pages). The conversion will take some seconds. So for obvious reasons don't be impatient and don't click twice...

By using FAXRCV_HTTPGUI_CONVERT='yes' JPEGs with aspect ratio automatically adapted to the Fax resolution will be generated.

FAXRCV_HTTPGUI_CONVERT='no' deactivates this feature.

Default Setting: FAXRCV_HTTPGUI_CONVERT='yes'

The package contains an additional module to be used with OPT_OLED. It makes the Caps-LED on the keyboard blink if a directory contains a file. In case of the Fax directory this means: a Fax has been received.


Don't use together with OLED_BLINK!

OLED_DIRBLINK_DIR

Set the directory to be monitored here.

Default Setting: OLED_DIRBLINK_DIR='/data/fax'

In case you don't want to use OPT_OLED_DIRBLINK (i.e. for spinning down the harddisk), you may use the following replacement and activate OPT_CAPIFAXBLINK.

It works like this: If a Fax is received, a file will be saved to RAM. This may be entered in OLED_BLINK (OLED_BLINK_FILE='/var/run/capifaxnotify'). The disadvantage is that after loading the Faxes from the router this file has to be deleted explicitely (CapiClient supports this function as of version 0.16).


You will have to enter '/usr/local/bin/capifaxnotify.sh' in FAXRCV_NTFYCMD though.

1.1.2 Fax Download

You may download the Faxes either with Imonc (see FAXRCV_IMONC_LIST), with the CapiClient (http://fli4l.tribut.de/) or from the Web GUI (http://fli4l/ resp. http://<router_name>/) in the menu ISDNFaxes. The sff file format is supported in Fritz!Fax and IrfanView, for example.

The rights for viewing, deleting and switching Fax receiving on and off can be defined separately for the httpd. In HTTPD_RIGHTS_N you have to provide isdnfax:view, isdnfax:delete resp. isdnfax:startstop then. A user with rights all is allowed to.. guess what :)

1.1.3 Author

This package was integrated by Felix Eckhofer (email: felix@fli4l.de).

© 2001-2015 The fli4l-Team - 27 January 2015