Einarbeitung in die Versionsverwaltung SVN

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

Tipp 1  Die Lösungen finden Sie in der Arduino Dokumentation.

Tipp 2  Die Funktion der Steckplatine wird auf Wikipedia gut beschrieben.

---

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()

Musterlösung 

// Hier können globale Variablen angelegt werden.
const unsigned long BAUDRATE_u32 = 9600; // Geschwindigkeit des Seriellen Monitors in Baude festlegen

void setup() {
  // Dieser Programmteil wird einmalig vor dem void loop() ausgeführt
  Serial.begin(BAUDRATE_u32);    // Kommunikationsgeschwindigkeit des Seriellen Monitors festlegen
  Serial.println("Hallo Welt");  // Gewünschten String einmalig mit Zeilenumbruch ausgeben
}

void loop() {
  // Diese Zyklusschleife wird wiederholt nach dem void setup() ausgeführt
}

---

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_u8 mit dem Wert 13 vom Typen byte 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()

Musterlösung  Anleitung Blinkende LED

// Hier können globale Variablen angelegt werden.
const byte LED_PIN_u8   = 13;            // Die verbaute LED ist an PIN D13 angeschlossen.
const unsigned long SEKUNDE_u32  = 1000; // 1s = 1000ms
const unsigned long BAUDRATE_u32 = 9600; // Geschwindigkeit des Seriellen Monitors in Baude festlegen

void setup() {
  // Dieser Programmteil wird einmalig vor dem void loop() ausgeführt
  pinMode(LED_PIN_u8, OUTPUT);   // PIN D13 ist ein Ausgabepin
  Serial.begin(BAUDRATE_u32);    // Kommunikationsgeschwindigkeit des Seriellen Monitors festlegen
  Serial.println("Hallo Welt");  // Gewünschten String einmalig mit Zeilenumbruch ausgeben
}

void loop() {
  // Diese Zyklusschleife wird wiederholt nach dem void setup() ausgeführt
  digitalWrite(LED_PIN_u8,HIGH); // LED anschalten
  delay(SEKUNDE_u32);            // 1s warten
  digitalWrite(LED_PIN_u8,LOW);  // LED ausschalten
  delay(SEKUNDE_u32);            // 1s warten
}

---

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

• Software Versionsverwaltung mit SVN
• Arduino Befehlsübersicht
• Komplexitätsbeherrschung durch Versionskontrolle Komplexitätsbeherrschung durch Versionskontrolle
• Source Control mit SVN vs. GIT Source Control mit SVN vs. GIT
• Handbuch Tortoise SVN (Deutsch)
• Handbuch Tortoise Merge (Deutsch)
• Programmierrichtlinie für C

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