Arduino: IR-Theremin: Unterschied zwischen den Versionen

Aus HSHL Mechatronik
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 30: Zeile 30:
# Wurde auf <code>magic numbers</code> verzichtet?
# Wurde auf <code>magic numbers</code> verzichtet?
# Wurde die [[Medium:Programmierrichtlinie.pdf|Programmierrichtlinie]] eingehalten?
# Wurde die [[Medium:Programmierrichtlinie.pdf|Programmierrichtlinie]] eingehalten?
'''Arbeitsergebnisse''' in SVN: <code>Lernzielkontrolle_Termin_07.pdf</code>
 


== Vorbereitung ==
== Vorbereitung ==
Bereiten Sie sich anhand der nachfolgenden Aufgaben auf den Praktikumstermin vor.
Bereiten Sie sich anhand der nachfolgenden Aufgaben auf den Praktikumstermin vor.
# Installieren Sie den seriellen Monitor Putty und machen Sie sich mit der Bedienung vertraut.
# Installieren Sie den seriellen Monitor <code>Putty</code> und machen Sie sich mit der Bedienung vertraut. Nutzen Sie den Artikel [[Einrichtung_von_PuTTY| Anleitung für Putty]].
 
# Schreiben Sie ein Arduino Programm, welchen die Zeit in ms und Distanz in cm seriell ausgibt.
# Installieren Sie die [https://www.arduino.cc/reference/en/libraries/quicksortlib/ QuickSort Bibliothek]. Nutzen Sie die [https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries Anleitung zur Installation von Bibliotheken].
# Visualisieren Sie Die Distanz über der Zeit in MATLAB. Nutzen Sie hierfür das [https://svn.hshl.de/svn/Informatikpraktikum_1/trunk/Demos/Arduino/DemoDebugTxt2MATLAB  DemoDebugTxt2MATLAB].
# Sortieren Sie die 5 Zufallswerte nach Größe z.&thinsp;B. <code>2,2,4,1,2</code> wird zu <code>1,2,2,2,4</code>. Nutzen Sie hierfür die Funktionen aus <code>DemoSortiereArray.ino</code>.
 
[[Datei:Batterie-Tester.jpg |thumb|rigth|300px|Abb. 2: Batterie-Tester]]
# Studieren Sie das [https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-serial-plotter Using the Serial Plotter Tool]  und nutzen Sie das Demo [https://svn.hshl.de/svn/Informatikpraktikum_1/trunk/Demos/Arduino/DemoSharpIR/DemoSharpIR.ino DemoSharpIR.ino], um Daten im Seriellen Plotter auszugeben.
# Recherchieren Sie die Funktion des Sensors anhand von Fachliteratur und des [[Medium:GP2Y0A41SK0F.pdf|Datenblatts]] oder [[Sharp_GP2Y0A41SK0F|Wiki-Artikels]].
# Bauen Sie die Schaltungen zur Auswertung der Sensoren auf.
# Nutzen Sie die Abbildung auf Seite 4 des [[Medium:GP2Y0A41SK0F.pdf|Datenblatts]], um eine Tabelle Spannung/Distanz aufzustellen (vgl. Tab. 1).
# Machen Sie sich mit der Funktion der analogen Eingänge vertraut: [https://www.arduino.cc/reference/en/language/functions/analog-io/analogread/ Arduino Referenz: <code>analogRead()</code> ]. Messen Sie gemäß Abb. 2 die Spannung einen AA Batterie in V. (Hinweis: KEINE 9-V-BLOCK nutzen! Spannung von mehr als 5&thinsp;V können den '''Arduino zerstören'''.)
# Nutzen Sie die [https://www.arduino.cc/reference/en/language/functions/analog-io/analogread/ Arduino Referenz: <code>analogRead()</code> ] und erweitern Sie Ihre Tabelle um die Spalte Digitalwert <code>D1</code> (vgl. Tab. 1).
# Planen Sie die Software via PAP.
# Planen Sie die Software via PAP.
# Beantworten Sie die Lernzielkontrollfragen.
# Beantworten Sie die Lernzielkontrollfragen.
# Sichern Sie Ihre Unterlagen in SVN.
# Sichern Sie Ihre Unterlagen in SVN.
<div class="mw-collapsible mw-collapsed">


'''Musterlösung:''' für den Batterie-Tester
'''Arbeitsergebnisse''' in SVN: <code>Lernzielkontrolle_Termin_07.pdf</code>
<source line lang="C" style="font-size:small">const unsigned long BAUD_RATE_u32 = 9600;
const unsigned int AUFLOESUNG_u16 = 1023; //2^10-1
const float ARDUINO_SPANNUNG_f32  = 5.0;
 
void setup() {
  Serial.begin(BAUD_RATE);
}
 
