<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "66b81165e60f8f169bd52a401b6a0f8b",
  "translation_date": "2025-08-26T22:30:02+00:00",
  "source_file": "2-farm/lessons/3-automated-plant-watering/pi-relay.md",
  "language_code": "mo"
}
-->
# 控制繼電器 - Raspberry Pi

在本課程中，您將在 Raspberry Pi 上添加一個繼電器，並根據土壤濕度的水平來控制它，除了土壤濕度傳感器之外。

## 硬體

Raspberry Pi 需要一個繼電器。

您將使用的是 [Grove 繼電器](https://www.seeedstudio.com/Grove-Relay.html)，這是一個常開型繼電器（意味著當沒有信號發送到繼電器時，輸出電路是開路或斷開的），可以處理高達 250V 和 10A 的輸出電路。

這是一個數位執行器，因此需要連接到 Grove Base Hat 上的數位引腳。

### 連接繼電器

Grove 繼電器可以連接到 Raspberry Pi。

#### 任務

連接繼電器。

![一個 Grove 繼電器](../../../../../translated_images/grove-relay.d426958ca210fbd0fb7983d7edc069d46c73a8b0a099d94797bd756f7b6bb6be.mo.png)

1. 將 Grove 電纜的一端插入繼電器上的插座。它只能以一種方式插入。

1. 在 Raspberry Pi 關機的情況下，將 Grove 電纜的另一端連接到 Pi 上 Grove Base Hat 上標記為 **D5** 的數位插座。這個插座位於 GPIO 引腳旁邊那排插座的第二個位置。保持土壤濕度傳感器連接到 **A0** 插座。

![Grove 繼電器連接到 D5 插座，土壤濕度傳感器連接到 A0 插座](../../../../../translated_images/pi-relay-and-soil-moisture-sensor.02f3198975b8c53e69ec716cd2719ce117700bd1fc933eaf93476c103c57939b.mo.png)

1. 如果土壤濕度傳感器還沒有插入土壤，請將其插入土壤中（如果是從上一課程中留下的，則可能已經插入）。

## 編程控制繼電器

現在可以編程 Raspberry Pi 來使用已連接的繼電器。

### 任務

編程設備。

1. 啟動 Raspberry Pi，並等待其啟動完成。

1. 在 VS Code 中打開上一課程中的 `soil-moisture-sensor` 專案（如果尚未打開）。您將在此專案中進行添加。

1. 在現有的匯入語句下方，將以下代碼添加到 `app.py` 文件中：

    ```python
    from grove.grove_relay import GroveRelay
    ```

    這段語句從 Grove Python 庫中匯入 `GroveRelay`，以便與 Grove 繼電器進行互動。

1. 在 `ADC` 類的聲明下方，添加以下代碼來創建一個 `GroveRelay` 實例：

    ```python
    relay = GroveRelay(5)
    ```

    這段代碼使用 **D5** 引腳（您連接繼電器的數位引腳）創建了一個繼電器。

1. 為了測試繼電器是否正常工作，將以下代碼添加到 `while True:` 迴圈中：

    ```python
    relay.on()
    time.sleep(.5)
    relay.off()
    ```

    這段代碼會打開繼電器，等待 0.5 秒，然後關閉繼電器。

1. 運行 Python 應用程式。繼電器將每 10 秒打開和關閉一次，打開和關閉之間有 0.5 秒的延遲。您會聽到繼電器的開啟和關閉聲音。當繼電器打開時，Grove 板上的 LED 會亮起，關閉時則熄滅。

    ![繼電器開啟和關閉](../../../../../images/relay-turn-on-off.gif)

## 根據土壤濕度控制繼電器

現在繼電器已經可以正常工作，您可以根據土壤濕度讀數來控制它。

### 任務

控制繼電器。

1. 刪除您為測試繼電器而添加的 3 行代碼。用以下代碼替換它們：

    ```python
    if soil_moisture > 450:
        print("Soil Moisture is too low, turning relay on.")
        relay.on()
    else:
        print("Soil Moisture is ok, turning relay off.")
        relay.off()
    ```

    這段代碼會檢查土壤濕度傳感器的讀數。如果讀數高於 450，則打開繼電器；如果低於 450，則關閉繼電器。

    > 💁 請記住，電容式土壤濕度傳感器的讀數越低，土壤中的濕度越高，反之亦然。

1. 運行 Python 應用程式。您將看到繼電器根據土壤濕度水平開啟或關閉。嘗試在乾燥的土壤中測試，然後添加水。

    ```output
    Soil Moisture: 638
    Soil Moisture is too low, turning relay on.
    Soil Moisture: 452
    Soil Moisture is too low, turning relay on.
    Soil Moisture: 347
    Soil Moisture is ok, turning relay off.
    ```

> 💁 您可以在 [code-relay/pi](../../../../../2-farm/lessons/3-automated-plant-watering/code-relay/pi) 資料夾中找到這段代碼。

😀 您的土壤濕度傳感器控制繼電器程式已成功完成！

---

**免責聲明**：  
本文件已使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。儘管我們努力確保翻譯的準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於關鍵信息，建議使用專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或誤釋不承擔責任。