Tilt detection using KY-20 tilt switch module

The EzloPi smart devices provide automation through simple, customizable use with our open-source EzloPi platform, making daily life easier and improving human-machine interactions.

Before moving into this example, it is very important to know about the device registration, provisioning and converting the ESP32 device into an EzloPi device along with knowledge of Web Flasher, MiOS Mobile Application for Android/iOS and the MiOS Web Application.

The following project aims to interface the KY-20 tilt switch module with the EzloPi device to detect orientation changes. The KY-20 module is a simple tilt sensor which reacts to tilt movements. The EzloPi device reads the digital signal from the KY-20 module and executes predefined actions which the user has set based on the tilt status. This project setup can be used for applications like motion detection, security systems, and automatic device shutdowns in case of abnormal tilts. The project involves wiring the components, configuring the EzloPi device to interpret the tilt sensor's output, handle the sensor’s data and trigger appropriate responses.

Welcome to the project demonstration video section. The following video showcases the key aspects of Tilt detection using KY-20 tilt switch module, providing a visual walkthrough of its implementation.

The following components are required for interfacing with the EzloPi device:

• ESP32 as an EzloPi smart device.
• KY-020 Tilt switch module.

The wiring diagram of ESP32 30 pin is represented as follows:

The following connections are made in order to complete the circuit setup:

From ESP32 to KY-020:

1. Set up your device/hardware by visiting config.ezlopi.com

2. Log in using the credentials which you just set earlier while signing up.

3. Now, click on the Connect Device button and a pop-up window will appear.

4. Now, select COM Port to which your ESP32 device is connected. In our case, the COM3 port is used.

Click Connect

5. If you are new to this and it's your first time configuring, select Create new Device ID. Enter Wifi SSID and Wifi Password.
6. In the Device Configuration, tab click on Digital Input.

8. The Digital Input window will open for inputting the following parameters:

• Set a Device name of your choosing. In our case, we set it to the Tilt Switch.
• Set Device Subtype to Digital In Switch / Button / Key.
• Set Resistor to PULL DOWN.
• Now, Click the Apply button.
• After clicking the apply button you can see a table of your setting in the device configuration tab.
• Press the Flash Device button.

9. A window will appear on the bottom right side of the screen displaying “Please press BOOT button while flashing begins.”

10. Hold the BOOT button down until the next window appears on the bottom right side of the screen which says “Installation prepared. Please release the boot button now.”

11. Release the BOOT button from your ESP32 when this pop-up on the bottom right window appears.

12. After some time, a popup will appear saying Device Flashed Successfully! This means that your device has been set up successfully.

You can download the MIOS Android app from the Google Play Store and Apple App Store.

1. After downloading the app, proceed to install the application and open it.

2. Using the MIOS mobile application, create a new Ezlo Cloud account using the sign-up option. If you already have an account, you may proceed to log in.

3. After successfully logging in, you will be able to see the number of controllers connected such as a lamp, fan, or any other device in the MiOS app. Tap on any controller of your desired ID:

4. You will be able to see the status of your controller whether it is online or offline. Access the device dashboard, and tap the device. The following view of the dashboard will appear:
5. After opening the MiOS mobile dashboard, you will be able to see the tile of your connected device.

6. As you can see in the MiOS mobile dashboard, we can see the tilt switch tile. When the KY-020 module does not get tilted, the tile will display the "off” message as shown in the above image.

6. Similarly, when the KY-020 gets a tilt signal, the tile will display the “On” message as depicted in the above image.

1. After configuring the controller with the EzloPi web flasher, head to ezlogic.mios.com

2. Use the same credentials to log in that you used for configuring the controller with the web flasher.

3. As you can see in the MiOS web dashboard, we can see the tilt switch tile. When the KY-020 module does not get tilted, the tile will display the "off” message as shown in the above image.

MeshBots:

4. Similarly, when the KY-020 gets a tilt signal, the tile will display the “On” message as depicted in the above image.