Einarbeitung in die Versionsverwaltung SVN: Unterschied zwischen den Versionen

Aus HSHL Mechatronik
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(13 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Kategorie:Arduino]]
[[Kategorie:Arduino]]
<!--[[Datei:MATLAB-Symbol-700x394.jpg|thumb|rigth|450px|Abb. 1: MATrix LABoratory (MATLAB)]]-->
[[Datei:Apache Subversion logo.svg.png|thumb|rigth|300px|Abb. 1: Einarbeitung in die Versionsverwaltung SVN]]
'''Autor:''' [[Benutzer:Ulrich_Schneider| Prof. Dr.-Ing. Schneider]]<br>
{|
'''Modul:''' Praxismodul I<br>
'''Lektion 1:''' Mechatronik, Informatikpraktikum, 1. Semester
{| class="wikitable"
|-
|-
! style="hidden"| {{vertikal|vertikaler Text}} !! Horizontal
| '''Autor:'''  || [[Benutzer:Ulrich_Schneider| Prof. Dr.-Ing. Schneider]]
|-
|-
| A || längerer Text im Beispiel
| '''Modul:''' || Praxismodul I
|-
|-
| B || längerer Text im Beispiel
| '''Lektion 1:'''  || Mechatronik, Informatikpraktikum, 1. Semester
|-
| C || längerer Text im Beispiel
|}
|}
<br>
==Fragestellungen, Begriffe und Voraussetzungen==
==Fragestellungen, Begriffe und Voraussetzungen==
===Fragestellungen===
===Fragestellungen===
Zeile 48: Zeile 45:
* können Sie mittels Arduino IDE Programme anlegen, globale Variablen anlegen, den Arduino programmieren, einen Text im seriellen Monitor ausgeben und eine LED ansteuern.
* können Sie mittels Arduino IDE Programme anlegen, globale Variablen anlegen, den Arduino programmieren, einen Text im seriellen Monitor ausgeben und eine LED ansteuern.


== Lernzielkontrolle ==
== Versuchsvorbereitung ==
# Legen Sie auf Ihrem Rechner ein (lokales) SVN-Projektarchiv an, z.&thinsp;B. <code>D:\SVN\Gruppenordner</code>.
# Legen Sie auf Ihrem Rechner ein (lokales) SVN-Projektarchiv an, z.&thinsp;B. <code>D:\SVN\Gruppenordner</code>.
# Checken Sie mit <code>SVN/Checkout</code> eine Arbeitskopie des Arbeitsordners aus. URL: <code>https://svn.hshl.de/svn/Informatikpraktikum_1/trunk/Gruppen/Gruppen_WS2223</code>
# Checken Sie mit <code>SVN/Checkout</code> eine Arbeitskopie des Arbeitsordners aus. URL: <code>https://svn.hshl.de/svn/Informatikpraktikum_1/trunk/Gruppen/Gruppen_WS2223</code>
Zeile 120: Zeile 117:
* <code>Test.txt</code> mit Historie (s.o.)
* <code>Test.txt</code> mit Historie (s.o.)
* <code>SVN_Dokumentation.pdf</code>
* <code>SVN_Dokumentation.pdf</code>
----


=== Aufgabe 1.2 ===
=== Aufgabe 1.2 ===
Zeile 140: Zeile 138:
'''Arbeitsergebnis''': <code>ArduinoUnoSpec.pdf</code>
'''Arbeitsergebnis''': <code>ArduinoUnoSpec.pdf</code>


<div class="mw-collapsible mw-collapsed">
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
 
