<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="de">
	<id>https://wiki.orgamon.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Root</id>
	<title>OrgaMon Wiki - Benutzerbeiträge [de]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.orgamon.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Root"/>
	<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Spezial:Beitr%C3%A4ge/Root"/>
	<updated>2026-11-22T21:21:20Z</updated>
	<subtitle>Benutzerbeiträge</subtitle>
	<generator>MediaWiki 1.40.0</generator>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33443</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33443"/>
		<updated>2026-11-20T16:21:07Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Quellen */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== Pascal -&amp;gt; JavaScript ===&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
* http://www.creaturearchives.com/animalia-chariot-allegory/&lt;br /&gt;
* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Polyzalos Binary&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf ein Web-Verzeichnis&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;br /&gt;
* https://gitlab.com/freepascal.org/mcp/-/blob/main/Src/Base/mcp.transport.stdio.pas?ref_type=heads&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33438</id>
		<title>Pizero2.vent</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33438"/>
		<updated>2026-11-18T14:44:35Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Komponenten */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Diese Seite beschreibt die technischen Details eines Raumluft-Steuerung-Systems für ein Mikroappartment. Es steuert 3 Lüfter-Motoren: &amp;quot;Frischluft&amp;quot;, &amp;quot;Abluft Bad&amp;quot; und &amp;quot;Abluft Küche&amp;quot;. Ein Feuchte-Sensor im Bad wird dabei berücksichtigt. Die Steuerung kann über Home-Assistant erfolgen. Die Logik läuft aber auf einem Raspberry Pi Zero. Das System (Name &amp;lt;b&amp;gt;vent&amp;lt;/b&amp;gt;) ist über MQTT steuerbar und überwachbar. Ein kleines Display mit 4 Tasten ist im Mikro-Appartment angebracht zur alltäglichen Bedienung. &lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Komponenten ==&lt;br /&gt;
&lt;br /&gt;
* 3x Ventilatormotoren für DN110 Lüftungsrohre&lt;br /&gt;
* 2x [[https://www.kemo-electronic.de/de/Wandler-Regler/Regler/Module/M240-Leistungsregler-230-V-AC-10-A-Multifunktion.php | &amp;quot;Kemo M240&amp;quot;]] Motorcontroller &lt;br /&gt;
* Raspberry Pi Zero 2W &lt;br /&gt;
** 2x PWM Signalerzeugung für die Ventilator Motoren&lt;br /&gt;
* Steckernetzteil 6 V an 5 Volt Relais mit Schließerkontakt 250V/4A Schaltleistung&lt;br /&gt;
* Shelly 1 Gen4 (Doppelfunktion)&lt;br /&gt;
** Kontakt SW(itch): Sensor für den Lichtschalter Bad&lt;br /&gt;
** Kontakt O(utput): Relais für den Küchenlüfter&lt;br /&gt;
* Shelly H&amp;amp;T Gen3 im Bad&lt;br /&gt;
* Raspberry Pi 5, 4 GB&lt;br /&gt;
* WAVESHARE e-Paper 2.7&amp;quot; Hat für Raspberry Pi&lt;br /&gt;
* Shelly 1PM Mini Gen 3&lt;br /&gt;
** Kontakt Output: Relais um das ganze System stromlos zu schalten (Reset)&lt;br /&gt;
** Selbstreset möglich durch Auto-ON: Settings-&amp;gt;Output-&amp;gt;Timer-&amp;gt;Auto-ON 15 sec&lt;br /&gt;
&lt;br /&gt;
== Fähigkeiten ==&lt;br /&gt;
&lt;br /&gt;
* frei programmierbare Drehzahlregelung von Lüfter &amp;quot;Bad&amp;quot; und &amp;quot;Zuluft&amp;quot;, &amp;quot;Küche&amp;quot; ist immer 100%&lt;br /&gt;
* Bad Lüfter&lt;br /&gt;
** Anlaufverzögerung: Zeit einstellbar&lt;br /&gt;
** Abschaltverzögerung: Zeit einstellbar&lt;br /&gt;
** Aufenthaltdauer Bad messbar (Betriebsdauer des Lichts), somit Abhängig davon &amp;quot;Abschaltverzögerung&amp;quot; einstellbar&lt;br /&gt;
** Selbsttätiges Einschalten der Lüftung bei hoher Luftfeuchte&lt;br /&gt;
** Selbsttätiges Einschalten zeitgesteuert mit Messung der bisherigen Laufzeit, somit 3 Min. / Tag sichergestellt&lt;br /&gt;
* Küche Lüfter&lt;br /&gt;
** Timeout Einstellbar z.B. nach 35 Min&lt;br /&gt;
* Zuluft&lt;br /&gt;
** Stärke Regelbar 0% .. 100%&lt;br /&gt;
** Programmierbar Tagvolumen Nachtvolumen&lt;br /&gt;
** Partymodus 100% Bad, 100% Küche, 100% Zuluft&lt;br /&gt;
&lt;br /&gt;
== Boot ==&lt;br /&gt;
&lt;br /&gt;
=== piz2w ===&lt;br /&gt;
&lt;br /&gt;
 # /boot/firmware/config.txt&lt;br /&gt;
 &lt;br /&gt;
 dtoverlay=disable-bt&lt;br /&gt;
 dtoverlay=audio=off&lt;br /&gt;
 dtoverlay=pwm-2chan,pin=18,func=2,pin2=13,func2=4&lt;br /&gt;
&lt;br /&gt;
=== pi5x00 ===&lt;br /&gt;
&lt;br /&gt;
https://www.waveshare.com/wiki/2.7inch_e-Paper_HAT_Manual#Working_With_Raspberry_Pi&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi 5 ==&lt;br /&gt;
=== Setup ===&lt;br /&gt;
&lt;br /&gt;
 apt install python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
=== Display ===&lt;br /&gt;
&lt;br /&gt;
 apt install fonts-noto-core fonts-material*&lt;br /&gt;
&lt;br /&gt;
 fc-list&lt;br /&gt;
&lt;br /&gt;
 FreeMonoBoldOblique.ttf&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Symbole&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
== Power ==&lt;br /&gt;
&lt;br /&gt;
 mqtt:&lt;br /&gt;
 - sensor:&lt;br /&gt;
    device:&lt;br /&gt;
      identifiers:&lt;br /&gt;
      - 01K86H4AGN8GWHVPKFCQS2N3B0&lt;br /&gt;
      name: Power Meter&lt;br /&gt;
    name: null&lt;br /&gt;
    qos: 0.0&lt;br /&gt;
    state_topic: shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
    unique_id: 01K86H4AGN8GWHVPKFCQS2N3B0_157d838fb92145c4bd638922d560b2f1&lt;br /&gt;
    value_template: ' { { value_json.aenergy.total  } } '&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi Zero 2 W ==&lt;br /&gt;
&lt;br /&gt;
=== disable bluetooth ===&lt;br /&gt;
&lt;br /&gt;
 sudo systemctl disable --now bluetooth.service&lt;br /&gt;
 sudo systemctl disable --now hciuart.service&lt;br /&gt;
&lt;br /&gt;
=== take over control to the LED ===&lt;br /&gt;
&lt;br /&gt;
 echo none | sudo tee /sys/class/leds/ACT/trigger&lt;br /&gt;
 echo 0 | sudo tee /sys/class/leds/ACT/brightness&lt;br /&gt;
&lt;br /&gt;
== pwm.py ==&lt;br /&gt;
&lt;br /&gt;
 # apt install pigpio python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # KEMO M240&lt;br /&gt;
 #  PWM Spannung: 3 V bis 24 V&lt;br /&gt;
 #  PWM Frequenz: 100 Hz bis 10 kHz&lt;br /&gt;
 #&lt;br /&gt;
 # Raspberry Pi Zero&lt;br /&gt;
 #  PWM0 Pin 18 xor 12, 3,3 V 1 kHz&lt;br /&gt;
 #  PWM1 Pin 13 xor 19, 3,3 V 1 kHz&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 import pigpio&lt;br /&gt;
 import time&lt;br /&gt;
 import random&lt;br /&gt;
 &lt;br /&gt;
 PWM_GPIO = 18&lt;br /&gt;
 PWM_FREQUENCY = 1000&lt;br /&gt;
 &lt;br /&gt;
 random.seed()&lt;br /&gt;
 pi = pigpio.pi()&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # Start Motor Full Speed for 4 Seconds&lt;br /&gt;
 #&lt;br /&gt;
 ret_code = pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, 1000000)&lt;br /&gt;
 print(ret_code)&lt;br /&gt;
 time.sleep(4)&lt;br /&gt;
 &lt;br /&gt;
 # print(pi.get_PWM_range(PWM_GPIO))&lt;br /&gt;
 # print(pi.get_PWM_real_range(PWM_GPIO)) &lt;br /&gt;
 &lt;br /&gt;
 while True:&lt;br /&gt;
 &lt;br /&gt;
  #pi.set_PWM_dutycycle(PWM_GPIO, 0)&lt;br /&gt;
  percent = random.randint(0,100)&lt;br /&gt;
  print(&amp;quot;set motor to &amp;quot;, percent, &amp;quot; %&amp;quot;)&lt;br /&gt;
  pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, percent * 10000)&lt;br /&gt;
  time.sleep(15)&lt;br /&gt;
&lt;br /&gt;
== Diagnose ==&lt;br /&gt;
&lt;br /&gt;
 journalctl -r -u trio-vent&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;b&amp;gt;11.11.2025&amp;lt;/b&amp;gt; Testbetrieb, nun im github&lt;br /&gt;
 &amp;lt;b&amp;gt;10.11.2025&amp;lt;/b&amp;gt; Shelly 1 &amp;quot;SW&amp;quot; Problem erkannt und gelöst&lt;br /&gt;
 &amp;lt;b&amp;gt;24.10.2025&amp;lt;/b&amp;gt; Powermeter als MQTT Value auf einem Dashboard läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;10.10.2025&amp;lt;/b&amp;gt; MQTT.subscribe auf Shelly Wert &amp;quot;Humidity&amp;quot; läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;09.10.2025&amp;lt;/b&amp;gt; zeitgleiches PWM0 und PWM1 mit Erfolg getestet&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33437</id>
		<title>Pizero2.vent</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33437"/>
		<updated>2026-11-18T14:25:00Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Komponenten */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Diese Seite beschreibt die technischen Details eines Raumluft-Steuerung-Systems für ein Mikroappartment. Es steuert 3 Lüfter-Motoren: &amp;quot;Frischluft&amp;quot;, &amp;quot;Abluft Bad&amp;quot; und &amp;quot;Abluft Küche&amp;quot;. Ein Feuchte-Sensor im Bad wird dabei berücksichtigt. Die Steuerung kann über Home-Assistant erfolgen. Die Logik läuft aber auf einem Raspberry Pi Zero. Das System (Name &amp;lt;b&amp;gt;vent&amp;lt;/b&amp;gt;) ist über MQTT steuerbar und überwachbar. Ein kleines Display mit 4 Tasten ist im Mikro-Appartment angebracht zur alltäglichen Bedienung. &lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Komponenten ==&lt;br /&gt;
&lt;br /&gt;
* 3x Ventilatormotoren für DN110 Lüftungsrohre&lt;br /&gt;
* 2x [[https://www.kemo-electronic.de/de/Wandler-Regler/Regler/Module/M240-Leistungsregler-230-V-AC-10-A-Multifunktion.php | &amp;quot;Kemo M240&amp;quot;]] Motorcontroller &lt;br /&gt;
* Raspberry Pi Zero 2W &lt;br /&gt;
** 2x PWM Signalerzeugung für die Ventilator Motoren&lt;br /&gt;
* Steckernetzteil 6 V an 5 Volt Relais mit Schließerkontakt 250V/4A Schaltleistung&lt;br /&gt;
* Shelly 1 Gen4 (Doppelfunktion)&lt;br /&gt;
** Kontakt SW(itch): Sensor für den Lichtschalter Bad&lt;br /&gt;
** Kontakt O(utput): Relais für den Küchenlüfter&lt;br /&gt;
* Shelly H&amp;amp;T Gen3 im Bad&lt;br /&gt;
* Raspberry Pi 5, 4 GB&lt;br /&gt;
* WAVESHARE e-Paper 2.7&amp;quot; Hat für Raspberry Pi&lt;br /&gt;
* Shelly 1PM Mini Gen 3&lt;br /&gt;
** Kontakt Output: Relais um das ganze System stromlos zu schalten (Reset)&lt;br /&gt;
&lt;br /&gt;
== Fähigkeiten ==&lt;br /&gt;
&lt;br /&gt;
* frei programmierbare Drehzahlregelung von Lüfter &amp;quot;Bad&amp;quot; und &amp;quot;Zuluft&amp;quot;, &amp;quot;Küche&amp;quot; ist immer 100%&lt;br /&gt;
* Bad Lüfter&lt;br /&gt;
** Anlaufverzögerung: Zeit einstellbar&lt;br /&gt;
** Abschaltverzögerung: Zeit einstellbar&lt;br /&gt;
** Aufenthaltdauer Bad messbar (Betriebsdauer des Lichts), somit Abhängig davon &amp;quot;Abschaltverzögerung&amp;quot; einstellbar&lt;br /&gt;
** Selbsttätiges Einschalten der Lüftung bei hoher Luftfeuchte&lt;br /&gt;
** Selbsttätiges Einschalten zeitgesteuert mit Messung der bisherigen Laufzeit, somit 3 Min. / Tag sichergestellt&lt;br /&gt;
* Küche Lüfter&lt;br /&gt;
** Timeout Einstellbar z.B. nach 35 Min&lt;br /&gt;
* Zuluft&lt;br /&gt;
** Stärke Regelbar 0% .. 100%&lt;br /&gt;
** Programmierbar Tagvolumen Nachtvolumen&lt;br /&gt;
** Partymodus 100% Bad, 100% Küche, 100% Zuluft&lt;br /&gt;
&lt;br /&gt;
== Boot ==&lt;br /&gt;
&lt;br /&gt;
=== piz2w ===&lt;br /&gt;
&lt;br /&gt;
 # /boot/firmware/config.txt&lt;br /&gt;
 &lt;br /&gt;
 dtoverlay=disable-bt&lt;br /&gt;
 dtoverlay=audio=off&lt;br /&gt;
 dtoverlay=pwm-2chan,pin=18,func=2,pin2=13,func2=4&lt;br /&gt;
&lt;br /&gt;
=== pi5x00 ===&lt;br /&gt;
&lt;br /&gt;
https://www.waveshare.com/wiki/2.7inch_e-Paper_HAT_Manual#Working_With_Raspberry_Pi&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi 5 ==&lt;br /&gt;
=== Setup ===&lt;br /&gt;
&lt;br /&gt;
 apt install python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
=== Display ===&lt;br /&gt;
&lt;br /&gt;
 apt install fonts-noto-core fonts-material*&lt;br /&gt;
&lt;br /&gt;
 fc-list&lt;br /&gt;
&lt;br /&gt;
 FreeMonoBoldOblique.ttf&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Symbole&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
== Power ==&lt;br /&gt;
&lt;br /&gt;
 mqtt:&lt;br /&gt;
 - sensor:&lt;br /&gt;
    device:&lt;br /&gt;
      identifiers:&lt;br /&gt;
      - 01K86H4AGN8GWHVPKFCQS2N3B0&lt;br /&gt;
      name: Power Meter&lt;br /&gt;
    name: null&lt;br /&gt;
    qos: 0.0&lt;br /&gt;
    state_topic: shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
    unique_id: 01K86H4AGN8GWHVPKFCQS2N3B0_157d838fb92145c4bd638922d560b2f1&lt;br /&gt;
    value_template: ' { { value_json.aenergy.total  } } '&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi Zero 2 W ==&lt;br /&gt;
&lt;br /&gt;
=== disable bluetooth ===&lt;br /&gt;
&lt;br /&gt;
 sudo systemctl disable --now bluetooth.service&lt;br /&gt;
 sudo systemctl disable --now hciuart.service&lt;br /&gt;
&lt;br /&gt;
=== take over control to the LED ===&lt;br /&gt;
&lt;br /&gt;
 echo none | sudo tee /sys/class/leds/ACT/trigger&lt;br /&gt;
 echo 0 | sudo tee /sys/class/leds/ACT/brightness&lt;br /&gt;
&lt;br /&gt;
== pwm.py ==&lt;br /&gt;
&lt;br /&gt;
 # apt install pigpio python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # KEMO M240&lt;br /&gt;
 #  PWM Spannung: 3 V bis 24 V&lt;br /&gt;
 #  PWM Frequenz: 100 Hz bis 10 kHz&lt;br /&gt;
 #&lt;br /&gt;
 # Raspberry Pi Zero&lt;br /&gt;
 #  PWM0 Pin 18 xor 12, 3,3 V 1 kHz&lt;br /&gt;
 #  PWM1 Pin 13 xor 19, 3,3 V 1 kHz&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 import pigpio&lt;br /&gt;
 import time&lt;br /&gt;
 import random&lt;br /&gt;
 &lt;br /&gt;
 PWM_GPIO = 18&lt;br /&gt;
 PWM_FREQUENCY = 1000&lt;br /&gt;
 &lt;br /&gt;
 random.seed()&lt;br /&gt;
 pi = pigpio.pi()&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # Start Motor Full Speed for 4 Seconds&lt;br /&gt;
 #&lt;br /&gt;
 ret_code = pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, 1000000)&lt;br /&gt;
 print(ret_code)&lt;br /&gt;
 time.sleep(4)&lt;br /&gt;
 &lt;br /&gt;
 # print(pi.get_PWM_range(PWM_GPIO))&lt;br /&gt;
 # print(pi.get_PWM_real_range(PWM_GPIO)) &lt;br /&gt;
 &lt;br /&gt;
 while True:&lt;br /&gt;
 &lt;br /&gt;
  #pi.set_PWM_dutycycle(PWM_GPIO, 0)&lt;br /&gt;
  percent = random.randint(0,100)&lt;br /&gt;
  print(&amp;quot;set motor to &amp;quot;, percent, &amp;quot; %&amp;quot;)&lt;br /&gt;
  pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, percent * 10000)&lt;br /&gt;
  time.sleep(15)&lt;br /&gt;
&lt;br /&gt;
== Diagnose ==&lt;br /&gt;
&lt;br /&gt;
 journalctl -r -u trio-vent&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;b&amp;gt;11.11.2025&amp;lt;/b&amp;gt; Testbetrieb, nun im github&lt;br /&gt;
 &amp;lt;b&amp;gt;10.11.2025&amp;lt;/b&amp;gt; Shelly 1 &amp;quot;SW&amp;quot; Problem erkannt und gelöst&lt;br /&gt;
 &amp;lt;b&amp;gt;24.10.2025&amp;lt;/b&amp;gt; Powermeter als MQTT Value auf einem Dashboard läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;10.10.2025&amp;lt;/b&amp;gt; MQTT.subscribe auf Shelly Wert &amp;quot;Humidity&amp;quot; läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;09.10.2025&amp;lt;/b&amp;gt; zeitgleiches PWM0 und PWM1 mit Erfolg getestet&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33436</id>
		<title>Pizero2.vent</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33436"/>
		<updated>2026-11-18T14:22:03Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Feuchtigkeit */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Diese Seite beschreibt die technischen Details eines Raumluft-Steuerung-Systems für ein Mikroappartment. Es steuert 3 Lüfter-Motoren: &amp;quot;Frischluft&amp;quot;, &amp;quot;Abluft Bad&amp;quot; und &amp;quot;Abluft Küche&amp;quot;. Ein Feuchte-Sensor im Bad wird dabei berücksichtigt. Die Steuerung kann über Home-Assistant erfolgen. Die Logik läuft aber auf einem Raspberry Pi Zero. Das System (Name &amp;lt;b&amp;gt;vent&amp;lt;/b&amp;gt;) ist über MQTT steuerbar und überwachbar. Ein kleines Display mit 4 Tasten ist im Mikro-Appartment angebracht zur alltäglichen Bedienung. &lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Komponenten ==&lt;br /&gt;
&lt;br /&gt;
* 3x Ventilatormotoren für DN110 Lüftungsrohre&lt;br /&gt;
* 2x [[https://www.kemo-electronic.de/de/Wandler-Regler/Regler/Module/M240-Leistungsregler-230-V-AC-10-A-Multifunktion.php | &amp;quot;Kemo M240&amp;quot;]] Motorcontroller &lt;br /&gt;
* Raspberry Pi Zero 2W &lt;br /&gt;
** 2x PWM Signalerzeugung für die Ventilator Motoren&lt;br /&gt;
* Steckernetzteil 6 V an 5 Volt Relais mit Schließerkontakt 250V/4A Schaltleistung&lt;br /&gt;
* Shelly 1 Gen4 (Doppelfunktion)&lt;br /&gt;
** Kontakt SW(itch): Sensor für den Lichtschalter Bad&lt;br /&gt;
** Kontakt O(utput): Relais für den Küchenlüfter&lt;br /&gt;
* Shelly H&amp;amp;T Gen3 im Bad&lt;br /&gt;
* Raspberry Pi 5, 4 GB&lt;br /&gt;
* WAVESHARE e-Paper 2.7&amp;quot; Hat für Raspberry Pi&lt;br /&gt;
* Raspberry Pi 400 für Home Assistant&lt;br /&gt;
&lt;br /&gt;
== Fähigkeiten ==&lt;br /&gt;
&lt;br /&gt;
* frei programmierbare Drehzahlregelung von Lüfter &amp;quot;Bad&amp;quot; und &amp;quot;Zuluft&amp;quot;, &amp;quot;Küche&amp;quot; ist immer 100%&lt;br /&gt;
* Bad Lüfter&lt;br /&gt;
** Anlaufverzögerung: Zeit einstellbar&lt;br /&gt;
** Abschaltverzögerung: Zeit einstellbar&lt;br /&gt;
** Aufenthaltdauer Bad messbar (Betriebsdauer des Lichts), somit Abhängig davon &amp;quot;Abschaltverzögerung&amp;quot; einstellbar&lt;br /&gt;
** Selbsttätiges Einschalten der Lüftung bei hoher Luftfeuchte&lt;br /&gt;
** Selbsttätiges Einschalten zeitgesteuert mit Messung der bisherigen Laufzeit, somit 3 Min. / Tag sichergestellt&lt;br /&gt;
* Küche Lüfter&lt;br /&gt;
** Timeout Einstellbar z.B. nach 35 Min&lt;br /&gt;
* Zuluft&lt;br /&gt;
** Stärke Regelbar 0% .. 100%&lt;br /&gt;
** Programmierbar Tagvolumen Nachtvolumen&lt;br /&gt;
** Partymodus 100% Bad, 100% Küche, 100% Zuluft&lt;br /&gt;
&lt;br /&gt;
== Boot ==&lt;br /&gt;
&lt;br /&gt;
=== piz2w ===&lt;br /&gt;
&lt;br /&gt;
 # /boot/firmware/config.txt&lt;br /&gt;
 &lt;br /&gt;
 dtoverlay=disable-bt&lt;br /&gt;
 dtoverlay=audio=off&lt;br /&gt;
 dtoverlay=pwm-2chan,pin=18,func=2,pin2=13,func2=4&lt;br /&gt;
&lt;br /&gt;
=== pi5x00 ===&lt;br /&gt;
&lt;br /&gt;
https://www.waveshare.com/wiki/2.7inch_e-Paper_HAT_Manual#Working_With_Raspberry_Pi&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi 5 ==&lt;br /&gt;
=== Setup ===&lt;br /&gt;
&lt;br /&gt;
 apt install python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
=== Display ===&lt;br /&gt;
&lt;br /&gt;
 apt install fonts-noto-core fonts-material*&lt;br /&gt;
&lt;br /&gt;
 fc-list&lt;br /&gt;
&lt;br /&gt;
 FreeMonoBoldOblique.ttf&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Symbole&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
== Power ==&lt;br /&gt;
&lt;br /&gt;
 mqtt:&lt;br /&gt;
 - sensor:&lt;br /&gt;
    device:&lt;br /&gt;
      identifiers:&lt;br /&gt;
      - 01K86H4AGN8GWHVPKFCQS2N3B0&lt;br /&gt;
      name: Power Meter&lt;br /&gt;
    name: null&lt;br /&gt;
    qos: 0.0&lt;br /&gt;
    state_topic: shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
    unique_id: 01K86H4AGN8GWHVPKFCQS2N3B0_157d838fb92145c4bd638922d560b2f1&lt;br /&gt;
    value_template: ' { { value_json.aenergy.total  } } '&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi Zero 2 W ==&lt;br /&gt;
&lt;br /&gt;
=== disable bluetooth ===&lt;br /&gt;
&lt;br /&gt;
 sudo systemctl disable --now bluetooth.service&lt;br /&gt;
 sudo systemctl disable --now hciuart.service&lt;br /&gt;
&lt;br /&gt;
=== take over control to the LED ===&lt;br /&gt;
&lt;br /&gt;
 echo none | sudo tee /sys/class/leds/ACT/trigger&lt;br /&gt;
 echo 0 | sudo tee /sys/class/leds/ACT/brightness&lt;br /&gt;
&lt;br /&gt;
== pwm.py ==&lt;br /&gt;
&lt;br /&gt;
 # apt install pigpio python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # KEMO M240&lt;br /&gt;
 #  PWM Spannung: 3 V bis 24 V&lt;br /&gt;
 #  PWM Frequenz: 100 Hz bis 10 kHz&lt;br /&gt;
 #&lt;br /&gt;
 # Raspberry Pi Zero&lt;br /&gt;
 #  PWM0 Pin 18 xor 12, 3,3 V 1 kHz&lt;br /&gt;
 #  PWM1 Pin 13 xor 19, 3,3 V 1 kHz&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 import pigpio&lt;br /&gt;
 import time&lt;br /&gt;
 import random&lt;br /&gt;
 &lt;br /&gt;
 PWM_GPIO = 18&lt;br /&gt;
 PWM_FREQUENCY = 1000&lt;br /&gt;
 &lt;br /&gt;
 random.seed()&lt;br /&gt;
 pi = pigpio.pi()&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # Start Motor Full Speed for 4 Seconds&lt;br /&gt;
 #&lt;br /&gt;
 ret_code = pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, 1000000)&lt;br /&gt;
 print(ret_code)&lt;br /&gt;
 time.sleep(4)&lt;br /&gt;
 &lt;br /&gt;
 # print(pi.get_PWM_range(PWM_GPIO))&lt;br /&gt;
 # print(pi.get_PWM_real_range(PWM_GPIO)) &lt;br /&gt;
 &lt;br /&gt;
 while True:&lt;br /&gt;
 &lt;br /&gt;
  #pi.set_PWM_dutycycle(PWM_GPIO, 0)&lt;br /&gt;
  percent = random.randint(0,100)&lt;br /&gt;
  print(&amp;quot;set motor to &amp;quot;, percent, &amp;quot; %&amp;quot;)&lt;br /&gt;
  pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, percent * 10000)&lt;br /&gt;
  time.sleep(15)&lt;br /&gt;
&lt;br /&gt;
== Diagnose ==&lt;br /&gt;
&lt;br /&gt;
 journalctl -r -u trio-vent&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;b&amp;gt;11.11.2025&amp;lt;/b&amp;gt; Testbetrieb, nun im github&lt;br /&gt;
 &amp;lt;b&amp;gt;10.11.2025&amp;lt;/b&amp;gt; Shelly 1 &amp;quot;SW&amp;quot; Problem erkannt und gelöst&lt;br /&gt;
 &amp;lt;b&amp;gt;24.10.2025&amp;lt;/b&amp;gt; Powermeter als MQTT Value auf einem Dashboard läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;10.10.2025&amp;lt;/b&amp;gt; MQTT.subscribe auf Shelly Wert &amp;quot;Humidity&amp;quot; läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;09.10.2025&amp;lt;/b&amp;gt; zeitgleiches PWM0 und PWM1 mit Erfolg getestet&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33435</id>
		<title>Pizero2.vent</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33435"/>
		<updated>2026-11-17T18:11:19Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Raspberry Pi Zero 2 W */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Diese Seite beschreibt die technischen Details eines Raumluft-Steuerung-Systems für ein Mikroappartment. Es steuert 3 Lüfter-Motoren: &amp;quot;Frischluft&amp;quot;, &amp;quot;Abluft Bad&amp;quot; und &amp;quot;Abluft Küche&amp;quot;. Ein Feuchte-Sensor im Bad wird dabei berücksichtigt. Die Steuerung kann über Home-Assistant erfolgen. Die Logik läuft aber auf einem Raspberry Pi Zero. Das System (Name &amp;lt;b&amp;gt;vent&amp;lt;/b&amp;gt;) ist über MQTT steuerbar und überwachbar. Ein kleines Display mit 4 Tasten ist im Mikro-Appartment angebracht zur alltäglichen Bedienung. &lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Komponenten ==&lt;br /&gt;
&lt;br /&gt;
* 3x Ventilatormotoren für DN110 Lüftungsrohre&lt;br /&gt;
* 2x [[https://www.kemo-electronic.de/de/Wandler-Regler/Regler/Module/M240-Leistungsregler-230-V-AC-10-A-Multifunktion.php | &amp;quot;Kemo M240&amp;quot;]] Motorcontroller &lt;br /&gt;
* Raspberry Pi Zero 2W &lt;br /&gt;
** 2x PWM Signalerzeugung für die Ventilator Motoren&lt;br /&gt;
* Steckernetzteil 6 V an 5 Volt Relais mit Schließerkontakt 250V/4A Schaltleistung&lt;br /&gt;
* Shelly 1 Gen4 (Doppelfunktion)&lt;br /&gt;
** Kontakt SW(itch): Sensor für den Lichtschalter Bad&lt;br /&gt;
** Kontakt O(utput): Relais für den Küchenlüfter&lt;br /&gt;
* Shelly H&amp;amp;T Gen3 im Bad&lt;br /&gt;
* Raspberry Pi 5, 4 GB&lt;br /&gt;
* WAVESHARE e-Paper 2.7&amp;quot; Hat für Raspberry Pi&lt;br /&gt;
* Raspberry Pi 400 für Home Assistant&lt;br /&gt;
&lt;br /&gt;
== Fähigkeiten ==&lt;br /&gt;
&lt;br /&gt;
* frei programmierbare Drehzahlregelung von Lüfter &amp;quot;Bad&amp;quot; und &amp;quot;Zuluft&amp;quot;, &amp;quot;Küche&amp;quot; ist immer 100%&lt;br /&gt;
* Bad Lüfter&lt;br /&gt;
** Anlaufverzögerung: Zeit einstellbar&lt;br /&gt;
** Abschaltverzögerung: Zeit einstellbar&lt;br /&gt;
** Aufenthaltdauer Bad messbar (Betriebsdauer des Lichts), somit Abhängig davon &amp;quot;Abschaltverzögerung&amp;quot; einstellbar&lt;br /&gt;
** Selbsttätiges Einschalten der Lüftung bei hoher Luftfeuchte&lt;br /&gt;
** Selbsttätiges Einschalten zeitgesteuert mit Messung der bisherigen Laufzeit, somit 3 Min. / Tag sichergestellt&lt;br /&gt;
* Küche Lüfter&lt;br /&gt;
** Timeout Einstellbar z.B. nach 35 Min&lt;br /&gt;
* Zuluft&lt;br /&gt;
** Stärke Regelbar 0% .. 100%&lt;br /&gt;
** Programmierbar Tagvolumen Nachtvolumen&lt;br /&gt;
** Partymodus 100% Bad, 100% Küche, 100% Zuluft&lt;br /&gt;
&lt;br /&gt;
== Boot ==&lt;br /&gt;
&lt;br /&gt;
=== piz2w ===&lt;br /&gt;
&lt;br /&gt;
 # /boot/firmware/config.txt&lt;br /&gt;
 &lt;br /&gt;
 dtoverlay=disable-bt&lt;br /&gt;
 dtoverlay=audio=off&lt;br /&gt;
 dtoverlay=pwm-2chan,pin=18,func=2,pin2=13,func2=4&lt;br /&gt;
&lt;br /&gt;
=== pi5x00 ===&lt;br /&gt;
&lt;br /&gt;
https://www.waveshare.com/wiki/2.7inch_e-Paper_HAT_Manual#Working_With_Raspberry_Pi&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi 5 ==&lt;br /&gt;
=== Setup ===&lt;br /&gt;
&lt;br /&gt;
 apt install python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
=== Display ===&lt;br /&gt;
&lt;br /&gt;
 apt install fonts-noto-core fonts-material*&lt;br /&gt;
&lt;br /&gt;
 fc-list&lt;br /&gt;
&lt;br /&gt;
 FreeMonoBoldOblique.ttf&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Symbole&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
== Power ==&lt;br /&gt;
&lt;br /&gt;
 mqtt:&lt;br /&gt;
 - sensor:&lt;br /&gt;
    device:&lt;br /&gt;
      identifiers:&lt;br /&gt;
      - 01K86H4AGN8GWHVPKFCQS2N3B0&lt;br /&gt;
      name: Power Meter&lt;br /&gt;
    name: null&lt;br /&gt;
    qos: 0.0&lt;br /&gt;
    state_topic: shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
    unique_id: 01K86H4AGN8GWHVPKFCQS2N3B0_157d838fb92145c4bd638922d560b2f1&lt;br /&gt;
    value_template: ' { { value_json.aenergy.total  } } '&lt;br /&gt;
&lt;br /&gt;
== Feuchtigkeit ==&lt;br /&gt;
&lt;br /&gt;
* Ich schaffe es nicht den Sensor im Home-Assistant anzuzeigen&lt;br /&gt;
* Im Home Assistant eigenen MQTT Broker ist der Wert drin, aber ich kann den Wert einfach hinzufügen&lt;br /&gt;
* Scheiß Home Assistant &lt;br /&gt;
&lt;br /&gt;
 # Topic&lt;br /&gt;
 shellyhtg3-543204567354/status/humidity:0&lt;br /&gt;
  &lt;br /&gt;
 # Wert&lt;br /&gt;
 {&amp;quot;id&amp;quot;: 0,&amp;quot;rh&amp;quot;:61.0}&lt;br /&gt;
 &lt;br /&gt;
 # für Home Assistant&lt;br /&gt;
 value_template: ' { { value_json.rh  } } '&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi Zero 2 W ==&lt;br /&gt;
&lt;br /&gt;
=== disable bluetooth ===&lt;br /&gt;
&lt;br /&gt;
 sudo systemctl disable --now bluetooth.service&lt;br /&gt;
 sudo systemctl disable --now hciuart.service&lt;br /&gt;
&lt;br /&gt;
=== take over control to the LED ===&lt;br /&gt;
&lt;br /&gt;
 echo none | sudo tee /sys/class/leds/ACT/trigger&lt;br /&gt;
 echo 0 | sudo tee /sys/class/leds/ACT/brightness&lt;br /&gt;
&lt;br /&gt;
== pwm.py ==&lt;br /&gt;
&lt;br /&gt;
 # apt install pigpio python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # KEMO M240&lt;br /&gt;
 #  PWM Spannung: 3 V bis 24 V&lt;br /&gt;
 #  PWM Frequenz: 100 Hz bis 10 kHz&lt;br /&gt;
 #&lt;br /&gt;
 # Raspberry Pi Zero&lt;br /&gt;
 #  PWM0 Pin 18 xor 12, 3,3 V 1 kHz&lt;br /&gt;
 #  PWM1 Pin 13 xor 19, 3,3 V 1 kHz&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 import pigpio&lt;br /&gt;
 import time&lt;br /&gt;
 import random&lt;br /&gt;
 &lt;br /&gt;
 PWM_GPIO = 18&lt;br /&gt;
 PWM_FREQUENCY = 1000&lt;br /&gt;
 &lt;br /&gt;
 random.seed()&lt;br /&gt;
 pi = pigpio.pi()&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # Start Motor Full Speed for 4 Seconds&lt;br /&gt;
 #&lt;br /&gt;
 ret_code = pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, 1000000)&lt;br /&gt;
 print(ret_code)&lt;br /&gt;
 time.sleep(4)&lt;br /&gt;
 &lt;br /&gt;
 # print(pi.get_PWM_range(PWM_GPIO))&lt;br /&gt;
 # print(pi.get_PWM_real_range(PWM_GPIO)) &lt;br /&gt;
 &lt;br /&gt;
 while True:&lt;br /&gt;
 &lt;br /&gt;
  #pi.set_PWM_dutycycle(PWM_GPIO, 0)&lt;br /&gt;
  percent = random.randint(0,100)&lt;br /&gt;
  print(&amp;quot;set motor to &amp;quot;, percent, &amp;quot; %&amp;quot;)&lt;br /&gt;
  pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, percent * 10000)&lt;br /&gt;
  time.sleep(15)&lt;br /&gt;
&lt;br /&gt;
== Diagnose ==&lt;br /&gt;
&lt;br /&gt;
 journalctl -r -u trio-vent&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;b&amp;gt;11.11.2025&amp;lt;/b&amp;gt; Testbetrieb, nun im github&lt;br /&gt;
 &amp;lt;b&amp;gt;10.11.2025&amp;lt;/b&amp;gt; Shelly 1 &amp;quot;SW&amp;quot; Problem erkannt und gelöst&lt;br /&gt;
 &amp;lt;b&amp;gt;24.10.2025&amp;lt;/b&amp;gt; Powermeter als MQTT Value auf einem Dashboard läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;10.10.2025&amp;lt;/b&amp;gt; MQTT.subscribe auf Shelly Wert &amp;quot;Humidity&amp;quot; läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;09.10.2025&amp;lt;/b&amp;gt; zeitgleiches PWM0 und PWM1 mit Erfolg getestet&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33434</id>
		<title>Pizero2.vent</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Pizero2.vent&amp;diff=33434"/>
		<updated>2026-11-17T18:05:00Z</updated>

		<summary type="html">&lt;p&gt;Root: /* piz2w */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Diese Seite beschreibt die technischen Details eines Raumluft-Steuerung-Systems für ein Mikroappartment. Es steuert 3 Lüfter-Motoren: &amp;quot;Frischluft&amp;quot;, &amp;quot;Abluft Bad&amp;quot; und &amp;quot;Abluft Küche&amp;quot;. Ein Feuchte-Sensor im Bad wird dabei berücksichtigt. Die Steuerung kann über Home-Assistant erfolgen. Die Logik läuft aber auf einem Raspberry Pi Zero. Das System (Name &amp;lt;b&amp;gt;vent&amp;lt;/b&amp;gt;) ist über MQTT steuerbar und überwachbar. Ein kleines Display mit 4 Tasten ist im Mikro-Appartment angebracht zur alltäglichen Bedienung. &lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Komponenten ==&lt;br /&gt;
&lt;br /&gt;
* 3x Ventilatormotoren für DN110 Lüftungsrohre&lt;br /&gt;
* 2x [[https://www.kemo-electronic.de/de/Wandler-Regler/Regler/Module/M240-Leistungsregler-230-V-AC-10-A-Multifunktion.php | &amp;quot;Kemo M240&amp;quot;]] Motorcontroller &lt;br /&gt;
* Raspberry Pi Zero 2W &lt;br /&gt;
** 2x PWM Signalerzeugung für die Ventilator Motoren&lt;br /&gt;
* Steckernetzteil 6 V an 5 Volt Relais mit Schließerkontakt 250V/4A Schaltleistung&lt;br /&gt;
* Shelly 1 Gen4 (Doppelfunktion)&lt;br /&gt;
** Kontakt SW(itch): Sensor für den Lichtschalter Bad&lt;br /&gt;
** Kontakt O(utput): Relais für den Küchenlüfter&lt;br /&gt;
* Shelly H&amp;amp;T Gen3 im Bad&lt;br /&gt;
* Raspberry Pi 5, 4 GB&lt;br /&gt;
* WAVESHARE e-Paper 2.7&amp;quot; Hat für Raspberry Pi&lt;br /&gt;
* Raspberry Pi 400 für Home Assistant&lt;br /&gt;
&lt;br /&gt;
== Fähigkeiten ==&lt;br /&gt;
&lt;br /&gt;
* frei programmierbare Drehzahlregelung von Lüfter &amp;quot;Bad&amp;quot; und &amp;quot;Zuluft&amp;quot;, &amp;quot;Küche&amp;quot; ist immer 100%&lt;br /&gt;
* Bad Lüfter&lt;br /&gt;
** Anlaufverzögerung: Zeit einstellbar&lt;br /&gt;
** Abschaltverzögerung: Zeit einstellbar&lt;br /&gt;
** Aufenthaltdauer Bad messbar (Betriebsdauer des Lichts), somit Abhängig davon &amp;quot;Abschaltverzögerung&amp;quot; einstellbar&lt;br /&gt;
** Selbsttätiges Einschalten der Lüftung bei hoher Luftfeuchte&lt;br /&gt;
** Selbsttätiges Einschalten zeitgesteuert mit Messung der bisherigen Laufzeit, somit 3 Min. / Tag sichergestellt&lt;br /&gt;
* Küche Lüfter&lt;br /&gt;
** Timeout Einstellbar z.B. nach 35 Min&lt;br /&gt;
* Zuluft&lt;br /&gt;
** Stärke Regelbar 0% .. 100%&lt;br /&gt;
** Programmierbar Tagvolumen Nachtvolumen&lt;br /&gt;
** Partymodus 100% Bad, 100% Küche, 100% Zuluft&lt;br /&gt;
&lt;br /&gt;
== Boot ==&lt;br /&gt;
&lt;br /&gt;
=== piz2w ===&lt;br /&gt;
&lt;br /&gt;
 # /boot/firmware/config.txt&lt;br /&gt;
 &lt;br /&gt;
 dtoverlay=disable-bt&lt;br /&gt;
 dtoverlay=audio=off&lt;br /&gt;
 dtoverlay=pwm-2chan,pin=18,func=2,pin2=13,func2=4&lt;br /&gt;
&lt;br /&gt;
=== pi5x00 ===&lt;br /&gt;
&lt;br /&gt;
https://www.waveshare.com/wiki/2.7inch_e-Paper_HAT_Manual#Working_With_Raspberry_Pi&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi 5 ==&lt;br /&gt;
=== Setup ===&lt;br /&gt;
&lt;br /&gt;
 apt install python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
=== Display ===&lt;br /&gt;
&lt;br /&gt;
 apt install fonts-noto-core fonts-material*&lt;br /&gt;
&lt;br /&gt;
 fc-list&lt;br /&gt;
&lt;br /&gt;
 FreeMonoBoldOblique.ttf&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Symbole&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
== Power ==&lt;br /&gt;
&lt;br /&gt;
 mqtt:&lt;br /&gt;
 - sensor:&lt;br /&gt;
    device:&lt;br /&gt;
      identifiers:&lt;br /&gt;
      - 01K86H4AGN8GWHVPKFCQS2N3B0&lt;br /&gt;
      name: Power Meter&lt;br /&gt;
    name: null&lt;br /&gt;
    qos: 0.0&lt;br /&gt;
    state_topic: shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
    unique_id: 01K86H4AGN8GWHVPKFCQS2N3B0_157d838fb92145c4bd638922d560b2f1&lt;br /&gt;
    value_template: ' { { value_json.aenergy.total  } } '&lt;br /&gt;
&lt;br /&gt;
== Feuchtigkeit ==&lt;br /&gt;
&lt;br /&gt;
* Ich schaffe es nicht den Sensor im Home-Assistant anzuzeigen&lt;br /&gt;
* Im Home Assistant eigenen MQTT Broker ist der Wert drin, aber ich kann den Wert einfach hinzufügen&lt;br /&gt;
* Scheiß Home Assistant &lt;br /&gt;
&lt;br /&gt;
 # Topic&lt;br /&gt;
 shellyhtg3-543204567354/status/humidity:0&lt;br /&gt;
  &lt;br /&gt;
 # Wert&lt;br /&gt;
 {&amp;quot;id&amp;quot;: 0,&amp;quot;rh&amp;quot;:61.0}&lt;br /&gt;
 &lt;br /&gt;
 # für Home Assistant&lt;br /&gt;
 value_template: ' { { value_json.rh  } } '&lt;br /&gt;
&lt;br /&gt;
== Raspberry Pi Zero 2 W ==&lt;br /&gt;
&lt;br /&gt;
* take over control to the LED&lt;br /&gt;
&lt;br /&gt;
 echo none | sudo tee /sys/class/leds/ACT/trigger&lt;br /&gt;
 echo 0 | sudo tee /sys/class/leds/ACT/brightness&lt;br /&gt;
&lt;br /&gt;
== pwm.py ==&lt;br /&gt;
&lt;br /&gt;
 # apt install pigpio python3-paho-mqtt python3-json5&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # KEMO M240&lt;br /&gt;
 #  PWM Spannung: 3 V bis 24 V&lt;br /&gt;
 #  PWM Frequenz: 100 Hz bis 10 kHz&lt;br /&gt;
 #&lt;br /&gt;
 # Raspberry Pi Zero&lt;br /&gt;
 #  PWM0 Pin 18 xor 12, 3,3 V 1 kHz&lt;br /&gt;
 #  PWM1 Pin 13 xor 19, 3,3 V 1 kHz&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 import pigpio&lt;br /&gt;
 import time&lt;br /&gt;
 import random&lt;br /&gt;
 &lt;br /&gt;
 PWM_GPIO = 18&lt;br /&gt;
 PWM_FREQUENCY = 1000&lt;br /&gt;
 &lt;br /&gt;
 random.seed()&lt;br /&gt;
 pi = pigpio.pi()&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # Start Motor Full Speed for 4 Seconds&lt;br /&gt;
 #&lt;br /&gt;
 ret_code = pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, 1000000)&lt;br /&gt;
 print(ret_code)&lt;br /&gt;
 time.sleep(4)&lt;br /&gt;
 &lt;br /&gt;
 # print(pi.get_PWM_range(PWM_GPIO))&lt;br /&gt;
 # print(pi.get_PWM_real_range(PWM_GPIO)) &lt;br /&gt;
 &lt;br /&gt;
 while True:&lt;br /&gt;
 &lt;br /&gt;
  #pi.set_PWM_dutycycle(PWM_GPIO, 0)&lt;br /&gt;
  percent = random.randint(0,100)&lt;br /&gt;
  print(&amp;quot;set motor to &amp;quot;, percent, &amp;quot; %&amp;quot;)&lt;br /&gt;
  pi.hardware_PWM(PWM_GPIO, PWM_FREQUENCY, percent * 10000)&lt;br /&gt;
  time.sleep(15)&lt;br /&gt;
&lt;br /&gt;
== Diagnose ==&lt;br /&gt;
&lt;br /&gt;
 journalctl -r -u trio-vent&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;b&amp;gt;11.11.2025&amp;lt;/b&amp;gt; Testbetrieb, nun im github&lt;br /&gt;
 &amp;lt;b&amp;gt;10.11.2025&amp;lt;/b&amp;gt; Shelly 1 &amp;quot;SW&amp;quot; Problem erkannt und gelöst&lt;br /&gt;
 &amp;lt;b&amp;gt;24.10.2025&amp;lt;/b&amp;gt; Powermeter als MQTT Value auf einem Dashboard läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;10.10.2025&amp;lt;/b&amp;gt; MQTT.subscribe auf Shelly Wert &amp;quot;Humidity&amp;quot; läuft&lt;br /&gt;
 &amp;lt;b&amp;gt;09.10.2025&amp;lt;/b&amp;gt; zeitgleiches PWM0 und PWM1 mit Erfolg getestet&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Orgamon.net&amp;diff=33433</id>
		<title>Orgamon.net</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Orgamon.net&amp;diff=33433"/>
		<updated>2026-11-17T12:10:48Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Aktuelles */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Überblick ==&lt;br /&gt;
&lt;br /&gt;
*Die OrgaMon-App kontaktiert zum &amp;quot;senden&amp;quot; und &amp;quot;Start&amp;quot; jeweils den Domain &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net&amp;lt;/code&amp;gt; über https://- und FTPS://- Protokoll&lt;br /&gt;
**Es gibt ein Hauptzertifikat (für &amp;lt;code&amp;gt;cargobay.orgamon.net&amp;lt;/code&amp;gt;) sowie ihre Kopie davon, das Firmenzertifikat (für &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net&amp;lt;/code&amp;gt;)  &lt;br /&gt;
* Die Firmendomain wird mit einer festen IP-V4-Adresse verbunden, die IP-Adresse haben Sie bei der Beantragung des Subdomains &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; angegeben&lt;br /&gt;
**Auf dem Server mit dieser IP-Adresse muss das Firmenzertifikat installiert werden&lt;br /&gt;
* Für die Absicherung des Datenverkehrs muss auf Ihrem Server das *.orgamon.net Haupt-Zertifikat (als Kopie) installiert werden&lt;br /&gt;
* Dieses liegt auf dem bei Strato gemietetem Webserver &amp;quot;cargobay.orgamon.net&amp;quot; - auf dem auch dieses Wiki gehostet ist - für Sie zum Abruf bereit&lt;br /&gt;
** Das Zertifikat wird aus 3 Dateien gebildet:&lt;br /&gt;
** &amp;lt;code&amp;gt;cert.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;code&amp;gt;fullchain.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;code&amp;gt;privkey.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
* Dieses ist immer für 3 Monate gültig und muss vor Ablauf aufgefrischt werden&lt;br /&gt;
* Das jeweils aktuelle Zertifikat ist auf dem Server &amp;quot;orgamon.net&amp;quot; gespeichert und kann von dort abgerufen werden&lt;br /&gt;
* Hier ist die Beschreibung wie Sie dieses Zertifikat herunterladen und auf Ihrem Server aktualisieren können:&lt;br /&gt;
**Zusammengefasst ist die &amp;quot;Installation&amp;quot; eine 1:1 Kopie des Hauptzertifikates auf Ihr System&lt;br /&gt;
&lt;br /&gt;
== Wann läuft das aktuelle Haupt-Zertifikat ab ? ==&lt;br /&gt;
* Anzeigen des ganzen Zertifikates im Browser&lt;br /&gt;
&lt;br /&gt;
 https://cargobay.orgamon.net/&lt;br /&gt;
&lt;br /&gt;
* Firefox: links neben der URL auf das Schlosssymbol klicken&lt;br /&gt;
** Verbindung sicher&lt;br /&gt;
** weitere Informationen&lt;br /&gt;
** Zertifikat anzeigen&lt;br /&gt;
&lt;br /&gt;
* Chrome: links neben der URL auf das Schieberegler-Symbol klicken&lt;br /&gt;
** Verbindung ist sicher&lt;br /&gt;
** Zertifikat ist gültig&lt;br /&gt;
&lt;br /&gt;
* Das Zertifikat auf &amp;quot;orgamon.net&amp;quot; wird in der Regel frühestens 20 Tage vor dem Ablauf aber spätestens 10 Tage vor dem Ablauf erneuert&lt;br /&gt;
&lt;br /&gt;
== Update ==&lt;br /&gt;
&lt;br /&gt;
* Loggen Sie sich mit Putty in Ihren OrgaMon-App-Server ein: &amp;amp;rarr;&amp;lt;code&amp;gt;Ticket&amp;lt;/code&amp;gt;&amp;amp;rarr;Reiter &amp;lt;code&amp;gt;Rechner&amp;lt;/code&amp;gt;&amp;amp;rarr;Klicken Sie auf Ihren OrgaMon-App-Linux-Server in der Liste&amp;amp;rarr;Symbol &amp;lt;i&amp;gt;schwarzer Schirm mit rot und grün&amp;lt;/i&amp;gt; (ssh root login via putty)&lt;br /&gt;
* Wechseln Sie auf ihrem OrgaMon-App-Server in das Verzeichnis /etc/nginx/orgamon.net&lt;br /&gt;
&lt;br /&gt;
 cd /etc/nginx/orgamon.net&lt;br /&gt;
&lt;br /&gt;
* Starten Sie das dortige Update Script&lt;br /&gt;
&lt;br /&gt;
 ./update.sh&lt;br /&gt;
&lt;br /&gt;
* Geben Sie nun 3 mal ein angefordertes Passwort ein, das Sie bei der Beantragung des Domains &amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net als &amp;quot;Zertifikat-Refresh-Passwort&amp;quot; erhalten haben (Es ist nicht Ihr &amp;quot;Firmenpasswort&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== Neustart von Diensten ===&lt;br /&gt;
&lt;br /&gt;
* Starten Sie nginx neu&lt;br /&gt;
&lt;br /&gt;
 systemctl restart nginx&lt;br /&gt;
&lt;br /&gt;
* Starten Sie vsftpd neu&lt;br /&gt;
&lt;br /&gt;
 systemctl restart vsftpd&lt;br /&gt;
&lt;br /&gt;
=== Prüfen ===&lt;br /&gt;
&lt;br /&gt;
* Anzeigen des Verfallsdatums des erhaltenen Zertifikates in der Kommandozeile&lt;br /&gt;
&lt;br /&gt;
 openssl x509 -enddate -noout -in cert.pem&lt;br /&gt;
&lt;br /&gt;
=== Ende ===&lt;br /&gt;
&lt;br /&gt;
 exit&lt;br /&gt;
&lt;br /&gt;
== Problemlösungen ==&lt;br /&gt;
&lt;br /&gt;
=== Vergessen das Firmenzertifikat zu aktualisieren ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Fehlermeldung Orgamob Zertifikatswechsel.jpg]]&lt;br /&gt;
&lt;br /&gt;
*Fehlermeldung nach dem Senden, wenn der Zertifikatswechsel nicht durchgeführt wurde: Handshake Exception &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Aktuelles == &lt;br /&gt;
&lt;br /&gt;
* durchgeführte Erneuerungen des Hauptzertifikates auf orgamon.net werden hier durch den Admin protokolliert. &lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|1=ändern Sie bitte hier nichts, das hat nichts mit Ihrer Zertifikatskopie zu tun, dafür sind Sie selbst verantwortlich}}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;17.11.2026: Nächster Ablauf des Zertifikates: 15.02.2027&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;27.08.2026: Nächster Ablauf des Zertifikates: 25.11.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;02.06.2026: Nächster Ablauf des Zertifikates: 31.08.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;09.03.2026: Nächster Ablauf des Zertifikates: 07.06.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;19.12.2025: Nächster Ablauf des Zertifikates: 18.03.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;08.10.2025: Nächster Ablauf des Zertifikates: 06.01.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;10.07.2025: Nächster Ablauf des Zertifikates: 08.10.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;17.04.2025: Nächster Ablauf des Zertifikates: 16.07.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.02.2025: Nächster Ablauf des Zertifikates: 04.05.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;12.11.2024: Nächster Ablauf des Zertifikates: 10.02.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;26.08.2024: Nächster Ablauf des Zertifikates: 24.11.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;02.06.2024: Nächster Ablauf des Zertifikates: 02.09.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;08.03.2024: Nächster Ablauf des Zertifikates: 06.06.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;21.12.2023: Nächster Ablauf des Zertifikates: 20.03.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;29.09.2023: Nächster Ablauf des Zertifikates: 28.12.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;19.07.2023: Nächster Ablauf des Zertifikates: 17.10.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;15.06.2023: Nächster Ablauf des Zertifikates: 13.09.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.04.2023: Nächster Ablauf des Zertifikates: 01.07.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;21.01.2023: Nächster Ablauf des Zertifikates: 21.04.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;24.10.2022: Nächster Ablauf des Zertifikates: 22.01.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.08.2022: Nächster Ablauf des Zertifikates: 01.11.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;23.05.2022: Nächster Ablauf des Zertifikates: 21.08.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;01.03.2022: Nächster Ablauf des Zertifikates: 30.05.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Foto&amp;diff=33430</id>
		<title>Foto</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Foto&amp;diff=33430"/>
		<updated>2026-10-23T16:47:21Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Fotoapparatur */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Um die OrgaMon-Foto Verwaltung benutzen zu können brauchen Sie einen OrgaMon &amp;quot;ohne Dienste&amp;quot;&lt;br /&gt;
* Erst dann können Sie im OrgaMon-Hauptmenü die Schaltfläche &amp;amp;rarr;&amp;lt;code&amp;gt;Foto&amp;lt;/code&amp;gt; nutzen&lt;br /&gt;
* Mit &amp;lt;code&amp;gt;Foto&amp;lt;/code&amp;gt; verwalten und Steuern Sie viele Aufgaben rund um Auftragsfotos und deren Zugänglichkeit/Umbenennung für ihre Kunden&lt;br /&gt;
&lt;br /&gt;
== OrgaMon &amp;quot;ohne Dienste&amp;quot; ==&lt;br /&gt;
&lt;br /&gt;
{{Info|1=Überspringen Sie diesen Punkt wenn Sie auf dem Desktop ein OrgaMon-Symbol mit der Unterschrift &amp;quot;OrgaMon - ohne Dienste&amp;quot; bereits haben!}}&lt;br /&gt;
&lt;br /&gt;
* (Sind die folgenden Schritte bei Ihnen nicht möglich, kann es sein dass Ihr Benutzerprofil eingeschränkt wurde! Bitten Sie in diesem Fall Ihren Administrator &amp;quot;OrgaMon - ohne Dienste&amp;quot; anzulegen.)&lt;br /&gt;
* Drücken Sie links unten auf das Windows &amp;quot;Start&amp;quot; Symbol&lt;br /&gt;
* Gehen Sie in der alphabetischen Liste der Programm nach unten bis &amp;quot;O&amp;quot; wir OrgaMon...&lt;br /&gt;
* Klicken Sie auf den fgelben Ordner &amp;quot;OrgaMon&amp;quot;, so dass sich Unterpunkte öffnen&lt;br /&gt;
* Klicken und halten Sie &amp;quot;OrgaMon&amp;quot; und ziehen Sie das Symbol auf Ihren Desktop&lt;br /&gt;
&lt;br /&gt;
[[Datei:OrgaMon-Symbol.png]]&lt;br /&gt;
&lt;br /&gt;
* Rechte Maustaste auf das neue Symbol und &amp;quot;Eigenschaften&amp;quot;&lt;br /&gt;
* Im Reiter &amp;quot;Verknüpfung&amp;quot; im Eingabefeld &amp;quot;Ziel:&amp;quot; ergänzen Sie den bestehenden Eintrag um &amp;lt;code&amp;gt;-ds&amp;lt;/code&amp;gt; (&amp;lt;Leerschritt&amp;gt; &amp;quot;-&amp;quot; &amp;quot;d&amp;quot; &amp;quot;s&amp;quot;)&lt;br /&gt;
* dann auf OK, Klicken Sie jetzt noch auf die Symbolunterschrift &amp;quot;OrgaMon&amp;quot; (keine Doppelklick!), diesen Text sollte man ergänzen mit &amp;lt;code&amp;gt; - ohne Dienste&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Id wählen ==&lt;br /&gt;
&lt;br /&gt;
* Sie konnten den &amp;quot;OrgaMon - ohne Dienste&amp;quot; starten, dann ist auch &amp;quot;Foto&amp;quot; freigeschaltet&lt;br /&gt;
* Sie erkennen dass der OrgaMon ohne Dienste läuft daran, dass alle Dienstampeln auf rot stehen&lt;br /&gt;
** [[Datei:OrgaMon-ohne-Dienste.png]]&lt;br /&gt;
* Wählen Sie den Menü-Punkt &amp;quot;Foto&amp;quot;&lt;br /&gt;
* dann die Drop-Down Box bei Id&lt;br /&gt;
* dann werden Firmen-Mandanten angeboten, also verschiedene Identitäten, die auf Ihrem Server betrieben werden&lt;br /&gt;
* Wenn nur ein Mandant angeboten wird, nehmen Sie diesen&lt;br /&gt;
* dann die Taste &amp;quot;Init&amp;quot;&lt;br /&gt;
&lt;br /&gt;
[[Datei:Foto-Pflege-2.png]]&lt;br /&gt;
&lt;br /&gt;
== Fotos (Verwaltungsaufgaben) ==&lt;br /&gt;
&lt;br /&gt;
=== Fotos neu benennen lassen ===&lt;br /&gt;
&lt;br /&gt;
{{Info|1= Sie haben eine Umbenennungsvorschrift geändert, dann können Sie Bilder der Internet-Ablage neu benennen lassen}}&lt;br /&gt;
&lt;br /&gt;
* Schalter Foto im Orgamon ohne Dienste &lt;br /&gt;
* ID auswählen, Schalter Init&lt;br /&gt;
* Reiter &amp;quot;Jpegs&amp;quot;&lt;br /&gt;
* Bei &amp;lt;b&amp;gt;Pfad&amp;lt;/b&amp;gt; den vollständigen Pfad der Internet-Ablage reinkopieren, z.B. J:\Ablagen\stadwerke-entenhausen\ (&amp;lt;Backslash&amp;gt; am Ende ist Pflicht!)&lt;br /&gt;
* Bei &amp;lt;b&amp;gt;Ablage&amp;lt;/b&amp;gt; nochmal einfach nur den Namen der Ablage, also &amp;lt;code&amp;gt;stadtwerke-entenhausen&amp;lt;/code&amp;gt;&lt;br /&gt;
* Nun das Symbol &amp;lt;b&amp;gt;Refresh&amp;lt;/b&amp;gt; drücken, es muss eine Liste der Bilder erscheinen, das erste Bild ist markiert und wird angezeigt&lt;br /&gt;
* Mit den &amp;quot;Hoch&amp;quot; / &amp;quot;Runter&amp;quot; Tasten das Bild wählen das neu umbenannt werden muss&lt;br /&gt;
* jeweils &amp;lt;F2&amp;gt; drücken, das Bild verschwindet dann, nach refresh sollte es aber wieder - diesmal richtig benannt wieder erscheinen&lt;br /&gt;
&lt;br /&gt;
=== Foto-nnnn.zips erstellen lassen ===&lt;br /&gt;
&lt;br /&gt;
{{Info|1= Sie haben z.B. Fotos von Vortagen nachgeliefert bekommen, und wollen jetzt das der Kunde oder Sie die Fotos schneller bekommen}}&lt;br /&gt;
&lt;br /&gt;
* Schalter Foto im Orgamon ohne Dienste &lt;br /&gt;
* ID auswählen, Schalter Init&lt;br /&gt;
* Reiter &amp;quot;Ablegen/Dienste&amp;quot;&lt;br /&gt;
* Bei &amp;lt;b&amp;gt;Einzelne Ablage&amp;lt;/b&amp;gt; den Namen der Internet-Ablage eintragen z.B. &amp;lt;code&amp;gt;stadtwerke-entenhausen&amp;lt;/code&amp;gt;&lt;br /&gt;
** wenn man nichts eingibt werden alle Internet-Ablagen verarbeitet&lt;br /&gt;
* Taste &amp;lt;b&amp;gt;Zips ablegen/Fotos ablegen&amp;lt;/b&amp;gt; drücken, dann werden Fotos-nnnn.zips erstellt&lt;br /&gt;
&lt;br /&gt;
=== Fehler bei der Foto-Zuordnung ===&lt;br /&gt;
&lt;br /&gt;
{{Info|1= Foto Zuordnungen können aus verschiedenen Gründen misslingen}}&lt;br /&gt;
&lt;br /&gt;
* Schalter Foto im Orgamon ohne Dienste &lt;br /&gt;
* ID auswählen, Schalter Init&lt;br /&gt;
* Reiter &amp;quot;Unverarbeitet&amp;quot;&lt;br /&gt;
* Refresh-Knopf drücken&lt;br /&gt;
* einzelne Fotos anklicken, unten steht dann die Fehlermeldung&lt;br /&gt;
&lt;br /&gt;
* Schalter &amp;lt;code&amp;gt;Anfordern&amp;lt;/code&amp;gt;&lt;br /&gt;
** Die Foto-Datei wird beim nächsten &amp;quot;senden&amp;quot; des Monteurs erneut angefordert. Die FTPS Übertragung also nochmals gestartet.&lt;br /&gt;
&lt;br /&gt;
* Schalter &amp;lt;code&amp;gt;Neu zuordnen&amp;lt;/code&amp;gt;&lt;br /&gt;
** Die Datei wird nun nochmals (mit aktuellen Wissenstand) zugeordnet. Dies ist hilfreich wenn man das Problem das zuvor bestand gelöst hat. Die Datei sollte dann verschwinden, wenn Sie wieder auftaucht ist das Problem noch nicht gelöst&lt;br /&gt;
 &lt;br /&gt;
* Schalter &amp;lt;code&amp;gt;Alle neu zuordnen&amp;lt;/code&amp;gt;&lt;br /&gt;
** analog zu &amp;quot;Neu zuordnen&amp;quot;, nur dies gilt für alle Dateien&lt;br /&gt;
&lt;br /&gt;
* Schalter &amp;lt;code&amp;gt;Amnestie&amp;lt;/code&amp;gt;&lt;br /&gt;
** Die Datei nach .\bak\#nnn\Amnestiegrund\ für immer ablegen. So hält man .\htm sauber und hat dennoch in .\bak\ die Dateien gesichert&lt;br /&gt;
&lt;br /&gt;
== Einleitung ==&lt;br /&gt;
&lt;br /&gt;
Fotos dienen der Dokumentation eines Auftrages. Das Schliessen des Datenkreislaufes vom &amp;quot;elektronischen Auftrags-Dokument&amp;quot; bis zum &amp;quot;Ergebnis-Dokument zum Upload in das Auftraggeber-IT-System&amp;quot; gelang erstmals 1999.&amp;lt;br&amp;gt;&lt;br /&gt;
Bei der Übergabe von Fotos an den Kunden können verschiedene Möglichkeiten angewendet werden:&lt;br /&gt;
&lt;br /&gt;
* Zusätzlich zu einem xls-Dokument werden Fotos in einer Datenmeldung geliefert&lt;br /&gt;
* Datenausbelichtungen als html oder pdf sind möglich.&lt;br /&gt;
* Fotos werden auf der Internet-Ablage des Kunden abrufbar gemacht&lt;br /&gt;
&lt;br /&gt;
== Voraussetzungen ==&lt;br /&gt;
&lt;br /&gt;
=== Dienste ===&lt;br /&gt;
&lt;br /&gt;
* Installation eines FTP-Serves für den Foto-Upload und eines Foto-Servers der die Bilder zuordnet&lt;br /&gt;
&lt;br /&gt;
=== Arbeitsplatz ===&lt;br /&gt;
&lt;br /&gt;
* damit Sie mit Ihrem OrgaMon-Arbeitsplatz Dienste des Foto-Servers ausführen können müssen Sie ihre lokale (Dokumente\OrgaMon\OrgaMon.ini) und zentrale (OrgaMonNetwerkverzeichnis\OrgaMon.ini) um einige Zeilen erweitern. In DataBaseName= muss der &amp;quot;dat&amp;quot; Pfad des Foto-Servers angegeben werden&lt;br /&gt;
* In der zweiten eckigen Klammer muss ihr &amp;quot;id&amp;quot; für den Server Dienst angegeben werden&lt;br /&gt;
&lt;br /&gt;
[[Datei:Foto-Pflege-1.png]]&lt;br /&gt;
&lt;br /&gt;
== Motivation für Fotos ==&lt;br /&gt;
&lt;br /&gt;
* Bei Mängeln / Manipulationen / Nachfragen können auch sofortige Beweisfotos sowie Hinweis-Fotos für das Störungsteam zur Vorabinfo bereit gestellt werden.&lt;br /&gt;
* Die Foto-Haltung ist auch möglich ohne dass die Fotos an den Kunden weitergegeben werden, dies dient dann zur internen Qualitätsicherung und Dokumentation&lt;br /&gt;
&lt;br /&gt;
== Voraussetzungen ==&lt;br /&gt;
&lt;br /&gt;
* Beherrschung der Rohdaten-Schnittstelle des Versorgers.&lt;br /&gt;
&lt;br /&gt;
=== IT-Infrastruktur (Dienstleister) ===&lt;br /&gt;
&lt;br /&gt;
* Online-Anbindung des Monteursnetz an die Zentrale des Dienstleister&lt;br /&gt;
* Möglichkeiten des Dienstleisters jederzeit Bild-Daten dem Versorger bereitzustellen (Bei Gefahr im Verzug)&lt;br /&gt;
&lt;br /&gt;
=== Fotoapparatur ===&lt;br /&gt;
&lt;br /&gt;
* Fotomodus &amp;quot;Nahaufnahme 10 cm&amp;quot; muss möglich sein&lt;br /&gt;
* Der Foto muss mit der üblicherweise schlechten Beleuchtung am Zählerplatz zurechtkommen (Blitz/Eigentlicht notwendig!)&lt;br /&gt;
* Auflösung ab 2,5 Megapixel bis 5,5 Megapixel, jedoch Schärfe ist ausschlaggebend.&lt;br /&gt;
* Nur digitale Fotos im JPEG Bildformat, maximal 1,5 MByte pro Bild&lt;br /&gt;
* In jedem Bild (im normierten EXiF Format): &lt;br /&gt;
** Datum und Uhrzeit des Auslösemomentes&lt;br /&gt;
** Anpassen des Dateidatums an den Aufnahmemoment &amp;lt;code&amp;gt;exiftool '-DateTimeOriginal&amp;gt;FileModifyDate' .&amp;lt;/code&amp;gt;&lt;br /&gt;
** eindeutiges Identifikationsmerkmal des Monteurs bzw. der Kamera&lt;br /&gt;
** Optional: Geolokalisierungspunkt (Geo-Koordinate)&lt;br /&gt;
** Ausrichtung der Kamera, http://www.impulseadventure.com/photo/exif-orientation.html&lt;br /&gt;
&lt;br /&gt;
=== IT ===&lt;br /&gt;
&lt;br /&gt;
* Übertragungsweg Monteur -&amp;gt; Diensleisterzentrale muss gesichert sein&lt;br /&gt;
* Übertragungsweg Dienstleisterzentrale -&amp;gt; Versorger muss gesichert sein&lt;br /&gt;
&lt;br /&gt;
=== Datenschutz ===&lt;br /&gt;
&lt;br /&gt;
* Fotos innerhalb der Wohnung des Endkunden unterliegen grundsätzlich den strengsten Datenschutzbestimmungen&lt;br /&gt;
* Auf den Fotos dürfen keine Personen abgebildet werden&lt;br /&gt;
* Der Bildausschnitt muss überwiegend den Zählerplatz mit Zähler ohne grössere Umgebung umfassen&lt;br /&gt;
* Das Foto sollte zwar eindeutig den Zähler, ev. noch den Zählerplatz jedoch keine zufälligen / individuelle / private Details der Umgebung zeigen&lt;br /&gt;
* Das Fotografieren ist überhaupt nur möglich, da sich der Zähler im Eigentum des Versorgers befindet&lt;br /&gt;
&lt;br /&gt;
== Ziel ==&lt;br /&gt;
&lt;br /&gt;
* Nachkontrollmöglichkeit des Zählerstandes / der Zählernummer (nach dem Ausbau)&lt;br /&gt;
* Dokumentations-Ablage des Zählerbildes da Zähler verschrottet wird&lt;br /&gt;
* Herausgabemöglichkeit einer Beweisgrundlage bei Nachfragen des Endkunden&lt;br /&gt;
&lt;br /&gt;
=== Dokumentation Ausbau ===&lt;br /&gt;
&lt;br /&gt;
* deutliche Zählernummer&lt;br /&gt;
* deutlicher Ausbaustand&lt;br /&gt;
* Zustand / Bauform des Gerätes wird deutlich&lt;br /&gt;
&lt;br /&gt;
=== Dokumentation Einbau ===&lt;br /&gt;
&lt;br /&gt;
* Plausibilisierung des Einbau-Momentes bei unsicherer neuer Zählernummer.&lt;br /&gt;
* Kontrollmöglichkeit (Zählerstand) bei geeichten Geräten mit Einbaustand &amp;lt;&amp;gt; 0.&lt;br /&gt;
* Dokumentation der Einbau-Position am Zählerplatz&lt;br /&gt;
&lt;br /&gt;
=== Dokumentation Anlage ===&lt;br /&gt;
&lt;br /&gt;
* Allgemeiner Zustand &lt;br /&gt;
* Qualitätsbeurteilung&lt;br /&gt;
* Manipulationen an der Anlage (Stromdiebstahl)&lt;br /&gt;
* Unzulässige Modifikationen&lt;br /&gt;
* Laienhafte Änderungen / Reparaturversuche&lt;br /&gt;
&lt;br /&gt;
== Ergebnismeldung ==&lt;br /&gt;
&lt;br /&gt;
* Der Dienstleister stellt isolierten Speicherplatz auf seinem via Internet zugänglichen Server bereit&lt;br /&gt;
* Arbeitet der Dienstleister für verschiedene Versorger muss die gegenseitige Sichtbarkeit der Daten technisch ausgeschlossen werden&lt;br /&gt;
* Die Bild-Übertragung erfolgt immer verschlüsselt auf eine passwortgesicherte Internetablage&lt;br /&gt;
* Die Tagwerke sind pro Monteur pro Tag in ZIP-Archive zusammenzufassen&lt;br /&gt;
&lt;br /&gt;
=== Weg der Meldung ===&lt;br /&gt;
&lt;br /&gt;
* Der Versorger muss Alternativ via FTP://- oder HTTP://-Protokoll Zugriff erhalten&lt;br /&gt;
&lt;br /&gt;
=== Dateinamen-Konvention ===&lt;br /&gt;
&lt;br /&gt;
* Ohne eine besondere Konfiguration haben alle auftragsbezogenen Bilder folgenden Dateinamen&lt;br /&gt;
&lt;br /&gt;
  // Bild-Namenskonvention&lt;br /&gt;
  //&lt;br /&gt;
  // GeraeteID &amp;quot;-&amp;quot; RID &amp;quot;-&amp;quot; BildProtokollName[ &amp;quot;-&amp;quot; n ].jpg&lt;br /&gt;
  // &amp;quot;-&amp;quot; n wird nur angefügt sobald auf dem Smartphone eine Bildnamensgleichheit&lt;br /&gt;
  // erkannt wird.&lt;br /&gt;
  //&lt;br /&gt;
  // &amp;lt;b&amp;gt;GeraeteID&amp;lt;/b&amp;gt;          die 3 stellige Handy-Nummer gespeichert beim Monteur&lt;br /&gt;
  // &amp;lt;b&amp;gt;RID&amp;lt;/b&amp;gt;                das Datenbankfeld &amp;lt;i&amp;gt;RID&amp;lt;/i&amp;gt; der Tabelle &amp;lt;i&amp;gt;AUFTRAG&amp;lt;/i&amp;gt;&lt;br /&gt;
  // &amp;lt;b&amp;gt;ProtokollVariable&amp;lt;/b&amp;gt;  2 stelliger Variablenname beginnend mit &amp;lt;i&amp;gt;F&amp;lt;/i&amp;gt;, also &amp;lt;i&amp;gt;FA&amp;lt;/i&amp;gt;,&amp;lt;i&amp;gt;FN&amp;lt;/i&amp;gt; usw.&lt;br /&gt;
&lt;br /&gt;
==== Bilder ====&lt;br /&gt;
&lt;br /&gt;
* Das Bild selbst muss die Ausbau-Zählernummer im Dateinamen tragen:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;Zählernummer-Ausbau&amp;gt;.jpg, Beispiel: 52000-281723.jpg&lt;br /&gt;
&lt;br /&gt;
Zusätzliche Bilder werden im Namen noch erweitert.&lt;br /&gt;
&lt;br /&gt;
* Einbauzähler: &amp;lt;Zählernummer-Ausbau&amp;gt;-Neu.jpg  ( das Bild des Ausbauzählers )&lt;br /&gt;
* Anlage: &amp;lt;Zählernummer-Ausbau&amp;gt;-Anlage.jpg ( das Bild der Gesamtanlage )&lt;br /&gt;
* Mängel: &amp;lt;Zählernummer-Ausbau&amp;gt;-Mangel.jpg ( Detailansicht des Mangels )&lt;br /&gt;
* Fatal: &amp;lt;Zählernummer-Ausbau&amp;gt;-Störung.jpg ( Störungsgrund )&lt;br /&gt;
&lt;br /&gt;
==== Bild-Archive ====&lt;br /&gt;
&lt;br /&gt;
* Die täglichen Datenlieferungen des Dienstleisters sind fortlaufend durchzunummerieren: Bilder-0001.zip, Bilder-0002.zip&lt;br /&gt;
* Im Archiv ist das Tagwerk des Dienstleisters oder das Tagwerk eines einzelnen Monteures zu konzentrieren&lt;br /&gt;
* Dateidatum und Dateiuhrzeit des Archives muss der Archiv-Bereitstellungsmoment sein&lt;br /&gt;
&lt;br /&gt;
== Erläuterung ==&lt;br /&gt;
&lt;br /&gt;
*FTPServer=orgamon.de&lt;br /&gt;
*FTPBenutzer=energie-entenhausen  ''- Ablage http://energie-entenhausen.meineablage.tld/'' &lt;br /&gt;
*FTPPasswort=*********  ''- Passwort Internetablage''&lt;br /&gt;
*ZipPasswort=*********  ''- Passwort Zipdatei'' &lt;br /&gt;
*QS_Mode=2&lt;br /&gt;
*SpaltenReihenfolge=ID;Zaehler_Nummer;Fabrikat;Lager;Werk;Standort;MaterialnummerNeu;ZaehlwerksnummerNeu;Art(5);Vorkomma;Nachkomma;Konstante;ZaehlerStandAlt;ZaehlerStandNeu;ZaehlerNummerNeu;Lager(L);WechselDatum;WechselZeit&lt;br /&gt;
*ZipPräfix=mea_x_u.2009&lt;br /&gt;
*FreieZähler=energie-entenhausen\mea_mzv_d.tab.csv  ''- Dateiname der Lagerdatei''&lt;br /&gt;
*AuchAlsCSV=JA&lt;br /&gt;
*eMail=1002&lt;br /&gt;
&lt;br /&gt;
* Namen der Spalten&lt;br /&gt;
&lt;br /&gt;
*MaterialnummerNeu=MaterialnummerNeu&lt;br /&gt;
*ZaehlwerksnummerNeu=ZaehlwerksnummerNeu&lt;br /&gt;
*Zählwerk=ZaehlwerksnummerAlt&lt;br /&gt;
&lt;br /&gt;
 '''Einstellungen für Foto-Betrieb'''&lt;br /&gt;
&lt;br /&gt;
*FotoQuelle=L:\  ''- Verzeichnis Cardreader''&lt;br /&gt;
*ZusätzlicheZips=J:\OrgaMon\Baustellen\EHAUS\Upload\ ''- Speicherverzeichnis aus dem Orgamon die Datei lädt''&lt;br /&gt;
*FotoAblage=I:\Aufträge\EV Entenhausen 2009\Images\'' - Orgamon erstellt automatisch eine Sicherungsdatei von dem Upload''&lt;br /&gt;
&lt;br /&gt;
== Fotos suchen / Fotos nachreichen ==&lt;br /&gt;
&lt;br /&gt;
kann ein Datensatz wegen fehlendem Eintrag in &amp;quot;FA&amp;quot; nicht gemeldet werden, so beginnt die Suche nach dem Foto. Ich beschreibe hier diverse Möglichkeiten der Suche und den &amp;quot;offiziellen&amp;quot; Weg einer ordentlichen Nachmeldung.&lt;br /&gt;
&lt;br /&gt;
=== Suchen und finden ===&lt;br /&gt;
&lt;br /&gt;
* Tipp: Laden Sie zunächst alle Bilder mit &amp;amp;rarr;&amp;lt;code&amp;gt;Baustellen&amp;lt;/code&amp;gt;&amp;amp;rarr;Fotos&amp;amp;rarr;Fotos einlesen&amp;amp;rarr;Symbol &amp;quot;Weltkugel Download&amp;quot; herunter.&lt;br /&gt;
* NNNN-Bilder_Unbenannt.zip: In diesem Archiv befinden sich Bilder die noch nicht erkannt werden konnten. Hier ist das Ansehen der Bilder an sich also notwendig. Den Inhalt dieser Zips finden Sie im Foto-Zentrallager in den Geräte-Unterverzeichnisse. Es ist also bekannt &amp;quot;WER&amp;quot; (welches Gerät) das Foto geliefert hat.&lt;br /&gt;
* NNNN-Bilder.zip: Auf der Internetablage des Versorgers befinden sich Archive mit dem Namen Bilder-NNNN.zip. In diesem Archiv befinden sich eigentlich nur Bilder, die OrgaMon-Foto umbenannt hat. Die Umbenennung wird auch an den OrgaMon-Büro gemeldet. Dies äussert sich durch ordentliche FA= , FN= Einträge. Dennoch kann sein, dass der Monteur einfach vor dem Hochladen Bilder selbst umbenannt und in das passende Verzeichnis gestellt hat - in diesem Fall ist das Bild im zip - es fehlt jedoch der FA= Eintrag. Der Monteur wird wohl bei der Umbenennung die Methode, die sonst auch bei der Bildumbennung angewendet wird verwendet haben, so kann man nach der &amp;quot;alten Zählernummer&amp;quot; im Dateinamen ausschau halten.&lt;br /&gt;
* Eine gute Quelle für &amp;quot;verlorene Bilder&amp;quot; sind auch die -Neu.jpgs. Soll der Monteur nur 1 Bild pro Zählerwechsel machen ist das -Neu Bild entweder ein unnötiges zweites Bild des Zählers ODER das gesuchte Bild. &amp;quot;-Neu&amp;quot; Bilder deuten darauf hin dass der Monteur die Reihenfolge &amp;quot;JonDa/Foto/JonDa/Foto&amp;quot; nicht eingehalten hat.&lt;br /&gt;
* Bilder noch auf dem Handy? Wurde ev. auf den Telefonspeicher fotografiert? Dann ist nach dem Andocken des Handys an den PC kein einziges Bild vorhanden.&lt;br /&gt;
* Datensicherung: Bei &amp;quot;Speicherkarte leerlesen&amp;quot; wird immer eine Kopie des Bildes auf dem Netbook abgelegt ~GeräteNrDesMonteurs~&amp;quot;-&amp;quot;~FortlaufendeNummer~.jpg! Diese Kopien befinden sich im Verzeichnis ~EigeneDateien~\OrgaMon\Fotos. Hier kann man über die Monteursnummer und Datum / Uhrzeit das gesuchte Bild finden.&lt;br /&gt;
&lt;br /&gt;
=== Manuell melden ===&lt;br /&gt;
&lt;br /&gt;
* Wurde nun ein fehlendes Bild gefunden, benennt man das Bild wie auf dieser Baustelle üblich und speichert es in das &amp;quot;Foto&amp;quot;-Verzeichnis der Baustelle (&amp;amp;rarr;Baustelle&amp;amp;rarr;oberes Symbol &amp;quot;Gelber Ordner&amp;quot;&amp;amp;rarr;Unterverzeichnis &amp;quot;Fotos&amp;quot;). Alle Bilder, die in diesem Verzeichnis gespeichert sind werden später per Knopfdruck archiviert und auf die Versorger-Ablage gestellt. &lt;br /&gt;
&lt;br /&gt;
Mit dem reinen Umbenennen und Bereitstellen sind wir jedoch noch nicht fertig. Hintergrund-Info: &lt;br /&gt;
&lt;br /&gt;
* Es ist wichtig bei Foto Meldungen ...&lt;br /&gt;
** den JonDaServer zu informieren. &lt;br /&gt;
** das OrgaMon-Büro zu informieren (FA=Eintrag!), dies erfolgt über den Standard-Weg der Ergebnismeldung des JonDaServers an OrgaMon.&lt;br /&gt;
** das Foto im zentralen &amp;quot;Foto-Lager&amp;quot; zu speichern&lt;br /&gt;
** das Foto dem Versorger bereitzustellen&lt;br /&gt;
&lt;br /&gt;
Nur wenn Fotos in dieser Art gemeldet werden, werden die entsprechenden Aufträge beim Monteur auch &amp;quot;grün&amp;quot;, da der JonDaServer von der Erledigung erfahren hat.&lt;br /&gt;
&lt;br /&gt;
OrgaMon&amp;amp;rarr;Baustelle&amp;amp;rarr;Reiter &amp;quot;Foto&amp;quot;&amp;amp;rarr;Im Bereich &amp;quot;Fotos zuordnen&amp;quot; das 3. Symbol &amp;quot;Eingabefeld&amp;quot; (Hinweis: &amp;quot;Manueller Modus&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
Zugegeben: dieser Dialog ist etwas für Experten.&lt;br /&gt;
&lt;br /&gt;
* Gerät: Tragen sie hier ein welchem Monteur der Auftrag zugeteilt war, Beispiel 007&lt;br /&gt;
* RID: bestimmen Sie zuvor den RID des passenden Auftrages und tragen sie in hier ein&lt;br /&gt;
* Dateiname: Tragen Sie hier den Dateinamen des Bildes ein (ohne Pfad), Beispiel 29928383.jpg&lt;br /&gt;
* FA / FN : Kreuzen Sie an ob es sich um das &amp;quot;Ausbau&amp;quot; oder &amp;quot;Neu&amp;quot; Bild handelt&lt;br /&gt;
* &amp;quot;nächste Zuordnung&amp;quot;: Drücken sie hier wenn Sie die Meldung senden wollen, dies ist für jedes Bild notwendig.&lt;br /&gt;
* &amp;quot;Ende&amp;quot;: drücken Sie nach der letzten &amp;quot;nächste Zuordnung&amp;quot; auch noch zusätzlich &amp;quot;Ende&amp;quot; um die Transaktion auf dem Server abzuschliessen&lt;br /&gt;
&lt;br /&gt;
Danach ist Mobil&amp;amp;rarr;nur &amp;quot;Mobile Ergebnisdaten&amp;amp;rarr;OrgaMon&amp;quot; durchzuführen. Jetzt werden die eben gemeldeten FA und FN auch in den Aufträgen eingetragen.&lt;br /&gt;
&lt;br /&gt;
Nun kann man die Bilder dem Versorger zur Verfügung stellen: Baustelle&amp;amp;rarr;Fotos&amp;amp;rarr;Fotos hochladen (ACHTUNG: Dabei wird eine Ergebnismeldung an den Versorger durchgeführt)&lt;br /&gt;
&lt;br /&gt;
== Fotos-nnnn.zip werden nicht erstellt ==&lt;br /&gt;
&lt;br /&gt;
* werden um 00:00 Uhr die Foto-Archive des Vortages nicht erstellt (dies ist die Aufgabe des Foto-Servers), so hat dies weitreichende Konzequenzen&lt;br /&gt;
** Wenn keine Foto-Zips vorhanden sind, werden diese auch nicht in die Foto-Verzeichnisse heruntergeladen&lt;br /&gt;
** Q25 könnten z.B. einen kritischen Zustand bekommen da Voraussetzung für die Ergebnismneldung die Existenz eines Fotos ist&lt;br /&gt;
** Es unterbleiben dadurch Ergebnismeldungen&lt;br /&gt;
** Auf den Internet-Ablagen bleiben viele Fotos vom Vortag stehen und sie wird unübersichtlich&lt;br /&gt;
&lt;br /&gt;
=== Ursache ===&lt;br /&gt;
&lt;br /&gt;
* der Foto-Server ist abgestürtzt&lt;br /&gt;
** Im .\log nachsehen warum&lt;br /&gt;
** systemctl status cOrgaMonFoto@id&lt;br /&gt;
&lt;br /&gt;
=== Diagnose ===&lt;br /&gt;
&lt;br /&gt;
* Im .\log Verzeichnis des App-Servers fehlt die Datei &amp;lt;code&amp;gt;Ablage-JJJJMMTT.log.txt&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Behebung ===&lt;br /&gt;
&lt;br /&gt;
==== Foto-nnnn.zips erstellen ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; OrgaMon ohne Dienste starten&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Foto, Ihren &amp;quot;id&amp;quot; auswählen, Taste &amp;quot;Init&amp;quot;&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Reiter &amp;quot;Ablegen/Dienste&amp;quot;&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; ins Eingabefeld &amp;quot;Einzelne Ablage&amp;quot; den genauen Verzeichnisnamen der Internet-Ablage eingeben, z.B. &amp;lt;code&amp;gt;sw-stadt&amp;lt;/code&amp;gt;, wenn man nichts eingibt werden alle Internet-Ablagen bearbeitet&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Taste &amp;quot;Zips ablegen / Fotos ablegen&amp;quot;&lt;br /&gt;
&lt;br /&gt;
==== Foto-nnnn.zips herunterladen ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Tagwache&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Taste &amp;quot;Einzeltest vorbereiten&amp;quot;&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Haken bei &amp;quot;Fotos laden rausmachen&amp;quot;&lt;br /&gt;
&amp;lt;br&amp;gt; &amp;amp;rarr; Taste &amp;quot;Start&amp;quot;&lt;br /&gt;
&lt;br /&gt;
[[Datei:Foto-Pflege-3.png]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Orgamon.net&amp;diff=33429</id>
		<title>Orgamon.net</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Orgamon.net&amp;diff=33429"/>
		<updated>2026-08-27T09:35:18Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Aktuelles */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Überblick ==&lt;br /&gt;
&lt;br /&gt;
*Die OrgaMon-App kontaktiert zum &amp;quot;senden&amp;quot; und &amp;quot;Start&amp;quot; jeweils den Domain &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net&amp;lt;/code&amp;gt; über https://- und FTPS://- Protokoll&lt;br /&gt;
**Es gibt ein Hauptzertifikat (für &amp;lt;code&amp;gt;cargobay.orgamon.net&amp;lt;/code&amp;gt;) sowie ihre Kopie davon, das Firmenzertifikat (für &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net&amp;lt;/code&amp;gt;)  &lt;br /&gt;
* Die Firmendomain wird mit einer festen IP-V4-Adresse verbunden, die IP-Adresse haben Sie bei der Beantragung des Subdomains &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; angegeben&lt;br /&gt;
**Auf dem Server mit dieser IP-Adresse muss das Firmenzertifikat installiert werden&lt;br /&gt;
* Für die Absicherung des Datenverkehrs muss auf Ihrem Server das *.orgamon.net Haupt-Zertifikat (als Kopie) installiert werden&lt;br /&gt;
* Dieses liegt auf dem bei Strato gemietetem Webserver &amp;quot;cargobay.orgamon.net&amp;quot; - auf dem auch dieses Wiki gehostet ist - für Sie zum Abruf bereit&lt;br /&gt;
** Das Zertifikat wird aus 3 Dateien gebildet:&lt;br /&gt;
** &amp;lt;code&amp;gt;cert.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;code&amp;gt;fullchain.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;code&amp;gt;privkey.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
* Dieses ist immer für 3 Monate gültig und muss vor Ablauf aufgefrischt werden&lt;br /&gt;
* Das jeweils aktuelle Zertifikat ist auf dem Server &amp;quot;orgamon.net&amp;quot; gespeichert und kann von dort abgerufen werden&lt;br /&gt;
* Hier ist die Beschreibung wie Sie dieses Zertifikat herunterladen und auf Ihrem Server aktualisieren können:&lt;br /&gt;
**Zusammengefasst ist die &amp;quot;Installation&amp;quot; eine 1:1 Kopie des Hauptzertifikates auf Ihr System&lt;br /&gt;
&lt;br /&gt;
== Wann läuft das aktuelle Haupt-Zertifikat ab ? ==&lt;br /&gt;
* Anzeigen des ganzen Zertifikates im Browser&lt;br /&gt;
&lt;br /&gt;
 https://cargobay.orgamon.net/&lt;br /&gt;
&lt;br /&gt;
* Firefox: links neben der URL auf das Schlosssymbol klicken&lt;br /&gt;
** Verbindung sicher&lt;br /&gt;
** weitere Informationen&lt;br /&gt;
** Zertifikat anzeigen&lt;br /&gt;
&lt;br /&gt;
* Chrome: links neben der URL auf das Schieberegler-Symbol klicken&lt;br /&gt;
** Verbindung ist sicher&lt;br /&gt;
** Zertifikat ist gültig&lt;br /&gt;
&lt;br /&gt;
* Das Zertifikat auf &amp;quot;orgamon.net&amp;quot; wird in der Regel frühestens 20 Tage vor dem Ablauf aber spätestens 10 Tage vor dem Ablauf erneuert&lt;br /&gt;
&lt;br /&gt;
== Update ==&lt;br /&gt;
&lt;br /&gt;
* Loggen Sie sich mit Putty in Ihren OrgaMon-App-Server ein: &amp;amp;rarr;&amp;lt;code&amp;gt;Ticket&amp;lt;/code&amp;gt;&amp;amp;rarr;Reiter &amp;lt;code&amp;gt;Rechner&amp;lt;/code&amp;gt;&amp;amp;rarr;Klicken Sie auf Ihren OrgaMon-App-Linux-Server in der Liste&amp;amp;rarr;Symbol &amp;lt;i&amp;gt;schwarzer Schirm mit rot und grün&amp;lt;/i&amp;gt; (ssh root login via putty)&lt;br /&gt;
* Wechseln Sie auf ihrem OrgaMon-App-Server in das Verzeichnis /etc/nginx/orgamon.net&lt;br /&gt;
&lt;br /&gt;
 cd /etc/nginx/orgamon.net&lt;br /&gt;
&lt;br /&gt;
* Starten Sie das dortige Update Script&lt;br /&gt;
&lt;br /&gt;
 ./update.sh&lt;br /&gt;
&lt;br /&gt;
* Geben Sie nun 3 mal ein angefordertes Passwort ein, das Sie bei der Beantragung des Domains &amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net als &amp;quot;Zertifikat-Refresh-Passwort&amp;quot; erhalten haben (Es ist nicht Ihr &amp;quot;Firmenpasswort&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== Neustart von Diensten ===&lt;br /&gt;
&lt;br /&gt;
* Starten Sie nginx neu&lt;br /&gt;
&lt;br /&gt;
 systemctl restart nginx&lt;br /&gt;
&lt;br /&gt;
* Starten Sie vsftpd neu&lt;br /&gt;
&lt;br /&gt;
 systemctl restart vsftpd&lt;br /&gt;
&lt;br /&gt;
=== Prüfen ===&lt;br /&gt;
&lt;br /&gt;
* Anzeigen des Verfallsdatums des erhaltenen Zertifikates in der Kommandozeile&lt;br /&gt;
&lt;br /&gt;
 openssl x509 -enddate -noout -in cert.pem&lt;br /&gt;
&lt;br /&gt;
=== Ende ===&lt;br /&gt;
&lt;br /&gt;
 exit&lt;br /&gt;
&lt;br /&gt;
== Problemlösungen ==&lt;br /&gt;
&lt;br /&gt;
=== Vergessen das Firmenzertifikat zu aktualisieren ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Fehlermeldung Orgamob Zertifikatswechsel.jpg]]&lt;br /&gt;
&lt;br /&gt;
*Fehlermeldung nach dem Senden, wenn der Zertifikatswechsel nicht durchgeführt wurde: Handshake Exception &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Aktuelles == &lt;br /&gt;
&lt;br /&gt;
* durchgeführte Erneuerungen des Hauptzertifikates auf orgamon.net werden hier durch den Admin protokolliert. &lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|1=ändern Sie bitte hier nichts, das hat nichts mit Ihrer Zertifikatskopie zu tun, dafür sind Sie selbst verantwortlich}}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;27.08.2026: Nächster Ablauf des Zertifikates: 25.11.2026&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;02.06.2026: Nächster Ablauf des Zertifikates: 31.08.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;09.03.2026: Nächster Ablauf des Zertifikates: 07.06.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;19.12.2025: Nächster Ablauf des Zertifikates: 18.03.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;08.10.2025: Nächster Ablauf des Zertifikates: 06.01.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;10.07.2025: Nächster Ablauf des Zertifikates: 08.10.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;17.04.2025: Nächster Ablauf des Zertifikates: 16.07.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.02.2025: Nächster Ablauf des Zertifikates: 04.05.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;12.11.2024: Nächster Ablauf des Zertifikates: 10.02.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;26.08.2024: Nächster Ablauf des Zertifikates: 24.11.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;02.06.2024: Nächster Ablauf des Zertifikates: 02.09.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;08.03.2024: Nächster Ablauf des Zertifikates: 06.06.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;21.12.2023: Nächster Ablauf des Zertifikates: 20.03.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;29.09.2023: Nächster Ablauf des Zertifikates: 28.12.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;19.07.2023: Nächster Ablauf des Zertifikates: 17.10.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;15.06.2023: Nächster Ablauf des Zertifikates: 13.09.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.04.2023: Nächster Ablauf des Zertifikates: 01.07.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;21.01.2023: Nächster Ablauf des Zertifikates: 21.04.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;24.10.2022: Nächster Ablauf des Zertifikates: 22.01.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.08.2022: Nächster Ablauf des Zertifikates: 01.11.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;23.05.2022: Nächster Ablauf des Zertifikates: 21.08.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;01.03.2022: Nächster Ablauf des Zertifikates: 30.05.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33428</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33428"/>
		<updated>2026-08-25T19:23:10Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden (hostapd für 802.11r?!)&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
* https://github.com/morrownr/USB-WiFi/blob/main/home/AP_Mode/Bridged_Wireless_Access_Point.md&lt;br /&gt;
* Scheinbar wird MediaTek MT7921AUN (Wi-Fi 6 / AX1800) empfohlen&lt;br /&gt;
* https://www.wlan-profi-shop.de/Alfa-Network-AWUS036AXM-Tri-Band-WiFi-6-AC1200-WLAN-Bluetooth-52-Adapter-80211ax-3000MBit&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 # /etc/udev/rules.d/50-aic8800.rules&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, ATTR{idVendor}==&amp;quot;a69c&amp;quot;, ATTR{idProduct}==&amp;quot;5725&amp;quot;, RUN+=&amp;quot;/usr/sbin/usb_modeswitch -KQ -v a69c -p 5725&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33427</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33427"/>
		<updated>2026-08-25T19:20:36Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden (hostapd für 802.11r?!)&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
* https://github.com/morrownr/USB-WiFi/blob/main/home/AP_Mode/Bridged_Wireless_Access_Point.md&lt;br /&gt;
&lt;br /&gt;
* Scheinbar wird MediaTek MT7921AUN (Wi-Fi 6 / AX1800) empfohlen&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 # /etc/udev/rules.d/50-aic8800.rules&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, ATTR{idVendor}==&amp;quot;a69c&amp;quot;, ATTR{idProduct}==&amp;quot;5725&amp;quot;, RUN+=&amp;quot;/usr/sbin/usb_modeswitch -KQ -v a69c -p 5725&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33426</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33426"/>
		<updated>2026-08-25T18:43:17Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden (hostapd für 802.11r?!)&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
* https://github.com/morrownr/USB-WiFi/blob/main/home/AP_Mode/Bridged_Wireless_Access_Point.md&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 # /etc/udev/rules.d/50-aic8800.rules&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, ATTR{idVendor}==&amp;quot;a69c&amp;quot;, ATTR{idProduct}==&amp;quot;5725&amp;quot;, RUN+=&amp;quot;/usr/sbin/usb_modeswitch -KQ -v a69c -p 5725&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33425</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33425"/>
		<updated>2026-08-25T18:11:09Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden (hostapd für 802.11r?!)&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 # /etc/udev/rules.d/50-aic8800.rules&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, ATTR{idVendor}==&amp;quot;a69c&amp;quot;, ATTR{idProduct}==&amp;quot;5725&amp;quot;, RUN+=&amp;quot;/usr/sbin/usb_modeswitch -KQ -v a69c -p 5725&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33424</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33424"/>
		<updated>2026-08-25T18:06:54Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden (hostapd?!)&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 # /etc/udev/rules.d/50-aic8800.rules&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, ATTR{idVendor}==&amp;quot;a69c&amp;quot;, ATTR{idProduct}==&amp;quot;5725&amp;quot;, RUN+=&amp;quot;/usr/sbin/usb_modeswitch -KQ -v a69c -p 5725&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33423</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33423"/>
		<updated>2026-08-25T17:06:28Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Wifi 6 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 # /etc/udev/rules.d/50-aic8800.rules&lt;br /&gt;
 ACTION==&amp;quot;add&amp;quot;, ATTR{idVendor}==&amp;quot;a69c&amp;quot;, ATTR{idProduct}==&amp;quot;5725&amp;quot;, RUN+=&amp;quot;/usr/sbin/usb_modeswitch -KQ -v a69c -p 5725&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33422</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33422"/>
		<updated>2026-08-25T16:46:52Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;br /&gt;
&lt;br /&gt;
=== Wifi 5 ===&lt;br /&gt;
&lt;br /&gt;
=== Wifi 6 === &lt;br /&gt;
&lt;br /&gt;
 usb_modeswitch -KQ -v a69c -p 5725&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33421</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33421"/>
		<updated>2026-08-25T16:38:04Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Roaming, Access-Point */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
* Ich will ein Wifi-Aufspannen in einem großen Bereich mit mehreren Access-Points. &lt;br /&gt;
* Alle Access-Point sind am gleichen LAN angebunden, dieses LAN soll per Wifi versendet werden&lt;br /&gt;
* Dazu soll 802.11(k/v/r) aktiviert werden&lt;br /&gt;
* Dazu muss 802.11s deaktiviert werden, da das Wifi den Clients gehört, es soll nicht das Wifi für Clients UND Infrastruktur Routing aufgeteilt werden&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;br /&gt;
&lt;br /&gt;
* 802.11s&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33420</id>
		<title>Raspberrypi.wifi</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Raspberrypi.wifi&amp;diff=33420"/>
		<updated>2026-08-18T16:43:10Z</updated>

		<summary type="html">&lt;p&gt;Root: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* basierend auf Raspberry Pi OS (Trixie)&lt;br /&gt;
&lt;br /&gt;
== scan == &lt;br /&gt;
&lt;br /&gt;
* Verwendung von einem WLAN&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst nach verfügbaren SSIDs scannen, sonst funktioniert es nicht&lt;br /&gt;
 #&lt;br /&gt;
 iwlist wlan0 scan | grep ESSID&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # nun im Rasi-Config SSID und Wifi-Passwort eingeben&lt;br /&gt;
 #&lt;br /&gt;
 raspi-config -&amp;gt; System Options -&amp;gt; Wifi&lt;br /&gt;
 raspi-config -&amp;gt; Localisation Options -&amp;gt; WLAN Country&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
== wlan0, wlan1, ... ==&lt;br /&gt;
&lt;br /&gt;
* Ich habe einen Raspberry Pi 4 mit 2 kleinen WLAN USB Adaptern&lt;br /&gt;
&lt;br /&gt;
 wlan0: (intern) Broadcom BCM43438&lt;br /&gt;
 wlan1: Bus 001 Device 004: ID 0bda:8178 Realtek Semiconductor Corp. &amp;lt;s&amp;gt;RTL8192CU&amp;lt;/s&amp;gt; 802.11n WLAN Adapter&lt;br /&gt;
 wlan2: Bus 001 Device 003: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter&lt;br /&gt;
&lt;br /&gt;
 nmtui&lt;br /&gt;
  &lt;br /&gt;
 #&lt;br /&gt;
 # ev. alle alten Networks löschen&lt;br /&gt;
 # dann für jedes interface &amp;quot;wlan0, wlan1, &amp;quot; eine einzelne &amp;quot;Wi Fi&amp;quot;  Verbindung anlegen&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
* Verbindungen anzeigen&lt;br /&gt;
&lt;br /&gt;
 nmcli --fields all connection show&lt;br /&gt;
&lt;br /&gt;
* Verbindung starten&lt;br /&gt;
&lt;br /&gt;
 nmcli connection up 'WiFi FRITZ!Box 8755'&lt;br /&gt;
&lt;br /&gt;
== Roaming, Access-Point ==&lt;br /&gt;
&lt;br /&gt;
USB Chips, die 802.11r/ können (reine 2,4 GHz-Chips werden nicht empfohlen)&lt;br /&gt;
&lt;br /&gt;
 RTL8851BU, RTL8812BU, RTL8814AU&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Protokolle&amp;diff=33418</id>
		<title>Protokolle</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Protokolle&amp;diff=33418"/>
		<updated>2026-07-10T15:53:35Z</updated>

		<summary type="html">&lt;p&gt;Root: /* %set BARCODE_TYPE Technologie */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;b&amp;gt;Überblick&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
die OrgaMon-App sammelt mobile Daten. Protokolle sind frei gestaltbare Eingabeformulare, die unterwegs ausgefüllt werden können. Pro Auftrag wird nur ein Protokoll ausgefüllt.&lt;br /&gt;
&lt;br /&gt;
* Protokolle sind .txt Dateien mit UTF8-BOM Kodierung&lt;br /&gt;
* Protokolle sind Baustellen speziefisch&lt;br /&gt;
* Protokolle sind Zählerart speziefisch&lt;br /&gt;
** Beispiel: Baustelle ST3A, hier gibt es die Auftragsarten &amp;quot;W&amp;quot; und &amp;quot;G&amp;quot; und &amp;quot;E2&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3AW.txt&amp;lt;/code&amp;gt; wird dann verwendet für die Auftragsart &amp;quot;W&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3AG.txt&amp;lt;/code&amp;gt; ... &amp;quot;G&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3AE2.txt&amp;lt;/code&amp;gt; ... &amp;quot;E2&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3A.txt&amp;lt;/code&amp;gt; für alle anderen&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Protokoll Gestaltung ==&lt;br /&gt;
&lt;br /&gt;
Protokolle sind Textdateien, in die vor Ort zusätzliche Daten (neben den Standard-OrgaMon-&lt;br /&gt;
Daten) eingegeben werden können.&amp;lt;br&amp;gt;&lt;br /&gt;
Protokolle sind frei definierbar. Fest stehender Text, sowie Eingabepositionen&lt;br /&gt;
können definiert werden.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Protokolle, die für JonDa-Geräte geschrieben wurden können nun auch im OrgaMon&lt;br /&gt;
aufgerufen und bearbeitet werden. Ist ein Auftrag offen, so kann man das passende&lt;br /&gt;
Protokoll mit &amp;lt;Strg&amp;gt; und &amp;lt;1&amp;gt;, &amp;lt;2&amp;gt; usw. aufrufen. Der Name des Protokolles wird aus&lt;br /&gt;
&amp;quot;Baustellenkrzel&amp;quot;-&amp;quot;ZählerArt&amp;quot;-&amp;quot;NummerDerProtokollAlternative&amp;quot;.txt zusammengesetzt.&lt;br /&gt;
Protokolle werden im Verzeichnis .\Protokolle erwartet.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Muss man Änderungen an einem Protokoll machen, so ruft man das Protokoll mit&lt;br /&gt;
&amp;lt;Shift&amp;gt;&amp;amp;&amp;lt;Strg&amp;gt; und &amp;lt;1&amp;gt;, &amp;lt;2&amp;gt; usw. auf.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Der Variablen-Name ist immer 2 Buchstaben lang. Handelt es sich dabei um eine Zahl &lt;br /&gt;
01 .. 99, so ist es keine &amp;quot;echte&amp;quot; Eingabe-Position sondern ein Datenfeld, das aus OrgaMon &lt;br /&gt;
rauskopiert wird. Macht man Eingaben in diese festen OrgaMon-Felder hat dies&lt;br /&gt;
keine Auswirkung.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Gibt es pro Baustelle mehrere Protokolle sollten eindeutige Variblennamen ver&lt;br /&gt;
wendet werden. z.B.&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 Protokoll 1 -&amp;gt; AA bis AZ, BA bis BZ&lt;br /&gt;
 Protokoll 2 -&amp;gt; CA bis CZ, DA bis DZ&lt;br /&gt;
 Protokoll 3 -&amp;gt; EA bis EZ, FA bis FZ&lt;br /&gt;
 Protokoll 4 -&amp;gt; GA bis GZ, HA bis HZ&lt;br /&gt;
 Protokoll 5 -&amp;gt; IA bis IZ, JA bis JZ&lt;br /&gt;
&lt;br /&gt;
Datenausgabe: OrgaMon erzeugt Ausgabedaten im bekannten .csv Format. In der Regel&lt;br /&gt;
jedoch ohne Protokolldaten. In der Baustelle kann man jedoch die Ausgabe der&lt;br /&gt;
csv-Dateien incl. der Protokoll-Eingaben ermöglichen.&lt;br /&gt;
Dazu &amp;quot;Baustelle&amp;quot;, Reiter &amp;quot;Protokolle&amp;quot; das Häkchen &amp;quot;Ausfühen Protokollausgabe&amp;quot;&lt;br /&gt;
aktivieren.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Übergeben Sie ev. Protokolle aus dem Verzeichnis &amp;quot;./Protokolle&amp;quot; dem&lt;br /&gt;
Auftraggeber, damit ihm klar wird, was sich z.B. hinter der Spalte &amp;quot;V1&amp;quot; verbirgt.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Im Auftragsarbeitsplatz: Werden Protokolldaten mit ausgegeben erscheint der Ausgabewartenbalken als&lt;br /&gt;
voller Balken, ansonsten ist dieser Balken unterbrochen (da nur ein Teil der Daten&lt;br /&gt;
ausgegeben wird).&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Ist schon eine Feldreihenfolge mit dem Auftraggeber vereinbart sollten neue Felder&lt;br /&gt;
nur hinten (also im Excel &amp;quot;rechts&amp;quot;) angefügt werden.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Ist noch keine Feldreihenfolge mit dem Auftraggeber vereinbart empfiehlt es sich&lt;br /&gt;
die Spaltennamen ev. inhaltlich oder vom Namen her zu sortieren, damit die Daten&lt;br /&gt;
de zusammengehören auch zusammen sind.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Dateiname eines Protokolles ===&lt;br /&gt;
&lt;br /&gt;
* bei der Aufbereitung des Auftragsvolumens wird für jeden einzelnen Auftrag ermittelt welches Protokoll mitgegeben wird.&lt;br /&gt;
* Hier ist man also sehr flexibel und man kann so steuern &amp;quot;was&amp;quot; der Monteur vor Ort alles machen kann und soll. Und das abhängig von der Baustelle und der Auftragsart.&lt;br /&gt;
* das zu jedem einzelnen Auftrag mitgesendete Protokoll ist nicht Geräte-abhängig sondern Baustellen- und Zähler-Art abhängig: Also bei Baustelle &amp;quot;X3&amp;quot; kann es z.B. die Art &amp;quot;W&amp;quot; und &amp;quot;E2&amp;quot; und andere Zählerarten geben. Dann kann man 3 ganz verschiendene Protokolle hinterlegen:&lt;br /&gt;
&lt;br /&gt;
 X3&lt;br /&gt;
 X3W&lt;br /&gt;
 X3E2&lt;br /&gt;
&lt;br /&gt;
* im OrgaMon finden sich die Dateien im Verzeichnis .\Protokolle. Sie werden folgendermassen benannt:&lt;br /&gt;
 &lt;br /&gt;
  &amp;lt;Kürzel der Baustelle&amp;gt;&amp;lt;Zählerart&amp;gt;&amp;lt;Protokollvariante&amp;gt;.txt&lt;br /&gt;
 &lt;br /&gt;
  Bei &amp;lt;Protokollvariante&amp;gt; = &amp;quot;1&amp;quot; wird die Ziffer &amp;quot;1&amp;quot; NICHT angegeben! Beispiel:&lt;br /&gt;
  Baustelle KARL: es gibt &amp;quot;G&amp;quot; und &amp;quot;W&amp;quot; Zählertypen: die möglichen Protokolle sind&lt;br /&gt;
  somit:&lt;br /&gt;
  &lt;br /&gt;
  OrgaMon/JonDa&lt;br /&gt;
  ===========&lt;br /&gt;
  &lt;br /&gt;
  KARLG.TXT, KARLW.TXT&lt;br /&gt;
  &lt;br /&gt;
  OrgaMon&lt;br /&gt;
  &lt;br /&gt;
  KARLG2.TXT, KARLW2.TXT&lt;br /&gt;
  KARLG3.TXT, KARLW3.TXT&lt;br /&gt;
  KARLG4.TXT, KARLW4.TXT&lt;br /&gt;
  KARLG5.TXT, KARLW5.TXT&lt;br /&gt;
&lt;br /&gt;
=== Konstante ===&lt;br /&gt;
&lt;br /&gt;
* 1=, RID &lt;br /&gt;
* 2=, TERMIN &lt;br /&gt;
* 3=, ABNUMMER&lt;br /&gt;
* 4=, ART &lt;br /&gt;
* 5=, ZAEHLER_# ALT&lt;br /&gt;
* 6=, REGLER_# ALT&lt;br /&gt;
* 7=, ZAEHLER_INFO&lt;br /&gt;
* 8=, MONTEUR_INFO&lt;br /&gt;
* 9=, ORT&lt;br /&gt;
* 10=, PROTOKOLL_NAME&lt;br /&gt;
&lt;br /&gt;
=== vorbestimmete Variable ===&lt;br /&gt;
&lt;br /&gt;
Variable speichern Protokoll-Eingaben. Dabei gibt es folgende fest eingebauten Speicherplätze:&lt;br /&gt;
&lt;br /&gt;
* 11=, Zählernummer Korrektur&lt;br /&gt;
* 12=, Zählernummer Neu &lt;br /&gt;
* 13=, Zählerstand Neu&lt;br /&gt;
* 14=, Zählerstand Alt&lt;br /&gt;
* 15=, Reglernummer Korrektur&lt;br /&gt;
* 16=, Reglernummer Neu&lt;br /&gt;
&lt;br /&gt;
=== freie Variable (Protokollwerte) ===&lt;br /&gt;
&lt;br /&gt;
* werden in Grossbuchstaben angegeben und haben immer 2 Stellen&lt;br /&gt;
* die 2. Stelle kann eine Ziffer sein&lt;br /&gt;
* Freie Variable sind die Wertbezeichnungen für Eingaben in das Protokoll, also Speicherbezeichnungen für Protokollwerte&lt;br /&gt;
* Die kommende Verwendung einer Variable gibt man durch ein abschliessendes &amp;quot;=&amp;quot; Zeichen an&lt;br /&gt;
* Der Name einer Variable wird einem eingegebenen Wert vorangestellt&lt;br /&gt;
* Im Datenfeld PROTOKOLLE des Auftrages können Eingaben abgerufen werden&lt;br /&gt;
&lt;br /&gt;
 S1=X&lt;br /&gt;
 OR=Keller&lt;br /&gt;
&lt;br /&gt;
* In der Ergebnismeldung können Spaltennamen den Variablennamen entsprechen&lt;br /&gt;
&lt;br /&gt;
=== Konventionenn ===&lt;br /&gt;
&lt;br /&gt;
==== A1 ====&lt;br /&gt;
&lt;br /&gt;
Alphanumerischer Prefix für eine Zählernummer Neu&lt;br /&gt;
&lt;br /&gt;
==== N1 ====&lt;br /&gt;
&lt;br /&gt;
Zählernummer Neu (Alternativ-Feld)&lt;br /&gt;
&lt;br /&gt;
==== V1,V2,V3,V4 ====&lt;br /&gt;
&lt;br /&gt;
Vergebliche Besuche &lt;br /&gt;
&lt;br /&gt;
==== Zählwerke ====&lt;br /&gt;
&lt;br /&gt;
===== Ausbau =====&lt;br /&gt;
&lt;br /&gt;
 Ausbau Verbrauch 1.8.0&lt;br /&gt;
 ZAEHLER_STAND_ALT (echtes Datenbankfeld, intern 14=)&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Verbrauch 1.8.1&lt;br /&gt;
 A181=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Verbrauch Nebentarif 1.8.2&lt;br /&gt;
 NA=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Einspeisung 2.8.0&lt;br /&gt;
 A280=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Einspeisung  2.8.1&lt;br /&gt;
 A281=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau  Einspeisung 2.8.2&lt;br /&gt;
 A282=&lt;br /&gt;
&lt;br /&gt;
===== Einbau =====&lt;br /&gt;
 &lt;br /&gt;
 Einbau Verbrauch 1.8.0&lt;br /&gt;
 ZAEHLER_STAND_NEU (echtes Datenbankfeld, intern 13=)&lt;br /&gt;
 &lt;br /&gt;
 Einbau Verbrauch 1.8.1&lt;br /&gt;
 E181=&lt;br /&gt;
 &lt;br /&gt;
 Einbau Verbrauch Nebentarif 1.8.2&lt;br /&gt;
 NN=&lt;br /&gt;
 &lt;br /&gt;
 Einbau  Einspeisung 2.8.0&lt;br /&gt;
 E280=&lt;br /&gt;
 &lt;br /&gt;
 Einbau  Einspeisung 2.8.1&lt;br /&gt;
 E281=&lt;br /&gt;
 &lt;br /&gt;
 Einbau  Einspeisung Nebentarif 2.8.2&lt;br /&gt;
 E282=&lt;br /&gt;
&lt;br /&gt;
==== Fotos ====&lt;br /&gt;
&lt;br /&gt;
 Foto Ausbau &lt;br /&gt;
 FA&lt;br /&gt;
 &lt;br /&gt;
 Foto Einbau &lt;br /&gt;
 FN&lt;br /&gt;
 &lt;br /&gt;
 Foto Regler&lt;br /&gt;
 FE&lt;br /&gt;
 &lt;br /&gt;
 Foto Anlage&lt;br /&gt;
 FH&lt;br /&gt;
 &lt;br /&gt;
 Ausbau 1.8.0&lt;br /&gt;
 FA &lt;br /&gt;
 Ausbau 1.8.1 &lt;br /&gt;
 FB &lt;br /&gt;
 Ausbau 1.8.2&lt;br /&gt;
 FC &lt;br /&gt;
 Ausbau 2.8.0&lt;br /&gt;
 FD &lt;br /&gt;
 Ausbau 2.8.1&lt;br /&gt;
 FF &lt;br /&gt;
 Ausbau 2.8.2&lt;br /&gt;
 FG &lt;br /&gt;
 &lt;br /&gt;
 Einbau 1.8.0&lt;br /&gt;
 FN&lt;br /&gt;
 Einbau 1.8.1&lt;br /&gt;
 FM&lt;br /&gt;
 Einbau 1.8.2&lt;br /&gt;
 FO&lt;br /&gt;
 Einbau 2.8.0&lt;br /&gt;
 FP&lt;br /&gt;
 Einbau 2.8.1&lt;br /&gt;
 FQ&lt;br /&gt;
 Einbau 2.8.2&lt;br /&gt;
 FR&lt;br /&gt;
&lt;br /&gt;
===== FU =====&lt;br /&gt;
&lt;br /&gt;
* kein Foto, sondern es wird ein Dialog gezeigt auf dem kann man unterschreiben&lt;br /&gt;
* die Unterschrift wird als -FU.jpg abgespeichert und als normales Foto übertragen&lt;br /&gt;
&lt;br /&gt;
==== ZZ ====&lt;br /&gt;
&lt;br /&gt;
* Ja/Nein Feld&lt;br /&gt;
* Alles fertig, Eingabe des Ausbaustandes wird so unnötig&lt;br /&gt;
&lt;br /&gt;
=== Verwendung eines Variablen-Wertes innerhalb des Protokolles ===&lt;br /&gt;
&lt;br /&gt;
Werte von aktuellen Variablen können mit Schlangenlinien ausbelichtet werden:&lt;br /&gt;
&lt;br /&gt;
 ~NN~&lt;br /&gt;
&lt;br /&gt;
Ist der Wert bereits bestimmt wird anstelle von ~NN~ der eingegebene Wert angezeigt&lt;br /&gt;
&lt;br /&gt;
=== Unterformulare ===&lt;br /&gt;
&lt;br /&gt;
Formulare lassen sich verschachteln. So kann man Inhaltlich zusammenpassende Bereiche eines Protokolles auf eine eigene Unterseite bringen&lt;br /&gt;
&lt;br /&gt;
* (, Unterbereich beginnen&lt;br /&gt;
* ), Unterbereich Ende&lt;br /&gt;
&lt;br /&gt;
=== Trenner ===&lt;br /&gt;
&lt;br /&gt;
* --&lt;br /&gt;
&lt;br /&gt;
=== Eingabetypen ===&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;N;&amp;quot; rein numerische Eingabe (0 .. 9)&lt;br /&gt;
* &amp;quot;D;&amp;quot; dezimal  (0 .. 9 und Punkt oder Komma)&lt;br /&gt;
* &amp;quot;A;&amp;quot; alphanumerisch (Buchstaben und Ziffern)&lt;br /&gt;
* &amp;quot;T;&amp;quot; Zeit/Datum&lt;br /&gt;
&lt;br /&gt;
=== Ankreuzfelder ===&lt;br /&gt;
&lt;br /&gt;
==== Haken ====&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;H;&amp;quot; &amp;lt;SichtbarerText&amp;gt; [&amp;quot;;&amp;quot; &amp;lt;WertWennAngekreuzt&amp;gt; [&amp;quot;;&amp;quot; &amp;lt;WertWennAngekreuztEntferntwird&amp;gt;]]&lt;br /&gt;
&lt;br /&gt;
 # mit dem Default: &amp;quot;H;&amp;quot; &amp;lt;SichtbarerText&amp;gt; &amp;quot;;J;N&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 # Wird das angekreuzt wird der &amp;quot;J&amp;quot;-Wert bzw. &amp;lt;WertWennAngekreuzt&amp;gt; übermittelt&lt;br /&gt;
 # Im Fall dass ein Haken rausgemacht wird, wird der &amp;quot;N&amp;quot;-Wert bzw. &amp;lt;WertWennAngekreuztEntferntwird&amp;gt; übermittelt&lt;br /&gt;
 # Bei unberührten Ankreuzfeldern wird &amp;quot;&amp;quot; (&amp;lt;leer&amp;gt;) übermittelt&lt;br /&gt;
&lt;br /&gt;
==== Bobbele ====&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;B;&amp;quot; &amp;lt;SichtbarerText&amp;gt; [ &amp;quot;;&amp;quot; &amp;lt;JA-Wert&amp;gt; ]&lt;br /&gt;
&lt;br /&gt;
 # B sind eine Gruppe von Radiobuttons, als es ist immer nur EIN&lt;br /&gt;
 # Knopf gedrückt angekreuzt, wählt man eine andere Option &lt;br /&gt;
 # springt der Haken in einer ehemals gewählten Option raus&lt;br /&gt;
 #&lt;br /&gt;
 # Übermittelt wird der &amp;lt;JA-Wert&amp;gt; der jeweils gesetzten Option&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
 Bobbele eignen sich, wenn man nur eine Auswahl im Protokoll treffen soll und dieses auch als Pflichtfeld &amp;quot;!&amp;quot; versehen möchte&lt;br /&gt;
&lt;br /&gt;
=== (Barcode-) Scan ===&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;S;&amp;quot; &amp;lt;Beschriftung&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Infos zur Parametrisierung finden Sie hier [[#.25set_BARCODE_TYPE_Technologie]]&lt;br /&gt;
&lt;br /&gt;
=== Foto ===&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;F;&amp;quot; &amp;lt;Beschriftung&amp;gt;&lt;br /&gt;
** einzelnes Foto für einen vorbestimmten Dokumentationsschritt z.B. &amp;quot;Zählerstand Ausbau&amp;quot;&lt;br /&gt;
** keines oder mehrere Fotos (Story-Modus), wobei alle Fotos gleichberechtigt übertragen werden und ihre Gültigkeit haben z.B. &amp;quot;Vergeblicher Besuch&amp;quot; dieser Modus muss durch ein ~#~ bei der &amp;lt;code&amp;gt;F?-Benennung=&amp;lt;/code&amp;gt; aktiviert werden&lt;br /&gt;
&lt;br /&gt;
=== Pflichteingabe ===&lt;br /&gt;
&lt;br /&gt;
* Um die Eingabedaten zu plausibilisieren kann am Ende des Protokolles eine Prüf-Vorschrift mitgegeben werden&lt;br /&gt;
* beim &amp;quot;SPEICHERN&amp;quot; wird die Prüf-Vorschrift angewendet&lt;br /&gt;
* Folgende &amp;quot;Eingabefehler&amp;quot; des Monteurs können durch die Prüf-Vorschrift aufgedeckt werden&lt;br /&gt;
** Vergessen ein Feld auszufüllen (als ein sogenanntes Pflichtfeld/Mussfeld/Sollfeld)&lt;br /&gt;
** Vergessen eine Option zu wählen&lt;br /&gt;
** Einen Wert eingegeben, obwohl dies in diesem Falle nicht mehr notwendig ist&lt;br /&gt;
** Einen Wert eingegeben der zu gross oder zu klein ist&lt;br /&gt;
&lt;br /&gt;
==== Syntax der Prüf-Vorschrift ====&lt;br /&gt;
&lt;br /&gt;
* man schreibt als letzten Punkt des Protokolles eine neue Rubrik &amp;lt;code&amp;gt;(Prüfen )&amp;lt;/code&amp;gt; als reinen Text ohne Eingabefelder&lt;br /&gt;
* bei einer Prüfung wird Zeile für Zeile von oben nach unten abgearbeitet (Prüflogik)&lt;br /&gt;
* bei einem Fehler springt der Eingabe-Fokus auf die erste Eingabeposition, die in der Fehlerzeile angegeben ist&lt;br /&gt;
* Der Aufbau einer Zeile ist&lt;br /&gt;
** &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Bedingung [ Resultat [ Aktion ]]&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* Vor der &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Bedingung&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; kann man einige Leerschritte machen um eine Blockzugehörigkeit zu setzen&lt;br /&gt;
* Erfüllte Bedigungen bekommen einen Punkt, man kann z.B. 5 Bedingungen in eine Zeile schreiben, nach der Prüfung aller Bedingungen ergibt sich ein Resultat von 0,1,2,3,4 oder 5 (wenn alle Bedingungen erfüllt sind!)&lt;br /&gt;
* wird &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Resultat&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; weggelassen, so wird der kommende Block nur ausgeführt wenn die Bedingung erfüllt ist&lt;br /&gt;
* wird &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Aktion&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; weggelassen, so wird auf eine Unstimmigkeit aufmerksam gemacht&lt;br /&gt;
* &amp;lt;u&amp;gt;default&amp;lt;/u&amp;gt; Werte sind unterstrichen, diese können einfach weggelassen werden&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 &amp;lt;i&amp;gt;Zeile&amp;lt;/i&amp;gt; = { ' ' } { &amp;lt;i&amp;gt;Bedingung&amp;lt;/i&amp;gt; ' ' } [ &amp;lt;i&amp;gt;Resultat&amp;lt;/i&amp;gt; [ &amp;lt;i&amp;gt;Aktion&amp;lt;/i&amp;gt; ]]&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 &amp;lt;i&amp;gt;Bedingung&amp;lt;/i&amp;gt; = &amp;lt;b&amp;gt;Protokollfeld&amp;lt;/b&amp;gt; [ '!' | '&amp;lt;u&amp;gt;=&amp;quot;J&amp;quot;&amp;lt;/u&amp;gt;' | ( '=' | '&amp;lt;&amp;gt;' | '&amp;lt;' | '&amp;gt;' | '&amp;gt;=' | '&amp;lt;=' ) &amp;lt;i&amp;gt;Eingabewert&amp;lt;/i&amp;gt; ]&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 Eingabewert = '&amp;quot;' { &amp;lt;b&amp;gt;Zeichen&amp;lt;/b&amp;gt; } '&amp;quot;' &lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 Resultat = '=0' | &amp;lt;u&amp;gt;'=1'&amp;lt;/u&amp;gt; | '&amp;gt;0'&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 Aktion = &amp;lt;b&amp;gt;exit&amp;lt;/b&amp;gt; | &amp;lt;u&amp;gt;&amp;lt;b&amp;gt;fail&amp;lt;/b&amp;gt;&amp;lt;/u&amp;gt; | &amp;lt;b&amp;gt;:&amp;lt;/b&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* werden mehrere Protokollfelder in einer Zeile angegeben so wird eine Summe aller erfüllten Bedingungen gebildet, das ist das Resultat&lt;br /&gt;
* Stimmt das Resultat nicht, ergibt sich ein Eingabefehler&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;b&amp;gt;!&amp;lt;/b&amp;gt; ist einfach eine Kurzform von &amp;lt;b&amp;gt;&amp;lt;&amp;gt;&amp;quot;&amp;quot;&amp;lt;/b&amp;gt;, also es soll etwas drinstehen - egal was&lt;br /&gt;
* &amp;lt;b&amp;gt;=&amp;quot;J&amp;quot;&amp;lt;/b&amp;gt; kann weggelassen werden, also wenn nichts rechts vom Protokollfeld steht wird =&amp;quot;J&amp;quot; angenommen&lt;br /&gt;
** &amp;lt;code&amp;gt;KL=&amp;quot;J&amp;quot; KM=&amp;quot;J&amp;quot; KN=&amp;quot;J&amp;quot;&amp;lt;/code&amp;gt; kann man schreiben&lt;br /&gt;
** &amp;lt;code&amp;gt;KL KM KN&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== Aktion &amp;lt;code&amp;gt;&amp;lt;b&amp;gt;fail&amp;lt;/b&amp;gt;&amp;lt;/code&amp;gt; ====&lt;br /&gt;
&lt;br /&gt;
* Im Fall das das wirkliche Resultat NICHT dem angegebenen Resultat entspricht wird auf das zuerst angegebene Protokollfeld fokusiert&lt;br /&gt;
&lt;br /&gt;
==== Aktion &amp;lt;code&amp;gt;&amp;lt;b&amp;gt;exit&amp;lt;/b&amp;gt;&amp;lt;/code&amp;gt; ====&lt;br /&gt;
&lt;br /&gt;
* Im Fall das das Resultat stimmt wird an dieser Stelle die Prüfung mit Erfolg beendet&lt;br /&gt;
&lt;br /&gt;
==== Beispiele ====&lt;br /&gt;
&lt;br /&gt;
 ZZ exit&lt;br /&gt;
 O1 O2 O3 &amp;gt;0&lt;br /&gt;
 HK NK&lt;br /&gt;
 HK :&lt;br /&gt;
  N1 N2&lt;br /&gt;
  K3 K2&lt;br /&gt;
&lt;br /&gt;
==== Standard ====&lt;br /&gt;
&lt;br /&gt;
* wird keine Prüf-Vorschrift angegeben, so gilt folgendes:&lt;br /&gt;
&lt;br /&gt;
 ZZ exit&lt;br /&gt;
 14!&lt;br /&gt;
&lt;br /&gt;
== Befehlsausführung ==&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;b&amp;gt;&amp;lt;code&amp;gt;$&amp;lt;/code&amp;gt;&amp;lt;/b&amp;gt;, globaler Befehl (Ausführung einmalig)&lt;br /&gt;
* &amp;lt;b&amp;gt;&amp;lt;code&amp;gt;%&amp;lt;/code&amp;gt;&amp;lt;/b&amp;gt;, Befehl für dieses Protokoll (wirksam für aktuelles Protokoll)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Beim Laden aus dem Internet werden die Protokolle gespeichert. &lt;br /&gt;
&lt;br /&gt;
* Dabei werden alle mit &amp;quot;$&amp;quot; aufgeführten Befehle ausgeführt.&lt;br /&gt;
* Lokale BEfehle, die bei jeder Protokollverwendung ausgeführt werden sollen werden mit &amp;quot;%&amp;quot; eingeleitet&lt;br /&gt;
&lt;br /&gt;
=== $mv ===&lt;br /&gt;
&lt;br /&gt;
* Verschieben einer Datei&lt;br /&gt;
&lt;br /&gt;
=== $rm ===&lt;br /&gt;
&lt;br /&gt;
* Löschen einer Datei&lt;br /&gt;
&lt;br /&gt;
=== %set ===&lt;br /&gt;
&lt;br /&gt;
* setzen einer Systemvariable&lt;br /&gt;
&lt;br /&gt;
==== %set BARCODE_TYPE &amp;lt;i&amp;gt;Technologie&amp;lt;/i&amp;gt;====&lt;br /&gt;
&lt;br /&gt;
* Um Barcodes über das Protokoll abscannen zu können muss dies im Protokoll erst aktiviert werden&lt;br /&gt;
* Ganz oben im Protokoll wird eingestellt welche Barcode-Technologie zum Einsatz kommt&lt;br /&gt;
* Folgende Technologien gibt es:&lt;br /&gt;
** 1D Technologien: &amp;lt;code&amp;gt;UPC_A|UPC_E|EAN_13|EAN_8|RSS_14|RSS_EXPANDED|CODE_39|CODE_93|CODE_128|ITF|CODABAR&amp;lt;/code&amp;gt;&lt;br /&gt;
** 2D Technologien: &amp;lt;code&amp;gt;DATA_MATRIX|QR_CODE &amp;lt;/code&amp;gt; &lt;br /&gt;
* Das Scannen wird bewusst auf einzelne Technologien vor Ort beschränkt, damit es nicht zu Fehlinterpretationen kommt:&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 2016-01-29-09-57-05.png|300px]]&lt;br /&gt;
&lt;br /&gt;
* Um die verwendetet Technologie herauszufinden starten Sie auf dem Handy die &amp;quot;zxing Barcode Scanner&amp;quot;-App und Scannen den Code.&lt;br /&gt;
* Merken Sie sich was rechts von &amp;quot;Format&amp;quot; steht (=&amp;lt;i&amp;gt;Technologie&amp;lt;/i&amp;gt;), das tragen Sie bitte in die erste Zeile des Protokolls ein &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE Technologie { &amp;quot;,&amp;quot; Technologie }&lt;br /&gt;
&lt;br /&gt;
* ohne Leerzeichen - Aufzählung mit KOMMA kein SEMIKOLON!&lt;br /&gt;
* Beispiel&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Datei:Format-ITF.jpg|300px]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE ITF,ITF&lt;br /&gt;
&lt;br /&gt;
===== Besondere Werte =====&lt;br /&gt;
&lt;br /&gt;
* Folgende Angaben haben interne feste Programmierungen&lt;br /&gt;
** &amp;lt;code&amp;gt;ITF&amp;lt;/code&amp;gt; : Es wird eine Prüfziffern-Routine nachgeschaltet, &amp;quot;+&amp;quot; bedeutet Erfolg, &amp;quot;-&amp;quot; Fehler in der Prüfziffer. &lt;br /&gt;
** &amp;lt;code&amp;gt;ITF,ITF&amp;lt;/code&amp;gt; : Einfach nur ITF ohne Prüfziffernberechnung&lt;br /&gt;
** &amp;lt;code&amp;gt;CODE_39&amp;lt;/code&amp;gt; : Es wird die Einlagerungsfunktion durchgeführt. &lt;br /&gt;
** &amp;lt;code&amp;gt;CODE_39,CODE_39&amp;lt;/code&amp;gt; Einfach nur CODE_39-Scan ohne jede weitere Sonderfunktion&lt;br /&gt;
&lt;br /&gt;
==== %set AUTO_FOCUS &amp;lt;i&amp;gt;Parameter&amp;lt;/i&amp;gt; ==== &lt;br /&gt;
&lt;br /&gt;
* setzt automatisch den Eingabefokus des Protokolles auf eines der angegebenen Felder&lt;br /&gt;
* Der Fokus wird nur dann gesetzt wenn das Feld bisher keine Eingabe hat&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Beispiel, Gehe auf das Feld S1 danach S2&lt;br /&gt;
 #&lt;br /&gt;
 %set AUTO_FOCUS=S1;S2&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # default&lt;br /&gt;
 #&lt;br /&gt;
 %set AUTO_FOCUS=14&lt;br /&gt;
&lt;br /&gt;
==== %set AUTO_SCAN &amp;lt;i&amp;gt;Parameter&amp;lt;/i&amp;gt; ====&lt;br /&gt;
&lt;br /&gt;
* ist das angegebene Eingabefeld leer wird sofort der Barcode-Scanner gestartet und das Scan-Ergebnis landet in dem Feld&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst S1 dann S2 scannen&lt;br /&gt;
 #&lt;br /&gt;
 %set AUTO_SCAN=S1;S2&lt;br /&gt;
&lt;br /&gt;
== Beispiel 1 ==&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE CODE_128&lt;br /&gt;
 #&lt;br /&gt;
 # KAWS 2016-01-26&lt;br /&gt;
 #&lt;br /&gt;
 (Zählerwechsel&lt;br /&gt;
 Korrektur der Ausbau-Zählernummer&lt;br /&gt;
 11=&lt;br /&gt;
 N;&lt;br /&gt;
 Stand des Ausbau-Zählers&lt;br /&gt;
 14=&lt;br /&gt;
 D;&lt;br /&gt;
 Nummer des Einbau-Zählers&lt;br /&gt;
 12=&lt;br /&gt;
 A;&lt;br /&gt;
 S;Barcode ~12~&lt;br /&gt;
 Stand des Einbau-Zählers&lt;br /&gt;
 13=&lt;br /&gt;
 D;&lt;br /&gt;
 )&lt;br /&gt;
 (Regler&lt;br /&gt;
 Korrektur der Ausbau-Reglernummer&lt;br /&gt;
 15=&lt;br /&gt;
 N;&lt;br /&gt;
 Nummer des Einbau-Reglers&lt;br /&gt;
 16=&lt;br /&gt;
 N;&lt;br /&gt;
 )&lt;br /&gt;
 #&lt;br /&gt;
 --&lt;br /&gt;
 Vergebliche Besuche&lt;br /&gt;
 --&lt;br /&gt;
 V1=&lt;br /&gt;
 A;&lt;br /&gt;
 V2=&lt;br /&gt;
 A;&lt;br /&gt;
 V3=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 Inspektion SCHACHT&lt;br /&gt;
 --&lt;br /&gt;
 V5=&lt;br /&gt;
 H;Kopie an Eigent.&lt;br /&gt;
 AA=&lt;br /&gt;
 H;Turnus&lt;br /&gt;
 AB=&lt;br /&gt;
 H;Abnahme&lt;br /&gt;
 AC=&lt;br /&gt;
 H;Reparaturwechsel&lt;br /&gt;
 AD=&lt;br /&gt;
 H;Neusetzung&lt;br /&gt;
 --&lt;br /&gt;
 Mängelprüfung&lt;br /&gt;
 --&lt;br /&gt;
 BR=&lt;br /&gt;
 H;DIN 1988 OK!&lt;br /&gt;
 SA=&lt;br /&gt;
 H;DVGW-Blatt OK!&lt;br /&gt;
 Entnahmestelle&lt;br /&gt;
 BA=&lt;br /&gt;
 H;vor Zähler.Info:&lt;br /&gt;
 BB=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 P0=&lt;br /&gt;
 H;ALLES WIE EBEN!&lt;br /&gt;
 --&lt;br /&gt;
 Wasserzählerplatz.&lt;br /&gt;
 BC=&lt;br /&gt;
 H;nicht zugänglich&lt;br /&gt;
 BD=&lt;br /&gt;
 H;frostgefährdet&lt;br /&gt;
 Wasserzähleran-&lt;br /&gt;
 schlussbügel&lt;br /&gt;
 BK=&lt;br /&gt;
 H;fehlt!&lt;br /&gt;
 Absperrventil&lt;br /&gt;
 kombiniert mit&lt;br /&gt;
 Rückflussver-&lt;br /&gt;
 hinderer&lt;br /&gt;
 BM=&lt;br /&gt;
 H;fehlt!&lt;br /&gt;
 läßt sich&lt;br /&gt;
 BN=&lt;br /&gt;
 H;nicht schliessen&lt;br /&gt;
 Installations&lt;br /&gt;
 leitungen der&lt;br /&gt;
 Kundenanlage&lt;br /&gt;
 BO=&lt;br /&gt;
 H;stark angerostet&lt;br /&gt;
 unzureichend&lt;br /&gt;
 BP=&lt;br /&gt;
 H;befestigt!&lt;br /&gt;
 BX=&lt;br /&gt;
 H;Sonstige Mängel&lt;br /&gt;
 BQ=&lt;br /&gt;
 A;&lt;br /&gt;
 BS=&lt;br /&gt;
 H;wegen Mängel un-&lt;br /&gt;
 möglich!&lt;br /&gt;
 --&lt;br /&gt;
 Eingebaute Apparate&lt;br /&gt;
 --&lt;br /&gt;
 Schachttiefe bis&lt;br /&gt;
 Rohrachse kleinr&lt;br /&gt;
 SB=&lt;br /&gt;
 H;1,5m:Frostgefahr&lt;br /&gt;
 Bodenfreiheit&lt;br /&gt;
 SC=&lt;br /&gt;
 H;kleiner 40 cm&lt;br /&gt;
 Leiter(ab DN100&lt;br /&gt;
 SD=&lt;br /&gt;
 H;Treppe!) fehlt&lt;br /&gt;
 Undicht gegen&lt;br /&gt;
 SE=&lt;br /&gt;
 H;Grund-/Tagwasser&lt;br /&gt;
 Mauerdurchführng&lt;br /&gt;
 ohne Dichtung&lt;br /&gt;
 SF=&lt;br /&gt;
 H;Gummi/Quellm÷rtl&lt;br /&gt;
 Pumpensumpf&lt;br /&gt;
 SG=&lt;br /&gt;
 H;40x40 fehlt&lt;br /&gt;
 Pumpensumpf&lt;br /&gt;
 SH=&lt;br /&gt;
 H;ohne Gitterrost&lt;br /&gt;
 Schachtabdeckung&lt;br /&gt;
 nicht Tagwasser&lt;br /&gt;
 SI=&lt;br /&gt;
 H;dicht&lt;br /&gt;
 Schachtabdeckung&lt;br /&gt;
 falsche Belast-&lt;br /&gt;
 SJ=&lt;br /&gt;
 H;ungsklasse&lt;br /&gt;
 Befestigung für&lt;br /&gt;
 Wasseranschluss&lt;br /&gt;
 bügel an Wand&lt;br /&gt;
 oder Schacht-&lt;br /&gt;
 SK=&lt;br /&gt;
 H;boden fehlt&lt;br /&gt;
 Schraubmuffe&lt;br /&gt;
 innerhalb des&lt;br /&gt;
 SL=&lt;br /&gt;
 H;Schachtbauwerkes&lt;br /&gt;
 ab QN15: Schacht&lt;br /&gt;
 belüftung mind.&lt;br /&gt;
 SM=&lt;br /&gt;
 H;180qcm fehlt&lt;br /&gt;
 ab QN15: Schacht&lt;br /&gt;
 entlüftung mind.&lt;br /&gt;
 SN=&lt;br /&gt;
 H;180qcm fehlt&lt;br /&gt;
 ab Grosswasser:&lt;br /&gt;
 Montagehaken /&lt;br /&gt;
 Montageschiene&lt;br /&gt;
 über Rohrachse&lt;br /&gt;
 SO=&lt;br /&gt;
 H;fehlt&lt;br /&gt;
 --&lt;br /&gt;
 Hausanschluss&lt;br /&gt;
 --&lt;br /&gt;
 Hausanschluss-&lt;br /&gt;
 leitung stark&lt;br /&gt;
 CD=&lt;br /&gt;
 H;angerostet&lt;br /&gt;
 Hauptabsperr-&lt;br /&gt;
 ventil ..&lt;br /&gt;
 CE=&lt;br /&gt;
 H;schließt nicht&lt;br /&gt;
 CF=&lt;br /&gt;
 H;fehlt&lt;br /&gt;
 --&lt;br /&gt;
 EA=&lt;br /&gt;
 A;&lt;br /&gt;
 EB=&lt;br /&gt;
 A;&lt;br /&gt;
 EC=&lt;br /&gt;
 A;&lt;br /&gt;
 ********************&lt;br /&gt;
 FA=&lt;br /&gt;
 F;Foto Ausbau ~FA~&lt;br /&gt;
 FN=&lt;br /&gt;
 F;Foto Einbau ~FN~&lt;br /&gt;
 FH=&lt;br /&gt;
 F;Foto Anlage ~FH~&lt;br /&gt;
&lt;br /&gt;
== Beispiel 2 ==&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE CODE_128,CODE_39&lt;br /&gt;
 #&lt;br /&gt;
 # Elektro-Protokoll 1.0&lt;br /&gt;
 # vom 19.04.2013, AF&lt;br /&gt;
 #&lt;br /&gt;
 Korrektur der Ausbau-Zählernummer&lt;br /&gt;
 11=&lt;br /&gt;
 N;&lt;br /&gt;
 Stand des Ausbau-Zählers&lt;br /&gt;
 14=&lt;br /&gt;
 D;&lt;br /&gt;
 NT-Stand des Ausbau-Zählers&lt;br /&gt;
 NA=&lt;br /&gt;
 D;&lt;br /&gt;
 --&lt;br /&gt;
 Nummer des Einbau-Zählers&lt;br /&gt;
 12=&lt;br /&gt;
 N;&lt;br /&gt;
 S;Barcode ~12~&lt;br /&gt;
 Stand des Einbau-Zählers&lt;br /&gt;
 13=&lt;br /&gt;
 D;&lt;br /&gt;
 NT-Stand des Einbau-Zählers&lt;br /&gt;
 NN=&lt;br /&gt;
 D;&lt;br /&gt;
 --&lt;br /&gt;
 Vergebliche Besuche (2 eingeben für jetzt)&lt;br /&gt;
 V1=&lt;br /&gt;
 A;&lt;br /&gt;
 V2=&lt;br /&gt;
 A;&lt;br /&gt;
 V3=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 Bemerkungen&lt;br /&gt;
 I3=&lt;br /&gt;
 A;&lt;br /&gt;
 I4=&lt;br /&gt;
 A;&lt;br /&gt;
 I5=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 wichtige Hinweise&lt;br /&gt;
 I6=&lt;br /&gt;
 A;&lt;br /&gt;
 I7=&lt;br /&gt;
 A;&lt;br /&gt;
 I8=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 Hinweise Buero&lt;br /&gt;
 B1=&lt;br /&gt;
 A;&lt;br /&gt;
 B2=&lt;br /&gt;
 A;&lt;br /&gt;
 B3=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 FA=&lt;br /&gt;
 F;Foto Ausbau ~FA~&lt;br /&gt;
 FN=&lt;br /&gt;
 F;Foto Einbau ~FN~&lt;br /&gt;
&lt;br /&gt;
== Beispiel 3 ==&lt;br /&gt;
&lt;br /&gt;
  %set BARCODE_TYPE CODE_128&lt;br /&gt;
  #&lt;br /&gt;
  # Hermesdorf 2020-05-07&lt;br /&gt;
  #&lt;br /&gt;
  (Zählerwechsel&lt;br /&gt;
  Korrektur der Ausbau-Zählernummer&lt;br /&gt;
  11=&lt;br /&gt;
  A;&lt;br /&gt;
  Ausbau 1.8.0&lt;br /&gt;
  14=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 1.8.1&lt;br /&gt;
  A181=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 1.8.2&lt;br /&gt;
  NA=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 2.8.0&lt;br /&gt;
  A280=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 2.8.1&lt;br /&gt;
  A281=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 2.8.2&lt;br /&gt;
  A282=&lt;br /&gt;
  D;&lt;br /&gt;
  --&lt;br /&gt;
  Nummer des Einbau-Zählers&lt;br /&gt;
  12=&lt;br /&gt;
  A;&lt;br /&gt;
  S;Barcode ~12~&lt;br /&gt;
  Einbau 1.8.0&lt;br /&gt;
  13=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 1.8.1&lt;br /&gt;
  E181=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 1.8.2&lt;br /&gt;
  NN=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 2.8.0&lt;br /&gt;
  E280=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 2.8.1&lt;br /&gt;
  E281=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 2.8.2&lt;br /&gt;
  E282=&lt;br /&gt;
  D;&lt;br /&gt;
  )&lt;br /&gt;
  #&lt;br /&gt;
  --&lt;br /&gt;
  weitere Protokoll Eintragungen&lt;br /&gt;
  --&lt;br /&gt;
  Vergebliche Besuche (2 eingeben für jetzt)&lt;br /&gt;
  V1=&lt;br /&gt;
  A;&lt;br /&gt;
  V2=&lt;br /&gt;
  A;&lt;br /&gt;
  V3=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  Bemerkungen&lt;br /&gt;
  I3=&lt;br /&gt;
  A;&lt;br /&gt;
  I4=&lt;br /&gt;
  A;&lt;br /&gt;
  I5=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  wichtige Hinweise&lt;br /&gt;
  I6=&lt;br /&gt;
  A;&lt;br /&gt;
  I7=&lt;br /&gt;
  A;&lt;br /&gt;
  I8=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  Hinweise Buero&lt;br /&gt;
  B1=&lt;br /&gt;
  A;&lt;br /&gt;
  B2=&lt;br /&gt;
  A;&lt;br /&gt;
  B3=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  FA=&lt;br /&gt;
  F;Foto Ausbau 1.8.0 -FA- ~FA~&lt;br /&gt;
  FB=&lt;br /&gt;
  F;Foto Ausbau 1.8.1 ~FB~&lt;br /&gt;
  FC=&lt;br /&gt;
  F;Foto Ausbau 1.8.2 ~FC~&lt;br /&gt;
  FD=&lt;br /&gt;
  F;Foto Ausbau 2.8.0 ~FD~&lt;br /&gt;
  FF=&lt;br /&gt;
  F;Foto Ausbau 2.8.1 ~FF~&lt;br /&gt;
  FG=&lt;br /&gt;
  F;Foto Ausbau 2.8.2 ~FG~&lt;br /&gt;
  FN=&lt;br /&gt;
  F;Foto Einbau 1.8.0 -FN- ~FN~&lt;br /&gt;
  FM=&lt;br /&gt;
  F;Foto Einbau 1.8.1 ~FM~&lt;br /&gt;
  FO=&lt;br /&gt;
  F;Foto Einbau 1.8.2 ~FO~&lt;br /&gt;
  FP=&lt;br /&gt;
  F;Foto Einbau 2.8.0 ~FP~&lt;br /&gt;
  FQ=&lt;br /&gt;
  F;Foto Einbau 2.8.1 ~FQ~&lt;br /&gt;
  FR=&lt;br /&gt;
  F;Foto Einbau 2.8.2 ~FR~&lt;br /&gt;
  FH=&lt;br /&gt;
  F;Foto Hausanschlusskasten ~FH~&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Protokolle&amp;diff=33417</id>
		<title>Protokolle</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Protokolle&amp;diff=33417"/>
		<updated>2026-07-10T15:51:48Z</updated>

		<summary type="html">&lt;p&gt;Root: /* %set BARCODE_TYPE Barcode Scanner Technologie */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;b&amp;gt;Überblick&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
die OrgaMon-App sammelt mobile Daten. Protokolle sind frei gestaltbare Eingabeformulare, die unterwegs ausgefüllt werden können. Pro Auftrag wird nur ein Protokoll ausgefüllt.&lt;br /&gt;
&lt;br /&gt;
* Protokolle sind .txt Dateien mit UTF8-BOM Kodierung&lt;br /&gt;
* Protokolle sind Baustellen speziefisch&lt;br /&gt;
* Protokolle sind Zählerart speziefisch&lt;br /&gt;
** Beispiel: Baustelle ST3A, hier gibt es die Auftragsarten &amp;quot;W&amp;quot; und &amp;quot;G&amp;quot; und &amp;quot;E2&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3AW.txt&amp;lt;/code&amp;gt; wird dann verwendet für die Auftragsart &amp;quot;W&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3AG.txt&amp;lt;/code&amp;gt; ... &amp;quot;G&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3AE2.txt&amp;lt;/code&amp;gt; ... &amp;quot;E2&amp;quot;&lt;br /&gt;
** &amp;lt;code&amp;gt;ST3A.txt&amp;lt;/code&amp;gt; für alle anderen&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Protokoll Gestaltung ==&lt;br /&gt;
&lt;br /&gt;
Protokolle sind Textdateien, in die vor Ort zusätzliche Daten (neben den Standard-OrgaMon-&lt;br /&gt;
Daten) eingegeben werden können.&amp;lt;br&amp;gt;&lt;br /&gt;
Protokolle sind frei definierbar. Fest stehender Text, sowie Eingabepositionen&lt;br /&gt;
können definiert werden.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Protokolle, die für JonDa-Geräte geschrieben wurden können nun auch im OrgaMon&lt;br /&gt;
aufgerufen und bearbeitet werden. Ist ein Auftrag offen, so kann man das passende&lt;br /&gt;
Protokoll mit &amp;lt;Strg&amp;gt; und &amp;lt;1&amp;gt;, &amp;lt;2&amp;gt; usw. aufrufen. Der Name des Protokolles wird aus&lt;br /&gt;
&amp;quot;Baustellenkrzel&amp;quot;-&amp;quot;ZählerArt&amp;quot;-&amp;quot;NummerDerProtokollAlternative&amp;quot;.txt zusammengesetzt.&lt;br /&gt;
Protokolle werden im Verzeichnis .\Protokolle erwartet.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Muss man Änderungen an einem Protokoll machen, so ruft man das Protokoll mit&lt;br /&gt;
&amp;lt;Shift&amp;gt;&amp;amp;&amp;lt;Strg&amp;gt; und &amp;lt;1&amp;gt;, &amp;lt;2&amp;gt; usw. auf.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Der Variablen-Name ist immer 2 Buchstaben lang. Handelt es sich dabei um eine Zahl &lt;br /&gt;
01 .. 99, so ist es keine &amp;quot;echte&amp;quot; Eingabe-Position sondern ein Datenfeld, das aus OrgaMon &lt;br /&gt;
rauskopiert wird. Macht man Eingaben in diese festen OrgaMon-Felder hat dies&lt;br /&gt;
keine Auswirkung.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Gibt es pro Baustelle mehrere Protokolle sollten eindeutige Variblennamen ver&lt;br /&gt;
wendet werden. z.B.&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 Protokoll 1 -&amp;gt; AA bis AZ, BA bis BZ&lt;br /&gt;
 Protokoll 2 -&amp;gt; CA bis CZ, DA bis DZ&lt;br /&gt;
 Protokoll 3 -&amp;gt; EA bis EZ, FA bis FZ&lt;br /&gt;
 Protokoll 4 -&amp;gt; GA bis GZ, HA bis HZ&lt;br /&gt;
 Protokoll 5 -&amp;gt; IA bis IZ, JA bis JZ&lt;br /&gt;
&lt;br /&gt;
Datenausgabe: OrgaMon erzeugt Ausgabedaten im bekannten .csv Format. In der Regel&lt;br /&gt;
jedoch ohne Protokolldaten. In der Baustelle kann man jedoch die Ausgabe der&lt;br /&gt;
csv-Dateien incl. der Protokoll-Eingaben ermöglichen.&lt;br /&gt;
Dazu &amp;quot;Baustelle&amp;quot;, Reiter &amp;quot;Protokolle&amp;quot; das Häkchen &amp;quot;Ausfühen Protokollausgabe&amp;quot;&lt;br /&gt;
aktivieren.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Übergeben Sie ev. Protokolle aus dem Verzeichnis &amp;quot;./Protokolle&amp;quot; dem&lt;br /&gt;
Auftraggeber, damit ihm klar wird, was sich z.B. hinter der Spalte &amp;quot;V1&amp;quot; verbirgt.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Im Auftragsarbeitsplatz: Werden Protokolldaten mit ausgegeben erscheint der Ausgabewartenbalken als&lt;br /&gt;
voller Balken, ansonsten ist dieser Balken unterbrochen (da nur ein Teil der Daten&lt;br /&gt;
ausgegeben wird).&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Ist schon eine Feldreihenfolge mit dem Auftraggeber vereinbart sollten neue Felder&lt;br /&gt;
nur hinten (also im Excel &amp;quot;rechts&amp;quot;) angefügt werden.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
Ist noch keine Feldreihenfolge mit dem Auftraggeber vereinbart empfiehlt es sich&lt;br /&gt;
die Spaltennamen ev. inhaltlich oder vom Namen her zu sortieren, damit die Daten&lt;br /&gt;
de zusammengehören auch zusammen sind.&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Dateiname eines Protokolles ===&lt;br /&gt;
&lt;br /&gt;
* bei der Aufbereitung des Auftragsvolumens wird für jeden einzelnen Auftrag ermittelt welches Protokoll mitgegeben wird.&lt;br /&gt;
* Hier ist man also sehr flexibel und man kann so steuern &amp;quot;was&amp;quot; der Monteur vor Ort alles machen kann und soll. Und das abhängig von der Baustelle und der Auftragsart.&lt;br /&gt;
* das zu jedem einzelnen Auftrag mitgesendete Protokoll ist nicht Geräte-abhängig sondern Baustellen- und Zähler-Art abhängig: Also bei Baustelle &amp;quot;X3&amp;quot; kann es z.B. die Art &amp;quot;W&amp;quot; und &amp;quot;E2&amp;quot; und andere Zählerarten geben. Dann kann man 3 ganz verschiendene Protokolle hinterlegen:&lt;br /&gt;
&lt;br /&gt;
 X3&lt;br /&gt;
 X3W&lt;br /&gt;
 X3E2&lt;br /&gt;
&lt;br /&gt;
* im OrgaMon finden sich die Dateien im Verzeichnis .\Protokolle. Sie werden folgendermassen benannt:&lt;br /&gt;
 &lt;br /&gt;
  &amp;lt;Kürzel der Baustelle&amp;gt;&amp;lt;Zählerart&amp;gt;&amp;lt;Protokollvariante&amp;gt;.txt&lt;br /&gt;
 &lt;br /&gt;
  Bei &amp;lt;Protokollvariante&amp;gt; = &amp;quot;1&amp;quot; wird die Ziffer &amp;quot;1&amp;quot; NICHT angegeben! Beispiel:&lt;br /&gt;
  Baustelle KARL: es gibt &amp;quot;G&amp;quot; und &amp;quot;W&amp;quot; Zählertypen: die möglichen Protokolle sind&lt;br /&gt;
  somit:&lt;br /&gt;
  &lt;br /&gt;
  OrgaMon/JonDa&lt;br /&gt;
  ===========&lt;br /&gt;
  &lt;br /&gt;
  KARLG.TXT, KARLW.TXT&lt;br /&gt;
  &lt;br /&gt;
  OrgaMon&lt;br /&gt;
  &lt;br /&gt;
  KARLG2.TXT, KARLW2.TXT&lt;br /&gt;
  KARLG3.TXT, KARLW3.TXT&lt;br /&gt;
  KARLG4.TXT, KARLW4.TXT&lt;br /&gt;
  KARLG5.TXT, KARLW5.TXT&lt;br /&gt;
&lt;br /&gt;
=== Konstante ===&lt;br /&gt;
&lt;br /&gt;
* 1=, RID &lt;br /&gt;
* 2=, TERMIN &lt;br /&gt;
* 3=, ABNUMMER&lt;br /&gt;
* 4=, ART &lt;br /&gt;
* 5=, ZAEHLER_# ALT&lt;br /&gt;
* 6=, REGLER_# ALT&lt;br /&gt;
* 7=, ZAEHLER_INFO&lt;br /&gt;
* 8=, MONTEUR_INFO&lt;br /&gt;
* 9=, ORT&lt;br /&gt;
* 10=, PROTOKOLL_NAME&lt;br /&gt;
&lt;br /&gt;
=== vorbestimmete Variable ===&lt;br /&gt;
&lt;br /&gt;
Variable speichern Protokoll-Eingaben. Dabei gibt es folgende fest eingebauten Speicherplätze:&lt;br /&gt;
&lt;br /&gt;
* 11=, Zählernummer Korrektur&lt;br /&gt;
* 12=, Zählernummer Neu &lt;br /&gt;
* 13=, Zählerstand Neu&lt;br /&gt;
* 14=, Zählerstand Alt&lt;br /&gt;
* 15=, Reglernummer Korrektur&lt;br /&gt;
* 16=, Reglernummer Neu&lt;br /&gt;
&lt;br /&gt;
=== freie Variable (Protokollwerte) ===&lt;br /&gt;
&lt;br /&gt;
* werden in Grossbuchstaben angegeben und haben immer 2 Stellen&lt;br /&gt;
* die 2. Stelle kann eine Ziffer sein&lt;br /&gt;
* Freie Variable sind die Wertbezeichnungen für Eingaben in das Protokoll, also Speicherbezeichnungen für Protokollwerte&lt;br /&gt;
* Die kommende Verwendung einer Variable gibt man durch ein abschliessendes &amp;quot;=&amp;quot; Zeichen an&lt;br /&gt;
* Der Name einer Variable wird einem eingegebenen Wert vorangestellt&lt;br /&gt;
* Im Datenfeld PROTOKOLLE des Auftrages können Eingaben abgerufen werden&lt;br /&gt;
&lt;br /&gt;
 S1=X&lt;br /&gt;
 OR=Keller&lt;br /&gt;
&lt;br /&gt;
* In der Ergebnismeldung können Spaltennamen den Variablennamen entsprechen&lt;br /&gt;
&lt;br /&gt;
=== Konventionenn ===&lt;br /&gt;
&lt;br /&gt;
==== A1 ====&lt;br /&gt;
&lt;br /&gt;
Alphanumerischer Prefix für eine Zählernummer Neu&lt;br /&gt;
&lt;br /&gt;
==== N1 ====&lt;br /&gt;
&lt;br /&gt;
Zählernummer Neu (Alternativ-Feld)&lt;br /&gt;
&lt;br /&gt;
==== V1,V2,V3,V4 ====&lt;br /&gt;
&lt;br /&gt;
Vergebliche Besuche &lt;br /&gt;
&lt;br /&gt;
==== Zählwerke ====&lt;br /&gt;
&lt;br /&gt;
===== Ausbau =====&lt;br /&gt;
&lt;br /&gt;
 Ausbau Verbrauch 1.8.0&lt;br /&gt;
 ZAEHLER_STAND_ALT (echtes Datenbankfeld, intern 14=)&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Verbrauch 1.8.1&lt;br /&gt;
 A181=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Verbrauch Nebentarif 1.8.2&lt;br /&gt;
 NA=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Einspeisung 2.8.0&lt;br /&gt;
 A280=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau Einspeisung  2.8.1&lt;br /&gt;
 A281=&lt;br /&gt;
 &lt;br /&gt;
 Ausbau  Einspeisung 2.8.2&lt;br /&gt;
 A282=&lt;br /&gt;
&lt;br /&gt;
===== Einbau =====&lt;br /&gt;
 &lt;br /&gt;
 Einbau Verbrauch 1.8.0&lt;br /&gt;
 ZAEHLER_STAND_NEU (echtes Datenbankfeld, intern 13=)&lt;br /&gt;
 &lt;br /&gt;
 Einbau Verbrauch 1.8.1&lt;br /&gt;
 E181=&lt;br /&gt;
 &lt;br /&gt;
 Einbau Verbrauch Nebentarif 1.8.2&lt;br /&gt;
 NN=&lt;br /&gt;
 &lt;br /&gt;
 Einbau  Einspeisung 2.8.0&lt;br /&gt;
 E280=&lt;br /&gt;
 &lt;br /&gt;
 Einbau  Einspeisung 2.8.1&lt;br /&gt;
 E281=&lt;br /&gt;
 &lt;br /&gt;
 Einbau  Einspeisung Nebentarif 2.8.2&lt;br /&gt;
 E282=&lt;br /&gt;
&lt;br /&gt;
==== Fotos ====&lt;br /&gt;
&lt;br /&gt;
 Foto Ausbau &lt;br /&gt;
 FA&lt;br /&gt;
 &lt;br /&gt;
 Foto Einbau &lt;br /&gt;
 FN&lt;br /&gt;
 &lt;br /&gt;
 Foto Regler&lt;br /&gt;
 FE&lt;br /&gt;
 &lt;br /&gt;
 Foto Anlage&lt;br /&gt;
 FH&lt;br /&gt;
 &lt;br /&gt;
 Ausbau 1.8.0&lt;br /&gt;
 FA &lt;br /&gt;
 Ausbau 1.8.1 &lt;br /&gt;
 FB &lt;br /&gt;
 Ausbau 1.8.2&lt;br /&gt;
 FC &lt;br /&gt;
 Ausbau 2.8.0&lt;br /&gt;
 FD &lt;br /&gt;
 Ausbau 2.8.1&lt;br /&gt;
 FF &lt;br /&gt;
 Ausbau 2.8.2&lt;br /&gt;
 FG &lt;br /&gt;
 &lt;br /&gt;
 Einbau 1.8.0&lt;br /&gt;
 FN&lt;br /&gt;
 Einbau 1.8.1&lt;br /&gt;
 FM&lt;br /&gt;
 Einbau 1.8.2&lt;br /&gt;
 FO&lt;br /&gt;
 Einbau 2.8.0&lt;br /&gt;
 FP&lt;br /&gt;
 Einbau 2.8.1&lt;br /&gt;
 FQ&lt;br /&gt;
 Einbau 2.8.2&lt;br /&gt;
 FR&lt;br /&gt;
&lt;br /&gt;
===== FU =====&lt;br /&gt;
&lt;br /&gt;
* kein Foto, sondern es wird ein Dialog gezeigt auf dem kann man unterschreiben&lt;br /&gt;
* die Unterschrift wird als -FU.jpg abgespeichert und als normales Foto übertragen&lt;br /&gt;
&lt;br /&gt;
==== ZZ ====&lt;br /&gt;
&lt;br /&gt;
* Ja/Nein Feld&lt;br /&gt;
* Alles fertig, Eingabe des Ausbaustandes wird so unnötig&lt;br /&gt;
&lt;br /&gt;
=== Verwendung eines Variablen-Wertes innerhalb des Protokolles ===&lt;br /&gt;
&lt;br /&gt;
Werte von aktuellen Variablen können mit Schlangenlinien ausbelichtet werden:&lt;br /&gt;
&lt;br /&gt;
 ~NN~&lt;br /&gt;
&lt;br /&gt;
Ist der Wert bereits bestimmt wird anstelle von ~NN~ der eingegebene Wert angezeigt&lt;br /&gt;
&lt;br /&gt;
=== Unterformulare ===&lt;br /&gt;
&lt;br /&gt;
Formulare lassen sich verschachteln. So kann man Inhaltlich zusammenpassende Bereiche eines Protokolles auf eine eigene Unterseite bringen&lt;br /&gt;
&lt;br /&gt;
* (, Unterbereich beginnen&lt;br /&gt;
* ), Unterbereich Ende&lt;br /&gt;
&lt;br /&gt;
=== Trenner ===&lt;br /&gt;
&lt;br /&gt;
* --&lt;br /&gt;
&lt;br /&gt;
=== Eingabetypen ===&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;N;&amp;quot; rein numerische Eingabe (0 .. 9)&lt;br /&gt;
* &amp;quot;D;&amp;quot; dezimal  (0 .. 9 und Punkt oder Komma)&lt;br /&gt;
* &amp;quot;A;&amp;quot; alphanumerisch (Buchstaben und Ziffern)&lt;br /&gt;
* &amp;quot;T;&amp;quot; Zeit/Datum&lt;br /&gt;
&lt;br /&gt;
=== Ankreuzfelder ===&lt;br /&gt;
&lt;br /&gt;
==== Haken ====&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;H;&amp;quot; &amp;lt;SichtbarerText&amp;gt; [&amp;quot;;&amp;quot; &amp;lt;WertWennAngekreuzt&amp;gt; [&amp;quot;;&amp;quot; &amp;lt;WertWennAngekreuztEntferntwird&amp;gt;]]&lt;br /&gt;
&lt;br /&gt;
 # mit dem Default: &amp;quot;H;&amp;quot; &amp;lt;SichtbarerText&amp;gt; &amp;quot;;J;N&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 # Wird das angekreuzt wird der &amp;quot;J&amp;quot;-Wert bzw. &amp;lt;WertWennAngekreuzt&amp;gt; übermittelt&lt;br /&gt;
 # Im Fall dass ein Haken rausgemacht wird, wird der &amp;quot;N&amp;quot;-Wert bzw. &amp;lt;WertWennAngekreuztEntferntwird&amp;gt; übermittelt&lt;br /&gt;
 # Bei unberührten Ankreuzfeldern wird &amp;quot;&amp;quot; (&amp;lt;leer&amp;gt;) übermittelt&lt;br /&gt;
&lt;br /&gt;
==== Bobbele ====&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;B;&amp;quot; &amp;lt;SichtbarerText&amp;gt; [ &amp;quot;;&amp;quot; &amp;lt;JA-Wert&amp;gt; ]&lt;br /&gt;
&lt;br /&gt;
 # B sind eine Gruppe von Radiobuttons, als es ist immer nur EIN&lt;br /&gt;
 # Knopf gedrückt angekreuzt, wählt man eine andere Option &lt;br /&gt;
 # springt der Haken in einer ehemals gewählten Option raus&lt;br /&gt;
 #&lt;br /&gt;
 # Übermittelt wird der &amp;lt;JA-Wert&amp;gt; der jeweils gesetzten Option&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
 Bobbele eignen sich, wenn man nur eine Auswahl im Protokoll treffen soll und dieses auch als Pflichtfeld &amp;quot;!&amp;quot; versehen möchte&lt;br /&gt;
&lt;br /&gt;
=== (Barcode-) Scan ===&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;S;&amp;quot; &amp;lt;Beschriftung&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Infos zur Parametrisierung finden Sie hier [[#.25set_BARCODE_TYPE_Technologie]]&lt;br /&gt;
&lt;br /&gt;
=== Foto ===&lt;br /&gt;
&lt;br /&gt;
* &amp;quot;F;&amp;quot; &amp;lt;Beschriftung&amp;gt;&lt;br /&gt;
** einzelnes Foto für einen vorbestimmten Dokumentationsschritt z.B. &amp;quot;Zählerstand Ausbau&amp;quot;&lt;br /&gt;
** keines oder mehrere Fotos (Story-Modus), wobei alle Fotos gleichberechtigt übertragen werden und ihre Gültigkeit haben z.B. &amp;quot;Vergeblicher Besuch&amp;quot; dieser Modus muss durch ein ~#~ bei der &amp;lt;code&amp;gt;F?-Benennung=&amp;lt;/code&amp;gt; aktiviert werden&lt;br /&gt;
&lt;br /&gt;
=== Pflichteingabe ===&lt;br /&gt;
&lt;br /&gt;
* Um die Eingabedaten zu plausibilisieren kann am Ende des Protokolles eine Prüf-Vorschrift mitgegeben werden&lt;br /&gt;
* beim &amp;quot;SPEICHERN&amp;quot; wird die Prüf-Vorschrift angewendet&lt;br /&gt;
* Folgende &amp;quot;Eingabefehler&amp;quot; des Monteurs können durch die Prüf-Vorschrift aufgedeckt werden&lt;br /&gt;
** Vergessen ein Feld auszufüllen (als ein sogenanntes Pflichtfeld/Mussfeld/Sollfeld)&lt;br /&gt;
** Vergessen eine Option zu wählen&lt;br /&gt;
** Einen Wert eingegeben, obwohl dies in diesem Falle nicht mehr notwendig ist&lt;br /&gt;
** Einen Wert eingegeben der zu gross oder zu klein ist&lt;br /&gt;
&lt;br /&gt;
==== Syntax der Prüf-Vorschrift ====&lt;br /&gt;
&lt;br /&gt;
* man schreibt als letzten Punkt des Protokolles eine neue Rubrik &amp;lt;code&amp;gt;(Prüfen )&amp;lt;/code&amp;gt; als reinen Text ohne Eingabefelder&lt;br /&gt;
* bei einer Prüfung wird Zeile für Zeile von oben nach unten abgearbeitet (Prüflogik)&lt;br /&gt;
* bei einem Fehler springt der Eingabe-Fokus auf die erste Eingabeposition, die in der Fehlerzeile angegeben ist&lt;br /&gt;
* Der Aufbau einer Zeile ist&lt;br /&gt;
** &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Bedingung [ Resultat [ Aktion ]]&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* Vor der &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Bedingung&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; kann man einige Leerschritte machen um eine Blockzugehörigkeit zu setzen&lt;br /&gt;
* Erfüllte Bedigungen bekommen einen Punkt, man kann z.B. 5 Bedingungen in eine Zeile schreiben, nach der Prüfung aller Bedingungen ergibt sich ein Resultat von 0,1,2,3,4 oder 5 (wenn alle Bedingungen erfüllt sind!)&lt;br /&gt;
* wird &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Resultat&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; weggelassen, so wird der kommende Block nur ausgeführt wenn die Bedingung erfüllt ist&lt;br /&gt;
* wird &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;Aktion&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; weggelassen, so wird auf eine Unstimmigkeit aufmerksam gemacht&lt;br /&gt;
* &amp;lt;u&amp;gt;default&amp;lt;/u&amp;gt; Werte sind unterstrichen, diese können einfach weggelassen werden&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 &amp;lt;i&amp;gt;Zeile&amp;lt;/i&amp;gt; = { ' ' } { &amp;lt;i&amp;gt;Bedingung&amp;lt;/i&amp;gt; ' ' } [ &amp;lt;i&amp;gt;Resultat&amp;lt;/i&amp;gt; [ &amp;lt;i&amp;gt;Aktion&amp;lt;/i&amp;gt; ]]&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 &amp;lt;i&amp;gt;Bedingung&amp;lt;/i&amp;gt; = &amp;lt;b&amp;gt;Protokollfeld&amp;lt;/b&amp;gt; [ '!' | '&amp;lt;u&amp;gt;=&amp;quot;J&amp;quot;&amp;lt;/u&amp;gt;' | ( '=' | '&amp;lt;&amp;gt;' | '&amp;lt;' | '&amp;gt;' | '&amp;gt;=' | '&amp;lt;=' ) &amp;lt;i&amp;gt;Eingabewert&amp;lt;/i&amp;gt; ]&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 Eingabewert = '&amp;quot;' { &amp;lt;b&amp;gt;Zeichen&amp;lt;/b&amp;gt; } '&amp;quot;' &lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 Resultat = '=0' | &amp;lt;u&amp;gt;'=1'&amp;lt;/u&amp;gt; | '&amp;gt;0'&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 Aktion = &amp;lt;b&amp;gt;exit&amp;lt;/b&amp;gt; | &amp;lt;u&amp;gt;&amp;lt;b&amp;gt;fail&amp;lt;/b&amp;gt;&amp;lt;/u&amp;gt; | &amp;lt;b&amp;gt;:&amp;lt;/b&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* werden mehrere Protokollfelder in einer Zeile angegeben so wird eine Summe aller erfüllten Bedingungen gebildet, das ist das Resultat&lt;br /&gt;
* Stimmt das Resultat nicht, ergibt sich ein Eingabefehler&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;b&amp;gt;!&amp;lt;/b&amp;gt; ist einfach eine Kurzform von &amp;lt;b&amp;gt;&amp;lt;&amp;gt;&amp;quot;&amp;quot;&amp;lt;/b&amp;gt;, also es soll etwas drinstehen - egal was&lt;br /&gt;
* &amp;lt;b&amp;gt;=&amp;quot;J&amp;quot;&amp;lt;/b&amp;gt; kann weggelassen werden, also wenn nichts rechts vom Protokollfeld steht wird =&amp;quot;J&amp;quot; angenommen&lt;br /&gt;
** &amp;lt;code&amp;gt;KL=&amp;quot;J&amp;quot; KM=&amp;quot;J&amp;quot; KN=&amp;quot;J&amp;quot;&amp;lt;/code&amp;gt; kann man schreiben&lt;br /&gt;
** &amp;lt;code&amp;gt;KL KM KN&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== Aktion &amp;lt;code&amp;gt;&amp;lt;b&amp;gt;fail&amp;lt;/b&amp;gt;&amp;lt;/code&amp;gt; ====&lt;br /&gt;
&lt;br /&gt;
* Im Fall das das wirkliche Resultat NICHT dem angegebenen Resultat entspricht wird auf das zuerst angegebene Protokollfeld fokusiert&lt;br /&gt;
&lt;br /&gt;
==== Aktion &amp;lt;code&amp;gt;&amp;lt;b&amp;gt;exit&amp;lt;/b&amp;gt;&amp;lt;/code&amp;gt; ====&lt;br /&gt;
&lt;br /&gt;
* Im Fall das das Resultat stimmt wird an dieser Stelle die Prüfung mit Erfolg beendet&lt;br /&gt;
&lt;br /&gt;
==== Beispiele ====&lt;br /&gt;
&lt;br /&gt;
 ZZ exit&lt;br /&gt;
 O1 O2 O3 &amp;gt;0&lt;br /&gt;
 HK NK&lt;br /&gt;
 HK :&lt;br /&gt;
  N1 N2&lt;br /&gt;
  K3 K2&lt;br /&gt;
&lt;br /&gt;
==== Standard ====&lt;br /&gt;
&lt;br /&gt;
* wird keine Prüf-Vorschrift angegeben, so gilt folgendes:&lt;br /&gt;
&lt;br /&gt;
 ZZ exit&lt;br /&gt;
 14!&lt;br /&gt;
&lt;br /&gt;
== Befehlsausführung ==&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;b&amp;gt;&amp;lt;code&amp;gt;$&amp;lt;/code&amp;gt;&amp;lt;/b&amp;gt;, globaler Befehl (Ausführung einmalig)&lt;br /&gt;
* &amp;lt;b&amp;gt;&amp;lt;code&amp;gt;%&amp;lt;/code&amp;gt;&amp;lt;/b&amp;gt;, Befehl für dieses Protokoll (wirksam für aktuelles Protokoll)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Beim Laden aus dem Internet werden die Protokolle gespeichert. &lt;br /&gt;
&lt;br /&gt;
* Dabei werden alle mit &amp;quot;$&amp;quot; aufgeführten Befehle ausgeführt.&lt;br /&gt;
* Lokale BEfehle, die bei jeder Protokollverwendung ausgeführt werden sollen werden mit &amp;quot;%&amp;quot; eingeleitet&lt;br /&gt;
&lt;br /&gt;
=== $mv ===&lt;br /&gt;
&lt;br /&gt;
* Verschieben einer Datei&lt;br /&gt;
&lt;br /&gt;
=== $rm ===&lt;br /&gt;
&lt;br /&gt;
* Löschen einer Datei&lt;br /&gt;
&lt;br /&gt;
=== %set ===&lt;br /&gt;
&lt;br /&gt;
* setzen einer Systemvariable&lt;br /&gt;
&lt;br /&gt;
==== %set BARCODE_TYPE &amp;lt;i&amp;gt;Technologie&amp;lt;/i&amp;gt;====&lt;br /&gt;
&lt;br /&gt;
* Um Barcodes über das Protokoll abscannen zu können muss dies im Protokoll erst aktiviert werden&lt;br /&gt;
* Ganz oben im Protokoll wird eingestellt welche Barcode-Technologie zum Einsatz kommt&lt;br /&gt;
* Folgende Technologien gibt es:&lt;br /&gt;
** 1D Technologien: &amp;lt;code&amp;gt;UPC_A|UPC_E|EAN_13|EAN_8|RSS_14|RSS_EXPANDED|CODE_39|CODE_93|CODE_128|ITF|CODABAR&amp;lt;/code&amp;gt;&lt;br /&gt;
** 2D Technologien: &amp;lt;code&amp;gt;DATA_MATRIX|QR_CODE &amp;lt;/code&amp;gt; &lt;br /&gt;
* Das Scannen wird bewusst auf einzelne Technologien vor Ort beschränkt, damit es nicht zu Fehlinterpretationen kommt:&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 2016-01-29-09-57-05.png|300px]]&lt;br /&gt;
&lt;br /&gt;
* Um die verwendetet Technologie herauszufinden starten Sie auf dem Handy die &amp;quot;zxing Barcode Scanner&amp;quot;-App und Scannen den Code.&lt;br /&gt;
* Merken Sie sich was rechts von &amp;quot;Format&amp;quot; steht (=&amp;lt;i&amp;gt;Technologie&amp;lt;/i&amp;gt;), das tragen Sie bitte in die erste Zeile des Protokolls ein &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE Technologie { &amp;quot;,&amp;quot; Technologie }&lt;br /&gt;
&lt;br /&gt;
* ohne Leerzeichen - Aufzählung mit KOMMA kein SEMIKOLON!&lt;br /&gt;
* Beispiel&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Datei:Format-ITF.jpg|300px]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE ITF,ITF&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===== Besondere Werte =====&lt;br /&gt;
&lt;br /&gt;
* Folgende Angaben haben interne feste Programmierungen&lt;br /&gt;
** &amp;lt;code&amp;gt;ITF&amp;lt;/code&amp;gt; : Es wird eine Prüfziffern-Routine nachgeschaltet, &amp;quot;+&amp;quot; bedeutet Erfolg, &amp;quot;-&amp;quot; Fehler in der Prüfziffer. &lt;br /&gt;
** &amp;lt;code&amp;gt;ITF,ITF&amp;lt;/code&amp;gt; : Einfach nur ITF ohne Prüfziffernberechnung&lt;br /&gt;
** &amp;lt;code&amp;gt;CODE_39&amp;lt;/code&amp;gt; : Es wird die Einlagerungsfunktion durchgeführt. &lt;br /&gt;
** &amp;lt;code&amp;gt;CODE_39,CODE_39&amp;lt;/code&amp;gt; Einfach nur CODE_39-Scan ohne jede weitere Sonderfunktion&lt;br /&gt;
&lt;br /&gt;
==== %set AUTO_FOCUS &amp;lt;i&amp;gt;Parameter&amp;lt;/i&amp;gt; ==== &lt;br /&gt;
&lt;br /&gt;
* setzt automatisch den Eingabefokus des Protokolles auf eines der angegebenen Felder&lt;br /&gt;
* Der Fokus wird nur dann gesetzt wenn das Feld bisher keine Eingabe hat&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Beispiel, Gehe auf das Feld S1 danach S2&lt;br /&gt;
 #&lt;br /&gt;
 %set AUTO_FOCUS=S1;S2&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # default&lt;br /&gt;
 #&lt;br /&gt;
 %set AUTO_FOCUS=14&lt;br /&gt;
&lt;br /&gt;
==== %set AUTO_SCAN &amp;lt;i&amp;gt;Parameter&amp;lt;/i&amp;gt; ====&lt;br /&gt;
&lt;br /&gt;
* ist das angegebene Eingabefeld leer wird sofort der Barcode-Scanner gestartet und das Scan-Ergebnis landet in dem Feld&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # erst S1 dann S2 scannen&lt;br /&gt;
 #&lt;br /&gt;
 %set AUTO_SCAN=S1;S2&lt;br /&gt;
&lt;br /&gt;
== Beispiel 1 ==&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE CODE_128&lt;br /&gt;
 #&lt;br /&gt;
 # KAWS 2016-01-26&lt;br /&gt;
 #&lt;br /&gt;
 (Zählerwechsel&lt;br /&gt;
 Korrektur der Ausbau-Zählernummer&lt;br /&gt;
 11=&lt;br /&gt;
 N;&lt;br /&gt;
 Stand des Ausbau-Zählers&lt;br /&gt;
 14=&lt;br /&gt;
 D;&lt;br /&gt;
 Nummer des Einbau-Zählers&lt;br /&gt;
 12=&lt;br /&gt;
 A;&lt;br /&gt;
 S;Barcode ~12~&lt;br /&gt;
 Stand des Einbau-Zählers&lt;br /&gt;
 13=&lt;br /&gt;
 D;&lt;br /&gt;
 )&lt;br /&gt;
 (Regler&lt;br /&gt;
 Korrektur der Ausbau-Reglernummer&lt;br /&gt;
 15=&lt;br /&gt;
 N;&lt;br /&gt;
 Nummer des Einbau-Reglers&lt;br /&gt;
 16=&lt;br /&gt;
 N;&lt;br /&gt;
 )&lt;br /&gt;
 #&lt;br /&gt;
 --&lt;br /&gt;
 Vergebliche Besuche&lt;br /&gt;
 --&lt;br /&gt;
 V1=&lt;br /&gt;
 A;&lt;br /&gt;
 V2=&lt;br /&gt;
 A;&lt;br /&gt;
 V3=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 Inspektion SCHACHT&lt;br /&gt;
 --&lt;br /&gt;
 V5=&lt;br /&gt;
 H;Kopie an Eigent.&lt;br /&gt;
 AA=&lt;br /&gt;
 H;Turnus&lt;br /&gt;
 AB=&lt;br /&gt;
 H;Abnahme&lt;br /&gt;
 AC=&lt;br /&gt;
 H;Reparaturwechsel&lt;br /&gt;
 AD=&lt;br /&gt;
 H;Neusetzung&lt;br /&gt;
 --&lt;br /&gt;
 Mängelprüfung&lt;br /&gt;
 --&lt;br /&gt;
 BR=&lt;br /&gt;
 H;DIN 1988 OK!&lt;br /&gt;
 SA=&lt;br /&gt;
 H;DVGW-Blatt OK!&lt;br /&gt;
 Entnahmestelle&lt;br /&gt;
 BA=&lt;br /&gt;
 H;vor Zähler.Info:&lt;br /&gt;
 BB=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 P0=&lt;br /&gt;
 H;ALLES WIE EBEN!&lt;br /&gt;
 --&lt;br /&gt;
 Wasserzählerplatz.&lt;br /&gt;
 BC=&lt;br /&gt;
 H;nicht zugänglich&lt;br /&gt;
 BD=&lt;br /&gt;
 H;frostgefährdet&lt;br /&gt;
 Wasserzähleran-&lt;br /&gt;
 schlussbügel&lt;br /&gt;
 BK=&lt;br /&gt;
 H;fehlt!&lt;br /&gt;
 Absperrventil&lt;br /&gt;
 kombiniert mit&lt;br /&gt;
 Rückflussver-&lt;br /&gt;
 hinderer&lt;br /&gt;
 BM=&lt;br /&gt;
 H;fehlt!&lt;br /&gt;
 läßt sich&lt;br /&gt;
 BN=&lt;br /&gt;
 H;nicht schliessen&lt;br /&gt;
 Installations&lt;br /&gt;
 leitungen der&lt;br /&gt;
 Kundenanlage&lt;br /&gt;
 BO=&lt;br /&gt;
 H;stark angerostet&lt;br /&gt;
 unzureichend&lt;br /&gt;
 BP=&lt;br /&gt;
 H;befestigt!&lt;br /&gt;
 BX=&lt;br /&gt;
 H;Sonstige Mängel&lt;br /&gt;
 BQ=&lt;br /&gt;
 A;&lt;br /&gt;
 BS=&lt;br /&gt;
 H;wegen Mängel un-&lt;br /&gt;
 möglich!&lt;br /&gt;
 --&lt;br /&gt;
 Eingebaute Apparate&lt;br /&gt;
 --&lt;br /&gt;
 Schachttiefe bis&lt;br /&gt;
 Rohrachse kleinr&lt;br /&gt;
 SB=&lt;br /&gt;
 H;1,5m:Frostgefahr&lt;br /&gt;
 Bodenfreiheit&lt;br /&gt;
 SC=&lt;br /&gt;
 H;kleiner 40 cm&lt;br /&gt;
 Leiter(ab DN100&lt;br /&gt;
 SD=&lt;br /&gt;
 H;Treppe!) fehlt&lt;br /&gt;
 Undicht gegen&lt;br /&gt;
 SE=&lt;br /&gt;
 H;Grund-/Tagwasser&lt;br /&gt;
 Mauerdurchführng&lt;br /&gt;
 ohne Dichtung&lt;br /&gt;
 SF=&lt;br /&gt;
 H;Gummi/Quellm÷rtl&lt;br /&gt;
 Pumpensumpf&lt;br /&gt;
 SG=&lt;br /&gt;
 H;40x40 fehlt&lt;br /&gt;
 Pumpensumpf&lt;br /&gt;
 SH=&lt;br /&gt;
 H;ohne Gitterrost&lt;br /&gt;
 Schachtabdeckung&lt;br /&gt;
 nicht Tagwasser&lt;br /&gt;
 SI=&lt;br /&gt;
 H;dicht&lt;br /&gt;
 Schachtabdeckung&lt;br /&gt;
 falsche Belast-&lt;br /&gt;
 SJ=&lt;br /&gt;
 H;ungsklasse&lt;br /&gt;
 Befestigung für&lt;br /&gt;
 Wasseranschluss&lt;br /&gt;
 bügel an Wand&lt;br /&gt;
 oder Schacht-&lt;br /&gt;
 SK=&lt;br /&gt;
 H;boden fehlt&lt;br /&gt;
 Schraubmuffe&lt;br /&gt;
 innerhalb des&lt;br /&gt;
 SL=&lt;br /&gt;
 H;Schachtbauwerkes&lt;br /&gt;
 ab QN15: Schacht&lt;br /&gt;
 belüftung mind.&lt;br /&gt;
 SM=&lt;br /&gt;
 H;180qcm fehlt&lt;br /&gt;
 ab QN15: Schacht&lt;br /&gt;
 entlüftung mind.&lt;br /&gt;
 SN=&lt;br /&gt;
 H;180qcm fehlt&lt;br /&gt;
 ab Grosswasser:&lt;br /&gt;
 Montagehaken /&lt;br /&gt;
 Montageschiene&lt;br /&gt;
 über Rohrachse&lt;br /&gt;
 SO=&lt;br /&gt;
 H;fehlt&lt;br /&gt;
 --&lt;br /&gt;
 Hausanschluss&lt;br /&gt;
 --&lt;br /&gt;
 Hausanschluss-&lt;br /&gt;
 leitung stark&lt;br /&gt;
 CD=&lt;br /&gt;
 H;angerostet&lt;br /&gt;
 Hauptabsperr-&lt;br /&gt;
 ventil ..&lt;br /&gt;
 CE=&lt;br /&gt;
 H;schließt nicht&lt;br /&gt;
 CF=&lt;br /&gt;
 H;fehlt&lt;br /&gt;
 --&lt;br /&gt;
 EA=&lt;br /&gt;
 A;&lt;br /&gt;
 EB=&lt;br /&gt;
 A;&lt;br /&gt;
 EC=&lt;br /&gt;
 A;&lt;br /&gt;
 ********************&lt;br /&gt;
 FA=&lt;br /&gt;
 F;Foto Ausbau ~FA~&lt;br /&gt;
 FN=&lt;br /&gt;
 F;Foto Einbau ~FN~&lt;br /&gt;
 FH=&lt;br /&gt;
 F;Foto Anlage ~FH~&lt;br /&gt;
&lt;br /&gt;
== Beispiel 2 ==&lt;br /&gt;
&lt;br /&gt;
 %set BARCODE_TYPE CODE_128,CODE_39&lt;br /&gt;
 #&lt;br /&gt;
 # Elektro-Protokoll 1.0&lt;br /&gt;
 # vom 19.04.2013, AF&lt;br /&gt;
 #&lt;br /&gt;
 Korrektur der Ausbau-Zählernummer&lt;br /&gt;
 11=&lt;br /&gt;
 N;&lt;br /&gt;
 Stand des Ausbau-Zählers&lt;br /&gt;
 14=&lt;br /&gt;
 D;&lt;br /&gt;
 NT-Stand des Ausbau-Zählers&lt;br /&gt;
 NA=&lt;br /&gt;
 D;&lt;br /&gt;
 --&lt;br /&gt;
 Nummer des Einbau-Zählers&lt;br /&gt;
 12=&lt;br /&gt;
 N;&lt;br /&gt;
 S;Barcode ~12~&lt;br /&gt;
 Stand des Einbau-Zählers&lt;br /&gt;
 13=&lt;br /&gt;
 D;&lt;br /&gt;
 NT-Stand des Einbau-Zählers&lt;br /&gt;
 NN=&lt;br /&gt;
 D;&lt;br /&gt;
 --&lt;br /&gt;
 Vergebliche Besuche (2 eingeben für jetzt)&lt;br /&gt;
 V1=&lt;br /&gt;
 A;&lt;br /&gt;
 V2=&lt;br /&gt;
 A;&lt;br /&gt;
 V3=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 Bemerkungen&lt;br /&gt;
 I3=&lt;br /&gt;
 A;&lt;br /&gt;
 I4=&lt;br /&gt;
 A;&lt;br /&gt;
 I5=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 wichtige Hinweise&lt;br /&gt;
 I6=&lt;br /&gt;
 A;&lt;br /&gt;
 I7=&lt;br /&gt;
 A;&lt;br /&gt;
 I8=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 Hinweise Buero&lt;br /&gt;
 B1=&lt;br /&gt;
 A;&lt;br /&gt;
 B2=&lt;br /&gt;
 A;&lt;br /&gt;
 B3=&lt;br /&gt;
 A;&lt;br /&gt;
 --&lt;br /&gt;
 FA=&lt;br /&gt;
 F;Foto Ausbau ~FA~&lt;br /&gt;
 FN=&lt;br /&gt;
 F;Foto Einbau ~FN~&lt;br /&gt;
&lt;br /&gt;
== Beispiel 3 ==&lt;br /&gt;
&lt;br /&gt;
  %set BARCODE_TYPE CODE_128&lt;br /&gt;
  #&lt;br /&gt;
  # Hermesdorf 2020-05-07&lt;br /&gt;
  #&lt;br /&gt;
  (Zählerwechsel&lt;br /&gt;
  Korrektur der Ausbau-Zählernummer&lt;br /&gt;
  11=&lt;br /&gt;
  A;&lt;br /&gt;
  Ausbau 1.8.0&lt;br /&gt;
  14=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 1.8.1&lt;br /&gt;
  A181=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 1.8.2&lt;br /&gt;
  NA=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 2.8.0&lt;br /&gt;
  A280=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 2.8.1&lt;br /&gt;
  A281=&lt;br /&gt;
  D;&lt;br /&gt;
  Ausbau 2.8.2&lt;br /&gt;
  A282=&lt;br /&gt;
  D;&lt;br /&gt;
  --&lt;br /&gt;
  Nummer des Einbau-Zählers&lt;br /&gt;
  12=&lt;br /&gt;
  A;&lt;br /&gt;
  S;Barcode ~12~&lt;br /&gt;
  Einbau 1.8.0&lt;br /&gt;
  13=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 1.8.1&lt;br /&gt;
  E181=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 1.8.2&lt;br /&gt;
  NN=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 2.8.0&lt;br /&gt;
  E280=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 2.8.1&lt;br /&gt;
  E281=&lt;br /&gt;
  D;&lt;br /&gt;
  Einbau 2.8.2&lt;br /&gt;
  E282=&lt;br /&gt;
  D;&lt;br /&gt;
  )&lt;br /&gt;
  #&lt;br /&gt;
  --&lt;br /&gt;
  weitere Protokoll Eintragungen&lt;br /&gt;
  --&lt;br /&gt;
  Vergebliche Besuche (2 eingeben für jetzt)&lt;br /&gt;
  V1=&lt;br /&gt;
  A;&lt;br /&gt;
  V2=&lt;br /&gt;
  A;&lt;br /&gt;
  V3=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  Bemerkungen&lt;br /&gt;
  I3=&lt;br /&gt;
  A;&lt;br /&gt;
  I4=&lt;br /&gt;
  A;&lt;br /&gt;
  I5=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  wichtige Hinweise&lt;br /&gt;
  I6=&lt;br /&gt;
  A;&lt;br /&gt;
  I7=&lt;br /&gt;
  A;&lt;br /&gt;
  I8=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  Hinweise Buero&lt;br /&gt;
  B1=&lt;br /&gt;
  A;&lt;br /&gt;
  B2=&lt;br /&gt;
  A;&lt;br /&gt;
  B3=&lt;br /&gt;
  A;&lt;br /&gt;
  --&lt;br /&gt;
  FA=&lt;br /&gt;
  F;Foto Ausbau 1.8.0 -FA- ~FA~&lt;br /&gt;
  FB=&lt;br /&gt;
  F;Foto Ausbau 1.8.1 ~FB~&lt;br /&gt;
  FC=&lt;br /&gt;
  F;Foto Ausbau 1.8.2 ~FC~&lt;br /&gt;
  FD=&lt;br /&gt;
  F;Foto Ausbau 2.8.0 ~FD~&lt;br /&gt;
  FF=&lt;br /&gt;
  F;Foto Ausbau 2.8.1 ~FF~&lt;br /&gt;
  FG=&lt;br /&gt;
  F;Foto Ausbau 2.8.2 ~FG~&lt;br /&gt;
  FN=&lt;br /&gt;
  F;Foto Einbau 1.8.0 -FN- ~FN~&lt;br /&gt;
  FM=&lt;br /&gt;
  F;Foto Einbau 1.8.1 ~FM~&lt;br /&gt;
  FO=&lt;br /&gt;
  F;Foto Einbau 1.8.2 ~FO~&lt;br /&gt;
  FP=&lt;br /&gt;
  F;Foto Einbau 2.8.0 ~FP~&lt;br /&gt;
  FQ=&lt;br /&gt;
  F;Foto Einbau 2.8.1 ~FQ~&lt;br /&gt;
  FR=&lt;br /&gt;
  F;Foto Einbau 2.8.2 ~FR~&lt;br /&gt;
  FH=&lt;br /&gt;
  F;Foto Hausanschlusskasten ~FH~&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.git&amp;diff=33414</id>
		<title>Linux.git</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.git&amp;diff=33414"/>
		<updated>2026-07-07T17:47:58Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Einrichten der Entwicklungsumgebung */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Dieses Mini-Howto soll erklären was man als Entwickler auf der Kommandozeile seines Systems tun muss um seinen Quelltext auf github zu aktualisieren&lt;br /&gt;
&lt;br /&gt;
== Einrichten der Entwicklungsumgebung ==&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Sorry alle Schritte nur so aus dem Kopf - beim nächsten Mal kontrolliere ich diese Einträge / versprochen.&lt;br /&gt;
 #&lt;br /&gt;
 git config --global user.email &amp;quot;andreas.filsinger@orgamon.org&amp;quot;&lt;br /&gt;
 git config --global user.name &amp;quot;Andreas Filsinger&amp;quot;&lt;br /&gt;
 git clone &amp;lt;dein Repo&amp;gt;&lt;br /&gt;
 on github: enable 2 Factor Autentification &lt;br /&gt;
 local: generate a key&lt;br /&gt;
 ssh-keygen -t ed25519 -C &amp;quot;andreas.filsinger@orgamon.org&amp;quot;&lt;br /&gt;
 on github: store the .pub-Part Key in github &amp;quot;SSH Keys save&amp;quot;&lt;br /&gt;
 local: login in github&lt;br /&gt;
  ssh -T git@github.com&lt;br /&gt;
 say &amp;quot;yes&amp;quot;&lt;br /&gt;
 change the origin of the git&lt;br /&gt;
 git remote set-url origin git@github.com:Andreas-Filsinger/Polyzalos.git&lt;br /&gt;
&lt;br /&gt;
== Daily Driver ==&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # [optional] Check whats you updated today&lt;br /&gt;
 #&lt;br /&gt;
 git status&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # [optional] Add new Files&lt;br /&gt;
 #&lt;br /&gt;
 git add {Path|File}&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # Send your updated Files &lt;br /&gt;
 #&lt;br /&gt;
 git add -u&lt;br /&gt;
 git commit -m &amp;quot;Describe todays Work&amp;quot;&lt;br /&gt;
 git push&lt;br /&gt;
&lt;br /&gt;
== Tag it ==&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # Sample for set a tag &amp;quot;9.004&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 git tag -a 9.004 -m &amp;quot;Rev. 9.004 - 04.03.2026&amp;quot;&lt;br /&gt;
 git push origin 9.004&lt;br /&gt;
&lt;br /&gt;
== Remove private File ==&lt;br /&gt;
&lt;br /&gt;
* private in a sense that is has not a secret but is useless for cloners&lt;br /&gt;
&lt;br /&gt;
# Make a copy outside the git&lt;br /&gt;
# Remove the file from git&lt;br /&gt;
# Add the File to gitignore&lt;br /&gt;
# Put back the copy&lt;br /&gt;
&lt;br /&gt;
 cp Polyzalos.lps ..&lt;br /&gt;
 git rm Polyzalos.lps&lt;br /&gt;
 git commit -m &amp;quot;remove Polyzalos.lps&amp;quot;&lt;br /&gt;
 git push&lt;br /&gt;
 touch .gitignore&lt;br /&gt;
 nano .gitignore&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;i&amp;gt;File .gitignore:&amp;lt;/i&amp;gt;&amp;lt;b&amp;gt;&lt;br /&gt;
 #&lt;br /&gt;
 # IDE positions / watches / breakpoints&lt;br /&gt;
 #&lt;br /&gt;
 Polyzalos.lps &lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # App&lt;br /&gt;
 #&lt;br /&gt;
 Polyzalos&lt;br /&gt;
 &amp;lt;/b&amp;gt;&lt;br /&gt;
 git add .gitignore&lt;br /&gt;
 git commit -m &amp;quot;initial .gitignore&amp;quot;&lt;br /&gt;
 git push&lt;br /&gt;
 cp ../Polyzalos.lps .&lt;br /&gt;
 git status&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33412</id>
		<title>Linux.mqtt</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33412"/>
		<updated>2026-07-03T17:24:06Z</updated>

		<summary type="html">&lt;p&gt;Root: /* mosquitto */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Geräte ==&lt;br /&gt;
&lt;br /&gt;
=== Shelly Temperatur &amp;amp; Luftfeuchtigkeit ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellyhtg3-543204567354/status/humidity:0&lt;br /&gt;
 mosquitto_sub -v -t shellyhtg3-543204567354/status/humidity:0 &amp;gt;&amp;gt;/var/log/mosquitto/humidity.log &amp;amp;&lt;br /&gt;
&lt;br /&gt;
=== Shelly Stromzähler ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
&lt;br /&gt;
==== per RPC den Energy Verbrauch auslesen ====&lt;br /&gt;
&lt;br /&gt;
 http://192.168.115.115/rpc/Shelly.GetStatus &lt;br /&gt;
 http://192.168.115.115/rpc/KVS.List&lt;br /&gt;
&lt;br /&gt;
 {&lt;br /&gt;
  &amp;quot;ble&amp;quot;:{},&lt;br /&gt;
  &amp;quot;bthome&amp;quot;:{ &lt;br /&gt;
    &amp;quot;errors&amp;quot;:[&amp;quot;observer_disabled&amp;quot;]},&lt;br /&gt;
  &amp;quot;cloud&amp;quot;:{&amp;quot;connected&amp;quot;:true},&lt;br /&gt;
  &amp;quot;mqtt&amp;quot;:{&amp;quot;connected&amp;quot;:false},&lt;br /&gt;
  &amp;quot;pm1:0&amp;quot;:{&lt;br /&gt;
    &amp;quot;id&amp;quot;:0, &lt;br /&gt;
    &amp;quot;voltage&amp;quot;:237.4, &lt;br /&gt;
    &amp;quot;current&amp;quot;:0.679, &lt;br /&gt;
    &amp;quot;apower&amp;quot;:96.0 ,&lt;br /&gt;
    &amp;quot;freq&amp;quot;:50.0,&lt;br /&gt;
    &amp;quot;aenergy&amp;quot;:{&lt;br /&gt;
      &amp;quot;total&amp;quot;:88939.057,  // &amp;lt;b&amp;gt;88,939057 kWh&amp;lt;/b&amp;gt;&lt;br /&gt;
      &amp;quot;by_minute&amp;quot;: [1654.950,1654.950,1448.081],&lt;br /&gt;
      &amp;quot;minute_ts&amp;quot;:1730759340},&lt;br /&gt;
    &amp;quot;ret_aenergy&amp;quot;:{&amp;quot;total&amp;quot;:0.000,&amp;quot;by_minute&amp;quot;:[0.000,0.000,0.000],&amp;quot;minute_ts&amp;quot;:1730759340}},&lt;br /&gt;
  &amp;quot;sys&amp;quot;: { &lt;br /&gt;
   &amp;quot;mac&amp;quot;:&amp;quot;84FCE638C62C&amp;quot;,&lt;br /&gt;
   &amp;quot;restart_required&amp;quot;:false,&lt;br /&gt;
   &amp;quot;time&amp;quot;:&amp;quot;23:29&amp;quot;,&lt;br /&gt;
   &amp;quot;unixtime&amp;quot;:1730759397,&lt;br /&gt;
   &amp;quot;uptime&amp;quot;:952959,&amp;quot;ram_size&amp;quot;:260232,&amp;quot;ram_free&amp;quot;:85864,&amp;quot;fs_size&amp;quot;:1048576,&amp;quot;fs_free&amp;quot;:606208,&amp;quot;cfg_rev&amp;quot;:13,&amp;quot;kvs_rev&amp;quot;:0,&amp;quot;schedule_rev&amp;quot;:0,&amp;quot;webhook_rev&amp;quot;:2,&amp;quot;avail able_updates&amp;quot;:{},&amp;quot;reset_reason&amp;quot;:3},&lt;br /&gt;
   &amp;quot;wifi&amp;quot;:{&amp;quot;sta_ip&amp;quot;:&amp;quot;192.168.115.115&amp;quot;,&amp;quot;status&amp;quot;:&amp;quot;got ip&amp;quot;,&amp;quot;ssid&amp;quot;:&amp;quot;OrgaMon&amp;quot;,&amp;quot;rssi&amp;quot;:-39},&lt;br /&gt;
   &amp;quot;ws&amp;quot;:{&amp;quot;connected&amp;quot;:false}}&lt;br /&gt;
&lt;br /&gt;
* der Wert pm1:0:aenergy:total ist &lt;br /&gt;
** Unsicher: nicht stromausfall fest, also wenn der Strom am Shelly ausfällt ist der Wert wieder &amp;quot;0&amp;quot;&lt;br /&gt;
** Unsicher: ist Firmware-Update fest?&lt;br /&gt;
** Unsicher: ist Gerät-Neustart fest?&lt;br /&gt;
&lt;br /&gt;
== mosquitto ==&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # a MQTT broker is a 24/7 message relay/örtöö for topics&lt;br /&gt;
 # it is not a database, the broker duplicates messages for all subscribers&lt;br /&gt;
 # you can ask if you get notified if a topic of your interest changes (=&amp;quot;subscribe&amp;quot;)&lt;br /&gt;
 # you can send out a message (=&amp;quot;publish&amp;quot;) so all subscribers get it&lt;br /&gt;
 # The Broker is not persistent so values from &amp;quot;missed&amp;quot; messages can not be retrieved&lt;br /&gt;
 # But, if a Client publish a value with a &amp;quot;retain&amp;quot;-Flag the Broker hold the value for a time&lt;br /&gt;
 # after the publish by system A, if a client system B is a bit late - still unconnected, in the moment subscribing &lt;br /&gt;
 # to a retained message, system B gets the last known value stored by the broker. System B so &lt;br /&gt;
 # must not wait for the next live value, wich maybe come in minutes or hours&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* installation&lt;br /&gt;
&lt;br /&gt;
 apt install mosquitto&lt;br /&gt;
&lt;br /&gt;
* /etc/mosquitto/mosquitto.conf erweitern:&lt;br /&gt;
&lt;br /&gt;
 allow_anonymous false&lt;br /&gt;
 password_file /etc/mosquitto/passwd&lt;br /&gt;
 listener 1883 0.0.0.0&lt;br /&gt;
&lt;br /&gt;
* user anlegen&lt;br /&gt;
&lt;br /&gt;
 mosquitto_passwd -c -b /etc/mosquitto/passwd &amp;lt;i&amp;gt;user&amp;lt;/i&amp;gt; &amp;lt;i&amp;gt;password&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* neustart&lt;br /&gt;
&lt;br /&gt;
 systemctl restart mosquitto&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33411</id>
		<title>Linux.mqtt</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33411"/>
		<updated>2026-07-03T17:22:32Z</updated>

		<summary type="html">&lt;p&gt;Root: /* mosquitto */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Geräte ==&lt;br /&gt;
&lt;br /&gt;
=== Shelly Temperatur &amp;amp; Luftfeuchtigkeit ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellyhtg3-543204567354/status/humidity:0&lt;br /&gt;
 mosquitto_sub -v -t shellyhtg3-543204567354/status/humidity:0 &amp;gt;&amp;gt;/var/log/mosquitto/humidity.log &amp;amp;&lt;br /&gt;
&lt;br /&gt;
=== Shelly Stromzähler ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
&lt;br /&gt;
==== per RPC den Energy Verbrauch auslesen ====&lt;br /&gt;
&lt;br /&gt;
 http://192.168.115.115/rpc/Shelly.GetStatus &lt;br /&gt;
 http://192.168.115.115/rpc/KVS.List&lt;br /&gt;
&lt;br /&gt;
 {&lt;br /&gt;
  &amp;quot;ble&amp;quot;:{},&lt;br /&gt;
  &amp;quot;bthome&amp;quot;:{ &lt;br /&gt;
    &amp;quot;errors&amp;quot;:[&amp;quot;observer_disabled&amp;quot;]},&lt;br /&gt;
  &amp;quot;cloud&amp;quot;:{&amp;quot;connected&amp;quot;:true},&lt;br /&gt;
  &amp;quot;mqtt&amp;quot;:{&amp;quot;connected&amp;quot;:false},&lt;br /&gt;
  &amp;quot;pm1:0&amp;quot;:{&lt;br /&gt;
    &amp;quot;id&amp;quot;:0, &lt;br /&gt;
    &amp;quot;voltage&amp;quot;:237.4, &lt;br /&gt;
    &amp;quot;current&amp;quot;:0.679, &lt;br /&gt;
    &amp;quot;apower&amp;quot;:96.0 ,&lt;br /&gt;
    &amp;quot;freq&amp;quot;:50.0,&lt;br /&gt;
    &amp;quot;aenergy&amp;quot;:{&lt;br /&gt;
      &amp;quot;total&amp;quot;:88939.057,  // &amp;lt;b&amp;gt;88,939057 kWh&amp;lt;/b&amp;gt;&lt;br /&gt;
      &amp;quot;by_minute&amp;quot;: [1654.950,1654.950,1448.081],&lt;br /&gt;
      &amp;quot;minute_ts&amp;quot;:1730759340},&lt;br /&gt;
    &amp;quot;ret_aenergy&amp;quot;:{&amp;quot;total&amp;quot;:0.000,&amp;quot;by_minute&amp;quot;:[0.000,0.000,0.000],&amp;quot;minute_ts&amp;quot;:1730759340}},&lt;br /&gt;
  &amp;quot;sys&amp;quot;: { &lt;br /&gt;
   &amp;quot;mac&amp;quot;:&amp;quot;84FCE638C62C&amp;quot;,&lt;br /&gt;
   &amp;quot;restart_required&amp;quot;:false,&lt;br /&gt;
   &amp;quot;time&amp;quot;:&amp;quot;23:29&amp;quot;,&lt;br /&gt;
   &amp;quot;unixtime&amp;quot;:1730759397,&lt;br /&gt;
   &amp;quot;uptime&amp;quot;:952959,&amp;quot;ram_size&amp;quot;:260232,&amp;quot;ram_free&amp;quot;:85864,&amp;quot;fs_size&amp;quot;:1048576,&amp;quot;fs_free&amp;quot;:606208,&amp;quot;cfg_rev&amp;quot;:13,&amp;quot;kvs_rev&amp;quot;:0,&amp;quot;schedule_rev&amp;quot;:0,&amp;quot;webhook_rev&amp;quot;:2,&amp;quot;avail able_updates&amp;quot;:{},&amp;quot;reset_reason&amp;quot;:3},&lt;br /&gt;
   &amp;quot;wifi&amp;quot;:{&amp;quot;sta_ip&amp;quot;:&amp;quot;192.168.115.115&amp;quot;,&amp;quot;status&amp;quot;:&amp;quot;got ip&amp;quot;,&amp;quot;ssid&amp;quot;:&amp;quot;OrgaMon&amp;quot;,&amp;quot;rssi&amp;quot;:-39},&lt;br /&gt;
   &amp;quot;ws&amp;quot;:{&amp;quot;connected&amp;quot;:false}}&lt;br /&gt;
&lt;br /&gt;
* der Wert pm1:0:aenergy:total ist &lt;br /&gt;
** Unsicher: nicht stromausfall fest, also wenn der Strom am Shelly ausfällt ist der Wert wieder &amp;quot;0&amp;quot;&lt;br /&gt;
** Unsicher: ist Firmware-Update fest?&lt;br /&gt;
** Unsicher: ist Gerät-Neustart fest?&lt;br /&gt;
&lt;br /&gt;
== mosquitto ==&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # a MQTT broker is a 24/7 message relay/örtöö for topics&lt;br /&gt;
 # it is not a database, the broker duplicates messages for all subscribers&lt;br /&gt;
 # you can ask if you get notified if a topic of your interest changes (=&amp;quot;subscribe&amp;quot;)&lt;br /&gt;
 # you can send out a message (=&amp;quot;publish&amp;quot;) so all subscribers get it&lt;br /&gt;
 # The Broker is not persistent so values from &amp;quot;missed&amp;quot; messages can not be retrieved&lt;br /&gt;
 # But, if a Client publish a value with a &amp;quot;retain&amp;quot;-Flag the Broker hold the value for a time&lt;br /&gt;
 # after the publish by system A, if a client system B is a bit late - still unconnected, in the moment subscribing &lt;br /&gt;
 # to a ratained message, system B gets the last known value stored by the broker. system B so &lt;br /&gt;
 # must not wait for the next value, wich maybe come in minutes or hours&lt;br /&gt;
 #&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* installation&lt;br /&gt;
&lt;br /&gt;
 apt install mosquitto&lt;br /&gt;
&lt;br /&gt;
* /etc/mosquitto/mosquitto.conf erweitern:&lt;br /&gt;
&lt;br /&gt;
 allow_anonymous false&lt;br /&gt;
 password_file /etc/mosquitto/passwd&lt;br /&gt;
 listener 1883 0.0.0.0&lt;br /&gt;
&lt;br /&gt;
* user anlegen&lt;br /&gt;
&lt;br /&gt;
 mosquitto_passwd -c -b /etc/mosquitto/passwd &amp;lt;i&amp;gt;user&amp;lt;/i&amp;gt; &amp;lt;i&amp;gt;password&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* neustart&lt;br /&gt;
&lt;br /&gt;
 systemctl restart mosquitto&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33410</id>
		<title>Linux.mqtt</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33410"/>
		<updated>2026-07-03T17:19:49Z</updated>

		<summary type="html">&lt;p&gt;Root: /* mosquitto */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Geräte ==&lt;br /&gt;
&lt;br /&gt;
=== Shelly Temperatur &amp;amp; Luftfeuchtigkeit ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellyhtg3-543204567354/status/humidity:0&lt;br /&gt;
 mosquitto_sub -v -t shellyhtg3-543204567354/status/humidity:0 &amp;gt;&amp;gt;/var/log/mosquitto/humidity.log &amp;amp;&lt;br /&gt;
&lt;br /&gt;
=== Shelly Stromzähler ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
&lt;br /&gt;
==== per RPC den Energy Verbrauch auslesen ====&lt;br /&gt;
&lt;br /&gt;
 http://192.168.115.115/rpc/Shelly.GetStatus &lt;br /&gt;
 http://192.168.115.115/rpc/KVS.List&lt;br /&gt;
&lt;br /&gt;
 {&lt;br /&gt;
  &amp;quot;ble&amp;quot;:{},&lt;br /&gt;
  &amp;quot;bthome&amp;quot;:{ &lt;br /&gt;
    &amp;quot;errors&amp;quot;:[&amp;quot;observer_disabled&amp;quot;]},&lt;br /&gt;
  &amp;quot;cloud&amp;quot;:{&amp;quot;connected&amp;quot;:true},&lt;br /&gt;
  &amp;quot;mqtt&amp;quot;:{&amp;quot;connected&amp;quot;:false},&lt;br /&gt;
  &amp;quot;pm1:0&amp;quot;:{&lt;br /&gt;
    &amp;quot;id&amp;quot;:0, &lt;br /&gt;
    &amp;quot;voltage&amp;quot;:237.4, &lt;br /&gt;
    &amp;quot;current&amp;quot;:0.679, &lt;br /&gt;
    &amp;quot;apower&amp;quot;:96.0 ,&lt;br /&gt;
    &amp;quot;freq&amp;quot;:50.0,&lt;br /&gt;
    &amp;quot;aenergy&amp;quot;:{&lt;br /&gt;
      &amp;quot;total&amp;quot;:88939.057,  // &amp;lt;b&amp;gt;88,939057 kWh&amp;lt;/b&amp;gt;&lt;br /&gt;
      &amp;quot;by_minute&amp;quot;: [1654.950,1654.950,1448.081],&lt;br /&gt;
      &amp;quot;minute_ts&amp;quot;:1730759340},&lt;br /&gt;
    &amp;quot;ret_aenergy&amp;quot;:{&amp;quot;total&amp;quot;:0.000,&amp;quot;by_minute&amp;quot;:[0.000,0.000,0.000],&amp;quot;minute_ts&amp;quot;:1730759340}},&lt;br /&gt;
  &amp;quot;sys&amp;quot;: { &lt;br /&gt;
   &amp;quot;mac&amp;quot;:&amp;quot;84FCE638C62C&amp;quot;,&lt;br /&gt;
   &amp;quot;restart_required&amp;quot;:false,&lt;br /&gt;
   &amp;quot;time&amp;quot;:&amp;quot;23:29&amp;quot;,&lt;br /&gt;
   &amp;quot;unixtime&amp;quot;:1730759397,&lt;br /&gt;
   &amp;quot;uptime&amp;quot;:952959,&amp;quot;ram_size&amp;quot;:260232,&amp;quot;ram_free&amp;quot;:85864,&amp;quot;fs_size&amp;quot;:1048576,&amp;quot;fs_free&amp;quot;:606208,&amp;quot;cfg_rev&amp;quot;:13,&amp;quot;kvs_rev&amp;quot;:0,&amp;quot;schedule_rev&amp;quot;:0,&amp;quot;webhook_rev&amp;quot;:2,&amp;quot;avail able_updates&amp;quot;:{},&amp;quot;reset_reason&amp;quot;:3},&lt;br /&gt;
   &amp;quot;wifi&amp;quot;:{&amp;quot;sta_ip&amp;quot;:&amp;quot;192.168.115.115&amp;quot;,&amp;quot;status&amp;quot;:&amp;quot;got ip&amp;quot;,&amp;quot;ssid&amp;quot;:&amp;quot;OrgaMon&amp;quot;,&amp;quot;rssi&amp;quot;:-39},&lt;br /&gt;
   &amp;quot;ws&amp;quot;:{&amp;quot;connected&amp;quot;:false}}&lt;br /&gt;
&lt;br /&gt;
* der Wert pm1:0:aenergy:total ist &lt;br /&gt;
** Unsicher: nicht stromausfall fest, also wenn der Strom am Shelly ausfällt ist der Wert wieder &amp;quot;0&amp;quot;&lt;br /&gt;
** Unsicher: ist Firmware-Update fest?&lt;br /&gt;
** Unsicher: ist Gerät-Neustart fest?&lt;br /&gt;
&lt;br /&gt;
== mosquitto ==&lt;br /&gt;
&lt;br /&gt;
* installation&lt;br /&gt;
&lt;br /&gt;
 apt install mosquitto&lt;br /&gt;
&lt;br /&gt;
* /etc/mosquitto/mosquitto.conf erweitern:&lt;br /&gt;
&lt;br /&gt;
 allow_anonymous false&lt;br /&gt;
 password_file /etc/mosquitto/passwd&lt;br /&gt;
 listener 1883 0.0.0.0&lt;br /&gt;
&lt;br /&gt;
* user anlegen&lt;br /&gt;
&lt;br /&gt;
 mosquitto_passwd -c -b /etc/mosquitto/passwd &amp;lt;i&amp;gt;user&amp;lt;/i&amp;gt; &amp;lt;i&amp;gt;password&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* neustart&lt;br /&gt;
&lt;br /&gt;
 systemctl restart mosquitto&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33409</id>
		<title>Linux.mqtt</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.mqtt&amp;diff=33409"/>
		<updated>2026-07-03T17:19:07Z</updated>

		<summary type="html">&lt;p&gt;Root: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Geräte ==&lt;br /&gt;
&lt;br /&gt;
=== Shelly Temperatur &amp;amp; Luftfeuchtigkeit ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellyhtg3-543204567354/status/humidity:0&lt;br /&gt;
 mosquitto_sub -v -t shellyhtg3-543204567354/status/humidity:0 &amp;gt;&amp;gt;/var/log/mosquitto/humidity.log &amp;amp;&lt;br /&gt;
&lt;br /&gt;
=== Shelly Stromzähler ===&lt;br /&gt;
&lt;br /&gt;
 mosquitto_sub -t shellypmminig3-84fce638c62c/status/pm1:0&lt;br /&gt;
&lt;br /&gt;
==== per RPC den Energy Verbrauch auslesen ====&lt;br /&gt;
&lt;br /&gt;
 http://192.168.115.115/rpc/Shelly.GetStatus &lt;br /&gt;
 http://192.168.115.115/rpc/KVS.List&lt;br /&gt;
&lt;br /&gt;
 {&lt;br /&gt;
  &amp;quot;ble&amp;quot;:{},&lt;br /&gt;
  &amp;quot;bthome&amp;quot;:{ &lt;br /&gt;
    &amp;quot;errors&amp;quot;:[&amp;quot;observer_disabled&amp;quot;]},&lt;br /&gt;
  &amp;quot;cloud&amp;quot;:{&amp;quot;connected&amp;quot;:true},&lt;br /&gt;
  &amp;quot;mqtt&amp;quot;:{&amp;quot;connected&amp;quot;:false},&lt;br /&gt;
  &amp;quot;pm1:0&amp;quot;:{&lt;br /&gt;
    &amp;quot;id&amp;quot;:0, &lt;br /&gt;
    &amp;quot;voltage&amp;quot;:237.4, &lt;br /&gt;
    &amp;quot;current&amp;quot;:0.679, &lt;br /&gt;
    &amp;quot;apower&amp;quot;:96.0 ,&lt;br /&gt;
    &amp;quot;freq&amp;quot;:50.0,&lt;br /&gt;
    &amp;quot;aenergy&amp;quot;:{&lt;br /&gt;
      &amp;quot;total&amp;quot;:88939.057,  // &amp;lt;b&amp;gt;88,939057 kWh&amp;lt;/b&amp;gt;&lt;br /&gt;
      &amp;quot;by_minute&amp;quot;: [1654.950,1654.950,1448.081],&lt;br /&gt;
      &amp;quot;minute_ts&amp;quot;:1730759340},&lt;br /&gt;
    &amp;quot;ret_aenergy&amp;quot;:{&amp;quot;total&amp;quot;:0.000,&amp;quot;by_minute&amp;quot;:[0.000,0.000,0.000],&amp;quot;minute_ts&amp;quot;:1730759340}},&lt;br /&gt;
  &amp;quot;sys&amp;quot;: { &lt;br /&gt;
   &amp;quot;mac&amp;quot;:&amp;quot;84FCE638C62C&amp;quot;,&lt;br /&gt;
   &amp;quot;restart_required&amp;quot;:false,&lt;br /&gt;
   &amp;quot;time&amp;quot;:&amp;quot;23:29&amp;quot;,&lt;br /&gt;
   &amp;quot;unixtime&amp;quot;:1730759397,&lt;br /&gt;
   &amp;quot;uptime&amp;quot;:952959,&amp;quot;ram_size&amp;quot;:260232,&amp;quot;ram_free&amp;quot;:85864,&amp;quot;fs_size&amp;quot;:1048576,&amp;quot;fs_free&amp;quot;:606208,&amp;quot;cfg_rev&amp;quot;:13,&amp;quot;kvs_rev&amp;quot;:0,&amp;quot;schedule_rev&amp;quot;:0,&amp;quot;webhook_rev&amp;quot;:2,&amp;quot;avail able_updates&amp;quot;:{},&amp;quot;reset_reason&amp;quot;:3},&lt;br /&gt;
   &amp;quot;wifi&amp;quot;:{&amp;quot;sta_ip&amp;quot;:&amp;quot;192.168.115.115&amp;quot;,&amp;quot;status&amp;quot;:&amp;quot;got ip&amp;quot;,&amp;quot;ssid&amp;quot;:&amp;quot;OrgaMon&amp;quot;,&amp;quot;rssi&amp;quot;:-39},&lt;br /&gt;
   &amp;quot;ws&amp;quot;:{&amp;quot;connected&amp;quot;:false}}&lt;br /&gt;
&lt;br /&gt;
* der Wert pm1:0:aenergy:total ist &lt;br /&gt;
** Unsicher: nicht stromausfall fest, also wenn der Strom am Shelly ausfällt ist der Wert wieder &amp;quot;0&amp;quot;&lt;br /&gt;
** Unsicher: ist Firmware-Update fest?&lt;br /&gt;
** Unsicher: ist Gerät-Neustart fest?&lt;br /&gt;
&lt;br /&gt;
== mosquitto ==&lt;br /&gt;
&lt;br /&gt;
* installation&lt;br /&gt;
&lt;br /&gt;
 apt install mosquitto&lt;br /&gt;
&lt;br /&gt;
* /etc/mosquitto/mosquitto.conf erweitern:&lt;br /&gt;
&lt;br /&gt;
 allow_anonymous false&lt;br /&gt;
 password_file /etc/mosquitto/passwd&lt;br /&gt;
 listener 1883 0.0.0.0&lt;br /&gt;
&lt;br /&gt;
* user anlegen&lt;br /&gt;
&lt;br /&gt;
 mosquitto_passwd -c -b /etc/mosquitto/passwd &amp;lt;i&amp;gt;user&amp;lt;/i&amp;gt; &amp;lt;i&amp;gt;password&amp;lt;/i&amp;gt;&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Orgamon.net&amp;diff=33408</id>
		<title>Orgamon.net</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Orgamon.net&amp;diff=33408"/>
		<updated>2026-06-02T16:32:24Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Aktuelles */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Überblick ==&lt;br /&gt;
&lt;br /&gt;
*Die OrgaMon-App kontaktiert zum &amp;quot;senden&amp;quot; und &amp;quot;Start&amp;quot; jeweils den Domain &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net&amp;lt;/code&amp;gt; über https://- und FTPS://- Protokoll&lt;br /&gt;
**Es gibt ein Hauptzertifikat (für &amp;lt;code&amp;gt;cargobay.orgamon.net&amp;lt;/code&amp;gt;) sowie ihre Kopie davon, das Firmenzertifikat (für &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net&amp;lt;/code&amp;gt;)  &lt;br /&gt;
* Die Firmendomain wird mit einer festen IP-V4-Adresse verbunden, die IP-Adresse haben Sie bei der Beantragung des Subdomains &amp;lt;code&amp;gt;&amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;&amp;lt;/code&amp;gt; angegeben&lt;br /&gt;
**Auf dem Server mit dieser IP-Adresse muss das Firmenzertifikat installiert werden&lt;br /&gt;
* Für die Absicherung des Datenverkehrs muss auf Ihrem Server das *.orgamon.net Haupt-Zertifikat (als Kopie) installiert werden&lt;br /&gt;
* Dieses liegt auf dem bei Strato gemietetem Webserver &amp;quot;cargobay.orgamon.net&amp;quot; - auf dem auch dieses Wiki gehostet ist - für Sie zum Abruf bereit&lt;br /&gt;
** Das Zertifikat wird aus 3 Dateien gebildet:&lt;br /&gt;
** &amp;lt;code&amp;gt;cert.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;code&amp;gt;fullchain.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
** &amp;lt;code&amp;gt;privkey.pem&amp;lt;/code&amp;gt;&lt;br /&gt;
* Dieses ist immer für 3 Monate gültig und muss vor Ablauf aufgefrischt werden&lt;br /&gt;
* Das jeweils aktuelle Zertifikat ist auf dem Server &amp;quot;orgamon.net&amp;quot; gespeichert und kann von dort abgerufen werden&lt;br /&gt;
* Hier ist die Beschreibung wie Sie dieses Zertifikat herunterladen und auf Ihrem Server aktualisieren können:&lt;br /&gt;
**Zusammengefasst ist die &amp;quot;Installation&amp;quot; eine 1:1 Kopie des Hauptzertifikates auf Ihr System&lt;br /&gt;
&lt;br /&gt;
== Wann läuft das aktuelle Haupt-Zertifikat ab ? ==&lt;br /&gt;
* Anzeigen des ganzen Zertifikates im Browser&lt;br /&gt;
&lt;br /&gt;
 https://cargobay.orgamon.net/&lt;br /&gt;
&lt;br /&gt;
* Firefox: links neben der URL auf das Schlosssymbol klicken&lt;br /&gt;
** Verbindung sicher&lt;br /&gt;
** weitere Informationen&lt;br /&gt;
** Zertifikat anzeigen&lt;br /&gt;
&lt;br /&gt;
* Chrome: links neben der URL auf das Schieberegler-Symbol klicken&lt;br /&gt;
** Verbindung ist sicher&lt;br /&gt;
** Zertifikat ist gültig&lt;br /&gt;
&lt;br /&gt;
* Das Zertifikat auf &amp;quot;orgamon.net&amp;quot; wird in der Regel frühestens 20 Tage vor dem Ablauf aber spätestens 10 Tage vor dem Ablauf erneuert&lt;br /&gt;
&lt;br /&gt;
== Update ==&lt;br /&gt;
&lt;br /&gt;
* Loggen Sie sich mit Putty in Ihren OrgaMon-App-Server ein: &amp;amp;rarr;&amp;lt;code&amp;gt;Ticket&amp;lt;/code&amp;gt;&amp;amp;rarr;Reiter &amp;lt;code&amp;gt;Rechner&amp;lt;/code&amp;gt;&amp;amp;rarr;Klicken Sie auf Ihren OrgaMon-App-Linux-Server in der Liste&amp;amp;rarr;Symbol &amp;lt;i&amp;gt;schwarzer Schirm mit rot und grün&amp;lt;/i&amp;gt; (ssh root login via putty)&lt;br /&gt;
* Wechseln Sie auf ihrem OrgaMon-App-Server in das Verzeichnis /etc/nginx/orgamon.net&lt;br /&gt;
&lt;br /&gt;
 cd /etc/nginx/orgamon.net&lt;br /&gt;
&lt;br /&gt;
* Starten Sie das dortige Update Script&lt;br /&gt;
&lt;br /&gt;
 ./update.sh&lt;br /&gt;
&lt;br /&gt;
* Geben Sie nun 3 mal ein angefordertes Passwort ein, das Sie bei der Beantragung des Domains &amp;lt;i&amp;gt;firma&amp;lt;/i&amp;gt;.orgamon.net als &amp;quot;Zertifikat-Refresh-Passwort&amp;quot; erhalten haben (Es ist nicht Ihr &amp;quot;Firmenpasswort&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== Neustart von Diensten ===&lt;br /&gt;
&lt;br /&gt;
* Starten Sie nginx neu&lt;br /&gt;
&lt;br /&gt;
 systemctl restart nginx&lt;br /&gt;
&lt;br /&gt;
* Starten Sie vsftpd neu&lt;br /&gt;
&lt;br /&gt;
 systemctl restart vsftpd&lt;br /&gt;
&lt;br /&gt;
=== Prüfen ===&lt;br /&gt;
&lt;br /&gt;
* Anzeigen des Verfallsdatums des erhaltenen Zertifikates in der Kommandozeile&lt;br /&gt;
&lt;br /&gt;
 openssl x509 -enddate -noout -in cert.pem&lt;br /&gt;
&lt;br /&gt;
=== Ende ===&lt;br /&gt;
&lt;br /&gt;
 exit&lt;br /&gt;
&lt;br /&gt;
== Problemlösungen ==&lt;br /&gt;
&lt;br /&gt;
=== Vergessen das Firmenzertifikat zu aktualisieren ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Fehlermeldung Orgamob Zertifikatswechsel.jpg]]&lt;br /&gt;
&lt;br /&gt;
*Fehlermeldung nach dem Senden, wenn der Zertifikatswechsel nicht durchgeführt wurde: Handshake Exception &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Aktuelles == &lt;br /&gt;
&lt;br /&gt;
* durchgeführte Erneuerungen des Hauptzertifikates auf orgamon.net werden hier durch den Admin protokolliert. &lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|1=ändern Sie bitte hier nichts, das hat nichts mit Ihrer Zertifikatskopie zu tun, dafür sind Sie selbst verantwortlich}}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;02.06.2026: Nächster Ablauf des Zertifikates: 31.08.2026&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;09.03.2026: Nächster Ablauf des Zertifikates: 07.06.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;19.12.2025: Nächster Ablauf des Zertifikates: 18.03.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;08.10.2025: Nächster Ablauf des Zertifikates: 06.01.2026&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;10.07.2025: Nächster Ablauf des Zertifikates: 08.10.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;17.04.2025: Nächster Ablauf des Zertifikates: 16.07.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.02.2025: Nächster Ablauf des Zertifikates: 04.05.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;12.11.2024: Nächster Ablauf des Zertifikates: 10.02.2025&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;26.08.2024: Nächster Ablauf des Zertifikates: 24.11.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;02.06.2024: Nächster Ablauf des Zertifikates: 02.09.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;08.03.2024: Nächster Ablauf des Zertifikates: 06.06.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;21.12.2023: Nächster Ablauf des Zertifikates: 20.03.2024&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;29.09.2023: Nächster Ablauf des Zertifikates: 28.12.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;19.07.2023: Nächster Ablauf des Zertifikates: 17.10.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;15.06.2023: Nächster Ablauf des Zertifikates: 13.09.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.04.2023: Nächster Ablauf des Zertifikates: 01.07.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;21.01.2023: Nächster Ablauf des Zertifikates: 21.04.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;24.10.2022: Nächster Ablauf des Zertifikates: 22.01.2023&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;03.08.2022: Nächster Ablauf des Zertifikates: 01.11.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;23.05.2022: Nächster Ablauf des Zertifikates: 21.08.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;s&amp;gt;01.03.2022: Nächster Ablauf des Zertifikates: 30.05.2022&amp;lt;/s&amp;gt;&amp;lt;br&amp;gt;&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.postfix&amp;diff=33405</id>
		<title>Linux.postfix</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.postfix&amp;diff=33405"/>
		<updated>2026-04-28T17:24:01Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Diagnose Möglichkeiten */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Ziel ==&lt;br /&gt;
&lt;br /&gt;
* Kompletter Mail - Server, der von innen wie von aussen kontaktiert werden kann (via pop3,smtp). Er soll für mehrere Domain-Namen und noch mehr Benutzer (alle auf die eigene ServerIP gebunden) die Post verwalten und natürlich kein offenes Relay sein.&lt;br /&gt;
&lt;br /&gt;
== Voraussetzungen ==&lt;br /&gt;
&lt;br /&gt;
=== Feste IP ===&lt;br /&gt;
&lt;br /&gt;
* ein Linux Server mit fester IP Adresse. Meine, bei t-com bestellte feste IP ist z.B. &lt;br /&gt;
&lt;br /&gt;
  217.91.31.84&lt;br /&gt;
&lt;br /&gt;
* Du legst eine Domain auf diese IP, das nennen wir ab jetzt &amp;lt;MailAgentDomain&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== PTR Record ===&lt;br /&gt;
&lt;br /&gt;
* einen PTR Eintrag deiner IP Adresse, ab jetzt &amp;lt;ReverseHost&amp;gt; bezeichnet&lt;br /&gt;
&lt;br /&gt;
  host -t PTR &amp;lt;DeineFesteIP&amp;gt;&lt;br /&gt;
 &lt;br /&gt;
  # Bei mir ergibt das z.B. pd95b1f54.dip0.t-ipconnect.de&lt;br /&gt;
  # Leider ist es nicht möglich diesen Eintrag zu belassen, das einigen Mail Server, &lt;br /&gt;
  # so z.B. aol diese Art von Hostnamen so gar nicht mögen. Die meinen dann, man hätte&lt;br /&gt;
  # einen dynamische IP Adresse, und man versuche sich als Mailserver aufzuführen. Leider&lt;br /&gt;
  # löst der Ziel- Mailserver die Absender Domain nicht auf, sonst würde er erkennen&lt;br /&gt;
  # das die IP der Versende-Identität sowie die Identität des senders decken, also&lt;br /&gt;
  # offensichtlich kein relay verwendet wird. Meiner Meinung nach unberechtigt der&lt;br /&gt;
  # Ablehnende Fehlercode :&lt;br /&gt;
  #&lt;br /&gt;
  # 554-:  (DNS:B2) http://postmaster.info.aol.com/errors/554dnsb2.html&lt;br /&gt;
  #&lt;br /&gt;
  # Fehler 1)&lt;br /&gt;
  # &lt;br /&gt;
  # Bezieht man von der t-com eine feste IP, kommt die aus einem zweifelhaften pool,&lt;br /&gt;
  # man sollte diese mit einem schönen PTR Eintrag versehen, so z.B.&lt;br /&gt;
  # HSGWBSGA.t-com-festeip.de&lt;br /&gt;
  # dann müsste man keinen eigenen PTR Eintrag ersinnen. &lt;br /&gt;
  #&lt;br /&gt;
  # Fehler 2)&lt;br /&gt;
  #&lt;br /&gt;
  # &amp;quot;riecht&amp;quot; der PTR Eintrag nach dynamischer IP sollte die püfung der Versende&lt;br /&gt;
  # Identität erfolgen. Ist der A Eintrag wieder die selbe Adresse, so ist das ja&lt;br /&gt;
  # wohl mehr als Beweis, da die IP Adresse und PTR 100% OK ist.&lt;br /&gt;
  #&lt;br /&gt;
&lt;br /&gt;
=== MX Record ===&lt;br /&gt;
&lt;br /&gt;
* bei allen Domains die der Mailserver hosten soll, muss der ReverseHost von oben als der MX Eintrag gemacht sein. So bekommen wir einen ganz soliden MX Eintrag, der den neuesten Forderungen (PTR-fest) entspricht.&lt;br /&gt;
&lt;br /&gt;
  host -t MX &amp;lt;DeineMailDomain&amp;gt;&lt;br /&gt;
  &lt;br /&gt;
  # sollte als Ergebnis also pd95b1f54.dip0.t-ipconnect.de &lt;br /&gt;
  # ergeben!&lt;br /&gt;
&lt;br /&gt;
=== SPF Record ===&lt;br /&gt;
&lt;br /&gt;
* Es ist ein TXT Record in &amp;lt;DeineMailDomain&amp;gt; der aussagt WER zuständig für den ausgehenden Mailversand ist&lt;br /&gt;
* Es verbessert nicht die Anzahl der Spam-Mails, die Dich erreichen&lt;br /&gt;
* Es verbessert aber die Anzahl der Spam-Mails in der Welt, die als Absender &amp;lt;DeineMailDomain&amp;gt; missbrauchen, da Du hiermit erklärt hast, welche SendeServer Du benutzt. Alle anderen gelten als nicht berechtigt.&lt;br /&gt;
* In unserem Fall, ist der berechtigte unser MX, sonst niemand: &lt;br /&gt;
** &amp;lt;code&amp;gt;v=spf1 mx -all&amp;lt;/code&amp;gt;&lt;br /&gt;
* Test mit http://spf.myisp.ch/&lt;br /&gt;
&lt;br /&gt;
=== DKIM ===&lt;br /&gt;
&lt;br /&gt;
* https://kofler.info/dkim-konfiguration-fuer-postfix/&lt;br /&gt;
&lt;br /&gt;
=== DMARC ===&lt;br /&gt;
&lt;br /&gt;
* Typischer Snake-Oil Mechanismus der nur scheinbar die Sicherheit erhöht, der _dmarc TXT Record muss bei der Mail-Domain hinzugemacht werden, nicht bei der mx Domain&lt;br /&gt;
&lt;br /&gt;
* https://support.google.com/a/answer/2466563?sjid=13818195432106118449-EU&lt;br /&gt;
&lt;br /&gt;
 _dmarc   TXT    v=DMARC1; p=reject; rua=mailto:postmaster@orgamon.org&lt;br /&gt;
&lt;br /&gt;
== Aktivierung der notwendigen Dienste ==&lt;br /&gt;
&lt;br /&gt;
Neuere Implementierung hier: [[Raspberrypi.mail]]&lt;br /&gt;
&lt;br /&gt;
Wir verwenden das bebliebte Postfix Programm. Es ist sehr umfassend, dennoch kann man die Schritte, die man braucht um alles aufzusetzen (nach Wochen der Forschung) an 2 Händen abzählen. Also wie immer: Die Details später, erst mal soll es funktionieren!&lt;br /&gt;
&lt;br /&gt;
  zypper install cyrus-sasl-saslauthd&lt;br /&gt;
  chkconfig --add postfix&lt;br /&gt;
  chkconfig --add saslauthd&lt;br /&gt;
  rcpostfix start&lt;br /&gt;
  rcsaslauthd start&lt;br /&gt;
&lt;br /&gt;
== main.cf ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;&lt;br /&gt;
  queue_directory = /var/spool/postfix&lt;br /&gt;
  command_directory = /usr/sbin&lt;br /&gt;
  daemon_directory = /usr/lib/postfix&lt;br /&gt;
  mail_owner = postfix&lt;br /&gt;
  myorigin = $myhostname&lt;br /&gt;
  inet_interfaces = all&lt;br /&gt;
  unknown_local_recipient_reject_code = 550&lt;br /&gt;
  mynetworks_style = subnet&lt;br /&gt;
  mynetworks = 192.168.115.0/8, 127.0.0.0/8&lt;br /&gt;
  smtpd_banner = $myhostname ESMTP $mail_name OrgaMon(tm)&lt;br /&gt;
  debug_peer_level = 2&lt;br /&gt;
  debugger_command =&lt;br /&gt;
    PATH=/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin&lt;br /&gt;
    xxgdb $daemon_directory/$process_name $process_id &amp;amp; sleep 5&lt;br /&gt;
  sendmail_path = /usr/sbin/sendmail&lt;br /&gt;
  newaliases_path = /usr/bin/newaliases&lt;br /&gt;
  mailq_path = /usr/bin/mailq&lt;br /&gt;
  setgid_group = maildrop&lt;br /&gt;
  html_directory = /usr/share/doc/packages/postfix/html&lt;br /&gt;
  manpage_directory = /usr/share/man&lt;br /&gt;
  sample_directory = /usr/share/doc/packages/postfix/samples&lt;br /&gt;
  readme_directory = /usr/share/doc/packages/postfix/README_FILES&lt;br /&gt;
  biff = no&lt;br /&gt;
  mail_spool_directory = /var/mail&lt;br /&gt;
  canonical_maps = hash:/etc/postfix/canonical&lt;br /&gt;
  virtual_maps = hash:/etc/postfix/virtual&lt;br /&gt;
  relocated_maps = hash:/etc/postfix/relocated&lt;br /&gt;
  transport_maps = hash:/etc/postfix/transport&lt;br /&gt;
  sender_canonical_maps = hash:/etc/postfix/sender_canonical&lt;br /&gt;
  masquerade_exceptions = root&lt;br /&gt;
  masquerade_classes = envelope_sender, header_sender, header_recipient&lt;br /&gt;
  program_directory = /usr/lib/postfix&lt;br /&gt;
  masquerade_domains = &lt;br /&gt;
  myhostname = mx.orgamon.org&lt;br /&gt;
  mydomain = orgamon.org&lt;br /&gt;
  mydestination = localhost, $myhostname, localhost.$mydomain&lt;br /&gt;
  local_recipient_maps = $alias_maps unix:passwd.byname&lt;br /&gt;
  defer_transports = &lt;br /&gt;
  disable_dns_lookups = no&lt;br /&gt;
  relayhost = &lt;br /&gt;
  mailbox_command = &lt;br /&gt;
  mailbox_transport = &lt;br /&gt;
  smtpd_sender_restrictions = hash:/etc/postfix/access&lt;br /&gt;
  smtpd_client_restrictions = &lt;br /&gt;
  smtpd_helo_required = no&lt;br /&gt;
  smtpd_helo_restrictions = &lt;br /&gt;
  strict_rfc821_envelopes = no&lt;br /&gt;
  smtpd_recipient_restrictions = permit_sasl_authenticated, reject_unauth_destination&lt;br /&gt;
  smtpd_sasl_auth_enable = yes&lt;br /&gt;
  smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd&lt;br /&gt;
  smtpd_sasl_local_domain = raib90&lt;br /&gt;
  smtpd_sasl_security_options = noanonymous&lt;br /&gt;
  smtpd_sender_login_maps =&lt;br /&gt;
  broken_sasl_auth_clients = yes&lt;br /&gt;
  smtpd_use_tls = no&lt;br /&gt;
  smtp_use_tls = no&lt;br /&gt;
  alias_maps = hash:/etc/aliases&lt;br /&gt;
  mailbox_size_limit = 99999999&lt;br /&gt;
  message_size_limit = 99999999&lt;br /&gt;
&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Anlegen eines neuen eMail Postfaches (und die Zuordnung zu einem Benutzer) ==&lt;br /&gt;
&lt;br /&gt;
  YaST2-&amp;gt;Sicherheit und Benutzer-&amp;gt;Benutzer bearbeiten und anlegen&lt;br /&gt;
  &amp;lt;Alt&amp;gt;&amp;lt;H&amp;gt;(für Hinzufügen)&lt;br /&gt;
  Daten ensprechende Eintrag:&lt;br /&gt;
  POP3 Konto ist der Benutzername&lt;br /&gt;
  POP3 Passwort ist das normale Password&lt;br /&gt;
  Die Gruppenrechte entsprechend völligst minimal einstellen. &lt;br /&gt;
  [x] Leeres Home&lt;br /&gt;
  Standard-Gruppe &amp;quot;postfix&amp;quot;&lt;br /&gt;
  Gruppenzugehörigkeit nur &amp;quot;postfix!&amp;quot;&lt;br /&gt;
  Einen Login verhindern, diese Benutzer dürfen ausschliesslich via popper ihre eMails abholen!&lt;br /&gt;
    &lt;br /&gt;
  -- Mailname korrekt einstellen&lt;br /&gt;
  joe /etc/postfix/virtual&lt;br /&gt;
  unten Eintragen:&lt;br /&gt;
&lt;br /&gt;
  domain.tld                         DOMAIN&lt;br /&gt;
  vorname.nachname@domain.tld        Benutzername@localhost&lt;br /&gt;
&lt;br /&gt;
  # Bemerkung:&lt;br /&gt;
  # ==========&lt;br /&gt;
  # Die erste Zeile &amp;quot;domain.tld&amp;quot; muss nur 1x pro gehostetem Domainname&lt;br /&gt;
  # als &amp;quot;überschrift&amp;quot; über alle User dieser Domain eingetragen werden&lt;br /&gt;
  # damit wird postfix klargemacht, dass es für diese Domains zuständig &lt;br /&gt;
  # ist.&lt;br /&gt;
  &lt;br /&gt;
  -- das ganze compilieren mit postmap&lt;br /&gt;
 &lt;br /&gt;
  postmap /etc/postfix/virtual&lt;br /&gt;
  &lt;br /&gt;
  -- die ganzen Änderungen jetzt bekannt machen&lt;br /&gt;
  postfix reload&lt;br /&gt;
&lt;br /&gt;
== Anlegen einer Weiterleitung ==&lt;br /&gt;
&lt;br /&gt;
Für eine reine Weiterleitung brauchen wir keinen neuen Benutzer anlegen. Es reicht ein Eintrag in die &amp;quot;virtual&amp;quot;.&lt;br /&gt;
&lt;br /&gt;
  joe /etc/postfix/virtual&lt;br /&gt;
 &lt;br /&gt;
  domain.tld            DOMAIN&lt;br /&gt;
  name@domain.tld       weiter.leitungs.ziel@fremder-domain.tld&lt;br /&gt;
 &lt;br /&gt;
  postmap /etc/postfix/virtual&lt;br /&gt;
&lt;br /&gt;
== POP3 Dienst starten ==&lt;br /&gt;
&lt;br /&gt;
* Damit die eMails auch abgeholt werden können muss im YaST bei den Netzwerk-Diensten (inetd/xinetd) noch der &amp;quot;pop3&amp;quot; &amp;quot;(q)popper&amp;quot; Dienst aktiviert werden.&lt;br /&gt;
&lt;br /&gt;
== Diagnose Möglichkeiten ==&lt;br /&gt;
&lt;br /&gt;
Zum Test braucht man unbedingt eine funktionierende Mail Adresse, die von einem externen Server aus operiert. Mit dieser identität kann man nun den eigenen Mail Server auf seine Funktion hin testen.&lt;br /&gt;
&lt;br /&gt;
 # in diesem Verzeichnis befinden sich die Mail aller Benutzer (INBOX). &lt;br /&gt;
 # Pro Postfach wird eine Datei mit dem Dateinamen = Benutzername&lt;br /&gt;
 # geführt. Ist diese &amp;gt; 0 Bytes hat der Benutzer unabgerufenen Mail&lt;br /&gt;
 # Dateidatum und Uhrzeit zeigt den Zeitpunkt der Zustellung der &lt;br /&gt;
 # letzten Mail.&lt;br /&gt;
 &lt;br /&gt;
 /var/mail&lt;br /&gt;
&lt;br /&gt;
 # wichtige Informationsquelle bei Störungen&lt;br /&gt;
 &lt;br /&gt;
 /var/log/mail.*&lt;br /&gt;
&lt;br /&gt;
 # Anzeigen des im Moment gültigen Wertes einer Einstellung.&lt;br /&gt;
 &lt;br /&gt;
 postconf &amp;lt;ParameterName&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 # Statistik mit interessanten Zusammenfassungen&lt;br /&gt;
 &lt;br /&gt;
 pflogsumm /var/log/mail.log&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Linux.postfix&amp;diff=33404</id>
		<title>Linux.postfix</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Linux.postfix&amp;diff=33404"/>
		<updated>2026-04-28T17:23:43Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Diagnose Möglichkeiten */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Ziel ==&lt;br /&gt;
&lt;br /&gt;
* Kompletter Mail - Server, der von innen wie von aussen kontaktiert werden kann (via pop3,smtp). Er soll für mehrere Domain-Namen und noch mehr Benutzer (alle auf die eigene ServerIP gebunden) die Post verwalten und natürlich kein offenes Relay sein.&lt;br /&gt;
&lt;br /&gt;
== Voraussetzungen ==&lt;br /&gt;
&lt;br /&gt;
=== Feste IP ===&lt;br /&gt;
&lt;br /&gt;
* ein Linux Server mit fester IP Adresse. Meine, bei t-com bestellte feste IP ist z.B. &lt;br /&gt;
&lt;br /&gt;
  217.91.31.84&lt;br /&gt;
&lt;br /&gt;
* Du legst eine Domain auf diese IP, das nennen wir ab jetzt &amp;lt;MailAgentDomain&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== PTR Record ===&lt;br /&gt;
&lt;br /&gt;
* einen PTR Eintrag deiner IP Adresse, ab jetzt &amp;lt;ReverseHost&amp;gt; bezeichnet&lt;br /&gt;
&lt;br /&gt;
  host -t PTR &amp;lt;DeineFesteIP&amp;gt;&lt;br /&gt;
 &lt;br /&gt;
  # Bei mir ergibt das z.B. pd95b1f54.dip0.t-ipconnect.de&lt;br /&gt;
  # Leider ist es nicht möglich diesen Eintrag zu belassen, das einigen Mail Server, &lt;br /&gt;
  # so z.B. aol diese Art von Hostnamen so gar nicht mögen. Die meinen dann, man hätte&lt;br /&gt;
  # einen dynamische IP Adresse, und man versuche sich als Mailserver aufzuführen. Leider&lt;br /&gt;
  # löst der Ziel- Mailserver die Absender Domain nicht auf, sonst würde er erkennen&lt;br /&gt;
  # das die IP der Versende-Identität sowie die Identität des senders decken, also&lt;br /&gt;
  # offensichtlich kein relay verwendet wird. Meiner Meinung nach unberechtigt der&lt;br /&gt;
  # Ablehnende Fehlercode :&lt;br /&gt;
  #&lt;br /&gt;
  # 554-:  (DNS:B2) http://postmaster.info.aol.com/errors/554dnsb2.html&lt;br /&gt;
  #&lt;br /&gt;
  # Fehler 1)&lt;br /&gt;
  # &lt;br /&gt;
  # Bezieht man von der t-com eine feste IP, kommt die aus einem zweifelhaften pool,&lt;br /&gt;
  # man sollte diese mit einem schönen PTR Eintrag versehen, so z.B.&lt;br /&gt;
  # HSGWBSGA.t-com-festeip.de&lt;br /&gt;
  # dann müsste man keinen eigenen PTR Eintrag ersinnen. &lt;br /&gt;
  #&lt;br /&gt;
  # Fehler 2)&lt;br /&gt;
  #&lt;br /&gt;
  # &amp;quot;riecht&amp;quot; der PTR Eintrag nach dynamischer IP sollte die püfung der Versende&lt;br /&gt;
  # Identität erfolgen. Ist der A Eintrag wieder die selbe Adresse, so ist das ja&lt;br /&gt;
  # wohl mehr als Beweis, da die IP Adresse und PTR 100% OK ist.&lt;br /&gt;
  #&lt;br /&gt;
&lt;br /&gt;
=== MX Record ===&lt;br /&gt;
&lt;br /&gt;
* bei allen Domains die der Mailserver hosten soll, muss der ReverseHost von oben als der MX Eintrag gemacht sein. So bekommen wir einen ganz soliden MX Eintrag, der den neuesten Forderungen (PTR-fest) entspricht.&lt;br /&gt;
&lt;br /&gt;
  host -t MX &amp;lt;DeineMailDomain&amp;gt;&lt;br /&gt;
  &lt;br /&gt;
  # sollte als Ergebnis also pd95b1f54.dip0.t-ipconnect.de &lt;br /&gt;
  # ergeben!&lt;br /&gt;
&lt;br /&gt;
=== SPF Record ===&lt;br /&gt;
&lt;br /&gt;
* Es ist ein TXT Record in &amp;lt;DeineMailDomain&amp;gt; der aussagt WER zuständig für den ausgehenden Mailversand ist&lt;br /&gt;
* Es verbessert nicht die Anzahl der Spam-Mails, die Dich erreichen&lt;br /&gt;
* Es verbessert aber die Anzahl der Spam-Mails in der Welt, die als Absender &amp;lt;DeineMailDomain&amp;gt; missbrauchen, da Du hiermit erklärt hast, welche SendeServer Du benutzt. Alle anderen gelten als nicht berechtigt.&lt;br /&gt;
* In unserem Fall, ist der berechtigte unser MX, sonst niemand: &lt;br /&gt;
** &amp;lt;code&amp;gt;v=spf1 mx -all&amp;lt;/code&amp;gt;&lt;br /&gt;
* Test mit http://spf.myisp.ch/&lt;br /&gt;
&lt;br /&gt;
=== DKIM ===&lt;br /&gt;
&lt;br /&gt;
* https://kofler.info/dkim-konfiguration-fuer-postfix/&lt;br /&gt;
&lt;br /&gt;
=== DMARC ===&lt;br /&gt;
&lt;br /&gt;
* Typischer Snake-Oil Mechanismus der nur scheinbar die Sicherheit erhöht, der _dmarc TXT Record muss bei der Mail-Domain hinzugemacht werden, nicht bei der mx Domain&lt;br /&gt;
&lt;br /&gt;
* https://support.google.com/a/answer/2466563?sjid=13818195432106118449-EU&lt;br /&gt;
&lt;br /&gt;
 _dmarc   TXT    v=DMARC1; p=reject; rua=mailto:postmaster@orgamon.org&lt;br /&gt;
&lt;br /&gt;
== Aktivierung der notwendigen Dienste ==&lt;br /&gt;
&lt;br /&gt;
Neuere Implementierung hier: [[Raspberrypi.mail]]&lt;br /&gt;
&lt;br /&gt;
Wir verwenden das bebliebte Postfix Programm. Es ist sehr umfassend, dennoch kann man die Schritte, die man braucht um alles aufzusetzen (nach Wochen der Forschung) an 2 Händen abzählen. Also wie immer: Die Details später, erst mal soll es funktionieren!&lt;br /&gt;
&lt;br /&gt;
  zypper install cyrus-sasl-saslauthd&lt;br /&gt;
  chkconfig --add postfix&lt;br /&gt;
  chkconfig --add saslauthd&lt;br /&gt;
  rcpostfix start&lt;br /&gt;
  rcsaslauthd start&lt;br /&gt;
&lt;br /&gt;
== main.cf ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;&lt;br /&gt;
  queue_directory = /var/spool/postfix&lt;br /&gt;
  command_directory = /usr/sbin&lt;br /&gt;
  daemon_directory = /usr/lib/postfix&lt;br /&gt;
  mail_owner = postfix&lt;br /&gt;
  myorigin = $myhostname&lt;br /&gt;
  inet_interfaces = all&lt;br /&gt;
  unknown_local_recipient_reject_code = 550&lt;br /&gt;
  mynetworks_style = subnet&lt;br /&gt;
  mynetworks = 192.168.115.0/8, 127.0.0.0/8&lt;br /&gt;
  smtpd_banner = $myhostname ESMTP $mail_name OrgaMon(tm)&lt;br /&gt;
  debug_peer_level = 2&lt;br /&gt;
  debugger_command =&lt;br /&gt;
    PATH=/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin&lt;br /&gt;
    xxgdb $daemon_directory/$process_name $process_id &amp;amp; sleep 5&lt;br /&gt;
  sendmail_path = /usr/sbin/sendmail&lt;br /&gt;
  newaliases_path = /usr/bin/newaliases&lt;br /&gt;
  mailq_path = /usr/bin/mailq&lt;br /&gt;
  setgid_group = maildrop&lt;br /&gt;
  html_directory = /usr/share/doc/packages/postfix/html&lt;br /&gt;
  manpage_directory = /usr/share/man&lt;br /&gt;
  sample_directory = /usr/share/doc/packages/postfix/samples&lt;br /&gt;
  readme_directory = /usr/share/doc/packages/postfix/README_FILES&lt;br /&gt;
  biff = no&lt;br /&gt;
  mail_spool_directory = /var/mail&lt;br /&gt;
  canonical_maps = hash:/etc/postfix/canonical&lt;br /&gt;
  virtual_maps = hash:/etc/postfix/virtual&lt;br /&gt;
  relocated_maps = hash:/etc/postfix/relocated&lt;br /&gt;
  transport_maps = hash:/etc/postfix/transport&lt;br /&gt;
  sender_canonical_maps = hash:/etc/postfix/sender_canonical&lt;br /&gt;
  masquerade_exceptions = root&lt;br /&gt;
  masquerade_classes = envelope_sender, header_sender, header_recipient&lt;br /&gt;
  program_directory = /usr/lib/postfix&lt;br /&gt;
  masquerade_domains = &lt;br /&gt;
  myhostname = mx.orgamon.org&lt;br /&gt;
  mydomain = orgamon.org&lt;br /&gt;
  mydestination = localhost, $myhostname, localhost.$mydomain&lt;br /&gt;
  local_recipient_maps = $alias_maps unix:passwd.byname&lt;br /&gt;
  defer_transports = &lt;br /&gt;
  disable_dns_lookups = no&lt;br /&gt;
  relayhost = &lt;br /&gt;
  mailbox_command = &lt;br /&gt;
  mailbox_transport = &lt;br /&gt;
  smtpd_sender_restrictions = hash:/etc/postfix/access&lt;br /&gt;
  smtpd_client_restrictions = &lt;br /&gt;
  smtpd_helo_required = no&lt;br /&gt;
  smtpd_helo_restrictions = &lt;br /&gt;
  strict_rfc821_envelopes = no&lt;br /&gt;
  smtpd_recipient_restrictions = permit_sasl_authenticated, reject_unauth_destination&lt;br /&gt;
  smtpd_sasl_auth_enable = yes&lt;br /&gt;
  smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd&lt;br /&gt;
  smtpd_sasl_local_domain = raib90&lt;br /&gt;
  smtpd_sasl_security_options = noanonymous&lt;br /&gt;
  smtpd_sender_login_maps =&lt;br /&gt;
  broken_sasl_auth_clients = yes&lt;br /&gt;
  smtpd_use_tls = no&lt;br /&gt;
  smtp_use_tls = no&lt;br /&gt;
  alias_maps = hash:/etc/aliases&lt;br /&gt;
  mailbox_size_limit = 99999999&lt;br /&gt;
  message_size_limit = 99999999&lt;br /&gt;
&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Anlegen eines neuen eMail Postfaches (und die Zuordnung zu einem Benutzer) ==&lt;br /&gt;
&lt;br /&gt;
  YaST2-&amp;gt;Sicherheit und Benutzer-&amp;gt;Benutzer bearbeiten und anlegen&lt;br /&gt;
  &amp;lt;Alt&amp;gt;&amp;lt;H&amp;gt;(für Hinzufügen)&lt;br /&gt;
  Daten ensprechende Eintrag:&lt;br /&gt;
  POP3 Konto ist der Benutzername&lt;br /&gt;
  POP3 Passwort ist das normale Password&lt;br /&gt;
  Die Gruppenrechte entsprechend völligst minimal einstellen. &lt;br /&gt;
  [x] Leeres Home&lt;br /&gt;
  Standard-Gruppe &amp;quot;postfix&amp;quot;&lt;br /&gt;
  Gruppenzugehörigkeit nur &amp;quot;postfix!&amp;quot;&lt;br /&gt;
  Einen Login verhindern, diese Benutzer dürfen ausschliesslich via popper ihre eMails abholen!&lt;br /&gt;
    &lt;br /&gt;
  -- Mailname korrekt einstellen&lt;br /&gt;
  joe /etc/postfix/virtual&lt;br /&gt;
  unten Eintragen:&lt;br /&gt;
&lt;br /&gt;
  domain.tld                         DOMAIN&lt;br /&gt;
  vorname.nachname@domain.tld        Benutzername@localhost&lt;br /&gt;
&lt;br /&gt;
  # Bemerkung:&lt;br /&gt;
  # ==========&lt;br /&gt;
  # Die erste Zeile &amp;quot;domain.tld&amp;quot; muss nur 1x pro gehostetem Domainname&lt;br /&gt;
  # als &amp;quot;überschrift&amp;quot; über alle User dieser Domain eingetragen werden&lt;br /&gt;
  # damit wird postfix klargemacht, dass es für diese Domains zuständig &lt;br /&gt;
  # ist.&lt;br /&gt;
  &lt;br /&gt;
  -- das ganze compilieren mit postmap&lt;br /&gt;
 &lt;br /&gt;
  postmap /etc/postfix/virtual&lt;br /&gt;
  &lt;br /&gt;
  -- die ganzen Änderungen jetzt bekannt machen&lt;br /&gt;
  postfix reload&lt;br /&gt;
&lt;br /&gt;
== Anlegen einer Weiterleitung ==&lt;br /&gt;
&lt;br /&gt;
Für eine reine Weiterleitung brauchen wir keinen neuen Benutzer anlegen. Es reicht ein Eintrag in die &amp;quot;virtual&amp;quot;.&lt;br /&gt;
&lt;br /&gt;
  joe /etc/postfix/virtual&lt;br /&gt;
 &lt;br /&gt;
  domain.tld            DOMAIN&lt;br /&gt;
  name@domain.tld       weiter.leitungs.ziel@fremder-domain.tld&lt;br /&gt;
 &lt;br /&gt;
  postmap /etc/postfix/virtual&lt;br /&gt;
&lt;br /&gt;
== POP3 Dienst starten ==&lt;br /&gt;
&lt;br /&gt;
* Damit die eMails auch abgeholt werden können muss im YaST bei den Netzwerk-Diensten (inetd/xinetd) noch der &amp;quot;pop3&amp;quot; &amp;quot;(q)popper&amp;quot; Dienst aktiviert werden.&lt;br /&gt;
&lt;br /&gt;
== Diagnose Möglichkeiten ==&lt;br /&gt;
&lt;br /&gt;
Zum Test braucht man unbedingt eine funktionierende Mail Adresse, die von einem externen Server aus operiert. Mit dieser identität kann man nun den eigenen Mail Server auf seine Funktion hin testen.&lt;br /&gt;
&lt;br /&gt;
 # in diesem Verzeichnis befinden sich die Mail aller Benutzer (INBOX). &lt;br /&gt;
 # Pro Postfach wird eine Datei mit dem Dateinamen = Benutzername&lt;br /&gt;
 # geführt. Ist diese &amp;gt; 0 Bytes hat der Benutzer unabgerufenen Mail&lt;br /&gt;
 # Dateidatum und Uhrzeit zeigt den Zeitpunkt der Zustellung der &lt;br /&gt;
 # letzten Mail.&lt;br /&gt;
 &lt;br /&gt;
 /var/mail&lt;br /&gt;
 &lt;br /&gt;
 # wichtige Informationsquelle bei Störungen&lt;br /&gt;
 &lt;br /&gt;
 /var/log/mail.*&lt;br /&gt;
&lt;br /&gt;
 # Anzeigen des im Moment gültigen Wertes einer Einstellung.&lt;br /&gt;
 &lt;br /&gt;
 postconf &amp;lt;ParameterName&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 # Statistik mit interessanten Zusammenfassungen&lt;br /&gt;
 &lt;br /&gt;
 pflogsumm /var/log/mail.log&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33396</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33396"/>
		<updated>2026-03-20T16:40:41Z</updated>

		<summary type="html">&lt;p&gt;Root: /* polyzalos.js */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== Pascal -&amp;gt; JavaScript ===&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
* http://www.creaturearchives.com/animalia-chariot-allegory/&lt;br /&gt;
* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Polyzalos Binary&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf ein Web-Verzeichnis&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33395</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33395"/>
		<updated>2026-03-20T16:40:03Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Pascal -&amp;gt; JavaScript */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
 pacman -S openssl mkcert&lt;br /&gt;
&lt;br /&gt;
=== localhost-Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
=== local.orgamon.net-Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* Die Dev Tools haben im &amp;quot;Netzwerk&amp;quot; ein Toggle oder OFFLINE Knopf um das zu testen&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33394</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33394"/>
		<updated>2026-03-20T16:39:52Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Inbetriebnahme */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
 pacman -S openssl mkcert&lt;br /&gt;
&lt;br /&gt;
=== localhost-Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
=== local.orgamon.net-Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* Die Dev Tools haben im &amp;quot;Netzwerk&amp;quot; ein Toggle oder OFFLINE Knopf um das zu testen&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33393</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33393"/>
		<updated>2026-03-20T16:39:27Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Inbetriebnahme */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
 pacman -S openssl mkcert&lt;br /&gt;
&lt;br /&gt;
=== localhost-Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* Die Dev Tools haben im &amp;quot;Netzwerk&amp;quot; ein Toggle oder OFFLINE Knopf um das zu testen&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33392</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33392"/>
		<updated>2026-03-20T16:38:37Z</updated>

		<summary type="html">&lt;p&gt;Root: /* openSSL */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
 pacman -S openssl&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* Die Dev Tools haben im &amp;quot;Netzwerk&amp;quot; ein Toggle oder OFFLINE Knopf um das zu testen&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33391</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33391"/>
		<updated>2026-03-20T16:37:23Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Retry-, Reconnect- Fähig */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* Die Dev Tools haben im &amp;quot;Netzwerk&amp;quot; ein Toggle oder OFFLINE Knopf um das zu testen&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33390</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33390"/>
		<updated>2026-03-20T16:31:07Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Informationsquellen */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33389</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33389"/>
		<updated>2026-03-20T16:29:05Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Paralleles Arbeiten */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33388</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33388"/>
		<updated>2026-03-20T16:28:11Z</updated>

		<summary type="html">&lt;p&gt;Root: /* todo */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* zstd shared-compression-dictionaries&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33387</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33387"/>
		<updated>2026-03-20T16:24:56Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Meilensteine */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 20.03.2026 SSE für /log in die Client Console&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33386</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33386"/>
		<updated>2026-03-20T16:22:43Z</updated>

		<summary type="html">&lt;p&gt;Root: /* polyzalosd */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33385</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33385"/>
		<updated>2026-03-20T16:22:30Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Port 443 auf dem eigenen System öffnen */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
=== polyzalosd ===&lt;br /&gt;
&lt;br /&gt;
* Diese Konsolenanwendung gibt Statusmeldungen (Log) in Farbe aus&lt;br /&gt;
* dies muss unter Windows jedoch aktiviert werden&lt;br /&gt;
&lt;br /&gt;
 reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f&lt;br /&gt;
&lt;br /&gt;
* https://ss64.com/nt/syntax-ansi.html&lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|Dies macht polyzalosd inzwischen über eine Windows-API Funktion selbst}}&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33384</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33384"/>
		<updated>2026-03-20T16:22:20Z</updated>

		<summary type="html">&lt;p&gt;Root: /* On demand cert generation */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
=== Port 443 auf dem eigenen System öffnen ===&lt;br /&gt;
&lt;br /&gt;
Wenn Du einen von aussen sichtbaren Webserver (HTTPS) auf dem eigenen Rechner betreiben willst musst Du Port :443 öffnen.&lt;br /&gt;
&lt;br /&gt;
* http://praxistipps.chip.de/windows-10-ports-in-der-firewall-oeffnen-so-gehts_42589&lt;br /&gt;
&lt;br /&gt;
* Auf deinem Router brauchst Du eine feste IP oder ein Dyndns&lt;br /&gt;
* Auf deinem Router musst Du eingehenden Netzwerkverkehr auf Port :443 auf deinen lokalen Rechner leiten (AVM nennt das &amp;quot;Freigabe&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== polyzalosd ===&lt;br /&gt;
&lt;br /&gt;
* Diese Konsolenanwendung gibt Statusmeldungen (Log) in Farbe aus&lt;br /&gt;
* dies muss unter Windows jedoch aktiviert werden&lt;br /&gt;
&lt;br /&gt;
 reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f&lt;br /&gt;
&lt;br /&gt;
* https://ss64.com/nt/syntax-ansi.html&lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|Dies macht polyzalosd inzwischen über eine Windows-API Funktion selbst}}&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33383</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33383"/>
		<updated>2026-03-20T16:19:05Z</updated>

		<summary type="html">&lt;p&gt;Root: /* localhost */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
==== On demand cert generation ====&lt;br /&gt;
&lt;br /&gt;
* Generiere doch ein key/cert für computername.local&lt;br /&gt;
&lt;br /&gt;
https://github.com/marsupilami79/zeoslib/blob/master/src/webservice/server/dbcproxycertstore.pas&lt;br /&gt;
&lt;br /&gt;
=== Port 443 auf dem eigenen System öffnen ===&lt;br /&gt;
&lt;br /&gt;
Wenn Du einen von aussen sichtbaren Webserver (HTTPS) auf dem eigenen Rechner betreiben willst musst Du Port :443 öffnen.&lt;br /&gt;
&lt;br /&gt;
* http://praxistipps.chip.de/windows-10-ports-in-der-firewall-oeffnen-so-gehts_42589&lt;br /&gt;
&lt;br /&gt;
* Auf deinem Router brauchst Du eine feste IP oder ein Dyndns&lt;br /&gt;
* Auf deinem Router musst Du eingehenden Netzwerkverkehr auf Port :443 auf deinen lokalen Rechner leiten (AVM nennt das &amp;quot;Freigabe&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== polyzalosd ===&lt;br /&gt;
&lt;br /&gt;
* Diese Konsolenanwendung gibt Statusmeldungen (Log) in Farbe aus&lt;br /&gt;
* dies muss unter Windows jedoch aktiviert werden&lt;br /&gt;
&lt;br /&gt;
 reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f&lt;br /&gt;
&lt;br /&gt;
* https://ss64.com/nt/syntax-ansi.html&lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|Dies macht polyzalosd inzwischen über eine Windows-API Funktion selbst}}&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33382</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33382"/>
		<updated>2026-03-20T16:17:07Z</updated>

		<summary type="html">&lt;p&gt;Root: /* localhost */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;mkcert&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 pacman -S mkcert&lt;br /&gt;
 mkcert -install&lt;br /&gt;
 &lt;br /&gt;
 # gehe in dein /hosts/localhost Verzeichnis&lt;br /&gt;
 #&lt;br /&gt;
 mkcert -cert-file cert.pem -key-file privkey.pem &amp;quot;localhost&amp;quot;&lt;br /&gt;
&lt;br /&gt;
 # mit &amp;quot;openssl&amp;quot;&lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=localhost'&lt;br /&gt;
&lt;br /&gt;
 # &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -out localhost.crt -keyout localhost.key   -newkey rsa:2048 -nodes -days 365 -sha256   -subj '/CN=localhost' -extensions EXT -config &amp;lt;( \&lt;br /&gt;
 printf &amp;quot;[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
* Zertifikat in Google Chrome installieren&lt;br /&gt;
** Einstellung -&amp;gt; Sicherheit und Datenschutz -&amp;gt; Sicherheit -&amp;gt; Zertifikate verwalten -&amp;gt; Reiter &amp;quot;Vertrauenswürdige Stammzertifizierungsstellen&amp;quot; -&amp;gt; Importieren -&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
==== On demand cert generation ====&lt;br /&gt;
&lt;br /&gt;
* Generiere doch ein key/cert für computername.local&lt;br /&gt;
&lt;br /&gt;
https://github.com/marsupilami79/zeoslib/blob/master/src/webservice/server/dbcproxycertstore.pas&lt;br /&gt;
&lt;br /&gt;
=== Port 443 auf dem eigenen System öffnen ===&lt;br /&gt;
&lt;br /&gt;
Wenn Du einen von aussen sichtbaren Webserver (HTTPS) auf dem eigenen Rechner betreiben willst musst Du Port :443 öffnen.&lt;br /&gt;
&lt;br /&gt;
* http://praxistipps.chip.de/windows-10-ports-in-der-firewall-oeffnen-so-gehts_42589&lt;br /&gt;
&lt;br /&gt;
* Auf deinem Router brauchst Du eine feste IP oder ein Dyndns&lt;br /&gt;
* Auf deinem Router musst Du eingehenden Netzwerkverkehr auf Port :443 auf deinen lokalen Rechner leiten (AVM nennt das &amp;quot;Freigabe&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== polyzalosd ===&lt;br /&gt;
&lt;br /&gt;
* Diese Konsolenanwendung gibt Statusmeldungen (Log) in Farbe aus&lt;br /&gt;
* dies muss unter Windows jedoch aktiviert werden&lt;br /&gt;
&lt;br /&gt;
 reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f&lt;br /&gt;
&lt;br /&gt;
* https://ss64.com/nt/syntax-ansi.html&lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|Dies macht polyzalosd inzwischen über eine Windows-API Funktion selbst}}&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33381</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33381"/>
		<updated>2026-03-20T15:59:08Z</updated>

		<summary type="html">&lt;p&gt;Root: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
* mit openssl erst mal key.pem und cert.pem erstellen (hier im Beispiel für die Server-Identität &amp;quot;localhost&amp;quot;)&lt;br /&gt;
** &amp;lt;code&amp;gt;openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;localhost&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;'&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 # &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -out localhost.crt -keyout localhost.key   -newkey rsa:2048 -nodes -days 365 -sha256   -subj '/CN=localhost' -extensions EXT -config &amp;lt;( \&lt;br /&gt;
 printf &amp;quot;[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
* Zertifikat in Google Chrome installieren&lt;br /&gt;
** Einstellung -&amp;gt; Sicherheit und Datenschutz -&amp;gt; Sicherheit -&amp;gt; Zertifikate verwalten -&amp;gt; Reiter &amp;quot;Vertrauenswürdige Stammzertifizierungsstellen&amp;quot; -&amp;gt; Importieren -&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
==== On demand cert generation ====&lt;br /&gt;
&lt;br /&gt;
* Generiere doch ein key/cert für computername.local&lt;br /&gt;
&lt;br /&gt;
https://github.com/marsupilami79/zeoslib/blob/master/src/webservice/server/dbcproxycertstore.pas&lt;br /&gt;
&lt;br /&gt;
=== Port 443 auf dem eigenen System öffnen ===&lt;br /&gt;
&lt;br /&gt;
Wenn Du einen von aussen sichtbaren Webserver (HTTPS) auf dem eigenen Rechner betreiben willst musst Du Port :443 öffnen.&lt;br /&gt;
&lt;br /&gt;
* http://praxistipps.chip.de/windows-10-ports-in-der-firewall-oeffnen-so-gehts_42589&lt;br /&gt;
&lt;br /&gt;
* Auf deinem Router brauchst Du eine feste IP oder ein Dyndns&lt;br /&gt;
* Auf deinem Router musst Du eingehenden Netzwerkverkehr auf Port :443 auf deinen lokalen Rechner leiten (AVM nennt das &amp;quot;Freigabe&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== polyzalosd ===&lt;br /&gt;
&lt;br /&gt;
* Diese Konsolenanwendung gibt Statusmeldungen (Log) in Farbe aus&lt;br /&gt;
* dies muss unter Windows jedoch aktiviert werden&lt;br /&gt;
&lt;br /&gt;
 reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f&lt;br /&gt;
&lt;br /&gt;
* https://ss64.com/nt/syntax-ansi.html&lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|Dies macht polyzalosd inzwischen über eine Windows-API Funktion selbst}}&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33380</id>
		<title>HTTP2</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=HTTP2&amp;diff=33380"/>
		<updated>2026-03-20T15:58:11Z</updated>

		<summary type="html">&lt;p&gt;Root: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* Das Zukunftsprojekt [[Polyzalos]] erfordert die Integration eines HTTP/2 Servers in OrgaMon&lt;br /&gt;
* Im Moment entsteht deshalb ein HTTP/2 Server in FreePascal, Zielsystem ist im Moment auf Linux beschränkt&lt;br /&gt;
* Alle Quelltexte befinden sich auf GitHub&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/src/cryptossl.pas cryptossl.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/PASconTools/hpack.pas hpack.pas]]&lt;br /&gt;
** [[https://github.com/Andreas-Filsinger/Polyzalos/blob/main/PASconTools/http2.pas http2.pas]]&lt;br /&gt;
&lt;br /&gt;
== Inbetriebnahme ==&lt;br /&gt;
&lt;br /&gt;
=== openSSL ===&lt;br /&gt;
&lt;br /&gt;
Windows&lt;br /&gt;
&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* Downloade und Installiere die 64bit Light Version (im Moment &amp;quot;Win64 OpenSSL v3.2.0 Light&amp;quot; .exe)&lt;br /&gt;
** Standard-Ziel akzeptieren, &amp;quot;in das Systemverzeichnis&amp;quot; angekreuzt lassen&lt;br /&gt;
&lt;br /&gt;
Linux&lt;br /&gt;
&lt;br /&gt;
* selbst aus den Quellen compilieren, da zumeist 1.0 Teil der Distributionen ist&lt;br /&gt;
&lt;br /&gt;
=== Zertifikat ===&lt;br /&gt;
&lt;br /&gt;
==== localhost ====&lt;br /&gt;
&lt;br /&gt;
* mit openssl erst mal key.pem und cert.pem erstellen (hier im Beispiel für die Server-Identität &amp;quot;localhost&amp;quot;)&lt;br /&gt;
** &amp;lt;code&amp;gt;openssl req -x509 -nodes -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj '/CN=&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;localhost&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;'&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 # &lt;br /&gt;
 #&lt;br /&gt;
 #&lt;br /&gt;
 openssl req -x509 -out localhost.crt -keyout localhost.key   -newkey rsa:2048 -nodes -days 365 -sha256   -subj '/CN=localhost' -extensions EXT -config &amp;lt;( \&lt;br /&gt;
 printf &amp;quot;[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* ein Hauptverzeichnis ausdenken und dort ein Verzeichnis pro CN erstellen&lt;br /&gt;
* jeweils die 2 Dateien dort rein&lt;br /&gt;
* Beispiel: Dein Server ist als &amp;quot;localhost&amp;quot; auf der Maschine selbst, und als &amp;quot;rom&amp;quot; im eigenen Netz, und als &amp;quot;orgamon-2.dyndns.org&amp;quot; von aussen ansprechbar, dann must Du 3x openssl rifen wir oben angegeben mit wechselnder CN&lt;br /&gt;
&lt;br /&gt;
 \srv\hosts\&lt;br /&gt;
   .\localhost\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\rom\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
   .\orgamon-2.dyndns.org\&lt;br /&gt;
      key.pem&lt;br /&gt;
      cert.pem&lt;br /&gt;
&lt;br /&gt;
* Zertifikat in Google Chrome installieren&lt;br /&gt;
** Einstellung -&amp;gt; Sicherheit und Datenschutz -&amp;gt; Sicherheit -&amp;gt; Zertifikate verwalten -&amp;gt; Reiter &amp;quot;Vertrauenswürdige Stammzertifizierungsstellen&amp;quot; -&amp;gt; Importieren -&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== local.orgamon.net ====&lt;br /&gt;
&lt;br /&gt;
* Ich habe bereits ein letsencrypt *.orgamon.net Zertifikat&lt;br /&gt;
* Ich habe (bei schlundtech) &amp;quot;local.orgamon.net&amp;quot; auf 127.0.0.1 zeigen lassen (A-Record)&lt;br /&gt;
* Ich habe in der Fritz!Box die Ausnahme für den lokalen Rebindschutz eingetragen (für &amp;quot;local.orgamon.net&amp;quot;)&lt;br /&gt;
* privkey.pem und cert.pem kann ich so für den Webserver nutzen&lt;br /&gt;
* Meine Entwicklungsumgebung kann somit die lokale Maschine sein, obwohl ich eine richtige Domain angebe deren Namensauflösung im Web läuft&lt;br /&gt;
&lt;br /&gt;
==== On demand cert generation ====&lt;br /&gt;
&lt;br /&gt;
* Generiere doch ein key/cert für computername.local&lt;br /&gt;
&lt;br /&gt;
https://github.com/marsupilami79/zeoslib/blob/master/src/webservice/server/dbcproxycertstore.pas&lt;br /&gt;
&lt;br /&gt;
=== Port 443 auf dem eigenen System öffnen ===&lt;br /&gt;
&lt;br /&gt;
Wenn Du einen von aussen sichtbaren Webserver (HTTPS) auf dem eigenen Rechner betreiben willst musst Du Port :443 öffnen.&lt;br /&gt;
&lt;br /&gt;
* http://praxistipps.chip.de/windows-10-ports-in-der-firewall-oeffnen-so-gehts_42589&lt;br /&gt;
&lt;br /&gt;
* Auf deinem Router brauchst Du eine feste IP oder ein Dyndns&lt;br /&gt;
* Auf deinem Router musst Du eingehenden Netzwerkverkehr auf Port :443 auf deinen lokalen Rechner leiten (AVM nennt das &amp;quot;Freigabe&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
=== polyzalosd ===&lt;br /&gt;
&lt;br /&gt;
* Diese Konsolenanwendung gibt Statusmeldungen (Log) in Farbe aus&lt;br /&gt;
* dies muss unter Windows jedoch aktiviert werden&lt;br /&gt;
&lt;br /&gt;
 reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f&lt;br /&gt;
&lt;br /&gt;
* https://ss64.com/nt/syntax-ansi.html&lt;br /&gt;
&lt;br /&gt;
{{Anmerkung|Dies macht polyzalosd inzwischen über eine Windows-API Funktion selbst}}&lt;br /&gt;
&lt;br /&gt;
== Informationsquellen ==&lt;br /&gt;
&lt;br /&gt;
=== HPACK ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HPACK&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7541&lt;br /&gt;
&lt;br /&gt;
=== HTTP/2 ===&lt;br /&gt;
&lt;br /&gt;
* RFC &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://datatracker.ietf.org/doc/html/rfc9113&lt;br /&gt;
** veraltet: &amp;lt;b&amp;gt;HTTP/2&amp;lt;/b&amp;gt; https://tools.ietf.org/html/rfc7540&lt;br /&gt;
* https://github.com/nghttp2/nghttp2&lt;br /&gt;
** https://nghttp2.org/blog/2014/04/27/how-dependency-based-prioritization-works/&lt;br /&gt;
* https://github.com/nginx/nginx&lt;br /&gt;
* https://github.com/h2o/h2o&lt;br /&gt;
&lt;br /&gt;
=== Design ===&lt;br /&gt;
&lt;br /&gt;
* https://calendar.perfplanet.com/2020/head-of-line-blocking-in-quic-and-http-3-the-details/&lt;br /&gt;
* Der Client stellt eine Menge Requests, der erste Response (16 MB gross) verstopft aber die sende Richtung&lt;br /&gt;
** die folgenden Responses hätten aber nur minimal kleine Antworten benötigt, also z.B. HTTP 304&lt;br /&gt;
** dann blockiert der lange Response alles andere&lt;br /&gt;
** in der Aufbau-Phase einer Seite wäre es gut der Server hätte eine Kenntniss davon was der Client alles braucht&lt;br /&gt;
** Es ist ja eigentlich klar war ein &amp;quot;full&amp;quot; Reload benötigt, und da sollte man multiplexen solange noch nicht alle Antworten durch sind&lt;br /&gt;
&lt;br /&gt;
=== TLS ===&lt;br /&gt;
&lt;br /&gt;
* https://wiki.openssl.org/index.php/Simple_TLS_Server&lt;br /&gt;
* http://openssl.6102.n7.nabble.com/TLS-1-3-client-hello-issue-td72449.html#a72460&lt;br /&gt;
* http://slproweb.com/products/Win32OpenSSL.html&lt;br /&gt;
* https://github.com/openssl/openssl/blob/master/include/openssl/tls1.h&lt;br /&gt;
* https://www.openssl.org/blog/blog/2017/05/04/tlsv1.3/&lt;br /&gt;
* http://gnutls.org/manual/gnutls.html#Server-name-indication&lt;br /&gt;
* https://github.com/jay/http2_blacklisted_ciphers&lt;br /&gt;
* https://wiki.openssl.org/index.php/TLS1.3&lt;br /&gt;
&lt;br /&gt;
=== Konzept ===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* cOrgaMon ist ein https:// Server nach HTTP/2 Standard ohne UI&lt;br /&gt;
* &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; Instanz von cOrgaMon kümmert sich um &amp;lt;u&amp;gt;eine&amp;lt;/u&amp;gt; langbestehende TCP-Clientverbindung (KEEP_ALIVE)&lt;br /&gt;
* HTTPS:// TLS 1.3 (nichts anderes!) &lt;br /&gt;
* Clients, die NICHT die &amp;quot;Server Name Indication (SNI) extension&amp;quot; liefern werden abgelehnt&lt;br /&gt;
* Target ist win64 und linux&lt;br /&gt;
* openSSL Lib der Version 3.1 oder besser wird verwendet&lt;br /&gt;
* die Verbindung bleibt ständig bestehen&lt;br /&gt;
* Test https://tools.keycdn.com/http2-test&lt;br /&gt;
&lt;br /&gt;
=== Implementierung TCP ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
 |[[Datei:HTTP2.png|220px]]&lt;br /&gt;
 |[[Datei:SrvOrgaMon.png|220px]]&lt;br /&gt;
 |}&lt;br /&gt;
&lt;br /&gt;
* unit HPACK.pas erstellen (Quelle github)&lt;br /&gt;
* testen mit https://github.com/http2jp/hpack-test-case (uses json)&lt;br /&gt;
* unit HTTP2Server.pas erstellen (https://github.com/nghttp2/nghttp2)&lt;br /&gt;
* ev. auch mit https://python-hyper.org/h2/en/stable/index.html und Kopplung über das WSGI Interface&lt;br /&gt;
&lt;br /&gt;
==== Test ====&lt;br /&gt;
&lt;br /&gt;
Sollte dein cOrgaMon-Host ROM heissen:&lt;br /&gt;
&lt;br /&gt;
* openssl s_client -debug -servername &amp;lt;i&amp;gt;&amp;lt;b&amp;gt;rom&amp;lt;/b&amp;gt;&amp;lt;/i&amp;gt; -connect &amp;lt;b&amp;gt;&amp;lt;i&amp;gt;rom&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;:443&lt;br /&gt;
&lt;br /&gt;
Sollte interessant sein, was der Server so liefert, kann man das in eine Datei umleiten:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 #&lt;br /&gt;
 # openssl s_client -servername rom -nextprotoneg &amp;quot;h2,h3&amp;quot; -sess_out out.http2 -connect rom:443 &amp;gt;o.http2&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 #&lt;br /&gt;
 # hexdump -C o.http2&lt;br /&gt;
 # (leider ist ein openssl interner Prefix nicht vermeidbar, aber ab einer gewissen Position gehts los!)&lt;br /&gt;
 #&lt;br /&gt;
 &lt;br /&gt;
 00000df0  28 73 65 6c 66 20 73 69  67 6e 65 64 20 63 65 72  |(self signed cer|&lt;br /&gt;
 00000e00  74 69 66 69 63 61 74 65  29 0a 2d 2d 2d 0a 50 52  |tificate).---.PR|&lt;br /&gt;
 00000e10  49 20 2a 20 48 54 54 50  2f 32 2e 30 0d 0a 0d 0a  |I * HTTP/2.0....|&lt;br /&gt;
 00000e20  53 4d 0d 0a 0d 0a 00 00  18 04 00 00 00 00 00 00  |SM..............|&lt;br /&gt;
 00000e30  01 00 00 10 00 00 03 00  00 00 65 00 04 00 00 ff  |..........e.....|&lt;br /&gt;
 00000e40  ff 00 05 00 10 00 00 00  00 04 08 00 00 00 00 00  |................|&lt;br /&gt;
 00000e50  00 0a 00 00                                       |....|&lt;br /&gt;
 00000e54&lt;br /&gt;
&lt;br /&gt;
=== Aufbau ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:HTTP2-Units.png|300px]]&lt;br /&gt;
&lt;br /&gt;
==== HTTP2 ====&lt;br /&gt;
&lt;br /&gt;
* Zentrale Steuerunit für den HTTP2 Server&lt;br /&gt;
* Öffnet und Schliesst die Verbindung, dabei wird die openSSL entsprechend Konfiguriert&lt;br /&gt;
* Beobachtet die Verbindungsaushandlung&lt;br /&gt;
* Lehnt ungeeignetes ab&lt;br /&gt;
* Verhindert Fallbacks in unsichere Technik&lt;br /&gt;
* Verarbeitet den Server-Domain Namen Callback&lt;br /&gt;
* Stellt .pem und .cert zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* implementiert den Datenmultiplexer laut RFC, fügt also den fragmentierten Netzwerkverkehr wieder in geordnete Bahnen&lt;br /&gt;
* Feuert Events wenn Daten &amp;quot;fertig&amp;quot; vorliegen an HTTP2&lt;br /&gt;
&lt;br /&gt;
typischer HTTP/2 Content am Anfang der Verbindung.&lt;br /&gt;
&lt;br /&gt;
 Client -&amp;gt; Server&lt;br /&gt;
 &lt;br /&gt;
 50 52 49 20 2A 20 48 54 54 50 2F 32 2E 30 0D 0A  PRI.*.HTTP/2.0..&lt;br /&gt;
 0D 0A 53 4D 0D 0A 0D 0A &lt;br /&gt;
 00 00 12 (18 Bytes Content)&lt;br /&gt;
 04 00 00 00 00 00 SETTINGS, also 3 Settings!)&lt;br /&gt;
 00 01 00 01 00 00 &lt;br /&gt;
 00 04 00 02 00 00&lt;br /&gt;
 00 05 00 00 40 00&lt;br /&gt;
 00 00 04 (4 Bytes content)&lt;br /&gt;
 08 00 00 00 00 00 WINDOW_UPDATE&lt;br /&gt;
 00 BF 00 01  &lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 03 PRIO&lt;br /&gt;
 00 00 00 00 C8&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 05 PRIO&lt;br /&gt;
 00 00 00 00 64&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 07 PRIO&lt;br /&gt;
 00 00 00 00 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 09  PRIO&lt;br /&gt;
 00 00 00 07 00&lt;br /&gt;
 00 00 05 (5 Bytes Content)&lt;br /&gt;
 02 00 00 00 00 0B PRIO&lt;br /&gt;
 00 00 00 03 00 &lt;br /&gt;
  &lt;br /&gt;
 &lt;br /&gt;
 FRAME_SETTINGS&lt;br /&gt;
  HEADER_TABLE_SIZE 65536&lt;br /&gt;
  INITIAL_WINDOW_SIZE 131072&lt;br /&gt;
  MAX_FRAME_SIZE 16384&lt;br /&gt;
 FRAME_WINDOW_UPDATE&lt;br /&gt;
  0 has Window_Size_Increment 12517377&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 3.0 has 200&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 5.0 has 100&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 7.0 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 9.7 has 0&lt;br /&gt;
 FRAME_PRIORITY&lt;br /&gt;
  Stream 11.3 has 0&lt;br /&gt;
&lt;br /&gt;
==== HMUX ====&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;Entfällt, wurde in HTTP2 integriert&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== HPACK ====&lt;br /&gt;
&lt;br /&gt;
* implementiert die Header Compression laut RFC&lt;br /&gt;
&lt;br /&gt;
==== cryptossl ====&lt;br /&gt;
&lt;br /&gt;
* spricht mit der openSSL Bibliothek und implementiert dabei nur was gebraucht wird.&lt;br /&gt;
&lt;br /&gt;
==== Informationsquellen ====&lt;br /&gt;
&lt;br /&gt;
* https://stackoverflow.com/questions/19029647/ssl-ctx-use-privatekey-file-failed&lt;br /&gt;
* https://letsencrypt.org&lt;br /&gt;
* https://github.com/certbot/certbot&lt;br /&gt;
* Der Client MUSS den Servername mitteilen damit cOrgaMon erkennen kann welcher Mandant geladen werden soll&lt;br /&gt;
** https://tools.ietf.org/html/rfc6066&lt;br /&gt;
* auf diesen Server-Namen MUSS Certifikat Pinnig angewendet werden, er darf also KEIN anderes Zertifikat verwendet werden&lt;br /&gt;
** https://tools.ietf.org/html/rfc7469&lt;br /&gt;
&lt;br /&gt;
==== Schritt für Schritt mit Lets Encrypt ====&lt;br /&gt;
&lt;br /&gt;
Wir sind als in Besitz einer Domain und haben es geschafft Port 80 auf die eigene WIndows 10 Kiste zu lenken&lt;br /&gt;
&lt;br /&gt;
* Sorry, aber wir brauchen als erstes einen HTTP Webserver&lt;br /&gt;
* https://www.windowspro.de/wolfgang-sommergut/web-server-iis-windows-10-installieren-konfigurieren&lt;br /&gt;
&lt;br /&gt;
* letsencrypt-win-simple.V1.9.3.zip&lt;br /&gt;
* https://github.com/Lone-Coder/letsencrypt-win-simple/releases&lt;br /&gt;
&lt;br /&gt;
== Paralleles Arbeiten ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Ein einzelner OrgaMon-Prozess ist für eine dauerhafte TCP/Connection zuständig&lt;br /&gt;
* Ich denke dass mit OpenSSL 3.5 QUIC Server Support kommt (https://github.com/openssl/openssl/commit/cb629550cdab518c925e9b402e11b86497a03845)&lt;br /&gt;
&lt;br /&gt;
=== Thread: SSL_read() ===&lt;br /&gt;
&lt;br /&gt;
* Ein Thread sollte SSL_read ausführen, wenn da ein Datenblock oder FRAME fertig ist, sollte dieser als &amp;quot;EventProc&amp;quot; an den Main-Thread übergeben werden&lt;br /&gt;
** https://github.com/BeRo1985/pasmp&lt;br /&gt;
&lt;br /&gt;
=== Thread: JOBs ===&lt;br /&gt;
&lt;br /&gt;
* Möglicherweise startet OrgaMon wiederum SubProgramme mit langen Laufzeiten, diese SubProgramme schreiben Status Infos in memcached&lt;br /&gt;
* Rückmeldungen dieser lang laufenden Prozesse ev. über https://developer.mozilla.org/de/docs/Web/API/Push_API&lt;br /&gt;
&lt;br /&gt;
== Pascal -&amp;gt; JavaScript ==&lt;br /&gt;
&lt;br /&gt;
Durch den Wegfall der GUI muss Code auf der Client GUI autark laufen können. Dieser soll im OrgaMon Programm als FreePascal-Code aufnotiert werden, die compilierung teilt den Code auf (Client Code / Server Code) und verteilt das Java-Script über den HTTP2 Server. Freepascal hat schon eine Implementierung die Pascal nach JS ermöglicht.&lt;br /&gt;
&lt;br /&gt;
Details:&lt;br /&gt;
&lt;br /&gt;
* Die Tatsache &amp;quot;JavaScript&amp;quot; auf der Clientside wird der Lazarus-IDE scheinbar verheimlicht&lt;br /&gt;
** Es muss also der Pascalcode in JavaScript umgewandelt werden&lt;br /&gt;
** Für den Client muss eine Art Code-Lib zur Verfügung stehen, die Pascal rufen kann und umgekehrt&lt;br /&gt;
* Die IDE soll denken/vorleben das Client-Seitig auch &amp;quot;Pascal&amp;quot; gesprochen wird&lt;br /&gt;
** Debugging: Hier muss der WebClient in den remote-Debugging Modus gebracht werden&lt;br /&gt;
*** https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging&lt;br /&gt;
** Es könnte die Infrastruktur der &amp;quot;Source maps&amp;quot; verwendet werden, also &amp;quot;komprimierte&amp;quot; Zeilen des JavaScript Quellcodes zeigen auf die entsprechenden Zeilen, die in FreePascal formuliert sind. Es werden also &amp;quot;fake&amp;quot;-Source-Maps zur Verfügung gestellt, so das eine korrekte 1:1 Beziehung zwischen Pascal und Javascript bestehen kann.&lt;br /&gt;
** FreePascal und die Lazarus IDE müssen lernen, dass Teile vom Quelltext &amp;quot;remote&amp;quot; executables sind&lt;br /&gt;
** FreePascal Lazarus  muss Möglichkeiten bieten von einem eintretendem JAvaScript Breakpoint gerufen zu werden&lt;br /&gt;
&lt;br /&gt;
** Es soll alles auch in der Lazarus IDE mit Break-Points programmierbar sein, die IDE soll ein Verständnis haben welche Zeile welchen Code verbirgt&lt;br /&gt;
* Die IDE sollte den Client-Side Part ev. farblich hinterlegen?!&lt;br /&gt;
* Es muss so sein, dass eine Unit weiterhin ServerSide- / ClientSide- Code mischen kann&lt;br /&gt;
&lt;br /&gt;
 program SimpleCalculator;&lt;br /&gt;
 &lt;br /&gt;
 var&lt;br /&gt;
  Panel : TPanel;&lt;br /&gt;
  Button1 : TButton;&lt;br /&gt;
  Button2 : TButton;&lt;br /&gt;
  &lt;br /&gt;
 procedure Panel.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  beep; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 procedure Button1.OnClick;&lt;br /&gt;
 begin&lt;br /&gt;
  Button2.Disable; // This goes to JavaScript Client Code&lt;br /&gt;
 end;&lt;br /&gt;
 &lt;br /&gt;
 begin&lt;br /&gt;
  App.add(Panel);&lt;br /&gt;
  App.add(Button1);&lt;br /&gt;
  App.add(Button2);&lt;br /&gt;
 end.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* die IDE soll ein Verständnis haben dass auf Client-Seite nicht &amp;quot;alles&amp;quot; Programmierbar ist&lt;br /&gt;
* aus den JavaScript Parts soll über einen Dispatcher der nonGUI Code aufbar gemacht werden&lt;br /&gt;
* In einer Datenbank soll das Know-How für die Web Objekte gespeichert sein&lt;br /&gt;
&lt;br /&gt;
== Retry-, Reconnect- Fähig ==&lt;br /&gt;
&lt;br /&gt;
* immer eine lang stehende Keep-Alive TCP Verbindung, mit &amp;quot;Full Reconnect&amp;quot;- und &amp;quot;Client-IP-Change&amp;quot;- Möglichkeit&lt;br /&gt;
* Ein kleines Symbol oder eine Uhr, oder ich weis noch nicht, soll symbolisieren wenn es sich um eine frisch aufgebaute Verbindung handelt&lt;br /&gt;
* Es. soll eine Reconnect auch visualisiert werden, oder auch ein Verbindungsende / Abbruch&lt;br /&gt;
* In der Anfangszeit brauche ich aber ein Feedback das mir beweist dass NICHT immer neue TCP verbindungen aufgebaut werden&lt;br /&gt;
* Der HTTP/2 Server soll eine Modus haben, wo er nur EINE Verbindung EINER IP akzetiert&lt;br /&gt;
&lt;br /&gt;
== Meilensteine ==&lt;br /&gt;
&lt;br /&gt;
 08.12.2023 Feature Freeze: Funktionalität für ServiceWorker und sqlite3.wasm Test ausreichend&lt;br /&gt;
 01.12.2023 RFC: &amp;quot;WINDOW_UPDATE&amp;quot; verbessert&lt;br /&gt;
 26.11.2023 erster &amp;quot;polyzalosd.exe&amp;quot; mit Setup für Win64&lt;br /&gt;
 18.11.2023 Server läuft als Konsolen-App&lt;br /&gt;
 14.11.2023 Auslieferung von DATA&amp;gt;MAX_FRAME_SIZE&lt;br /&gt;
 10.11.2023 openSSL 3.1.4 mit TLS 1.3, erstmals von der RFC 9113 erfahren, Festlegung auf Chrome als Client&lt;br /&gt;
 24.02.2022 openSSL 3.0.1 mit TLS 1.3&lt;br /&gt;
 13.10.2021 Umstellung auf OpenSSL 3, bisher noch mit ACCEPT Fehler&lt;br /&gt;
 23.10.2020 erste Seite wird ausgeliefert&lt;br /&gt;
 12.11.2018 FRAME / HPACK decoding im laufenden Betrieb möglich&lt;br /&gt;
 08.11.2018 Firefox 63 macht leider keine TLS 1.3 Verbindung, aber immerhin TLS 1.2&lt;br /&gt;
 26.06.2018 Firefox 61 mit nativ aktiviertem TLS 1.3 ist erschienen&lt;br /&gt;
 24.11.2017 Erster Client Hello via Read-Thread&lt;br /&gt;
 23.08.2017 Erster Client Hello von Chrome&lt;br /&gt;
 14.08.2017 Erster Client Hello von Firefox&lt;br /&gt;
&lt;br /&gt;
== todo ==&lt;br /&gt;
&lt;br /&gt;
* Linux Version&lt;br /&gt;
* HTTP/2 erste Login Seite&lt;br /&gt;
* OLAP -&amp;gt; Migration auf Console&lt;br /&gt;
* Auswertung -&amp;gt; Migration auf Console&lt;br /&gt;
* OrgaMon Workflow Sheet?!&lt;br /&gt;
* OpenSSL QUIC Server Integration&lt;br /&gt;
&lt;br /&gt;
== Screen-Shots ==&lt;br /&gt;
&lt;br /&gt;
[[Datei:PolyZalos-0.png|200px]]&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33369</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33369"/>
		<updated>2026-03-18T20:18:28Z</updated>

		<summary type="html">&lt;p&gt;Root: /* FreePascal Target Polyzalos */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
* http://www.creaturearchives.com/animalia-chariot-allegory/&lt;br /&gt;
* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Polyzalos Binary&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf ein Web-Verzeichnis&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33368</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33368"/>
		<updated>2026-03-18T20:16:09Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Bezug zu diesem Polyzalos-Projekt */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
* http://www.creaturearchives.com/animalia-chariot-allegory/&lt;br /&gt;
* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Server.exe&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf Web-Bereich&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33367</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33367"/>
		<updated>2026-03-18T20:15:05Z</updated>

		<summary type="html">&lt;p&gt;Root: /* weiter &amp;quot;Poly&amp;quot;- Bezug (=2 Pferde) */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Server.exe&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf Web-Bereich&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33366</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33366"/>
		<updated>2026-03-18T20:14:00Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Namensherkunft */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== weiter &amp;quot;Poly&amp;quot;- Bezug (=2 Pferde) ===&lt;br /&gt;
&lt;br /&gt;
* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* 2 Pferde, Kelpies Falkirk Scotland&lt;br /&gt;
* Er führt ruhig einen Streitwagen mit 2 sehr unterschiedlichen Pferden (Server/Pascal, Browser/JS)&lt;br /&gt;
** ev. auch auseinanderstrebenden Pferden&lt;br /&gt;
&lt;br /&gt;
* http://www.creaturearchives.com/animalia-chariot-allegory/&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Server.exe&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf Web-Bereich&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
	<entry>
		<id>https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33365</id>
		<title>Polyzalos</title>
		<link rel="alternate" type="text/html" href="https://wiki.orgamon.org/index.php?title=Polyzalos&amp;diff=33365"/>
		<updated>2026-03-18T20:13:22Z</updated>

		<summary type="html">&lt;p&gt;Root: /* Bezug zu diesem Polyzalos-Projekt */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}&lt;br /&gt;
&lt;br /&gt;
== Was ist Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)&lt;br /&gt;
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)&lt;br /&gt;
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)&lt;br /&gt;
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)&lt;br /&gt;
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.6, Zeos 8.0, fpspreadsheet 2.0)&lt;br /&gt;
* Anstelle des &amp;quot;GPL-3.0-or-later&amp;quot; Lizenz wird die &amp;quot;MIT&amp;quot; Lizenz verwendet&lt;br /&gt;
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Was bleibt so wie es ist:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* der bisherige Funktionsumfang und Mehrwert&lt;br /&gt;
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)&lt;br /&gt;
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur&lt;br /&gt;
&lt;br /&gt;
== Wie nutzt man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* Vorbereitung, benötigt wird ...&lt;br /&gt;
** ... eine URL, die lokal auf die Maschine des Polyzalos-Servers aufgelöst wird - z.B. &amp;quot;local.orgamon.net&amp;quot;, das wird zu 127.0.0.1 aufgelöst&lt;br /&gt;
** ... ein Zertifikat, das diese Domain bestätigt (Ich verwende dazu das *.orgamon.net Zertifikat)&lt;br /&gt;
** ... ein OrgaMon Verzeichnis lokal oder auf einem NAS&lt;br /&gt;
** ... ein firebird Server mit einer OrgaMon Datenbank&lt;br /&gt;
** ... eine lokale Polyzalos Installation&lt;br /&gt;
* Start der Anwendung &lt;br /&gt;
** Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des lokal installierten Polyzalos-Servers (z.B. &amp;lt;code&amp;gt;https://local.orgamon.net:1443/&amp;lt;/code&amp;gt;)&lt;br /&gt;
&lt;br /&gt;
&amp;lt;b&amp;gt;Download eines ersten Beispiel-Servers:&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html&lt;br /&gt;
* (Linux) -- noch nicht verfügbar --&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
== Wie programmiert man Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
* In der Lazarus-IDE! &lt;br /&gt;
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)&lt;br /&gt;
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)&lt;br /&gt;
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)&lt;br /&gt;
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt&lt;br /&gt;
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung&lt;br /&gt;
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können&lt;br /&gt;
&lt;br /&gt;
* Es wird immer 2fach compiliert&lt;br /&gt;
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat &amp;lt;code&amp;gt;./polyzalos&amp;lt;/code&amp;gt; (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).&lt;br /&gt;
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis&lt;br /&gt;
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden&lt;br /&gt;
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides&lt;br /&gt;
&lt;br /&gt;
== Wie funktioniert Polyzalos ==&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern&lt;br /&gt;
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary&lt;br /&gt;
* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich &amp;quot;nonblocking&amp;quot;, also der Client wartet nie, sondern setzt nur Requests ab&lt;br /&gt;
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers&lt;br /&gt;
&lt;br /&gt;
=== Pure Pascal Prinzip ===&lt;br /&gt;
&lt;br /&gt;
* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein &amp;lt;code&amp;gt;writeln('-b-fett-/b-');&amp;lt;/code&amp;gt; geben&lt;br /&gt;
** Vegas- Prinzip (What Happens Here, Stays Here)&lt;br /&gt;
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal&lt;br /&gt;
* Auf dem Client lauffähiger Code wird zu JavaScript&lt;br /&gt;
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary&lt;br /&gt;
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren&lt;br /&gt;
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout, Provider Switch)&lt;br /&gt;
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein&lt;br /&gt;
&lt;br /&gt;
=== Rückkanal ===&lt;br /&gt;
&lt;br /&gt;
* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model&lt;br /&gt;
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream&lt;br /&gt;
* Dazu öffnet der Client über JavaScript &amp;quot;EventSource()&amp;quot; über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden&lt;br /&gt;
* Client-Seite:&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;script&amp;gt;&lt;br /&gt;
  const source = new EventSource('/log');&lt;br /&gt;
  source.onmessage = function(event) {&lt;br /&gt;
    console.log('Incoming date:' + event.data);&lt;br /&gt;
  };&lt;br /&gt;
  source.addEventListener('notice', (event) =&amp;gt; {&lt;br /&gt;
    console.log(event.data)&lt;br /&gt;
  })&lt;br /&gt;
 &amp;lt;/script&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Asynchron ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten&lt;br /&gt;
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)&lt;br /&gt;
** Ein Worker versucht Antworten vom Server zu erhalten&lt;br /&gt;
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers&lt;br /&gt;
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. &amp;quot;unsaved, =gelb&amp;quot; auf &amp;quot;saved, weiß&amp;quot; zu stellen&lt;br /&gt;
&lt;br /&gt;
=== WVCL-OS (Client) ===&lt;br /&gt;
&lt;br /&gt;
* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)&lt;br /&gt;
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können&lt;br /&gt;
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen&lt;br /&gt;
** Wird UI-OS einmal inkompatibel mit &amp;quot;alten&amp;quot; Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten&lt;br /&gt;
* Um Erfahrung zu sammeln und nicht bei &amp;quot;0&amp;quot; beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]&lt;br /&gt;
&lt;br /&gt;
=== polyzalos.js ===&lt;br /&gt;
&lt;br /&gt;
* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird&lt;br /&gt;
* darin sind lokale &amp;quot;onButtonpressed&amp;quot; Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)&lt;br /&gt;
&lt;br /&gt;
=== ServiceWorker ===&lt;br /&gt;
&lt;br /&gt;
* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung &amp;quot;Offline&amp;quot; Funktionalität&lt;br /&gt;
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)&lt;br /&gt;
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)&lt;br /&gt;
* Er erstellt aus Daten der Datenbank Formulare (statefull)&lt;br /&gt;
&lt;br /&gt;
==== SQLite3.wasm ====&lt;br /&gt;
&lt;br /&gt;
* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)&lt;br /&gt;
* every Request to a &amp;quot;Form&amp;quot; is generated by the ServiceWorker with persistent Data from the DB&lt;br /&gt;
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)&lt;br /&gt;
&lt;br /&gt;
=== PolyzalosD Server ===&lt;br /&gt;
&lt;br /&gt;
* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren&lt;br /&gt;
* Der Server kann Alerts beim Client ausführen&lt;br /&gt;
** https://www.npmjs.com/package/web-push&lt;br /&gt;
&lt;br /&gt;
=== Formulardesigner ===&lt;br /&gt;
&lt;br /&gt;
* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)&lt;br /&gt;
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE&lt;br /&gt;
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden&lt;br /&gt;
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt&lt;br /&gt;
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist&lt;br /&gt;
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)&lt;br /&gt;
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert&lt;br /&gt;
* der Worker erzeugt auf &amp;quot;fetch&amp;quot; der app.js das Formular als html5&lt;br /&gt;
&lt;br /&gt;
** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web&lt;br /&gt;
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden&lt;br /&gt;
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber&lt;br /&gt;
** wfm ist nicht mehr pixelgenau&lt;br /&gt;
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das &amp;quot;Verständnis&amp;quot; der UI&lt;br /&gt;
** wfm ist reactive&lt;br /&gt;
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert&lt;br /&gt;
&lt;br /&gt;
== Namensherkunft ==&lt;br /&gt;
&lt;br /&gt;
=== Historie ===&lt;br /&gt;
&lt;br /&gt;
* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]&lt;br /&gt;
* poly = πολύς = viel&lt;br /&gt;
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz&lt;br /&gt;
* Polyzalos war der siegreiche Wagenlenker von Delphi&lt;br /&gt;
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg&lt;br /&gt;
&lt;br /&gt;
* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt&lt;br /&gt;
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten&lt;br /&gt;
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG&lt;br /&gt;
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als &amp;quot;Eigner&amp;quot; vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!&lt;br /&gt;
** [[Datei:Zuegelhalter.png|100px]]&lt;br /&gt;
** https://www.john-uebersax.com/plato/plato3.htm&lt;br /&gt;
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet&lt;br /&gt;
&lt;br /&gt;
* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg&lt;br /&gt;
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi&lt;br /&gt;
&lt;br /&gt;
=== weiter &amp;quot;Poly&amp;quot;- Bezug (=2 Pferde) ===&lt;br /&gt;
&lt;br /&gt;
* 2 Pferde, Kelpies Falkirk Scotland&lt;br /&gt;
* Er führt ruhig einen Streitwagen mit 2 sehr unterschiedlichen Pferden (Server/Pascal, Browser/JS)&lt;br /&gt;
** ev. auch auseinanderstrebenden Pferden&lt;br /&gt;
&lt;br /&gt;
* http://www.creaturearchives.com/animalia-chariot-allegory/&lt;br /&gt;
&lt;br /&gt;
=== Bezug zu diesem Polyzalos-Projekt ===&lt;br /&gt;
&lt;br /&gt;
* eines der Pferde symbolisiert die JavaScript-Seite des Browsers&lt;br /&gt;
* das andere Pferd symbolisiert die Pascal-Seite des Servers&lt;br /&gt;
&lt;br /&gt;
== Systemvergleich ==&lt;br /&gt;
&lt;br /&gt;
=== Turbo Pascal 1989 ===&lt;br /&gt;
&lt;br /&gt;
* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei &lt;br /&gt;
** Knowhow über den Umgang mit Heap- und Hauptspeicher&lt;br /&gt;
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...&lt;br /&gt;
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)&lt;br /&gt;
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard&lt;br /&gt;
* Grafik wird völlig selbst berechnet und ausgegeben&lt;br /&gt;
&lt;br /&gt;
=== Delphi ===&lt;br /&gt;
&lt;br /&gt;
* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)&lt;br /&gt;
* Es wird an eine MessageLoop des Betriebssystems angedockt und so&lt;br /&gt;
** Click- und Mausevents verarbeitet&lt;br /&gt;
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)&lt;br /&gt;
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet&lt;br /&gt;
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)&lt;br /&gt;
&lt;br /&gt;
=== FreePascal Target Polyzalos ===&lt;br /&gt;
&lt;br /&gt;
* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server &lt;br /&gt;
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis&lt;br /&gt;
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)&lt;br /&gt;
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung&lt;br /&gt;
&lt;br /&gt;
* typischer Entwicklungszyklus&lt;br /&gt;
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden&lt;br /&gt;
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen&lt;br /&gt;
** 1. Compilierung zu einer Server.exe&lt;br /&gt;
** 2. Compilierung zu JavaScript und deploy auf Web-Bereich&lt;br /&gt;
** Der  Pascal-Quelltext soll &amp;quot;debug&amp;quot; infos mit ins JavaScript ausgeben können, so dass ...&lt;br /&gt;
** Start des Servers&lt;br /&gt;
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server&lt;br /&gt;
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird&lt;br /&gt;
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden&lt;br /&gt;
*** https://docs.firefox-dev.tools/backend/protocol.html&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend&lt;br /&gt;
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md&lt;br /&gt;
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour&lt;br /&gt;
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden&lt;br /&gt;
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* typische Server-Funktionen&lt;br /&gt;
** eine Verbindung zu firebird&lt;br /&gt;
** Erstellen und Verarbeiten von Dateien im Dateisystem&lt;br /&gt;
** Uploads- Downloads von/auf anderen Servern&lt;br /&gt;
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)&lt;br /&gt;
** Hosten des Polyzalos Compilates (.js)&lt;br /&gt;
** Hosten der &amp;quot;RTL&amp;quot; (.js)&lt;br /&gt;
* typische Client-Funktionen&lt;br /&gt;
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt &lt;br /&gt;
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist&lt;br /&gt;
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)&lt;br /&gt;
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung&lt;br /&gt;
&lt;br /&gt;
== Roadmap ==&lt;br /&gt;
&lt;br /&gt;
* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht&lt;br /&gt;
* ?.2026: Umstellen auf OpenSSL QUIC Server&lt;br /&gt;
* --v-Past----------------^-Future------------------&lt;br /&gt;
* 18.03.2026 vorregistrieren der zu erwarteten SSEs möglich&lt;br /&gt;
* 03.03.2026 Server-sent events funktioniert&lt;br /&gt;
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!&lt;br /&gt;
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele &amp;quot;imp pend&amp;quot;s &lt;br /&gt;
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version&lt;br /&gt;
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv&lt;br /&gt;
* in 2023 &amp;quot;cOrgaMon&amp;quot; Codeumfang nach Lazarus migriert, HTTP/2 Server&lt;br /&gt;
&lt;br /&gt;
=== TO DO ===&lt;br /&gt;
&lt;br /&gt;
* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md&lt;br /&gt;
* Benutze das PasMP Package, und nicht direkt das PasMP.pas&lt;br /&gt;
* &amp;quot;SQLite3 Worker&amp;quot; innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!&lt;br /&gt;
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt&lt;br /&gt;
&lt;br /&gt;
=== aktuelle Probleme ===&lt;br /&gt;
&lt;br /&gt;
* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden&lt;br /&gt;
** Lösung: Auf das AsyncKKKK verzichten&lt;br /&gt;
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann&lt;br /&gt;
&lt;br /&gt;
=== Screenshot ===&lt;br /&gt;
&lt;br /&gt;
[[Datei:Screenshot 20260225 191731.png]]&lt;br /&gt;
&lt;br /&gt;
== Quellen ==&lt;br /&gt;
&lt;br /&gt;
* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/&lt;br /&gt;
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API&lt;br /&gt;
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker&lt;br /&gt;
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js&lt;br /&gt;
* https://github.com/rhashimoto/wa-sqlite&lt;/div&gt;</summary>
		<author><name>Root</name></author>
	</entry>
</feed>