Through Ethernet¶

Prerequisites:

Overview¶

In Esphome 2024.9 release Esphome introduced new way of communication between nodes using UDP broadcast.

More info of the component is available at Esphome documentation: https://esphome.io/components/udp

Instructions¶

Communication can go both way, let’s assume that we have 2 boneIO ESP. We want to share:

Both boneIO need to be on the same subnet. In case of different subnets see below example.

boneIO-1 config¶

In this guide we’d assume that we have config for both boneIO as follow. You’d need to remember name of the boneIO.

substitutions:
  name: boneio-32-l-07-abcdef
  friendly_name: boneIO-1
  serial_prefix: esp #Don't change it.

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: false
  project:
    name: boneio.32x10-lights
    version: '0.7'

boneIO-2 config¶

substitutions:
  name: boneio-32-l-07-ghijkl
  friendly_name: boneIO-2
  serial_prefix: esp #Don't change it.

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: false
  project:
    name: boneio.32x10-lights
    version: '0.7'

Add UDP section:¶

UDP section allows sending data with sensors or binary sensors data. By default it sends data to broadcast address 255.255.255.255.

Binary sensors section is section responsible for sending sensors to another device.

Providers section is responsible for receiving data from another device.

boneIO-1

udp:
  update_interval: 5s
  encryption: 'ENCRYPTION1KEY' #set it to yours shared secret key
  rolling_code_enable: true
  binary_sensors:
    - in_01
  providers:
    - name: boneio-32-l-07-ghijkl
      encryption: 'ENCRYPTION2KEY' #set it to yours shared secret key

boneIO-2

udp:
  update_interval: 5s
  encryption: 'ENCRYPTION2KEY' #set it to yours shared secret key
  rolling_code_enable: true
  binary_sensors:
    - in_02
  providers:
    - name: boneio-32-l-07-abcdef
      encryption: 'ENCRYPTION1KEY' #set it to yours shared secret key

Add binary sensor section¶

Now let’s import binary sensors of another node:

boneIO-1

This imports sensor from boneIO-2

binary_sensor:
  - platform: udp
    provider: boneio-32-l-07-ghijkl
    id: ghijkl_in_02 #OR CHANGE TO SOMETHING MORE SUITABLE FOR YOU
    remote_id: in_02
    on_press:
      - light.toggle: light_01

boneIO-2

This imports sensor from boneIO-1

binary_sensor:
  - platform: udp
    provider: boneio-32-l-07-abcdef
    id: abcdef_in_01 #OR CHANGE TO SOMETHING MORE SUITABLE FOR YOU
    remote_id: in_01
    on_press:
      - light.toggle: light_01

Full config of both¶

Remember that you can’t duplicate sections, so add udp platform to your existing binary sensors. Don’t create new one!

boneIO-1¶

substitutions:
  name: boneio-32-l-07-abcdef
  friendly_name: boneIO-1
  serial_prefix: esp #Don't change it.

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: false
  project:
    name: boneio.32x10-lights
    version: '0.7'

udp:
  update_interval: 5s
  encryption: 'ENCRYPTION1KEY' #set it to yours shared secret key
  rolling_code_enable: true
  binary_sensors:
    - in_01
  providers:
    - name: boneio-32-l-07-ghijkl
      encryption: 'ENCRYPTION2KEY' #set it to yours shared secret key

binary_sensor:
  - platform: udp
    provider: boneio-32-l-07-ghijkl
    id: ghijkl_in_02 #OR CHANGE TO SOMETHING MORE SUITABLE FOR YOU
    remote_id: in_02
    on_press:
      - light.toggle: light_01

boneIO-2¶

substitutions:
  name: boneio-32-l-07-ghijkl
  friendly_name: boneIO-2
  serial_prefix: esp #Don't change it.

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: false
  project:
    name: boneio.32x10-lights
    version: '0.7'

udp:
  update_interval: 5s
  encryption: 'ENCRYPTION2KEY' #set it to yours shared secret key
  rolling_code_enable: true
  binary_sensors:
    - in_02
  providers:
    - name: boneio-32-l-07-abcdef
      encryption: 'ENCRYPTION1KEY' #set it to yours shared secret key

binary_sensor:
  - platform: udp
    provider: boneio-32-l-07-abcdef
    id: abcdef_in_01 #OR CHANGE TO SOMETHING MORE SUITABLE FOR YOU
    remote_id: in_01
    on_press:
      - light.toggle: light_01

Different subnets¶

If you have your boneIO on different subnets then you’d need set addresses to which send data of the udp component. You can set data to many nodes on your network!

udp:
  update_interval: 5s
  encryption: 'ENCRYPTION1KEY' #set it to yours shared secret key
  rolling_code_enable: true
  addresses: ['192.168.1.10']
  binary_sensors:
    - in_01

Installation¶

After modifying your config click install on both boneIO, then choose Wirelessly and wait for both to finish.