From 56d9bdd39ed36c36e9a61411b86c76d5228b2133 Mon Sep 17 00:00:00 2001 From: sicarius Date: Sun, 11 Feb 2007 18:32:03 +0000 Subject: Added lot's of code-files used during work --- source/ct-Bot/Documentation/remote-calls.html | 33 +++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 source/ct-Bot/Documentation/remote-calls.html (limited to 'source/ct-Bot/Documentation/remote-calls.html') diff --git a/source/ct-Bot/Documentation/remote-calls.html b/source/ct-Bot/Documentation/remote-calls.html new file mode 100644 index 0000000..3691afe --- /dev/null +++ b/source/ct-Bot/Documentation/remote-calls.html @@ -0,0 +1,33 @@ + + + + + + + + +c't-Bot -Remote-Calls + + + +

Dokumentation zum Remote-Call-System

+
+

Funktionsweise der Remote-Calls für den c't-Bot:

Auf das Kommando CMD_REMOTE_CALL:SUB_REMOTE_CALL_LIST schickt der Bot +eine Liste mit den verfügbaren Remote-Calls an den PC.
+Jeder Listeneintrag kommt als eigenes Kommando (CMD_REMOTE_CALL:SUB_REMOTE_CALL_ENTRY).
+In der Payload steht neben dem Namen der Funktion auch, wie sie aufzurufen +ist und welche Parameter sie braucht. Das geschieht, indem die ganze interne +Datenstruktur (siehe call_t in remote_calls.h) übertragen wird.

Der PC kann jederzeit einen Remote-Call starten. Dazu schickt es das Kommando + CMD_REMOTE_CALL:SUB_REMOTE_CALL_ORDER. In der Payload steht zuerst der Name +der Funktion (null terminierter String). Danach kommen die Parameter. Jeder +Parameter muss dabei (unabhängig von seiner tatsächlichen Länge) 32 Bit belegen.

Ist der Bot fertig, antwortet er mit CMD_REMOTE_CALL:SUB_REMOTE_CALL_DONE +im DataL Feld steht eine 0, wenn das Verhalten nicht erfolgreich ausgeführt wurde. Steht dort eine 1, ist alles ok.

Um eigen Verhalten remote-aufrufbar zu machen, muss man ihre Botenfunktion nur in +die calls-Struktur in behaviour_remotecall.c eintragen. Wie das geht ist dort +ausführlich beschrieben. Alles andere übernimmt das Framework.

+ + + \ No newline at end of file -- cgit v1.2.3