GET THE LATEST VERSION OF THE FLEXOPTIX APP!

Installationshinweise

Obwohl die FLEXOPTIX Desktop Anwendung vollständig auf deinem Computer installiert wird, benötigst du eine ständige Internetverbindung um sie auszuführen.
Außerdem überprüft unsere Anwendung automatisch auf neue Updates und installiert diese gegebenenfalls.

Troubleshooting

Überprüfe ob die FLEXBOX korrekt erkannt wird.

1. Schließe die FLEXBOX per USB an.
2. Das Gerät FLEXBOX muss unter Systemsteuerung > Hardware und Sound > Geräte und Drucker angezeigt werden.
   Außerdem muss im Feld Gerätestatus stehen, dass das Gerät einwandfrei funktioniert:
   
3. Wenn die FLEXBOX nicht aufgelistet ist oder gemeldet wird, dass Probleme aufgetreten sind, versuche es bitte an anderen USB-Ports oder Computern (vorzugsweise mit Administratorrechten), um die Fehlerursache einzugrenzen.

Überprüfe ob die Treiber korrekt funktionieren

1. Schließe die FLEXBOX per USB an.
2. Unter Systemsteuerung > Hardware und Sound > Geräte und Drucker, öffne das Kontextmenü von FLEXBOX und wähle Eigenschaften > Hardware > HID-konformes Gerät > Eigenschaften > Ereignisse.
3. Wenn dort ein Ereignis Gerät nicht migriert ist, musst Du die neusten Firmware-Updates für Dein System installieren.
4. Stelle sicher, dass Dein System neugestartet wurde, nachdem die FLEXBOX das erste mal gesteckt wurde, oder ihre Treiber installiert wurden.

Verbindungsprobleme

Die FLEXOPTIX App erkennt die FLEXBOX nicht, kann sie nicht verbinden, oder ternnt die Verbindung bzw. stürzt ab, sobald ein Transceiver gesteckt wird oder der Laser im Power Meter & Source Feature aktiviert wird. Das deutet auf Probleme mit der Stromversorgung hin.

Optionen, um Probleme mit der Stromversorgung zu beheben:

• Verbinde die FLEXBOX direkt mit dem Computer. Vermeide USB-Hubs und lange USB-Verlängerungskabel. Stelle auch sicher, dass das USB-Kabel Daten übertragen kann.
• Verwende einen USB-Hub mit externer Stromversorgung und stelle sicher, dass diese auch verbunden ist. Verwende bevorzugt USB 3 Hubs.
• Verwende ein FLEXBOX MOBILITY PACK im "off"- oder "USB"-Modus.

Netzwerkanforderungen

Um die einwandfreie Funktionalität der FLEXOPTIX-App zu gewährleisten, insbesondere für Authentifizierung und Fernzugriff, sind spezifische Netzwerkkonfigurationen notwendig.

• Die Netzwerkkommunikation muss auf mindestens einem der folgenden Ports auf localhost aktiviert sein: 50153, 51109, 52843, 53000, 54892, 55095.
• Der Zugriff auf diese Domänen muss gewährleistet sein:
  •  id.flexoptix.net
  • oauth.reconfigure.me
  • flexbox.reconfigure.me
  • flexbox5.reconfigure.me
  • app.reconfigure.me

Hintergrund-Installation

Die Desktop Anwendung kann im Hintergrund installiert werden, indem man den Parameter /S an den Installer übergibt. Sie wird für den aktuellen Nutzer nach  %LOCALAPPDATA%\Programs\FLEXOPTIX App   installiert.

Mit den Parametern  /S /allusers  wird die Anwendung für alle Nutzer nach  C:\Program Files\FLEXOPTIX App  installiert. Dies erfordert Admin-Rechte.

Sollten immer noch Probleme auftreten lass es uns bitte wissen.

Installationshinweise

Obwohl die FLEXOPTIX Desktop Anwendung vollständig auf deinem Computer installiert wird, benötigst du eine ständige Internetverbindung um sie auszuführen.
Außerdem überprüft unsere Anwendung automatisch auf neue Updates und installiert diese gegebenenfalls.

