Differences

This shows you the differences between two versions of the page.

--- cobi.wms:keyboardemulator_settings [2025/12/29 11:37] – created thuth
+++ cobi.wms:keyboardemulator_settings [2025/12/29 11:49] (current) – [2) Configure BroadcastReceiver for COBI.wms (Tab “AppSettings”)] thuth
@@ Line 1: / Line 1: @@
-===== keyboardemulator Settings =====
+====== 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)