Vbus: Unterschied zwischen den Versionen

Aus FHEMWiki
Keine Bearbeitungszusammenfassung
K (veraltete "source"-Angaben in "syntaxhighlight" geändert)
 
(3 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Infobox Modul
<div style="float:right">{{Infobox Modul
|Name=THZ
|ModPurpose=VBUS LAN Adapter Device
|ModPurpose=Anbindung Heizungssteuerung über einen Resol V-Bus Lanadapter
|ModType=x
|ModType=d
|ModCmdRef=VBUSIF
<!-- |ModCategory= (noch?) nicht verwendet -->
|ModForumArea=Sonstige Systeme  
|ModForumArea=Sonstige Systeme  
|ModFTopic=10303
|ModTechName=19_VBUSIF.pm
|ModTechName=19_VBUSIF.pm
|ModOwner={{Link2FU|1754|Jörg (pejonp}})
}}
{{Infobox Modul
|ModPurpose=VBUS Client Device
|ModType=x
|ModCmdRef=VBUSDEV
|ModForumArea=Sonstige Systeme
|ModFTopic=10303
|ModTechName=21_VBUSDEV.pm
|ModTechName=21_VBUSDEV.pm
|ModOwner=
|ModOwner={{Link2FU|1754|Jörg (pejonp}})
}}
}}
 
</div>


== Kurzbeschreibung ==
== Kurzbeschreibung ==
Das Vbus-Modul verbindet einen Vbus-Lan adapter mit FHEM.
Das Vbus-Modul verbindet einen Vbus LAN-Adapter mit FHEM.


== Voraussetzung ==
== Voraussetzung ==
Voraussetzung zur Anbindung eines VBus Device an FHEM ist das eine Netzwerkverbindung besteht die zur Verfügung stehenden Module:  
Voraussetzung zur Anbindung eines VBus Device an FHEM ist eine bestehende Netzwerkverbindung und die Verwendung der zur Verfügung stehenden Module:  
    19_VBUSIF.pm
* 19_VBUSIF.pm
    21_VBUSDEV.pm
* 21_VBUSDEV.pm
genutzt werden.
Diese Dateien müssen in den Ordner /opt/fhem/FHEM kopiert werden und es findet keine aktualisierung beim Update statt.
 
==== Benutzte Dateien ====
 
Code der VBUSIF.pm Datei
<pre>
# $Id: 19_VBUSIF.pm 20160725 2016-07-25 03:54:15Z awk+pejonp $
# VBUS LAN Adapter Device
#
# (c) 2014 Arno Willig <akw@bytefeed.de>
# (c) 2015 Frank Wurdinger <frank@wurdinger.de>
# (c) 2015 Adrian Freihofer <adrian.freihofer gmail com>
 
 
package main;
 
use strict;
use warnings;
use POSIX;
use Data::Dumper;
use Device::SerialPort;
 
sub VBUSIF_Read($@);
sub VBUSIF_Write($$$);
sub VBUSIF_Ready($);
sub VBUSIF_getDevList($$);
 
 
sub VBUSIF_Initialize($)
{
my ($hash) = @_;
require "$attr{global}{modpath}/FHEM/DevIo.pm";
 
# Provider
$hash->{ReadFn}    = "VBUSIF_Read";
$hash->{WriteFn}    = "VBUSIF_Write";
$hash->{ReadyFn}    = "VBUSIF_Ready";
$hash->{UndefFn}    = "VBUSIF_Undef";
$hash->{ShutdownFn} = "VBUSIF_Undef";
 
# Normal devices
$hash->{DefFn}      = "VBUSIF_Define";
$hash->{AttrList}  = "dummy:1,0"
                        ."$readingFnAttributes ";
  $hash->{AutoCreate} = { "VBUSDEF.*" => { ATTR => "event-min-interval:.*:120 event-on-change-reading:.* ",FILTER => "%NAME"} };
 
}
 
