102 lines
3.7 KiB
Markdown
102 lines
3.7 KiB
Markdown
<!-- devre sema ekle -->
|
|
## 👀 esp32_home-assistant_telegram-bot 2nd Generation Overview
|
|
<h1 align="center">Home Assistant controlled by telegram bot</h1>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- sensorlu devre semasi -->
|
|
|
|
## 🚀 Features
|
|
<h1 align="center">The design aims to provide real-time control and monitoring by leveraging a Telegram bot to verify collected data. This core functionality is extended to enable immediate awareness through voice notifications delivered directly via both the user's mobile device and the home system.</h1>
|
|
|
|
|
|
## 🔎 Preparation
|
|
<details>
|
|
<summary>1. Components</summary>
|
|
'1' ESP32-CAM<br>
|
|
'1' Flammable gas sensor (MQ-2)<br>
|
|
'1' Temperature and humidity sensor (DHT11)<br>
|
|
'1' Motion sensor (PIR Sensor Hc-Sr501)<br>
|
|
'1' 5V Active Buzzer<br>
|
|
'1' Breadboard Power Supply Module (Mb102)
|
|
</details>
|
|
|
|
2. `Find your wifi's name and password`
|
|
<details>
|
|
<summary>3. Open the Telegram for the Bot Token and follow these steps:</summary>
|
|
|
|
1. Open Telegram and search for `@BotFather`.
|
|
2. Start a chat with BotFather by typing `/start`.
|
|
3. Create a new bot with the `/newbot` command.
|
|
4. Follow the prompts to name your bot and choose a username.
|
|
5. Copy the API token provided by BotFather.
|
|
|
|
</details>
|
|
<details>
|
|
<summary>4. Get your Telegram Chat ID:</summary>
|
|
|
|
1. Open Telegram and search for `@userinfobot` or `@get_id_bot`.
|
|
2. Start a chat with the bot by typing `/start`.
|
|
3. The bot will reply with your **numeric user ID**.
|
|
4. For group chat ID:
|
|
1. Add your bot to the group.
|
|
2. Send a message in the group mentioning the bot.
|
|
3. Use the API call:
|
|
```
|
|
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
|
|
```
|
|
- Look for `"chat":{"id": ...}` in the JSON response.
|
|
- The `chat.id` is your group chat ID (usually negative for groups, e.g., `-1001234567890`).
|
|
|
|
</details>
|
|
|
|
|
|
## 📦 Setup
|
|
1. `Refer to the circuit diagram`
|
|
2. `Install the 'Arduino IDE' software and open 'esp32_home-assistan_telegram.ino' file`
|
|
3. `Paste your wifi, bot token and chat id inf.`
|
|
4. `File>Preferences>Additional Boards Manager URLs:(Click the double window button)`
|
|
>Paste this code
|
|
```bash
|
|
https://dl.espressif.com/dl/package_esp32_index.json
|
|
```
|
|
5. `Click 'OK'`
|
|
6. `Tools>Board>Boards Manager...`
|
|
7. `Search 'esp32' by Espressif Systems, and install it`
|
|
> ⚠️ **Warning:** Make sure you have installed the correct USB driver (CH340, CH341, FT232R / FTDI Driver, CP2102) before connecting the ESP32CAM to your computer.
|
|
8. `Plug the ESP32CAM into your computer`
|
|
9. `Tools>Board>esp32>'ESP32 Wrover Module'`
|
|
<details>
|
|
<summary>Apply these changes:</summary>
|
|
|
|
- Core Debug Level: None
|
|
- Erase All Flash Before Sketch Upload: Disabled
|
|
- Flash Frequency: 80MHz
|
|
- Flash Mode: QIO
|
|
- Partition Scheme: Huge APP (3MB No OTA/1MB SPIFFS)
|
|
- Upload Speed: 115200
|
|
- *115200 baud*
|
|
|
|
</details>
|
|
|
|
10. `Tools>Port>'Select the esp's port'`
|
|
11. `Tools>Manage Libraries...>Install the libraries used in the code`
|
|
12. `Click the 'upload ➡️' button`
|
|
✅ **To make sure it has been uploaded successfully, you should see the message 'Done uploading'**
|
|
|
|
|
|
## 🎉 Run
|
|
1. `Disconnect the IO0-GND connection(disable programming mode)`
|
|
2. `Press the reset button on the esp32cam`
|
|
3. `You are ready to use '/start' command in your telegram bot`
|
|
|
|
`You can explore more projects in my`[`projects page`](https://furk4ngg.me/projects)
|
|
|
|
## 🔒 License
|
|
<h1 align="center">📜 GPL-3.0 License</h1>
|