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

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

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release
page	Modbus	Instructions how to integrate Modbus within Home Assistant.	2015-04-25 9:16	true	false	true	true	modbus.png	Hub	pre 0.7

Modbus is a serial communication protocol to control PLCs (Programmable logic controller). It currently supports sensors and switches which can be controlled over serial, TCP, and UDP connections.

To add modbus to your installation, add the following to your configuration.yaml file:

For a network connection:

#Modbus TCP
modbus:
  type: tcp
  host: IP_ADDRESS
  port: 2020

Configuration variables:

• type (Required): Type of the connection to Modebus.
• host (Required): The IP address of your router, eg. 192.168.1.1.
• port (Required): The port for the comminication.

For a serial connection:

# Example configuration.yaml entry
modbus:
  type: serial
  method: rtu
  port: /dev/ttyUSB0
  baudrate: 9600
  stopbits: 1
  bytesize: 8
  parity: N

Configuration variables:

• type (Required): Type of the connection to Modebus.
• method (Required): Method of the connection to Modbus.
• port (Required): The port where your Modbus device is connected to your Home Assistant host.
• baudrate (Required): The speed for the serial connection.
• stopbits (Required): The stopbits for the serial connection.
• bytesize (Required): The bytesize for the serial connection.
• parity (Required): The parity for the serial connection.

{% linkable_title Building on top of Modbus %}

• Modbus Sensor
• Modbus Switch