Wiki source code of Selfbus Namenskonventionen

Version 3.1 by Christian B. on 2019/04/30 00:48
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 (% class="row" %)
6 (((
7 (% class="col-xs-12 col-sm-8" %)
8 (((
9 (% class="jumbotron" %)
10 (((
11 (% class="container" %)
12 (((
13 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.
14
15 Hier werden die wichtigsten allgemeinen Konventionen zusammengefasst.
16 )))
17 )))
18
19 == ~-~-- ENTWURF ~-~-- ==
20
21 == Geräte ==
22
23 Selfbus-Geräte sind am Ende KNX-kompatible Geräte, die sich ähnlich wie die Kauflösungen verhalten.
24 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.
25
26 Wichtig ist festzuhalten, welche Kombinationen von konkreten Bausteinen valide sind, um ein fuktionierendes Gerät zu erzeugen.
27 Beispiel: "derselbe" 8fach Schaltaktor kann zwar dieselbe Applikationsplatine verwenden, aber verschiedene Controller (LPC922 SMD, LPC922 DIL oder LPC1115).
28
29 ,,Tabelle: Bausteinkombinationen 8fach Schaltaktor,,
30
31 (% style="height:159px; width:976px" summary="Bausteinkombinationen 8fach Schaltaktor" %)
32 |=(% scope="row" %)Gerät|=Controller-Baustein|=(% style="vertical-align:top" %)Applikations-Baustein
33 |=8fach Schaltaktor|Controller LPC|(% style="vertical-align:top" %)(((
34 8out LPC
35 )))
36 |=8fach Schaltaktor|Controller SMD LPC|(% style="vertical-align:top" %)8out LPC
37 |=(% style="vertical-align:top" %)8fach Schaltaktor|(% style="vertical-align:top" %)Controller ARM|(% style="vertical-align:top" %)8out ARM
38
39 == Hardware-Bezeichnungen ==
40
41 |Verwendeter Begriff|(% style="vertical-align:top" %)Standardisierter Begriff|Erläuterung
42 |(((
43 LPC, LPC 922, DIL
44 )))|(% style="vertical-align:top" %)LPC922 DIL|
45 |SMD LPC, LPC 922|(% style="vertical-align:top" %)LPC922 SMD|
46 |ARM|(% style="vertical-align:top" %)LPC1115|
47 | |(% style="vertical-align:top" %) |
48
49 == Dokumentation ==
50
51 Auch eine Vereinheitlichung der Struktur und Namen in der Dokumentation ist sinvoll - alleine, weil man sich schneller zurecht findet beim Suchen von Inhalten.
52
53 === Bezeichnung von Hardwarebausteinen ===
54
55 [{Einaulage}] {Bausteintyp} {Bausteinname} {Prozessorvariante} - {Einbauort} - [{besondere Eigenschaft}] - {Version}
56
57 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.
58
59 **Beispiele**:
60
61 * Controller ARM - 4TE - v1.02
62 * Controller LPCSMD - 4TE - v3.54
63 * Applikation 8out ARM - 4TE - bistabile Relais - v2.1
64 * Addon Tasterplatine - 4TE - v1.0
65 * Einbaumodul Binäreingang LPC1115 - UP - v3.7
66 * Systembaustein FT1.2-Modul - HAT - v1.1
67
68 === Liste der Bausteintypen ===
69
70 * Applikation
71 * Controller
72 * Addon
73 * Systembaustein
74 * Einbaumodul
75
76 === Liste der Prozessorvarianten ===
77
78 * LPC922
79 * LPC1115
80 * //leer //(für Bausteine, die sowohl von einem LPC922- als auch einem LPC1115-basierten Controller angesprochen werden können)
81
82 === Liste der Einbauorte ===
83
84 * 1TE
85 * 2TE
86 * 4TE (am häufigsten verwendet: REG-Gehäuse mit einer Breite von 4 Teilungseinheiten)
87 * 6TE
88 * 8TE
89 * UP (Gerät hat in einer Hohlwand- / Unterputzdose Platz)
90 * ET206 (BOPLA ET-206-Gehäuse)
91 * PK101 (BOPLA PK 101-Gehäuse)
92 * HAT (Hardware Attached on Top - Modul, das auf einen RPi aufgestelckt werden kann ([[https:~~/~~/www.raspberrypi.org/blog/introducing-raspberry-pi-hats/ )>>https://www.raspberrypi.org/blog/introducing-raspberry-pi-hats/]])
93
94 === Liste der Einbaulagen ===
95
96 * TOP
97 * MID
98 * BOT
99
100 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.
101
102 Wird vom Standard (BOT = Applikation, MID = Controller, TOP = Addon) abgewichen, sollte das auf jeden Fall in der Bezeichnung angegeben werden.
103
104 Natürlich könnten diese Einbaulagen auch Einbaulagen von Platinen in anderen Gehäusen als den REG-Gehäusen differenzieren!
105
106 == ==
107 )))
108 )))