====== Honeywell MDE: Configure KeyboardEmulator ======

===== Purpose =====
To ensure barcode scans on Honeywell MDE devices are received correctly by **COBI.wms**, the **keyboardemulator** app must be configured to send scan data via **BroadcastReceiver** to COBI.wms.

===== Prerequisites =====
  * Honeywell MDE (Android)
  * **keyboardemulator** app (verified with **v11.4.3.M**)
  * COBI.wms installed
  * Recommended: close COBI.wms while applying the settings

===== Required Settings (Summary) =====
  * **Function**: enable scanner, enable **Barcode2D**, set KeyCode
  * **AppSettings**: enable **BroadcastReceiver** and set action/key
  * Optional/recommended: **End mark = Enter**

----

===== 1) Enable Scanner and configure Barcode2D (Tab “Function”) =====

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

  - Open **keyboardemulator**.
  - Go to the **Function** tab.
  - Apply/verify the following:
    - **Barcode2D**: enable (check the box).  *(see marker 1)*
    - **KeyCode**: set to **293**.  *(see marker 2)*
    - **Enable Scanner**: set to **AN** (On).  *(see marker 3)*

> Note: Depending on the device setup, Barcode1D may also be used. For COBI.wms it is essential that scans are triggered and then forwarded via Broadcast (next step).

----

===== 2) Configure BroadcastReceiver for COBI.wms (Tab “AppSettings”) =====

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

  - Switch to the **AppSettings** tab. *(see marker 1)*
  - Select **BroadcastReceiver** as the output mode. *(see marker 2)*
  - In section **Barcode**, set:
    * **Broadcast name**: **de.cobi.wms.action.KEYBOARDEMULATOR_BARCODE** *(see marker 3)*
    * **Key**: **data**
  - (Optional/recommended) In section **End mark**:
    * Enable **Enter**
    * Keep **TAB** disabled

> Important: The broadcast name must match **exactly**, including capitalization and underscores.

----

===== 3) Test in COBI.wms =====
  - Open **COBI.wms**.
  - Navigate to a field where scanning is expected (e.g., login, item/barcode field).
  - Scan a barcode.
  - Expected result: COBI.wms receives the value and processes it (e.g., item is found).

If nothing is received:
  * fully close COBI.wms (task switcher) and reopen it
  * verify **BroadcastReceiver** is selected (not “Keyboard input”)
  * verify **Broadcast name** and **Key** are correct

----

===== Troubleshooting (common causes) =====
  * **No reaction in COBI.wms**
    - BroadcastReceiver not enabled / wrong broadcast name
    - COBI.wms was running during changes → restart the app
  * **Scans appear as normal keyboard typing**
    - output mode is set to “Keyboard input” instead of “BroadcastReceiver”
  * **Scan is sent but value is empty**
    - the extra “Key” must be **data** (COBI.wms reads the barcode value from this field)