ECMD: Unterschied zwischen den Versionen

Aus Ethersex_Wiki
Wechseln zu: Navigation, Suche
K (link auf Mailing Listen Diskussion)
K (→‎Vorbereitung: Blocksatz für die Code-Zeile)
 
(5 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 parse_FUNCTIONSNAME (char *cmd, char *output, uint16_t len)
+
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 parse_FUNCTIONSNAME2 (char *cmd, char *output, uint16_t len)
+
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 =
−
Wenn du dein ethersex mit ECMD in einer hohen Geschwindigkeit angesprechen möchtest, ist für dich die Rate wichtig, in der das ethersex in der Lage ist, ECMD Anfragen zu beantworten. Hierzu gibt es eine kleine Untersuchung, die auf einem Pollin AVR-NET-IO mit ATMega32 durchgeführt wurde:
 
  
−
{| border='1'
+
Eine Untersuchung zur Geschwindigkeit verschiedener Anbindungen und Konfigurationen ist unter [[ECMD Geschwindigkeit]] zu finden.
−
| ''Beantwortete Anfragen pro Sekunde''
 
−
| ''Weg der Anfrage''
 
−
| ''gesandtes ECMD''
 
−
|-
 
−
| 480
 
−
| Netzwerk, TCP
 
−
| adc get
 
−
|-
 
−
| 17
 
−
| T-DSL 2000, TCP
 
−
| adc get
 
−
|-
 
−
| 32
 
−
| RS232 (115200 baud)
 
−
| adc get
 
−
|-
 
−
| 627
 
−
| Netzwerk, TCP
 
−
| whm
 
−
|-
 
−
|}
 
−
 
 
−
Diese Werte wurden mithilfe des Python-Projekts avrnetio von pklaus ermittelt, das auf http://github.com/pklaus/avrnetio zu finden ist. Für die serielle Kommunikation wird pySerial verwendet, für Netzwerk python sockets (TCP mit persistenter Verbindung). Konkret genutzt wurden die beiden Skripte example.highSpeedMeasurement.py und example.highSpeedMeasurementSerial.py, die für eine eigene Untersuchung anzupassen wären.
 
−
Die verwendete ethersex Version ist der Commit [http://github.com/ethersex/ethersex/commit/e9c8928fcbf110fb5ddb5aacc08226a012e6da64 e9c8928] mit einer Laufzeit (whm) von mittlerweile 817 Stunden (34 days).
 
−
 
 
−
siehe auch: http://list.zerties.org/pipermail/ethersex-devel/2009-February/000724.html
 
  
 
[[Kategorie:ECMD]]
 
[[Kategorie:ECMD]]

Aktuelle Version vom 12. Juni 2011, 09:47 Uhr

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

  1. Wechsel in den Ordner des Moduls, welches ein neues ECMD bekommen soll.
  2. Erstelle eine Datei [modulname]_ecmd.c
  3. 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.

Abgerufen von „http://old.ethersex.de/index.php?title=ECMD&oldid=4909“