aioxcom 0.0.1

Async python library to communicate with Studer-Innotec devices on the local network via Xcom protocol

aioxcom

Python library for retrieving sensor information from Studer-Innotec devices. This component connects directly over the local network using the Studer xcom protocol.

The custom component was tested with:

• Xtender XTH 8000-48 (but should also work for other XTH, XTS and XTM)
• Xcom-CAN (BSP connection to a third party BMS)
• Xcom-LAN (which actually is a Xcom232i with a Moxy NPort 5110A)
• RCC-03

It should also be able to detect and handle

• Studer BMS
• VarioTrack
• VarioString
• RCC-02

Prerequisites

This device depends on having a Studer Xcom-LAN (i.e. an Xcom-232i and a Moxa ethernet gateway) acting as a Xcom client and connecting to this integration. For older systems this will be a separate component, for future systems Studer have indicated that LAN connection will become part of the Xtender range.

The Studer Xcom-LAN will be able to simultaneously send data to the Studer online portal as well as sending data to this integration.

Configuration steps:

1. Download and install the Moxa DSU tool (Device Search Utility)

   • Open www.moxa.com in a browser
   • Select Support -> Software and Documentation
   • Choose NPort 5100A series (or whatever specific device you have)
   • Scroll down under 'Related Software, Firmware and Drivers' to find 'Device Search Utility'
   • Download and install the utility

2. Locate the Moxa NPort device on the local network

   • Run the Moxa Device Search Utility

   • Press the 'Search' button and wait until the search finishes

   • The utility should display the found NPort device

   • Double click on the found device to open its configuration page

     

3. Configure the Moxa NPort device

   • In the Main Menu, select 'Operating Settings' -> Port 1

   • Verify that 'Operation Mode' is set to 'TCP Client'

   • Add the ip-address or network name of your HomeAssistant as 'Destination IP address'

   • Press the 'Submit' button

   • Press 'Save/Restart'

     

Usage

TODO

Param writes to device

When the value of a Studer param is changed via this library, these are written via Xcom to the affected device. Changes are stored in the device's RAM memory, not in its flash memory as you can only write to flash a limited number of time over its lifetime.

However, reading back the value from the entity will be from flash (querying RAM gives unreliable responses). As a result, the change to the entity value is not visible. You can only tell from the behavior of the PV system that the Studer param was indeed changed.
After a restart/reboot of the PV system the system will revert to the value from Flash. So you may want to periodically repeat the write of changed param values via an automation.

IMPORTANT:

I will not take responsibility for damage to your PV system resulting from you choosing to change Studer params you are not supposed to change. Or setting a combination of param values that cause an invalid status.
Be very carefull in changing params marked as having level Expert, Installer or even Qualified Service Person. If you do not know what the effect of a Studer param change is, then do not change it.

Credits

Special thanks to the following people for providing the information this library is based on:

• zocker-160
• Michael Jeffers