OrgaMon Wiki - Benutzerbeiträge [de]

OrgaMon-App

2026-04-23T09:34:21Z

OrgaMon: /* OrgaMon-App (3. Generation) */

* Die OrgaMon-App ist der mobile Teil des OrgaMon. Aufträge, die sich im OrgaMon befinden, können auf Android fähige Mobil Geräte (Smartphones, Tablets) übertragen werden. Der Datenabgleich zwischen der OrgaMon-App und OrgaMon erfolgt durch cOrgaMon (Server-Prozess). Der Server ist an das Internet gekoppelt und somit weltweit sichtbar. Der OrgaMon ist über einen FTPS-Ablageplatz mit dem Internet gekoppelt. Der Datenabgleich erfolgt 2x täglich automatisiert (Tagwache & Tagesabschluss) oder auf manuelle Anforderung.
* Als Transportmittel OrgaMon-App<->cOrgaMon wird das Internet benutzt. Dabei wird ihr zugeteilter Firmen-ID (ab sofort immer firma genannt) mit der Domain [[orgamon.net]] zu firma.orgamon.net verbunden. Die Mobilgeräte können durch WLAN oder das mobile Datenfunknetz an das InterNet angekoppelt werden. 
* Die OrgaMon-App ist abgesehen vom manuell angestossenen "Senden" nicht auf eine ständige Online-Verbindung angewiesen

[[MOB]] (OrgaMon-App-Bedienungsanleitung für Monteure) 
[[LOB]] (OrgaMon-App-Bedienungsanleitung für Lageristen) 
[[Protokolle]] Hinweise für die Gestaltung der Auftrags-Protokolle 
Was ist neu? https://github.com/Andreas-Filsinger/OrgaMon/blob/main/rev/OrgaMon-App.rev.txt

[[Datei:Infrastruktur-2043.jpg|220px]] Infrastruktur

== Installation ==
=== Hilfsprogramme ===

* ->Android-Einstellungen (Zahnrad)->Anzeige->Bildschirm-Timeout->auf 30 Min
** Erklärung: OrgaMon-App benutzt einen Hintergrundprozess um die Fotos auf den Server hochzuladen. Seit Android 11 werden Hintergrund-Prozesse von Apps gestoppt wenn die Anwendung selbst nicht mehr im Vordergrund ist. Wenn Sie also das Handy weglegen und das Display deaktivieren (oder es deaktiviert sich durch einen Display-Timeout) bekommt OrgaMon-App nicht mehr genug Zeit um Bilder hochzuladen. Lassen Sie also "abends" die OrgaMon-App im Vordergrund, und lassen Sie das Display aktiv, damit in einem Zug die Bilder übertragen werden können. Spätestens nach 10 Minuten jedoch stoppt Android den Upload-Vorgang, danach müssen Sie wieder "Stop" und "Start" drücken. Eigentlich sollten Sie den von Android erzwungenen "Stop" durch einen "bösen" Ton signalisiert bekommen.
* Im Play-Store zusätzlich installieren
** Slack
** Open Camera (Mark Harmann)
** ZXing Barcode Scanner (Firefox öffnen - als Standard-Browser auswählen - QR-Code scannen - zulassen - herunterladen - öffnen - Einstellungen - aus dieser Quelle zulassen auswählen - installieren), Achtung nur bis einschl. Android Version "13" kompatibel!
** https://cargobay.orgamon.org/BarcodeScanner-4.7.8.apk
*** [[Datei:BarcodeScanner-4.7.8.png|150px]]
** Firefox
** Das Örtliche-App
** Wetter.com

* Im Play-Store alle Updates
* In den Einstellungen (Symbol Zahnrad)
** Software-Update (ziemlich weit unten) -> Herunterladen und installieren -> bis "Ihre Software ist auf dem neuesten Stand"
* In den Einstellungen Apps
** bei "Facebook", die Benachrichtigungen AUS
* Open Camera starten

->Zahnrad oben rechts drücken
->Mehr Kamera Einstellungen
->Benutze Storage Access Framework
-> Pictures
-> DIESEN ORDNER VERWENDEN
-> zulassen
(zurück)
->Foto Einstellungen
->Kamera-Auflösung
-> 1088x1088
-> Bildqualität
-> 68 %
(zurück)
-> Standort Einstellungen
-> Geotagging [v] aktivieren
(zurück)
-> Camera API
-> Camera 2 APIn ( ist automatisch ausgewählt)
(zurück)
(zurück)
(Zulassen bei Benutzung der App)

* ZXing
**Alle Berechtigungen akzeptieren
** Einstellungen, ganz unten 4 Kreuze raus (kein kontinuierlicher Fokus, keine Belichtungsmessung, keine Dosierung, kein Barcode-Szene-Modus), Foto LED an

=== OrgaMon-App ===

* Starten Sie den Firefox-Browser, tippen Sie auf das Eingabefeld "Suche oder Adresse", oberhalb erscheint nun "() Scannen", dies drücken
* Scannen Sie folgenden QR Code
** [[Datei:OrgaMon-App-2050.png|200px]]
** Sollte der Scan nicht möglich sein, kann man manuell die Internetadresse eingeben, aktuellste Version August´2025
** <code>https://hidrive.ionos.com/lnk/d0pCn6CPO</code>
* [Erlauben, Zulassen, Zulassen] Herunterladen -> [Einstellungen, Aus dieser Quelle zulassen, Zurück] Installieren, Öffnen
* Hier endet die Anleitung wenn Sie nur ein Update machen

* Einstellungen (Zahnrad) -> Apps -> Lupe: "org" eingeben -> OrgaMon wählen
** -> Berechtigungen -> "Kamera" zulassen, zurück, "Speicher" zulassen, zurück
** "Berechtigung für ungenutzte App entfernen" deaktivieren
** Zurück, Zurück
* Aus den Einstellungen (Symbol Zahnrad)->Telefoninfo (ziemlich weit unten)->lange auf IMEI (Steckplatz 1) drücken, bis es in der Zwischenablage ist
* OrgaMon-App: In Einstellungen die Geräte Nummer: 000 löschen und 2 Sekunden lang auf das Eingabefeld drücken dann loslassen, dann Einfügen wählen (die kopierte IMEI von eben), dann weiter, dann ok, "Speichern"
** Die IMEI verschwindet wieder
* Nun das 9 stellige Firmen-Passwort bei Geräte Nummer: eingeben (zuvor auch wieder die 000 rausmachen), dann weiter, dann ok, dann "Speichern"
** Das Passwort verschwindet wieder
* Nun keine oder mehrere 4 stelligen Firmen-Optionen eingeben, dann weiter, dann ok, dann "Speichern"
** Die Option verschwindet wieder
* Bei Firma:, ihr Firmenkürzel in Kleinbuchstaben eintippen, speichern
* Menü (Symbol "drei Punkte untereinander") -> Senden
** bei Aktualität: muss nun ein aktuelles Datum und Uhrzeit von eben stehen

== Firmen Optionen ==

{|class="wikitable"
|-
!Option
!Wirkung
!Default
|-
|1000
|alle Optionen werden wieder auf Ihren Defaultwert gesetzt
|
|-
|1001
|Fotopfad ist "/mnt/sdcard/DCIM/Camera"
|1005
|-
|1002
|Fotopfad ist "/mnt/sdcard/DCIM/100ANDRO"
|1005
|-
|1003
|Fotopfad ist "/storage/extSdCard/DCIM/Camera"
|1005
|-
|1004
|Fotopfad ist "/storage/emulated/0/DCIM/Camera"
|1005
|-
|1005
|Fotopfad ist "/storage/emulated/0/Pictures"
|JA
|-
|1006
|FTP wird verwendet
|FTPS wird verwendet
|-
|1007
|FTP-Host ist "ftp.local"
|FTP-Host ist firma.orgamon.net
|-
|1008
|Fotos werden durch die Camera-App bestätigt
|Fotos werden durch die OrgaMon-App bestätigt
|-
|}

