COBISOFT Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Barcode-Scanning über Bluetooth ======

COBI.wms unterstützt die Verwendung von Barcodescannern, die über **Bluetooth 4.0** oder höher mit dem Android-Gerät verbunden werden. Diese Technologie wird auch als Bluetooth Low Energy, Bluetooth LE oder kurz **BLE** bezeichnet.

Bei der Nutzung eines BLE-Scanners ergeben sich einige Herausforderungen. Das Hauptproblem besteht darin, dass es keine standardisierte Bluetooth-Spezifikation zur Übertragung von Barcode-Scan-Daten gibt. Aus diesem Grund geben sich die meisten BLE-Scanner als Tastatur (**HID-Gerät**) aus und senden die gescannten Barcodes als eine Reihe von Tastatureingaben.

Aus diesem Grund empfehlen wir dringend, ein Android-Gerät mit integriertem Barcodescanner zu verwenden, anstatt einen externen Scanner per Bluetooth zu verbinden. Dennoch werden auf dieser Seite die Herausforderungen und mögliche Workarounds beschrieben.

===== Verwendung von Scannern, die als HID-Gerät arbeiten =====

Wenn ein BLE-Scanner im HID-Modus verwendet werden soll, muss das Gerät in den Android-Einstellungen (außerhalb von COBI.wms) gekoppelt werden. Achten Sie darauf, dass es als Tastatur registriert ist. Anschließend muss in COBI.wms die **[[de:COBI.wms:app-optionen|]]** **„Barcode-Scan über Tastatureingabe“** aktiviert werden.

**Während dies bei einfachen (nicht-GS1-) Barcodes funktionieren sollte, kann es bei GS1-Barcodes wie GS1 DataBar, GS1-128, GS1 DataMatrix und GS1 QR-Codes zu Problemen kommen.**

Der Grund ist komplex: GS1-Barcodes enthalten ein spezielles Symbol, den „Function Code 1“ (**FNC1**). Dieser erscheint sowohl am Anfang eines Barcodes, um ihn als GS1-Barcode zu kennzeichnen, als auch an verschiedenen Stellen innerhalb des Barcodes, um Datenfelder voneinander zu trennen. Wenn beispielsweise ein Chargennummern-Feld nicht alle 20 Ziffern nutzt, die der GS1-Standard erlaubt, muss es mit FNC1 abgeschlossen werden, bevor das nächste Feld (Seriennummer) beginnt.

Das Problem dabei: Das FNC1-Symbol entspricht keiner Taste auf einer Tastatur. Scanner im HID-Modus können dieses Symbol daher oft nicht übertragen – und damit sind GS1-Barcodes mit solchen Scannern nicht nutzbar.

Einige Scanner senden FNC1 dennoch als spezielle Tastenkombination (z. B. unter Verwendung der STRG-Taste). Dies wurde bei BLE-Scannern der Marke **Inateck** getestet (Modell **BCST-40**). Bitte beachten Sie jedoch, dass COBISOFT nicht garantieren kann, dass diese Geräte für den industriellen Einsatz geeignet sind.

In COBI.wms gibt es einen Workaround unter Verwendung pseudo-GS1-konformer Barcodes, die allerdings nicht standardkonform sind. Das Semikolon-Symbol (**;**) kann dabei überall dort eingesetzt werden, wo sonst ein FNC1 erscheinen würde. Wenn Sie den folgenden Text beispielsweise als Code-128- oder DataMatrix-Barcode kodieren, wird COBI.wms diesen als GS1-Barcode erkennen:

<html><pre>
;<span style="color:red">240</span>12345;<span style="color:red">10</span>BATCHXYZ;<span style="color:red">21</span>SERIALXYZ
</pre></html>

Wie Sie sehen, beginnt der Text mit einem Semikolon als Kennzeichnung für einen GS1-Code. Weitere Semikola trennen die Datenfelder 240 (Artikelnummer) und 10 (Chargennummer).

Bei eindimensionalen Barcodeformaten wie Code 128 kann dies zu **sehr langen Barcodes** führen, die schwer zu scannen sind, da die Kodierung von Sonderzeichen wie dem Semikolon mehr Platz benötigt als das FNC1-Symbol.

Bei zweidimensionalen Codes wie DataMatrix oder QR sollte dieser Workaround problemlos funktionieren. Bitte beachten Sie jedoch: Diese Lösung ist eine **COBI.wms-Spezialisierung** und funktioniert nicht mit anderen Barcode-Systemen, sofern diese nicht ebenfalls speziell für solche „Fake-GS1-Codes“ angepasst wurden.

===== Verwendung von Scannern mit benutzerdefiniertem GATT-Service =====

In der Bluetooth-LE-Terminologie steht **GATT** für Generic Attribute Profile und beschreibt ein System, mit dem BLE-Geräte (z. B. Barcodescanner) und Host-Geräte (z. B. Android-Tablet) Daten über definierte **Services** und **Characteristics** austauschen können.

