Ändern des Bluetooth-Namens


⚠️ Achtung: Dieses Dokument beschreibt, wie man die API des SDKs verwendet, um Scan-Geräte zu bedienen, und enthält Beispielcode in C. Beachten Sie, dass die API synchron arbeitet und den Hauptthread blockieren kann.

⚠️ Achtung: Vor der Verwendung der API müssen Sie das Gerät selbst verbinden und Nachrichtenbenachrichtigungen registrieren, um Nachrichten vom Gerät zu empfangen. Die genauen Schritte finden Sie unter Nachrichtenbenachrichtigung.

1. Ändern des Bluetooth-Namens

Um den Bluetooth-Namen des Scan-Geräts zu ändern, müssen Sie die folgenden Bluetooth-Dienst- und Charakteristik-UUIDs für die write without response-Operation verwenden:

Bluetooth UUID
Dienst 0x0000ff0000001000800000805f9b34fb
Charakteristik 0x0000ff0400001000800000805f9b34fb

Verwenden Sie den folgenden Befehl, um die Daten für die Schreiboperation zu erhalten:

const char* result = inateck_scanner_cmd_set_name(new_name);

Eingabeparameter:


Das Ergebnis wird im JSON-Format zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result folgendes zurückgeben:

{
    "status": 0,
    "data": [0, 1, 2, 3],
}

Wenn der Aufruf fehlschlägt, wird result folgendes zurückgeben:

{
    "status": 1,
    "data": [],
}

2. Nachrichtenanalyse

Nachdem das Gerät geantwortet hat, können Sie die Daten mit der folgenden Methode analysieren:

int result = inateck_scanner_cmd_check_result(data, data_length);

Das Ergebnis wird als int-Typ zurückgegeben. Wenn der Aufruf erfolgreich ist, wird result 0 zurückgeben. Wenn der Aufruf fehlschlägt, wird result 1 zurückgeben.

3. Beispielcode

#include <stdio.h>
#include <string.h>
#include <stdbool.h>
#include <unistd.h>
#include "inateck_scanner_ble.h"

int main() {
    const char* new_name = "Inateck Scanner";
    const char* result = inateck_scanner_cmd_set_name(new_name);
    if (result) {
        // result ist im JSON-Format, Daten analysieren
        const unsigned char* data = (const unsigned char*)result;
        int data_length = strlen(result);

        // Daten über Bluetooth senden, write without response
        // Hier wird angenommen, dass es eine Funktion send_data_via_bluetooth gibt, die Daten sendet
        send_data_via_bluetooth(data, data_length);

        // Auf Antwort des Geräts warten, Daten empfangen
        // Hier wird angenommen, dass es eine Funktion receive_data_via_bluetooth gibt, die Daten empfängt
        receive_data_via_bluetooth();

        const unsigned char* data = get_received_data();
        int data_length = get_received_data_length();

        // Daten analysieren
        int result = inateck_scanner_cmd_check_result(data, data_length);
        if (result == 0) {
            printf("Name erfolgreich gesetzt\n");
        } else {
            printf("Name setzen fehlgeschlagen\n");
        }
    }
    return 0;
}