Published April 12, 2020 © GPL3+

Humidity sensing and alerting system using Bolt IoT

It monitors if the humidity lies in the specified range, if not sends a alert message via Telegram and even gives out an alarm using buzzer

BeginnerFull instructions provided5 hours703

Humidity sensing and alerting system using Bolt IoT

Things used in this project

Hardware components

Bolt IoT Bolt WiFi Module

Buzzer

USB-A to Micro-USB Cable

Male/Female Jumper Wires

Breadboard (generic)

DHT11 Temperature & Humidity Sensor (4 pins)

Software apps and online services

Bolt IoT Bolt Cloud

Hand tools and fabrication machines

Wire Stripper & Cutter, 18-10 AWG / 0.75-4mm² Capacity Wires

Story

1. INTRODUCTION

Humidity is the presence of water in air. Its measurement and monitoring is critical as the amount of water vapour can affect many industrial and biological processes.

Humidity Sensor is of utmost importance when it comes to optimum functioning of medical devices like incubators, respiratory equipment's, etc. Even the imaging modalities like MRI, CT-SCAN; even CATHLAB. It is necessary to ensure that Relative percentage humidity doesn't cross the range 20%-60% in most of the cases, while it may vary in other places. If it exceeds it may damage electronic components in the imaging modalities or optimum working in the magnet room in case of MRI.

When the level exceeds, having an alert message send over the telegram application(if you are away from the main site) and alarming of the buzzer(useful for quick look if you are closer) can help rectify the problem immediately before it causes any issues.

So using this project it is possible to measure % relative humidity and send alert messages over telegram as well as ring buzzer if the level exceeds.

2. HARDWARE CONNECTIONS

Step 1: Hold the sensor in a manner such that you can identify the pins of the sensor as VCC, GND and Output(A0) from your right. to left(Do not consider the Do pin)

Step 2:In the above image, VCC is connected to the blue wire, A0 is connected to the green wire and Gnd is connected to the yellow wire.

Step 3: Using male to female wire connect the 2 pins (A0 and VCC) of the sensor to the Bolt Wifi Module as follows:

VCC pin of the sensor connects to 5v of the Bolt Wifi module.
A0 pin of the sensor connects to A0 (Analog input pin) of the Bolt Wifi module.

Step 4: Connect the longer lead of the buzzer to a maroon wire of a two-pin connector(joined via green wire) and shorter lead of the buzzer to a black wire of a two-pin connector(joined via white wire).

Step 5: Connect the two pin connector on the breadboard. Connect the yellow wire (from the sensor) in the same line as the black of the two pin connector(as both are to be connected to GND of wifi module). Now insert one end of a red male-male connector wire to the same line as yellow and black on the breadboard and connect the other end to GND of the Bolt Wifi module.

Step 6: Now insert one end of a black male-male connector wire to the same line as maroon wire of the two-pin connector on the breadboard and connect the other end to Digital ''0" of the Bolt Wifi module.

Final connection outcome:

3. CONFIGURATION FILE

The python coding for this project has been done in Ubuntu. It is necessary to make a configuration file which will have the specific keys for each user/device and it will be imported in our main code with various attributes. Each new user will only have to change the contents the configuration file to use the product.

The API key and Device ID of the Bolt module can be obtained from your Bolt Cloud webpage

4. CREATION OF TELEGRAM CHANNEL AND BOT

Install the Telegram App and sign in using your mobile number. Then follow the following steps to create a telegram channel and bot.

New channel:

Go to the home screen of the Telegram app.
Swipe from the left side to reveal the menu.
Click on "New Channel".
It will ask you for a Name and Description for your channel. Give a suitable name and description. Adding photo is optional.
In the next screen set the channel as Public.
On the same screen, it will ask you to enter a permanent link for your channel.
The channel link name is unique and only one can exist at one time.
Save it as telegram_chat_id

You have created a new channel.

New bot:

On the Home screen of the app, click on the search icon on the top right and type in "botfather".
In the search results, click on the correct result for "BotFather" as shown below. This will take you to a chat window with the "BotFather".
Since we need to create a new Bot, go ahead and type in "/newbot" in the window.
It will ask you to type in few more details like Bot name and Bot username.
When your bot is created successfully, you will be shown a screen containing the Bot Token. This token is used to control your Bot as well as send messages on behalf of it.
Bot token is saved as telegram_bot_id. The telegram_bot_id is saved as "bot" followed by the bot token.
The telegram_bot_id will be used in the python code to send messages.
You have created a new Bot.

Add channel to Bot:

From the App home screen, open the channel we have created earlier.
In the screen, click on the channel name on the top to open the information for the Channel.
Click on the Administrators button so that we can add the newly created bot to the channel.
Search for the bot that we have created using the Bot's username. Once you have found the correct Bot click on it to add it to the channel.
You will now see the newly created Bot in the list of administrators for the channel.

5. EXPLANATION OF FEW AREAS

5.1 BUZZER

We are calling a function named digitalWrite()

This function has two parameter. The first parameter is pin number and the second parameter state.

To turn the LED ON, the state would be HIGH and to turn it OFF state would be LOW.

The pin no is "0" in our case

5.2 HUMIDITY SENSOR RANGE

The sensor_value is not the real percentage humidity, but infact is something as follows:

Humidity = (100 * sensor_value)/1024

This makes our minimum_value(20%) and maximum_value(60%) as:

minimum_value = (20*1024)/100 = 204.8

maximum_value = (60*1024)/100 = 614.4

6. Python O/P photo:

7. TELEGRAM ALERT MESSAGE

8. PROJECT VIDEO

Code

bolt_api_key = "XXXX"               # This is your Bolt Cloud API Key
device_id = "XXXX"                  # This is the device ID and will be similar to BOLTXXXX where XXXX is some numbers
telegram_chat_id = "@XXXX"          # This is the channel ID of the created Telegram channel. Paste after @
telegram_bot_id = "botXXXX"         # This is the bot ID of the created Telegram Bot. Paste after bot
min_value = 204.8                     # minimumvalue beyond which alert should be sent
max_value = 614.4                     # maximumvalue beyond which alert should be sent

import requests                 # for making HTTP requests
import json                     # library for handling JSON data
import time                     # module for sleep operation

from boltiot import Bolt        # importing Bolt from boltiot module
import conf                     # config file

mybolt = Bolt(conf.bolt_api_key, conf.device_id)

def get_sensor_value_from_pin(pin):
    """Returns the sensor value. Returns -999 if request fails"""
    try:
        response = mybolt.analogRead(pin)
        data = json.loads(response)
        if data["success"] != 1:
            print("Request not successfull")
            print("This is the response->", data)
            return -999
        sensor_value = int(data["value"])
        return sensor_value
    except Exception as e:
        print("Something went wrong when returning the sensor value")
        print(e)
        return -999

def send_telegram_message(message):
    """Sends message via Telegram"""
    url = "https://api.telegram.org/" + conf.telegram_bot_id + "/sendMessage"
    data = {
        "chat_id": conf.telegram_chat_id,
        "text": message
    }
    try:
        response = requests.request(
            "POST",
            url,
            params=data
        )
        print("This is the Telegram URL")
        print(url)
        print("This is the Telegram response")
        print(response.text)
        telegram_data = json.loads(response.text)
        return telegram_data["ok"]
    except Exception as e:
        print("An error occurred in sending the alert message via Telegram")
        print(e)
        return False


while True:
    # Step 1
    sensor_value = get_sensor_value_from_pin("A0")    
    print("The current sensor value is:", sensor_value)
    
    # Step 2
    if sensor_value == -999:
        print("Request was unsuccessfull. Skipping.")
        time.sleep(10)
        continue
    
    # Step 3
    if sensor_value > conf.max_value or sensor_value < conf.min_value:
        print("Sensor value is not in range")
        message = "Alert! Sensor value is not in range " + str(conf.min_value)+ "-"+ str(conf.min_value) + ". The current value is " + str(sensor_value)
        telegram_status = send_telegram_message(message)
        print("This is the Telegram status:", telegram_status)
	res = mybolt.digitalWrite('0', 'HIGH')
	
    else
	res = mybolt.digitalWrite('0', 'LOW')

    # Step 4
    time.sleep(10)

Credits

Valentina

1 project • 1 follower

Humidity sensing and alerting system using Bolt IoT

Things used in this project

Hardware components

Software apps and online services

Hand tools and fabrication machines

Story

1. INTRODUCTION

2. HARDWARE CONNECTIONS

5.1 BUZZER

6. Python O/P photo:

Schematics

Circuit

Code

Configuration file

Main code

Credits

Valentina

Comments

Embed the widget on your own site

Humidity sensing and alerting system using Bolt IoT

Humidity sensing and alerting system using Bolt IoT

Things used in this project

Hardware components

Software apps and online services

Hand tools and fabrication machines

Story

1. INTRODUCTION

2. HARDWARE CONNECTIONS

5.1 BUZZER

6. Python O/P photo:

Schematics

Circuit

Code

Configuration file

Main code

Credits

Valentina

Comments

Related channels and tags