View source for Raspberry Pi and Sensors

==The Ultrasound sensor==

[[File:RPI3_Pinout.png|right|thumb|x300px|alt=A Raspberry Pi 3 Pinout|A Raspberry Pi 3 Pinout]]

In this activity, we are going to integrate an HC-SR04 Ultrasonic Module Distance Measuring Sensor to measure distance. Modern self-driving cars can use ultrasonic in conjunction with other sensors which may include radar, cameras, GPS and potentially LIDAR. In some cases, ultrasonic sensors can be more reliable than other proximity sensor for detecting movement in an area, such as the presence of a person in a room. 

Note, this activity was designed based on the guide [https://thepihut.com/blogs/raspberry-pi-tutorials/hc-sr04-ultrasonic-range-sensor-on-the-raspberry-pi here]

Let's get started by referring to the Raspberry Pi pinout. Then, carefully examine the circuit diagram that we will be using below.

[[File:sr04_circuit.jpeg|right|thumb|x300px|alt=A circuit diagram of the SR04 Wiring|A circuit diagram of the SR04 Wiring]]

Finally, examine the picture, of my SR04 wired up, below to confirm your understanding. You may want to click on it to get a high res version. Note that to reduce the number of resistors we were required to purchase, I have used 2 x 1k Resistors rather than a single 1k resistor.

Please read [https://thepihut.com/blogs/raspberry-pi-tutorials/hc-sr04-ultrasonic-range-sensor-on-the-raspberry-pi here] for a more thorough description of the electronics used in this activity.

Put simply, ultrasound relies on sound waves, so picture a speaker making a sound wave that hits a surface and reflects back and is then received by a microphone. The sounds are not audible to us as they are a higher frequency than we can hear. 

These ultrasound sensors will measure the time duration between when the ultrasound signal is sent out, and when it is received back. Working out the distance of the object from the sensor will require us to understand the speed of sound.

The speed of sound is 343m per second. Now the unit we are using is cm so let's multiply 343 by 100 to get to cm, so 34300. Now, the signal we will send out will need to hit a surface and bounce back so to prevent the distances from appearing twice as far, lets divide 34300 by 2 to get 17150.

Now that you understand where that value is coming from, read the Python 3 code below and see if you can get an idea of what is going on.

[[File:sr04_picture.jpeg|right|thumb|x500px|alt=A picture of a Raspberry Pi Zero, wired to an SR04|A picture of a Raspberry Pi Zero, wired to an SR04]]

[[File:distance_sensor.jpeg|right|thumb|x500px|alt=Another picture of a Raspberry Pi Zero, wired to an SR04|Another picture of a Raspberry Pi Zero, wired to an SR04]]

=== The Python 3 code ===

<pre>
#!/usr/bin/python3

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)

TRIG = 23
ECHO = 24

print("Distance Measurement In Progress")

GPIO.setup(TRIG,GPIO.OUT)
GPIO.setup(ECHO,GPIO.IN)

GPIO.output(TRIG, False)

print("Waiting For Sensor To Settle")

time.sleep(2)

GPIO.output(TRIG, True)
time.sleep(0.00001)

GPIO.output(TRIG, False)

while GPIO.input(ECHO)==0:

  pulse_start = time.time()

while GPIO.input(ECHO)==1:

  pulse_end = time.time()      

pulse_duration = pulse_end - pulse_start

distance = pulse_duration * 17150

distance = round(distance, 2)

print("Distance:",distance,"cm")

GPIO.cleanup()
</pre>

Use the code above and your favourite text editor, and save it as distance_sensor.py, then run.

 python3 distance_sensor.py

Make sure you play around with distances to ensure your sensor is working properly.

== Challenge 1 ==

*Can you loop over this code continually? 

== Challenge 2 ==

Review one of the early labs, called [[Contactless Doorbell with If This Then That]], where you setup a webhooks trigger that sent an email. 

Set up a new webhooks trigger called distance. Can you integrate the following python3 code to make your Raspberry Pi trigger the webhook to send you an email when someone is within 10 cm of the sensor?

<pre>
import urllib.request as req

    if distance < 10:
        print(req.urlopen("https://maker.ifttt.com/trigger/proximity/with/key/this-is-your-url").status)
        print("The object is closer than 10 cm, firing up IFTTT")
</pre>