Skip to main content

Loxone Integration: Leser Series

This guide provides a standardized workflow for integrating stromleser, gasleser, and wasserleser devices into Loxone Config using Virtual HTTP Input templates.


Template Downloads

Before starting, download the specific template for your device:

DeviceTypeDownload Link
stromleserElectricityVorlage herunterladen
gasleserGasVorlage herunterladen
wasserleserWaterVorlage herunterladen

1. Establish Connection

Ensure your Loxone Config software is communicating with your hardware.

  1. Open your project in Loxone Config.
  2. Navigate to the Miniserver tab in the top ribbon.
  3. Click Connect to establish a live session.

Connect to Miniserver


2. Import the HTTP Template

Import the specific .xml template file you downloaded above.

  1. Select Virtual Inputs in the Periphery tree on the left.
  2. In the top menu, click the HTTP Device Templates icon.
  3. Choose Import Template... from the dropdown menu.
  4. Select your template file (e.g., VI_Stromleser Loxone Template) from your local directory.

Importing Template Menu Importing Template Menu Selecting File


3. Add Template to Project

Once imported, you must instantiate the specific device in your project.

  1. Click HTTP Device Templates again.
  2. Locate your template under the My templates section.
  3. Click the template name (e.g., stromleser, gasleser, or wasserleser) to add it to the Virtual Inputs tree.

Adding Template to Periphery


4. Configure Device Communication

Loxone requires the local network address of your device to fetch data.

  1. Click on the newly added Virtual HTTP Input in the Periphery tree.
  2. In the Properties window on the right, update the URL field:
    • Format: http://<DEVICE_IP>/v1/data
    • Example: http://192.168.0.171/v1/data
Static IP Recommendation

Ensure your device has a Static IP address assigned in your router settings to prevent communication loss if the router reboots.

Configuring IP and Polling Configuring IP and Polling


5. Configure Input Commands

Each device contains specific commands (e.g., Consumption, Flow Rate, Status). Assign these to the correct rooms and categories for the Loxone App.

Property Setup

For each command under the device:

  • Category: Set to Electricity (stromleser), Gas (gasleser), or Water (wasserleser).
  • Room: Assign to the relevant room (e.g., Utility Room or Central).
  • User Interface: Ensure Use in User Interface is checked.
  • Rating: Set the star rating to determine priority in the Loxone App.

Command Properties Setup Command Properties Setup


6. Deployment

Upload the final logic to your Miniserver hardware.

  1. Navigate to the Miniserver tab.
  2. Click Save in Miniserver.
  3. The Miniserver will reboot and begin polling your device for real-time data.

Save to Miniserver


Support

If data does not appear immediately, verify that your device is powered on and that the URL entered in Step 4 is accessible via your web browser.