Joy-it KY-001 User manual

3
Temperature Sensor
KY-001

Published: 27.08.2018 Copyright by Joy-IT 2
Temperature Sensor
1. Overview
2. Pin-Assignment
3. Code Example Arduino
4. Code Example Raspberry Pi
5. Informaon and take-back obligaons
6. Support
TABLE OF CONTENTS

Published: 27.08.2018 Copyright by Joy-IT 3
Temperature Sensor
Dear customer,
Thank you for choosing our product.
In the following, we will show you what to observe during commissioning and use. Should you encounter
any unexpected problems during use, please do not hesitate to contact us.
1. OVERVIEW
Chipset DS18B20
Communicaon protocoll 1-Wire
Accuracy of Measurement 9 - 12 Bit
Range of Measurement -55°C - 125°C
2. PIN-ASSIGNMENT
Pin assignment Arduino
Signal Pin 4
+V Pin 5V
GND Pin GND
Pin assignment Raspberry Pi
Signal GPIO4 [Pin 7]
+V 3,3V [Pin 1]
GND Masse [Pin 6]

Published: 27.08.2018 Copyright by Joy-IT 4
Temperature Sensor
The following code example requires two addional libraries. These consist of the OneWire Library by
Paul Storegen, published under the MIT License, and the Dallas Temperature Control Library by Miles
Burton, published under the LGPL License. Both libraries are included in the package and must be copied
to the "library" folder before starng the Arduino IDE. You can nd it by default under the following path
of your Windows installaon: C:\Users\[Username]\Documents\Arduino\libraries
You can download the code example for Arduinos here or copy the following one:
3. CODE EXAMPLE ARDUINO
// Required libraries are imported
#include <DallasTemperature.h>
#include <OneWire.h>
// The input pin to which the sensor module is connected is declared here.
#define KY001_Signal_PIN 4
// Libraries are configured
OneWire oneWire(KY001_Signal_PIN);
DallasTemperature sensors(&oneWire);
void setup() {
// Initialization Serial output
Serial.begin(9600);
Serial.println("KY-001 Temperaturmessung");
// Sensor is initialized
sensors.begin();
}
// Main program loop
void loop()
{
// Temperature measurement is started...
sensors.requestTemperatures();
// ... and display measured temperature
Serial.print("Temperatur: ");
Serial.print(sensors.getTempCByIndex(0));
Serial.write(176); // UniCode specification of a char symbol for the "° symbol".
Serial.println("C");
delay(1000); // 5s Pause until next measurement
}

Published: 27.08.2018 Copyright by Joy-IT 5
Temperature Sensor
In order for the Raspberry Pi to be able to communicate with the One-Wire Bus, with which the DS18B20
sensor transmits its measurement data digitally, it must rst be acvated. The le "/boot/cong.txt" must
be edited. To do this, open a terminal window and enter the following command to open the le:
Now add the following line to the opened le at the end:
Save the le with the key combinaon CTRL+O and exit it with the combinaon CTRL+X.
Now restart your Raspberry Pi with the following command so that the changes you have made take
eect:
You can download the code example for Raspberry Pis here or copy and paste the following secons.
4. CODE EXAMPLE RASPBERRY PI
sudo nano /boot/config.txt
dtoverlay=w1-gpio,gpiopin=4
sudo reboot

Published: 27.08.2018 Copyright by Joy-IT 6
Temperature Sensor
# coding=utf-8
# Required modules are imported and set up
import glob
import time
from time import sleep
import RPi.GPIO as GPIO
# At this point the pause between the individual measurements can be set
sleeptime = 1
# The One-Wire input pin is declared and the integrated pull-up resistor is activated
GPIO.setmode(GPIO.BCM)
GPIO.setup(4, GPIO.IN, pull_up_down=GPIO.PUD_UP)
# After activation of the pull-up resistor, wait until communication with the DS18B20
# sensor is established.
print 'Warte auf Initialisierung...'
base_dir = '/sys/bus/w1/devices/'
while True:
try:
device_folder = glob.glob(base_dir + '28*')[0]
break
except IndexError:
sleep(0.5)
continue
device_file = device_folder + '/w1_slave'
# Function is defined with which the current measured value can be read out at the
sensor
def TemperaturMessung():
f = open(device_file, 'r')
lines = f.readlines()
f.close()
return lines
# For initialization, the sensor is read "blind" once
TemperaturMessung()
# Temperature evaluation: With Raspberry Pi, detected one-wire slaves are stored in
the folder /sys/bus/w1/devices/
# This folder contains the file w1-slave
# in which the data sent over the One-Wire bus is stored
# In this function, this data is analyzed and the temperature is read out and shown

Published: 27.08.2018 Copyright by Joy-IT 7
Temperature Sensor
def TemperaturAuswertung():
lines = TemperaturMessung()
while lines[0].strip()[-3:] != 'YES':
time.sleep(0.2)
lines = TemperaturMessung()
equals_pos = lines[1].find('t=')
if equals_pos != -1:
temp_string = lines[1][equals_pos+2:]
temp_c = float(temp_string) / 1000.0
return temp_c
# main loop
# The measured temperature is sent to the console between the individual measurements
# is a pause whose length can be set with the variable "sleeptime
try:
while True:
print '---------------------------------------'
print "Temperatur:", TemperaturAuswertung(), "°C"
time.sleep(sleeptime)
except KeyboardInterrupt:
GPIO.cleanup()

Published: 27.08.2018 Copyright by Joy-IT 8
Temperature Sensor
Symbol on electrical and electronic equipment
This crossed-out dustbin means that electrical and electronic equipment does not belong in household
waste. You must return the old devices to a collecon point. Before disposal, you must separate old
baeries and accumulators which are not enclosed in the old device from it.
Return opons
As an end user, you can dispose of your old device (which essenally fulls the same funcon as the new
one purchased from us) free of charge when purchasing a new device. Small appliances where no external
dimensions are larger than 25 cm can be delivered in normal household quanes, irrespecve of the
purchase of a new appliance.
Possibility of return at our company locaon during opening hours
Simac GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn
Possibility of return in your area
We will send you a parcel stamp with which you can return the device to us free of charge. Please contact
us by e-mail at [e-mail] or by phone.
Informaon about packaging
If you do not have suitable packaging material or do not wish to use your own, please contact us and we
will send you suitable packaging.
5. INFORMATION AND TAKE-BACK OBLIGATIONS

Published: 27.08.2018 Copyright by Joy-IT 9
Temperature Sensor
We also support you aer your purchase. If there are any quesons le or if you encounter any problems,
please feel free to contact us by mail, phone or by our cket-system on our website.
E-Mail: [e-mail]
Ticket-System: hp://support.joy-it.net
Phone: [phone] – 66 (11- 18 o‘clock)
For more informaon, please visit our website:
www.joy-it.net
6. SUPPORT