Selfbus Namenskonventionen
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 wie die Kauflösungen von MDT, Jung, ADD, etc.
Ein Selfbus-Gerät setzt sich in der Regel zusammen aus aus mehreren Bausteinen. Die Denke in Bausteinen repräsentiert mehr die Sicht eines Entwicklers, die Denke in Geräten mehr die eines Anwenders.
- Aktoren
- Sensoren
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 oder SMD LPC).
Tabelle: Bausteinkombinationen 8fach Schaltaktor
Gerät | Controller-Baustein | Applikations-Baustein |
---|---|---|
8fach Schaltaktor | Controller LPC | 8out LPC |
8fach Schaltaktor | Controller SMD LPC | 8out LPC |
8fach Schaltaktor | Controller ARM | 8out ARM |
Hardware-Bezeichnungen
Verwendeter Begriff | Standardisierter Begriff | Erläuterung |
LPC, LPC 922, DIL | LPC922 DIL | |
SMD LPC, LPC 922 | LPC922 SMD | |
ARM | LPC1115 | |
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} - {Einbaugröße} - {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
- Controller LPCSMD - 4TE
- Applikation 8out ARM - 4TE - bistabile Relais - v2.1
- Addon Tasterplatine - 4TE - V1
- Einbaumodul 8fach Binäreingang ARM - UP - v3.7
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!