Aus Sicherheitsgründen verbietet macOS etwas von außerhalb des Apple App Store zu installieren per Standardeinstellung. Um zertifizierte Software dennoch installieren zu können, musst du diese Einstellung ändern:

1. Öffne deine Systemeinstellungen und gehe auf Sicherheit
2. Im Reiter Allgemein findest du die Einstellung 'Apps download erlauben von'
3. Ändere sie zu 'App Store und verifizierten Entwickler'.
   Eventuell musst du diese Einstellungsmöglichkeit freischalten, indem du auf das Schlosssymbol unten links klickst und dein Passwort eingibst.
   Frag bitte deinen System Administrator, falls du keine Administratorrechte besitzt.

FLEXOPTIX App auf MacBooks ausführen

Es gibt die FLEXOPTIX App jetzt in zwei Versionen. Dadurch wird eine gute Leistung auf allen Mac Geräten garantiert und langsame Ladezeiten werden vermieden.

• Mac-Computer mit Apple-Chip (arm64): Der Standard Download (arm64) wird für Apple-Chips empfohlen.
• Mac-Computer mit Intel-Chip (x64): Falls der Fehler "Du kannst das Programm “FLEXOPTIX App.app” nicht öffnen, da dieses Programm auf diesem Mac nicht unterstützt wird" angezeigt wird, versuchst Du die App für Apple-Silicon auf einem Intel Chip auszuführen. Installiere stattdessen die x64 Version der FLEXOPTIX App.

Troubleshooting

Überprüfe ob die FLEXBOX korrekt erkannt wird.

1. Connect FLEXBOX to USB port.Klicke auf das Apple-Symbol in der oberen linken Ecke des Bildschirms
2. Gehe auf Über diesen Mac > Systembericht
3. Unter Hardware klicke auf USB
4. Überprüfe ob im USB-Gerätebaum FLEXBOX gelistet ist.
5. Das sollte in etwa so aussehen:
   
   Wenn das nicht der Fall ist probiere andere USB Ports aus oder starte das System neu. Sobald die FLEXBOX gelistet wird sollte alles funktionieren.

Verbindungsprobleme

Die FLEXOPTIX App erkennt die FLEXBOX nicht, kann sie nicht verbinden, oder ternnt die Verbindung bzw. stürzt ab, sobald ein Transceiver gesteckt wird oder der Laser im Power Meter & Source Feature aktiviert wird. Das deutet auf Probleme mit der Stromversorgung hin.

Optionen, um Probleme mit der Stromversorgung zu beheben:

• Verbinde die FLEXBOX direkt mit dem Computer. Vermeide USB-Hubs und lange USB-Verlängerungskabel. Stelle auch sicher, dass das USB-Kabel Daten übertragen kann.
• Verwende einen USB-Hub mit externer Stromversorgung und stelle sicher, dass diese auch verbunden ist. Verwende bevorzugt USB 3 Hubs.
• Verwende ein FLEXBOX MOBILITY PACK im "off"- oder "USB"-Modus.

Netzwerkanforderungen

Um die einwandfreie Funktionalität der FLEXOPTIX-App zu gewährleisten, insbesondere für Authentifizierung und Fernzugriff, sind spezifische Netzwerkkonfigurationen notwendig.

• Die Netzwerkkommunikation muss auf mindestens einem der folgenden Ports auf localhost aktiviert sein: 50153, 51109, 52843, 53000, 54892, 55095.
• Der Zugriff auf diese Domänen muss gewährleistet sein:
  •  id.flexoptix.net
  • oauth.reconfigure.me
  • flexbox.reconfigure.me
  • flexbox5.reconfigure.me
  • app.reconfigure.me

App stürzt ab auf MacOS Sequoia 15.0.1 oder älter

Wenn Ihre App abstürzt und Sie die Nachricht 'IMKClient_Legacy' im Terminal sehen, könnte ein Update Ihres MacOS das Problem lösen.

Sollten immer noch Probleme auftreten lass es uns bitte wissen.

Installationshinweise

Obwohl die FLEXOPTIX Desktop Anwendung vollständig auf deinem Computer installiert wird, benötigst du eine ständige Internetverbindung um sie auszuführen.
Außerdem überprüft unsere Anwendung automatisch auf neue Updates und installiert diese gegebenenfalls.

