Im Paket liegt die Datei base.xml.new. Diese ist in base.xml umzubenennen und dann entsprechend anzupassen. Die Datei „base.xml“ enthält die wesentlichen Daten, welche vom Anwender anzupassen sind. Es enthält aktuell (Stand 15.06.2021) folgenden Inhalt:

<?xml version="1.0" encoding="UTF-8"?>
<tns:BaseData xmlns:tns="http://www.example.org/control"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.example.org/control base.xsd ">
	<tns:ExecutionData timeZone="Europe/Berlin"
		port="10735"
		writablePathLinux="/opt/solvis"
		writeablePathWindows="C:\JavaPgms\SolvisSmartHomeServer\log"
		echoInhibitTime_ms="2000" />
	<tns:Units>
		<tns:Unit
			id="mySolvis"
			type="SolvisMax"
			mainHeating="OelBW"
			heatingCircuits="1"
			fwLth2_21_02A="true"
			account="account" passwordCrypt="AES-coded" url="aaa.bbb.ccc.ddd"
			defaultAverageCount="12"
			measurementHysteresisFactor="4"
			measurementsInterval_s="10"
			measurementsIntervalFast_s="10"
			forceUpdateAfterFastChangingIntervals="3"
			forcedUpdateInterval_ms="3600000"
			doubleUpdateInterval_ms="10000"
			bufferedInterval_ms="60000"
			watchDogTime_ms="30000"
			releaseBlockingAfterUserAccess_ms="300000"
			releaseBlockingAfterServiceAccess_ms="3600000"
			delayAfterSwitchingOnEnable="true"
			resetErrorDelayTime_ms="300000"
			ignoredFrameThicknesScreenSaver="3">

			<tns:Extensions>
				<!-- <tns:Extension id="Festbrennstoff" /> -->
				<!-- <tns:Extension id="SolarOstWest"/> -->
				<!-- <tns:Extension id="Zaehlfunktion2Screens"/> -->
			</tns:Extensions>

			<tns:Features>
				<tns:Feature id="InteractiveGUIAccess" value="false"/> <!-- false: GUI controlling disabled -->
				<tns:Feature id="ClockTuning" value="false"/>
				<tns:Feature id="EquipmentTimeSynchronisation" value="false"/>
			        <tns:Feature id="UpdateAfterUserAccess" value="false"/>
				<tns:Feature id="DetectServiceAccess" value="false"/>
				<tns:Feature id="PowerOffIsServiceAccess" value="false"/>
				<tns:Feature id="SendMailOnError" value="false"/>
				<tns:Feature id="SendMailOnErrorsCleared" value="false" />
				<tns:Feature id="ClearErrorMessageAfterMail" value="false"/>
				<tns:Feature id="Admin" value="false" />
				<tns:Feature id="Min_Vorlauf_Temp" value="false"/>				
				<tns:Feature id="BetriebsartVT_HK" value="false"/>				
				<tns:Feature id="WW_Pumpe_Min_Laufzeit" value="false"/>
			</tns:Features>

			<tns:IgnoredChannels>
				<!-- Example -->
				<!-- Inhibit sending of channel by regular expressions
				<tns:RegEx>AIn.*</tns:RegEx>
				<tns:RegEx>AOut.*</tns:RegEx>
			-->
			</tns:IgnoredChannels>

			<tns:ChannelAssignments>
				<!-- tns:Assignment id="A03" name="A03.Another_Name" unit="%"/ -->
			</tns:ChannelAssignments>

			<tns:Durations>
				<!-- <tns:Duration id="ModeChange" time_ms="3500" /> -->
			</tns:Durations>
			<tns:ChannelOptions>
				<!--
					<tns:Channel id="C47.Puffer_dT_Start" fix="12" />
					<tns:Channel id="X01.BrennerStarts" offset="65536" />
				-->
				<tns:Channel id="S03.Speicherreferenztemperatur"
					powerOnDelay_s="600" />
				<tns:Channel id="S04.Heizungspuffertemperatur_oben"
					powerOnDelay_s="600" />
				<tns:Channel id="S09.Heizungspuffertemperatur_unten"
					powerOnDelay_s="600" />
				<tns:Channel id="S10.Aussentemperatur"
					powerOnDelay_s="900" />
				<tns:Channel id="RF1.Raumfuehler_HK1"
					powerOnDelay_s="1500" />
			</tns:ChannelOptions>

		</tns:Unit>
	</tns:Units>

	<tns:Mqtt
		enable="false"
		brokerUrl="192.168.0.71"
		port="1883"
		userName="MQTT-User-Name"
		passwordCrypt="MQTT-Password-AES-coded"
		subscribeQoS="1"
		publishQoS="1"
		idPrefix="SolvisSmartHomeServer"
		topicPrefix="SolvisSmartHomeServer"
		smartHomeId="MySmarthomeSystem" />

	<tns:ExceptionMail port="5870"
		passwordCrypt="AES-coded"
		name="Vorname Nachname"
		securityType="TLS"
		provider="securesmtp.t-online.de"
		from="[email protected]">
		<tns:Recipients>
			<tns:Recipient address="[email protected]"
				type="TO" />
			<tns:Recipient address="[email protected]"
				type="TO" />
		</tns:Recipients>
		<!--<tns:Proxy host="HttpProxy" port="80" user="user" passwordCrypt="EhDnGP6WICnLIIA2q9ZTew=="/>-->	</tns:ExceptionMail>
	<tns:Iobroker
		mqttInterface="mqtt-client.0"
		javascriptInterface="javascript.0" />


