Merge branch 'main' into easee-dev

Signed-off-by: Alexander Friese <alexf2015@users.noreply.github.com>

Author: alexf2015

.github/markdownlint.yaml

@@ -0,0 +1,39 @@
+# From: https://github.com/openhab/openhab-docs/blob/main/.github/.markdownlint.yaml
+
+default: true
+
+# Expect dash usage for unordered lists
+MD004:
+  style: dash
+
+# Allow long line lengths
+MD013: false
+
+# Allow duplicate headers for different nesting
+MD024:
+  siblings_only: true
+
+# Allow Multiple top level headers in the same document
+MD025: false
+
+# Allow trailing punctuation in headers
+MD026: false
+MD029:
+  style: one
+
+# Allow inline HTML
+MD033: false
+
+# Code block style
+MD046:
+  style: fenced
+
+# Emphasis in underscore
+MD049:
+  style: underscore
+
+# Strong in asterisk
+MD050:
+  style: asterisk
+
+MD060: false

.github/scripts/maven-build

@@ -14,16 +14,58 @@ function print_reactor_summary() {
     cat "$BUILD_LOG" | sed -n "${start},${end}p" | sed 's/\[INFO\] //'
 }
 
+gha_escape() {
+  sed -e 's/%/%25/g' -e 's/\r/%0D/g' -e 's/\n/%0A/g'
+}
+
+emit_markdownlint_annotations() {
+  [[ -f "$BUILD_LOG" ]] || return 0
+
+  while IFS= read -r l; do
+    file=$(echo "$l" | sed -E 's/^([^:]+\.md):.*/\1/')
+    line=$(echo "$l" | sed -E 's/^[^:]+\.md:([0-9]+).*/\1/')
+
+    # Repair path so GitHub can link it (repo-root relative)
+    if [[ ! -f "$file" ]]; then
+      if [[ -f "bundles/$file" ]]; then
+        file="bundles/$file"
+      elif [[ -f "itests/$file" ]]; then
+        file="itests/$file"
+      fi
+    fi
+
+    if echo "$l" | grep -qE '^[^:]+\.md:[0-9]+:[0-9]+ error MD'; then
+      col=$(echo "$l" | sed -E 's/^[^:]+\.md:[0-9]+:([0-9]+) error .*/\1/')
+      rule=$(echo "$l" | sed -E 's/^[^:]+\.md:[0-9]+:[0-9]+ error (MD[^ ]+) .*/\1/')
+      rest=$(echo "$l" | sed -E 's/^[^:]+\.md:[0-9]+:[0-9]+ error MD[^ ]+ (.*)$/\1/')
+      rest_esc=$(printf '%s' "$rest" | gha_escape)
+      echo "::error file=$file,line=$line,col=$col,title=$rule::$rest_esc"
+    else
+      rule=$(echo "$l" | sed -E 's/^[^:]+\.md:[0-9]+ error (MD[^ ]+) .*/\1/')
+      rest=$(echo "$l" | sed -E 's/^[^:]+\.md:[0-9]+ error MD[^ ]+ (.*)$/\1/')
+      rest_esc=$(printf '%s' "$rest" | gha_escape)
+      echo "::error file=$file,line=$line,title=$rule::$rest_esc"
+    fi
+  done < <(
+    grep -aE '\[INFO\] .*\.md:[0-9]+(:[0-9]+)? error MD' "$BUILD_LOG" \
+    | sed -E 's/^.*\[INFO\] //'
+  )
+}
+
 function mvnp() {
-    set -o pipefail # exit build with error when pipes fail
-    local reactor_size=$(find -name "pom.xml" | grep -vE '/src/|/target/' | wc -l)
-    local padding=$(bc -l <<< "scale=0;2*(l($reactor_size)/l(10)+1)")
-    local command=(./mvnw $@)
-    exec "${command[@]}" 2>&1 | # execute, redirect stderr to stdout
-        tee "$BUILD_LOG" | # write output to log
-        stdbuf -oL grep -aE '^\[INFO\] Building .+ \[.+\]$' | # filter progress
-        stdbuf -o0 sed -uE 's/^\[INFO\] Building (.*[^ ])[ ]+\[([0-9]+\/[0-9]+)\]$/\2| \1/' | # prefix project name with progress
-        stdbuf -o0 sed -e :a -e "s/^.\{1,${padding}\}|/ &/;ta" # right align progress with padding
+  set -o pipefail # exit build with error when pipes fail
+  local reactor_size=$(find -name "pom.xml" | grep -vE '/src/|/target/' | wc -l)
+  local padding=$(bc -l <<< "scale=0;2*(l($reactor_size)/l(10)+1)")
+  local command=(bash ./mvnw "$@")
+
+  "${command[@]}" 2>&1 | # execute, redirect stderr to stdout
+    tee "$BUILD_LOG" | # write output to log
+    stdbuf -oL grep -aE '^\[INFO\] Building .+ \[.+\]$' | # filter progress
+    stdbuf -o0 sed -uE 's/^\[INFO\] Building (.*[^ ])[ ]+\[([0-9]+\/[0-9]+)\]$/\2| \1/' | # prefix project name with progress
+    stdbuf -o0 sed -e :a -e "s/^.\{1,${padding}\}|/ &/;ta" # right align progress with padding
+
+  # Exit code of Maven is the first command in the pipeline
+  return "${PIPESTATUS[0]}"
 }
 
 function build_all() {
@@ -38,6 +80,8 @@ function build_all() {
     status=$?
     echo
 
+	emit_markdownlint_annotations
+
     if [ $status -eq 0 ]; then
         print_reactor_summary
     else
@@ -104,5 +148,5 @@ function build_based_on_changes() {
     fi
 }
 
-./mvnw -v
+bash ./mvnw -v
 build_based_on_changes

.github/workflows/ci-build.yml

@@ -67,7 +67,7 @@ jobs:
 
       - name: Build
         id: build
-        run: './.github/scripts/maven-build'
+        run: bash './.github/scripts/maven-build'
         env:
           CHANGED_FILES: ${{ steps.files.outputs.all }}
           MAVEN_OPTS: >-
@@ -78,14 +78,14 @@ jobs:
 
       - name: Upload Build Log
         if: ${{ always() && ((steps.build.outcome == 'success') || (steps.build.outcome == 'failure')) }}
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: build-log-java-${{ matrix.java }}-${{ matrix.os }}
           path: build.log
 
       - name: Upload SAT Summary Report
         if: ${{ always() && ((steps.build.outcome == 'success') || (steps.build.outcome == 'failure')) }}
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: sat-summary-report
           path: target/summary_report.html

.mvn/wrapper/maven-wrapper.properties

@@ -16,5 +16,5 @@
 # under the License.
 wrapperVersion=3.3.2
 distributionType=only-script
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.12/apache-maven-3.9.12-bin.zip
-distributionSha256Sum=305773a68d6ddfd413df58c82b3f8050e89778e777f3a745c8e5b8cbea4018ef
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.13/apache-maven-3.9.13-bin.zip
+distributionSha512Sum=43f82fc40a65079528c0037856c95b8aa04bd74c9851b01225c61c5debeb5e3b7d2acd1266979b4ea359887dfc26f176932b5f10eb47d684add97d262a821592

AGENTS.md

@@ -34,8 +34,9 @@ repo root folder
 #### Comments and Documentation
 - Add meaningful code comments where helpful
 - Avoid obvious comments (e.g., `// constructor`)
-- Use JavaDoc for API/class/method documentation
+- Use Javadoc for API/class/method documentation
 - Follow guidelines at: https://www.openhab.org/docs/developer/guidelines.html
+- Follow checklist at: https://github.com/openhab/openhab-addons/wiki/Review-Checklist
 
 #### Import Organization
 - Sort imports alphabetically
@@ -70,6 +71,10 @@ When upgrading Maven dependencies:
 - Reference documentation: https://bnd.bndtools.org/chapters/825-instructions-ref.html
 - Used to define OSGi runtime configurations for testing
 
+### OH-INF/i18n/*_xx.properties
+- I18N properties files for specific languages, e.g. foobar_de.properties, should be omitted.
+- Reference documentation: https://www.openhab.org/docs/developer/utils/i18n.html#managing-translations
+
 ### AGENTS.md
 There might be AGENTS.md files in subfolders. Consider them when files from that binding are open in the editor:
 - bundles/org.openhab.*/AGENTS.md
@@ -91,6 +96,10 @@ There might be AGENTS.md files in subfolders. Consider them when files from that
 - **GitHub Username:** Must match pattern `[a-z0-9]*` 
 - **Author Name:** Can contain spaces (use quotes when scripting)
 
+### Declare Connnection
+- Declare connection in OH-INF/addon/addon.xml
+- Reference documentation: https://www.openhab.org/docs/developer/addons/addon.html#xml-structure-for-add-on-definitions
+
 ### Creation Process
 
 Important: Run all the following commands from repo root folder.

CODEOWNERS

@@ -34,6 +34,7 @@
 /bundles/org.openhab.binding.astro/ @gerrieg
 /bundles/org.openhab.binding.asuswrt/ @wildcs
 /bundles/org.openhab.binding.atlona/ @mlobstein
+/bundles/org.openhab.binding.atmofrance/ @clinique
 /bundles/org.openhab.binding.autelis/ @digitaldan
 /bundles/org.openhab.binding.automower/ @maxpg
 /bundles/org.openhab.binding.avmfritz/ @cweitkamp
@@ -75,6 +76,7 @@
 /bundles/org.openhab.binding.cm11a/ @BobRak
 /bundles/org.openhab.binding.comfoair/ @boehan
 /bundles/org.openhab.binding.coolmasternet/ @projectgus
+/bundles/org.openhab.binding.dahuadoor/ @svnsssd
 /bundles/org.openhab.binding.daikin/ @caffineehacker
 /bundles/org.openhab.binding.dali/ @rs22
 /bundles/org.openhab.binding.danfossairunit/ @pravussum
@@ -110,6 +112,7 @@
 /bundles/org.openhab.binding.emotiva/ @espenaf
 /bundles/org.openhab.binding.energenie/ @hmerk
 /bundles/org.openhab.binding.energidataservice/ @jlaur
+/bundles/org.openhab.binding.energyforecast/ @weymann
 /bundles/org.openhab.binding.enigma2/ @gdolfen
 /bundles/org.openhab.binding.enocean/ @fruggy83
 /bundles/org.openhab.binding.enphase/ @Hilbrand
@@ -208,6 +211,7 @@
 /bundles/org.openhab.binding.lgtvserial/ @fa2k
 /bundles/org.openhab.binding.lgwebos/ @sprehn
 /bundles/org.openhab.binding.lifx/ @wborn
+/bundles/org.openhab.binding.linkplay/ @digitaldan
 /bundles/org.openhab.binding.linktap/ @dag81
 /bundles/org.openhab.binding.linky/ @clinique @lolodomo
 /bundles/org.openhab.binding.linuxinput/ @t-8ch
@@ -263,7 +267,6 @@
 /bundles/org.openhab.binding.mqtt.fpp/ @computergeek1507
 /bundles/org.openhab.binding.mqtt.ruuvigateway/ @ssalonen
 /bundles/org.openhab.binding.mspa/ @weymann
-/bundles/org.openhab.binding.mybmw/ @ntruchsess @mherwege @martingrassl
 /bundles/org.openhab.binding.mycroft/ @dalgwen
 /bundles/org.openhab.binding.mynice/ @clinique
 /bundles/org.openhab.binding.mystrom/ @pail23
@@ -415,7 +418,9 @@
 /bundles/org.openhab.binding.tr064/ @J-N-K
 /bundles/org.openhab.binding.tradfri/ @cweitkamp @kaikreuzer
 /bundles/org.openhab.binding.tuya/ @J-N-K
+/bundles/org.openhab.binding.twilio/ @digitaldan
 /bundles/org.openhab.binding.unifi/ @mgbowman @Hilbrand
+/bundles/org.openhab.binding.unifiaccess/ @digitaldan
 /bundles/org.openhab.binding.unifiedremote/ @GiviMAD
 /bundles/org.openhab.binding.unifiprotect/ @digitaldan
 /bundles/org.openhab.binding.upb/ @marcusb
@@ -473,13 +478,15 @@
 /bundles/org.openhab.persistence.mapdb/ @openhab/add-ons-maintainers
 /bundles/org.openhab.persistence.mongodb/ @openhab/add-ons-maintainers
 /bundles/org.openhab.persistence.rrd4j/ @openhab/add-ons-maintainers
+/bundles/org.openhab.persistence.timescaledb/ @ulbi
 /bundles/org.openhab.transform.basicprofiles/ @cweitkamp @J-N-K
 /bundles/org.openhab.transform.bin2json/ @paulianttila
 /bundles/org.openhab.transform.exec/ @openhab/add-ons-maintainers
 /bundles/org.openhab.transform.geocoding/ @weymann
 /bundles/org.openhab.transform.jinja/ @jochen314
 /bundles/org.openhab.transform.jsonpath/ @clinique
 /bundles/org.openhab.transform.map/ @openhab/add-ons-maintainers
+/bundles/org.openhab.transform.math/ @cweitkamp
 /bundles/org.openhab.transform.regex/ @openhab/add-ons-maintainers
 /bundles/org.openhab.transform.rollershutterposition/ @jsjames
 /bundles/org.openhab.transform.scale/ @clinique

README.md

@@ -85,11 +85,12 @@ mvn clean install karaf:kar -pl :org.openhab.binding.astro
 To improve build times you can add the following options to the command:
 
 | Option                        | Description                                         |
-| ----------------------------- | --------------------------------------------------- |
+|-------------------------------|-----------------------------------------------------|
 | `-DskipChecks`                | Skip the static analysis (Checkstyle, FindBugs)     |
 | `-DskipTests`                 | Skip the execution of tests                         |
 | `-Dmaven.test.skip=true`      | Skip the compilation and execution of tests         |
 | `-Dfeatures.verify.skip=true` | Skip the Karaf feature verification                 |
+| `-Dmarkdownlint.skip=true`    | Skip the Markdown linting                           |
 | `-Dspotless.check.skip=true`  | Skip the Spotless code style checks                 |
 | `-o`                          | Work offline so Maven does not download any updates |
 | `-T 1C`                       | Build in parallel, using 1 thread per core          |

bom/openhab-addons/pom.xml

@@ -161,6 +161,11 @@
       <artifactId>org.openhab.binding.atlona</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.atmofrance</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.autelis</artifactId>
@@ -361,6 +366,11 @@
       <artifactId>org.openhab.binding.coolmasternet</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.dahuadoor</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.daikin</artifactId>
@@ -536,6 +546,11 @@
       <artifactId>org.openhab.binding.energidataservice</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.energyforecast</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.enigma2</artifactId>
@@ -1026,6 +1041,11 @@
       <artifactId>org.openhab.binding.lifx</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.linkplay</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.linktap</artifactId>
@@ -1301,11 +1321,6 @@
       <artifactId>org.openhab.binding.mycroft</artifactId>
       <version>${project.version}</version>
     </dependency>
-    <dependency>
-      <groupId>org.openhab.addons.bundles</groupId>
-      <artifactId>org.openhab.binding.mybmw</artifactId>
-      <version>${project.version}</version>
-    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.mynice</artifactId>
@@ -2056,11 +2071,21 @@
       <artifactId>org.openhab.binding.tuya</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.twilio</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.unifi</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.unifiaccess</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.unifiedremote</artifactId>
@@ -2346,6 +2371,11 @@
       <artifactId>org.openhab.persistence.rrd4j</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.persistence.timescaledb</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.transform.basicprofiles</artifactId>
@@ -2381,6 +2411,11 @@
       <artifactId>org.openhab.transform.map</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.transform.math</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.transform.regex</artifactId>