====== FCPCI auf openSUSE Leap 42.1 ======

===== Installieren =====
Alle folgenden Schritte als root ausführen:

Installieren von ISDN, capi und fcpci (rpm-Pakete inklusive Devel-Paket für capi4linux installieren):

1. Installieren von ISDN und capi aus der Distribution z.B. über yast:

{{:fcpci:screenshot_20160527_135413.png|}}

{{:fcpci:screenshot_20160527_162003.png|}}

2. Installieren des fcpci-Treibermoduls von der Hauptseite passend zur aktuellen Kernelversion (uname -a) der Distribution

3. Installieren von capisuite nach Download aus der Distribution 13.2 (fehlt in Leap 42.1)

http://download.opensuse.org/distribution/13.2/repo/oss/suse/x86_64/

<code>
rpm -Uhv capisuite-0.4.5-266.1.3.x86_64.rpm     
</code>


===== Einrichten und Starten =====
Alle Schritte als root ausführen:

1. /etc/modprobe.d/50-blacklist.conf anpassen gemäß Anleitung (fcpci zulassen, avmfritz, mISNDipac sperren)

2. /etc/capisuite/fax.conf anpassen. Die notwendige Anpassung ist dort beschrieben. Datei nach der Anpassung sichern!

3. Starten von capi, isdn, capisuite

  * **capiinit** ausführen (Fehler zu Modul capifs ignorieren) 
  * Falls eine Meldung erfolgt, dass /etc/capi.conf fehlt, Datei anlegen und //fcpci// eintragen (weitere Optionen siehe capiinit /h): 
<code>
echo "fcpci" > /etc/capi.conf
</code>
  * **capiinit reload** (erneut) ausführen
  * **rcisdn start** ausführen
  * **rcisdn status** ausführen --> Egebnis: active (exited)
  * **rccapisuite start** ausführen
  * **rccapisuite status** ausführen --> Ergebnis: active (running)

capisuite schreibt die Log-Dateien capisuite.log, capisuite.error in /var/log
   
3. Starten des isdnlogs

  * Aliase ergänzen, falls nicht bereits vorhanden:
<code>
echo "alias char-major-43     capidrv" >> /etc/99-local.conf
echo "alias char-major-44     capidrv" >> /etc/99-local.conf
echo "alias char-major-45     capidrv" >> /etc/99-local.conf
</code>

  * isdnctr-Device und isdninfo-Device anlegen, falls nicht bereits vorhanden
<code>
mknod /dev/isdnctrl0 c 45 64 2>/dev/null
mknod /dev/isdninfo c 45 255 2>/dev/null
</code>

  * capi-Driver laden
<code>
modprobe capidrv
</code>

  * isdnlog im Hintergrund starten (weitere Optionen über man pages)
<code>
isdnlog -D /dev/isdnctrl0
</code>

isdnlog wird über die Konfigurationsdateien in /etc/idsn eingerichtet

isdnlog schreibt die Log-Datei /var/log/isdn.log

===== FAQ / Hinweise =====
  - Faxversand über **capisuitefax -d**//<Faxnummer>//  //<PDF/PS-Datei>//
  - der User muss zum faxen in /etc/capisuite/fax.conf konfiguriert sein
  - Kopien der Sende-/Empfangs-Dateien befinden sich im Pfad /var/spool/capisuite 
  - CapiSuite akzeptiert nicht alle PDFs: zum Testen einen kurzen Text in Libreoffice erstellen und als PDF exportieren
  - CapiSuite Fehlercodes siehe Dokumentation: http://www.capisuite.org/manual.php
  - **rccapisuite restart** muss nach jeder Änderung der CapiSuite-Konfiguration /etc/capisuite/fax.conf erneut ausgeführt werden
  - eine Neuinstallation von capisuite überschreibt die alte Konfiguration in /etc/capisuite
  - Mailversand über die Capisuite-Option "MailAndSave" erfordert einen installierten Mailserver (z.B. postfix), der ggf. zum Versand an einen ext. Provider für TLS konfiguriert.
  - zum gelegentlichen Faxversand eignet sich KDE-Printfax
      * User der Gruppe "fax" hinzufügen (-> Benutzerverwaltung) 
      * KDE3 nachinstallieren 
      * kdeprintfax befindet sich im Paket kdebase3
      * Kdeprintfax konfiguieren:
          * in Fax System Selection als Command: 
              * /usr/bin/capisuitefax -d %number %files, 
          * in Filters Configuration als Filter: 
              * Mime Type: application/pdf, Command: pdf2ps %in %out)


__Hilfen__
  * mit **hwinfo  - -isdn** prüfen, ob die Karte physikalisch erkannt wird
  * nach capiinit
      * mit **dmesg** prüfen ob der capi gestartet, und der fcpci-Treiber geladen ist oder
      * mit **lsmod | grep fcpci** prüfen, ob die Treiber fcpci und capi geladen sind
      * mit **capiinfo** prüfen ob CAPI die Karte erkannt hat

   * bei unklarem Status die Module stoppen und neuladen: 
      * **rccapisuite stop**
      * **rcisdn stop**
      * **capiinit stop**
      * **capiinit reload**
      * **rcisdn restart**
      * **rccapisuite restart**

  * zum verlässlichen Reset der FCPCI-Karte Rechner rebooten mit etwas Wartezeit vor dem erneuten Einschalten

----

__Protokoll-Beispiel __ 
<code>
//erfolgreicher FAX-Versand an sich selbst über den 2. B-Kanal (unterschiedliche Sende- und Empfangs- MSN, entsprechend in fax.conf konfiguriert)//
Protokollverlauf in /var/log/capisuite.log:
Fri May 27 17:51:25 2016 CapiSuite 0x7ffc010401d0: CapiSuite 0.4.5 started.
Fri May 27 17:51:25 2016 Capi 0xd51a90: Registered successful at CAPI with ApplId 1
Fri May 27 17:51:25 2016 CapiSuite 0x7ffc010401d0: 1 controllers found
Fri May 27 17:52:28 2016 CapiSuite 0x7ffc010401d0: job fax-01.sff from //<name>// to //<Empfangs-MSN>// initiated
Fri May 27 17:52:28 2016 Connection 0x7fa1c80370f0: Connection object created for outgoing call from //<Sende-MSN>// to //<Empfangs-MSN>// service 1
Fri May 27 17:52:29 2016 Connection 0x7fa1c0000920: Connection object created for incoming call PLCI 513 from //<Sende-MSN>// to //<Empfangs-MSN>// CIP 0x4
Fri May 27 17:52:29 2016 Connection 0x7fa1c0000920: call from //<Sende-MSN>// to //<Empfangs-MSN>// for //<name>// connecting with fax
Fri May 27 17:52:29 2016 Connection 0x7fa1c0000920: accepting with service 1
Fri May 27 17:52:45 2016 Connection 0x7fa1c80370f0: disconnect initiated
Fri May 27 17:52:45 2016 Connection 0x7fa1c0000920: disconnect initiated
Fri May 27 17:52:45 2016 Connection 0x7fa1c0000920: connection lost with cause 0x3490,0x0
Fri May 27 17:52:45 2016 Connection 0x7fa1c80370f0: Connection object deleted
Fri May 27 17:52:45 2016 CapiSuite 0x7ffc010401d0: job fax-01.sff: result was 3490,0
Fri May 27 17:52:45 2016 CapiSuite 0x7ffc010401d0: job fax-01.sff: finished successfully
Fri May 27 17:52:45 2016 Connection 0x7fa1c0000920: Connection object deleted
</code>