Eine einheitliche Verwendung von Begriffen und Strukturen erleichtert die Kommunikation. Neueinsteiger werden so das Projekt leichter verstehen, Alteingesessenen erleichtert es das Nachvollziehen von lange zurückliegenden Entwicklungen.

Hier werden die wichtigsten allgemeinen Konventionen zusammengefasst.

--- ENTWURF ---

Geräte

Selfbus-Geräte sind am Ende KNX-kompatible Geräte, die sich ähnlich wie die Kauflösungen verhalten.
Ein Selfbus-Gerät setzt sich in der Regel zusammen aus aus mehreren Bausteinen. Das Denken in Bausteinen repräsentiert mehr die Sicht eines Entwicklers, die Denke in Geräten mehr die eines Anwenders.

Wichtig ist festzuhalten, welche Kombinationen von konkreten Bausteinen valide sind, um ein fuktionierendes Gerät zu erzeugen.
Beispiel: "derselbe" 8fach Schaltaktor kann zwar dieselbe Applikationsplatine verwenden, aber verschiedene Controller (LPC922 SMD, LPC922 DIL oder LPC1115).

Tabelle: Bausteinkombinationen 8fach Schaltaktor

GerätController-BausteinApplikations-Baustein
8fach SchaltaktorController LPC

8out LPC

8fach SchaltaktorController SMD LPC8out LPC
8fach SchaltaktorController ARM8out ARM

Hardware-Bezeichnungen

Verwendeter BegriffStandardisierter BegriffErläuterung

LPC, LPC 922, DIL

LPC922 DIL 
SMD LPC, LPC 922LPC922 SMD 
ARMLPC1115 
   

Dokumentation

Auch eine Vereinheitlichung der Struktur und Namen in der Dokumentation ist sinvoll - alleine, weil man sich schneller zurecht findet beim Suchen von Inhalten.

Bezeichnung von Hardwarebausteinen

[{Einaulage}] {Bausteintyp} {Bausteinname} {Prozessorvariante} - {Einbauort} - [{besondere Eigenschaft}] - {Version}

Besonderheit: Manche Module (wie z.B. Einbaumodule) bestehen aus nur einem Hardwarebaustein! Daher müssten diese konsequenter Weise sowohl bei den Hardwarebausteinen als auch bei den Geräten gelistet werden.

Beispiele:

  • Controller ARM - 4TE - v1.02
  • Controller LPCSMD - 4TE - v3.54
  • Applikation 8out ARM - 4TE - bistabile Relais - v2.1
  • Addon Tasterplatine - 4TE - v1.0
  • Einbaumodul Binäreingang LPC1115 - UP - v3.7
  • Systembaustein FT1.2-Modul - HAT - v1.1

Liste der Bausteintypen

  • Applikation
  • Controller
  • Addon
  • Systembaustein
  • Einbaumodul

Liste der Prozessorvarianten

  • LPC922
  • LPC1115
  • leer (für Bausteine, die sowohl von einem LPC922- als auch einem LPC1115-basierten Controller angesprochen werden können)

Liste der Einbauorte

  • 1TE
  • 2TE
  • 4TE (am häufigsten verwendet: REG-Gehäuse mit einer Breite von 4 Teilungseinheiten)
  • 6TE
  • 8TE
  • UP (Gerät hat in einer Hohlwand- / Unterputzdose Platz)
  • ET206 (BOPLA ET-206-Gehäuse)
  • PK101 (BOPLA PK 101-Gehäuse)
  • HAT (Hardware Attached on Top - Modul, das auf einen RPi aufgestelckt werden kann (https://www.raspberrypi.org/blog/introducing-raspberry-pi-hats/ ))

Liste der Einbaulagen

  • TOP
  • MID
  • BOT

Die standardmäßig verwendeten REG-Einbaugehäuse haben drei verwendbare Abschnitte. Der untere (BOT) ist der flächenmäßig größte und trägt typischerweise die Applikationsplatine mit den Fahrstuhlklemmen. Der mittlere (MID) wurde bisher fast immer verwendet, um die Controllerplatine aufzunehmen. Der obere (TOP) wurde meist verwendet, um Addon-Platinen für Taster / LEDs unterzubringen.

Wird vom Standard (BOT = Applikation, MID = Controller, TOP = Addon) abgewichen, sollte das auf jeden Fall in der Bezeichnung angegeben werden.

Natürlich könnten diese Einbaulagen auch Einbaulagen von Platinen in anderen Gehäusen als den REG-Gehäusen differenzieren!

Tags:
Created by Christian B. on 2018/01/11 00:13