Präfix- und Suffix-Konfiguration¶
⚠️ Achtung: Dieses Dokument beschreibt, wie man die API des SDKs verwendet, um Scan-Geräte zu bedienen, und bietet Beispielcode in C. Beachten Sie, dass die API synchron arbeitet und den Hauptthread blockieren kann.
⚠️ Achtung: Vor der Verwendung der API muss das Gerät verbunden werden. Die genauen Schritte finden Sie unter Gerät verbinden.
1. Präfix setzen¶
Setzen Sie das Präfix des Scan-Geräts. Die Verwendung ist wie folgt:
const char* result = inateck_scanner_ble_set_prefix(device_id, prefix, prefix_length);
Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result zurückgegeben:
{
"status": 0,
"error": "",
}
Wenn der Aufruf fehlschlägt, wird result zurückgegeben:
{
"status": 1,
"error": "Fehlermeldung",
}
Die Eingabeparameter sind wie folgt:
prefix: Präfix-String, maximale Länge 32 Bytes, das letzte Byte muss0xFFsein. Der Zeichenbereich ist in der benutzerdefinierten Kodierungstabelle beschrieben. Zum Beispiel, wenn das PräfixABCist, sollteprefix0x41 0x42 0x43 0xFFsein.prefix_length: Länge des Präfixes, maximal 32 Bytes.
2. Präfix abrufen¶
Abrufen des Präfixes des Scan-Geräts. Die Verwendung ist wie folgt:
const char* result = inateck_scanner_ble_get_prefix(device_id);
Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result zurückgegeben:
{
"status": 0,
"error": "",
"prefix": [0x41, 0x42, 0x43, 0xFF],
}
Wenn der Aufruf fehlschlägt, wird result zurückgegeben:
{
"status": 1,
"error": "Fehlermeldung",
"prefix": [],
}
Die Rückgabeparameter sind wie folgt:
prefix: Präfix-Byte-Array. Die Byte-Analyse ist in der benutzerdefinierten Kodierungstabelle beschrieben.
3. Suffix setzen¶
Setzen Sie das Suffix des Scan-Geräts. Die Verwendung ist wie folgt:
const char* result = inateck_scanner_ble_set_suffix(device_id, suffix, suffix_length);
Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result zurückgegeben:
{
"status": 0,
"error": "",
}
Wenn der Aufruf fehlschlägt, wird result zurückgegeben:
{
"status": 1,
"error": "Fehlermeldung",
}
Die Eingabeparameter sind wie folgt:
suffix: Suffix-String, maximale Länge 32 Bytes, das letzte Byte muss0xFFsein. Der Zeichenbereich ist in der benutzerdefinierten Kodierungstabelle beschrieben. Zum Beispiel, wenn das SuffixXYZist, solltesuffix0x58 0x59 0x5A 0xFFsein.suffix_length: Länge des Suffixes, maximal 32 Bytes.
4. Suffix abrufen¶
Abrufen des Suffixes des Scan-Geräts. Die Verwendung ist wie folgt:
const char* result = inateck_scanner_ble_get_suffix(device_id);
Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result zurückgegeben:
{
"status": 0,
"error": "",
"suffix": [0x58, 0x59, 0x5A, 0xFF],
}
Wenn der Aufruf fehlschlägt, wird result zurückgegeben:
{
"status": 1,
"error": "Fehlermeldung",
"suffix": [],
}
Die Rückgabeparameter sind wie folgt:
suffix: Suffix-Byte-Array. Die Byte-Analyse ist in der benutzerdefinierten Kodierungstabelle beschrieben.
5. Beispielcode¶
#include <stdio.h>
#include <string.h>
#include <stdbool.h>
#include <unistd.h>
#include "inateck_scanner_ble.h"
int main() {
const char* device_id = "Geräte-ID";
const char prefix[] = {0x41, 0x42, 0x43, 0xFF};
const char suffix[] = {0x58, 0x59, 0x5A, 0xFF};
const char* result = inateck_scanner_ble_set_prefix(device_id, prefix, sizeof(prefix));
printf("set prefix result: %s\n", result);
result = inateck_scanner_ble_get_prefix(device_id);
printf("get prefix result: %s\n", result);
result = inateck_scanner_ble_set_suffix(device_id, suffix, sizeof(suffix));
printf("set suffix result: %s\n", result);
result = inateck_scanner_ble_get_suffix(device_id);
printf("get suffix result: %s\n", result);
return 0;
}