Updated external content (Jenkins build 2129)

_addons_bindings/energidataservice/readme.md

@@ -185,6 +185,14 @@ A persistence configuration is required for this channel.
 Please note that the CO₂ emission channels only apply to Denmark.
 These channels will not be updated when the configured price area is not DK1 or DK2.
 
+#### Trigger Channels
+
+Advanced channel `event` can trigger the following events:
+
+| Event                | Description                    |
+|----------------------|--------------------------------|
+| DAY_AHEAD_AVAILABLE  | Day-ahead prices are available |
+
 ## Thing Actions
 
 Thing actions can be used to perform calculations as well as import prices directly into rules without relying on persistence.
@@ -576,3 +584,36 @@ console.log("Spot price two hours from now: " + price);
 :::
 
 ::::
+
+### Trigger Channel Example
+
+:::: tabs
+
+::: tab DSL
+
+```javascript
+rule "Day-ahead event"
+when
+    Channel 'energidataservice:service:energidataservice:electricity#event' triggered 'DAY_AHEAD_AVAILABLE'
+then
+    logInfo("Day-ahead", "Day-ahead prices for the next day are now available")
+end
+```
+
+:::
+
+::: tab JavaScript
+
+```javascript
+rules.when()
+    .channel('energidataservice:service:energidataservice:electricity#event').triggered('DAY_AHEAD_AVAILABLE')
+    .then(event =>
+    {
+        console.log('Day-ahead prices for the next day are now available');
+    })
+    .build("Day-ahead event");
+```
+
+:::
+
+::::

_addons_bindings/serial/readme.md

@@ -70,8 +70,8 @@ The configuration for the `serialBridge` consists of the following parameters:
 The configuration for the `serialDevice` consists of the following parameters:
 
 | Parameter    | Description                                                                                                                                        |
-| ------------ | ----------------------------------------------------------------------------------------------------- |
+| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| patternMatch | Regular expression used to identify device from received data (must match the whole line) (mandatory) |
+| patternMatch | Regular expression used to identify device from received data (must match the whole line). Use .* when having only one device attached. (mandatory)|
 
 ## Channels
 

_addons_bindings/smaenergymeter/readme.md

@@ -35,6 +35,15 @@ No binding configuration required.
 Usually no manual configuration is required, as the multicast IP address and the port remain on their factory set values.
 Optionally, a refresh interval (in seconds) can be defined.
 
+| Parameter        | Name            | Description                           | Required | Default         |
+|------------------|-----------------|---------------------------------------|----------|-----------------|
+| `serialNumber`   | Serial number   | Serial number of a meter.             | yes      |                 |
+| `mcastGroup`     | Multicast Group | Multicast group used by meter.        | yes      | 239.12.255.254  |
+| `port`           | Port            | Port number used by meter.            | no       | 9522            |
+| `pollingPeriod`  | Polling Period  | Polling period used to readout meter. | no       | 30              |
+
+The polling period parameter is used to trigger readout of meter. In case if two consecutive readout attempts fail thing will report offline status.
+
 ## Channels
 
 | Channel     | Description            |

_addons_transformations/exec/readme.md

@@ -20,6 +20,10 @@ Transforms an input string with an external program.
 Executes an external program and returns the output as a string.
 In the given command line the placeholder `%s` is substituted with the input value.
 
+The provided command line is split on spaces before it is passed to the shell.
+Using single quotes (`'`) splitting can be avoided (e.g. `'%s'` would prevent splitting on spaces within the input value).
+The surrounding single quotes are removed.
+
 The external program must either be in the executable search path of the server process, or an absolute path has to be used.
 
 For security reasons all commands need to be whitelisted.
@@ -38,7 +42,7 @@ numfmt --to=iec-i --suffix=B --padding=7 %s
 
 ### General Setup
 
-**Item**
+#### Item
 
 This will replace the visible label in the UI with the transformation you apply with the command <TransformProgram>.
   
@@ -46,7 +50,7 @@ This will replace the visible label in the UI with the transformation you apply
 String yourItem "Some info  [EXEC(/absolute/path/to/your/<TransformProgram> %s):%s]"
 ```
 
-**Rule**
+#### Rule
 
 ```java
 rule "Your Rule Name"
@@ -68,7 +72,7 @@ Substitute the `/absolute/path/to/your/<TransformProgram>` with
 
 When the input argument for `%s` is `fri` the execution returns a string with the last weekday of the month, formated as readable text.
 
-```
+```shell
 Fri 31 Mar 2017 13:58:47 IST`
 ```
 
@@ -99,9 +103,7 @@ If omitted the default is `%s`, so the input value will be put into the transfor
 
 Please note: This profile is a one-way transformation, i.e. only values from a device towards the item are changed, the other direction is left untouched.
 
-# Further Reading
+## Further Reading
 
 * [Manual](http://man7.org/linux/man-pages/man1/date.1.html) and [tutorial](https://linode.com/docs/tools-reference/tools/use-the-date-command-in-linux/) for date.
 * [Manual](http://man7.org/linux/man-pages/man1/numfmt.1.html) and [tutorial](https://www.pixelbeat.org/docs/numfmt.html) for numfmt.
-
-

_thing_types/org.openhab.binding.energidataservice/src/main/resources/OH-INF/thing/channel-groups.xml

@@ -40,6 +40,7 @@
 				<label>CO₂ Emission Realtime</label>
 				<description>Near up-to-date history for CO₂ emission from electricity consumed in Denmark in g/kWh.</description>
 			</channel>
+			<channel id="event" typeId="event"/>
 		</channels>
 	</channel-group-type>
 

_thing_types/org.openhab.binding.energidataservice/src/main/resources/OH-INF/thing/channel-types.xml

@@ -29,4 +29,15 @@
 		<state readOnly="true" pattern="%.1f %unit%"></state>
 	</channel-type>
 
+	<channel-type id="event" advanced="true">
+		<kind>trigger</kind>
+		<label>Event</label>
+		<description>Event triggered</description>
+		<event>
+			<options>
+				<option value="DAY_AHEAD_AVAILABLE">Day-ahead prices are available</option>
+			</options>
+		</event>
+	</channel-type>
+
 </thing:thing-descriptions>

_thing_types/org.openhab.binding.energidataservice/src/main/resources/OH-INF/thing/thing-service.xml

@@ -14,7 +14,7 @@
 		</channel-groups>
 
 		<properties>
-			<property name="thingTypeVersion">5</property>
+			<property name="thingTypeVersion">6</property>
 		</properties>
 
 		<config-description-ref uri="thing-type:energidataservice:service"/>

_thing_types/org.openhab.binding.smaenergymeter/src/main/resources/OH-INF/thing/energyMeter.xml

@@ -32,6 +32,10 @@
 		</properties>
 
 		<config-description>
+			<parameter name="serialNumber" type="text" required="true">
+				<label>Serial number</label>
+				<description>Identifier of meter </description>
+			</parameter>
 			<parameter name="mcastGroup" type="text" required="true">
 				<label>Multicast Group</label>
 				<description>IP address of the multicast group</description>