Lesen der Geräteversionsinformationen und des Batteriestands


⚠️ Hinweis: Dieses Dokument beschreibt, wie Sie die API des SDKs verwenden, um Geräteoperationen durchzuführen, und bietet Beispielcode in C. Beachten Sie, dass die API synchron arbeitet und den Hauptthread blockieren kann.

⚠️ Hinweis: Vor der Verwendung der API muss das Gerät verbunden werden. Die genauen Schritte finden Sie unter Gerät verbinden.

1. Lesen der Bluetooth-Version des Geräts

Lesen der Bluetooth-Version des Geräts. Methode wie folgt:

const char* result = inateck_scanner_ble_get_hardware_version(device_id);

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

{
    "status": 0,
    "error": "",
    "version": "OTA_D_V0.1.8"
}

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

{
    "status": 1,
    "error": "Fehlermeldung",
    "version": ""
}

version ist die Bluetooth-Version des Geräts. Zum Beispiel: OTA_D_V0.1.8, wobei V0.1.8 die Versionsnummer ist.

2. Lesen der Firmware-Version des Geräts

Lesen der Firmware-Version des Geräts. Methode wie folgt:

const char* result = inateck_scanner_ble_get_software_version(device_id);

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

{
    "status": 0,
    "error": "",
    "version": "BCST-75 V1.1.0 AI"
}

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

{
    "status": 1,
    "error": "Fehlermeldung",
    "version": ""
}

version ist die Firmware-Version des Geräts. Zum Beispiel: BCST-75 V1.1.0 AI,

3. Lesen des Batteriestands des Geräts

Lesen des Batteriestands des Geräts. Methode wie folgt:

const char* result = inateck_scanner_ble_get_battery(device_id);

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

{
    "status": 0,
    "error": "",
    "battery": 100
}

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

{
    "status": 1,
    "error": "Fehlermeldung",
    "battery": 0
}

battery ist der Batteriestand des Geräts. Zum Beispiel: 100 bedeutet, dass der Batteriestand 100% beträgt.

4. Beispielcode

Hier ist ein vollständiger Beispielcode:

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

int main() {
    const char* device_id = "device_id";
    const char* result = inateck_scanner_ble_get_hardware_version(device_id);
    if (result) {
        printf("Hardware-Version: %s\n", result);
    } else {
        printf("Hardware-Version konnte nicht abgerufen werden\n");
    }

    result = inateck_scanner_ble_get_software_version(device_id);
    if (result) {
        printf("Software-Version: %s\n", result);
    } else {
        printf("Software-Version konnte nicht abgerufen werden\n");
    }

    result = inateck_scanner_ble_get_battery(device_id);
    if (result) {
        printf("Batterie: %s\n", result);
    } else {
        printf("Batteriestand konnte nicht abgerufen werden\n");
    }

    return 0;
}

5. Beispielcode in anderen Sprachen