Content
Dateianzeige für lprng_power (1.2.0)
usr/share/doc/lprng_power/lprng_power.txt
Das LPRng_power-Paket
Die Einleitung
Dieses Paket ermoeglicht das automatisierte Einschalten von Druckern
beim Eingang eines Druckauftrags und das Ausschalten nach Abschluss des
Druckauftrags ueber Netzwerkschalter der Firma Allnet vom Typ ALL3075
oder WLAN-Steckdosen welche mittels HTTP-Kommandos gesteuert werden
koennen.
Die Funktionen
Dieses Paket enthaelt keine externen Programmkomponenten.
Die Voraussetzungen
Dieses Paket benoetigt zur korrekten Funktion ein installiertes
LPRng-Paket.
Die Installation
Das LPRng_power-Paket wird ueber das Setup-Menue installiert. Wird eine
aeltere Paketversion vorgefunden, so wird diese deinstalliert bevor die
neuen Programmdateien installiert werden. Nach dem Installieren der
Programmdateien wird direkt der Konfigurations-Editor gestartet um die
Konfiguration anzupassen. Nach Beendigung dieses Schrittes werden die
Konfigurationsdateien generiert und alle benoetigten Programme
gestartet.
Das Menue im Setup-Programm
Das Menue im Setup-Programm ist wie folgt aufgebaut:
* LPRng-Power-Configuration
+ View documentation: Anzeigen der Dokumentation
+ Edit configuration: Bearbeiten der Konfiguration
+ Show/Toggle device status: Status der Netzwerkschalter
anzeigen bzw. umschalten
+ Advanced configuration file handling: Konfigurationen
verwalten
+ View Logfile: Anzeige der Logdatei
+ Return: Untermenue verlassen
Die Menuepunkte duerften selbsterklaerend sein, da sie keinerlei
weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion
nicht weiter eingegangen.
Die Aenderung der Konfiguration
Die Konfiguration kann ueber den Menuepunkt 'Edit configuration'
geaendert werden. Standardmaessig wird der Editor aufgerufen, der in
der Environment-Konfiguration ueber die Variable 'EDITOR' festgelegt
wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die
Konfiguration aktiviert werden soll. Wird dies bestaetigt, werden ueber
ein Skript die Anpassungen umgehend wirksam gemacht.
Die Konfigurationsdatei
In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind
folgende Parameter vorhanden; wer sie von Hand editieren will findet
sie unter /etc/config.d/lprng_power.
Die Parameter
START_LPRNG_POWER
Zur Aktivierung der Konfiguration muss dieser Parameter
lediglich auf den Wert 'yes' gestellt werden. Die Einstellung
'no' deaktiviert die Konfiguration.
Gueltige Werte: yes, no
Standardeinstellung: START_LPRNG_POWER='no'
LPRNG_POWER_LOAD_CONTROL_SCRIPT (optionaler Parameter)
Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird das
Laden des Kontrollskriptes forciert, welches der Ueberwachung
der LPR-Warteschlagen dient. Bei Verwendung eines USB-Druckers
wird das Kontrollskript ueblicherweise automatisch gestartet,
sodass ein manuelles Laden nicht erforderlich sein sollte.
Einzig beim direkten LPR-Drucken auf USB-Druckern kann es
notwendig sein, diesen Parameter zu aktivieren.
Gueltige Werte: yes, no
Standardeinstellung: LPRNG_POWER_LOAD_CONTROL_SCRIPT='no'
LPRNG_POWER_N
Ueber diesen Parameter wird die Anzahl der Netzwerkschalter
festgelegt welche zum Schalten von Druckern verwendet werden.
Gueltige Werte: Zahl
Standardeinstellung: LPRNG_POWER_N='0'
LPRNG_POWER_x_ACTIVE
Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird der
zugehoerige Datensatz aktiviert, 'no' deaktiviert ihn.
Gueltige Werte: yes oder no
Standardeinstellung: LPRNG_POWER_1_ACTIVE='no'
LPRNG_POWER_x_COMMENT
Dies ist ein Kommentarfeld, welches die Identifizierung des
Datensatzes erleichtern soll.
Gueltige Werte: beliebiger Text
Beispiel: LPRNG_POWER_1_COMMENT='Dies ist mein Drucker'
LPRNG_POWER_x_IPADDR
Ueber diesen Parameter legt man die IP-Adresse und TCP-Port
(optional) fest ueber welchen auf den Netzwerkschalter
zugegriffen werden kann.
Gueltige Werte: IP-Adresse und TCP-Port (optional)
Beispiel: LPRNG_POWER_1_IPADDR='192.168.6.40:80'
LPRNG_POWER_x_URL_ON
Ueber diesen Parameter legt man den URL-Pfad fest, mittels
welchem das Geraete eingeschaltet wird. Siehe auch den Absatz
[1]Geraetespezische URL-Pfade in der Dokumentation.
Gueltige Werte: URL-Pfad
Beispiel: LPRNG_POWER_1_URL_ON='/r?b=1&r=0&s=1'
LPRNG_POWER_x_URL_OFF
Ueber diesen Parameter legt man den URL-Pfad fest, mittels
welchem das Geraete ausgeschaltet wird. Siehe auch den Absatz
[2]Geraetespezische URL-Pfade in der Dokumentation.
Gueltige Werte: URL-Pfad
Beispiel: LPRNG_POWER_1_URL_OFF='/r?b=1&r=0&s=0'
LPRNG_POWER_x_URL_STATUS
Ueber diesen Parameter legt man den URL-Pfad fest, mittels
welchem der Geraetetatus abgefragt wird. Siehe auch den Absatz
[3]Geraetespezische URL-Pfade in der Dokumentation.
Gueltige Werte: URL-Pfad
Beispiel: LPRNG_POWER_1_URL_STATUS='/xml'
LPRNG_POWER_x_URL_STATUS_FILTER
Ueber diesen Parameter legt man die Filterbefehle fest mit
dessen Hilfe der Geraetestatus mittels Pipe aus der zuvor
definierten Statusabfrage extrahiert wird. Aus diesem Grund darf
natuerlich der URL-Pfad selbst NICHT den Befehlen vorangestellt
werden.
Als Ergebnis muss final das Schaltergebnis `0' (aus) oder `1'
(an) zurueck geliefert werden. Andere Ergebnisse koennen nicht
verarbeitet werden. Siehe auch den Absatz [4]Geraetespezische
URL-Pfade in der Dokumentation.
ACHTUNG
Einfache Hochkommata sind in den Befehlen NICHT erlaubt, da sie
ueblicherweise zum Einfassen der Parameterwerte verwendet
werden.
Beispiel: LPRNG_POWER_1_URL_STATUS_FILTER='sed -e "//!d"
-e "s/^.*//" -e "s/ .*$//"'
LPRNG_POWER_x_PRINTER_CAPNAME
Ueber diesen Parameter legt man den eindeutigen Namen des
Druckers fest welcher beim Eingang eines Druckauftrages
automatisch eingeschaltet werden soll. Der Name entspricht
ueblicherweise dem in der Samba-Paketkonfiguration festgelegten
Wert des Parameters SAMBA_PRINTER_x_CAPNAME.
Gueltige Werte: Druckername
Beispiel: LPRNG_POWER_1_PRINTER_CAPNAME='repr1'
LPRNG_POWER_x_AUTH
Wird dieser Parameter auf den Wert 'yes' gestellt, so kann man
einen Benutzernamen und ein Kennwort festlegen welches zur
Authentifizierung am Netzwerkschalter verwendet werden soll.
Gueltige Werte: yes, no
Standardeinstellung: LPRNG_POWER_1_AUTH='no'
LPRNG_POWER_x_USER
Ueber diesen Parameter legt man den Benutzernamen fest, welcher
zur Authentifizierung am Netzwerkschalter verwendet werden soll.
Gueltige Werte: Benutzername
Standardeinstellung: LPRNG_POWER_1_USER='admin'
LPRNG_POWER_x_PASS
Ueber diesen Parameter legt man das Kennwort fest, welches zur
Authentifizierung am Netzwerkschalter verwendet werden soll.
Gueltige Werte: Kennwort
Standardeinstellung: LPRNG_POWER_1_USER='allnet'
LPRNG_POWER_x_TIMEOUT
Ueber diesen Parameter legt man fest nach wie viel Minuten der
Netzwerkschalter nach dem Einschalten automatisiert
ausgeschaltet werden soll.
Gueltige Werte: Zeit in Minuten
Standardeinstellung: LPRNG_POWER_1_TIMEOUT='10'
Verschiedenes
Geraetespezische URL-Pfade
+ Allnet ALL3075-Netzwerksteckdose
LPRNG_POWER_1_URL_ON='/r?b=1&r=0&s=1'
LPRNG_POWER_1_URL_OFF='/r?b=1&r=0&s=0'
LPRNG_POWER_1_URL_STATUS='/xml'
LPRNG_POWER_1_URL_STATUS_FILTER='sed -e "//!d"
-e "s/^.*//"
-e "s# .*$##"'
+ OBI WLAN-Steckdose (Tasmota-ROM 5.14.0)
URL: [5]https://github.com/arendst/Sonoff-Tasmota
LPRNG_POWER_1_URL_ON='/cm?cmnd=Power%20On'
LPRNG_POWER_1_URL_OFF='/cm?cmnd=Power%20Off'
LPRNG_POWER_1_URL_STATUS='/cm?cmnd=Power%20Status'
LPRNG_POWER_1_URL_STATUS_FILTER='grep "{\"POWER\":" |
cut -d\" -f4 |
sed -e "s/ON/1/"
-e "s/OFF/0/"'
+ OBI WLAN-Steckdose (ESPEasy-ROM)
URL: [6]https://www.letscontrolit.com/wiki/index.php/ESPEasy
LPRNG_POWER_1_URL_ON='/control?cmd=gpio,5,1'
LPRNG_POWER_1_URL_OFF='/control?cmd=gpio,5,0'
LPRNG_POWER_1_URL_STATUS='/control?cmd=status,gpio,5'
LPRNG_POWER_1_URL_STATUS_FILTER='grep "state" |
cut -d" " -f2'
+ FHEM SmartHome-Server
URL: [7]https://wiki.fhem.de/
LPRNG_POWER_1_URL_ON='/fhem?cmd=set%20
%20ON&fwcsrf=&XHR=1'
LPRNG_POWER_1_URL_OFF='/fhem?cmd=set%20
%20ON&fwcsrf=&XHR=0'
LPRNG_POWER_1_URL_STATUS='/fhem?cmd=list%20
%20state&fwcsrf=&XHR=1'
LPRNG_POWER_1_URL_STATUS_FILTER='sed -e "s/^.*[ \t]ON$/1/"
-e "s/^.*[ \t]OFF$/0/'
__________________________________________________________________
Juergen Edner 2018-06-12