Input Controller – Quick Start Guide
Prerequisites
The software included on the Logi.Casa Digital Input Controller is intended for use with Home Assistant. If you need to set up Home Assistant, additional hardware is required.
Logi.Casa offers powerful hardware that comes pre-installed with Home Assistant. Please visit our webshop for more information at www.logi.casa. If you prefer to use other hardware please follow the directions for installing Home Assistant at: https://www.home-assistant.io/installation/
Once you have Home Assistant installed and running, proceed to Getting Started. You also have the option to reprogram the Logi.Casa Digital Input Controller with another ESP32 compatible firmware, which may not require Home Assistant.
These instructions will help you to perform the initial setup of a new device. In case something goes wrong during this setup you can revert your controller to the factory defaults and start over. To revert the device to factory settings you can reflash the initial firmware to the device. This link will give you access to our firmware installation page using ESP Web Tools. You will need to open the casing of your device and connect the microcontroller to your PC using a USB-C cable.
STEP 1 – Getting started
Begin by installing the Logi.Casa Digital Input Controller into your power distribution cabinet by clicking it onto a DIN rail. The controller needs a power supply of 24VDC with a minimum power of 10 Watt. Logi.Casa recommends using a DIN mountable 24VDC power supply with sufficient power for all your 24VDC devices in your power distribution cabinet. Logi.Casa offers high quality power supplies ranging from 60 Watt to 150 Watt. Please visit our webshop for more information at www.logi.casa.
It’s possible to configure multiple Logi.Casa controllers at once, but we recommend configuring the controller completely before providing power to an additional controller to avoid complexity.
STEP 2 – Wi-Fi setup
Initially the controller will be unable to connect to your Wi-Fi network. You will need to enter your Wi-Fi credentials so the device can connect to your network.
When the controller is unable to connect to a known Wi-Fi network it will automatically create a Wi-Fi fallback hotspot for you to connect to. Open your Wi-Fi connections settings on a Wi-Fi enabled device. (eg. a computer or smartphone)
Search for the controllers W-Fi fallback hotspot ‘inputcontroller-XXXXXX’, where ‘XXXXXX’ are the last 6 digits of the MAC address of the device used as a unique identifier. You will be prompted for a password to connect. The default password is ‘LogiCasa’ (case sensitive).
Once connected, you will be prompted with a web interface to select your Wi-Fi network and enter the credentials for your Wi-Fi network. Enter the required information and submit the form by clicking SAVE. Now the controller will reboot and connect to your network.
Note: if you’re not redirected to the web interface automatically open a browser and enter the URL 192.168.4.1 to visit the web interface manually.
STEP 3 – Install the ESPHome add-on in Home Assistant
Log in to your Home Assistant server.
The ESPHome addon needs to be installed in Home Assistant. If you already done this, please proceed to STEP 4.
Go to Settings -> Addons and click on ADD-ON STORE in the right bottom corner.
Select the ESPHome add-on and click on INSTALL.
Once installed check all the sliders and click on START.
STEP 4 – Adopting the controller in ESPHome
Open the ESPHome web interface by selecting ESPHome in the left menu in Home Assistant.
Your new device should be listed in green with an option to ADOPT the device.
Click on ADOPT and choose a name for your new device. Please note that the name should be unique. If you’re planning on installing more than one input controller add a number to the name to easily identify them later. (eg. Input Controller 1)
If this is the first device you are adopting you will be prompted to enter your Wi-Fi network name and password. This will be saved in ESPHome and used for every other device you will be adding in the future.
Next you will be prompted to install the device. Click on INSTALL to install the latest version of the software to your device.
Give the process time to finish and make sure the upload is successful. Occasionally the initial installation might fail to upload to the device. In this case click the RETRY button below. If the upload is successful, click STOP to close this window.
If the installation is successful the LED on the device will turn from red to blue, indicating it is successfully connected to Home Assistant.
STEP 5 – Renaming the hostname of the device
Rename the hostname of your device before adding it to Home Assistant. By default the initial name of the device will be used for each entity of the device for easy identification later. We advise to use a short name that allows you to identify your device later. (eg. IC1)
Click on the tree dots to open the menu in the ESPHome interface and select the option RENAME HOSTNAME enter a unique name for the device.
Wait for the process to finish.
STEP 6 – Integrate the device in Home Assistant
Now we will add the device to Home Assistant to start using it in your automations. Go to Settings -> Devices & Services. Home Assistant will discover your new device automatically and it will be listed for configuration.
Click on configure and click SUBMIT.
You will be prompted with a success message where you have the option to assign the device to a room. We advise you to not assign it to a room because home assistant will automatically assign all the entities to that room. Finish the setup by clicking FINISH.
You are now ready to use the device in Home Assistant.
Click on Settings -> Devices & Services and search for the ESPHome integration on the page. Open the Device page by clicking your device.
This overview will show you all the entities the device exposes to Home Assistant ready to be used in automations.
STEP 7 – Create your first automation
Create an automation to react on a state change on an input channel of the controller.
Please note that our input controller is designed to receive inputs from push buttons in your house. Make sure you connect your push buttons correctly to the input controller to avoid damage to the device. You should connect the positive lead of your 24VDC power supply to the common connector of your push buttons. The separate leads from each button should be connected to an input channel on the controller. When the button is pushed a positive 24VDC signal will be available on that channel and Home Assistant will detect the status change for that channel.
Consult the wiring documentation for more information.
Go to Settings -> Automations & Scenes. In the right bottom corner click on CREATE AUTOMATION.
Select Create New Automation to open a new Automation page in the GUI. Click on ADD TRIGGER and select State from the list. Search for the entity of the input you want to create an automation for and set the ‘To’ field to ‘On’ to react on a push of a button.
Click on ADD ACTION to select what should happen when the button is pressed. In this example we will activate an output channel on our output controller which will toggle a relay servicing a light.
Click SAVE and give your automation a name to identify it in the list later.
Congratulations, you’ve created your first automation using an input and output controller. Test your automation by pushing the button connected to the input you selected, and the selected output should be toggled on each press of the button.
This is a basic example of what you can accomplish with the Logi.Casa input and output controllers. The possibilities are endless, you can trigger every possible entity available in Home Assistant.
- Toggle or dim lights in Home Assistant
- Activating scripts or other automations
- Toggle blinds or covers available in Home Assistant
- Open or close a lock
- Activate an alarm
- Control a Media Player to play or stop music
- …