docs: add Home Assistant integration documentation and related images

docs.json

@@ -167,6 +167,7 @@
               "tr/projects/mediabox",
               "tr/projects/firewall",
               "tr/projects/hotspot",
+              "tr/projects/homeassistant",
               {
                 "group": "Teknofest",
                 "pages": [
@@ -339,6 +340,7 @@
               "en/projects/mediabox",
               "en/projects/firewall",
               "en/projects/hotspot",
+              "en/projects/homeassistant",
               {
                 "group": "Teknofest",
                 "pages": [

en/projects/homeassistant.mdx

@@ -0,0 +1,312 @@
+---
+title: 'Home Assistant'
+description: 'T3 Gemstone O1 Smart Home Hub Management System'
+---
+
+<Frame>
+    <img noZoom src="/images/homeassistant/homeassistant.png" alt="Home Assistant" />
+</Frame>
+
+<Tip>
+By the end of this section, you will have knowledge about the following topics:
+
+* **Home Assistant** smart home system installation on the T3 Gemstone O1 development board
+* Connecting sensors using the Deneyap Kart and providing home automation to develop smart home applications with this project
+</Tip>
+
+## 1. Introduction
+
+Today, controlling home automation data and securing smart devices is more important than ever. 
+You might want to manage your lighting, security cameras, smart plugs, and sensors in a centralized system 
+without depending on major cloud providers like Amazon, Google, Xiaomi, or Tuya. 
+To do this, you need to host your own smart home server on your own device and control your devices over your local network. 
+However, running such a hub in your home brings technical challenges: enabling communication between devices from different brands, 
+providing secure remote access from outside the world, and keeping the system continuously operational. 
+These problems are often solved with complex configurations and high-cost hardware. 
+The T3 Gemstone O1 development board, with its Home Assistant integration, provides an easy, cost-effective, and secure solution to these problems.
+
+
+## 2. Home Assistant Installation
+
+Home Assistant is an open-source smart home and automation platform. It offers features such as monitoring sensor data, controlling lights, plugs, and other devices, creating automated scenarios, and providing mobile access—all in a single system.
+
+After establishing a [terminal connection](/en/quickstart/#2-explore-gemstone) to the T3 Gemstone O1 development board, start the Docker installation with the following command:
+
+```bash
+sudo curl -fsSL https://get.docker.com | sudo sh
+```
+
+After the Docker installation is complete, you can install **Home Assistant**.
+
+```bash
+sudo apt install t3-gem-homeassistant
+```
+
+After the installation is complete, it may take 5-10 minutes for the Supervisor to download and start all services, depending on your internet speed. 
+You can monitor the status with the following command:
+
+```bash
+sudo docker logs -f hassio_supervisor
+```
+
+When you see that the `hassio_supervisor` and `homeassistant` services are in the `Up` (Running) state on the screen, you can access the interface from your browser:
+
+`http://gemstone.local:8123` or `http://<your-gemstone-ip-address>:8123`
+
+To access from outside your home, you can use the [Tailscale](/en/projects/cloud#3-external-access) network for which an installation guide is available, and securely connect to your system via your Tailscale IP address (`http://<tailscale-ip>:8123`).
+
+
+## 3. Accessing the Home Assistant Interface and Initial Setup
+
+Once the system services are active, when you first access the interface via your browser at `http://gemstone.local:8123` or 
+`http://<your-gemstone-ip-address>:8123`, Home Assistant will greet you with a setup wizard. 
+At this stage, you can create your administrator account and complete the basic configuration of your smart home. 
+You can easily complete the interface setup by following the images below:
+
+<Note>
+  If you encounter an error connecting to the interface, you can resolve it by changing `https://` in the address bar to `http://`.
+</Note>
+
+<Frame caption="Home Assistant Preparing Screen">
+  <img src="/images/homeassistant/en/preparation.png" alt="Preparing Screen" />
+</Frame>
+
+When you enter the address, you will see the Home Assistant preparing screen. The screen displays an estimated time.
+
+<Frame caption="Home Assistant Welcome Screen">
+  <img src="/images/homeassistant/en/welcome.png" alt="Welcome Screen" />
+</Frame>
+
+If you are setting up for the first time, you can proceed with the setup from the **Create my smart home** section. 
+If you have installed before and have backups, you can proceed with the options at the bottom.
+
+<Frame caption="Home Assistant User Creation Screen">
+  <img src="/images/homeassistant/en/user-creation.png" alt="User Creation" />
+</Frame>
+
+After entering your name, username, and password, click the **Create Account** button to create your account.
+
+<Frame caption="Home Assistant Home Location Selection Screen">
+  <img src="/images/homeassistant/en/home-location.png" alt="Home Location" />
+</Frame>
+
+You can select the location of your device, i.e., your **Home Location**.
+
+<Frame caption="Home Assistant Data Sharing Selection Screen">
+  <img src="/images/homeassistant/en/data-sharing.png" alt="Data Sharing" />
+</Frame>
+
+You need to give your consent for Home Assistant to use your data. You can continue with these settings enabled or disabled.
+
+<Frame caption="Home Assistant Main Screen">
+  <img src="/images/homeassistant/en/main.png" alt="Main Screen" />
+</Frame>
+
+Congratulations! You have successfully completed the setup steps and are now on the Home Assistant main screen. You can now freely configure the hub of your smart home on the T3 Gemstone O1 and start managing your devices.
+
+
+## 4. Sensor Integration with Deneyap Kart
+
+This section covers the steps for connecting a motion sensor to the Deneyap Kart 1A V2 development board and integrating this sensor into the Home Assistant platform.
+
+### 4.1 Installing ESPHome in Home Assistant
+
+<Frame caption="Home Assistant Main Screen">
+  <img src="/images/homeassistant/en/main.png" alt="Home Assistant Main Screen" />
+</Frame>
+
+After opening the menu on the left side, click on the Settings option.
+
+<Frame caption="Home Assistant Settings Section">
+  <img src="/images/homeassistant/en/settings.png" alt="Home Assistant Settings Section" />
+</Frame>
+
+From the opened menu, select the Add-ons option.
+
+<Frame caption="Home Assistant Settings Section">
+  <img src="/images/homeassistant/en/settings-2.png" alt="Home Assistant Add-ons Section" />
+</Frame>
+
+Click the "Install Add-on" button located in the bottom right corner.
+
+<Frame caption="Home Assistant Add-on Store">
+  <img src="/images/homeassistant/en/app-store.png" alt="Home Assistant Add-on Store" />
+</Frame>
+
+Type "esphome" in the search field in the opened menu.
+
+<Frame caption="Home Assistant Add-on Store Search Result">
+  <img src="/images/homeassistant/en/app-store-search.png" alt="Home Assistant Add-on Store Search Result" />
+</Frame>
+
+Click on the ESPHome option displayed in the search results.
+
+<Frame caption="Home Assistant ESPHome">
+  <img src="/images/homeassistant/en/esphome.png" alt="Home Assistant ESPHome" />
+</Frame>
+
+In the opened menu, click on the Install option and wait for the installation to complete.
+
+<Frame caption="Home Assistant ESPHome After Installation">
+  <img src="/images/homeassistant/en/esphome-installed.png" alt="Home Assistant ESPHome After Installation" />
+</Frame>
+
+After the installation is complete, click on the Start button in the displayed menu.
+
+<Frame caption="Home Assistant ESPHome After Installation">
+  <img src="/images/homeassistant/en/esphome-installed-2.png" alt="Home Assistant ESPHome After Installation" />
+</Frame>
+
+Click on the "Open Web UI" button.
+
+<Frame caption="ESPHome Welcome Screen">
+  <img src="/images/homeassistant/en/esphome-welcome.png" alt="ESPHome Welcome Screen" />
+</Frame>
+
+### 4.2 Configuring ESPHome for Deneyap Kart
+
+In the opened menu, click on the "Create Device" option.
+
+<Frame caption="ESPHome New Device Addition Screen">
+  <img src="/images/homeassistant/en/esphome-add-device.png" alt="ESPHome New Device Addition Screen" />
+</Frame>
+
+Click the "Create new project" button to continue.
+
+<Frame caption="ESPHome Device Configuration Screen">
+  <img src="/images/homeassistant/en/esphome-device-config.png" alt="ESPHome Device Configuration Screen" />
+</Frame>
+
+On the opened page, search according to the MCU model you will use.
+
+<Frame caption="ESPHome Device Configuration Screen">
+  <img src="/images/homeassistant/en/esphome-device-config-2.png" alt="ESPHome Device Configuration Screen" />
+</Frame>
+
+At this step, select the appropriate model.
+
+<Frame caption="ESPHome Device Type Selection Screen">
+  <img src="/images/homeassistant/en/esphome-device-name.png" alt="ESPHome Device Type Selection Screen" />
+</Frame>
+
+At this step, you need to assign a name to the board.
+
+<Frame caption="ESPHome Completing Device Configuration">
+  <img src="/images/homeassistant/en/esphome-device-wifi.png" alt="ESPHome Completing Device Configuration" />
+</Frame>
+
+At this step, enter your modem's SSID and password in the "Network Name" and "Password" fields.
+
+```yaml
+substitutions:
+  LED_PIN: GPIO48      # Onboard RGB LED
+  BUTTON_PIN: GPIO0    # Boot Button
+
+  # Pin Mappings
+  D0: GPIO1
+  D1: GPIO2
+  D4: GPIO42
+  D8: GPIO38
+  D9: GPIO48
+  D12: GPIO10
+  D13: GPIO3
+  D14: GPIO8
+  # I2C
+  SDA_PIN: GPIO47
+  SCL_PIN: GPIO21
+```
+Then, copy the **pin definitions** made in this section to the bottom of the YAML file.
+
+<Frame caption="Adding Sensor to ESPHome YAML File">
+  <img src="/images/homeassistant/en/esphome-add-sensor.png" alt="Adding Sensor to ESPHome YAML File" />
+</Frame>
+
+Since a motion sensor will be connected in this example, paste the following definitions at the bottom of the YAML file as shown above.
+
+```yaml
+binary_sensor:
+  - platform: gpio
+    pin: 
+      number: GPIO42
+      mode: INPUT
+      inverted: false
+    name: "PIR Sensor"
+    device_class: motion
+    filters:
+      - delayed_on: 1s
+```
+
+
+<Note>
+ The motion sensor is connected to the **D4 pin (GPIO42)**. If you connected it to a different pin, you need to update the **`number`** field accordingly. 
+ For the required pin assignments, you can refer to the [Deneyap Kart Pin Guide](https://docs.deneyapkart.org/en/Development_Boards) page.
+</Note>
+
+Click the "Install" button in the bottom right corner. This step completes the configuration.
+
+### 4.3 Uploading Software to Deneyap Kart for ESPHome
+
+<Frame caption="ESPHome Software Upload Options">
+  <img src="/images/homeassistant/en/esphome-flash-options.png" alt="ESPHome Software Upload Options" />
+</Frame>
+
+First, connect the **Deneyap Kart** to any USB port of your **T3 Gemstone O1** development board. 
+Various upload options will be displayed in the opened menu, but for the initial upload, you should select **"Plug into the computer running ESPHome Device Builder"**. 
+For subsequent uploads, you can perform wireless uploads.
+
+<Frame caption="ESPHome Software Upload">
+  <img src="/images/homeassistant/en/esphome-flashing.png" alt="ESPHome Software Upload" />
+</Frame>
+
+In the **Port selection** section, select the appropriate option from the list. If multiple ports are visible, the port that disappears and reappears when you unplug and replug the Deneyap Kart is the correct port.
+
+<Frame caption="ESPHome Software Upload Log Screen">
+  <img src="/images/homeassistant/en/esphome-flash-log.png" alt="ESPHome Software Upload Log Screen" />
+</Frame>
+
+Start the upload process. The first upload may take some time, so patience is recommended.
+
+<Frame caption="ESPHome Software Upload Log Screen">
+  <img src="/images/homeassistant/en/esphome-flash-log-2.png" alt="ESPHome Software Upload Log Screen" />
+</Frame>
+
+After the upload is complete, go to the ESPHome main screen and click on the "Logs" section. 
+In the opened menu, the "Wirelessly" option is now available.
+
+<Frame caption="Adding ESPHome Device">
+  <img src="/images/homeassistant/en/esphome-find.png" alt="Adding ESPHome Device" />
+</Frame>
+
+On **Home Assistant**, go to **Settings > Devices & Services > Add Integration** and click the "Add" button on the ESPHome device found there.
+
+<Frame caption="Adding ESPHome Device">
+  <img src="/images/homeassistant/en/esphome-add-device-homeassistant.png" alt="Adding ESPHome Device" />
+</Frame>
+
+At this stage, click the **Send** button that appears.
+
+<Frame caption="Adding ESPHome Device">
+  <img src="/images/homeassistant/en/esphome-homeassistant-name.png" alt="Adding ESPHome Device" />
+</Frame>
+
+At this step, give the board a name for Home Assistant. Then click the **Skip and Finish** button to continue.
+
+<Frame caption="ESPHome Devices">
+  <img src="/images/homeassistant/en/esphome-devices.png" alt="ESPHome Devices" />
+</Frame>
+
+Click on the **"1 device"** option under **ESPHome**.
+
+<Frame caption="ESPHome Device Details">
+  <img src="/images/homeassistant/en/esphome-device-details.png" alt="ESPHome Device Details" />
+</Frame>
+
+Congratulations! A motion sensor has been successfully integrated into the **Home Assistant** platform. The status of the added sensor can be viewed in real-time.
+
+## 5. Frequently Asked Questions
+
+**I get an "Unsupported System" warning after installation, why?**
+> This warning may appear when using an operating system other than Home Assistant OS or when there are other manually running services on the system (such as Nextcloud or Tailscale). It is not an obstacle to the stable operation of the smart home system; it is only for informational purposes.
+
+**When will the Add-on store appear?**
+> If you access the interface immediately after installation, the Add-ons menu may not be visible. The "Settings -> Add-ons" tab will automatically become active after the system completes the necessary configurations in the background (usually within 5-10 minutes).