Notwendige Bibliotheken

Damit die Anwendung funktioniert muss libhidapi  installiert sein:

• Debian: apt-get install libhidapi-libusb0
  
• Fedora: dnf install hidapi
  
• Arch: pacman -S hidapi

Die App benötigt außerdem GLIBCXX_3.4.21 (verfügbar ab libstdc++.so.6.0.21) oder neuer, was z.B. in Ubuntu 16.04, Debian 9 (stretch), CentOS 8 oder Fedora 30 verfügbar ist.

Udev-Regeln für die FLEXBOX unter Linux definieren:

1. Finde heraus wo die udev-Regeln liegen.
   Normalerweise unter: /etc/udev/rules.d/ 
2. Speichere dort folgende Datei: 99-tprogrammer.rules 
   Die Datei heißt '99-tprogrammer.rules' (das Zahlen-Präfix und die Endung '.rules' sind essentiell).
   Die Datei enthält die Regeln, welche der FLEXBOX die notwendigen Privilegien geben.
3. Lade die udev-Regeln neu.
   udevadm control --reload-rules && udevadm trigger
4. Trenne danach die Verbindung zur FLEXBOX und schließe sie erneut an.

Starten des AppImages

Um das AppImage zu starten muss dieses erst ausführbar sein und dann gestartet werden:

• Mache das AppImage ausführbar mit z.B.: chmod +x filename.AppImage
• Starte das AppImage mit Doppelclick oder mit: ./filename.AppImage
• Detailreichere Information hierzu gibt es unter: appimage.org

Troubleshooting

Proxy Einstellung

Wenn deine Internetverbindung über einen Proxy läuft, vergewissere dich ob ein HTTPS-Proxy eingestellt ist:

• export https_proxy="http://username:password@proxy-ip:port"

Die App zeigt dir eine Eingabeaufforderung an, falls die Authentfizierung beim Proxy-Server mit den gegebenen Anmeldedaten nicht klappt.

Überprüfe ob die FLEXBOX korrekt erkannt wird.

1. Schließe die FLEXBOX per USB an.
2. Öffne ein Terminalfenster und gebe lsusb ein.
3. Es sollte einer der folgenden Einträge erscheinen:
   - ID 0483:5750 SGS Thomson Microelectronics
   - ID 0483:A0E7 SGS Thomson Microelectronics
   - ID 0483:A0E8 SGS Thomson Microelectronics
   - ID 16D0:0B1A MCS
   - ID 384D:0B1C FLEXOPTIX
4. Falls nicht könnte ein Problem mit deiner USB Verbindung bestehen.
   Versuche andere USB Geräte anzuschließen und überprüfe ob sich die Ausgabe von lsusb ändert.
   Wenn du dein Eintrag siehst, fahre mit dem nächsten Schritt fort.
5. Für den Fall, dass beim Speichern etwas schief gegangen ist, versichere dich bitte ob die Datei /etc/udev/rules.d/99-tprogrammer.rules existiert.
   Falls sie fehlt, erstelle sie nochmal.
6. Trenne danach die Verbindung zur FLEXBOX und schließe sie erneut an.

Verbindungsprobleme

Die FLEXOPTIX App erkennt die FLEXBOX nicht, kann sie nicht verbinden, oder ternnt die Verbindung bzw. stürzt ab, sobald ein Transceiver gesteckt wird oder der Laser im Power Meter & Source Feature aktiviert wird. Das deutet auf Probleme mit der Stromversorgung hin.

Optionen, um Probleme mit der Stromversorgung zu beheben:

• Verbinde die FLEXBOX direkt mit dem Computer. Vermeide USB-Hubs und lange USB-Verlängerungskabel. Stelle auch sicher, dass das USB-Kabel Daten übertragen kann.
• Verwende einen USB-Hub mit externer Stromversorgung und stelle sicher, dass diese auch verbunden ist. Verwende bevorzugt USB 3 Hubs.
• Verwende ein FLEXBOX MOBILITY PACK im "off"- oder "USB"-Modus.

