home-assistant.io/source/_components/switch.modbus.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category
page	Modbus Switch	Instructions how to integrate Modbus switches into Home Assistant.	2015-08-30 23:38	true	false	true	true	modbus.png	Switch

The modbus switch platform allows you to control Modbus switches.

To use your Modbus switches in your installation, add the following to your configuration.yaml file:

# Example configuration.yml entry
switch:
  platform: modbus
  slave: 1
  registers:
    24:
      bits:
        0:
          name: My switch
        2:
          name: My other switch
  coils:
    0:
      name: My coil switch

Configuration variables:

• slave (Required): The number of the slave (ignored and can be omitted if not serial Modbus).
• registers array (Required): The array contains a list of relevant registers to read from.
  • number of register (Required): Listing relevant bits. It must contain a bits section.
    • bits array (Required): Listing relevant bits. It must contain a bits section.
      • name (Required): Name of the switch.
• coils (Optional): A list of relevant coils to read from/write to
  • number of coil array (Required):
    • name (Required): Name of the coil.

Each named bit will create a switch.