Difference between revisions of "ECMD (Deutsch)"
(Created page with "= 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 Ko…") |
(→ECMD Geschwindigkeit) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| + | {{i18n|ECMD}} | ||
| + | {{Module | ||
| + | |NAME=ECMD | ||
| + | |MENUCONFIG={{Protocols}}->ECMD (Etherrape Command Interface) support | ||
| + | |STATUS={{stable}} | ||
| + | |PINNING=no | ||
| + | |ECMD={{has_ecmd}} | ||
| + | |DEPENDS= | ||
| + | |REQUIRES= | ||
| + | |CODE=[https://github.com/ethersex/ethersex/tree/master/protocols/ecmd https://github.com/ethersex/ethersex/tree/master/protocols/ecmd] | ||
| + | }} | ||
| + | |||
= Was ist ECMD? = | = 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 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]]. | ||
| Line 60: | Line 72: | ||
Eine Untersuchung zur Geschwindigkeit verschiedener Anbindungen und Konfigurationen ist unter [[ECMD Geschwindigkeit]] zu finden. | Eine Untersuchung zur Geschwindigkeit verschiedener Anbindungen und Konfigurationen ist unter [[ECMD Geschwindigkeit]] zu finden. | ||
| − | |||
| − | |||
Latest revision as of 17:32, 7 April 2012
| ECMD | |
|---|---|
| Status | Stable
|
| menuconfig | Protocols->ECMD (Etherrape Command Interface) support |
| Pinning | no |
| Ecmd | yes |
| Code | https://github.com/ethersex/ethersex/tree/master/protocols/ecmd |
Contents
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.
