Softwarekonzept - Versionsgeschichte

Robertadmin: /* Schichtenmodell */

2023-06-01T07:41:35Z

‎Schichtenmodell

Robertadmin: /* Hinweis zu Präprozessordefinitionen in Eclipse */

2017-10-26T16:48:54Z

‎Hinweis zu Präprozessordefinitionen in Eclipse

Robertadmin: /* environment.h */

2017-10-26T16:46:41Z

‎environment.h

Robertadmin: /* arduinoDefs.h */

2017-10-20T16:39:45Z

‎arduinoDefs.h

Robertadmin: /* environment.h */

2017-10-20T16:38:13Z

‎environment.h

Robertadmin: /* environment.h */

2017-10-20T16:36:52Z

‎environment.h

Robertadmin: /* environment.h */

2017-10-20T16:32:27Z

‎environment.h

Robertadmin: /* Lizenzmodell */

2017-10-20T15:42:27Z

‎Lizenzmodell

Robertadmin am 20. Oktober 2017 um 15:11 Uhr

2017-10-20T15:11:46Z

Robertadmin am 19. Oktober 2017 um 15:57 Uhr

2017-10-19T15:57:43Z

@@ Zeile 51: / Zeile 51: @@
 Die funktionalen Abläufe erfolgen über eine Zustandsmaschine. Der aktuelle Zustand eines Gerätes ist Bestandteil der zyklischen Twitter-Botschaft.
+|
-  in Entwicklung
+  StateMachine.h
 |-
 | (7)<br/>Profile

@@ Zeile 89: / Zeile 89: @@
 === Hinweis zu Präprozessordefinitionen in Eclipse ===
-Das Kontextmenü des Projektes (rechte Maustaste auf Projekt) enthält den Eintrag ''Eigenschaften'' (''Properties''). Im Menübaum findet man unter ''C/C++ Build -> Settings'' den Karteireiter (Tab) ''Tool Settings'' und darunter ''GCC C++ Compiler -> Preprocessor''. Der Mausklick darauf liefert ein Editierfeld für Präprozessordefinition, die für das ausgewählte Projekt gelten.
+Das Kontextmenü des Projektes (rechte Maustaste auf Projekt) enthält den Eintrag ''Eigenschaften'' (''Properties''). Im Menübaum findet man unter ''C/C++ Build -> Settings'' den Karteireiter (Tab) ''Tool Settings'' und darunter ''GCC C++ Compiler -> Preprocessor''. Der Mausklick darauf liefert ein Editierfeld für Präprozessordefinition, die für das ausgewählte Projekt gelten. Dort ergänzt man z.B. einfach mit smnDEFBYBUILD.
 Wenn man allerdings ein Projekt mit dem Arduino-Plugin (Sloeber) bearbeitet, dann wird der GCC nicht in der klassischen Form verwendet, sondern die jeweiliegen Compilervarianten für das eingesetzte Arduino-Board. Demzufolge gibt es auch nicht den oben beschriebenen Menüpunkt für die Präprozessordefinitionen. Stattdessen findet man im Menübaum der ''Eigenschaften'' (''Properties'') den Eintrag ''Arduino'', der u.a. den Karteireiter ''Compile Options'' bietet. Darin befindet sich das Textfeld ''append to C and C++'', in das man seine Präprozessordefinitionen, mit dem Schalter -D eingeleitet, einträgt. Also für die Auswertung von #ifdef smnDEFBYBUILD in einer Datei wird hier -DsmnDEFBYBUILD eingetragen.

@@ Zeile 87: / Zeile 87: @@
 Wird die Software für weitere Entwicklungsumgebungen und Zielsysteme angepasst, so muss auch die Datei environment.h entsprechend ergänzt werden.
 == arduinoDefs.h ==
 Diese Datei ersetzt die Header-Datei Arduino.h für Zielsysteme, die nicht mit der Arduino-Umgebung betrieben werden und daher auch die Datei Arduino.h nicht inkludieren. Hier werden Datentypen definiert, die sonst in Arduino.h zu finden wären. Damit können Sketche (XYZ.ino), die auf typischen Arduino-Boards ablaufen, auch auf anderen Zielsystemen (bzw. auch unter Linux und Windows) übersetzt und bedingt ausgeführt werden.

← Nächstältere Version		Version vom 20. Oktober 2017, 16:39 Uhr
Zeile 89:		Zeile 89:

	== arduinoDefs.h ==		== arduinoDefs.h ==
