Einarbeitung in die Versionsverwaltung SVN: Unterschied zwischen den Versionen

Aus HSHL Mechatronik
Zur Navigation springen Zur Suche springen
Zeile 37: Zeile 37:
*<code>Diff</code>
*<code>Diff</code>


Neue Arduino-Begriffe sind: <code>Sketch</code>, <code>Serial.begin(), Serial.print(), Serial.println()</code>
Neue Arduino-Begriffe sind: <code>Sketch</code>, <code>Serial.begin()</code>, <code>Serial.print()</code>, <code>Serial.println()</code>, <code>pinMode()</code>, <code>digitalWrite()</code>, <code>delay()</code>


=== Voraussetzungen ===
=== Voraussetzungen ===

Version vom 12. September 2024, 15:07 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

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.

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.

In dieser Veranstaltung entstehen ersten Programme für den Arduino.

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

Neue Arduino-Begriffe sind: Sketch, Serial.begin(), Serial.print(), Serial.println(), pinMode(), digitalWrite(), delay()

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.

Vorbereitung

Bereiten Sie sich anhand der nachfolgenden Aufgaben auf den Praktikumstermin vor.

  1. Studieren Sie folgenden Wiki-Artikel: Software Versionsverwaltung mit SVN.
  2. Legen Sie auf Ihrem Rechner ein (lokales) SVN-Projektarchiv an, z. B. D:\SVN\Gruppenordner.
  3. Checken Sie mit SVN/Checkout eine Arbeitskopie des Arbeitsordners aus. URL: https://svn.hshl.de/svn/Informatikpraktikum_1/trunk/Gruppen/Gruppen_WS2223
  4. Schreiben Sie eine Textdatei Test.txt mit beliebigem Inhalt.
  5. Sichern Sie Ihre Daten auf dem SVN Server mit SVN/Commit; Schreiben Sie einen passenden Log-Text.
  6. Checken Sie eine 2. Arbeitskopie aus.
  7. Ändern Sie etwas in beiden Arbeitskopien gleichzeitig, aber in unterschiedlichen Zeilen
  8. Sichern Sie beider Arbeitskopien auf dem SVN Server mit SVN/Commit; Schreiben Sie einen passenden Log-Text.
  9. Analysieren Sie die Differenz mit SVN/Diff.
  10. Ändern Sie etwas in beiden Arbeitskopien gleichzeitig, aber in GLEICHEN Zeilen
  11. Sichern Sie beider Arbeitskopien auf dem SVN Server mit SVN/Commit; Schreiben Sie einen passenden Log-Text.
  12. Lösen Sie den Konflikt mit: SVN/Merge
  13. Legen Sie einen SVN/Tag an.
  14. Stellen Sie einen alten Stand wieder her.
  15. 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

Lernzielkontrolle

  • Loggen Sie sich via USVN ein und ändern Sie Ihr Passwort
  • Vorname.Nachname@stud.hshl.de::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.


Links

Tabelle 1: Nützliche Links für den Semesterstart
HSHL Wiki https://wiki.hshl.de/
uSVN Benutzeroberfläche https://svn.hshl.de/
SVN Checkout URL https://svn.hshl.de/svn/Informatikpraktikum_1/trunk
SVN-Anleitung Software Versionsverwaltung mit SVN

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 und Dokumentationen

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

Abgerufen von „https://wiki.hshl.de/wiki/index.php?title=Einarbeitung_in_die_Versionsverwaltung_SVN&oldid=124520“