| <strong>Tipp 1&thinsp;</strong>
'''Tipps:'''
|-
* Die Lösungen finden Sie in der [https://store.arduino.cc/products/arduino-uno-rev3 Arduino Dokumentation.]  
| Die Lösungen finden Sie in der [https://store.arduino.cc/products/arduino-uno-rev3 Arduino Dokumentation.]  
* Die Funktion der Steckplatine wird auf [https://de.wikipedia.org/wiki/Steckplatine Wikipedia] gut beschrieben.
|-
</div>
|}
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
| <strong>Tipp 2&thinsp;</strong>
|-
| Die Funktion der Steckplatine wird auf [https://de.wikipedia.org/wiki/Steckplatine Wikipedia] gut beschrieben.
|-
|}
----


=== Aufgabe 1.3 ===
=== Aufgabe 1.3 ===
Zeile 158: Zeile 163:


'''Nützliche Befehle''': <code>Serial.begin(), Serial.print(), Serial.println()</code>
'''Nützliche Befehle''': <code>Serial.begin(), Serial.print(), Serial.println()</code>
----


=== Aufgabe 1.4 ===
=== Aufgabe 1.4 ===
Zeile 170: Zeile 176:
'''Nützliche Befehle''': <code>pinMode(), digitalWrite(), delay()</code>
'''Nützliche Befehle''': <code>pinMode(), digitalWrite(), delay()</code>


<div class="mw-collapsible mw-collapsed">
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
 
| <strong>Musterlösung&thinsp;</strong>
'''Musterlösung:''' [https://funduino.de/nr-1-blinkende-led Anleitung Blinkende LED]
|-
</div>
| [https://funduino.de/nr-1-blinkende-led Anleitung Blinkende LED]
|-
|}
----


=== Aufgabe 1.5 ===
=== Aufgabe 1.5 ===
Zeile 183: Zeile 192:


'''Arbeitsergebnis''' in SVN: <code>SVN Log</code>
'''Arbeitsergebnis''' in SVN: <code>SVN Log</code>
== Tutorial ==
== Tutorial ==
* [[Software Versionsverwaltung mit SVN]]
* [[Software Versionsverwaltung mit SVN]]
Zeile 193: Zeile 203:


----
----
→ Termine [[Einarbeitung_in_die_Versionsverwaltung_SVN|1]] [[Einstieg_in_die_Welt_des_Arduino|2]] [[AlphaBot:_MATLAB_als_serieller_Monitor|3]] [[AlphaBot: Servo ansteuern|4]] [[AlphaBot:_Motoren_und_Inkrementalgeber|5]] [[AlphaBot: Programmier-Challenge I SoSe23|6]] [[AlphaBot:_Gesteuerte_Fahrt|7]] [[AlphaBot: Geregelte Fahrt mit Linienverfolger|8]] [[AlphaBot: Parklücke suchen|9]] [[AlphaBot: Autonomes Einparken|10]] [[AlphaBot: Programmier-Challenge II SoSe23|11]]<br>
→ Termine [[Einführungsveranstaltung Informatikpraktikum 1|0]] [[Einarbeitung_in_die_Versionsverwaltung_SVN|1]] [[Einstieg_in_die_Welt_des_Arduino|2]] [[Arduino: Taster auswerten und LEDs ansteuern|3]] [[Arduino:_Sensoren_einlesen|4]] [[Arduino:_Infrarotsensor_einlesen|5]] [[Arduino:_Infrarotsensor_entstören|6]] [[Arduino:_Programmier-Challenge_I_WS_23/24|7]] [[Arduino:_IR-Theremin|8]] [[Arduino:_Aktoren|9]] [[Arduino:_LCD_Display_mit_I2C_Schnittstelle|10]] [[Arduino:_Ultraschall_Entfernungsmessung|11]] [[Arduino:_Ultraschallsensor_entstören|12]] [[Arduino:_Temperaturmessung_mit_NTC_und_PTC|13]] [[Arduino:_Programmier-Challenge_I_WS_23/24|14]]<br>
→ zurück zum Hauptartikel: [[Arduino_Praxiseinstieg_WS_23/24|Arduino Praxiseinstieg]]
→ zurück zum Hauptartikel: [[Arduino_Praxiseinstieg_WS_23/24|Arduino Praxiseinstieg]]

Aktuelle Version vom 21. Oktober 2023, 12:19 Uhr

Abb. 1: Einarbeitung in die Versionsverwaltung SVN
Autor: Prof. Dr.-Ing. Schneider
Modul: Praxismodul I
Lektion 1: Mechatronik, Informatikpraktikum, 1. Semester


Fragestellungen, Begriffe und Voraussetzungen

Fragestellungen

Eine Versionsverwaltung dient einerseits dazu Daten auf einem Server zu sichern und so dass weltweite kollaborierte Arbeiten zu ermöglichen. Andererseits bietet sie die Möglichkeit ältere Projektstände verschiedener Dateien wieder herzustellen. Wesentliche Fragestellung sind die Funktion der Versionsverwaltung mit Fokus auf den Datentransfer und dem praktischen Umgang. Als Software Versionsverwaltung verwenden wir an der Hochschule Hamm-Lippstadt Subversion (kurz SVN). Hierfür gibt es kostenlose Clients für Win und Mac. Versionsverwaltung und nachhaltiges Arbeiten ist ein wichtiger Bestandteil Ihres Studiums, daher führen wir Sie bereits im 1. Semester heran.

Eingeführte Begriffe und Konzepte

Die Bedienoberfläche uSVN und der Client Turtoise SVN wird vorgestellt. Der Umgang mit den wesentlichen Funktionen wird geübt. Neue Begriffe sind:

  • Checkout
  • Commit
  • Update
  • Tag
  • Branch
  • Trunk
  • Show Log
  • Repro-browser
  • Revert
  • Clean up
  • Get lock
  • Merge
  • Diff

Voraussetzungen

Grundlagen der PC-Bedienung sind erforderlich.

Lernziele

Nach Durchführung dieser Lektion

  • können Sie die Verbindung zum Vorlesungs-SVN herstellen.
  • können Sie auf Daten zugreifen und diese wieder auf dem Server versioniert sichern.
  • können Sie kollaboriert im Team auf dem SVN-Server arbeiten.
  • können Sie Dateikonflikte elegant lösen.
  • fühlen Sie sich sicher im Umgang mit der Versionsverwaltung SVN.
  • können Sie mittels Arduino IDE Programme anlegen, globale Variablen anlegen, den Arduino programmieren, einen Text im seriellen Monitor ausgeben und eine LED ansteuern.

Versuchsvorbereitung

  1. Legen Sie auf Ihrem Rechner ein (lokales) SVN-Projektarchiv an, z. B. D:\SVN\Gruppenordner.
  2. Checken Sie mit SVN/Checkout eine Arbeitskopie des Arbeitsordners aus. URL: https://svn.hshl.de/svn/Informatikpraktikum_1/trunk/Gruppen/Gruppen_WS2223
  3. Schreiben Sie eine Textdatei Test.txt mit beliebigem Inhalt.
  4. Sichern Sie Ihre Daten auf dem SVN Server mit SVN/Commit; Schreiben Sie einen passenden Log-Text.
  5. Checken Sie eine 2. Arbeitskopie aus.
  6. Ändern Sie etwas in beiden Arbeitskopien gleichzeitig, aber in unterschiedlichen Zeilen
  7. Sichern Sie beider Arbeitskopien auf dem SVN Server mit SVN/Commit; Schreiben Sie einen passenden Log-Text.
  8. Analysieren Sie die Differenz mit SVN/Diff.
  9. Ändern Sie etwas in beiden Arbeitskopien gleichzeitig, aber in GLEICHEN Zeilen
  10. Sichern Sie beider Arbeitskopien auf dem SVN Server mit SVN/Commit; Schreiben Sie einen passenden Log-Text.
  11. Lösen Sie den Konflikt mit: SVN/Merge
  12. Legen Sie einen SVN/Tag an.
  13. Stellen Sie einen alten Stand wieder her.
  14. Erläutern Sie im Dokument SVN_Dokumentation.pdf die SVN-Begriffe
    1. Checkout, Update, Commit,
    2. Merge, Diff, Log,
    3. Trunk, Tag, Branch, Switch,
    4. Show log, Repo Browser und Revision Graph

Arbeitsergebnisse in SVN:

  • Test.txt mit Historie (s.o.)
  • SVN_Dokumentation.pdf

Inhalt

Als Software Versionsverwaltung verwenden wir an der Hochschule Hamm-Lippstadt Subversion (kurz SVN). Hierfür gibt es kostenlose Clients für Win und Mac. Versionsverwaltung und nachhaltiges Arbeiten ist ein wichtiger Bestandteil Ihres Studiums, daher führen wir Sie bereits im 1. Semester heran.

Versuchsvorbereitung

Studieren Sie unseren Artikel zu SVN im HSHL Wiki.

SVN Quickstart

  • Loggen Sie sich via USVN ein und ändern Sie Ihr Passwort
  • Vorname_Nachname::Kennwort1 (z. B. Max_Mustermann Kennwort1)
  • Prüfen Sie, ob Sie Zugang zum passenden Repositorium haben.
  • Installieren Sie Tortoise SVN für Windows (Mac) in englischer Sprache.
  • Legen Sie sich auf der Datenpartition unter D:\SVN ein Repositorium "Informatikpraktikum1" an.
  • Machen Sie sich mit der Funktion von SVN bekannt.
  • Sichern Sie alle Ihren Quelltext in Ihrem Gruppenordner.
  • Antworten auf alle Fragen finden Sie hier.

Studieren Sie diese Inhalte:

Login

Das Login wurde Ihnen als E-Mail zugesandt.

Links

Video-Tutorials

Mit den folgenden Video Tutorial lernen Sie spielend leicht und kostenlos den Einstieg in die Versionskontrolle:

  • Christopher Janietz - Versionskontrolle mit Git und SVN bei LinkedIn
  • Julian Robichaux - SVN for Java Developers bei LinkedIn

Den kostenlosen Zugang zum LinkedIN Portal erhalten Sie über den Bibliothekskatalog im Bereich "Lizenzierte Datenbanken".

Versuchsdurchführung

Aufgabe 1.1

Präsentieren Sie Prof. Schneider das Ergebnis der Lernzielkontrolle. Arbeitsergebnisse in SVN:

  • Test.txt mit Historie (s.o.)
  • SVN_Dokumentation.pdf

Aufgabe 1.2

Befassen Sie sich mit der Arduino-Uno Hardware und beantworten Sie die Fragen:

  1. Welches sind die technischen Daten eines Arduino UNO R3?
    1. Mikrocontroller
    2. Spannungsversorgung
    3. Betriebsspannung
    4. Digitale I/O
    5. Analoge I/O
    6. Strom pro digitalem Pin
    7. Flash Memory
    8. SRAM
    9. EEPROM
    10. Taktfrequenz
    11. Programmierschnittstelle
    12. ISCP-Schnittstelle
  2. Recherchieren und erläutern Sie diese Fachbegriffe.
  3. Untersuchen Sie die Steckplatine (Engl. breadboard). Wie ist es aufgebaut?

Arbeitsergebnis: ArduinoUnoSpec.pdf


Aufgabe 1.3

Programmieren Sie Ihr erstes Programm im Bereich setup mit der Arduino IDE.

  1. Nehmen Sie Verbindung zum Arduino auf. Der Geräte-Manager zeigt Ihnen an welchem COM-Port der Arduino angeschlossen ist.
  2. Legen Sie in Ihrem Arbeitsordner ein neues Sketch an.
  3. Schreiben Sie einen Header.
  4. Ihr Programm soll einmalig "Hallo Welt" im seriellen Monitor ausgeben.
  5. Kompilieren Sie Ihr Programm und übertragen Sie es auf den Arduino.
  6. Werten Sie Ihr Programm mit Kommentaren auf.

Arbeitsergebnis in SVN: HalloWelt.ino

Nützliche Befehle: Serial.begin(), Serial.print(), Serial.println()


Aufgabe 1.4

Erweitern Sie Ihr erstes Programm im Bereich loop. Auf dem Arduino ist an Pin 13 eine Test-LED verbaut. Lassen Sie die LED im Sekundentakt blinken.

  1. Legen Sie als globale Variable die Konstante LED_PIN mit dem Wert 13 vom Typen integer an.
  2. Initialisieren Sie im Bereich setup den digitalen Port LED_PIN als Ausgang.
  3. Schalten Sie die LED zyklisch für 1 s an und aus.
  4. Werten Sie Ihr Programm mit Header und Kommentaren auf.

Arbeitsergebnis in SVN: blinkendeLED.ino

Nützliche Befehle: pinMode(), digitalWrite(), delay()


Aufgabe 1.5

Sichern Sie alle Ergebnisse mit beschreibendem Text (message) in SVN.

  • Wurden die Regeln für den Umgang mit SVN eingehalten?
  • Wurde nachhaltig dokumentiert?
  • Haben die Programme einen Header?
  • Wurden der Quelltext umfangreich kommentiert?

Arbeitsergebnis in SVN: SVN Log

Tutorial

FAQ

  • Muss ich die Lösungen selbst programmieren? Ja, nur Eigenleistung wird bewertet.
  • Darf ich die Musterlösung 1:1 kopieren und als meine Leistung ausgeben? Nein, das ist ein Plagiat und wird als Täuschungsversuch gewertet.



→ Termine 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14
→ zurück zum Hauptartikel: Arduino Praxiseinstieg