ECMD: Unterschied zwischen den Versionen
Pklaus (Diskussion | Beiträge) K (→ECMD Geschwindigkeit: kleine Korrekturen) |
Pklaus (Diskussion | Beiträge) K (→Vorbereitung: Blocksatz für die Code-Zeile) |
||
| (10 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 8: | Zeile 8: | ||
== Vorbereitung == | == Vorbereitung == | ||
# Wechsel in den Ordner des Moduls, welches ein neues ECMD bekommen soll. | # Wechsel in den Ordner des Moduls, welches ein neues ECMD bekommen soll. | ||
| − | # Erstelle eine Datei [modulname]_ecmd.c | + | # Erstelle eine Datei <tt>[modulname]_ecmd.c</tt> |
| − | # Füge #include "protocols/ecmd/ecmd-base.h ein | + | # Füge <tt>#include "protocols/ecmd/ecmd-base.h</tt> ein |
== Funktionen == | == Funktionen == | ||
Baue nun Funktionen mit einer Signatur wie die folgende Funktion hat: | Baue nun Funktionen mit einer Signatur wie die folgende Funktion hat: | ||
<pre> | <pre> | ||
| − | int16_t | + | int16_t parse_cmd_FUNCTIONSNAME (char *cmd, char *output, uint16_t len) |
{ | { | ||
zu_was(); | zu_was(); | ||
| Zeile 23: | Zeile 23: | ||
Wenn etwas schief läuft oder die Argumentanzahl falsch ist, dann kannst du ECMD_ERR_PARSE_ERROR zurückgeben. Wie läuft das eigentlich mit den ecmd Argumenten für dein neues Kommando? Hier siehst du ein kleines Beispiel um 3 Zahlen als Argumente entgegen zunehmen: | Wenn etwas schief läuft oder die Argumentanzahl falsch ist, dann kannst du ECMD_ERR_PARSE_ERROR zurückgeben. Wie läuft das eigentlich mit den ecmd Argumenten für dein neues Kommando? Hier siehst du ein kleines Beispiel um 3 Zahlen als Argumente entgegen zunehmen: | ||
<pre> | <pre> | ||
| − | int16_t | + | int16_t parse_cmd_FUNCTIONSNAME2 (char *cmd, char *output, uint16_t len) |
{ | { | ||
uint8_t val1=0; | uint8_t val1=0; | ||
| Zeile 58: | Zeile 58: | ||
= ECMD Geschwindigkeit = | = ECMD Geschwindigkeit = | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | Eine Untersuchung zur Geschwindigkeit verschiedener Anbindungen und Konfigurationen ist unter [[ECMD Geschwindigkeit]] zu finden. | ||
[[Kategorie:ECMD]] | [[Kategorie:ECMD]] | ||
Aktuelle Version vom 12. Juni 2011, 09:47 Uhr
Inhaltsverzeichnis
Was ist ECMD?
ECMD steht für Ethersex Command. ECMD ist ein einfaches, textbasiertes Protokoll mit dem mit einem Ethersex-System kommuniziert werden kann. Neben der Konfiguration des Ethersex Systems können auch die Hardware Schnittstellen angesprochen werden. Viele Module bieten ebenfalls ecmd Unterstützung an. Einen Überblick über die implementieren Befehle gibt die ECMD Reference.
ECMD Schnittstellen
Unter ECMD Protokolle kannst du nachlesen, wie dein ethersex mit ECMD angesprochen werden kann. Wenn du dein ethersex über Shell Scripte oder eigene Programme ansprechen möchtest, empfiehlt sich evtl. die libecmd (geschrieben in C) im contrib Ordner, welche alle ECMD Protokolle beherrscht.
Eigenen ECMD Befehl erstellen
Vorbereitung
- Wechsel in den Ordner des Moduls, welches ein neues ECMD bekommen soll.
- Erstelle eine Datei [modulname]_ecmd.c
- Füge #include "protocols/ecmd/ecmd-base.h ein
Funktionen
Baue nun Funktionen mit einer Signatur wie die folgende Funktion hat:
int16_t parse_cmd_FUNCTIONSNAME (char *cmd, char *output, uint16_t len)
{
zu_was();
return ECMD_FINAL_OK;
}
ECMD_FINAL_OK bedeutet hier, das der Aufruf ein Erfolg war. Hierrauf wird im http Interface beispielsweise ein OK zurückgegeben. Wenn etwas schief läuft oder die Argumentanzahl falsch ist, dann kannst du ECMD_ERR_PARSE_ERROR zurückgeben. Wie läuft das eigentlich mit den ecmd Argumenten für dein neues Kommando? Hier siehst du ein kleines Beispiel um 3 Zahlen als Argumente entgegen zunehmen:
int16_t parse_cmd_FUNCTIONSNAME2 (char *cmd, char *output, uint16_t len)
{
uint8_t val1=0;
uint8_t val2=0;
uint8_t val3 = 0;
ret = sscanf_P(cmd, PSTR("%hhu %hhu %hhu"), &val1, &val2, &val3);
if (ret == 3)
return ECMD_FINAL_OK;
else
return ECMD_ERR_PARSE_ERROR;
}
Möchtest du auch andere Dinge als OK und PARSE ERROR zurückgeben können, nimmst du folgenden Code:
return ECMD_FINAL(snprintf_P(output, len, PSTR("%u"), uint_value));
Hier wurde ein unsigned int zurückgegeben.
Bekanntmachen
Nun musst du deine Funktion noch dem Rest der Firmware bekannt machen. Füge daher ganz unten in der Datei folgendes ein:
/* -- Ethersex META -- block(Cooles Modul) ecmd_feature(FUNCTIONSNAME, "NEW ECMD COMMAND",, DESCRIPTION) ecmd_feature(FUNCTIONSNAME2, "NEW ECMD COMMAND2",VAL1 VAL2 VAL3, DESCRIPTION) */
Makefile erweitern
Läuft analog zu normalen anderen Quellcode Dateien.
ECMD Geschwindigkeit
Eine Untersuchung zur Geschwindigkeit verschiedener Anbindungen und Konfigurationen ist unter ECMD Geschwindigkeit zu finden.