</tns:BaseData>

Von der Version 1.00.02 an sind die Passwörter in diese Datei AES-256-verschlüsselt einzutragen. Nur für die Solvis-Anlage kann noch das Password im Klartext drin stehen.

Um diese Werte unter Linux zu generieren, ist der makefile-Aufruf sudo make cryptzu nutzen.

Unter Windows ist hierzu nach der Installation im Startmenü der Eintrag SolvisSmartHomeServer/Crtypt auszuwählen.

Es wird anschließend nach dem zu verschlüsselnden Wort gefragt. Im Anschluss erfolgt die Ausgabe des verschlüsselten Wortes.

Folgende Werte des obigen XML-Files müssen entsprechend der beim Anwender vorliegenden Voraussetzungen angepasst werden.:

Durch diese Sektion wird dem Server die weiteren Anlagenoptionen bekannt gegeben. Diese können auch in Kombinationen genutzt werden solange sie die Anlage zulässt.

Für jede dieser Anlagenoption ist ein Extension-Tag mit der entsprechenden id aus folgender Tabelle zu definieren:

Zu beachten: Mit der Version ausgelieferten base.xml sind sämtliche neuen Features des Servers (bezogen auf die alte reine Fhem-Lösung) deaktiviert, da die einzelnen Features überraschende Effekte haben können (u. U. unerwartete Reaktionen der SolvisControl “wie von Geisterhand”. Die Features müssen im Features-Element einzeln freigeschaltet werden. Bitte dabei nochmals den Kommentar im XML-File beachten.

Mit der ConfigOrMask werden bestimmte Optionen der Anlage bestimmt, welche nicht automatsch aus dem GUI oder Sensordaten bestimmt werden können. Aktuell sind folgende Werte möglich:

Zu beachten: Ab Version 01.03.00 ist diese Maske durch die Attribute type, mainHeating, heatingCircuits und den Extensions ersetzt worden

Will man die MQTT-Schnittstelle nutzen, muss man im Mqtt-Tag noch folgende Parameter anpassen:

Die übrigen Parameter können vom User angepasst werden und haben folgende Bedeutung:

Durch diese Sektion kann man mittels Regular Expressions die Sendung von Werten bestimmter Kanäle an den MQTT-Broker oder FHEM-Client unterdrücken.

In dieser Sektion wird für jeden regulären Ausdruck folgender Tag definiert:

<tns:RegEx>regular expression</tns:RegEx>

Die Änderungen der Kanalnamen, welche durche den regulären Ausdruck erfasst werden, werden nicht gesendet. Werden mehrer dieser Tags angegeben, reicht ein einziger zutreffender Tag aus, dass Änderungen des Kanals nicht mehr gesendet werden.

Wichtig:

Die Namen der Kanäle sind in der Schreibweise wie hier definiert zu verwenden.

Die Steuerung der SolvisControl über des Gui erfolgt über die Simulation der Touchs auf dem Bildschirm. Dazu sind bestimmte Zeiten für die Länge des Touches selbst und der Länge der Zeit, wo kein Druck erfolgt in den Steuerfile definiert. Diese sind abhängig von der Art der Bedienung. Diese Zeiten lassen sich über die base.xml in der Sektion Durartions noch modifizieren, wenn man diese an die eigene Anlage noch optimieren will oder manche Zeiten bei einer bestimmten Anlagenkonfiguration möglicherweise nicht ausreichen.

Außerdem lassen sich noch weitere Werte modifizieren.

Für die zu modifizierende Zeit ist ein Duration-Tag mit folgendem Aufbau nötig:

<tns:Duration id="id" time_ms="time" />

Folgende Tabelle gibt die möglichen Zeiten wieder:

                |              |

checkCalculation | 86400000 | Bestimmte Werte (z.B. Brennerlaufzeiten) werden aus dem Gui ermittelt und dannn genauer weiter gezählt. Bei aktiviertem Feature EquipmentTimeSynchronisation gibt diese Zeit das Intervall vor, wo eine Überprüfung mit dem Wert im Gui erfolgt. Eien bessere Genauigkeit

Durch diese Sektion können noch die Kanalnamen und optional deren Einheiten den eigenen Wünschen angepasst werden. Für jeden zu ändernden Kanal ist ein Assignment-Tag mit folgendem Aufbau zu definieren:

<tns:Assignment id="Id" name="Kanalname" unit="Unit"/>

Hierbei ist die Id der Präfix des zu ändernden Kanalnamens, z.B. A01, S01 etc., Kanalname der neue Name des Kanals und Unit die Einheit. Das Attribut unit ist optional.

Durch diese Sektion können Kanäle mit bestimmten Werten vorbelegt werden oder auch mittels konstanten Werten modifiziert werden. Außerdem kann dadurch bestimmt werden, dass Sensoren erst später erfasst werden. Die Temperatursensoren der SolvisMax sind nach dem PowerOn noch nicht sehr genau. Wenn Genauigkeit erforderlich ist z.B. abhängig von diesen etwas zu steuern, dann dürfen die nach dem PowerOn nicht zu früh ausgewertet werden. Das kann der SolvisSmarthomeServer übernehmen. Erst wenn eine einstellbare Zeit verstrichen ist, werden die Werte der entsprechenden Kanäle zum Smarthome-System übertragen

Aktuell sinnvoll (Stand 20.11.2021) ist eine fixe Festlegung für den Kanal C47.Puffer_dT_Start. Näheres siehe unter Nachheizen.

Eine Korrektur sind für die Brennerstarts X01.BrennerStarts und X03.BrennerStufe2Starts sinnvoll. Die Brennerstarts werden grafisch aus der SolvisControl gelesen und als Kanal C01.StartsBrenner erfasst. Bei der SolvisMax6 wurde für diesen Zähler nur mit 16 Bit realisiert. Dadurch erfolgt nach 65536 Brennerstarts ein Überlauf und der Wert ist dann wieder 0.

Das Channel-Tag der ChannelOptions ist wie folgt definiert:

<tns:Channel id="Id" fix="Fix" offset="Offset" factor="Factor" powerOnDelay_s="Delay" />

Hierbei sind:

Ist in den Optionen für einen Kanal die Attribute factor und offset definiert, wird der Wert erst mit dem Faktor multipliziert, anschließend wird der Offset aufaddiert.

Einige Beispiele sind in der base.xml zu finden.

Zusätzlich gibt es noch das ExceptionMail-Element, mit dem man die Zugangsdaten des Mail-Providers definiert, sowie die zu benachrichtigenden Adressen.

Ist SMTP nur über einen Proxy zugänglich, so kann man noch den Proxy-Tag mit folgenden Attributen definieren:

Mit dem Server können auch die Objektliste und ein Pairing-Skript für den iobroker erstellt werden. Um dies generierten Objekte individuell an die iobroker-Realisierung anzupassen, können folgende Attribute in der Iobroker-Sektion definiert werden: