> For the complete documentation index, see [llms.txt](https://pekaway.gitbook.io/van-pi-dokumentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pekaway.gitbook.io/van-pi-dokumentation/integration/victron-offiziell/victron-ve.direct.md).

# Victron Ve.Direct

**Integration von Victron-Geräten in VAN Pi über VE.direct**

Voraussetzungen

* Victron-Gerät(e)
* VE.direct zu USB-Kabel
* VAN Pi System

Schritte für die Einrichtung

1. VE.direct zu USB-Kabel anschließen:
   * Stecken Sie ein Ende des VE.direct-Kabels in Ihr Victron-Gerät.
   * Verbinden Sie das USB-Ende mit einem verfügbaren USB-Anschluss Ihres VAN Pi Systems.
2. Zugriff auf die Web-Oberfläche von VAN Pi:
   * Öffnen Sie einen Webbrowser auf einem Gerät, das mit demselben Netzwerk wie Ihr VAN Pi verbunden ist.
   * Geben Sie die IP-Adresse Ihres VAN Pi Systems + ":1880/ui" ein, um auf die Web-Oberfläche zuzugreifen.
3. Konfigurieren von VE.direct auf der Web-Oberfläche:
   * Navigieren Sie zu dem Abschnitt "System" in der Web-Oberfläche.
   * Finden Sie den USB-Anschluss, den Sie für die VE.direct-Verbindung verwenden.
   * Stellen Sie den USB-Port auf VE.direct ein.
4. Bei Verwendung eines Victron Shunts als Hauptbatteriemonitor (Optional):
   * Wenn Sie einen Victron Shunt angeschlossen haben, können Sie ihn als Hauptdatenquelle für die Batterie verwenden.
   * Gehen Sie in der Web-Oberfläche zum Abschnitt "Main Batt Data".
   * Stellen Sie "Main Batt Data" auf Victron Shunt ein.

Zusammenfassung Durch Befolgen dieser Schritte können Sie Ihre Victron-Geräte erfolgreich in Ihr VAN Pi System über das VE.direct zu USB-Kabel integrieren. Diese Einrichtung ermöglicht es Ihnen, die Daten Ihrer Victron-Geräte effektiv über die VAN Pi Web-Oberfläche zu überwachen und zu verwalten.

***

**Unterstützte Geräte über VE.Direct**

Folgende Victron-Geräte werden über VE.Direct unterstützt:

* Victron Shunts: 1 Gerät
* Victron BlueSolar / SmartSolar: bis zu 5 Geräte
* Victron Phoenix Inverter: 1 Gerät

Stand VAN PI OS 2.1.0: Die unterstützten PIDs basieren auf dem VE.Direct Protocol 3.34.

Hinweis: Der Victron Orion (B2B) ist aktuell nicht integriert. Eine Einbindung kann jedoch über Anpassungen im Backend als Eigenentwicklung umgesetzt werden.

***

**Webinterface Ansicht:**

<figure><img src="https://2414248595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGKWjq2gcLc6MCC4bkGHL%2Fuploads%2FOcrae4iiJcoQ65S3x98s%2Fimage.png?alt=media&amp;token=b8d54bda-c5a2-46c0-84aa-8c0c6c8390fd" alt=""><figcaption></figcaption></figure>

**APP Details Ansicht:**\
![](https://2414248595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGKWjq2gcLc6MCC4bkGHL%2Fuploads%2Fuy9wfKOYv2EVULHZblq4%2Fphoto_2026-08-12_14-34-54.jpg?alt=media\&token=16c6af37-cd78-4869-bd53-210fd515f287)![](https://2414248595-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGKWjq2gcLc6MCC4bkGHL%2Fuploads%2F9UZz12f8a71rc6CMKYvW%2Fphoto_2026-08-12_14-34-58.jpg?alt=media\&token=b4137041-47e2-4243-822c-9ed6be35d4f8)

***

<sup><sub>**Hinweis:**<sub></sup> <sup><sub> </sup><sup><sub>Das USB-Port-Limit beachten. Beim<sub></sup> <sup><sub> </sup><sup><sub>**VAN PI Core**<sub></sup> <sup><sub> </sup><sup><sub>stehen aktuell<sub></sup> <sup><sub> </sup><sup><sub>**4 USB-Ports + 1× Multi-UART**<sub></sup> <sup><sub> </sup><sup><sub>zur Verfügung. Dies gilt<sub></sup> <sup><sub> </sup><sup><sub>**nicht für den VAN PI Core Pro**<sub></sup><sup><sub>.<sub></sup>

**⚠️ Achtung:** Victron-Geräte können unter Umständen eine Masseverbindung über die **serielle Schnittstelle** herstellen. Achten Sie deshalb darauf, dass die Victron-Geräte immer über eine **ausreichend dimensionierte Masseverbindung** verfügen.

**Beim Anschließen:** Zuerst die reguläre **Stromversorgung inklusive Masseverbindung** herstellen und erst danach die serielle Verbindung über das **VAN PI USB JST** anschließen.

**Beim Abklemmen:** Zuerst die serielle Verbindung (**VAN PI USB JST**) trennen und erst danach die Stromversorgung bzw. Masseverbindung lösen.

Andernfalls können unerwünschte Ströme über die serielle Schnittstelle fließen und den **VAN PI Core beschädigen**.

{% embed url="<https://pekaway.de/collections/alle-produkte/products/van-pi-usb-jst-fur-victron>" %}