Wenn ein BLE-Scanner einen speziellen GATT-Service bzw. eine spezifische Characteristic zur Übertragung von Scan-Daten unterstützt, kann COBI.wms diese Daten ggf. auswerten – ohne HID-Modus.

Um diese Betriebsart zu nutzen, muss das BLE-Gerät **innerhalb von COBI.wms** auf dem Bluetooth-Bildschirm gekoppelt werden.

Bisher wird diese Methode nur von einer Scanner-Marke unterstützt: **Eyoyo** (getestet mit dem **EY-R30 2D** Fingerscanner). Leider überträgt dieses Modell das zuvor erwähnte FNC1-Symbol nicht, wodurch die Unterstützung von GS1-Barcodes ebenfalls nicht möglich ist. Zudem könnte dieses Modell für industrielle Anwendungen ungeeignet sein.

====== Barcode scanning via Bluetooth ======

COBI.wms supports using barcode scanners that connect to the Android device through **Bluetooth 4.0** or later, also called Bluetooth Low Energy, Bluetooth LE, or shortly **BLE**.

There are some challenges involved when using a BLE scanner.  The main problem is that there is no standardized Bluetooth specification for transmitting barcode-scan data.  For this reason, most BLE scanners pretend to be a keyboard (**HID device**) and send the scanned barcodes as a series of key-press events.

For this reason, we strongly recommend using an Android device with an integrated barcode scanner instead of connecting an external scanner via Bluetooth.  Nonetheless, this page describes the challenges involved and possible workarounds.

===== Using scanners that operate as a HID device =====

If you want to use a BLE scanner in HID mode, you must pair the device in the Android Settings (outside of COBI.wms), make sure that it's registered as a keyboard, and then within COBI.wms you must enable the **[[App Options|app option]]** called **"Barcode scan per keyboard input."**

**While this should work for plain (non-GS1) barcodes, it might not work with GS1 barcodes such as GS1 DataBar, GS1-128, GS1 DataMatrix, and GS1 QR Code.**

The reason for this is complex.  GS1 barcodes contain a special symbol called the "Function Code 1" (**FNC1**) which both appears as the beginning of the barcode to indicate that it's a GS1 barcode, and may appear in various places within the barcode to separate data fields.  For example, if there is a batch number field followed by a serial number field, and the batch number does not use all of the 20 digits that are allowed by the GS1 standard, then it must be ended with FNC1 before the next field (serial number) begins.

The problem is: the FNC1 symbol does not correspond to any letter, digit or other key on a keyboard, and therefore the scanner in HID mode may not transmit FNC1 symbols, which makes supporting GS1 barcodes with that scanner impossible.

Some scanners may nevertheless send the FNC1 symbol as a special key-combination (for example using the CTRL key).  This is known to work with BLE scanners from the brand **Inateck** (tested with the model **BCST-40**).  But please note that COBISOFT cannot guarantee that these devices are suitable for industrial use.

In COBI.wms, there is a workaround to this problem using pseudo-GS1 barcodes which are not standards-compliant.  The semicolon symbol ( **;** ) can be used in places where the FNC1 would normally appear.  For example, if you encode the following text as a Code 128 barcode or a DataMatrix code, then COBI.wms will recognized it as a GS1 barcode:

<html><pre>
;<span style="color:red">240</span>12345;<span style="color:red">10</span>BATCHXYZ;<span style="color:red">21</span>SERIALXYZ
</pre></html>

As you see, the text begins with a semicolon, which is to indicate that it's a GS1 code.  Later, it uses semicolons to end the data fields 240 (item code) and 10 (batch number).

If you use this workaround with a one-dimensional barcode format such as Code 128, it might result in a very long barcode which may be difficult to scan.  The reason is that special symbols like the semicolon are difficult to encode in Code 128 and produce a much longer barcode than if the FNC1 symbol was used.

If you use a two-dimensional encoding like DataMatrix or QR Code then it should work fine.  But please note that this workaround is a specialization for COBI.wms only, and it will not work with any other barcode scanning system unless it is programmed specifically to recognize these "fake" GS1 codes.

===== Using scanners with a custom GATT Service =====

In Bluetooth LE terminology, **GATT** is an abbreviation for Generic Attribute Profile and refers to a system that allows BLE devices (e.g. barcode scanner) and host device (e.g. Android tablet) to exchange any kind of specialized data by defining a set of **Services** and **Characteristics** for data exchange.

If a BLE scanner supports a specialized GATT Service/Characteristic for transmitting barcode scan events, then COBI.wms might be able to support it without needing to rely on HID mode.

To make use of this mode of operation, you have to pair the BLE device from within COBI.wms by opening the Bluetooth screen and finding the device there.

So far, there is only one brand of BLE scanner supported by COBI.wms in this way, which is **Eyoyo**.  (Tested with the **EY-R30 2D** finger scanner model.)  Sadly this model does not transmit the FNC1 symbol explained in the previous section, which makes supporting GS1 barcodes impossible, and the model might not be suitable for industrial use.