−	Diese Datei ersetzt die Header-Datei Arduino.h für Zielsysteme, die nicht mit der Arduino-Umgebung betrieben werden und daher auch die Datei Arduino.h nicht inkludieren. Hier werden Datentypen definiert, die sonst in Arduino.h zu finden wären. Damit können Sketche (XYZ.ino), die auf typischen Arduino-Boards ablaufen, auch unter Linux und Windows übersetzt und bedingt ausgeführt werden.	+	Diese Datei ersetzt die Header-Datei Arduino.h für Zielsysteme, die nicht mit der Arduino-Umgebung betrieben werden und daher auch die Datei Arduino.h nicht inkludieren. Hier werden Datentypen definiert, die sonst in Arduino.h zu finden wären. Damit können Sketche (XYZ.ino), die auf typischen Arduino-Boards ablaufen, auch auf anderen Zielsystemen (bzw. auch unter Linux und Windows) übersetzt und bedingt ausgeführt werden.

@@ Zeile 84: / Zeile 84: @@
   ......
   #endif
-Die Definition smnDEFBYBUILD wird bei Bedarf in den Präprozessordefinitionen für den Compiler angegeben. In environment.h sind unter #ifdef smnDEFBYBUILD die weiteren Definitionen smnUBUNTU_ECLIPSE und smnWIN32_VS ausgewertet, die ebenfalls in der IDE gesetzt werden. Hier bei Eclipse auf Ubuntu und bei Visual Studio auf Windows. Die in der Datei unter diesen Abfragen gemachten Definitionen werden im Sourcecode der Programme ausgewertet und ermöglichen den Einsatz der Software unter Linux und Windows. Sehr interessant ist in dem Fall die Überwachung des Echtzeitverhaltens mit LoopCheck.
+Die Definition smnDEFBYBUILD wird bei Bedarf in den Präprozessordefinitionen für den Compiler angegeben. In environment.h sind unter #ifdef smnDEFBYBUILD die weiteren Definitionen smnUBUNTU_ECLIPSE und smnWIN32_VS ausgewertet, die ebenfalls in der IDE gesetzt werden. Hier bei Eclipse auf Ubuntu und bei Visual Studio auf Windows. Die in der Datei environment.h unter diesen Abfragen gemachten Definitionen werden im Sourcecode der Programme ausgewertet und ermöglichen den Einsatz der Software unter Linux und Windows. Sehr interessant ist in dem Fall die Überwachung des Echtzeitverhaltens mit LoopCheck.
 Wird die Software für weitere Entwicklungsumgebungen und Zielsysteme angepasst, so muss auch die Datei environment.h entsprechend ergänzt werden.

@@ Zeile 71: / Zeile 71: @@
 == environment.h ==
-Diese Datei enthält die Schalter, mit der die Entwicklungsumgebung und das Zielsystem kenntlich gemacht werden.
+Diese Datei enthält die Schalter, mit der die Entwicklungsumgebung und das Zielsystem kenntlich gemacht werden. Sie wird über eine von außen vorzunehmende Definition alternativ ausgewertet:
 == arduinoDefs.h ==
 Diese Datei ersetzt die Header-Datei Arduino.h für Zielsysteme, die nicht mit der Arduino-Umgebung betrieben werden und daher auch die Datei Arduino.h nicht inkludieren. Hier werden Datentypen definiert, die sonst in Arduino.h zu finden wären. Damit können Sketche (XYZ.ino), die auf typischen Arduino-Boards ablaufen, auch unter Linux und Windows übersetzt und bedingt ausgeführt werden.

← Nächstältere Version		Version vom 20. Oktober 2017, 15:42 Uhr
Zeile 65:		Zeile 65:

	= Lizenzmodell =		= Lizenzmodell =
