OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Updated external content (Jenkins build 2336)

pull/2430/head
openHAB Build Server 2024-10-13 05:53:40 +00:00
parent b0173fa9c8
commit c51a945ae0
5 changed files with 56 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
_addons_bindings/fmiweather/readme.md
View File

@ -45,13 +45,13 @@ The binding automatically discovers weather stations and forecasts for nearby pl
## Thing Configuration
### `observation` thing configuration
### `observation` Thing Configuration
| Parameter | Type | Required | Description | Example |
| --------- | ---- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| `fmisid` | text | ✓ | FMI Station ID. You can FMISID of see all weathers stations at [FMI web site](https://en.ilmatieteenlaitos.fi/observation-stations?p_p_id=stationlistingportlet_WAR_fmiwwwweatherportlets&p_p_lifecycle=0&p_p_state=normal&p_p_mode=view&p_p_col_id=column-4&p_p_col_count=1&_stationlistingportlet_WAR_fmiwwwweatherportlets_stationGroup=WEATHER#station-listing) | `"852678"` for Espoo Nuuksio station |
### `forecast` thing configuration
### `forecast` Thing Configuration
| Parameter | Type | Required | Description | Example |
| ---------- | ---- | -------- | ---------------------------------------------------------------------------------------------------- | --------------------------------- |
@ -61,7 +61,7 @@ The binding automatically discovers weather stations and forecasts for nearby pl
Observation and forecast things provide slightly different details on weather.
### `observation` thing channels
### `observation` Thing Channels
Observation channels are grouped in single group, `current`.
@ -84,11 +84,12 @@ You can check the exact observation time by using the `time` channel.
To refer to certain channel, use the normal convention `THING_ID:GROUP_ID#CHANNEL_ID`, e.g. `fmiweather:observation:station_874863_Espoo_Tapiola:current#temperature`.
### `forecast` thing channels
### `forecast` Thing Channels
Forecast has multiple channel groups, one for each forecasted time. The groups are named as follows:
- `forecastNow`: Forecasted weather for the current time
- `forecast`: Forecasted weather (with time series support)
- `forecastNow`: Forecasted weather for the current time (deprecated, please use `forecast` instead)
- `forecastHours01`: Forecasted weather for 1 hours from now
- `forecastHours02`: Forecasted weather for 2 hours from now
- etc.

60
_addons_bindings/goecharger/readme.md
View File

@ -44,35 +44,37 @@ The apiVersion 2 is only available for go-e Charger with new hardware revision (
## Channels
Currently available channels are
| Channel ID | Item Type | Description | API version |
|--------------------------|--------------------------|---------------------------------------------------------------|-------------------|
| maxCurrent | Number:ElectricCurrent | Maximum current allowed to use for charging | 1 (r/w), 2 (r/w) |
| maxCurrentTemp | Number:ElectricCurrent | Maximum current temporary (not written to EEPROM) | 1 (r) |
| pwmSignal | String | Signal status for PWM signal | 1 (r), 2 (r) |
| error | String | Error code of charger | 1 (r), 2 (r) |
| voltageL1 | Number:ElectricPotential | Voltage on L1 | 1 (r), 2 (r) |
| voltageL2 | Number:ElectricPotential | Voltage on L2 | 1 (r), 2 (r) |
| voltageL3 | Number:ElectricPotential | Voltage on L3 | 1 (r), 2 (r) |
| currentL1 | Number:ElectricCurrent | Current on L1 | 1 (r), 2 (r) |
| currentL2 | Number:ElectricCurrent | Current on L2 | 1 (r), 2 (r) |
| currentL3 | Number:ElectricCurrent | Current on L3 | 1 (r), 2 (r) |
| powerL1 | Number:Power | Power on L1 | 1 (r), 2 (r) |
| powerL2 | Number:Power | Power on L2 | 1 (r), 2 (r) |
| powerL3 | Number:Power | Power on L2 | 1 (r), 2 (r) |
| powerAll | Number:Power | Power over all three phases | 1 (r), 2 (r) |
| phases | Number | Amount of phases currently used for charging | 1 (r), 2 (r/w) |
| sessionChargeEnergyLimit | Number:Energy | Wallbox stops charging after defined value, disable with 0 | 1 (r/w), 2 (r/w) |
| sessionChargedEnergy | Number:Energy | Amount of energy that has been charged in this session | 1 (r), 2 (r) |
| totalChargedEnergy | Number:Energy | Amount of energy that has been charged since installation | 1 (r), 2 (r) |
| transaction | Number | 0 if no card, otherwise card ID | 2 (r/w) |
| allowCharging | Switch | If `ON` charging is allowed | 1 (r/w), 2 (r) |
| cableCurrent | Number:ElectricCurrent | Specifies the max current that can be charged with that cable | 1 (r), 2 (r) |
| temperature | Number:Temperature | Temperature of the curciuit board of the go-e Charger | 1 (r), 2 (r) |
| temperatureType2Port | Number:Temperature | Temperature of the type 2 port of the go-e Charger | 2 (r) |
| firmware | String | Firmware Version | 1 (r), 2 (r) |
| accessConfiguration | String | Access configuration, for example OPEN, RFID ... | 1 (r/w) |
| forceState | Number | Force state (Neutral=0, Off=1, On=2) | 2 (r/w) |
Currently available channels are:
| Channel ID | Item Type | Description | API version |
|--------------------------|--------------------------|---------------------------------------------------------------|------------------|
| maxCurrent | Number:ElectricCurrent | Maximum current allowed to use for charging | 1 (r/w), 2 (r/w) |
| maxCurrentTemp | Number:ElectricCurrent | Maximum current temporary (not written to EEPROM) | 1 (r) |
| pwmSignal | String | Signal status for PWM signal | 1 (r), 2 (r) |
| error | String | Error code of charger | 1 (r), 2 (r) |
| voltageL1 | Number:ElectricPotential | Voltage on L1 | 1 (r), 2 (r) |
| voltageL2 | Number:ElectricPotential | Voltage on L2 | 1 (r), 2 (r) |
| voltageL3 | Number:ElectricPotential | Voltage on L3 | 1 (r), 2 (r) |
| currentL1 | Number:ElectricCurrent | Current on L1 | 1 (r), 2 (r) |
| currentL2 | Number:ElectricCurrent | Current on L2 | 1 (r), 2 (r) |
| currentL3 | Number:ElectricCurrent | Current on L3 | 1 (r), 2 (r) |
| powerL1 | Number:Power | Power on L1 | 1 (r), 2 (r) |
| powerL2 | Number:Power | Power on L2 | 1 (r), 2 (r) |
| powerL3 | Number:Power | Power on L2 | 1 (r), 2 (r) |
| powerAll | Number:Power | Power over all three phases | 1 (r), 2 (r) |
| phases | Number | Amount of phases currently used for charging | 1 (r), 2 (r/w) |
| sessionChargeEnergyLimit | Number:Energy | Wallbox stops charging after defined value, disable with 0 | 1 (r/w), 2 (r/w) |
| sessionChargedEnergy | Number:Energy | Amount of energy that has been charged in this session | 1 (r), 2 (r) |
| totalChargedEnergy | Number:Energy | Amount of energy that has been charged since installation | 1 (r), 2 (r) |
| transaction | Number | 0 if no card, otherwise card ID | 2 (r/w) |
| allowCharging | Switch | If `ON` charging is allowed | 1 (r/w), 2 (r) |
| cableCurrent | Number:ElectricCurrent | Specifies the max current that can be charged with that cable | 1 (r), 2 (r) |
| temperature | Number:Temperature | Temperature of the curciuit board of the go-e Charger | 1 (r), 2 (r) |
| temperatureType2Port | Number:Temperature | Temperature of the type 2 port of the go-e Charger | 2 (r) |
| firmware | String | Firmware Version | 1 (r), 2 (r) |
| accessConfiguration | String | Access configuration, for example OPEN, RFID ... | 1 (r/w) |
| forceState | Number | Force state (Neutral=0, Off=1, On=2) | 2 (r/w) |
| awattarMaxPrice | Number | Awattar Max Price in ct | 2 (r/w) |
## Full Example

8
_thing_types/org.openhab.binding.fmiweather/src/main/resources/OH-INF/thing/thing-types.xml
View File

@ -28,6 +28,10 @@
<description>Finnish Meteorological Institute (FMI) weather forecast</description>
<channel-groups>
<channel-group id="forecast" typeId="group-forecast">
<label>Forecast</label>
<description>This is the weather forecast</description>
</channel-group>
<channel-group id="forecastNow" typeId="group-forecast">
<label>Forecast for the Current Time</label>
<description>This is the weather forecast for the current time</description>
@ -234,6 +238,10 @@
</channel-group>
</channel-groups>
<properties>
<property name="thingTypeVersion">1</property>
</properties>
<config-description>
<parameter name="location" type="text" required="true">
<label>Location</label>

10
_thing_types/org.openhab.binding.goecharger/src/main/resources/OH-INF/thing/thing-types.xml
View File

@ -9,6 +9,7 @@
<description>Go-eCharger thing that represents the wallbox configuration and readings</description>
<channels>
<channel id="awattarMaxPrice" typeId="awp"/>
<channel id="maxCurrent" typeId="current"/>
<channel id="maxCurrentTemp" typeId="maxCurrTmp"/>
<channel id="pwmSignal" typeId="pwm"/>
@ -37,6 +38,10 @@
<channel id="temperature" typeId="tmp"/>
</channels>
<properties>
<property name="thingTypeVersion">1</property>
</properties>
<config-description>
<parameter name="ip" type="text" required="true">
<label>IP Address</label>
@ -178,6 +183,11 @@
<description>Force state (Neutral=0, Off=1, On=2)</description>
<state readOnly="true"/>
</channel-type>
<channel-type id="awp">
<item-type>Number</item-type>
<label>Awatttar Max Price</label>
<state pattern="%.2f"/>
</channel-type>
<channel-type id="scl">
<item-type>Number:Energy</item-type>
<label>Current Session Charge Energy Limit</label>

2
installation/openhabian.md
View File

@ -75,7 +75,7 @@ openHABian can run on x86 based systems but on those you need to install the OS
Anything else ARM based such as ODroids, OrangePis and the like may work or not.
NAS servers such as QNAP and Synology boxes will not work.
We strongly recommend Raspberry Pi 2, 3 or 4 systems that have 1 GB of RAM or more.
We strongly recommend a Raspberry Pi 2 or newer that has 1 GB of RAM or more.
RPi 1 and 0/0W just have a single CPU core and only 512 MB of RAM. The RPi0W2 has 4 cores but only 512 MB as well.
512 MB can be sufficient to run a smallish openHAB setup, but it will not be enough to run a full-blown system with many bindings and memory consuming openHABian features/components such as zram or InfluxDB.
We do not actively prohibit installation on any hardware, including unsupported systems, but we might skip or deny to install specific extensions such as those memory hungry applications named above.