boneIO Documentation
website·Indexed 32 days ago
https://boneio.euDocumentation for boneIO smart home hardware and software, including the Black, Edge, and ESP series. Covers system installation, release notes (up to v1.4.4), hardware guides for electrical cabinets, and integration with Home Assistant, including HACS, dashboards, and automations.
What's inside boneIO
- boneIO ESP controllers (including models such as ESP 32x10, 24x16, Cover, Cover Mix, Dimmer, and 8x10A) come preinstalled with ESPHome and a default configuration. To customize the device for specific requirements, users must modify the existing ESPHome configuration.
Overview of the boneIO Edge device family
boneIO Edge is a series of compact, intelligent peripheral devices designed for installation directly in rooms rather than inside distribution boards. They are intended to complement DIN rail-mounted controllers and provide precise data and control for smart home comfort and safety. The family includes devices utilizing Modbus, Wi-Fi, and CAN connectivity.Overview of boneIO Black Cover Mix capabilities
The boneIO Black Cover Mix is a versatile smart home controller based on the BeagleBone Black. It is designed to manage entire house automation, specifically combining general lighting control with specialized shutter/blind control. It features 49 digital inputs, 7 analog inputs, and 32 total relays. Of these relays, 16 are paired with hardware interlocks to protect and control 8 bidirectional motors (roller shutters), while the remaining 16 are individual 10A relays for general purposes like lighting.Overview of boneIO ESP Cover Mix outputs
The boneIO ESP Cover Mix features two distinct types of outputs:
- Cover Outputs (1-16): Eight pairs of relays designed to control up to 8 roller shutters or venetian blinds.
- Relay Outputs (17-32): Sixteen individual relays for general-purpose use, such as lights or switches.
Overview of boneIO ESP Controller Hardware and Software
boneIO ESP controllers (including models ESP 32x10, 24x16, Cover, Cover Mix, Dimmer, and 8x10A) come pre-installed with ESPHome and a default configuration. Users must adjust this configuration to meet their specific requirements.Overview of boneIO Black Series Hardware
The boneIO Black Series consists of several controller models. While all models share identical inputs, connection methods, and built-in buses, the output configuration and wiring are specific to each model. The available models are:
- Black 32x10A
- Black 24x16A
- Black Cover
- Black Cover Mix
Overview of Black Cover Mix configuration sections
The Settings tab is divided into several functional sections for device customization:
- Areas: Define areas compatible with Home Assistant.
- Outputs: Configure relay outputs.
- Covers: Configure covers and blinds.
- Inputs: Configure digital inputs.
- Events: Define events and automations.
- Binary Sensors: Configure binary sensors.
- Actions: Define specific actions.
Overview of Black 24x16a configuration sections
The Settings tab provides forms to configure the following controller functions:
- Areas: Define areas compatible with Home Assistant.
- Outputs: Configure relay outputs.
- Covers: Configure covers and blinds.
- Inputs: Configure digital inputs.
- Events: Define events and automations.
- Binary Sensors: Configure binary sensors.
- Actions: Define actions.
Overview of boneIO ESP controller configuration
boneIO ESP controllers (including models such as ESP 32x10, 24x16, Cover, Cover Mix, Dimmer, and 8x10A) come preinstalled with ESPHome and a default configuration. To customize the device for specific requirements, users must adjust the ESPHome configuration.Overview of boneIO ESP Series controllers
The boneIO ESP Series consists of various controllers preinstalled with ESPHome and a default configuration. These devices are designed for integration with systems like Home Assistant and require user configuration to match specific requirements. Supported models include:
- Large models: ESP 32x10A, ESP 24x16A, ESP Cover, ESP Cover Mix
- Small/Gen2 devices: Dimmer, ESP Dimmer gen2, ESP Input24 gen2, ESP 8x10A gen2
Overview of Home Assistant (HA) for smart home automation
Home Assistant (HA) is a free and open-source platform that serves as the central hub ("brain") for smart home systems. It enables the connection of devices from various manufacturers, including boneIO, and allows users to define advanced rules and automations across different hardware ecosystems.Overview of boneio Modbus helper
The Modbus helper is a built-in tool in boneio designed to read registers from connected Modbus devices and configure CWT sensors (such as setting the correct baudrate or updating the device address, as devices default to address 1). It must be run within the installed virtual environment.source ~/boneio/venv/bin/activate