What's new in the application?

On this subpage, you will find all the information regarding new versions of the application as well as the changes occurring within them.

boneIO Black v1.3.1 Release Notes - Newest release

Maintenance release focused on stability, type safety, and Home Assistant integration improvements.

✨ New Features

🔧 Support for legacy 0.2 / 0.3 boards — added device definitions for older boneIO Black hardware revisions
🏠 HA Update entity changed to binary sensor — firmware update entity is now a binary sensor for cleaner HA integration

🐛 Bug Fixes

Cover position precision — fixed inconsistent float/int conversion in cover position calculations, eliminating rounding drift during movement
Cover timestamp tracking — fixed incorrect timestamps in cover state updates
HA discovery device_class — fixed null device_class in Home Assistant autodiscovery by storing it directly on the input object
HA Update entity state during firmware restart — update entity now correctly shows 'Updating' state during firmware restart instead of going offline
Event form click handling — fixed click event handling in the WebUI event configuration form

♻️ Refactoring

Unified device_class — refactored device_class to be a single source of truth on the input object (GpioBaseClass)
Removed gpio_mode — deprecated gpio_mode setting, now handled by kernel overlay
Removed CAN System settings — CAN configuration migrated to system migrations, manual settings no longer needed
Type safety improvements — fixed multiple type checker issues across the codebase

⚠️ Duplicate Entity Fix in Home Assistant

If you see duplicated entities for your boneIO Black device in Home Assistant after updating:

Go to Home Assistant → Settings → Devices & Services → Devices tab
Enter Selection Mode, select the boneIO Black devices with duplicated entities, and delete them
Open the boneIO controller's WebUI → Settings → Communication Protocols → MQTT tab
Click "Delete and resend HA Discovery"

This will cleanly re-register all entities without duplicates.

🚀 Upgrade Instructions

Use the WebUI auto-update — navigate to System Update and click "Update"
Or via SSH: pip install --upgrade boneio==1.3.1
Restart the application

boneIO Black v1.3.0

Spring release — packed with new features, protocol support, and a complete WebUI overhaul!

✨ New Features

🌿 Multi-zone irrigation controller — schedules, per-zone intervals, water source management, master valve support, and a full dashboard UI with real-time zone countdown. All controlled also from Home Assistant!
🎛️ Conditional actions — time ranges, date ranges, and entity state conditions with AND/OR logic. Actions fire only when conditions are met
🎛️ Each output now has individual action capabilities — fine-grained control over what each output can do
📊 Live graphs added to the WebUI dashboard for real-time data visualization
📊 Simple history view for sensors — see past values at a glance
⏱️ Timed output with HA input — change the timer value directly from Home Assistant, no YAML restart needed
🔌 LoxUDP protocol — initial integration for Lox UDP communication
🔌 CANOpen protocol — initial support for CAN bus industrial devices
🏠 Experimental ha_child_devices mode for HA discovery — organize entities as child devices
🏠 Output groups visible in HA — output groups are now exposed to Home Assistant with their member outputs, so you can see which outputs belong to each group
🏠 Entity category reorganization — entities moved into proper HA categories (diagnostic, config) for a cleaner HA UI
🏠 Republish states on MQTT autodiscovery resend — ensures HA always has the latest state after reconnects
🔧 48×4A legacy board support — added device type for older 48-output / 4A boards
🔧 Tilt support for remote devices — venetian blinds on remote boneIO devices now support tilt actions
📦 Modbus entity naming — custom entity names for Modbus devices
📦 Temperature sensor rounding — configurable decimal rounding for temperature readings
📦 Serial number in backup filenames — easier identification of backup files across multiple devices

🐛 Bug Fixes

OLED refresh interval — fixed display refresh timing causing stale or flickering content
Modbus WebUI loading time — significantly reduced initial load time of Modbus device view
Modbus communication isolation — other Modbus traffic is now blocked while using WebUI tools, preventing bus conflicts

♻️ UI / UX Improvements *Hundreds of UI fixes across the entire WebUI — padding consistency, card styling, shadow standardization, responsive layout improvements

System Settings overhaul — redesigned Current Version, Available Versions, App Permissions, CAN Permissions, and Migrations sections
Migrations table — professional table layout with descriptions, status badges, and GitHub source links

boneIO Black v1.2.0

A lot of new features!

possibility to register boneIO Black in boneio.app domain
with that possible to install boneIO Black as PWA app!
redesigned logger to easier find bugs
add I2C scanner in webui tools
add support for more remote devices: WLED presets, WLED brightness,
add GET/POST /api/log-level endpoints for temporary runtime debug toggle
add sortable columns to UISettings tables
add smart toggle option for covers
add cycle option to long click, so you can cycle across presets, brightness etc while holding button
add new templates! Alarm Panel and Thermostat
add possibility to backup boneIO Black from boneIO Black Dashboard
prepare boneIO Black for boneIO Edge Temp & Humidity sensor *mobile improvements for Settings sidebar and RemoteDeviceTable *add possibility to shutdown system from OLED + button control!

Bug fixes:

Cross-debounce: ignore release too close to press
fix version comparision dev vs non-dev version
add Modbus inter-device delay and timeout config

boneIO Black v1.1.0

add LWE03MW and CT F&F energy meters
add N4DSC08 temperature RS485 board
fix modbus device liquid -sensor extra data inputs
add support for 32x5A config in boneio.
add firmware update manager with GitHub release checking and Home Assistant integration
fix binary sensor loading into HA
add initial WLED control support
fix time parsing in UI
add duration time every 200ms for long click
add modbus creator helper tool
add new Ultrasonic distance sensor
fix webui authentication

boneIO Black v1.0.0

It's finally ready. Almost 10 months of our work!

This app is almost rewritten from scrach. The app need special prepared Debian13 by boneIO. It has device tree prepared for boneIO Black.

This version will work only on Debian 13. Versions 0.x won't work on Debian13!

Breaking changes:

new option name for entities which can contain any character
id is now lowercase, no spaces, it is generated automatically from device perspective (eg device_id_input_id - boneio_in03)
change pin option to boneio_output or boneio_cover in actions
topic prefix is no more configurable from settings! It's hardcoded as serial number Changelog:
new modular managers of the app, which can reload it's parts without restarting the app
libgpiod support for inputs *new i2c driver
new rewritten input module
new One wire module
new Modbus module
new cover module
new events module
new webui with clickable Settings from User Interface! Almost no more yaml! If boneio: section is present.
rewritten output group
new modbus searcher function from webui
new options for virtual sensors
add option to provide NodeRed via nginx proxy (port 8443)
change pin option to boneio_output or boneio_cover in actions
add ability to change Mosquitto password from webui
start even with bad MCP
add option to manage areas from Black UI
add option to change hostname from webui
switch from nginx to caddy proxy and let's host https (unsecure)
add new actions for event entities: triple click and sequence actions! double_then_long, single_then_long, double_then_single
add autodiscovery of other boneio black's
show toast in inputs when something is clicked
add ability to control other Esphome devices in network (light, switch, cover)
add support for older 0.2 boards
add option to go to entity setting if long clicked in Card
add triple click and possibility to send sequences to mqtt
add backup to disk
add option to revert firmware via UI

🙏 Acknowledgments

Thank you to all users who provided feedback and bug reports during the development cycle!

📞 Support

Documentation: https://boneio.eu/docs/black
GitHub Issues: https://github.com/boneIO-eu/app_black/issues
Community: Join our Discord server

Release Notes

On this page