Flexbox 5 verbindet sich nicht

• über USB: Falls die udev Regeln bereits für ein älteres Flexbox Modell eingerichtet wurden, müssen diese durch die aktuelle Version von 99-tprogrammer.rules ersetzt werden.
• über Bluetooth (BLE): BLE wird auf Linux noch nicht unterstützt.

Netzwerkanforderungen

Um die einwandfreie Funktionalität der FLEXOPTIX-App zu gewährleisten, insbesondere für Authentifizierung und Fernzugriff, sind spezifische Netzwerkkonfigurationen notwendig.

• Die Netzwerkkommunikation muss auf mindestens einem der folgenden Ports auf localhost aktiviert sein: 50153, 51109, 52843, 53000, 54892, 55095.
• Der Zugriff auf diese Domänen muss gewährleistet sein:
  •  id.flexoptix.net
  • oauth.reconfigure.me
  • flexbox.reconfigure.me
  • flexbox5.reconfigure.me
  • app.reconfigure.me

AppImages require FUSE to run

Die meisten Linux Distributionen werden mit funktionierendem FUSE ausgeliefert. Falls dieser Fehler zu sehen ist, ist das entweder nicht der Fall, oder FUSE 3 ist installiert (z.B. in Ubuntu 22.04 oder neuer). Siehe im AppImage Troubleshooting nach, wie dies zu beheben ist.

Sandbox not configured correctly

Die FLEXOPTIX App beinhaltet eine Sandbox, die den Code daran hindern soll, auf das System zuzugreifen, um es vor bösartigen Code-Injections zu schützen, z.B. durch Man-in-the-middle Attacken. In manchen Linux Distributionen (z.B. Debian, Red Hat Enterprise, CentOS) könnte ein Fehler

The setuid sandbox is not running as root.

oder

The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now.

angezeigt werden, wenn das AppImage aus einer Konsole gestartet wird. Der Grund für den Fehler ist, dass das System keine namespaces für Nutzer ohne höhere Berechtigung erlaubt, was die Standardeinstellung in Debian ist.
Es gibt zwei Möglichkeiten für einen Workaround:

• namespaces für Benutzer ohne höhere Berechtigung temporär oder permanent erlauben, so wie es hier beschrieben wird, oder finde die entsprechenden Einstellungen für deine Distribution
• das AppImage mit dem Kommandozeilenparameter --no-sandbox starten

Bitte beachte dabei, dass beide Möglichkeiten Sicherheitsrisiken implizieren können.

"Storage Initialization Failed" Fehler

Wenn beim Start der FLEXOPTIX App Fehler beim Initialisieren vom "Storage" angezeigt werden, liegen diese meistens an der Schlüsselverwaltung für verschlüsselte Dateien in manchen Linux Installationen.

Um diese Probleme zu beheben, gibt es folgende Optionen:

• Stelle sicher, dass "libsecret" und "gnome-keyring" installiert sind. Erzwinge die Verwendung von "gnome-libsecret", indem du die App mit folgenden Parametern startest: ./FLEXOPTIX_App.5.26.0-<latest_version>.AppImage --password-store=gnome-libsecret
• Setze die Desktop-Session auf "GNOME", bevor die App gestartet wird: DESKTOP_SESSION=gnome ./FLEXOPTIX_App.<latest_version>-latest.AppImage
• Lösche die Date TERMS_CONDITIONS.json, um die Einstellungen der App zurückzusetzen.

GPU-Prozessfehler in der FLEXOPTIX-App

Plötzliche GPU-Prozessabbrüche, wie 'gpu process terminated abruptly' oder 'electron exited unexpectedly: exit_code=139', können das Starten der FLEXOPTIX App verhindern. Um dieses Problem zu beheben, starten Sie die Anwendung mit dem Befehlszeilenparameter --disable-accelerated-video-decode.

Fenster zeigt nichts an

Wenn die App über X forwarding asugeführt wird, zeigt das Fenster seit Version 5.8.0 nichts an. Starte das AppImage mit dem Kommandozeilenparameter --no-xshm um dies zu beheben.

Sollten immer noch Probleme auftreten lass es uns bitte wissen.