Joy-it Combi Sensor User manual

3
Combi Sensor
KY-015

Published: 27.08.2018 Copyright by Joy-IT 2
Combi 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
Combi 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.
Please note that the sensor only provides a new measurement result every 2 seconds. It is designed for
long-term recordings.
1. OVERVIEW
Chipset DHT11
Communicaon protocoll 1-Wire
Measuring range air humidity 20 - 90% RH
Measuring range temperature 0 - 50°C
2. PIN-ASSIGNMENT
Pin Assignment Arduino
Signal Pin D2
+V Pin 5V
GND Pin GND
Pin Assignment Raspberry Pi
Signal GPIO23 [Pin 16]
+V 3,3V [Pin 1]
GND Masse [Pin 6]

Published: 27.08.2018 Copyright by Joy-IT 4
Combi Sensor
This sensor does not output its measurement result as an analog signal on an output pin, but
communicates this digitally coded. There are several ways to control this sensor module. The
Adafruit_DHT Library, published by Adafruit under the following link under the OpenSource MIT license,
has proven to be parcularly accessible.
The example below uses this library - we recommend downloading it from Github, unpacking it and
copying it to the Arduino Library folder located by default at
(C:\User\[Username]\Documents\Arduino\libraries) to make it available for this code example and
subsequent projects. Alternavely, this is also included in the download package.
You can download the code example here or copy and paste the following secons:
3. CODE EXAMPLE ARDUINO
// Adafruit_DHT Library is inserted
#include "DHT.h"
// Here the respective input pin can be declared
#define DHTPIN 2
// The sensor is initialized
#define DHTTYPE DHT11 // DHT 11
DHT dht(DHTPIN, DHTTYPE);
void setup()
{
Serial.begin(9600);
Serial.println("KY-015 Test - Temperatur und Luftfeuchtigkeits-Test:");
// Measurement is started
dht.begin();
}
// main loop
// The program starts the measurement and reads out the measured values
// A pause of 2 seconds is inserted between the measurements,
// so that a new measurement can be recorded during the next run.
void loop() {
// Zwei Sekunden Pause zwischen den Messungen
delay(2000);
// Two seconds pause between measurements
float h = dht.readHumidity();
// Temperature is measured
float t = dht.readTemperature();

Published: 27.08.2018 Copyright by Joy-IT 5
Combi Sensor
// Here it is checked whether the measurements have run without errors.
// If an error is detected, an error message is displayed here
if (isnan(h) || isnan(t)) {
Serial.println("Fehler beim Auslesen des Sensors");
return;
}
// Output to the serial console
Serial.println("-----------------------------------------------------------");
Serial.print("Luftfeuchtigkeit: ");
Serial.print(h);
Serial.print(" %\t");
Serial.print("Temperatur: ");
Serial.print(t);
Serial.print(char(186)); //Output <°> Symbol
Serial.println("C ");
Serial.println("-----------------------------------------------------------");
Serial.println(" ");
}

Published: 27.08.2018 Copyright by Joy-IT 6
Combi Sensor
The program uses the corresponding Adafruit_Python_DHT library from Adafruit to control the DHT11
sensor installed on this sensor module. These were published under the following link unter under the
MIT OpenSource-Licence.This must be installed rst.
To do this, open a terminal window on your Raspberry Pi and enter the following commands:
Use the following command to download the latest version of the Adafruit_DHT Library:
Now install the library:
You can download the code example here. Alternavely, you can copy the following secon.
Then start the example with the following command:
4. CODE EXAMPLE RASPBERRY PI
sudo apt-get install git
sudo apt-get update
sudo apt-get install build-essential python-dev
git clone https://github.com/adafruit/Adafruit_Python_DHT.git
cd Adafruit_Python_DHT/
sudo python setup.py install
sudo python KY-015-RPi_Kombi-Sensor_Temperatur_Feuchtigkeit.py

Published: 27.08.2018 Copyright by Joy-IT 7
Combi Sensor
#!/usr/bin/python
# coding=utf-8
# Required modules are imported and set up
import RPi.GPIO as GPIO
import Adafruit_DHT
import time
# The pause of two seconds between measurements is set here
sleeptime = 2
# Sensor should be set to Adafruit_DHT.DHT11,
# Adafruit_DHT.DHT22, or Adafruit_DHT.AM2302.
DHTSensor = Adafruit_DHT.DHT11
# The pin to which the sensor module is connected can be declared here
GPIO_Pin = 23
print('KY-015 Sensortest - Temperatur und Luftfeuchtigkeit')
try:
while(1):
# Measurement is started and the result is written to the corresponding vari-
ables
Luftfeuchte, Temperatur = Adafruit_DHT.read_retry(DHTSensor, GPIO_Pin)
print("-----------------------------------------------------------------")
if Luftfeuchte is not None and Temperatur is not None:
# Das gemessene Ergebnis wird in der Konsole ausgegeben
print('Temperatur = {0:0.1f}°C | rel. Luftfeuchtigkeit =
{1:0.1f}%'.format(Temperatur, Luftfeuchte))
# Because the Raspberry Pi is disadvantaged for real-time applications due to
the Linux operating system,
# communication may fail due to timing problems.
# In this case an error message is displayed - a result should be available
at the next attempt
else:
print('Fehler beim Auslesen - Bitte warten auf nächsten Versuch!')
print("-----------------------------------------------------------------")
print("")
time.sleep(sleeptime)
# Cleanup after the program is finished
except KeyboardInterrupt:
GPIO.cleanup()

Published: 27.08.2018 Copyright by Joy-IT 8
Combi 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 Ltd, Pascalstr. 8, 47506 Neukirchen-Vluyn, Germany
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
Combi 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