DMC - Rezeptbuch Pro Erweiterung zur Anbindung eine Anton Paar DMA 4100/4200/4500 (Dichtemessgerät/Biegeschwinger)
Lizenz: GPL, Copyright by Karlheinz Klingbeil
Release: 17.7.2025


Diese Anleitung bezieht sich auf eine Installation unter Ubuntu 22.04 (.deb basiert). Für andere Distributionen ist die Anleitung
entprechend zu interpretieren.

1. Was ist DMC
DMC - Erweiterung zur Anbindung eine Anton Paar DMA 4100/4200/4500 an Rezeptbuch Pro.
Diese Erweiterung nimmt Druckdaten von einem Anton Paar DMA 4xxx entgegen und stellt diese Messungen im Rezeptbuch zur Verfügung.
Dort können diese Messungen zur Dokumentation an Losnummern angehängt werden. Zusätzlich werden diese Messungen im PDF-Format 
ein einem gesonderten Ordner archiviert.

2. Systemvoraussetzungen
Diese Erweiterung benötigt zwingend ein halbwegs aktuelles Linux-System. Sollten Sie keinen Linux-Rechner zur Verfügung haben, kann diese
Erweiterung auch auf einem "Raspberry Pi 4" (== billiger Einplatinenrechner für ca. 50-90 € - https://www.raspberrypi.com/ ) installiert werden.
Zur Installation werden auch fortgeschrittene Kenntnisse eines Linux-Systems vorausgesetzt.

3. Arbeitsweise
Ein DMA 4xxx kann Messungen als PCL-Bitmap auf einem Netzwerkdrucker ausdrucken.

DMC funktioniert folgendermassen:
	- Ein Script nimmt diese PCL-Ausdrucke im Netzwerk entgegen
	- PCL-Daten werden in eine PNG-Grafik konvertiert
	- ein OCR-Programm konvertiert diese Grafik in eine Textdatei
	- diese Textdatei wird ausgewertet und die Messdaten als Text gelesen
	- diese Daten werden in eine Tabelle im Rezeptbuch Pro geschrieben
	- PCL-Daten werden in PDF konvertiert
	- PDF-Datei mit der Messung wird archiviert
	- temporäre Dateien werden entfernt.
	
4. Installation

	**** Vor der Installation bitte ein Backup der Rezeptbuch-Datenbank anlegen ****
    
	4.1 benötigte Software installieren
		- von ruby benötigte Pakete installieren
			sudo apt install build_essential
			sudo apt install libmysqlclient-dev
		- ruby (Programmiersprache) und ruby-mysql
			sudo apt install ruby
			sudo apt install ruby-mysql2
		- diverse ruby gems (manche davon sind je nach Distrbution schon vorhanden)
			sudo gem install securerandom
			sudo gem install parseconfig
			sudo gem install optparse
			sudo gem install syslog 
			sudo gem install fileutils
			sudo gem install mysql2
			sudo gem install time
			sudo gem install socket
				socket sollte mittlerweile in der Standardlibrary enthalten sein.
				eine Meldung "No Gem found" oder ähnlich kann ignoriert werden.
			
		- Ghostpcl
			Ghostpcl Binary aus dem mitgelieferten Archiv (64bit) nach /usr/bin kopieren und in pcl6 umbenennen
			ein aktueller Build von gpcl6 Version 10 liegt ebenfalls als Binärdatei bei.
			Alternativ Download 32bit Version von https://ghostscript.com/releases/gpcldnld.html
			sudo cp gpcl6-9561-linux-x86 /usr/bin/pcl6
		- Tesseract OCR und Language File
			diese Pakete sind normalerweise in jeder Distibution enthalten
			sudo apt install tesseract-ocr
			sudo apt install tesseract-ocr-deu
			
		- optional xinetd
			Das ist nur nötig, wenn Ihre Distribution keinen systemd unterstützt
			sudo apt install xinetd
		- optional Samba
		   Zur Freigabe des Archiv-Ordners in einem Windows-Netzwerk
		   sudo apt install samba
		- optional Cups   
			Wenn Sie Messungen archivieren und direkt auf einen Drucker ausgeben wollen
		
	4.2 Rezeptbuch Datenbank modifizieren	
		- legen Sie in mysql einen Benutzer an, unter dem die Messungen eingetragen werden
			Starten Sie die Mysql-Konsole mit dem root Account
			mysql -u root -p
				> create user 'dm'@<IP Range des Netzwerks>
				> grant all privilleges on rzpro.* to 'dm'@<IP Range des Netzwerks
				> flush privileges 
			 Fügen Sie die benötigte Tabelle ein
			 	> source dmtable.sql
			 Starten Sie Rezeptbuch Pro danach neu. Jetzt ist die zusätzliche Funktionalität vorhanden.
			 Menü->Module->Messungen zeigt die Liste der erfassten Messungen. Hier können Sie Messungen an
			 Losnummern oder Ticketnummern anhängen. Die Felder "Feld1" bis "Feld3" sind editierbar zum Eintragen
			 zusätzlicher Daten.
			 Diese Messungen werden dann in der Detailansicht	im Hauptfenster
			 und im Herstellbuch angezeigt, Die "Erledigen"-Funktion im Herstellbuch (haken setzen) zeigt nun auch neben
			 einer Stellplatzauswahl eine liste der nicht zugewiesenen Messungen der letzen 14 Tage an, die damit einer Herstellung
			 zugewiesen werden können.
	 
	4.3 Scripte und Konfigurationsdateteien plazieren						
		- legen Sie Verzeichnisse für Script und Daten an
			sudo mkdir /data
			sudo mkdir /data/script
			sudo mkdir /data/dm
		- kopieren Sie dmc2, tcpserver.rb und portdump.rb nach /data/script
	 	- machen sie die Scripte ausführbar
	 		sudo chmod +x dmc2
	 		sudo chmod +x tcpserver.rb
	 		sudo chmod +x portdump.rb
		- kopieren Sie dmc.secrets nach /etc
		- bearbeiten Sie Konfigurationsdatei dmc.secrets
		----------------------------------------------------------
			temp_dir=/tmp
			out_dir=/data/dm
			mysql_host=
			mysql_database=rzpro
			mysql_user=dm
			mysql_passwd=
			printername=labordrucker
			pcl_command=/usr/bin/pcl6
			tesseract_command=/usr/bin/tesseract
		----------------------------------------------------------
		- Tragen Sie die benötigten Daten ein.
		
	4.4 TCPServer installieren
		- Für Systeme mit systemd
			in diesem Fall agiert das Script tcpserver.rb als "Empfänger" für Druckdaten.
			Default Port ist 9105
			
			- kopieren Sie dm-script.service nach /etc/systemd/system/
			- bearbeiten Sie diese Datei und legen Sie gewünschte Einstellungen fest.
				Parameter
					-p Port (Port des Servers; Default 9105)
					-h host (IP-Adresse des externen Interfaces ; NICHT localhost/127.0.0.1)
					-d dir (Ort für temporäre Dateien; Default /tmp)
				----------------------------------------------------------	
				[Unit]
				Description=DMC Script

				[Service]
				ExecStart=/data/script/tcpserver.rb -d /tmp -p 9105 -h <ip-adresse>

				[Install]
				WantedBy=multi-user.target
				----------------------------------------------------------			
			- richten Sie den Service ein:
				sudo systemctl daemon-reload
				sudo systemctl enable dmc-script.service  (wird auch nach jedem Reboot gestartet)
				sudo systemctl start dmc-script.service
			ein "sudo systemctl status dmc-script.service" sollte nun einen gestarteten Diens anzeigen.
			
		- für Systeme mit xinetd
			- installieren Sie xinedt, wenn noch nicht vorhanden
				sudo apt install xinetd
			fügen Sie der Datei /etc/services die Zeile
				dmc tcp/9105
			hinzu
			- kopieren sie die Konfigurationsdatei dmc nach /etc/xinetd.d/
			- bearbeiten Sie diese Konfigurationsdatei und tragen sie die gewünschten Werte ein
				----------------------------------------------------------	
				service dmc
				{
					socket_type = stream
					protocol = tcp
					wait = no
					user = root
					server = /data/script/dmc2
					disable = no
					port = 9105
				}
				----------------------------------------------------------	
			- starten Sie xinetd neu
				sudo service xinetd restart
				
	4.5 Testen sie die Installation
		im Archiv befindet sich die Datei test.pcl, die ein Originalausdruck des DMA 4100M ist.
		mittels dem Script portdump.rb können Sie diese Datei an den Server-Port schicken, wobei
		portdump,rb Daten auf der Standardeingabe entgegennimmt,
		Das Programm logt intensiv ins Syslog, nach der Ausführung können Sie 
		tail -n 50 /var/log/syslog aufrufen und die Meldungen kontrollieren
			
			portdump.rb -h <IP Adresse des hosts> -p 9105 <test.pcl
			
		Wenn alles funktioniert, sollte jetzt in /data/dm ein Unterverzeichnis mit dem aktuellen Datum liegen und darin
		2 Dateien, ein PDF mit dem Originalausdruck und ein TXT mit dem erkannten Text.
		Im Rezeptbuch wird nun unter Module->Messungen eine Messung gelistet (Diese wird unter dem Messdatum gelistet;
		RzPro zeigt hier standardmäßig nur die Messungen von <Heute> an, passen Sie den Zeitrahmen entsprechend an.
		
	4.6 Wenn das nicht funkioniert
		Pech gehabt....
		Die Sache kann prinzipiell auf 2 Arten scheitern:
			A. Es werden keine Dateien in /data/dm angelegt oder diese Dateien sind ohne Inhalt.
				Das ist ein Fehler im Scriptablauf: Kontrollieren Sie die Meldungen im Syslog um eine
				Ursache für den Abbruch zu finden. 
				Wenn die Scripte gar nicht erst ausgeführt werden, dann prüfen Sie die systemd/xinetd 
				Konfiguration
			B: Es werden Dateien korrekt angelegt, aber im Rezeptuch sind die Daten unvollständig/nicht vorhanden.
				Die Ausdrucke des DMA enthalten auch "graue" Text, die OCR nicht erkennt, das ist kein Fehler, sondern Pech.
				Wie auch immer, die Felder "Nummer". "Alkoholstärke" und "Datum" sollten erkannt werden,
				In diesem Fall sind die Regex-Ausdrücke in den Zeilen 68-86 des DMC-Scripts unpassend (was auch mal nach
				einem Update des DMA passieren kann.
				Vergleichen Sie diese Feldbezeichnungen in der  TXT Datei in /data/dm mit den Regex-Ausdrücken im Script und
				passen Sie diese notfalls an.
				
	4.7 DMA einrichten
		Gehen Sie auf dem DMA nach Home->Einstellungen->Systemeinstellungen->Druckerverwaltung
		Fügen Sie einen Drucker hinzu
			- Legen Sie einen Namen fest
			- Als Typ verwenden Sie "HP/PCL kompatibel"
			- Host ist die IP-Adresse des tcpservers
			- port der gewünschte Port
		Drucken Sie ein Messergebnis auf diesem Drucker aus; die Daten sollten nach Beenden des Drucks 
		(kann bis zu einer Minute bis zum Abschluss dauern, die DMA sind keine Rennwagen )im Rezepbuch auftauchen
		
	4.8 Direkter Druck
		Das dmc-Script kennt noch den Parameter -n, der bewirkt, dass Ausdrucke nur archiviert und auf einem "echten" Drucker
		ausgegeben werden. In diesem Fall werden keine Werte in die Rezeptbuch-Datenbank geschrieben. 
		Das System verwendet standardmäßig einen Drucker im lokalen System mit dem Namen "labordrucker"
		Diesen Namen können Sie in der Konfigurationsdatei /etc/dmc.secrets mit dem Parameter "printername=<name>" ändern.
		
		Um diese Funktion zu nutzen installieren Sie zunächst einen Cups-Printserver
			sudo apt install cups
		Fügen Sie einen Drucker hinzu, den Sie mit ihrem "echten" Drucker verbinden.
		
		Richten Sie einen zweiten TCP-Server mit einem anderen Port ein.
		- auf Systemen mit systemd
			- kopieren Sie die Konfigurationsdatei dm-printer.service nach /etc/systemd/system
			- bearbeiten Sie diese Datei und tragen Sie host und einen anderen Port als für dm-script.service ein
				wichtig ist dabei, dass der Parameter -p im [service] Tag angegeben ist
			- führen sie folgendes aus:
				sudo systemctl daemon-reload
				sudo systemctl enable dmc-printer.service  (wird auch nach jedem Reboot gestartet)
				sudo systemctl start dmc-printer.service
		- auf Systemen mit xinetd
			- kopieren Sie die Datei dmc_drucker nach /etc/xinetd.d/ 
			- bearbeiten sie diese Datei und tragen sie die passenden Daten ein
				wichtig ist, dass sie eine zusätzliche Zeile mit
					server_args = -p
				einfügen
			- starten Sie xinetd neu
			
	4.9 Freigabe des Archivordners im Netzwerk
		Um den Archivordner in einem Windows-Netzwerk freizugeben, installieren Sie einen SMB-Server.
			sudo apt install samba
		Bearbeiten Sie die Konfigurationsdatei /etc/samba/smb.conf
			Fügen Sie am Ende der Datei den Abschnitt
			----------------------------------------------------------	
			[dm]		
   				comment = dm
  				 path = /data/dm
   				browseable = yes
   				writable = yes
   				create mask = 0700
   				directory mask = 0700
   				admin users=administrator
   				guest ok = yes
   				public = yes
			----------------------------------------------------------	
			ein und starten Sie den Samba-Server mit
				sudo service smbd restart
			neu.
			
Wenn Sie bis hierher durchgehalten haben, kann ich nur noch viel Spaß wünschen....

			
		
			
 
			
	