######################################
sub VBUSIF_Define($$)
{
my ($hash, $def) = @_;
my @a = split("[ \t]+", $def);
 
if(@a != 3) {
my $msg = "wrong syntax: define <name> VBUSIF [<hostname:7053> or <dev>]";
    Log3 $hash, 2, $msg;
    return $msg;
}
 
#  if(@a != 3) {
# return "wrong syntax: define <name> VBUSIF [<hostname:7053> or <dev>]";
# }
 
 
my $name = $a[0];
my $dev = $a[2];
$hash->{Clients} = ":VBUSDEV:";
my %matchList = ( "1:VBUSDEV" => ".*" );
$hash->{MatchList} = \%matchList;
 
  Log3 $hash, 4,"$name: VBUSIF_Define: $hash->{MatchList} ";
 
DevIo_CloseDev($hash);
$hash->{DeviceName} = $dev;
my @dev_name = split('@', $dev);
if ( -c ${dev_name}[0]) {
$hash->{DeviceType} = "Serial";
} else {
$hash->{DeviceType} = "Net";
}
 
my $ret = DevIo_OpenDev($hash, 0, "VBUSIF_DoInit");
return $ret;
}
 
###############################
sub VBUSIF_DoInit($)
{
my $hash = shift;
if ($hash->{DeviceType} eq "Net" ) {
my $name = $hash->{NAME};
delete $hash->{HANDLE}; # else reregister fails / RELEASE is deadly
 
my $conn = $hash->{TCPDev};
$conn->autoflush(1);
$conn->getline();
$conn->write("PASS vbus\n");
$conn->getline();
$conn->write("DATA\n");
$conn->getline();
}
  Log3 $hash, 4,"VBUSIF_DoInit ";
return undef;
}
 
sub VBUSIF_Undef($@)
{
my ($hash, $arg) = @_;
if ($hash->{DeviceType} eq "Net" ) {
VBUSIF_Write($hash, "QUIT\n", "");  # RELEASE
}
DevIo_CloseDev($hash);
return undef;
}
 
sub VBUSIF_Write($$$)
{
my ($hash,$fn,$msg) = @_;
DevIo_SimpleWrite($hash, $msg, 1);
}
 
 
sub VBUSIF_Read($@)
{
my ($hash, $local, $regexp) = @_;
my $buf = ($local ? $local : DevIo_SimpleRead($hash));
return "" if(!defined($buf));
my $name = $hash->{NAME};
$buf = unpack('H*', $buf);
my $data = ($hash->{PARTIAL} ? $hash->{PARTIAL} : "");
$data .= $buf;
 
my $msg;
my $idx;
$idx = index($data,"aa");
  Log3 $hash, 4,"$name: VBUSIF_Read: index = $data";
if ($idx>=0) {
$data = substr($data,$idx); # Cut off beginning
 
$idx = index($data,"aa",2); # Find next message
 
if ($idx>0) {
 
$msg = substr($data,0,$idx);
$data = substr($data,$idx);
my $protoVersion = substr($msg,10,2);
Log3 $hash, 4,"$name: VBUSIF_Read: protoVersion : $protoVersion";
  if ($protoVersion == "10" && length($msg)>=20) {
my $frameCount = hex(substr($msg,16,2));
my $headerCRC  = hex(substr($msg,18,2));
 
my $crc = 0;
for (my $j = 1; $j<=8;$j++) {
$crc += hex(substr($msg,$j*2,2));
}
$crc = ($crc ^ 0xff) & 0x7f;
if ($headerCRC != $crc) {
Log3 $hash, 3, "$name: Wrong checksum: $crc != $headerCRC";
} else {
my $len = 20+12*$frameCount;
#if ($len != length($msg)) {
if ($len != length($msg) && length($msg) != 247) {
Log3 $hash, 4,"$name: Wrong message length: $len != ".length($msg);
} else {
if(length($msg) == 247) {
$msg = $msg."a";
}
my $payload = VBUSIF_DecodePayload($hash,$msg);
if (defined $payload) {
$msg = substr($msg,0,20).$payload;
 
$hash->{"${name}_MSGCNT"}++;
$hash->{"${name}_TIME"} = TimeNow();
$hash->{RAWMSG} = $msg;
my %addvals = (RAWMSG => $msg);
Dispatch($hash, $msg, \%addvals) if($init_done);
  }
}
}
 
}
if ($protoVersion == "20") {
my $command    = substr($msg,14,2).substr($msg,12,2);
my $dataPntId  = substr($msg,16,4);
my $dataPntVal = substr($msg,20,8);
my $septet    = substr($msg,28,2);
my $checksum  = substr($msg,30,2);
# TODO use septet
# TODO validate checksum
# TODO Understand protocol
 
}
}
}
 
$hash->{PARTIAL} = $data;
# return $msg if(defined($local));
return undef;
}
 
