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