Serial-plugin

Version vom 4. August 2013, 14:30 Uhr

Beschreibung

Autor: Ralf Klueber

Mit diesem Plugin lässt sich der VDR über Hardware-Tasten steuern, die an die serielle Schnittstelle angeschlossen sind. Zusätzlich lassen sich eine oder zwei Leuchtdioden ansteuern.

Für die Nutzung des Paralleports gibt es dieses Plugin: Parout-Plugin

Bilder

Einstellungen

Hardwareanforderungen

• Eine kleine Schaltung, die an die serielle Schnittstelle angeschlossen wird.

Schaltplan

Schaltplan

Funktionen der LED´s

LED1 = Status plugin geladen

LED2 = Status Aufnahme

Die zweite LED leuchtet bei einer aktiven Aufnahme und blinkt, wenn keine TV-Karte mehr frei für weitere Aufnahmen ist. Bei Systemen mit nur einer TV-Karte würde die LED bei aktiver Aufnahme immer blinken, da die eine vorhandene Karte für die Aufnahme gebraucht wird. Bei Systemen mit zwei TV-Karten würde die LED bei einer Aufnahme leuchten, da die zweite Karte noch "frei" ist, sie beginnt erst zu blinken, wenn auch die zweite Karte durch eine Aufnahme im Einsatz ist.

Ein kompletter Hardwareausbau ist nicht immer erforderlich und kann den persönlichen Ansprüchen und Erfordernissen angepasst werden. Damit ist eine teilweise Bestückung möglich, so können nur Taster oder nur die Anzeige per LED verwendet werden. Ein Vorwiderstand für die LED wird in der Regel nicht benötigt, da die meisten seriellen Ports eine Konstantstromquelle mit 10-20 mA darstellen. Aus Gründen der Helligkeitssteuerung empfiehlt es sich einen Vorwiderstand mit 1 kOhm bei normalen Anzeige-LEDs (rot, gelb, grün) zu verwenden.

Ein eventuelles Prellen der Tasten lässt sich durch parallel schalten eines zusätzlichen Kondensators (1 nF) zu jedem Taster beheben (Tiefpass). Mit der Softwareversion v0.0.6b ist dies nicht mehr erforderlich.

Nach Start des Plugins sollten etwa +12V zwischen Pin 4 und 5 der serielle Schnittstelle anliegen. Das ist LED1. Zwischen PIN7 und PIN5 liegen etwa -12V bei Ansteuerung. Massepunkt ist immer PIN5.

Die Belegung der externen seriellen Schnittstelle des PC ist hier beschrieben. Für die genaue Belegung einer internen seriellen Schnittstelle sollte das Handbuch des jeweiligen Mainboards berücksichtigt werden.

Softwareanforderungen

Beim Starten des Betriebsystems muss die serielle Schnittstelle initialisiert werden: /bin/setserial /dev/ttyS0 uart 16550A

Start beim VDR-Start durch Eintrag in die RunVDR:

-Pserial /dev/ttyS0'\

Übliche Zuordnung Schnittstellen zum Linux-Device:

• COM1: /dev/ttyS0
• COM2: /dev/ttyS1
• COM3: /dev/ttyS2

In der setup.conf gibt es diese Parameter für das Plugin:

serial.Flashrate = 5
serial.KeyPressDelay = 0
serial.Port = 1

Die Taster werden wie eine Fernbedienung in der remote.conf angelernt. Bei der Aufforderung irgendeine Taste zu drücken (Phase 1), muss jedoch eine Taste auf der Tastatur gedrückt werden, NICHT ein Taster an der seriellen Schnittstelle!

zum Beispiel:

Serial.Up Button11
Serial.Down Button7
Serial.Menu Button10
Serial.Ok Button6
Serial.Back Button9
Serial.Left Button12
Serial.Right Button14
Serial.Red Button8
Serial.Green Button1
Serial.Yellow Button4
Serial.Blue Button2

Die Zuordnung kann dann später dort auch beliebig geändert werden.

Patches

Der folgende Patch macht das Plugin wieder kompatibel für Versionen >= 1.4. Weiterhin fügt er zusätzliche Einträge ins syslog ein, die zur Fehlersuche sehr nützlich sein können.

--- serial.c	2005-07-22 12:48:36.000000000 +0200
+++ serial.c	2007-07-30 18:52:48.135644033 +0200
@@ -72,7 +72,7 @@
   int iNumDevices;
 
 protected:
-  virtual void Recording(const cDevice *Device, const char *Name);
+  virtual void Recording(const cDevice *Device, const char *Name, const char *FileName, bool On);
 
 public:
   int GetLedStatus(int i);
@@ -95,11 +95,15 @@
   int i;
 
   for(i=0; i<iNumDevices; i++) 
-    if(iCardIsRecording[i])
-		iOccupiedDevices++;
-  
+    if(iCardIsRecording[i]) {
+	    iOccupiedDevices++;
+    }
+
   if((iNumDevices == iOccupiedDevices) && (iOccupiedDevices >0)) // Blinken
   {
+    dsyslog("[serial] all cards are recording");
     for(i=0; i<SerialSetup.iFlash; i++)
 		iLedStatus[i] |=  LEDREC; // Bit setzen
     for(i=SerialSetup.iFlash; i<MAXCYCLE; i++)
@@ -107,28 +111,39 @@
   }
   else if(iOccupiedDevices > 0) // Dauerleuchten
   {
+    dsyslog("[serial] %i cards are recording",iOccupiedDevices);
     for(int i=0;i<MAXCYCLE;i++)
 		iLedStatus[i] |=  LEDREC; // Bit setzen
   }
   else // LED aus
   {
+    dsyslog("[serial] no card is recording");
     for(int i=0;i<MAXCYCLE;i++)
 		iLedStatus[i] &= ~LEDREC; // Bit loeschen
   }
   return iLedStatus[i % MAXCYCLE];
 }
  
-void cSerialStatus::Recording(const cDevice *Device, const char *Name)
+
+ // The given DVB device has started (On = true) or stopped (On = false) recording "Name".
+ // Name is the name of the recording, without any directory path. The full file name
+ // of the recording is given in FileName, which may be NULL in case there is no
+ // actual file involved. If On is false, Name may be NULL.
+
+void cSerialStatus::Recording(const cDevice *Device, const char *Name, const char *FileName, bool On)
 {
-	int iCardIndex = Device->CardIndex();
-	iNumDevices = Device->NumDevices();
+	int iCardIndex = Device->CardIndex(); // Returns the card index of this device (0 ... MAXDEVICES - 1).
+	iNumDevices = Device->NumDevices();   // Returns the total number of devices.
 
 	if(iCardIndex < MAXDEVICES)
 	{ 
-		if(Name && Name[0])
+		if(Name && Name[0]) {
 			iCardIsRecording[iCardIndex]++;
-		else
+			dsyslog("[serial] card %i starts recording",iCardIndex);
+		} else {
 			iCardIsRecording[iCardIndex]--;
+			dsyslog("[serial] card %i stops recording",iCardIndex);
+		}
 	}
 }

Links

1. Homepage des Plugins
2. Release-Thread
3. erweitertes Diag-Tool
4. nützliche Tips zum Plugin
5. v0.0.6b gegen Prellen
6. v0.0.6c ab VDR >1.3.38 aber wohl Probleme mit Tasten