sub VBUSIF_Ready($)
{
my ($hash) = @_;
return DevIo_OpenDev($hash, 1, "VBUSIF_DoInit") if($hash->{STATE} eq "disconnected");
return 0;
}
 
 
sub VBUSIF_DecodePayload($@)
{
my ($hash, $msg) = @_;
my $name = $hash->{NAME};
 
my $frameCount = hex(substr($msg,16,2));
my $payload = "";
for (my $i = 0; $i < $frameCount; $i++) {
my $septet  = hex(substr($msg,28+$i*12,2));
my $frameCRC = hex(substr($msg,30+$i*12,2));
 
my $crc = (0x7f - $septet) & 0x7f;
for (my $j = 0; $j<4;$j++) {
my $ch = hex(substr($msg,20+$i*12+$j*2,2));
$ch |= 0x80 if ($septet & (1 << $j));
$crc = ($crc - $ch) & 0x7f;
$payload .= chr($ch);
}
 
if ($crc != $frameCRC) {
  Log3 $hash, 4,"$name: Wrong checksum: $crc != $frameCRC";
return undef;
}
}
return unpack('H*', $payload);
}
 
1;
 
=pod
=begin html
<a name="VBUSIF"></a>
<h3>VBUSIF</h3>
<ul>
  This module connects to the RESOL VBUS LAN or Serial Port adapter.
  It serves as the "physical" counterpart to the <a href="#VBUSDevice">VBUSDevice</a>
  devices.
  <br /><br />
  <a name="VBUSIF_Define"></a>
  <b>Define</b>
  <ul>
    <code>define &lt;name&gt; VBUS &lt;device&gt;</code>
  <br />
  <br />
  &lt;device&gt; is a &lt;host&gt;:&lt;port&gt; combination, where
  &lt;host&gt; is the address of the RESOL LAN Adapter and &lt;port&gt; 7053.
  <br />
  Examples:
  <ul>
    <code>define vbus VBUSIF 192.168.1.69:7053</code>
    </ul>
    <ul>
    <code>define vbus VBUSIF  /dev/ttyS0</code>
  </ul>
  </ul>
  <br />
</ul>
=end html
=cut
</pre>
 
 
 
https://github.com/pejonp/vbus


Diese Module werden aktuell extern gehostet (es findet sich aber auch noch eine veraltete Version im FHEM repository). Um diese in die FHEM Installtion einzubinden muss folgender Befehl abgesetzt werden
:<syntaxhighlight lang="bash">update all https://raw.githubusercontent.com/pejonp/vbus/master/controls_vbus.txt</syntaxhighlight>


Damit werden auch bei einer FHEM Aktualisierung ([[update]]) diese Module berücksichtigt


== Installation RESOL VBUS LAN Gateway ==
== Installation RESOL VBUS LAN Gateway ==
# Erstmal keine Einstellungen am VBUS/Lan Gateway (Passwort/Port etc) vornehmen
# Vorerst keine Einstellungen am VBUS/Lan Gateway (Passwort/Port etc.) vornehmen
# Die Ip_adresse herausfinden (z.B. am Router) und prüfen ob man per Browser darauf zugreifen kann
# Die IP Adresse herausfinden (z.B. am Router) und prüfen, ob man per Browser darauf zugreifen kann
# Optional: Testen ob Daten ankommen mit der service center Software von Resol
# Optional: Testen, ob Daten ankommen mit der ServiceCenter Software von Resol
# Dann nur das VBUSIF als define eintragen
# dann nur das VBUSIF als ''define'' eintragen


== Definition ==
== Definition ==
 
:<code>define <name> VBUSIF  <IP des VBus-Lan> <Port muss 7053 bleiben></code>
define <name> VBUSIF  <IP des VBus-Lan> <Port muss 7053 bleiben>


<pre>
<pre>
Zeile 351: Zeile 86:
*DeltaSol_MX_HK 7E21
*DeltaSol_MX_HK 7E21
*DeltaSol_MX_WMZ 7E31
*DeltaSol_MX_WMZ 7E31


== Bekannte Probleme ==
== Bekannte Probleme ==
Aktuell ist es nicht möglich die Konfiguration der Steuerungen zu ändern es ist nur ein Abfragen der werte implementiert.
Aktuell ist es nicht möglich, die Konfiguration der Steuerungen zu ändern; es ist nur ein Abfragen der Werte implementiert.


