====== Honeywell MDE: KeyboardEmulator konfigurieren ======

===== Ziel =====
Damit Barcode-Scans auf Honeywell MDE-Geräten zuverlässig in **COBI.wms** ankommen, muss die App **keyboardemulator** so konfiguriert werden, dass sie die Scandaten per **BroadcastReceiver** an COBI.wms übergibt.

===== Voraussetzungen =====
  * Honeywell MDE (Android)
  * App **keyboardemulator** (getestet mit Version **v11.4.3.M**)
  * COBI.wms ist installiert
  * Nach Möglichkeit: COBI.wms während der Einrichtung geschlossen

===== Übersicht der erforderlichen Einstellungen =====
  * **Function**: Scanner aktivieren, **Barcode2D** aktivieren, KeyCode setzen
  * **AppSettings**: **BroadcastReceiver** aktivieren und Broadcast-Action/Key setzen
  * Optional/empfohlen: **End mark = Enter**

----

===== 1) Scanner aktivieren und Barcode2D konfigurieren (Tab „Function“) =====

{{:de:cobi.wms:honeywell_mde:keyboardemulator1.png?400|}}

  - Öffne **keyboardemulator**.
  - Wechsel in den Tab **Function**.
  - Setze/prüfe folgende Werte:
    - **Barcode2D**: aktivieren (Haken setzen).  *(siehe Markierung 1)*
    - **KeyCode**: auf **293** setzen.  *(siehe Markierung 2)*
    - **Enable Scanner**: auf **AN** (Ein).  *(siehe Markierung 3)*

> Hinweis: Je nach Geräte-Setup kann Barcode1D ebenfalls genutzt werden. Für COBI.wms ist entscheidend, dass die Scans korrekt ausgelöst und anschließend per Broadcast übergeben werden (siehe nächster Schritt).

----

===== 2) BroadcastReceiver für COBI.wms konfigurieren (Tab „AppSettings“) =====

{{:de:cobi.wms:honeywell_mde:keyboardemulator2.png?800|}}

  - Wechsel in den Tab **AppSettings**. *(siehe Markierung 1)*
  - Wähle als Ausgabeart **BroadcastReceiver**. *(siehe Markierung 2)*
  - Konfiguriere im Abschnitt **Barcode**:
    * **Broadcast name**: **de.cobi.wms.action.KEYBOARDEMULATOR_BARCODE** *(siehe Markierung 3)*
    * **Key**: **data**
  - (Optional/empfohlen) Im Abschnitt **End mark**:
    * **Enter** aktivieren
    * **TAB** deaktiviert lassen

> Wichtig: Der Broadcast-Name muss **exakt** so eingetragen werden, inkl. Groß-/Kleinschreibung und Unterstrichen.

----

===== 3) Funktionstest in COBI.wms =====
  - Öffne **COBI.wms**.
  - Navigiere in ein Eingabefeld (z. B. Login, Artikel-/Barcodefeld).
  - Scanne einen Barcode.
  - Erwartetes Ergebnis: Der Wert wird in COBI.wms übernommen bzw. der Artikel wird gefunden.

Falls nichts ankommt:
  * COBI.wms vollständig schließen (App-Switcher) und erneut öffnen
  * Prüfen, ob **BroadcastReceiver** ausgewählt ist (nicht „Keyboard input“)
  * Prüfen, ob **Broadcast name** und **Key** korrekt sind

----

===== Troubleshooting (häufige Ursachen) =====
  * **Keine Reaktion in COBI.wms**
    - BroadcastReceiver nicht aktiv / falscher Broadcast-Name
    - COBI.wms lief während der Umstellung → App einmal neu starten
  * **Scans landen „irgendwo“ als Tastatureingabe**
    - Ausgabe steht auf „Keyboard input“ statt „BroadcastReceiver“
  * **Scan wird übertragen, aber ohne Inhalt**
    - „Key“ muss **data** sein (COBI.wms liest den Wert aus diesem Feld)