***************************************************
***  Informationen zum Programm EDL_SML_zaehler ***
***************************************************

---------------------------------------------------
Datei:		EDL_SML_decode_20170711_2200.py
Versionsdatum:	11.07.2017

Dieses Programm liest die über die Infrarotschnittstelle des Stromzählers gesendeten Datentelegramme per TTY-Schnittstelle aus, dekodiert sie und legt sie auf der lokalen Festplatte ab.



Notwendige Dateien:
	configSERVER.txt

Notwendige Hardware:
	TTY-Dekodiereinheit mit Infrarot Empfangsdiode



---------------------------------------------------
Datei:		Socket_HOST_20170711_2200.py
Versionsdatum:	11.07.2017

In dieser Datei wird ein multifunktionaler Socket-SERVER gestartet, der permanent auf Anfragen anderer Rechner 'lauscht'.
Wird eine korrekte Anfrage erkannt, werden die entsprechenden Dateien an den aufrufenden Rechner gesendet.

Notwendige Dateien:
	configSERVER.txt

Optionale Dateien:
	startServer.sh
	Beispiel für Autostart: CRONjob.txt



---------------------------------------------------
Datei:		configSERVER.txt
Versionsdatum:	12.07.2017

In dieser Datei werden sowohl verschiedene Konfigurations-einstellungen für den SERVER, als auch Datenpfad und Dateiname für die lokal zu speichernden EDL-Daten vorgegeben.

Parameter:
   port: 	Portnummer, der für Anfragen abgefragt werden soll

   basispfad:	BasisPfade für die verschiedenen Anfragetypen
		(je 'getprefix' ein Absoluter Pfad,
		durch Komma getrennt)

   getprefix:	Alle Anfrage'Prefixe', auf die der SERVER antworten
		soll (jeweils durch Komma getrennt)

   EDLdaten:	Absoluter Datenpfad und Anfangsnamen für die 
		Speicherung der dekodierten EDL-Daten des Zählers.




###############################################################################
ALLE voranstehenden Dateien müssen sich im gleichen, lokalen Verzeichnis befinden
#################################################################################




---------------------------------------------------
Datei:		startServer.sh
Versionsdatum:	12.07.2017

In dieser Datei steht das Script zum Starten des HOST-Servers. Wird diese Datei in einer Shell gestartet, läuft das HOST-Programmm solange, wie die Shell läuft. Sollte der Server unabhängig von der Laufzeit der Shell funktionieren, ist das Programm mit 'nohup sudo programmname &' zu starten. Damit wird die Shell angewiesen, das Programm unabhängig von der Shell zu starten (nohup = not hangup). Das Kaufmannsund '&' am Ende ist ebenfalls wichtig und weist die Shell an, das Programm im Hintegrund zu starten. Dieses ist bei mit im absoluten Verzeichnis '/usr/eigen/' abgelegt. (Das Unzerverzeichnis 'eigen' habe ich dazu zunächst manuell erstellt)

Diese Datei kann 1. manuell oder 2. per cronjob gestartet werden.

1. In einer Shell den Befehl 'sudo /usr/eigen/startServer.py'  oder 'nohup sudo /usr/eigen/startServer.py &' eingeben.
Der Pfadname ist dabei von den eigenen Gegebenheiten abhängig!



2.  ---------------------------------------------------
Beispiel-Datei:	CRONjob.txt
Versionsdatum:	12.07.2017

Mit Einträgen in der Systemdatei CRONJOB, kann man automatische Abläufe steuern. Unter anderem kann man dadurch sowohl zeitgesteuert Programme starten, als auch Programme zum Bootzeitpunkt starten lassen. Letztere Funktion wird hier genutzt

In der Shell kann mit dem Befehl 'sudo crontab -e' die CRONTAB Datei von 'root' angesehen/ editiert werden. Beigefügte Datei ist eine Kopie von meiner eigenen. Es muß aber nur EIN Befehl zum automatischen start des HOST-Programms hinzugefügt werden ('@reboot /usr/eigen/startServer.sh').
Damit wird zum Bootzeitpunkt das Script unter dem angegebenen Pfad/ Namen gestartet.

HINWEISE:
CRONjob.txt ist nur ein BEISPIEL und dient nicht für den Ersatz der eigenen cronjob datei. Diese MUSS immer mit dem Shell-Befehl
'cronjob -e' (-e steht für edit -l steht für (auf)listen)
verändert werden. Um die Daten von 'root' zu ändern ist dem Befehl noch  'sudo' voranzustellen.




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
	Fehlermeldungen bitte an pythonweb@online.de
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