== Weblinks ==
== Weblinks ==
* Resol Protokollbeschreibung [https://danielwippermann.github.io/resol-vbus/vbus-packets.html]
* Resol Protokollbeschreibung [https://danielwippermann.github.io/resol-vbus/vbus-packets.html]
 
* VBus GitHub [https://github.com/pejonp/vbus]
 


[[Kategorie:Heizungssteuerung]]
[[Kategorie:Heizungssteuerung]]

Aktuelle Version vom 9. November 2023, 12:56 Uhr

VBUSIF
Zweck / Funktion
VBUS LAN Adapter Device
Allgemein
Typ Inoffiziell
Details
Dokumentation Thema
Support (Forum) Sonstige Systeme
Modulname 19_VBUSIF.pm
Ersteller Jörg (pejonp )
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


VBUSDEV
Zweck / Funktion
VBUS Client Device
Allgemein
Typ Inoffiziell
Details
Dokumentation Thema
Support (Forum) Sonstige Systeme
Modulname 21_VBUSDEV.pm
Ersteller Jörg (pejonp )
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Kurzbeschreibung

Das Vbus-Modul verbindet einen Vbus LAN-Adapter mit FHEM.

Voraussetzung

Voraussetzung zur Anbindung eines VBus Device an FHEM ist eine bestehende Netzwerkverbindung und die Verwendung der zur Verfügung stehenden Module:

  • 19_VBUSIF.pm
  • 21_VBUSDEV.pm

Diese Module werden aktuell extern gehostet (es findet sich aber auch noch eine veraltete Version im FHEM repository). Um diese in die FHEM Installtion einzubinden muss folgender Befehl abgesetzt werden 

update all https://raw.githubusercontent.com/pejonp/vbus/master/controls_vbus.txt

Damit werden auch bei einer FHEM Aktualisierung (update) diese Module berücksichtigt

Installation RESOL VBUS LAN Gateway

  1. Vorerst keine Einstellungen am VBUS/Lan Gateway (Passwort/Port etc.) vornehmen
  2. Die IP Adresse herausfinden (z.B. am Router) und prüfen, ob man per Browser darauf zugreifen kann
  3. Optional: Testen, ob Daten ankommen mit der ServiceCenter Software von Resol
  4. dann nur das VBUSIF als define eintragen

Definition

define <name> VBUSIF <IP des VBus-Lan> <Port muss 7053 bleiben>
  define vbus VBUSIF 192.168.1.25:7053
  attr vbus event-min-interval .*:120
  attr vbus verbose 5

Features / Funktionen

Es wurden die Module

  • DL 2 0050
  • DL 3 0053
  • Vitosolic200_SD4 1060
  • DeltaSol_SL 2251
  • WMZ 4010
  • SKSC1/2 4211
  • DeltaSolC 4212
  • Sonnenkraft_SKSC2HE 4214
  • DeltaSol_BS4 4278
  • DeltaSol_BS_2009 427b
  • DeltaTherm_FK 5611
  • MSR65_1 6521
  • MSR65_2 6522
  • SKS3HE 7160
  • SKSC3HE_[HK1] 7161
  • SKSC3HE_[HK2] 7162
  • DeltaSol_M 7311
  • DeltaSol_M_HKM 7312
  • DeltaSol_M_Volumen 7315
  • DeltaSol_M_WMZ1 7316
  • DeltaSol_M_WMZ2 7317
  • Vitosolic200 7321
  • Vitosolic200_WMZ1 7326
  • Vitosolic200_WMZ2 7327
  • SLR 7331
  • CitrinSLR_XT 7341
  • DeltaSol_ES 7411
  • DeltaSol_BX 7421
  • DeltaSolE_Regler 7721
  • DeltaSolE_WMZ 7722
  • DiemasolC 7751
  • Cosmo_Multi_Regler 7821
  • Cosmo_Multi_WMZ 7822
  • DeltaSol_MX_Regler 7E11
  • DeltaSol_MX_Module 7E12
  • DeltaSol_MX_HK 7E21
  • DeltaSol_MX_WMZ 7E31

Bekannte Probleme

Aktuell ist es nicht möglich, die Konfiguration der Steuerungen zu ändern; es ist nur ein Abfragen der Werte implementiert.

Weblinks

  • Resol Protokollbeschreibung [1]
  • VBus GitHub [2]
Abgerufen von „http://wiki.fhem.de/w/index.php?title=Vbus&oldid=38700“