## page was renamed from DVA_Praktikum #language de #format rst DVA Praktikum für TI (Gruppe Högl) ================================== Wintersemester 23/24 | Hubert Högl, , https://hhoegl.informatik.hs-augsburg.de | URL: https://hhoegl.informatik.hs-augsburg.de/hhwiki/DVATI_Praktikum | Moodle: https://moodle.hs-augsburg.de/course/view.php?id=7437 (Anmeldung, Ankündigungen, Forum) | Versuche: https://www.hs-augsburg.de/homes/hhoegl/dvati_versuche | Sphinx Demo-Bericht: https://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht | Gitlab Repos der Teams: https://gitlab.informatik.hs-augsburg.de/dvati/berichte-ws23 (VPN!) .. | Versuchsbelegungsplan: https://cloud.hs-augsburg.de/apps/onlyoffice/84444846 .. contents:: Inhalt .. sectnum:: Willkommen zum *DVA Praktikum für Technische Informatiker*. Die Veranstaltung soll dazu dienen, dass Sie ... * sich mit wichtigen Themen aus der Technischen Informatik vertraut machen. * verständlich über die Themen reden können, daher wird es eine wöchentliche Kommunikation mit dem Betreuer geben. * das, was Sie gelernt haben, auch in einem Bericht niederschreiben. Aus einer Themenliste werden Sie ein Semester lang alle ein bis zwei Wochen einen neuen Versuch bearbeiten. Insgesamt sind es fünf Versuche je Team. Die technische Schwierigkeit steht dabei wegen der kurzen Bearbeitungszeit nicht im Vordergrund. Die Versuche werden eher leichte bis mittlere Anforderungen stellen. Die Veranstaltung zählt mit 3 *Creditpoints*, das heisst der Arbeitswaufwand liegt in etwa bei 90 Stunden je Teammitglied. .. - Gruppe 1: Montag, 9:50-11:20 Uhr / G2.17 (Schöppler, ). **Achtung:** Dieser Termin ist parallel zum Elektrotechnik-Praktikum. - Gruppe 2: Montag, 11:40-13:10 Uhr / G2.17 (Schöppler) - Gruppe 3: Mittwoch, 8-9:30 Uhr / G2.16 (Högl, Schäferling , max. 16 TeilnehmerInnen) * Moodle: - https://moodle.hs-augsburg.de/course/view.php?id=2843 (Gruppe 3) - https://moodle.hs-augsburg.de/enrol/index.php?id=2916 (Gruppe 1 und 2) * Gitlab für Gruppe 3: https://gitlab.informatik.hs-augsburg.de/dvati/berichte-ws22 Die Anzahl der Teams innerhalb der Gruppe ändert sich noch. Je Team wird ein Student oder eine Studentin als Maintainer eingetragen. Alle weiteren Teammitglieder trägt der Maintainer ein. Ablauf ------ Die Studierenden werden in mehrere Teams eingeteilt, jedes Team umfasst zwei bis drei Personen. .. Die Seite DVATI_Versuche wird nicht mehr gebraucht Jedes Team sucht sich einen Versuch aus einer Liste von Versuchen (`DVATI-Versuche `_) aus und bearbeitet ihn in der vorgegebenen Zeit (siehe Abschnitt Termine_). Jedes Team schreibt im Semester *einen* Bericht, der für jeden Versuch ein Kapitel enthält. Der Bericht wird mit `Sphinx `_ geschrieben und in einem `Gitlab `_ Repository fortlaufend aktualisiert. Der Bericht existiert *nur in elektronischer Form*. Auch die pro Versuch angefertigten Quelltexte werden in gitlab abgespeichert. In der **Bearbeitungszeit** des Versuchs arbeiten alle Team-Mitglieder zusammen. Typische Tätigkeiten sind Recherche, Planung, Hardware aufbauen, Programmierung, Fehlersuche, Test und Dokumentation. Sie können entweder ausserhalb der Hochschule oder im Labor G2.16 der Hochschule arbeiten. Der Raum ist täglich geöffnet von ca. 8:00 bis 17 Uhr. Die Zusammenarbeit aus der Ferne wird durch das Gitlab Versionskontrollsystem vereinfacht. .. figure:: https://hhoegl.informatik.hs-augsburg.de/dva/workflow/workflow1.png :width: 500 :align: center *Diese Menschen und Dienste sind beim DVA Praktikum beteiligt.* Die **Abgabe** erfolgt nach der ein- oder zweiwöchigen Bearbeitungszeit. .. Es ist unter Umständen nicht zwingend erforderlich, dass Sie bei der Abgabe persönlich anwesend sind, **die Anwesenheit kann jedoch von Ihren Betreuern jederzeit gefordert werden.** Eine Abgabe ohne Anwesenheit würde wie folgt ablaufen: Nach der Bearbeitungszeit befindet sich im Repository des Teams das entsprechende Versuchskapitel und alle sonstigen benötigten Dateien, Quelltexte, etc. Falls der Versuch vom Betreuer ohne Probleme aus dem Bericht nachvollzogen werden kann, und auch sonst alle Vorgaben erfüllt werden, dann kann der Versuch auch ohne Anwesenheit abgenommen werden. Dazu ist natürlich ein sehr gut geschriebener Bericht erforderlich. Verbesserungsvorschläge werden über Gitlab Issues an die Teams übermittelt. Auf diese Weise wäre es auch möglich, dass Studierende, die sich zu der Zeit nicht an der Hochschule aufhalten (z.B. Auslandssemester), am Praktikum teilnehmen können. Die Abgabe mit Anwesenheit findet im zuständigen Labor statt, z.B. G2.16. Bei der Abgabe hält das Projektteam einen kurzen Vortrag und zeigt eine Versuchsvorführung. Der Bericht kann dabei über einen Beamer an die Wand projeziert werden. In der Regel werden zur Vorführung und zum Bericht Verbesserungsvorschläge gemacht, die innerhalb der darauffolgenden Woche umgesetzt werden müssen. Bei einer zweiwöchigen Bearbeitungszeit kann der Zwischentermin für eine "Lagebesprechung" vor Ort im Labor oder virtuell über Videokonferenz genutzt werden. Jedes Team kann von den Betreuern dazu in die Labore eingeladen werden. Die Versuche werden je Team als **bestanden** oder **nicht bestanden** gewertet. Die Betreuer führen je Versuch und Team einen "Zustandsautomaten", der wie folgt funktioniert: .. figure:: https://hhoegl.informatik.hs-augsburg.de/dva/workflow/dvafsm.png :width: 350 :align: center *Der Zustandsautomat der Bewertung.* Jedes Team muss bei allen Versuchen den Zustand "bestanden" erreichen. Gitlab ------ Nach der Vorbesprechung lege ich die benötigte Anzahl Repositories auf Gitlab an und gebe über Moodle an alle Bescheid. Der *owner* der Repositories bin ich. Als *maintainer* wird ein Studierender pro Team ausgewählt, der dann selbständig die weiteren Teammitglieder einteilen kann. Die Repositories liegen alle unter dem Pfad https://gitlab.informatik.hs-augsburg.de/dvati In jedem Gitlab Repository liegt an oberster Stelle eine Datei ``README.md``. Der Inhalt wird im `Markdown `_ Format geschrieben. Gitlab zeigt den Inhalt dieser Datei schön formatiert an. Die Datei dient als erste Beschreibung, wenn jemand das Repository auswählt. Deshalb sollte in etwa der folgende Inhalt enthalten sein: .. code-block:: text # DVA Praktikum für Technische Informatiker Hochschule Augsburg \ Fakultät für Informatik \ Wintersemester 2020/2021 \ Prof. Dr. Hubert Högl **Gruppe: 1** 1. Hans Maier, #123456, INF6, 2. Anna Huber, #126987, INF6, 3. Franz Xaver, #349816, INF8, 4. Isolde Weber, #432190, INF8, Das Gitlab Repository dieses Berichts ist unter https://gitlab.informatik.hs-augsburg.de/dvati/berichte-ws20/1 Der Bericht im HTML Format liegt hier: https://www.hs-augsburg.de/~xxx/xxx. Statt der \\-Zeichen kann man zum Zeilenumbruch auch zwei oder mehr Leerzeichen am Zeilenende verwenden. Der Bericht ----------- Einen Demo-Bericht finden Sie im HTML Format unter https://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht. Im Bericht steht, wo der Quelltext des Berichtes auf gitlab liegt. Von dort können Sie ihn "klonen" und für Ihr Team anpassen. Gitlab und RZ-WWW ................. Der "Quelltext" des Berichtes liegt im Gitlab Repository. Nehmen Sie aber nur die Quelldateien in das Repository auf, *nicht* das Verzeichnis für die HTML Ausgabe ``_build/html/``! Die HTML Ausgabe wird erzeugt durch ``make html``. Die generierte HTML Ausgabe des Berichts (unter ``_build/html/``) soll in Ihrem RZ WWW-Verzeichnis gespeichert werden. Auf dem Rechner ``login.rz.hs-augsburg.de`` findet man dieses Verzeichnis in ``/www/``, wobei ```` Ihr Login-Name ist. Dieses Verzeichnis finden Sie im WWW unter ``https://www.hs-augsburg.de/~user``. Sie finden diese Angaben auch im Demo-Bericht auf Kapitel 4.7 (*Auf Webspace übertragen*). Es genügt, wenn der Bericht in dem Web-Verzeichnis eines einzigen Teammitglieds liegt und dieser URL in die README.md Datei aufgenommen wird. Das Rechenzentrum erklärt den Zugriff auf das WWW Home auf folgender Seite: https://www.hs-augsburg.de/Rechenzentrum/Eigene-Homepage.html Im Sphinx Demobericht gibt es auch einen Abschnitt "Auf Webspace übertragen". .. Der Bericht kann bei Bedarf über Sphinx auch als PDF Datei ausgegeben werden ("make latex"). Diese Option ist ganz praktisch, wenn man einen Überblick bekommen möchte, wie viele Seiten man schon geschrieben hat. Ausserdem sieht man, ob die Grösse der Bilder im PDF Format stimmt. Wir brauchen die Berichte **nicht auf Papier** (ganz nach dem Logo "paperless"). Zum Inhalt .......... Der Bericht enthält für jeden durchgeführten Versuch ein Kapitel. Jedes Versuchskapitel sollte in etwa folgende Gliederung aufweisen: Datum, Thema 1. Einleitung Motivation, Aufgabenstellung 2. Grundlagen 3. Versuchsdurchführung Vorbereitung, Durchführung, Ergebnisse, Probleme 4. Zusammenfassung Fazit, Tipps für spätere Teams 5. Literaturangaben **Ganz wichtig:** Bei jedem Versuch muss nachvollziehbar sein, wer im Team welche Arbeit gemacht hat und welcher Zeitaufwand dafür in etwa nötig war! Der Bericht muss darüber Auskunft geben. Hier ist ein Beispiel-Bericht, der vom DVA Praktikum für Informatiker stammt: - RZ WWW Home: https://www.hs-augsburg.de/~mab-hsa/dva-praktikum/bericht/ Die Vorbereitungsaufgaben ------------------------- Die Vorbereitungsaufgaben dienen dazu, dass sich alle Teams an den Ablauf gewöhnen. Sie werden sich mit folgendem beschäftigen: - Mit Sphinx anfreunden (https://www.sphinx-doc.org/en/master/contents.html), siehe "Getting Started" - Mit Git und Gitlab anfreunden - https://hhoegl.informatik.hs-augsburg.de/hhwiki/GitSpicker - https://git-scm.com/doc - Freies "Pro Git" Buch in Deutsch https://git-scm.com/book/de/v2 - https://docs.gitlab.com/ce/ - Einloggen auf https://gitlab.informatik.hs-augsburg.de, ein Beispiel-Repository anlegen, klonen, commit, push, pull, ... Das sollen alle Teammitglieder mit dem Beispiel-Repository testen, so dass Sie sich an die gemeinsame Arbeit in Gitlab gewöhnen. - ssh Schlüssel in gitlab anlegen (https://docs.gitlab.com/ce/ssh/README.html) - https://education.github.com/git-cheat-sheet-education.pdf - den Sphinx-Demobericht lesen und auf Ihr Team personalisieren und in Ihr Gitlab Repository aufnehmen - die aktuelle HTML Ausgabe des Berichtes auf Ihr Web-Verzeichnis im RZ kopieren. Nach jeder Änderung/Erweiterung ihres Berichtes soll dieser Schritt wiederholt werden. .. _termine: Termine ------- Oktober bis Dezember 2023, Dienstag, 14:00 - 15:30, G2.16 :: 1. 10.10 Erstes Treffen, Vorbesprechung Ausgabe Versuch 1 2. 24.10. Abgabe Versuch 1 Ausgabe Versuch 2 3. 7.11. Abgabe Versuch 2 Ausgabe Versuch 3 4. 21.11. Abgabe Versuch 3 Ausgabe Versuch 4 5. 5.12. Abgabe Versuch 4 Ausgabe Versuch 5 6. 19.12. Abgabe Versuch 5 Literatur --------- Mikrocontroller - https://hhoegl.informatik.hs-augsburg.de/dva/ti/ct.2021.24.136_137.Grundlagen-Mikrocontroller.pdf GPS - https://hhoegl.informatik.hs-augsburg.de/dva/ti/gps/ct.2021.16.132_137.GPS.pdf - Kapitel 1 aus dem Buch von Shai Vaingast, Beginning Python Visualization, Apress 2009 (sie finden das Buch auch auf dem Springer Link https://link.springer.com/book/10.1007/978-1-4842-0052-0) - https://hhoegl.informatik.hs-augsburg.de/dva/ti/gps/vaingast-kap1.pdf - Quelltext https://hhoegl.informatik.hs-augsburg.de/dva/ti/gps/vaingast-src/ RPi Pico - https://hhoegl.informatik.hs-augsburg.de/dva/ti/rpi-pico/ct.2021.26.RP2040.pdf RPi - RPi Einführung von M. Schäferling https://hhoegl.informatik.hs-augsburg.de/dva/ti/rpi/pi_primer.pdf - ``_ - https://hhoegl.informatik.hs-augsburg.de/dva/ti/rpi/ct.1519.rpi4.pdf CAN - Applikationsschrift von Texas Instruments zum CAN Bus (17 Seiten, 2016) https://hhoegl.informatik.hs-augsburg.de/dva/ti/can/sloa101b.pdf - Applikationsschrift von Renesas zum CAN Bus (44 Seiten, 2006) https://hhoegl.informatik.hs-augsburg.de/dva/ti/can/rej05b0804_m16cap.pdf .. vim: et sw=4 ts=4