Config explanation


Overview

(valid up to Esphome 2024.2)

Configuration prepared for boneIO ESP is very long. Thus a few years ago we decided to split it accross multiple files. It is simplier to read by user that way.

Unfortunately official Esphome addon is not prepared to read nested files. We recommend to you Visual Studio Code to edit configuration files of boneIO.

Below there is explanation for most of the main config parts.

Substitutions

Substitutions replace some values in boneIO config.

name_add_mac_suffix

This adds MAC suffix to boneIO name. If you have multiple boneIO in your network you might to try it out. It wasn’t working very well for use, so we decided to not set it to true by default.

node_name

By default it is boneio. You can rename it to whatever you want. Don’t use spaces, as it’s hostname of the device.

dir_name

This is directory where fonts of the OLED are present.

Packages

input

Those are possible input configs. So push buttons etc. Through years we developed several possibilites for input boards.

We can divide it between two circuits:

  • MCP
  • PCF.

As of 2023/2024 we use PCF parts only (for boneIO ESP.)

Then we prepared inputs to automatically switch different types of bottom boards:

  • 24 relay board
  • 32 relay board
  • cover board
  • cover mix board
  • dimmer_led8x4_inputs board (discontinued)

You want to uncomment bottom board you have eg input: !include boards/relay32_inputs_PCF.yaml and edit these according to your needs.

output

There are several output boards possibilites (similar to inputs). Using:

  • MCP
  • PCF
  • Mosfet (no relays there)

There are several types of outputs there:

  • 48 Mosfet
  • 32 outputs
  • 24 outputs
  • 16 covers
  • 8 covers and 16 outputs
  • monochromatic_lights (discontinued)

Choose the board you have. You can change entities from switch to light (you’d gonna need another section in the file you chose).

core

Never comment this out sections. This is definition of ESP32 chip.

internals

Never comment out this section.

Those are definitions of internal sensors inside boneIO ESP.

Time module if present ds1307, ina219, buzzer, pcf8574 for input board.

temp

Temperature LM75 component installed on boneIO board.

display

OLED Display in front of the boneIO ESP.

uart

Uncomment this and edit file if you want to connect modbus devices.

one_wire

Uncomment this if you want to use 1 wire protocol.