void loop() {
  unsigned int Digitalwert_u16 = analogRead(A0); // Quantisierung der Apannung am Analogen Eingang A0
  Serial.print(ARDUINO_SPANNUNG_f32 * AUFLOESUNG_u16/Digitalwert_u16); // Umrechnung Digitalwert in V
  Serial.println("V");
</source>
</div>
{| class="wikitable"
|+ style = "text-align: left"|Tabelle 1: Kennlinie des IR-Distanzsensors
|-
| '''Spannung <code>U1</code> in V'''|| '''Distanz <code>d</code> in cm'''|| '''Digitalwert <code>D1</code>'''
|-
| 3|| 3,6 || 614
|-
| 2.02|| 6 || 413
|-
| 0.82|| 16 || 168
|-
| ..|| .. || ..
|-
|}
'''Tipps:'''
* Nutzen Sie Werte über den gesamten Wertebereich [0.2&thinsp;V .. 3.2&thinsp;V].
* Sie können die Werte auch durch reale Messungen auf ein statisches Ziel ermitteln.
* Umrechnungsformel: <math>D_1 = U_1\cdot \frac{1023}{5\,V}</math>
<iframe key="panopto" path="/Panopto/Pages/Embed.aspx?id=98958e23-9c36-48cf-b912-af3c00601ce1&autoplay=false&offerviewer=true&showtitle=true&showbrand=true&captions=false&interactivity=all" height="405" width="720" style="border: 1px solid #464646;" allowfullscreen allow="autoplay"></iframe>
-->


== Versuchsdurchführung ==
== Versuchsdurchführung ==

Version vom 4. November 2022, 16:51 Uhr

Abb. 1: Lernset - Einsteiger Kit für Arduino

Autor: Prof. Dr.-Ing. Schneider
Modul: Praxismodul I
Lehrveranstaltung: Mechatronik, Informatikpraktikum 1, 1. Semester, Wintersemester

Fragestellungen, Begriffe und Voraussetzungen

Fragestellungen

Bislang haben Sie sich umfangreich mit dem Sharp IR Abstandssensor beschäftigt. Sie haben analoge Spannungswerte digitalisiert, Störungen entfernt und mittels Kennlinie die Distanz berechnet. In dieser Lektion kommt der kalibrierte Sensor als Musikinstrument zur Anwendung.

Eingeführte Begriffe und Konzepte

In den vorherigen Lektionen wurde der serielle Monitor und Plotter der Arduino IDE zu Datenvisualisierung verwendet. In dieser Lektion werden die Daten in eine Textdatei geschrieben und mit MATLAB visualisiert. Zusätzlich wird der passive Lautsprecher verwendet, um eine Melodie zu spielen. Als Musikinstrument wird ein Theremin gebaut, welches abhängig vom gemessenen Abstand die Tonfrequenz variiert.

Vorausgesetzte Kenntnisse aus vorangegangenen Lektionen

  • Messung der Entfernung mit einem IR-Sensor
  • Ansteuerung des Piezo Lautsprechers

Lernziele

Nach Durchführung dieser Lektion

  • können Daten in eine Textdatei exportieren und visualisieren.
  • können eine Melodie mit dem Arduino spielen.
  • können Sie ein IR-Theremin bauen und entfernungsabhängig Töne spielen.

Lernzielkontrolle

  1. Haben Sie Messdaten mit 115200 baud seriell ausgegeben?
  2. Haben Sie Messdaten mit Putty in ein Textdatei geschrieben und gespeichert?
  3. Haben Sie die Messdaten mit MATLAB geladen und angezeigt?
  4. Wurde der Quelltext durch Header und Kommentare aufgewertet?
  5. Wurden jedes Programm mittels PAP geplant?
  6. Wurde auf magic numbers verzichtet?
  7. Wurde die Programmierrichtlinie eingehalten?


Vorbereitung

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

  1. Installieren Sie den seriellen Monitor Putty und machen Sie sich mit der Bedienung vertraut. Nutzen Sie den Artikel Anleitung für Putty.
  2. Schreiben Sie ein Arduino Programm, welchen die Zeit in ms und Distanz in cm seriell ausgibt.
  3. Visualisieren Sie Die Distanz über der Zeit in MATLAB. Nutzen Sie hierfür das DemoDebugTxt2MATLAB.
  4. Planen Sie die Software via PAP.
  5. Beantworten Sie die Lernzielkontrollfragen.
  6. Sichern Sie Ihre Unterlagen in SVN.

Arbeitsergebnisse in SVN: Lernzielkontrolle_Termin_07.pdf

Versuchsdurchführung

Aufgabe 7.1: Lernzielkontrolle

Präsentieren Sie Prof. Schneider das Ergebnis der Lernzielkontrolle.

Arbeitsergebnisse in SVN: Lernzielkontrolle_Termin_07.pdf

Aufgabe 7.2: Debugging

Arduino-Aufgabe

  1. Messen Sie die Zeit in Millisekunden mit dem Befehl millis()
  2. Messen Sie die Entfernung mit und ohne Median-Filter.
  3. Geben Sie die Zeit und Messdaten im seriellen Monitor aus (Format: Zeit in ms;d in cm; Median-Filter in cm <LF>).
  4. Nutzen Sie Putty als seriellen Monitor und speichern Sie die Daten in der Datei Debug.txt.

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

MATLAB-Aufgabe

  1. Nutzen Sie das Demo startLeseDebug.m und lesen Sie die Daten aus der Datei Debug.txt.
  2. Stellen Sie die Entfernung ohne Median Filter über der Zeit dar (plot(Zeit,Messwerte,'r.-')).
  3. Stellen Sie die Entfernung mit Median Filter über der Zeit dar (plot(Zeit,median,'b-')).
  4. Ergänzen Sie eine Legende (legend("Messwerte", Median-Filter,'b-')).
  5. Beschriften Sie die Achsen.

Nützliche Befehle: hold on, plot, yLabel, legend

Arbeitsergebnisse in SVN: schreibeDebugDatei.ino, Debug.txt, leseDebugDatei.m

Aufgabe 7.3: Töne erzeugen

  1. Folgen Sie der Anleitung zur Ausgaben von Tönen.
  2. Mit einem passiven Lautsprecher sollen unterschiedliche Töne und eine Melodie erzeugt werden.

Nützliche Befehle: tone(), delay(), noTone(), pinMode(), digitalRead(), if()

Arbeitsergebnisse in SVN: testeMedianFilter.ino

Aufgabe 7.4: IR-Theremin

Ein Theremin ist ein Instrument, das Töne abhängig von den Bewegungen des Musizierenden erzeugt. Die Titelmelodie von Star Treck wurde beispielsweise damit gespielt. Das Theremin detektiert die Hände im Verhältnis zu zwei Antennen. Diese Antennen sind mit einem analogen Schaltkreis verbunden und erzeugen die Musik. Eine Antenne regelt die Frequenz der Töne und die Andere die Lautstärke. Diese Aufgabe emuliert das Theremin indem die Funktion tone() verwendet wird und die vom IR-Sensor gemessenen Abstände die Tonfrequenzen manipulieren. Lesen Sie die Entfernung wie in den Aufgaben zuvor über analogRead() ein. Schließen Sie den aktiven Lautprecher (Piezo-Lautsprecher) an Pin 8 an.

  1. Erzeugen Sie Töne abhängig von den Messwerten des Sharp IR-Entfernungssensors.
  2. Kalibrieren Sie die Zuordnung von Entfernung zu Frequenzen mit dem Der map()-Befehl.
  3. Spielen Sie eine Melodie.

Nützliche Befehle: tone(), delay(), noTone(), analogRead(), map()

Arbeitsergebnisse in SVN: IR_Theremin.ino

Aufgabe 7.5: Nachhaltige Doku

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

  • Wurden die Regeln für den Umgang mit SVN eingehalten?
  • Wurde die Programmierrichtlinie eingehalten?
  • Wurde nachhaltig dokumentiert?
  • Haben die Programme einen Header?
  • Wurden der Quelltext umfangreich kommentiert?
  • Wurden die PAPs erstellt und abgelegt? Passen die PAPs 100% zum Programm?

Arbeitsergebnis in SVN: SVN Log

Bewertung

Aufgabe Punkte
7.1 2
7.2 2
7.3 2
7.4 2
7.5 2

Tutorials

Demos

Videos

Was ist ein Theremin?
STAR TREK original theme performed on theremin
Infrarotsensor Theremin

Literatur

  1. Brühlmann, T.: Arduino Praxiseinstieg. Heidelberg: mitp, 4. Auflage 2019. ISBN 978-3-7475-0056-9. URL: HSHL-Bib, O'Reilly-URL
  2. Brühlmann, T.: Sensoren im Einsatz mit Arduino. Frechen: mitp Verlag, 1. Auflage 2017. ISBN: 9783958451520. URL: HSHL-Bib, O'Reilly
  3. Snieders, R.: ARDUINO lernen. Nordhorn: 8. Auflage 2022. URL: https://funduino.de/vorwort
  4. Schneider, U.: Programmierrichtlinie für für die Erstellung von Software in C. Lippstadt: 1. Auflage 2022. PDF-Dokument (212 kb)
  5. Sharp: GP2Y0A41SK0F. URL: [1]. Datenblatt (858 kb)

→ zurück zum Hauptartikel: Arduino Praxiseinstieg