Nutzung Der Programmierschnittstelle (Api); Usb-Api-Funktionen - Yamaha CS-700 Betriebsanleitung

Nutzung der Programmierschnittstelle (API)

Das Yahama CS-700 bietet eine Schnittstelle zur Einbindung externer
Anwendungen zur direkten Steuerung und Verwaltung des Systems ohne die
Nutzung der Verwaltungsschnittstellen von Yahama. Die API ermöglicht den
Zugang zum CS-700 entweder über eine USB-Verbindung oder das Netzwerk.
Nutzungsbeispiel ist die Integration mit Raumsteuerungssystemen.
Die API und umfassende Dokumentation zur Schnittstelle können unter
https://www.revolabs.com/products/cs-700/download
steht in Form von C-Bibliotheken für die Betriebssysteme Windows, macOS
und Chrome OS zur Verfügung.
In den nachfolgenden Abschnitten finden Sie die Beschreibung einer Teilmenge
der verfügbaren Funktionen und Befehle.

USB-API-Funktionen

CsDevComm_Mode enum
Beschreibung: Auflistung der USB-Verbindungstypen. Der Client sollte zu Beginn einer Sitzung den
Verbindungstyp, Auto, HID oder Bulk, festlegen. Auto wählt Bulk, soweit verfügbar,
ansonsten HID. Bulk wird für die Aktualisierung der Firmware empfohlen.
Syntax:
typedef enum {
CsDevComm_Mode_Auto = 0,
CsDevComm_Mode_Hid,
CsDevComm_Mode_Bulk,
CsDevComm_Mode_Num
} CsDevComm_Mode;
devAttach
Beschreibung: Herstellung einer USB-Verbindung zu einem Gerät
Syntax:
EXPORT int __stdcall devAttach(int mode, void(*debug_callback)(char *msg),
Parameter:
Parameter Beschreibung
mode Der USB-Verbindungsmodus, entweder HID oder Bulk, Auswahl aus enum
CsDevComm_Mode
debug_callback Zeiger auf Callback-Funktion zur Verarbeitung von Debug-Meldungen
Zeiger auf Debug-Meldung
msg
heruntergeladen werden. Die API
void(*event_callback)(int type));
78