Grove TB6612FNG Motor Drive
===========================

.. seo::
    :description: Instructions for setting up Grove TB6612FNG Motor Driver  in ESPHome.
    :image: grove_tb6612fng.jpg

The Grove TBB6612FNG a runs over  I²C bus and has the capability to control DC and Stepper motors.
At the current stage of implementation only DC motor is implemented.

.. figure:: images/grove_tb6612fng.jpg
    :align: center
    :width: 50.0%

.. code-block:: yaml

    # Example configuration grove motor
    grove_tb6612fng:
        id: test_motor
        name: motor_outside
        address: 0x14

    # Example switch trigger
    switch:
      - platform: template
        name: open_vent
        id: open_vent
        optimistic: True
        on_turn_on:
          then:
            - grove_tb6612fng.run:
                channel: 1
                speed: 255
                direction: BACKWARD
                id: test_motor
            - delay: 10s
            - switch.turn_on: stop_motor
            - switch.turn_off:  open_vent

Configuration variables:
************************

- **id** (**Required**, :ref:`config-id`): The id to use for this TB6612FNG component.
- **address** (*Optional*, int): The I²C address of the driver.
  Defaults to ``0x14``.
- **name** (*Required*, boolean): The name of the component

.. grove_tb6612fng.run:

``grove_tb6612fng.run`` Action
------------------------------------

Set the motor to spin by defining the direction and speed of the rotation, speed is a range from 0 to 255

.. code-block:: yaml

    on_...:
      then:
        - grove_tb6612fng.run:
            channel: 1
            speed: 255
            direction: BACKWARD
            id: test_motor


.. grove_tb6612fng.stop:


``grove_tb6612fng.stop`` Action
-------------------------------------

Set the motor to stop motion but wont stop to spin in case there is a force pulling down, you would want to use break action if this is your case

.. code-block:: yaml

    on_...:
      then:
        - grove_tb6612fng.stop:
            channel: 1



.. grove_tb6612fng.break:


``grove_tb6612fng.break`` Action
--------------------------------------

Set the motor channel to be on break mode which it ensure the wheel wont spin even if forced or pushed

.. code-block:: yaml

    on_...:
      then:
        - grove_tb6612fng.break:
            channel: 1
            id: test_motor

.. grove_tb6612fng.standby:

``grove_tb6612fng.standby`` Action
----------------------------------

Set the board to be on standby when is not used for a long time which reduces power consumptions and any jerking motion when stationary

.. code-block:: yaml

    on_...:
      then:
        - grove_tb6612fng.standby
            id: test_motor

.. grove_tb6612fng.no_standby:

``grove_tb6612fng.no_standby`` Action
-------------------------------------

Set the board to be awake, every esphome is restarted the default mode is set to standby to ensure the motor wont spin accidentally

.. code-block:: yaml

    on_...:
      then:
        - grove_tb6612fng.no_standby
            id: test_motor


See Also
--------

- :ref:`i2c`
- :doc:`switch/gpio`
- :ghedit:`Edit`