boneio-loxone-via-udp-http

How to integrate BoneIO with Loxone via UDP & HTTP

For getting info from BoneIO into Loxone we use UDP connection.

For sending commands from Loxone into BoneIO we use HTTP connection.

Note: We could use UDP however it would require additional configuration changes in the yaml, where HTTP commands are working out of the box.

0. Download files

0.1. Go to github repository and download the zip just like that:

0.2. Save it to the location you want on your desktop (preferrably Downloads directory)

1. Adjust yaml config

1.1. Open boneio-dr-8ch-loxone.yaml in some kind of editor

1.2. Update fields

• static_ip_address: static ip address in your network that the boneIO will be attached to
• miniserver_ip: Miniserver's IP address
• miniserver_udp_port: UDP port that BoneIO will send data to (if using multiple devices, you might want to change this)

1.3. Save changes in a file

2. Update esp32 configuration on your boneIO device

There are multiple ways to do it: via usb cable, network using esphome application

• Go to esphome application
• Find your device and click Edit

• Click Install and wait until it completes

2.1 View the esphome's device dashboard

Navigate to static_ip_address of the device in a browser: for ex. http://192.168.31.214/

3. Loxone: Configure VI/VO

1. Open your project in Loxone Config

2. Virtual Inputs:

2.1. Import Virtual Inputs for template

• Find and Left Click on Virtual Inputs under your Miniserver

• Import Template by clicking: UDP Device Template -> Import Template... -> Find the file downloaded earlier VIU_BoneIO Dimmer 8ch 8di.xml

• Use newly created template by clicking: UDP Device Template -> Import Template... -> Choose under My Templates: VIU_BoneIO Dimmer 8ch 8di.xml

2.2. Update UDP receive port on newly created Virtual Input to boneIO's ip address

Change UDP receive port to the one from .yaml config under miniserver_udp_port (defaults to 9999 and no changes are required)

3. Virtual Outputs

3.1. Import Virtual Outputs from template:

• Find and Left Click on Virtual Outputs under your Miniserver

• Import Template by clicking: Device Templates -> Import Template... -> Find the file downloaded earlier VO_BoneIO Dimmer 8ch 8di.xml

• Use newly created template by clicking: Device Templates -> Import Template... -> Choose: VO_BoneIO Dimmer 8ch 8di.xml

3.2. Update Address field on newly created Virtual Output to boneIO's ip address

Change Address to the one from .yaml config under static_ip_address field

4. Loxone-config

4.1. How to use Virtual Inputs:

• DI1-8: Digital inputs. Possible values: 0, 1
• CHL Power/CHR Power: Power in watts for Left (CHL) and Right (CHR) channels
• KeepAliveTime: UnixTimestamp of last ping from BoneIO to Miniserver. In order to make a use of it we can use Formula: and Memory Flag: BoneIO Online as such:

1. Create new Memory Flag: BoneIO Online
2. Add formula block with: IF(I2 - I1 > 30;0;1)
3. Connect KeepAliveTime to I1 of Formula block
4. Connect UnixTimestamp to I2 of Formula block
5. Connect R from Formula block into newly created Memory Flag: BoneIO Online

4.2. How to use Virtual Outputs

• CHL1-CHL4/CHR1-CHR4: Relays for Left (CHL1-4) and Right Channels (CHR1-4). Possible values to send: 0, 1
• CHL1 Dimmer-CHL4 Dimmer/CHR1 Dimmer-CHR4 Dimmer: Dimmers for Left (CHL1-4) and Right Channels (CHR1-4). Possible values to send: 0-255

Above virtual output commands can be used in Lighting Controller as such: