Updated external content (Jenkins build 451)
openHAB Build Server
parent
c3c11991f4
commit
069580537a
File diff suppressed because one or more lines are too long
|
|
@ -0,0 +1,75 @@
|
|||
---
|
||||
id: semsportal
|
||||
label: SEMSPortal
|
||||
title: SEMSPortal - Bindings
|
||||
type: binding
|
||||
description: "This binding can help you include statistics of your SEMS / GoodWe solar panel installation into openHAB."
|
||||
since: 3x
|
||||
logo: images/addons/semsportal.png
|
||||
install: manual
|
||||
---
|
||||
|
||||
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# SEMSPortal Binding
|
||||
|
||||
This binding can help you include statistics of your SEMS / GoodWe solar panel installation into openHAB.
|
||||
It is a read-only connection that maps collected parameters to openHAB channels.
|
||||
It provides current, day, month and total yields, as well as some income statistics if you have configured these in the SEMS portal.
|
||||
It requires a power station that is connected through the internet to the SEMS portal.
|
||||
|
||||
## Supported Things
|
||||
|
||||
This binding provides two Thing types: a bridge to the SEMS Portal, and the Power Stations which are found at the Portal.
|
||||
The Portal (semsportal:portal) represents your account in the SEMS portal.
|
||||
The Power Station (semsportal:station) is an installation of a Power Station or inverter that reports to the SEMS portal and is available to your account.
|
||||
|
||||
## Discovery
|
||||
|
||||
Once you have configured a Portal Bridge, the binding will discover all Power Stations that are available to this account.
|
||||
You can trigger discovery in the add new Thing section of openHAB.
|
||||
Select the SEMS binding and press the Scan button.
|
||||
The discovered Power Stations will appear as new Things.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
The configuration of the Portal Thing (Bridge) is pretty straight forward.
|
||||
You need to have your power station set up in the SEMS portal, and you need to have an account that is allowed to view the power station data.
|
||||
You should log in at least once in the portal with this account to activate it.
|
||||
The Portal needs the username and password to connect and retrieve the data.
|
||||
You can configure the update frequency between 1 and 60 minutes.
|
||||
The default is 5 minutes.
|
||||
|
||||
Power Stations have no settings and will be auto discovered when you add a Portal Bridge.
|
||||
|
||||
## Channels
|
||||
|
||||
The Portal(Bridge) has no channels.
|
||||
The Power Station Thing has the following channels:
|
||||
|
||||
| channel | type | description |
|
||||
| ------------- | ---------------- | ---------------------------------------------------------------------------------------------------------- |
|
||||
| lastUpdate | DateTime | Last time the powerStation sent information to the portal |
|
||||
| currentOutput | Number:Power | The current output of the powerStation in Watt |
|
||||
| todayTotal | Number:Energy | Todays total generation of the station in kWh |
|
||||
| monthTotal | Number:Energy | This month's total generation of the station in kWh |
|
||||
| overallTotal | Number:Energy | The total generation of the station since installation, in kWh |
|
||||
| todayIncome | Number | Todays income as reported by the portal, if you have configured the power rates of your energy provider |
|
||||
| totalIncome | Number | The total income as reported by the portal, if you have configured the power rates of your energy provider |
|
||||
|
||||
## Parameters
|
||||
|
||||
The PowerStation Thing has no parameters.
|
||||
Only the Bridge has the following configuration parameters:
|
||||
|
||||
| Parameter | Required? | Description |
|
||||
| ----------- |:---------:| ---------------------------------------------------------------------------------------------------------- |
|
||||
| username | X | Account name (email address) at the SEMS portal. Account must have been used at least once to log in. |
|
||||
| password | X | Password of the SEMS portal |
|
||||
| update | | Number of minutes between two updates. Between 1 and 60 minutes, defaults to 5 minutes |
|
||||
|
||||
## Credits
|
||||
|
||||
This binding has been created using the information provided by RogerG007 in this forum topic: https://community.openhab.org/t/connecting-goodwe-solar-panel-inverter-to-openhab/85480
|
||||
|
|
@ -366,6 +366,7 @@
|
|||
<item-type>String</item-type>
|
||||
<label>Selected Program</label>
|
||||
<description>This state describes the selected program of the home appliance.</description>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="remaining_program_time_state">
|
||||
<item-type>Number:Time</item-type>
|
||||
|
|
@ -425,6 +426,7 @@
|
|||
<option value="LaundryCare.Washer.EnumType.Temperature.UlExtraHot">Extra hot (US/CA)</option>
|
||||
</options>
|
||||
</state>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="laundry_care_washer_spin_speed">
|
||||
<item-type>String</item-type>
|
||||
|
|
@ -447,6 +449,7 @@
|
|||
<option value="LaundryCare.Washer.EnumType.SpinSpeed.UlHigh">High (US/CA)</option>
|
||||
</options>
|
||||
</state>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="laundry_care_washer_idos1">
|
||||
<item-type>String</item-type>
|
||||
|
|
@ -461,6 +464,7 @@
|
|||
<option value="LaundryCare.Washer.EnumType.IDosingLevel.Strong">Strong</option>
|
||||
</options>
|
||||
</state>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="laundry_care_washer_idos2">
|
||||
<item-type>String</item-type>
|
||||
|
|
@ -475,6 +479,7 @@
|
|||
<option value="LaundryCare.Washer.EnumType.IDosingLevel.Strong">Strong</option>
|
||||
</options>
|
||||
</state>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="setpoint_temperature_refrigerator">
|
||||
<item-type>Number:Temperature</item-type>
|
||||
|
|
@ -508,6 +513,7 @@
|
|||
<label>Drying Target</label>
|
||||
<description>Specifies the desired dryness setting.</description>
|
||||
<state readOnly="false"/>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="hood_venting_level">
|
||||
<item-type>String</item-type>
|
||||
|
|
|
|||
|
|
@ -30,7 +30,7 @@
|
|||
<state readOnly="true"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="keypress">
|
||||
<channel-type id="key-press">
|
||||
<item-type>Contact</item-type>
|
||||
<label>Key Pressed</label>
|
||||
<state readOnly="true"/>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,96 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="semsportal"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:thing="https://openhab.org/schemas/thing-description/v1.0.0"
|
||||
xsi:schemaLocation="https://openhab.org/schemas/thing-description/v1.0.0 https://openhab.org/schemas/thing-description-1.0.0.xsd">
|
||||
|
||||
<bridge-type id="portal">
|
||||
<label>SEMS Portal</label>
|
||||
<description>The SEMS Portal is where the data about powerstations is collected online.
|
||||
Configuration will only work if
|
||||
you have used this account at least once in the portal itsself.</description>
|
||||
|
||||
<properties>
|
||||
<property name="vendor">GoodWe</property>
|
||||
</properties>
|
||||
<representation-property>username</representation-property>
|
||||
|
||||
<config-description>
|
||||
<parameter name="username" type="text" required="true">
|
||||
<label>Username</label>
|
||||
<description>Username (email address) of the account at the SEMS portal</description>
|
||||
</parameter>
|
||||
<parameter name="password" type="text" required="true">
|
||||
<context>password</context>
|
||||
<label>Password</label>
|
||||
<description>Password of the SEMS Portal</description>
|
||||
</parameter>
|
||||
<parameter name="interval" type="integer" min="1" max="60" unit="min">
|
||||
<label>Interval</label>
|
||||
<description>Number of minutes between updates. Minimum is 1 minute, maximum is 60. The default is 5 minutes.</description>
|
||||
<default>5</default>
|
||||
</parameter>
|
||||
</config-description>
|
||||
</bridge-type>
|
||||
|
||||
<thing-type id="station" listed="false">
|
||||
<supported-bridge-type-refs>
|
||||
<bridge-type-ref id="portal"/>
|
||||
</supported-bridge-type-refs>
|
||||
|
||||
<label>Power Station</label>
|
||||
<description>A Power Station is the GoodWe converter that is connected through the internet with the SEMSPortal.</description>
|
||||
|
||||
<channels>
|
||||
<channel id="lastUpdate" typeId="lastUpdate"/>
|
||||
<channel id="currentOutput" typeId="currentOutput"/>
|
||||
<channel id="todayTotal" typeId="todayTotal"/>
|
||||
<channel id="monthTotal" typeId="monthTotal"/>
|
||||
<channel id="overallTotal" typeId="overallTotal"/>
|
||||
<channel id="todayIncome" typeId="todayIncome"/>
|
||||
<channel id="totalIncome" typeId="totalIncome"/>
|
||||
</channels>
|
||||
|
||||
</thing-type>
|
||||
|
||||
|
||||
<channel-type id="lastUpdate">
|
||||
<item-type>DateTime</item-type>
|
||||
<label>Last Update</label>
|
||||
<description>Timestamp that the last information was received from the station. This is not the same as the last time
|
||||
that was checked: the station goes offline at night.</description>
|
||||
</channel-type>
|
||||
<channel-type id="currentOutput">
|
||||
<item-type>Number:Power</item-type>
|
||||
<label>Current Output</label>
|
||||
<description>Current output in Watts</description>
|
||||
</channel-type>
|
||||
<channel-type id="todayTotal">
|
||||
<item-type>Number:Energy</item-type>
|
||||
<label>Todays Total Output</label>
|
||||
<description>Todays total output in kWh</description>
|
||||
</channel-type>
|
||||
<channel-type id="monthTotal">
|
||||
<item-type>Number:Energy</item-type>
|
||||
<label>Current Month Total Output</label>
|
||||
<description>The total output of this month in kWh</description>
|
||||
</channel-type>
|
||||
<channel-type id="overallTotal">
|
||||
<item-type>Number:Energy</item-type>
|
||||
<label>Overall Total Output</label>
|
||||
<description>The total output from the start of the installation in kWh</description>
|
||||
</channel-type>
|
||||
<channel-type id="todayIncome">
|
||||
<item-type>Number</item-type>
|
||||
<label>Todays Income</label>
|
||||
<description>Todays income. Only reports if you have set the tariffs in the SEMS portal. Unit is the currency that is
|
||||
set in these tariffs.</description>
|
||||
</channel-type>
|
||||
<channel-type id="totalIncome">
|
||||
<item-type>Number</item-type>
|
||||
<label>Total Income</label>
|
||||
<description>Total income since installation. Only reports if you have set the tariffs in the SEMS portal. Unit is the
|
||||
currency that is set in these tariffs.</description>
|
||||
</channel-type>
|
||||
|
||||
</thing:thing-descriptions>
|
||||
Loading…
Reference in New Issue