Die OOBD Firmware Syntax

Diese Nachricht versorgt Dich mit Informationen wie die OOBD Firmware Syntax aufgebaut ist. Die Verteilung dieser Nachricht ist unbeschränkt.

Copyright (C) OOBD Team (2014). Alle Rechte vorbehalten.

Unter der Vorraussetzung, daß es manch andere Software gibt die zum Interface Kontakt aufnimmt und Botschaften sendet, ist die Kommandostruktur einfach aber flexibel gestaltet worden.

Um dies zu erreichen, kennt die Schnittstelle nur zwei Arten von Eingaben, Daten und Parameter, die sogenannten P-Kommandos

In der die Werte definiert sind wie folgt (in EBNF- Syntax)

data = hex , { hex };
digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;
hex = "A" | "B" | "C" | "D" | "E" | "F" |"a" | "b" | "c" | "d" | "e" | "f" | digit ;

Eingabe:

p Funktionsblock , Kommando , Wert , {Wert} <CR>

die Definition ist wie folgt

p = "p" | "P" ;
Funktionsblock = Nummer ;
Kommando = Nummer ;
Wert = Nummer ;
Nummer = Ziffer  {Ziffer } | "$" , hex , { hex } ;

Eingabe:

Daten <CR>

Wenn das p-Kommando oder die Dateneingabe erfolgreich verarbeitet worden ist, antwortet die Firmware mit optional zusätzlichen Ausgaben und immer mit einer Linie die aus “.” Zeichen sich aufbaut.

Irgendeine Ausgabe
.

Falls ein Fehler auftritt, antwortet die Firmware mit “:error:”, der funktionalen Block ID, einer Fehlernummer und optional mehreren Fehlerkodes und Text

:error: 8 3 Kein Speicher mehr

Alle anderen Ausgaben der Firmware, welche keine Antwort auf ein p- Datenkommando sind, müssen mit einem führenden “#” Zeichen starten

#Eine Firmware Nachricht

Sende 11 Bytes Daten

Eingabe:

 112233445566778899AABB

Falls die Anzahl von Eingabewerten nicht gerade ist, wird das letzte Zeichen als MSB des letzten Bytes betrachtet, also

 112233445566778899AAB

wird gesendet als

 112233445566778899AAB0

Setze den Parameter 127 auf 64:

p 127 64

das Gleiche, aber nun in der Hexadezimalen Notation lautet:

p $7F $40

Das Senden von data sperrt die Eingabe bis der Empfangstask auf einen Timeout läuft

Dieses RFC hat keine Sicherheitsaspekte.

Steffen Koehler

Telefon: +49 172 410 35 98

EMail:steffen@koehlers.de

Copyright (C) OOBD Team (2014). All Rights Reserved.

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the OOBD Team organizations, except as needed for the purpose of developing standards in which case the procedures for copyrights defined in the Standards process must be followed, or as required to translate it into languages other than English.

The limited permissions granted above are perpetual and will not be revoked by the OOBD Team or its successors or assigns.

This document and the information contained herein is provided on an “AS IS” basis and THE OOBD TEAM DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.“ Relation to other RFCs

Die OOBD-RFC Ankündigungen werden durch die oobd-commit-messages@googlegroups.com mailingliste verteilt.

Um diese zu nutzen (oder sich davon abzumelden) benutze https://groups.google.com/forum/?hl=de&fromgroups=#!forum/oobd-commit-messages