−	Für den Anwender ist es schwer, die vielfältigen Lizenzmodelle zu durchschauen. Da die hier beschriebene Software für die Ausbildung angehender Elektronik-Ingenieure (Schwerpunkt: Einsatz von Mikrocontrollern und Internet der Dinge (IoT) bzw. Cyber-physische Systeme (CPS)) eingesetzt wird und eine Basis für eigene Entwicklungen darstellt, liegt das Modell von [[Wikipedia:de:Open_Source\|'''Open Source''']] nahe. Allerdings sollen die mit Einfluss dieser Software erstellten studentischen Projekte sowie Bachelor- und Masterarbeiten ebenfalls allen Interessierten zur Verfügung stehen. Darum wird hier auf die [[Wikipedia:de:Creative_Commons\|'''Creative Commons''']] verwiesen, und zwar, wie bei Wikipedia, auf die Variante CC-BY-SA. Das heißt, mit der Verwendung dieser Software verpflichtet man sich, die Namen der ursprünglichen (bisherigen) Autoren zu nennen und sie nur unter diesen Bedingungen auch weiterzugeben.	+	Für den Anwender ist es schwer, die vielfältigen Lizenzmodelle zu durchschauen. Da die hier beschriebene Software für die Ausbildung angehender Elektronik-Ingenieure (Schwerpunkt: Einsatz von Mikrocontrollern und Internet der Dinge (IoT) bzw. Cyber-physische Systeme (CPS)) eingesetzt wird und eine Basis für eigene Entwicklungen darstellt, liegt das Modell von [[Wikipedia:de:Open_Source\|'''Open Source''']] nahe. Allerdings sollen die mit Einfluss dieser Software erstellten studentischen Projekte sowie Bachelor- und Masterarbeiten ebenfalls allen Interessierten zur Verfügung stehen. Darum wird hier auf die [[Wikipedia:de:Creative_Commons\|'''Creative Commons''']] verwiesen, und zwar, wie bei Wikipedia, auf die Variante CC-BY-SA. Das heißt, mit der Verwendung dieser Software verpflichtet man sich, die Namen der ursprünglichen (bisherigen) Autoren zu nennen und sie nur unter diesen Bedingungen auch weiterzugeben. Auf diese Weise ist die Anwendung der Software nicht eingeschränkt und die Arbeit der Entwickler erfährt eine Anerkennung.
		+
		+	= IDE und Zielsystem =
		+	Nach Meinung des Autors ist der bei den Programmiersprachen C bzw. C++ übliche [[Wikipedia:de:C-Präprozessor\|'''Präprozessor''']] eine der großen Stärken dieser Hochsprache. Er ist die Basis für die automatisierte Anpassung des Quellcodes an unterschiedliche Entwicklungsumgebungen und Zielsysteme. Wir machen bei der Gestaltung der Software für die dezentrale Heimautomatisierung davon regen Gebrauch, indem wir bedingt Kompilieren und die entsprechenden Schalter in Header-Dateien definieren. Diese sind im Bibliotheksordner [https://github.com/RobertPatzke/homeautomation/tree/master/libraries/environment '''environment'''] abgelegt.
		+
		+	== environment.h ==
		+	Diese Datei enthält die Schalter, mit der die Entwicklungsumgebung und das Zielsystem kenntlich gemacht werden.
		+
		+	== arduinoDefs.h ==
		+	Diese Datei ersetzt die Header-Datei Arduino.h für Zielsysteme, die nicht mit der Arduino-Umgebung betrieben werden und daher auch die Datei Arduino.h nicht inkludieren. Hier werden Datentypen definiert, die sonst in Arduino.h zu finden wären. Damit können Sketche (XYZ.ino), die auf typischen Arduino-Boards ablaufen, auch unter Linux und Windows übersetzt und bedingt ausgeführt werden.

@@ Zeile 1: / Zeile 1: @@
 Die Software für die Geräte der dezentralen Heimautomatisierung wird grundsätzlich in C/C++ geschrieben. Damit ist sie vom Ansatz her auf allen Geräten, für die entsprechende Compiler zur Verfügung gestellt werden, lauffähig. Wir haben als Grundlage für die Softwareentwicklung die [[Wikipedia:de:Arduino_(Plattform)|'''Arduino Plattform''']] gewählt. Das Konzept, sowohl die Software als auch die Hardware offen zu legen, ist natürlich eine ideale Basis für die Ausbildung angehender Ingenieure. Allerdings setzen wir für die Softwareentwicklung die Umgebung Eclipse ein, genauer ein Paket, das mit einem geeigneten Plug-in für die Arduino-Umgebung under dem Namen Sloeber als Freeware verfügbar ist. Weiteres dazu auf der Seite '''[[Firmware]]'''.
 Bei unserem Projekt gehen wir noch einen Schritt weiter als bei Arduino, indem wir die Vernetzung beliebiger Geräte (neben den Mikrocontrollern auch Smartphones, Tablets und PCs) über das sogenannte [[Social_Manufacturing_Network|'''Social Manufacturing Network''']] vereinheitlichen. Die entsprechende Kommunikationssoftware ist daher auch eine der unteren Schichten in einem entsprechend organisierten Schichtenmodell für die Software. Für das Betriebssystem Android stehen entsprechende Klassen in Java zur Verfügung.
-{| class="wikitable" style="float: left"
+{| class="wikitable" style="line-height:1.1em"
 ! style="text-align:center width:15%" |  Schicht
 ! style="width:70%" | Beschreibung
 ! style="width:15%" | Dateien
 |-
-| IDE<br/>Zielsystem
+| (1)<br/>IDE und <br/>Zielsystem
+|
 In dieser Schicht werden die Eigenschaften des Entwicklungssystems und des Zielsystems beschrieben. Das sind in erster Linie Schalter, die für eine bedingte Kompilation des Quellcode herangezogen werden und Parameter für die Umgebung, wie z.B. das Netzwerk.
@@ Zeile 16: / Zeile 17: @@
   socMananetUser.h
 |-
-| Steuerung<br/>des<br/>Zeitverhalten
+| (2)<br/>Steuerung<br/>des<br/>Zeitverhalten
+|
 Für möglichst genau Zeitabläufe in der loop-Funktion, unabhängig von der eingesetzten Hardware, wurde eine Zeitsteuerung eingerichtet, die eine Software-Uhr und einen Betriebsstundenzähler mit einer Auflösung von einer Millisekunde enthält. Daneben steht eine einstellbare Anzahl von Software-Zeitgebern zur Verfügung und das Echtzeitverhalten wird überwacht.
@@ Zeile 23: / Zeile 24: @@
   LoopCheck.cpp
 |-
-| Kommunikation
+| (3)<br/>Kommunikation
+|
 Die Kommunikation erfolgt auf Basis von zyklischen Rundrufen, deren Inhalte vom Anwender asynchron eingestellt werden. Zur Zeit wird dafür das UDP-Protokoll bei den klassischen Internet-Schnittstellen Ethernet/LAN und WiFi/WLAN verwendet. Bei den typischen Arduino-Boards über das Ethernet- oder WiFi-Shield und bei den preiswerten WiFi-Modulen ESP8266 und ESP32 über die von Espressif für die Arduino-Umgebung zur Verfügung gestellten Bibliotheken.
@@ Zeile 34: / Zeile 35: @@
   Follower.cpp
 |-
-| Wartung
+| (4)<br/>Wartung
+|
 Für die Wartung wird eine Schnittstelle für den Zugang durch den Gerätehersteller eingerichtet. Die kann ggf. auch proprietär ausgeführt sein. Allerdings geschieht der Zugriff auf das Gerät nach dem Pull-Prinzip (das Gerät initiiert die Kommunikation) und der Anwender wird eine angemessene Zeit vor dem Zugriff darüber informiert.
@@ Zeile 40: / Zeile 41: @@
   in Entwicklung
 |-
-| Programmierung
+| (5)<br/>Programmierung
+|
 Mit Programmierung ist an dieser Stelle die Gestaltung von Auswertungen und Abläufen im Gerät durch den Anwender gemeint. Die Programmierschnittstelle für den Anwender ist einheitlich für alle Geräte und ermöglicht in erster Linie die Kombination einzelner vordefinierter Module.
@@ Zeile 46: / Zeile 47: @@
   in Entwicklung
 |-
-| Zustandsmaschine
+| (6)<br/>Zustandsmaschine
+|
 Die funktionalen Abläufe erfolgen über eine Zustandsmaschine. Der aktuelle Zustand eines Gerätes ist Bestandteil der zyklischen Twitter-Botschaft.
@@ Zeile 52: / Zeile 53: @@
   in Entwicklung
 |-
-| Profile
+| (7)<br/>Profile
+|
 In studentischen Projekten (auch Bachelor- und Masterarbeiten) werden Geräte für die Heimautomatisierung entwickelt und getestet. Hier ist eine enge Kooperation mit industriellen Geräteherstellern vorgesehen, soweit die hier vorgestellte dezentrale Heimautomatisierung in ihr Konzept passt.
@@ Zeile 61: / Zeile 62: @@
 Intelligente Lichtsteuerung<br/></small>
 |}

@@ Zeile 33: / Zeile 33: @@
   Follower.h
   Follower.cpp
 |}