https://github.com/unreal4u/rpi3-magnetic-switch

Code for the service that reads out a magnetic switch and turns on a relay
https://github.com/unreal4u/rpi3-magnetic-switch

iot mqtt rpi3

Last synced: about 1 month ago
JSON representation

Code for the service that reads out a magnetic switch and turns on a relay

• Host: GitHub
• URL: https://github.com/unreal4u/rpi3-magnetic-switch
• Owner: unreal4u
• Created: 2019-02-14T22:13:04.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2019-03-11T23:07:40.000Z (almost 6 years ago)
• Last Synced: 2024-11-09T13:46:44.567Z (3 months ago)
• Topics: iot, mqtt, rpi3
• Language: PHP
• Size: 270 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Raspberry Pi 3 Magnetic Switch + relay controller

===========

This pure PHP implementation will read out a magnetic switch and depending on the input, it will control a relay,

allowing for a light to be turned on or off.

The idea is that the light will turn on ASAP when the door is opened, and will turn the lights off with a configurable

timer when the door has been closed.

It will additionally inform a MQTT broker of the sensors and commands that are being sent.

Used materials

--------

The materials used for this build are the following:

* [Magnetic switch](https://www.aliexpress.com/item/Free-Shipping-5-pcs-MC-38-MC38-Wired-Door-Window-Sensor-Magnetic-Switch-Home-Alarm-System/32255881055.html?spm=a2g0s.9042311.0.0.27424c4dj3ALXd)

* [Relay](https://www.aliexpress.com/item/Freeshipping-New-5V-2-Channel-Relay-Module-Shield-for-Arduino/1726504761.html?spm=a2g0s.9042311.0.0.27424c4dkd67Cr)

* Raspberry Pi 3b+ (Although any old rPi should be able to handle this program)

Schematics

--------

The general connections are made using the following diagram:

![Connections diagram](/magnetic-switch-kelder-schematics.png)

**Disclaimer**: Please ignore any errors in above drawing, I'm not an electrician. That being said, above diagram is

used to control devices dealing with AC voltage, if you don't even know what "AC" means, DO NOT use this guide and hire

somebody that knows about it!

[AC voltages *CAN* kill you!](https://www.youtube.com/watch?v=trmxzUVT2eE)  

[You don't believe me?](https://www.youtube.com/watch?v=snk3C4m44SY)

Pin layout is based on this diagram:

![GPIO pin diagram](/rpi3-gpio-pins.png)

How to run the program

--------

This program consists of 2 scripts: one that primarily checks out what the status of the door is and opens up the relay,

while the other implements only a timer and will turn the relay down after the door has been closed.

It uses standard symfony components to achieve this. In the case of this program, calling the following script will

start the program:

`sudo bin/console baseroom:door-sensor`

If you want to make it a cronjob, put the following line in your crontab:

`*/2 * * * * sudo [ABSOLUTE_PATH_TO_APPLICATION]/bin/console readDoorSensor`

This script is run with sudo because it needs access to the GPIO. There might be more elegant ways to solve this issue,

but this one is the first one that came up to me and it works.

Other information

--------

Check out [PHP/GPIO](https://github.com/PiPHP/GPIO), without that repo, this would be impossible in its current form.