== Fehlermeldungen ==

* HTTP 504, Ursache: nginx läuft aber [[COrgaMon#id_App|XMLRPC]] läuft nicht
* Chain validation failed, Ursache: Es wurde vergessen das Zertifikat firma.[[orgamon.net]] zu aktualisieren

== Mandant wechseln ==

* OrgaMon-App kann mit dem selben Handy unter verschiedenen Firmen-Kennungen betrieben werden
* Eine Neuinstallation der App ist für einen Wechsel nicht nötig, in den Einstellungen können alle notwendigen Parameter verändert werden
* Die IMEI wird dabei nicht verändert, ein intern Wert (SALT) identifiziert die Installation gegenüber dem Server
* Monteure mit eigenen Geräte Nummern und IMEI müssen vertraglich im OrgaMon angelegt werden
* Die Lizenzdateien (IMEI.csv, IMEI-OK.csv) müssen ausgespielt werden, und der cOrgaMon-Dienst muss neu gestartet werden
 
* "Senden" Sie ihre Daten um sicherzustellen dass alle Eingaben vom Server verarbeitet werden
* Stellen Sie sicher, dass ALLE Fotos übertragen sind (Stichwort "u"). (Das ist sehr wichtig da Restbilder, werden Sie erst nach der Umstellung übertragen, vom neuen Server nicht zugeordnet werden können, oder völlig falsch zugeordnet werden)
* Gehen Sie nun in die OrgaMon-App Einstellungen und ...
* Geben bei <code>Geräte Nummer</code> 000 ein
* Nun nochmals im Menü <code>Senden</code>, die Anzahl der Aufträge muss nun "0" sein
 
* Geben Sie bei <code>Firma:</code>die Firmen-ID des gewünschten neuen Mandanten ein, <speichern>
* Tätigen Sie nun Eingaben immer im Feld <code>Geräte Nummer:</code>
** das zur Firma gehörige Passwort, danach <speichern>
** 1000, danach <speichern>
** gegebenenfalls Firmen-Optionen, danach <speichern>
** Stellen Sie nun die Geräte-ID auf den richtigen, zum Monteur passenden 3stelligen Wert, wieder <speichern>
 
* Nun nochmals <code>Senden</code>, prüfen Sie abschließend die Anzahl der Aufträge

== offene Probleme ==

=== Android 11 ===

* <s>Camera MX läuft nicht</s> stelle um auf OpenCamera (ab Rev. 2.044)
* <s>Über das Intent kann man keine 3rd Party Camera App mehr starten</s> Lösung durch explizite Angabe "Open Camera" (ab Rev. 2.044)
* Hintergrund Prozess für den Upload wird willkürlich von Android 11 gestoppt
** Android 11 stoppt grundsätzlich den Hintergrundprozess wenn der Vordergrundprozess pausiert oder beendet wird
** Workaround ist es zu versuchen dass OrgaMon-App möglichst immer im Vordergrund bleibt
** ->Einstellungen->Anzeige->Bildschirm-Timeout->auf 30 Min

=== Android 13 ===

* ZXING Barcode Scanner wird nicht mehr angeboten (Lösung: Hosting auf cargobay)

=== Android Studio ===

* Samsung Android Developer UBS Treiber benutzen
* auf dem Handy "MIDI" ankreuzen

==== falsches apk-Dateiformat ====

* ganzes "Build-Verzeichnis" komplett leeren (.\app\build\*)
* "Build"->"Clean Project" machen
* "Build"->"Build Bundels/APK"->Build APK machen
* sicherstellen dass app\build\outputs\apk\debug\app-debug.apk die "richtige" Dateigrösse hat

=== Geblockte Fotos / Ausstehende Fotos ===

* Der Fehler zeigt sich dadurch dass Foto-Dateien zwar von der OrgaMon-App gesehen - aber nicht umbenannt werden können
** dadurch werden sie NICHT per FTP übertragen und verbleiben auf dem Handy
** in älteren OrgaMon-App Versionen führte es dazu, dass diese Datei endlos übertragen wurde
** Es gibt einzelne Geblockte Fotos, danach wieder Zeiten wo es funktioniert, es sind immer nur 1 oder 2 Dateien gestört
*** z.B. 8.12, 12.01, 15.06, 20.06., 22.06, 15.05, 26.06., 28.06

* neue OrgaMon-App Versionen machen eine Test-Umbenennung in t<alter Dateiname> kurios: Es gibt fälle da gelingt die "t" Umbenennung noch, die "Rückumbenennung" nicht mehr!
* Aktuelle Vermutung: Eine Cloud oder Backup-App könnte die Dateien ev. sperren, Gründe hierfür sind spekulativ

Aktuelle Lösung:
*Wenn das Foto mit WLAN und Ladekabel nicht übertragen werden kann, mit *A* in MonteurInfo kennzeichen und entsprechend deklarieren
*Monteur RID zukommen lassen, dass er das Foto auf dem Handy sucht
*Monteur muss Foto per Mail zusenden und unter "J:\OrgaMon\Handy-Server\ftp" hinterlegen --> Orgamon wird simuliert, dass das Foto auf herkömmlichen Weg übertragen wurde --> Foto verschwindet bei den ausstehendes Fotos im App-Server-Dashboard
*Bild wird automatisch der zugehörigen Internetablage zugeordnen - Foto über Transaktion LU1 auf J transferieren - Überprüfung mit Doppelklick im Protokollfeld, ob das Foto da ist - Datenmeldung auslösen
*Überprüfung vom Monteur durch erneutes senden und start, ob das Foto noch auf dem Handy ist --> wenn das Foto noch auf dem Handy ist, muss dieses gelöscht werden!!!
**Orgamon versucht ansonsten, immer wieder das Foto zu übertragen

=== Foto wird immer wieder übertragen ===
*Wenn ein Foto X-Mal übertragen wird und immer wieder auf der Interablage der STW ist, muss der Monteur das Foto auf dem Handy löschen. Dadurch wird die Bildübertragung gestoppt.
*in der Datei "J:\OrgaMon\Handy-Server\log\FotoService-Transaktionen.log.txt" (über Notepad öffnen) kann über die Suchfunktion - zählen nach dem RID gesucht und gezählt werden, wie oft das Foto schon übertragen wurde

== Historie ==

* OrgaMon-App ist der Nachfolger von JonDa
* JonDa ist der Nachfolger von MonDa

=== Handys im Einsatz ===

{|
|style="vertical-align:top;"|[[Bild:XCover-4s.jpg|85px]] Samsung Galaxy XCover 4s (Produktiv seit Oktober 2019) Android 9.0.0 API level 28 Android 10.0.0 API level 29 Android 11.0.0 API level 30
|style="vertical-align:top;"|[[Bild:Samsung-galaxy-xcover5.jpg|85px]] Samsung Galaxy XCover 5 (Produktiv seit Juni 2021) Android 11.0.0 API level 30 Android 12.0.0 API level 31 Android 13 API level 32
|
|}

=== MonDa (1. Generation) ===

* Turbo-Pascal-Entwicklung (i386 System unter MS-DOS)
* Transfer via der GSM-Modem Funktion von damaligen Handys

{|
|[[Bild:6400.jpg|65px]] Falcon i386 MS-DOS Produktiv ab Juni 2002
|-
|}

=== JonDa (2. Generation) ===

* J2ME Entwicklung
* Transfer via Internet Verbindung der Handys

{|
|[[Bild:SX1_Front_a.jpg|65px]] Siemens SX1 (Prototyp 2001) 
|[[Bild:6630.png]] Nokia 6630 (bis 2007)
|[[Bild:NokiaN73-90x163.jpg]] Nokia N73 (ab 2007) Code 0541151 Version
|[[Bild:Nokia-2630.png|65px]] Nokia 2630 (Ableser) 
|[[Bild:Nokia-6303.png|65px]] Nokia 6303 (ab 2009) 
|-
|}
 

[[JonDa.Anwender|Bedienungsanleitung für Monteure]] 
[[JonDa.Zertifizierung|Zertifizierung]] 
[[JonDa.Setup Protokoll]] 
[[Foto]] [[Medien]] 

=== OrgaMon-App (3. Generation) ===

* interner Projektname war [[AmDa]], "OrgaMon-MOB"
* Java am Android-API Entwicklung
* Daten-Transfers via Internet Verbindung des Smartphones

{|
|[[Bild:Samsung-galaxy3_i5800.jpg|65px]] Samsung Galaxy 3 (Prototyp I ab 2011) 
|[[Bild:Samsung-ace.jpg|75px]] Samsung Galaxy ACE (Prototyp II ab August 2011)
|[[Bild:Samsung-Galaxy-Ace-Plus.png|95px]] Samsung Galaxy ACE Plus (Produktiv seit Januar 2012)
|-
|[[Bild:Samsung-Galaxy-Ace-2.png|165px]] Samsung Galaxy ACE 2 (Produktiv seit Oktober 2012)
|[[Bild:Samsung-galaxy-xcover-2.jpg|130px]] Samsung XCover 2 (Produktiv seit Mai 2013)
|-
|[[Bild:ACE_3.png|95px]] Samsung Galaxy ACE 3 (Fokusprobleme seit Oktober 2014)
|[[Bild:ACE_4.png|95px]] Samsung Galaxy ACE 4 (Produktiv seit Februar 2015)
|[[Bild:XCover_3.png|95px]] Samsung Galaxy XCover 3 (Produktiv seit Mai 2015) Android 5.1.1 API level 22
|[[Bild:XCover_3.png|95px]] Samsung Galaxy XCover 3 VE (Produktiv seit Oktober 2016) Android 6.0.1 API level 23
|-
|style="vertical-align:top;"|[[Bild:XCover-4s.jpg|85px]] Samsung Galaxy XCover 4 (Produktiv seit April 2019) Android 8.1.0 API level 27 Android 9.0.0 API level 28
|[[Bild:Ulefone_Note_16_Pro.png|95px]] Ulefone Note 16 Pro (Produktiv seit Januar 2026) Android 13.0.1 API level 33
|-
|}

== Verbesserungsvorschläge ==

{{ToDo|1=
* Pflichtfelder
* Noch aus MonDa: Plausibilitätskontrolle Zählerstand alt ""
* Noch aus MonDa: Plausibilitätskontrolle Zählerstand neu ""
* Noch aus MonDa: Liste der möglichen (freien) Zählernummern neu
* Ampellösung für Bilder
* Protokoll Autostart im Feld "Ausbau"-Stand
* "Hold" um Datensendung zu Verhindern oder "Storno"
* <s>ZZ=N soll wieder gelb werden</s>
* <s>Telefonnummer aus den Infos rauskopierbar</s>
* <s>Zählerinfos vergrössern</s>
* Zählernummer vergrössern
* Anzahl der ungesendeten Fotos in der Notification Number des Desktop Symbols
* BarCode umstellen auf
** https://developers.google.com/ml-kit/vision/barcode-scanning/android?hl=de
** https://developers.google.com/ml-kit/vision/barcode-scanning/code-scanner?hl=de
** https://code.tutsplus.com/android-sdk-create-a-barcode-reader--mobile-17162t
** Alternativ: https://github.com/zxing/zxing
* FTP Hintergrund Upload
** https://github.com/gotev/android-upload-service
}}

OrgaMon-App

2026-04-23T09:32:51Z

OrgaMon: /* OrgaMon-App (3. Generation) */

* Die OrgaMon-App ist der mobile Teil des OrgaMon. Aufträge, die sich im OrgaMon befinden, können auf Android fähige Mobil Geräte (Smartphones, Tablets) übertragen werden. Der Datenabgleich zwischen der OrgaMon-App und OrgaMon erfolgt durch cOrgaMon (Server-Prozess). Der Server ist an das Internet gekoppelt und somit weltweit sichtbar. Der OrgaMon ist über einen FTPS-Ablageplatz mit dem Internet gekoppelt. Der Datenabgleich erfolgt 2x täglich automatisiert (Tagwache & Tagesabschluss) oder auf manuelle Anforderung.
* Als Transportmittel OrgaMon-App<->cOrgaMon wird das Internet benutzt. Dabei wird ihr zugeteilter Firmen-ID (ab sofort immer firma genannt) mit der Domain [[orgamon.net]] zu firma.orgamon.net verbunden. Die Mobilgeräte können durch WLAN oder das mobile Datenfunknetz an das InterNet angekoppelt werden. 
* Die OrgaMon-App ist abgesehen vom manuell angestossenen "Senden" nicht auf eine ständige Online-Verbindung angewiesen

[[MOB]] (OrgaMon-App-Bedienungsanleitung für Monteure) 
[[LOB]] (OrgaMon-App-Bedienungsanleitung für Lageristen) 
[[Protokolle]] Hinweise für die Gestaltung der Auftrags-Protokolle 
Was ist neu? https://github.com/Andreas-Filsinger/OrgaMon/blob/main/rev/OrgaMon-App.rev.txt

[[Datei:Infrastruktur-2043.jpg|220px]] Infrastruktur

== Installation ==
=== Hilfsprogramme ===

* ->Android-Einstellungen (Zahnrad)->Anzeige->Bildschirm-Timeout->auf 30 Min
** Erklärung: OrgaMon-App benutzt einen Hintergrundprozess um die Fotos auf den Server hochzuladen. Seit Android 11 werden Hintergrund-Prozesse von Apps gestoppt wenn die Anwendung selbst nicht mehr im Vordergrund ist. Wenn Sie also das Handy weglegen und das Display deaktivieren (oder es deaktiviert sich durch einen Display-Timeout) bekommt OrgaMon-App nicht mehr genug Zeit um Bilder hochzuladen. Lassen Sie also "abends" die OrgaMon-App im Vordergrund, und lassen Sie das Display aktiv, damit in einem Zug die Bilder übertragen werden können. Spätestens nach 10 Minuten jedoch stoppt Android den Upload-Vorgang, danach müssen Sie wieder "Stop" und "Start" drücken. Eigentlich sollten Sie den von Android erzwungenen "Stop" durch einen "bösen" Ton signalisiert bekommen.
* Im Play-Store zusätzlich installieren
** Slack
** Open Camera (Mark Harmann)
** ZXing Barcode Scanner (Firefox öffnen - als Standard-Browser auswählen - QR-Code scannen - zulassen - herunterladen - öffnen - Einstellungen - aus dieser Quelle zulassen auswählen - installieren), Achtung nur bis einschl. Android Version "13" kompatibel!
** https://cargobay.orgamon.org/BarcodeScanner-4.7.8.apk
*** [[Datei:BarcodeScanner-4.7.8.png|150px]]
** Firefox
** Das Örtliche-App
** Wetter.com

* Im Play-Store alle Updates
* In den Einstellungen (Symbol Zahnrad)
** Software-Update (ziemlich weit unten) -> Herunterladen und installieren -> bis "Ihre Software ist auf dem neuesten Stand"
* In den Einstellungen Apps
** bei "Facebook", die Benachrichtigungen AUS
* Open Camera starten

->Zahnrad oben rechts drücken
->Mehr Kamera Einstellungen
->Benutze Storage Access Framework
-> Pictures
-> DIESEN ORDNER VERWENDEN
-> zulassen
(zurück)
->Foto Einstellungen
->Kamera-Auflösung
-> 1088x1088
-> Bildqualität
-> 68 %
(zurück)
-> Standort Einstellungen
-> Geotagging [v] aktivieren
(zurück)
-> Camera API
-> Camera 2 APIn ( ist automatisch ausgewählt)
(zurück)
(zurück)
(Zulassen bei Benutzung der App)

* ZXing
**Alle Berechtigungen akzeptieren
** Einstellungen, ganz unten 4 Kreuze raus (kein kontinuierlicher Fokus, keine Belichtungsmessung, keine Dosierung, kein Barcode-Szene-Modus), Foto LED an

=== OrgaMon-App ===

* Starten Sie den Firefox-Browser, tippen Sie auf das Eingabefeld "Suche oder Adresse", oberhalb erscheint nun "() Scannen", dies drücken
* Scannen Sie folgenden QR Code
** [[Datei:OrgaMon-App-2050.png|200px]]
** Sollte der Scan nicht möglich sein, kann man manuell die Internetadresse eingeben, aktuellste Version August´2025
** <code>https://hidrive.ionos.com/lnk/d0pCn6CPO</code>
* [Erlauben, Zulassen, Zulassen] Herunterladen -> [Einstellungen, Aus dieser Quelle zulassen, Zurück] Installieren, Öffnen
* Hier endet die Anleitung wenn Sie nur ein Update machen

* Einstellungen (Zahnrad) -> Apps -> Lupe: "org" eingeben -> OrgaMon wählen
** -> Berechtigungen -> "Kamera" zulassen, zurück, "Speicher" zulassen, zurück
** "Berechtigung für ungenutzte App entfernen" deaktivieren
** Zurück, Zurück
* Aus den Einstellungen (Symbol Zahnrad)->Telefoninfo (ziemlich weit unten)->lange auf IMEI (Steckplatz 1) drücken, bis es in der Zwischenablage ist
* OrgaMon-App: In Einstellungen die Geräte Nummer: 000 löschen und 2 Sekunden lang auf das Eingabefeld drücken dann loslassen, dann Einfügen wählen (die kopierte IMEI von eben), dann weiter, dann ok, "Speichern"
** Die IMEI verschwindet wieder
* Nun das 9 stellige Firmen-Passwort bei Geräte Nummer: eingeben (zuvor auch wieder die 000 rausmachen), dann weiter, dann ok, dann "Speichern"
** Das Passwort verschwindet wieder
* Nun keine oder mehrere 4 stelligen Firmen-Optionen eingeben, dann weiter, dann ok, dann "Speichern"
** Die Option verschwindet wieder
* Bei Firma:, ihr Firmenkürzel in Kleinbuchstaben eintippen, speichern
* Menü (Symbol "drei Punkte untereinander") -> Senden
** bei Aktualität: muss nun ein aktuelles Datum und Uhrzeit von eben stehen

== Firmen Optionen ==

{|class="wikitable"
|-
!Option
!Wirkung
!Default
|-
|1000
|alle Optionen werden wieder auf Ihren Defaultwert gesetzt
|
|-
|1001
|Fotopfad ist "/mnt/sdcard/DCIM/Camera"
|1005
|-
|1002
|Fotopfad ist "/mnt/sdcard/DCIM/100ANDRO"
|1005
|-
|1003
|Fotopfad ist "/storage/extSdCard/DCIM/Camera"
|1005
|-
|1004
|Fotopfad ist "/storage/emulated/0/DCIM/Camera"
|1005
|-
|1005
|Fotopfad ist "/storage/emulated/0/Pictures"
|JA
|-
|1006
|FTP wird verwendet
|FTPS wird verwendet
|-
|1007
|FTP-Host ist "ftp.local"
|FTP-Host ist firma.orgamon.net
|-
|1008
|Fotos werden durch die Camera-App bestätigt
|Fotos werden durch die OrgaMon-App bestätigt
|-
|}

== Fehlermeldungen ==

* HTTP 504, Ursache: nginx läuft aber [[COrgaMon#id_App|XMLRPC]] läuft nicht
* Chain validation failed, Ursache: Es wurde vergessen das Zertifikat firma.[[orgamon.net]] zu aktualisieren

== Mandant wechseln ==

* OrgaMon-App kann mit dem selben Handy unter verschiedenen Firmen-Kennungen betrieben werden
* Eine Neuinstallation der App ist für einen Wechsel nicht nötig, in den Einstellungen können alle notwendigen Parameter verändert werden
* Die IMEI wird dabei nicht verändert, ein intern Wert (SALT) identifiziert die Installation gegenüber dem Server
* Monteure mit eigenen Geräte Nummern und IMEI müssen vertraglich im OrgaMon angelegt werden
* Die Lizenzdateien (IMEI.csv, IMEI-OK.csv) müssen ausgespielt werden, und der cOrgaMon-Dienst muss neu gestartet werden
 
* "Senden" Sie ihre Daten um sicherzustellen dass alle Eingaben vom Server verarbeitet werden
* Stellen Sie sicher, dass ALLE Fotos übertragen sind (Stichwort "u"). (Das ist sehr wichtig da Restbilder, werden Sie erst nach der Umstellung übertragen, vom neuen Server nicht zugeordnet werden können, oder völlig falsch zugeordnet werden)
* Gehen Sie nun in die OrgaMon-App Einstellungen und ...
* Geben bei <code>Geräte Nummer</code> 000 ein
* Nun nochmals im Menü <code>Senden</code>, die Anzahl der Aufträge muss nun "0" sein
 
* Geben Sie bei <code>Firma:</code>die Firmen-ID des gewünschten neuen Mandanten ein, <speichern>
* Tätigen Sie nun Eingaben immer im Feld <code>Geräte Nummer:</code>
** das zur Firma gehörige Passwort, danach <speichern>
** 1000, danach <speichern>
** gegebenenfalls Firmen-Optionen, danach <speichern>
** Stellen Sie nun die Geräte-ID auf den richtigen, zum Monteur passenden 3stelligen Wert, wieder <speichern>
 
* Nun nochmals <code>Senden</code>, prüfen Sie abschließend die Anzahl der Aufträge

== offene Probleme ==

=== Android 11 ===

* <s>Camera MX läuft nicht</s> stelle um auf OpenCamera (ab Rev. 2.044)
* <s>Über das Intent kann man keine 3rd Party Camera App mehr starten</s> Lösung durch explizite Angabe "Open Camera" (ab Rev. 2.044)
* Hintergrund Prozess für den Upload wird willkürlich von Android 11 gestoppt
** Android 11 stoppt grundsätzlich den Hintergrundprozess wenn der Vordergrundprozess pausiert oder beendet wird
** Workaround ist es zu versuchen dass OrgaMon-App möglichst immer im Vordergrund bleibt
** ->Einstellungen->Anzeige->Bildschirm-Timeout->auf 30 Min

=== Android 13 ===

* ZXING Barcode Scanner wird nicht mehr angeboten (Lösung: Hosting auf cargobay)

=== Android Studio ===

* Samsung Android Developer UBS Treiber benutzen
* auf dem Handy "MIDI" ankreuzen

==== falsches apk-Dateiformat ====

* ganzes "Build-Verzeichnis" komplett leeren (.\app\build\*)
* "Build"->"Clean Project" machen
* "Build"->"Build Bundels/APK"->Build APK machen
* sicherstellen dass app\build\outputs\apk\debug\app-debug.apk die "richtige" Dateigrösse hat

=== Geblockte Fotos / Ausstehende Fotos ===

* Der Fehler zeigt sich dadurch dass Foto-Dateien zwar von der OrgaMon-App gesehen - aber nicht umbenannt werden können
** dadurch werden sie NICHT per FTP übertragen und verbleiben auf dem Handy
** in älteren OrgaMon-App Versionen führte es dazu, dass diese Datei endlos übertragen wurde
** Es gibt einzelne Geblockte Fotos, danach wieder Zeiten wo es funktioniert, es sind immer nur 1 oder 2 Dateien gestört
*** z.B. 8.12, 12.01, 15.06, 20.06., 22.06, 15.05, 26.06., 28.06

* neue OrgaMon-App Versionen machen eine Test-Umbenennung in t<alter Dateiname> kurios: Es gibt fälle da gelingt die "t" Umbenennung noch, die "Rückumbenennung" nicht mehr!
* Aktuelle Vermutung: Eine Cloud oder Backup-App könnte die Dateien ev. sperren, Gründe hierfür sind spekulativ

Aktuelle Lösung:
*Wenn das Foto mit WLAN und Ladekabel nicht übertragen werden kann, mit *A* in MonteurInfo kennzeichen und entsprechend deklarieren
*Monteur RID zukommen lassen, dass er das Foto auf dem Handy sucht
*Monteur muss Foto per Mail zusenden und unter "J:\OrgaMon\Handy-Server\ftp" hinterlegen --> Orgamon wird simuliert, dass das Foto auf herkömmlichen Weg übertragen wurde --> Foto verschwindet bei den ausstehendes Fotos im App-Server-Dashboard
*Bild wird automatisch der zugehörigen Internetablage zugeordnen - Foto über Transaktion LU1 auf J transferieren - Überprüfung mit Doppelklick im Protokollfeld, ob das Foto da ist - Datenmeldung auslösen
*Überprüfung vom Monteur durch erneutes senden und start, ob das Foto noch auf dem Handy ist --> wenn das Foto noch auf dem Handy ist, muss dieses gelöscht werden!!!
**Orgamon versucht ansonsten, immer wieder das Foto zu übertragen

=== Foto wird immer wieder übertragen ===
*Wenn ein Foto X-Mal übertragen wird und immer wieder auf der Interablage der STW ist, muss der Monteur das Foto auf dem Handy löschen. Dadurch wird die Bildübertragung gestoppt.
*in der Datei "J:\OrgaMon\Handy-Server\log\FotoService-Transaktionen.log.txt" (über Notepad öffnen) kann über die Suchfunktion - zählen nach dem RID gesucht und gezählt werden, wie oft das Foto schon übertragen wurde

== Historie ==

* OrgaMon-App ist der Nachfolger von JonDa
* JonDa ist der Nachfolger von MonDa

=== Handys im Einsatz ===

{|
|style="vertical-align:top;"|[[Bild:XCover-4s.jpg|85px]] Samsung Galaxy XCover 4s (Produktiv seit Oktober 2019) Android 9.0.0 API level 28 Android 10.0.0 API level 29 Android 11.0.0 API level 30
|style="vertical-align:top;"|[[Bild:Samsung-galaxy-xcover5.jpg|85px]] Samsung Galaxy XCover 5 (Produktiv seit Juni 2021) Android 11.0.0 API level 30 Android 12.0.0 API level 31 Android 13 API level 32
|
|}

=== MonDa (1. Generation) ===

* Turbo-Pascal-Entwicklung (i386 System unter MS-DOS)
* Transfer via der GSM-Modem Funktion von damaligen Handys

{|
|[[Bild:6400.jpg|65px]] Falcon i386 MS-DOS Produktiv ab Juni 2002
|-
|}

=== JonDa (2. Generation) ===

* J2ME Entwicklung
* Transfer via Internet Verbindung der Handys

{|
|[[Bild:SX1_Front_a.jpg|65px]] Siemens SX1 (Prototyp 2001) 
|[[Bild:6630.png]] Nokia 6630 (bis 2007)
|[[Bild:NokiaN73-90x163.jpg]] Nokia N73 (ab 2007) Code 0541151 Version
|[[Bild:Nokia-2630.png|65px]] Nokia 2630 (Ableser) 
|[[Bild:Nokia-6303.png|65px]] Nokia 6303 (ab 2009) 
|-
|}
 

[[JonDa.Anwender|Bedienungsanleitung für Monteure]] 
[[JonDa.Zertifizierung|Zertifizierung]] 
[[JonDa.Setup Protokoll]] 
[[Foto]] [[Medien]] 

=== OrgaMon-App (3. Generation) ===

* interner Projektname war [[AmDa]], "OrgaMon-MOB"
* Java am Android-API Entwicklung
* Daten-Transfers via Internet Verbindung des Smartphones

{|
|[[Bild:Samsung-galaxy3_i5800.jpg|65px]] Samsung Galaxy 3 (Prototyp I ab 2011) 
|[[Bild:Samsung-ace.jpg|75px]] Samsung Galaxy ACE (Prototyp II ab August 2011)
|[[Bild:Samsung-Galaxy-Ace-Plus.png|95px]] Samsung Galaxy ACE Plus (Produktiv seit Januar 2012)
|-
|[[Bild:Samsung-Galaxy-Ace-2.png|165px]] Samsung Galaxy ACE 2 (Produktiv seit Oktober 2012)
|[[Bild:Samsung-galaxy-xcover-2.jpg|130px]] Samsung XCover 2 (Produktiv seit Mai 2013)
|-
|[[Bild:ACE_3.png|95px]] Samsung Galaxy ACE 3 (Fokusprobleme seit Oktober 2014)
|[[Bild:ACE_4.png|95px]] Samsung Galaxy ACE 4 (Produktiv seit Februar 2015)
|[[Bild:XCover_3.png|95px]] Samsung Galaxy XCover 3 (Produktiv seit Mai 2015) Android 5.1.1 API level 22
|[[Bild:XCover_3.png|95px]] Samsung Galaxy XCover 3 VE (Produktiv seit Oktober 2016) Android 6.0.1 API level 23
|-
|style="vertical-align:top;"|[[Bild:XCover-4s.jpg|85px]] Samsung Galaxy XCover 4 (Produktiv seit April 2019) Android 8.1.0 API level 27 Android 9.0.0 API level 28
|[[Bild:Ulefone_Note_16_Pro.png|95px]] Ulefone Note 16 Pro (Produktiv seit Januar2025) Android 13.0.1 API level 33
|-
|}

== Verbesserungsvorschläge ==

{{ToDo|1=
* Pflichtfelder
* Noch aus MonDa: Plausibilitätskontrolle Zählerstand alt ""
* Noch aus MonDa: Plausibilitätskontrolle Zählerstand neu ""
* Noch aus MonDa: Liste der möglichen (freien) Zählernummern neu
* Ampellösung für Bilder
* Protokoll Autostart im Feld "Ausbau"-Stand
* "Hold" um Datensendung zu Verhindern oder "Storno"
* <s>ZZ=N soll wieder gelb werden</s>
* <s>Telefonnummer aus den Infos rauskopierbar</s>
* <s>Zählerinfos vergrössern</s>
* Zählernummer vergrössern
* Anzahl der ungesendeten Fotos in der Notification Number des Desktop Symbols
* BarCode umstellen auf
** https://developers.google.com/ml-kit/vision/barcode-scanning/android?hl=de
** https://developers.google.com/ml-kit/vision/barcode-scanning/code-scanner?hl=de
** https://code.tutsplus.com/android-sdk-create-a-barcode-reader--mobile-17162t
** Alternativ: https://github.com/zxing/zxing
* FTP Hintergrund Upload
** https://github.com/gotev/android-upload-service
}}

2026-03-19T13:23:21Z

OrgaMon: /* bereitgestellte Daten */

Schnittstelle.WMF.iMSys

2026-03-19T12:13:33Z

OrgaMon: /* bereitgestellte Daten */

== Import ==

=== bereitgestellte Daten ===

Daten werden in einer XLSX (WFC-Export) bereitgestellt. Setze eine Filter auf Geräteaktion - Ausbau. Markiere Doppelte Zählernummern. Sortiere nach Z-Nr und OBiS Kennung. Füge eine neue Spalte
ZWRK ein und Nummeriere je Zählwerk durch 1,2,3 usw.

2026-02-27T11:40:52Z

Datei:H-nummer.png

2026-02-20T12:36:46Z

OrgaMon: OrgaMon lud eine neue Version von Datei:H-nummer.png hoch

Lazarus

2025-12-22T15:06:36Z

OrgaMon: /* erforderliche Freepascal-Packages (Online-Paket-Manager) */

Die Lazarus-IDE (http://lazarus-ide.org/) ist eine freie Open-Source Entwicklungsumgebung für den Freepascal-Compiler. OrgaMon wird im Moment komplett auf die Lazarus IDE migriert. Die Delphi GUI (VCL) wird dabei völlig entfallen (siehe [[OrgaMon-next]]).

[[Datei:Lazarus.png|200px]]

Mit dem Einzug von Lazarus in die OrgaMon Entwicklung gibt es Bestrebungen keinerlei kommerziellen Komponenten für OrgaMon mehr einzusetzen. Das betrifft den Wegfall folgender Komponenten:

Delphi, TMS Flexcell, IBObjects

Welche ist die aktuellste Version? : https://github.com/fpc/Lazarus/tags
== Installation ==

=== Windows ===

* https://sourceforge.net/projects/lazarus/files/Lazarus%20Windows%2064%20bits/

=== openSuSE 41.2 64bit ===

leider läuft Lazarus 1.6.2 (1.6.4 nicht getestet) bei mir nicht "Out of The Box", im Moment sind 2 Schritte notwendig:

* Fehlermeldung: cursors.res hat das falsche Format
** 1) kopiere ./OrgaMon/HTTP2/*.res nach

raib27:/usr/lib64/lazarus/lcl/units/x86_64-linux # l *.res
-rw-r--r-- 1 root root 8812 Feb 14 15:34 btn_icons.res
-rw-r--r-- 1 root root 4876 Feb 14 15:29 cursors.res
-rw-r--r-- 1 root root 8907 Feb 14 15:35 dialog_icons.res
-rw-r--r-- 1 root root 1567 Feb 14 15:36 lcl_dbgrid_images.res
-rw-r--r-- 1 root root 6700 Feb 14 15:37 lcl_dbnav_images.res
-rw-r--r-- 1 root root 359 Feb 14 15:38 lcl_dock_images.res
-rw-r--r-- 1 root root 6666 Feb 14 15:38 lcl_edbtnimg.res
-rw-r--r-- 1 root root 1335 Feb 14 15:35 lcl_grid_images.res

* Fehlermeldung: 'crtbeginS.o nicht gefunden'
** 2) in dem Projekt muss man noch einen Pfad nachtragen:

/usr/lib64/gcc/x86_64-suse-linux/4.8

== lOrgaMon ==

"l" steht für Lazarus aber auch für Linux. Für die lOrgaMon - Entwicklung müssen folgende Open-Source-Packete installiert werden:

=== erforderliche Freepascal-Packages (Online-Paket-Manager) ===

==== non-visual ====

fbintf https://github.com/MWASoftware/fbintf
aus IBX4Lazarus: ibnongui
IBControls https://github.com/MWASoftware/ibcontrols
aus ZeosDBO: zcomponent https://sourceforge.net/projects/zeoslib
dexif_package https://github.com/cutec-chris/dexif
dcpcrypt http://www.cityinthesky.co.uk/opensource/dcpcrypt/
indylaz (Indy) https://github.com/IndySockets/Indy
aus FPSpreadsheet: laz_fpspreadsheet http://wiki.lazarus.freepascal.org/FPSpreadsheet

==== visual ====

=== ehemals erforderliche manuelle Installation ===

Die Installation von Paketen funktioniert in Lazarus in der Regel so:

* ->Package->Package-Datei (.lpk) öffnen
* ->Verwenden->Installieren->Ja

==== Indy 10.6.2 ====

[[Indy]]

* Verzeichnis sollte "..\Indy\" sein (relativ zum OrgaMon-Verzeichnis)
* svn-Version empfohlen aus "https://svn.atozed.com:444/svn/Indy10/trunk"
* .\Lib\IndyLaz.lpk

==== ZEOS 7.2.4 ====

* https://sourceforge.net/projects/zeoslib/files/Zeos%20Database%20Objects/
* Verzeichnis sollte ..\Zeos\ heissen (relativ zum OrgaMon-Entwicklungsverzeichnis)
* von sourceforge lädt man sich "zeosdbo-7.2.4-stable.zip"
* Versionsnummer von ZEOS steht in srv/core/ZClasses.pas
* .\packages\lazarus\zcomponent.lpk 

==== ZEOS "trunk" ====

* Zeos (https://github.com/svn2github/ZeosLib.git) nach "Zeos-Git" auschecken
* mklink /D C:\Users\Andreas\Documents\Embarcadero\Studio\Projekte\Zeos C:\Users\Andreas\Documents\Embarcadero\Studio\Projekte\Zeos-Git\trunk
* Ansonsten Beschreibung wie oben

==== IBX 2.3.3 ====

* Verzeichnis sollte ..\IBX\ heissen (relativ zum OrgaMon-Entwicklungsverzeichnis)
* http://www.mwasoftware.co.uk/ibx
** Package->lpk öffnen->"ibexpressconsolemode" lpk öffnen
** Nutzung->Zum Projekt hinzufügen

=== erforderliche Tools ===

* keine Installation nötig, die Tools müssen nur im Suchpfad des Compilers sichtbar sein
* das Quellverzeichnis bei "Projekt -> Projekteinstellungen -> Compiler -> Pfade " eintragen

==== fpspreadsheet ====

[[fpspreadsheet]]

* Verzeichnis sollte "..\fpspreadsheet\" heissen
* svn-Version empfohlen aus "svn://svn.code.sf.net/p/lazarus-ccr/svn/components/fpspreadsheet"
** Will das dennoch das Package installieren: 1.5 | laz_fpspreadsheet 
* Das Package "source/laz_fpspreadsheet" sollte installiert werden

== In der Entwicklung ==

=== Linux-Only: libzip.so.2 ===

ev. den Zip Support über eine

libzip.so.2

siehe \lazarus\lcl\interfaces\gtk2\unitywsctrls.pas wie man das macht!

=== (k) D-BUS ===

über D-Bus will ich Serverdienste mit der GUI koppeln. Ob beides auf dem selben Host läuft oder nicht oder auch gemischt soll unerheblich sein, ich erhoffe mir Hilfe durch den "Transport" Begriff von D-Bus.
Läuft beides auf dem selben Host soll kein Netzwerk-Interface nötig sein, hier erwarte ich "Zero" Ausführungszeiten durch die Kernel Integration. Ein Remote Host soll aber auch über das Internet ZUgriff haben.

=== Ausführung von Aktionen mit langen Wartezeiten ===

Der Client kontrolliert über Properties die Aktion, bisher wird der Key/Value Store memcached verwendet, ab sofort soll mal mit "Properties" des D-Bus experimentiert werden. Clients sollen z.B. in 1,5 Sekunden Rhytmus den Wert einer lang brauchenden Aktion abfragen können. Verlieren sie den Kontext soll nach einem Restart des Client und dem Erneuten Auslösen der Aktion nur ein Token auf die bisher laufende Aktion gegeben werden.

org::freedesktop::DBus::Properties::Set

=== HTTP/2 ===

der lOrgaMon enthält einen [[HTTP2]]-Server zur Anbindung einer HTML 5- GUI. Der Web- Client verwendet für die Persistenz eine sqlite3 Datenbank. Auf dem Client ist nur ein Chrome Browser nötig.

<code>
HTTP/2 - Clients

^ TCP v

[lOrgaMon-, lOrgaMon-, lOrgaMon-, lOrgaMon-Instances]

^ local v

[Firebird] [FileSystem]
</code>

2025-12-20T16:07:40Z

OrgaMon: /* Wifi */

== Aktuelles ==

* Verfügbarkeit: https://rpilocator.com/

== Der raspi-Superserver ==

* Bei einer Server-Infrastruktur im OrgaMon Umfeld nehme ich mir den Buchtitel "Algorithmen und Datenstrukturen (Niklaus Wirth)" zum Vorbild.
* Es gibt also nur 2 Elemente, Datenstrukturen liegen auf einem NAS, Algorithmen liegen auf einem Raspi
* Ein 3. Element kommt nur hinzu weil ein NAS nicht 100% sicher ist - ein Backup NAS
* Das NAS macht (wegen der Nähe zum Datenträger) immer auch Virtualisierungen und Datenbankserver, das sind die einzigen 2 "Dienste" von denen der Raspi befreit ist, alles andere muss er machen, der raspi-Superserver ist geboren

=== Vorteile ===

* Will man einen Dienst aufsetzen sind alle Aspekte darüber im Internet gut zu finden
* Die SD Karte stellt die Idenität des Servers dar, Problem? Backup-SD rein und weiter gehts!
* Die Software-Basis des Raspi wird excellent gewartet
* Die Software ist aktuell und sicher
* Die Leistungskraft reicht allemal aus

=== Dienste im Einzelnen ===

* [[raspberrypi.vsftpd]]
* [[linux.nginx|raspberrypi.nginx]]
* [[raspberrypi.wiki]]
* [[raspberrypi.certbot]]
* [[raspberrypi.mail]]
* [[raspberrypi.rsync]]
* [[raspberrypi.dns]]
* [[raspberrypi.dhcp]]

[[Datei:Raspi-Super.png|200px]]

=== Sonstige Dienste/Projekte ===

* [[raspberrypi.router]]
* [[raspberrypi.gateway]]
* [[raspberrypi.solar]]
* [[raspberrypi.schalter]]
* [[raspberrypi.sata]]
* [[raspberrypi.Lastschrift]]
* [[raspberrypi.md]]
* [[raspberrypi.led-md]]
* [[raspberrypi.osm-tile-server]]
* [[raspberrypi.kernel]]
* [[raspberrypi.lazarus]]
* [[pizero2.vent]]

... aber der Reihe nach ...

== Inbetriebnahme "Headless" ==
=== SD-Karte erstellen ===

==== Kauf ====

* minimal sind 16 GByte für den normalen Betrieb notwendig, 8 ist etwas zu klein!
* Samsung Pro+ sind empfehlenswert gibts leider nur als 32 GByte (je grösser desto Wear-Levelling-Algorithmus- freundlicher!)
* die Samsung Pro+ wurde durch Pro Plus ersetzt
* <s>inzwischen benutze ich die Samsung endurance 32 GB</s>
* inzwischen benutze ich die Transcend 16GB High Endurance microSDXC/SDHC Speicherkarte TS16GUSDXC10V
* ich will mal die Transcend TS20GUSD240I industrielle Karte ausprobieren, die ist wirklich geeignet für den Dauerbetrieb

==== Prüfen ====

* Test, ob die Speicherkarte einwandfrei funktioniert: mit https://www.heise.de/download/product/h2testw-50539

==== Image schreiben ====

* aktuelles Raspbian Image von https://www.raspberrypi.org/downloads/raspbian/ laden
* Empfohlen: Der Imager der Raspberry Pi Foundation
** Alternativ: dotNetDiskImager_0.7.347.27_Installer.exe: https://sourceforge.net/projects/dotnetdiskimager/files/bin/
** Alternativ: Win32DiskImager-0.9.5-install.exe : https://sourceforge.net/projects/win32diskimager/
** Alternativ auf dem Raspberry Pi mit einem microSD USB Adapter
*** https://www.raspberrypi.org/documentation/installation/installing-images/linux.md
*** dd bs=4M if=/srv/mnt/INSTALL/hardware/Raspberry-pi/2019-buster/2019-09-26-raspbian-buster-full.img of=/dev/sda conv=fsync status=progress
*** danach Partition 1 der Karte mounten, z.B. nach /srv/mnt
*** touch /srv/mnt/ssh

#!/bin/bash

dd bs=4M if=2020-02-13-raspbian-buster-lite.img of=/dev/sda conv=fsync status=progress
mount /dev/sda1 /srv/mnt
touch /srv/mnt/ssh
umount /srv/mnt

==== Image vorbereiten ====

* Es sollte die Partition "boot" erkennbar sein
* Es ist ein kleines Standard-File-System (ich glaube FAT) mit nur wenigen MByte
* Im Hauptverzeichnis legt man eine leere Datei "ssh" an

* den Raspi mit der SD-Karte versehen, ans Netzwerk anschliessen, für starke Stromversorgung (>2A) sorgen
* Nun bei deinem DHCP-Server-System ermitteln welche IP Adresse der RASPI gezogen hat

tail -2000 /var/log/messages | grep dhcp
Mar 11 17:09:40 raib25 dhcpd: DHCPACK on 192.168.115.205 to b8:27:eb:8b:9b:0a (raspberrypi) via eth0

=== erster Start ===

* per ssh oder mit Putty als "pi" mit dem Passwort "raspberry" einloggen
* das Passwort des Users "pi" jetzt stark machen
** <code>passwd⏎</code> neues Passwort für pi setzen (altes ist "raspberry")
* das Passwort des Users "root" jetzt stark machen
** <code>sudo passwd</code> neues Passwort für root setzen (ein altes wird nicht abgefragt)
* nur dem User <code>root</code> den Login erlauben
** <code>sudo apt update</code>
** <code>sudo apt install joe</code>
** <code>sudo joe /etc/ssh/sshd_config</code>
*** <code>PermitRootLogin yes</code> sicherstellen (die entsprechende Zeile muss ABGEÄNDERT werden)
*** <code>AllowUsers root</code> sicherstellen (NUR noch User "root" kann sich per ssh einloggen! Diese Zeile muss neu eingetragen werden)
* <code>sudo reboot</code>

=== zweiter Start ===

* Jetzt mit ssh/Putty als "root" mit einem sehr starken Passwort einloggen

==== System-Update ====

* <code>apt update</code>
* <code>apt upgrade</code>
* <code>reboot</code>

=== dritter Start ===

* <code>rpi-update</code>
* <code>reboot</code>

=== vierter Start ===

* <code>joe /etc/default/rpi-eeprom-update</code>
** von "default" auf "beta"
* <code>rpi-eeprom-update -a</code>
* Version des Bootloaders anzeigen: Shift Key beim booten gedrückt halten

==== Joe ====

* joe sollte keine Backup-Dateien angelegen, da dies bei virtuellen Host Konfigurationsdatei kontraproduktiv ist, neben einem host.conf hat man dann immer noch eine weitere Datei host.conf~ die beim Start des Webservers (nginx) als "echt" interprätiert wird.

joe /etc/joe/editorrc

-nocurdir Do not prompt with current directory

-nobackups If you don't want backup files to be created

-nodeadjoe If you don't want DEADJOE files to be created

dazu einfach das "-nobackups" Setting aktivieren indem man es ein Zeichen nach links zieht

=== Hostname setzen ===

* 2 Dateien müssen geändert werden

joe /etc/hosts
joe /etc/hostname

Mal testen: Bekanntmachen des eigenen Namens im Netz: libnss-mdns

=== Zeitzone setzen ===

dpkg-reconfigure tzdata

=== locale setzen ===

dpkg-reconfigure locales

* <code>[*] de_DE.UTF8 UTF8</code> ankreuzen und OK
* Das Standard-Locale soll aber auf en_GB bleiben wie eingestellt <ENTER>

Generating locales (this might take a while)...
de_DE.UTF-8... done
en_GB.UTF-8... done
Generation complete.

== Tipps und Tricks ==

=== eigene MAC-Adressen ===

ip addr | grep ether | awk '{print $2}' | tr [a-z] [A-Z]

* 1. Zeile: LAN-MAC-Adresse
* 2. Zeile: WLAN-MAC-Adresse

=== eigene Seriennummer ===

vcgencmd otp_dump | grep 28: | sed s/.*://g

=== CPU Temperatur auslesen ===

vcgencmd measure_temp

=== Colorierter Prompt ===

[[Datei:Color.png|76px]]

=== Ermitteln der IP-Adresse eines frisch gestarteten RASPIs ===

* Ein Standard-Image meldet sich als host "raspberry" bei deinem DHCP-Server
* So kann man mit

tail -3000 /var/log/messages | grep DHCP | grep raspberry

* ermitteln wie die IP Adresse des Raspi ist
* Mit ssh nun einloggen

ssh pi@x.x.x.x

# Passwort wird abgefragt, es ist "raspberry"

=== Die 100 MByte Swap-Bereich abschalten ===

* <code>swapoff -a</code>
* <code>service dphys-swapfile stop</code>
* <code>systemctl disable dphys-swapfile</code>

=== SD-Karten-Platz sparen ===

* Erst möglich wenn das System läuft
** apt-get --purge remove epiphany-browser epiphany-browser-data libreoffice sonic-pi wolfram-engine
** apt-get autoremove

=== smb-Mount ===

* <code>systemctl enable systemd-networkd-wait-online.service</code>

* /etc/systemd/system/srv-ftp.mount

[Unit]
Description=srv-ftp

[Mount]
What=//192.168.115.25/web$
Where=/srv/ftp
Type=cifs
#
# vers=1.0 muss gesetzt werden, wenn ein "älterer" Server
# kontaktiert wird, wenn nicht, kommt die Fehlermeldung:
#
# mount error(112): Host is down
# Refer to the mount.cifs(8) manual page (e.g. man mount.cifs)
#
# im dmesg ist dann die Fehlermeldung:
# [] No dialect specified on mount. Default has changed to a more secure dialect, SMB2.1 or later (e.g. SMB3), from CIFS (SMB1). To use the less secure SMB1 dialect to access old servers which do not support SMB3 (or SMB2.1) specify vers=1.0 on mount.
# [] CIFS VFS: cifs_mount failed w/return code = -112
#
# manuell kann nun mal mit
#
# mount -o vers=1.0 //raib25/i$ /srv/smb
#
# prüfen, ob es so funktioniert. Wenn ja:
#
# die Lösung:
Options=guest,vers=1.0

[Install]
WantedBy=remote-fs.target

* Seit der Raspi über WLAN angebunden war rauschte der Mount beim boot mit einer Fehlermeldung durch

Nov 13 16:04:17 pi3x06 kernel: [ 7.195956] CIFS VFS: Error connecting to socket. Aborting operation.
Nov 13 16:04:17 pi3x06 kernel: [ 7.195986] CIFS VFS: cifs_mount failed w/return code = -101

* Ich habe obige .mount Unit "disabled" aber dafür eine zusätzliche .automount Unit geschrieben, und diese "enabled":

* /etc/systemd/system/srv-ftp.automount

[Unit]
Description=srv-ftp

[Automount]
Where=/srv/ftp

[Install]
WantedBy=remote-fs.target

* das war die Lösung,, seither springt der .mount erst an, wenn der Benutzer zugreift!!

=== alter Client ===

* ein alter Client würde immer versuchen mit dem Protokoll 1.0 auf den Server zuzugreifen
* moderne Server lehen dieses Protokoll ab, es kommt ein Fehler
* die alten Clients können oft 2.0, 2.1 usw aber der default ist 1.0
* diese alten Clients muss man zwingen ein moderneres Protokoll zu verwenden, da der Server die Verbindung sonst ablehnt

mount -o vers=3.0 //raib25/i$ /srv/smb

* so gelingt der mount

=== Power Saving ===
==== Audio ====

* /boot/config.txt

# disable audio
dtparam=audio=off

==== Bluetooth ====
* /boot/config.txt
# disable bluetooth
dtoverlay=pi3-disable-bt

systemctl disable bluetooth.service
==== Wifi ====
* /boot/config.txt
# disable wifi
dtoverlay=pi3-disable-wifi

systemctl disable hciuart.service
systemctl disable wpa_supplicant

[[raspberrypi.wifi]]

==== HDMI ====
* HDMI kann man ausschalten

/opt/vc/bin/tvservice -o
==== Display-Connector ====

* keine Infos dazu gefunden

==== Kamera-Connector ====

* keine Infos dazu gefunden

==== USB ====

* keine Infos dazu gefunden

==== GPIO ====

* keine Infos dazu gefunden

=== Ohne grafisches System ===

* Verhindern dass die grafische Benutzeroberfläche gestartet wird
** <s><code>update-rc.d lightdm disable</code></s>
** <code>sudo systemctl set-default multi-user.target</code>
** UnDo this: <code>systemctl set-default graphical.target</code>
* Nun ist der erste Headless Start möglich

=== System-Identifikation ===

# Welches Modell?
#
dmesg | grep Rasp

# Welche MAC Adresse?
#
ifconfig | grep ether
oder
lshw | grep serial

=== WLAN-Adapter ===

* Der Raspberry Pi als WLAN-Adapter missbraucht https://www.youtube.com/watch?v=TtLNue7gzZA

=== Zigbee Adapter ===

* RaspBee: <code>https://phoscon.de/de/raspbee</code>

== Hardware ==

* https://www.bicker.de/
* https://geekworm.com/
* https://buyzero.de/
* https://www.rasppishop.de/
* https://shop.pimoroni.com/
* https://www.raspberrypi.org/
* https://www.berrybase.de/
* https://www.pieye.org/
* https://www.adafruit.com/
* https://www.waveshare.com/
* https://www.sainsmart.com/