User Tools

Site Tools


de:doc:rfc_firmware_syntax

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 (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

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

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
de/doc/rfc_firmware_syntax.txt · Last modified: 2014/09/22 21:57 by wsauer