Merge pull request #316 from Enapter/ty/efoy-n-series

feat(blueprint): add EFOY H2 N-Series cabinet

.github/workflows/linter.yml

@@ -26,7 +26,7 @@ jobs:
         if: steps.changed-lua-files.outputs.any_changed == 'true'
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          version: v0.16.1
+          version: v0.20.0
           args: --check --allow-hidden --respect-ignores ${{ steps.changed-lua-files.outputs.all_changed_files }}
       - name: Lint Code Base
         uses: github/super-linter/slim@v4

.marketplace/devices/devices.yml

@@ -787,3 +787,13 @@
   blueprint_options:
     - blueprint: relays/shelly_2pm
       verification_level: verified
+
+- id: efoy-h2-cabinet-n-series
+  display_name: EFOY H2 Cabinet N-Series
+  description: Indoor cabinet solutions for EFOY Hydrogen fuel cells
+  icon: enapter-fuel-cell
+  vendor: efoy
+  category: fuel_cells
+  blueprint_options:
+    - blueprint: fuel_cells/efoy_h2_cabinet_n_series
+      verification_level: ready_for_testing

.marketplace/vendors/vendors.yml

@@ -247,3 +247,8 @@
   display_name: Shelly
   icon_url: https://raw.githubusercontent.com/Enapter/marketplace/main/.marketplace/vendors/icons/shelly.png
   website: https://www.shelly.com
+
+- id: efoy
+  display_name: EFOY
+  icon_url: https://raw.githubusercontent.com/Enapter/marketplace/main/.marketplace/vendors/icons/efoy.png
+  website: https://www.efoy.com/

.pre-commit-config.yaml

@@ -12,6 +12,6 @@ repos:
     hooks:
       - id: markdownlint
   - repo: https://github.com/JohnnyMorganz/StyLua
-    rev: v0.16.1
+    rev: v0.20.0
     hooks:
       - id: stylua-github

fuel_cells/efoy_h2_cabinet_n_series/README.md

@@ -0,0 +1,33 @@
+# EFOY H2 Cabinet N-Series for Arrakis MK4 IPC
+
+This [Enapter Device Blueprint](https://go.enapter.com/marketplace-readme) integrates **EFOY H2 Cabinet N-Series** - indoor cabinet solution for EFOY Hydrogen fuel cells. Thanks to FC Controller it's possible to monitor and control via [ModBus RTU](https://go.enapter.com/developers-enapter-modbus) over [RS-485 communication interface](https://go.enapter.com/developers-enapter-rs485) optimized for [Arrakis MK4 IPC](https://go.enapter.com/arrakis-mk4-product-page).
+
+## Configuring RS485 Ports of Arrakis MK4
+
+EFOY H2 Cabinet N-Series works over RS-485 port. Arrakis MK4 have universal ports which needs to be configured in BIOS of the IPC to required mode.
+
+1. Reboot IPC and press `Del` button on the keyboard to enter BIOS setup utility.
+2. Navigate to `Advanced` -> `SIO F81804`.
+
+    <img src="./.assets/1-arrakis-mk4-advanced.jpeg" alt="SIO F81804" width="25%" />
+
+3. Select the port you would like to use for connection of gas sensor. `UART Port 1 (ttyS0)` or `UART Port 2 (ttyS1)`.
+
+    <img src="./.assets/2-arrakis-mk4-f81804-conf.jpeg" alt="Arrakis MK4 UART" width="25%" />
+
+3. Set `Peripheral Type` to `RS485` and press `F10` on keyboard to save and exit configuration
+
+    <img src="./.assets/3-arrakis-mk4-uart-1-conf.jpeg" alt="Arrakis MK4 UART" width="25%" />
+
+## Connect to Enapter
+
+- Sign up to the Enapter Cloud using the [Web](https://cloud.enapter.com/) or mobile app ([iOS](https://apps.apple.com/app/id1388329910), [Android](https://play.google.com/store/apps/details?id=com.enapter&hl=en)).
+- Setup [Enapter Gateway](https://go.enapter.com/handbook-gateway-setup) on your Arrakis MK4.
+- [Create vUCM](https://go.enapter.com/handbook-mobile-app) using the mobile app.
+- [Upload](https://go.enapter.com/developers-upload-blueprint) this blueprint to vUCM.
+
+## References
+
+- [EFOY H2 Cabinets product page](https://go.enapter.com/efoy-h2cabinets-product-page);
+- [EFOY H2 Cabinet N-Series Datasheet](https://go.enapter.com/efoy-h2-cabinet-datasheet).
+- [Arrakis MK4 IPC](https://go.enapter.com/arrakis-mk4-product-page)