Wiki source code of Selfbus Namenskonventionen

Version 6.6 by Christian B. on 2020/11/03 12:10
Show last authors
1 (% id="cke_bm_149S" style="display:none" %) (%%)
2
3 {{box cssClass="floatinginfobox" title="**Contents**"}}
4 [[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
5 {{/box}}
6
7 (% class="row" %)
8 (((
9 (% class="col-xs-12 col-sm-8" %)
10 (((
11 (% class="jumbotron" %)
12 (((
13 (% class="container" %)
14 (((
15 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.
16
17 Hier werden die wichtigsten allgemeinen Konventionen zusammengefasst.
18 )))
19 )))
20
21 == ~-~-- ENTWURF ~-~-- ==
22
23 == Geräte ==
24
25 Selfbus-Geräte sind am Ende KNX-kompatible Geräte, die sich ähnlich wie die Kauflösungen verhalten.
26 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.
27
28 Wichtig ist festzuhalten, welche Kombinationen von konkreten Bausteinen valide sind, um ein fuktionierendes Gerät zu erzeugen.
29 Beispiel: "derselbe" 8fach Schaltaktor kann zwar dieselbe Applikationsplatine verwenden, aber verschiedene Controller (LPC922 SMD, LPC922 DIL oder LPC1115).
30
31 ,,Tabelle: Bausteinkombinationen 8fach Schaltaktor,,
32
33 (% style="height:159px; width:976px" summary="Bausteinkombinationen 8fach Schaltaktor" %)
34 |=(% scope="row" %)Gerät|=Controller-Baustein|=(% style="vertical-align:top" %)Applikations-Baustein
35 |=8fach Schaltaktor 10A|Controller LPCDIL - 4TE|(% style="vertical-align:top" %)(((
36 8out 10A
37 )))
38 |=8fach Schaltaktor 10A|Controller LPCSMD - 4TE|(% style="vertical-align:top" %)8out 10A
39 |=(% style="vertical-align:top" %)8fach Schaltaktor 10A|(% style="vertical-align:top" %)Controller ARM - 4TE|(% style="vertical-align:top" %)8out 10A
40 |=(% style="vertical-align:top" %)8fach Schaltaktor 16A|(% style="vertical-align:top" %)Controller ARM - 4TE|(% style="vertical-align:top" %)8out 16A v2.x
41 |=(% style="vertical-align:top" %) |(% style="vertical-align:top" %) |(% style="vertical-align:top" %)
42
43 == Prozessor-Bezeichnungen ==
44
45 |(bisher) Verwendeter Begriff|(% style="vertical-align:top" %)Standardisierter Begriff|Erläuterung
46 |(((
47 LPC, LPC 922, DIL
48 )))|(% style="vertical-align:top" %)LPCDIL|
49 |SMD LPC, LPC 922|(% style="vertical-align:top" %)LPCSMD|
50 |ARM|(% style="vertical-align:top" %)LPC1115|(((
51 * verfügt über die meisten Funktionen der LPC111x-Reihe
52 * zwingend notwendig für Rauchmeldermodul!
53 )))
54 |ARM|(% style="vertical-align:top" %)LPC1114|(((
55 * für viele SB-Appliaktionen ausreichend
56 * etwas günstiger als der LPC1115
57 )))
58 |ARM|(% style="vertical-align:top" %)ARM|wenn jede Variante der LPC111x-Reihe verwendet werden kann
59
60 == Dokumentation ==
61
62 Auch eine Vereinheitlichung der Struktur und Namen in der Dokumentation ist sinvoll - alleine, weil man sich schneller zurecht findet beim Suchen von Inhalten.
63
64 === Namensgebung für Geräte ===
65
66 Die Bezeichnung für ein Gerät wird konkateniert aus den folgenden Textbausteinen, wobei Werte in [] optional sind.
67
68 **[{differenzierende Merkmale}] {Gerätetyp} - [{besondere Eigenschaft}] - {Einbauort} [- {Version}]**
69
70 Das differenzierende Merkmal ist insbesondere wichtig um gleichartige Geräte mit zum Beispiel mehr oder weniger Kanälen unterscheiden zu können.
71
72 Ob die Version bei Geräten wirklich Sinn macht, ist fraglich. Nur weil eine Applikationsplatine weiterentwickelt wird, sollte man keine neue Geräte Version dokumentieren. Eine neue Variante, die zum Beispiel durch eine andere Anschlussvariante der Phase auf der 16A Applikationsplatine für den 8fach 16A entstand, die aber ansonsten (Aufbau, Bauteile, Controller, Einbauort und -größe), sollte nicht auf Geräte-Ebene differenziert werden.
73
74 Ein Hinweis, welche Optionen beider Wahl der Bausteine bestehen, sollte ausreichen.
75
76 **Beispiele**:
77
78 * 6fach 16A Schaltaktor - strommessend, bistabil - 6TE
79 * 8fach 10A Schaltaktor - 4TE
80 * 8fach 16A Schaltaktor - bistabil - 4TE
81 * 2fach AC 50Hz Dimmer -
82
83 === Namensgebung für Hardwarebausteine ===
84
85 Die Bezeichnung wird konkateniert aus den folgenden Textbausteinen, wobei Werte in [] optional sind.
86
87 **{Bausteintyp} {Bausteinname} {Prozessorvariante} - [{besondere Eigenschaft}] - {Einbauort} [{Einbaulage}] - {Version}**
88
89 Besonderheit: Manche Module (wie z.B. Einbaumodule) bestehen aus nur einem Hardwarebaustein! Daher müssten diese konsequenter Weise sowohl bei den Applikationsbausteinen als auch bei den Geräten gelistet werden.
90
91 **Beispiele**:
92
93 * Controller ARM - 4TE - v1.02
94 * Controller ARM - 4TE TOP - v1.0
95 * Controller LPCSMD - 4TE - v3.54
96 * Applikation 8out 16A ARM - bistabile Relais - 4TE - v2.1
97 * Addon Tasterplatine - 4TE TOP - v1.0
98 * Einbaumodul Binäreingang LPC1115 - UP - v3.7
99 * Systembaustein FT1.2-Modul - HAT - v1.1
100
101 === Liste der Bausteintypen ===
102
103 * Applikation
104 * Controller
105 * Addon
106 * Systembaustein
107 * Einbaumodul
108
109 === Liste der Prozessorvarianten ===
110
111 * LPCDIL (für LPC922 im DIL Package)
112 * LPCSMD (für LPC922 im TSOP Package)
113 * LPC1115
114 * //leer //(für Bausteine, die sowohl von einem LPC922- als auch einem LPC1115-basierten Controller angesprochen werden können)
115
116 === Liste der Einbauorte ===
117
118 * 1TE
119 * 2TE
120 * 4TE (am häufigsten verwendet: REG-Gehäuse mit einer Breite von 4 Teilungseinheiten)
121 * 6TE
122 * 8TE
123 * UP (Gerät hat in einer Hohlwand- / Unterputzdose Platz)
124 * ET206 (BOPLA ET-206-Gehäuse)
125 * PK101 (BOPLA PK 101-Gehäuse)
126 * HAT (Hardware Attached on Top - Modul, das auf einen RPi aufgesteckt werden kann ([[https:~~/~~/www.raspberrypi.org/blog/introducing-raspberry-pi-hats/ )>>https://www.raspberrypi.org/blog/introducing-raspberry-pi-hats/]])
127
128 === Liste der Einbaulagen ===
129
130 * TOP
131 * MID
132 * BOT
133
134 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.
135
136 Wird vom Standard (BOT = Applikation, MID = Controller, TOP = Addon) abgewichen, sollte das auf jeden Fall in der Bezeichnung angegeben werden.
137
138 Natürlich könnten diese Einbaulagen auch Einbaulagen von Platinen in anderen Gehäusen als den REG-Gehäusen differenzieren!
139
140 == ==
141 )))
142 )))