Firmware Installation and Reset
Learn how to install or reset the firmware on your boneIO ESP controller in a few simple steps using the web installer.
Firmware is the operating system of your boneIO controller. Thanks to our modern web installer, uploading or updating the software is incredibly simple and doesn't require installing any additional tools on your computer.
The entire process is done directly from your web browser.
Requirements
- A computer with Windows, macOS, or Linux.
- A web browser: Google Chrome or Microsoft Edge.
- A USB-C cable to connect the computer to the controller.
Step-by-Step Installation
Step 1: Connect the Controller to Your Computer
Connect your boneIO ESP controller to your computer using a USB-C cable.
Important: The controller does not need to be connected to its 24V power supply at this time. The power from your computer's USB port is sufficient for the installation process.
Step 2: Open the Web Installer
In your Chrome or Edge browser, go to: https://boneio.eu/esp
Step 3: Choose Your Configuration
On the installer page, you will see a simple configurator to help tailor the software to your needs.
- Choose your device version: Select the model you have from the dropdown list (e.g.,
boneIO ESP). - Choose your board version: If there have been multiple hardware revisions for your model, an additional list will appear. Select the one you own.
- Configure the default output type: Decide whether you want most of your outputs to appear in Home Assistant as
lightorswitchentities by default. Remember, you can always change this for each output individually later.
Step 4: Start the Installation
- Click the INSTALL button.
- A system window will pop up asking you to select a COM port. Choose the port that corresponds to your controller from the list (there is usually only one available option).
- The installation process will begin automatically. You will see a progress bar and logs in a console window. Do not disconnect the USB-C cable during this process!
- You will see a success message upon completion.
Resetting the Device to Factory Settings
If you want to completely wipe the controller and install the firmware from scratch (e.g., after a failed configuration or to update to the latest version), simply repeat the exact same steps as for the initial installation.
The web installer will first completely erase the device's memory and then install a clean copy of the latest firmware.
Modbus Integration with ESPHome Packages
Learn how to easily integrate Modbus devices like heat pumps or heat recovery ventilators with Home Assistant using pre-made ESPHome packages for boneIO.
UDP Communication Between Devices
How to connect two boneIO ESP devices using the ESPHome UDP component so they can share sensor states and synchronize inputs — without a server or broker.