Table of Contents
Die OOBD Firmware Syntax
OOBD Team | S. Koehler |
Anforderung zur Kommentierung:6 | |
Obsoletes: - | |
Category: Standard | March 2014 |
Status dieser Nachricht
Diese Nachricht versorgt Dich mit Informationen wie die OOBD Firmware Syntax aufgebaut ist. Die Verteilung dieser Nachricht ist unbeschränkt.
Copyright Notiz
Copyright (C) OOBD Team (2014). Alle Rechte vorbehalten.
Einleitung
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 ;
P- Kommandos
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 } ;
Dateneingabe
Eingabe:
Daten <CR>
Rückmeldung
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 .
Fehler
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
Andere nicht angeforderte Ausgaben
Alle anderen Ausgaben der Firmware, welche keine Antwort auf ein p- Datenkommando sind, müssen mit einem führenden “#” Zeichen starten
#Eine Firmware Nachricht
Beispiele
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
Implementationsdetail
Das Senden von data
sperrt die Eingabe bis der Empfangstask auf einen Timeout läuft
Sicherheitsüberlegungen
Dieses RFC hat keine Sicherheitsaspekte.
Referenzen
Adresse des Autors
Steffen Koehler
Telefon: +49 172 410 35 98
EMail:steffen@koehlers.de
Anhang
Full Copyright Statement
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
Updates
Obsoletes
Obsoleted-by
Updated-by
Contact
Verteilerlisten
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