From 3ecde5e4033f5d0c1a1dc31d7d744f1a50397cfd Mon Sep 17 00:00:00 2001 From: Tom Igoe Date: Mon, 13 Nov 2023 16:25:18 -0500 Subject: [PATCH] Added circuit image and readme for ultrasonic examples --- .../HC-SR04Ultrasonic_Uno_bb.png | Bin 0 -> 64617 bytes .../HC-SR04Ultrasonic_Uno_speaker_bb.svg | 6913 +++++++++++++++++ .../UltrasonicSensorExamples/readme.md | 35 + 3 files changed, 6948 insertions(+) create mode 100644 Tone_examples/UltrasonicSensorExamples/HC-SR04Ultrasonic_Uno_bb.png create mode 100644 Tone_examples/UltrasonicSensorExamples/HC-SR04Ultrasonic_Uno_speaker_bb.svg create mode 100644 Tone_examples/UltrasonicSensorExamples/readme.md diff --git a/Tone_examples/UltrasonicSensorExamples/HC-SR04Ultrasonic_Uno_bb.png b/Tone_examples/UltrasonicSensorExamples/HC-SR04Ultrasonic_Uno_bb.png new file mode 100644 index 0000000000000000000000000000000000000000..b9282b8ee7591da736a5723cbc62e51e1b0fa52a GIT binary patch literal 64617 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

8yJusporUjP=vo6w;Kb;Ke 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + 1 + + + 5 + + + 5 + + + 10 + + + 10 + + + 15 + + + 15 + + + 20 + + + 20 + + + 25 + + + 25 + + + 30 + + + 30 + + + A + + + A + + + B + + + B + + + C + + + C + + + D + + + D + + + E + + + E + + + F + + + F + + + G + + + G + + + H + + + H + + + I + + + I + + + J + + + J + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 13 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 12 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 11 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 10 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 9 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 8 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 7 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 6 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 4 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + L + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 5V + + + + + + + + + + + + + + + + + + + + A0 + + + + + + + + + + + + + + + + + + + + + + + + ANALOG IN + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + AREF + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + GND + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + TX + + + + + + + + + + + + + + + + + + + + + + + RX + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + RESET + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 3V3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A1 + + + + + + + + + + + + + + + + + + + A2 + + + + + + + + + + + + + + + + + + + + + + + A3 + + + + + + + + + + + + + + + + + + + + + + + A4 + + + + + + + + + + + + + + + + + + + + + + + A5 + + + + + + + + + + + + + + + + + + + + + + + + VIN + + + + + + + + + + + + + + + + + + + + + + + + + GND + + + + + + + + + + + + + + + + + + + + + + + + + GND + + + + + + + + + + + + + + + + + + + + + + + DIGITAL (PWM= + + + + + + + + + + + + + + + + + + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Arduino + + + + + + + + + + + + + + + + + + + + + + + TM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + IOREF + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ICSP + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ICSP2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ON + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + POWER + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + TX0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + RX0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + RESET + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 16.000 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Tone_examples/UltrasonicSensorExamples/readme.md b/Tone_examples/UltrasonicSensorExamples/readme.md new file mode 100644 index 0000000..312aefb --- /dev/null +++ b/Tone_examples/UltrasonicSensorExamples/readme.md @@ -0,0 +1,35 @@ +# HC-SR04 Ultrasonic Sensor Examples + +All the examples in this section can be done with the same circuit diagram, below: + +![Breadboard view of an ultrasonic sensor connected to pins 9 and 10 of an Uno, and a speaker connected to pins A0 and ground](HC-SR04Ultrasonic_Uno_bb.png) + +The examples cover the following concepts: + +Concepts covered: + + ## [How to Read Distance With the Sensor](1_HC_SR04_ultrasonic_sensor/1_HC_SR04_ultrasonic_sensor.ino): +* based on [these notes](https://itp.nyu.edu/physcomp/labs/lab-ultrasonic-distance-sensor/) +* How the ultrasonic sensor works +* Speed of sound +* conversion to centimeters + + +## [How to Convert Distance to Frequency](2_HC_SR04_ultrasonic_sensor_to_tone/2_HC_SR04_ultrasonic_sensor_to_tone.ino) +* based on these notes +* assume that the distance range that matters is 0 - 100cm +* Assume that the range of frequencies you want is 110Hz to 1046.5 Hz (A2 to C6 in equal tempered musical note pitches) +* Map the distance range to the frequency range +* Play the note (tone command) for 300 milliseconds +* Delay for 500 milliseconds to play the note and have a little rest + +Now you've got a theremin + +## [To Make The Device Not Play Continuously](3_HC_SR04_ultrasonic_sensor_to_note/3_HC_SR04_ultrasonic_sensor_to_note.ino) (optional) +* After playing a note, save the distance in a variable +* Before the next note, compare the new distance to the old distance +* If they're the same, don't play anything. + +## [To Make The Device Convert To Specific Notes (Not All Frequencies In Between)](4_HC_SR04_ultrasonic_sensor_to_note_norepeat/4_HC_SR04_ultrasonic_sensor_to_note_norepeat.ino) (optional) +* Convert the distance to a MIDI note value + * Convert the MIDI note value to a frequency