.. note::

    ¡Hola! Bienvenido a la Comunidad de Entusiastas de SunFounder Raspberry Pi, Arduino y ESP32 en Facebook. Sumérgete más en Raspberry Pi, Arduino y ESP32 con otros entusiastas.

    **¿Por qué unirse?**

    - **Soporte Experto**: Resuelve problemas post-venta y desafíos técnicos con la ayuda de nuestra comunidad y equipo.
    - **Aprender y Compartir**: Intercambia consejos y tutoriales para mejorar tus habilidades.
    - **Avances Exclusivos**: Obtén acceso anticipado a nuevos anuncios de productos y vistas previas.
    - **Descuentos Especiales**: Disfruta de descuentos exclusivos en nuestros productos más nuevos.
    - **Promociones Festivas y Sorteos**: Participa en sorteos y promociones de temporada.

    👉 ¿Listo para explorar y crear con nosotros? Haz clic en [|link_sf_facebook|] y únete hoy mismo!

.. _1.3.3_py:

1.3.3 Relé
===========

Introducción
------------

En este proyecto, aprenderemos a usar un relé. Es uno de los componentes más 
comúnmente utilizados en los sistemas de control automático. Cuando el voltaje, 
corriente, temperatura, presión, etc., alcanza, excede o está por debajo del 
valor predeterminado, el relé conectará o interrumpirá el circuito, para controlar 
y proteger el equipo.

Componentes Requeridos
----------------------------

En este proyecto, necesitamos los siguientes componentes.

.. image:: ../img/list_1.3.4.png

Es definitivamente conveniente comprar un kit completo, aquí está el enlace:

.. list-table::
    :widths: 20 20 20
    :header-rows: 1

    *   - Nombre
        - ELEMENTOS EN ESTE KIT
        - ENLACE
    *   - Kit Raphael
        - 337
        - |link_Raphael_kit|

También puedes comprarlos por separado en los enlaces a continuación.

.. list-table::
    :widths: 30 20
    :header-rows: 1

    *   - INTRODUCCIÓN DEL COMPONENTE
        - ENLACE DE COMPRA

    *   - :ref:`cpn_gpio_board`
        - |link_gpio_board_buy|
    *   - :ref:`cpn_breadboard`
        - |link_breadboard_buy|
    *   - :ref:`cpn_wires`
        - |link_wires_buy|
    *   - :ref:`cpn_resistor`
        - |link_resistor_buy|
    *   - :ref:`cpn_led`
        - |link_led_buy|
    *   - :ref:`cpn_transistor`
        - |link_transistor_buy|
    *   - :ref:`cpn_relay`
        - |link_relay_buy|
    *   - :ref:`cpn_diode`
        - |link_diode_buy|

Diagrama Esquemático
---------------------------

.. image:: ../img/image345.png


Procedimientos Experimentales
------------------------------------

**Paso 1:** Monta el circuito.

.. image:: ../img/image144.png

**Paso 2:** Abre el archivo de código.

.. raw:: html

   <run></run>

.. code-block::

    cd ~/raphael-kit/python

**Paso 3:** Ejecuta.

.. raw:: html

   <run></run>

.. code-block::

    sudo python3 1.3.3_Relay.py

Mientras el código se está ejecutando, el LED se enciende. Además, puedes 
escuchar un tic-tac causado por la ruptura del contacto normalmente cerrado 
y el cierre del contacto normalmente abierto.


**Código**

.. note::

    Puedes **Modificar/Resetear/Copiar/Ejecutar/Detener** el código a continuación. Pero antes de eso, necesitas ir a la ruta del código fuente como ``raphael-kit/python``. Después de modificar el código, puedes ejecutarlo directamente para ver el efecto.

.. raw:: html

    <run></run>

.. code-block:: python

    #!/usr/bin/env python3

    import RPi.GPIO as GPIO
    import time

    # Configurar GPIO17 como pin de control
    relayPin = 17

    # Definir una función de configuración para algunas configuraciones
    def setup():
        # Configurar los modos GPIO a numeración BCM
        GPIO.setmode(GPIO.BCM)
        # Configurar el modo de relayPin como salida,
        # y nivel inicial a Alto (3.3v)
        GPIO.setup(relayPin, GPIO.OUT, initial=GPIO.HIGH)

    # Definir una función principal para el proceso principal
    def main():
        while True:
            print ('Relay open...')
            # Tick
            GPIO.output(relayPin, GPIO.LOW)
            time.sleep(1)
            print ('...Relay close')
            # Tock
            GPIO.output(relayPin, GPIO.HIGH)
            time.sleep(1)

    # Definir una función destroy para limpiar todo después de
    # que el script haya terminado
    def destroy():
        # Apagar LED
        GPIO.output(relayPin, GPIO.HIGH)
        # Liberar recursos
        GPIO.cleanup()                    

    # Si ejecutas este script directamente, haz:
    if __name__ == '__main__':
        setup()
        try:
            main()
        # Cuando se presiona 'Ctrl+C', el programa hijo
        # destroy() será ejecutado.
        except KeyboardInterrupt:
            destroy()

**Explicación del Código**

.. code-block:: python

    GPIO.output(relayPin, GPIO.LOW)

Configura los pines del transistor a nivel bajo para abrir el relé, el LED no se enciende.

.. code-block:: python

    time.sleep(1)

Espera 1 segundo. 

.. code-block:: python

    GPIO.output(relayPin, GPIO.HIGH)

Configura los pines del transistor a nivel alto para activar el relé, el LED se enciende.

Imagen del Fenómeno
-------------------------

.. image:: ../img/image145.jpeg