From 2b4df1406221767e4fbf521377c0593a76c03a56 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 16 Jun 2024 15:39:08 +0000 Subject: [PATCH] deploy: 1c7caae7323684f4aa71ae2f5575adf85092343a --- 404.html | 4 +- assets/js/0b02251e.43b68093.js | 1 + assets/js/0b02251e.76105950.js | 1 - assets/js/1034e1fe.3d2b46d2.js | 1 + assets/js/2f1957c9.128d2478.js | 1 - assets/js/49425f7e.ccbf429c.js | 1 + assets/js/49425f7e.f8d531d8.js | 1 - assets/js/4ddd2498.1e45c94e.js | 1 + assets/js/a5b914f3.5622e817.js | 1 + assets/js/a5b914f3.e7788a87.js | 1 - assets/js/de2b644d.40cf7a8c.js | 1 - assets/js/f6d78023.9759d006.js | 1 - assets/js/f6d78023.f0300329.js | 1 + assets/js/main.5093ece0.js | 2 + ...CENSE.txt => main.5093ece0.js.LICENSE.txt} | 0 assets/js/main.fda6c74f.js | 2 - ...n.98388eb7.js => runtime~main.81db3202.js} | 2 +- cloud/direct+/index.html | 4 +- cloud/index.html | 4 +- cloud/platform/index.html | 4 +- .../index.html | 42 ++++++++-------- configuration/index.html | 44 +++++++++------- configuration/lobaro-tool/index.html | 12 ++--- .../index.html | 50 +++++++++---------- configuration/usb-config-adapter/index.html | 10 ++-- firmware/app-hybrid-modbus/index.html | 4 +- firmware/app-nrf9160-wmbus/index.html | 4 +- firmware/index.html | 4 +- hardware/extension-modules/index.html | 4 +- hardware/housings/index.html | 4 +- hardware/index.html | 4 +- hardware/mainboards/index.html | 4 +- index.html | 4 +- knowledge-base/doc-playground/index.html | 4 +- knowledge-base/modbus/index.html | 4 +- knowledge-base/wireless-mbus/index.html | 4 +- markdown-page/index.html | 4 +- products/index.html | 4 +- products/metering-gateways/index.html | 4 +- .../hardware-variants/dinrail-v1/index.html | 4 +- .../wired-mbus-g1/index.html | 4 +- .../wired-mbus-g1/manual/cfg/index.html | 4 +- .../wired-mbus-g1/manual/index.html | 4 +- .../wired-mbus-g1/manual/workflow/index.html | 4 +- .../hardware-variants/bridge-v2/index.html | 4 +- .../wireless-mbus-g2/index.html | 4 +- .../wireless-mbus-g2/manual/cfg/index.html | 4 +- .../wireless-mbus-g2/manual/index.html | 4 +- .../manual/workflow/index.html | 4 +- .../concentrator-v1/index.html | 4 +- .../hardware-variants/dinrail-v1/index.html | 4 +- .../discontinued/bridge-v2/index.html | 4 +- .../discontinued/gw-v2/index.html | 4 +- .../hardware-variants/discontinued/index.html | 4 +- .../hardware-variants/gw-v3/index.html | 4 +- .../hardware-variants/gw-v4/desc/index.html | 4 +- .../hardware-variants/gw-v4/index.html | 4 +- .../hardware-variants/sun-v1/index.html | 4 +- .../wireless-mbus-g3/index.html | 4 +- .../wireless-mbus-g3/manual/cfg/index.html | 4 +- .../wireless-mbus-g3/manual/index.html | 4 +- .../manual/workflow/index.html | 4 +- .../sensor-gateways/current-loop/index.html | 4 +- products/sensor-gateways/index.html | 4 +- products/sensor-gateways/level/index.html | 4 +- products/sensor-gateways/modbus/index.html | 4 +- .../sensor-gateways/temperature/index.html | 4 +- sitemap.xml | 2 +- 68 files changed, 184 insertions(+), 178 deletions(-) create mode 100644 assets/js/0b02251e.43b68093.js delete mode 100644 assets/js/0b02251e.76105950.js create mode 100644 assets/js/1034e1fe.3d2b46d2.js delete mode 100644 assets/js/2f1957c9.128d2478.js create mode 100644 assets/js/49425f7e.ccbf429c.js delete mode 100644 assets/js/49425f7e.f8d531d8.js create mode 100644 assets/js/4ddd2498.1e45c94e.js create mode 100644 assets/js/a5b914f3.5622e817.js delete mode 100644 assets/js/a5b914f3.e7788a87.js delete mode 100644 assets/js/de2b644d.40cf7a8c.js delete mode 100644 assets/js/f6d78023.9759d006.js create mode 100644 assets/js/f6d78023.f0300329.js create mode 100644 assets/js/main.5093ece0.js rename assets/js/{main.fda6c74f.js.LICENSE.txt => main.5093ece0.js.LICENSE.txt} (100%) delete mode 100644 assets/js/main.fda6c74f.js rename assets/js/{runtime~main.98388eb7.js => runtime~main.81db3202.js} (59%) rename configuration/{cron-expressions => cron-configuration}/index.html (77%) rename configuration/{remote-config-lorawan => lorawan-downlink-config}/index.html (84%) diff --git a/404.html b/404.html index cadba15b..0e3e56e7 100644 --- a/404.html +++ b/404.html @@ -4,8 +4,8 @@ Lobaro Documentation - - + +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

diff --git a/assets/js/0b02251e.43b68093.js b/assets/js/0b02251e.43b68093.js new file mode 100644 index 00000000..64aea28f --- /dev/null +++ b/assets/js/0b02251e.43b68093.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[3830],{5570:e=>{e.exports=JSON.parse('{"version":{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"htmlSidebar":[{"type":"html","value":"TEST|TEST","defaultStyle":true}],"allDocSidebar":[{"type":"category","label":"All Docs","items":[{"type":"link","label":"Lobaro Documentation","href":"/iot/","docId":"index","unlisted":false},{"type":"category","label":"Products","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Metering Gateways","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Wireless M-BUS (Gen. 3)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g3/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g3/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Gateway V4","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Description","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/"},{"type":"link","label":"Gateway V3","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","unlisted":false},{"type":"link","label":"Gateway DinRail","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","unlisted":false},{"type":"link","label":"Gateway Solar","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","unlisted":false},{"type":"link","label":"Gateway Concentrator","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","unlisted":false},{"type":"category","label":"Discontinued","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","unlisted":false},{"type":"link","label":"Gateway V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/"}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/"},{"type":"category","label":"Wireless M-BUS (Gen. 2)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g2/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g2/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/"},{"type":"category","label":"Wired M-BUS (Gen. 1)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/cfg","docId":"products/metering-gateways/wired-mbus-g1/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/workflow","docId":"products/metering-gateways/wired-mbus-g1/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wired-mbus-g1/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Hybrid Gateway","href":"/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wired-mbus-g1/"}],"href":"/iot/products/metering-gateways/"},{"type":"category","label":"Sensor Gateways","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Current Loop","href":"/iot/products/sensor-gateways/current-loop/","docId":"products/sensor-gateways/current-loop/index","unlisted":false},{"type":"link","label":"Liquid Level","href":"/iot/products/sensor-gateways/level/","docId":"products/sensor-gateways/level/index","unlisted":false},{"type":"link","label":"Modbus","href":"/iot/products/sensor-gateways/modbus/","docId":"products/sensor-gateways/modbus/index","unlisted":false},{"type":"link","label":"Temperature","href":"/iot/products/sensor-gateways/temperature/","docId":"products/sensor-gateways/temperature/index","unlisted":false}],"href":"/iot/products/sensor-gateways/"}],"href":"/iot/products/"},{"type":"category","label":"Firmware","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"app-nrf9160-wmbus","href":"/iot/firmware/app-nrf9160-wmbus/","docId":"firmware/app-nrf9160-wmbus/index","unlisted":false},{"type":"link","label":"app-hybrid-modbus","href":"/iot/firmware/app-hybrid-modbus/","docId":"firmware/app-hybrid-modbus/index","unlisted":false}],"href":"/iot/firmware/"},{"type":"category","label":"Hardware","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Mainboards","href":"/iot/hardware/mainboards/","docId":"hardware/mainboards/index","unlisted":false},{"type":"link","label":"Extension Modules","href":"/iot/hardware/extension-modules/","docId":"hardware/extension-modules/index","unlisted":false},{"type":"link","label":"Device Housings","href":"/iot/hardware/housings/","docId":"hardware/housings/index","unlisted":false}],"href":"/iot/hardware/"},{"type":"category","label":"Lobaro Cloud","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Lobaro Direct+","href":"/iot/cloud/direct+/","docId":"cloud/direct+/index","unlisted":false},{"type":"link","label":"Lobaro IoT Platform","href":"/iot/cloud/platform/","docId":"cloud/platform/index","unlisted":false}],"href":"/iot/cloud/"},{"type":"category","label":"Configuration","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Lobaro USB Config Adapter","href":"/iot/configuration/usb-config-adapter","docId":"configuration/usb-config-adapter","unlisted":false},{"type":"link","label":"Lobaro Config Tool","href":"/iot/configuration/lobaro-tool/","docId":"configuration/lobaro-tool/index","unlisted":false},{"type":"link","label":"CRON Configuration","href":"/iot/configuration/cron-configuration","docId":"configuration/cron-configuration","unlisted":false},{"type":"link","label":"LoRaWAN Downlink Config","href":"/iot/configuration/lorawan-downlink-config","docId":"configuration/lorawan-downlink-config","unlisted":false}],"href":"/iot/configuration/"},{"type":"category","label":"Knowledge Base","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Modbus","href":"/iot/knowledge-base/modbus","docId":"knowledge-base/modbus","unlisted":false},{"type":"link","label":"Wireless M-BUS","href":"/iot/knowledge-base/wireless-mbus","docId":"knowledge-base/wireless-mbus","unlisted":false},{"type":"link","label":"Doc Playground","href":"/iot/knowledge-base/doc-playground/","docId":"knowledge-base/doc-playground/index","unlisted":false}]}],"collapsed":true,"collapsible":true}],"productsSidebar":[{"type":"category","label":"Products","items":[{"type":"link","label":"Introduction","href":"/iot/products/","docId":"products/index","unlisted":false},{"type":"category","label":"Metering Gateways","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Wireless M-BUS (Gen. 3)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g3/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g3/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Gateway V4","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Description","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/"},{"type":"link","label":"Gateway V3","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","unlisted":false},{"type":"link","label":"Gateway DinRail","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","unlisted":false},{"type":"link","label":"Gateway Solar","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","unlisted":false},{"type":"link","label":"Gateway Concentrator","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","unlisted":false},{"type":"category","label":"Discontinued","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","unlisted":false},{"type":"link","label":"Gateway V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/"}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/"},{"type":"category","label":"Wireless M-BUS (Gen. 2)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g2/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g2/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/"},{"type":"category","label":"Wired M-BUS (Gen. 1)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/cfg","docId":"products/metering-gateways/wired-mbus-g1/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/workflow","docId":"products/metering-gateways/wired-mbus-g1/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wired-mbus-g1/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Hybrid Gateway","href":"/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wired-mbus-g1/"}],"href":"/iot/products/metering-gateways/"},{"type":"category","label":"Sensor Gateways","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Current Loop","href":"/iot/products/sensor-gateways/current-loop/","docId":"products/sensor-gateways/current-loop/index","unlisted":false},{"type":"link","label":"Liquid Level","href":"/iot/products/sensor-gateways/level/","docId":"products/sensor-gateways/level/index","unlisted":false},{"type":"link","label":"Modbus","href":"/iot/products/sensor-gateways/modbus/","docId":"products/sensor-gateways/modbus/index","unlisted":false},{"type":"link","label":"Temperature","href":"/iot/products/sensor-gateways/temperature/","docId":"products/sensor-gateways/temperature/index","unlisted":false}],"href":"/iot/products/sensor-gateways/"}],"collapsed":true,"collapsible":true}],"configurationSidebar":[{"type":"category","label":"Configuration","items":[{"type":"link","label":"Introduction","href":"/iot/configuration/","docId":"configuration/index","unlisted":false},{"type":"link","label":"Lobaro USB Config Adapter","href":"/iot/configuration/usb-config-adapter","docId":"configuration/usb-config-adapter","unlisted":false},{"type":"link","label":"Lobaro Config Tool","href":"/iot/configuration/lobaro-tool/","docId":"configuration/lobaro-tool/index","unlisted":false},{"type":"link","label":"CRON Configuration","href":"/iot/configuration/cron-configuration","docId":"configuration/cron-configuration","unlisted":false},{"type":"link","label":"LoRaWAN Downlink Config","href":"/iot/configuration/lorawan-downlink-config","docId":"configuration/lorawan-downlink-config","unlisted":false}],"collapsed":true,"collapsible":true}],"firmwareSidebar":[{"type":"category","label":"Firmware","items":[{"type":"link","label":"Introduction","href":"/iot/firmware/","docId":"firmware/index","unlisted":false},{"type":"link","label":"app-nrf9160-wmbus","href":"/iot/firmware/app-nrf9160-wmbus/","docId":"firmware/app-nrf9160-wmbus/index","unlisted":false},{"type":"link","label":"app-hybrid-modbus","href":"/iot/firmware/app-hybrid-modbus/","docId":"firmware/app-hybrid-modbus/index","unlisted":false}],"collapsed":true,"collapsible":true}],"hardwareSidebar":[{"type":"category","label":"Hardware","items":[{"type":"link","label":"Introduction","href":"/iot/hardware/","docId":"hardware/index","unlisted":false},{"type":"link","label":"Mainboards","href":"/iot/hardware/mainboards/","docId":"hardware/mainboards/index","unlisted":false},{"type":"link","label":"Extension Modules","href":"/iot/hardware/extension-modules/","docId":"hardware/extension-modules/index","unlisted":false},{"type":"link","label":"Device Housings","href":"/iot/hardware/housings/","docId":"hardware/housings/index","unlisted":false}],"collapsed":true,"collapsible":true}],"cloudSidebar":[{"type":"category","label":"Lobaro Cloud","items":[{"type":"link","label":"Introduction","href":"/iot/cloud/","docId":"cloud/index","unlisted":false},{"type":"link","label":"Lobaro Direct+","href":"/iot/cloud/direct+/","docId":"cloud/direct+/index","unlisted":false},{"type":"link","label":"Lobaro IoT Platform","href":"/iot/cloud/platform/","docId":"cloud/platform/index","unlisted":false}],"collapsed":true,"collapsible":true}],"knowledgeBaseSidebar":[{"type":"category","label":"Knowledge Base","items":[{"type":"link","label":"Modbus","href":"/iot/knowledge-base/modbus","docId":"knowledge-base/modbus","unlisted":false},{"type":"link","label":"Wireless M-BUS","href":"/iot/knowledge-base/wireless-mbus","docId":"knowledge-base/wireless-mbus","unlisted":false},{"type":"link","label":"Doc Playground","href":"/iot/knowledge-base/doc-playground/","docId":"knowledge-base/doc-playground/index","unlisted":false}],"collapsed":true,"collapsible":true}]},"docs":{"cloud/direct+/index":{"id":"cloud/direct+/index","title":"Lobaro Direct+","description":"test","sidebar":"cloudSidebar"},"cloud/index":{"id":"cloud/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"cloudSidebar"},"cloud/platform/index":{"id":"cloud/platform/index","title":"Lobaro IoT Platform","description":"Getting Started","sidebar":"cloudSidebar"},"configuration/cron-configuration":{"id":"configuration/cron-configuration","title":"CRON Configuration","description":"We use CRON expressions configure the behavioral timing of our devices. This CRON configuration can be adjusted during","sidebar":"configurationSidebar"},"configuration/index":{"id":"configuration/index","title":"Introduction","description":"Lobaro devices allow a wide range and flexible way of internal configuration adjustments.","sidebar":"configurationSidebar"},"configuration/lobaro-tool/index":{"id":"configuration/lobaro-tool/index","title":"Lobaro Config Tool","description":"The Lobaro Config Tool (a.k.a. Lobaro Maintenance Tool) can be used to configure and diagnose Lobaro devices locally using a PC and our special","sidebar":"configurationSidebar"},"configuration/lorawan-downlink-config":{"id":"configuration/lorawan-downlink-config","title":"LoRaWAN Downlink Config","description":"This article describes the technical details how to remotely configure Lobaro devices that are using LoRaWAN as","sidebar":"configurationSidebar"},"configuration/usb-config-adapter":{"id":"configuration/usb-config-adapter","title":"Lobaro USB Config Adapter","description":"The Lobaro USB configuration adapters connects the configuration serial uart of our devices to a PC. It is used for:","sidebar":"configurationSidebar"},"firmware/app-hybrid-modbus/index":{"id":"firmware/app-hybrid-modbus/index","title":"app-hybrid-modbus","description":"This new documentation center is currently work in progress","sidebar":"firmwareSidebar"},"firmware/app-nrf9160-wmbus/index":{"id":"firmware/app-nrf9160-wmbus/index","title":"app-nrf9160-wmbus","description":"This new documentation center is currently work in progress","sidebar":"firmwareSidebar"},"firmware/index":{"id":"firmware/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"firmwareSidebar"},"hardware/extension-modules/index":{"id":"hardware/extension-modules/index","title":"Hardware Addons","description":"","sidebar":"hardwareSidebar"},"hardware/housings/index":{"id":"hardware/housings/index","title":"Device Housings","description":"","sidebar":"hardwareSidebar"},"hardware/index":{"id":"hardware/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"hardwareSidebar"},"hardware/mainboards/index":{"id":"hardware/mainboards/index","title":"Mainboards","description":"","sidebar":"hardwareSidebar"},"index":{"id":"index","title":"Lobaro Documentation","description":"This new documentation center is currently work in progress","sidebar":"allDocSidebar"},"knowledge-base/doc-playground/index":{"id":"knowledge-base/doc-playground/index","title":"Docusaurus Playground","description":"Location to showcase features and examples for writing content in this doc with is based on Docusaurus.","sidebar":"knowledgeBaseSidebar"},"knowledge-base/modbus":{"id":"knowledge-base/modbus","title":"Modbus","description":"Some notable things in a block quote!","sidebar":"knowledgeBaseSidebar"},"knowledge-base/wireless-mbus":{"id":"knowledge-base/wireless-mbus","title":"Wireless M-BUS","description":"Some notable things in a block quote!","sidebar":"knowledgeBaseSidebar"},"products/index":{"id":"products/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/index":{"id":"products/metering-gateways/index","title":"Metering Gateway","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index":{"id":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","title":"Overview","description":"Some notable things in a block quote!","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/index":{"id":"products/metering-gateways/wired-mbus-g1/index","title":"Wired M-BUS Gateways","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/manual/cfg":{"id":"products/metering-gateways/wired-mbus-g1/manual/cfg","title":"Configuration","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/manual/index":{"id":"products/metering-gateways/wired-mbus-g1/manual/index","title":"Operation Manual","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/manual/workflow":{"id":"products/metering-gateways/wired-mbus-g1/manual/workflow","title":"Workflow","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index":{"id":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/index":{"id":"products/metering-gateways/wireless-mbus-g2/index","title":"Wireless M-BUS Gateways","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/manual/cfg":{"id":"products/metering-gateways/wireless-mbus-g2/manual/cfg","title":"Configuration","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/manual/index":{"id":"products/metering-gateways/wireless-mbus-g2/manual/index","title":"Operation Manual","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/manual/workflow":{"id":"products/metering-gateways/wireless-mbus-g2/manual/workflow","title":"Workflow","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/index","title":"Discontinued Gateways","description":"These products have been discontinued and are no longer available for sale.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","title":"Description","description":"Getting Started","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/index","title":"Wmbus Gateway V4","description":"Getting Started","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/index":{"id":"products/metering-gateways/wireless-mbus-g3/index","title":"Wireless M-BUS Gateways","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/manual/cfg":{"id":"products/metering-gateways/wireless-mbus-g3/manual/cfg","title":"Configuration","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/manual/index":{"id":"products/metering-gateways/wireless-mbus-g3/manual/index","title":"Operation Manual","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/manual/workflow":{"id":"products/metering-gateways/wireless-mbus-g3/manual/workflow","title":"Workflow","description":"Einleitung","sidebar":"productsSidebar"},"products/sensor-gateways/current-loop/index":{"id":"products/sensor-gateways/current-loop/index","title":"Current Loop Sensors (4...20 mA)","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/sensor-gateways/index":{"id":"products/sensor-gateways/index","title":"Metering Gateway","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/sensor-gateways/level/index":{"id":"products/sensor-gateways/level/index","title":"Liquid Level Sensors","description":"","sidebar":"productsSidebar"},"products/sensor-gateways/modbus/index":{"id":"products/sensor-gateways/modbus/index","title":"Modbus Sensors","description":"","sidebar":"productsSidebar"},"products/sensor-gateways/temperature/index":{"id":"products/sensor-gateways/temperature/index","title":"Temperature Sensors","description":"","sidebar":"productsSidebar"}}}}')}}]); \ No newline at end of file diff --git a/assets/js/0b02251e.76105950.js b/assets/js/0b02251e.76105950.js deleted file mode 100644 index 10d48dbe..00000000 --- a/assets/js/0b02251e.76105950.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[3830],{5570:e=>{e.exports=JSON.parse('{"version":{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"htmlSidebar":[{"type":"html","value":"TEST|TEST","defaultStyle":true}],"allDocSidebar":[{"type":"category","label":"All Docs","items":[{"type":"link","label":"Lobaro Documentation","href":"/iot/","docId":"index","unlisted":false},{"type":"category","label":"Products","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Metering Gateways","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Wireless M-BUS (Gen. 3)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g3/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g3/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Gateway V4","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Description","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/"},{"type":"link","label":"Gateway V3","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","unlisted":false},{"type":"link","label":"Gateway DinRail","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","unlisted":false},{"type":"link","label":"Gateway Solar","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","unlisted":false},{"type":"link","label":"Gateway Concentrator","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","unlisted":false},{"type":"category","label":"Discontinued","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","unlisted":false},{"type":"link","label":"Gateway V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/"}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/"},{"type":"category","label":"Wireless M-BUS (Gen. 2)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g2/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g2/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/"},{"type":"category","label":"Wired M-BUS (Gen. 1)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/cfg","docId":"products/metering-gateways/wired-mbus-g1/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/workflow","docId":"products/metering-gateways/wired-mbus-g1/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wired-mbus-g1/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Hybrid Gateway","href":"/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wired-mbus-g1/"}],"href":"/iot/products/metering-gateways/"},{"type":"category","label":"Sensor Gateways","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Current Loop","href":"/iot/products/sensor-gateways/current-loop/","docId":"products/sensor-gateways/current-loop/index","unlisted":false},{"type":"link","label":"Liquid Level","href":"/iot/products/sensor-gateways/level/","docId":"products/sensor-gateways/level/index","unlisted":false},{"type":"link","label":"Modbus","href":"/iot/products/sensor-gateways/modbus/","docId":"products/sensor-gateways/modbus/index","unlisted":false},{"type":"link","label":"Temperature","href":"/iot/products/sensor-gateways/temperature/","docId":"products/sensor-gateways/temperature/index","unlisted":false}],"href":"/iot/products/sensor-gateways/"}],"href":"/iot/products/"},{"type":"category","label":"Firmware","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"app-nrf9160-wmbus","href":"/iot/firmware/app-nrf9160-wmbus/","docId":"firmware/app-nrf9160-wmbus/index","unlisted":false},{"type":"link","label":"app-hybrid-modbus","href":"/iot/firmware/app-hybrid-modbus/","docId":"firmware/app-hybrid-modbus/index","unlisted":false}],"href":"/iot/firmware/"},{"type":"category","label":"Hardware","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Mainboards","href":"/iot/hardware/mainboards/","docId":"hardware/mainboards/index","unlisted":false},{"type":"link","label":"Extension Modules","href":"/iot/hardware/extension-modules/","docId":"hardware/extension-modules/index","unlisted":false},{"type":"link","label":"Device Housings","href":"/iot/hardware/housings/","docId":"hardware/housings/index","unlisted":false}],"href":"/iot/hardware/"},{"type":"category","label":"Lobaro Cloud","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Lobaro Direct+","href":"/iot/cloud/direct+/","docId":"cloud/direct+/index","unlisted":false},{"type":"link","label":"Lobaro IoT Platform","href":"/iot/cloud/platform/","docId":"cloud/platform/index","unlisted":false}],"href":"/iot/cloud/"},{"type":"category","label":"Configuration","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"USB Config Adapter","href":"/iot/configuration/usb-config-adapter","docId":"configuration/usb-config-adapter","unlisted":false},{"type":"link","label":"Lobaro Maintenance Tool","href":"/iot/configuration/lobaro-tool/","docId":"configuration/lobaro-tool/index","unlisted":false},{"type":"link","label":"CRON Expressions","href":"/iot/configuration/cron-expressions","docId":"configuration/cron-expressions","unlisted":false},{"type":"link","label":"Remote Config (LoRaWAN)","href":"/iot/configuration/remote-config-lorawan","docId":"configuration/remote-config-lorawan","unlisted":false}],"href":"/iot/configuration/"},{"type":"category","label":"Knowledge Base","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Modbus","href":"/iot/knowledge-base/modbus","docId":"knowledge-base/modbus","unlisted":false},{"type":"link","label":"Wireless M-BUS","href":"/iot/knowledge-base/wireless-mbus","docId":"knowledge-base/wireless-mbus","unlisted":false},{"type":"link","label":"Doc Playground","href":"/iot/knowledge-base/doc-playground/","docId":"knowledge-base/doc-playground/index","unlisted":false}]}],"collapsed":true,"collapsible":true}],"productsSidebar":[{"type":"category","label":"Products","items":[{"type":"link","label":"Introduction","href":"/iot/products/","docId":"products/index","unlisted":false},{"type":"category","label":"Metering Gateways","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Wireless M-BUS (Gen. 3)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g3/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g3/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Gateway V4","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Description","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/"},{"type":"link","label":"Gateway V3","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","unlisted":false},{"type":"link","label":"Gateway DinRail","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","unlisted":false},{"type":"link","label":"Gateway Solar","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","unlisted":false},{"type":"link","label":"Gateway Concentrator","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","unlisted":false},{"type":"category","label":"Discontinued","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","unlisted":false},{"type":"link","label":"Gateway V2","href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/","docId":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/"}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g3/"},{"type":"category","label":"Wireless M-BUS (Gen. 2)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg","docId":"products/metering-gateways/wireless-mbus-g2/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow","docId":"products/metering-gateways/wireless-mbus-g2/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"LoRaWAN Bridge V2","href":"/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/","docId":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wireless-mbus-g2/"},{"type":"category","label":"Wired M-BUS (Gen. 1)","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Operation Manual","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuration","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/cfg","docId":"products/metering-gateways/wired-mbus-g1/manual/cfg","unlisted":false},{"type":"link","label":"Workflow","href":"/iot/products/metering-gateways/wired-mbus-g1/manual/workflow","docId":"products/metering-gateways/wired-mbus-g1/manual/workflow","unlisted":false}],"href":"/iot/products/metering-gateways/wired-mbus-g1/manual/"},{"type":"category","label":"Hardware Variants","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Hybrid Gateway","href":"/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/","docId":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","unlisted":false}]}],"href":"/iot/products/metering-gateways/wired-mbus-g1/"}],"href":"/iot/products/metering-gateways/"},{"type":"category","label":"Sensor Gateways","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Current Loop","href":"/iot/products/sensor-gateways/current-loop/","docId":"products/sensor-gateways/current-loop/index","unlisted":false},{"type":"link","label":"Liquid Level","href":"/iot/products/sensor-gateways/level/","docId":"products/sensor-gateways/level/index","unlisted":false},{"type":"link","label":"Modbus","href":"/iot/products/sensor-gateways/modbus/","docId":"products/sensor-gateways/modbus/index","unlisted":false},{"type":"link","label":"Temperature","href":"/iot/products/sensor-gateways/temperature/","docId":"products/sensor-gateways/temperature/index","unlisted":false}],"href":"/iot/products/sensor-gateways/"}],"collapsed":true,"collapsible":true}],"configurationSidebar":[{"type":"category","label":"Configuration","items":[{"type":"link","label":"Introduction","href":"/iot/configuration/","docId":"configuration/index","unlisted":false},{"type":"link","label":"USB Config Adapter","href":"/iot/configuration/usb-config-adapter","docId":"configuration/usb-config-adapter","unlisted":false},{"type":"link","label":"Lobaro Maintenance Tool","href":"/iot/configuration/lobaro-tool/","docId":"configuration/lobaro-tool/index","unlisted":false},{"type":"link","label":"CRON Expressions","href":"/iot/configuration/cron-expressions","docId":"configuration/cron-expressions","unlisted":false},{"type":"link","label":"Remote Config (LoRaWAN)","href":"/iot/configuration/remote-config-lorawan","docId":"configuration/remote-config-lorawan","unlisted":false}],"collapsed":true,"collapsible":true}],"firmwareSidebar":[{"type":"category","label":"Firmware","items":[{"type":"link","label":"Introduction","href":"/iot/firmware/","docId":"firmware/index","unlisted":false},{"type":"link","label":"app-nrf9160-wmbus","href":"/iot/firmware/app-nrf9160-wmbus/","docId":"firmware/app-nrf9160-wmbus/index","unlisted":false},{"type":"link","label":"app-hybrid-modbus","href":"/iot/firmware/app-hybrid-modbus/","docId":"firmware/app-hybrid-modbus/index","unlisted":false}],"collapsed":true,"collapsible":true}],"hardwareSidebar":[{"type":"category","label":"Hardware","items":[{"type":"link","label":"Introduction","href":"/iot/hardware/","docId":"hardware/index","unlisted":false},{"type":"link","label":"Mainboards","href":"/iot/hardware/mainboards/","docId":"hardware/mainboards/index","unlisted":false},{"type":"link","label":"Extension Modules","href":"/iot/hardware/extension-modules/","docId":"hardware/extension-modules/index","unlisted":false},{"type":"link","label":"Device Housings","href":"/iot/hardware/housings/","docId":"hardware/housings/index","unlisted":false}],"collapsed":true,"collapsible":true}],"cloudSidebar":[{"type":"category","label":"Lobaro Cloud","items":[{"type":"link","label":"Introduction","href":"/iot/cloud/","docId":"cloud/index","unlisted":false},{"type":"link","label":"Lobaro Direct+","href":"/iot/cloud/direct+/","docId":"cloud/direct+/index","unlisted":false},{"type":"link","label":"Lobaro IoT Platform","href":"/iot/cloud/platform/","docId":"cloud/platform/index","unlisted":false}],"collapsed":true,"collapsible":true}],"knowledgeBaseSidebar":[{"type":"category","label":"Knowledge Base","items":[{"type":"link","label":"Modbus","href":"/iot/knowledge-base/modbus","docId":"knowledge-base/modbus","unlisted":false},{"type":"link","label":"Wireless M-BUS","href":"/iot/knowledge-base/wireless-mbus","docId":"knowledge-base/wireless-mbus","unlisted":false},{"type":"link","label":"Doc Playground","href":"/iot/knowledge-base/doc-playground/","docId":"knowledge-base/doc-playground/index","unlisted":false}],"collapsed":true,"collapsible":true}]},"docs":{"cloud/direct+/index":{"id":"cloud/direct+/index","title":"Lobaro Direct+","description":"test","sidebar":"cloudSidebar"},"cloud/index":{"id":"cloud/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"cloudSidebar"},"cloud/platform/index":{"id":"cloud/platform/index","title":"Lobaro IoT Platform","description":"Getting Started","sidebar":"cloudSidebar"},"configuration/cron-expressions":{"id":"configuration/cron-expressions","title":"CRON Expressions","description":"We use CRON expressions configure the behavioral timing of our devices. This CRON configuration can be adjusted during","sidebar":"configurationSidebar"},"configuration/index":{"id":"configuration/index","title":"Introduction","description":"Lobaro devices allow a wide range of internal configuration adjustments.","sidebar":"configurationSidebar"},"configuration/lobaro-tool/index":{"id":"configuration/lobaro-tool/index","title":"Lobaro Maintenance Tool","description":"The Lobaro Maintenance Tool can be used to configure and diagnose Lobaro devices locally using a PC and our special","sidebar":"configurationSidebar"},"configuration/remote-config-lorawan":{"id":"configuration/remote-config-lorawan","title":"Remote Config (LoRaWAN)","description":"This article describes the technical details how to remotely configure Lobaro devices that are using LoRaWAN as","sidebar":"configurationSidebar"},"configuration/usb-config-adapter":{"id":"configuration/usb-config-adapter","title":"USB Config Adapter","description":"The Lobaro USB configuration adapters connects the configuration serial uart of our devices to a PC. It is used for:","sidebar":"configurationSidebar"},"firmware/app-hybrid-modbus/index":{"id":"firmware/app-hybrid-modbus/index","title":"app-hybrid-modbus","description":"This new documentation center is currently work in progress","sidebar":"firmwareSidebar"},"firmware/app-nrf9160-wmbus/index":{"id":"firmware/app-nrf9160-wmbus/index","title":"app-nrf9160-wmbus","description":"This new documentation center is currently work in progress","sidebar":"firmwareSidebar"},"firmware/index":{"id":"firmware/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"firmwareSidebar"},"hardware/extension-modules/index":{"id":"hardware/extension-modules/index","title":"Hardware Addons","description":"","sidebar":"hardwareSidebar"},"hardware/housings/index":{"id":"hardware/housings/index","title":"Device Housings","description":"","sidebar":"hardwareSidebar"},"hardware/index":{"id":"hardware/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"hardwareSidebar"},"hardware/mainboards/index":{"id":"hardware/mainboards/index","title":"Mainboards","description":"","sidebar":"hardwareSidebar"},"index":{"id":"index","title":"Lobaro Documentation","description":"This new documentation center is currently work in progress","sidebar":"allDocSidebar"},"knowledge-base/doc-playground/index":{"id":"knowledge-base/doc-playground/index","title":"Docusaurus Playground","description":"Location to showcase features and examples for writing content in this doc with is based on Docusaurus.","sidebar":"knowledgeBaseSidebar"},"knowledge-base/modbus":{"id":"knowledge-base/modbus","title":"Modbus","description":"Some notable things in a block quote!","sidebar":"knowledgeBaseSidebar"},"knowledge-base/wireless-mbus":{"id":"knowledge-base/wireless-mbus","title":"Wireless M-BUS","description":"Some notable things in a block quote!","sidebar":"knowledgeBaseSidebar"},"products/index":{"id":"products/index","title":"Introduction","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/index":{"id":"products/metering-gateways/index","title":"Metering Gateway","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index":{"id":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","title":"Overview","description":"Some notable things in a block quote!","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/index":{"id":"products/metering-gateways/wired-mbus-g1/index","title":"Wired M-BUS Gateways","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/manual/cfg":{"id":"products/metering-gateways/wired-mbus-g1/manual/cfg","title":"Configuration","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/manual/index":{"id":"products/metering-gateways/wired-mbus-g1/manual/index","title":"Operation Manual","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wired-mbus-g1/manual/workflow":{"id":"products/metering-gateways/wired-mbus-g1/manual/workflow","title":"Workflow","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index":{"id":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/index":{"id":"products/metering-gateways/wireless-mbus-g2/index","title":"Wireless M-BUS Gateways","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/manual/cfg":{"id":"products/metering-gateways/wireless-mbus-g2/manual/cfg","title":"Configuration","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/manual/index":{"id":"products/metering-gateways/wireless-mbus-g2/manual/index","title":"Operation Manual","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g2/manual/workflow":{"id":"products/metering-gateways/wireless-mbus-g2/manual/workflow","title":"Workflow","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/index","title":"Discontinued Gateways","description":"These products have been discontinued and are no longer available for sale.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","title":"Description","description":"Getting Started","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/index","title":"Wmbus Gateway V4","description":"Getting Started","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index":{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","title":"index","description":"This product has been discontinued and functionally replaced by the wMBUS gateway V3 / V4.","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/index":{"id":"products/metering-gateways/wireless-mbus-g3/index","title":"Wireless M-BUS Gateways","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/manual/cfg":{"id":"products/metering-gateways/wireless-mbus-g3/manual/cfg","title":"Configuration","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/manual/index":{"id":"products/metering-gateways/wireless-mbus-g3/manual/index","title":"Operation Manual","description":"Einleitung","sidebar":"productsSidebar"},"products/metering-gateways/wireless-mbus-g3/manual/workflow":{"id":"products/metering-gateways/wireless-mbus-g3/manual/workflow","title":"Workflow","description":"Einleitung","sidebar":"productsSidebar"},"products/sensor-gateways/current-loop/index":{"id":"products/sensor-gateways/current-loop/index","title":"Current Loop Sensors (4...20 mA)","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/sensor-gateways/index":{"id":"products/sensor-gateways/index","title":"Metering Gateway","description":"This new documentation center is currently work in progress","sidebar":"productsSidebar"},"products/sensor-gateways/level/index":{"id":"products/sensor-gateways/level/index","title":"Liquid Level Sensors","description":"","sidebar":"productsSidebar"},"products/sensor-gateways/modbus/index":{"id":"products/sensor-gateways/modbus/index","title":"Modbus Sensors","description":"","sidebar":"productsSidebar"},"products/sensor-gateways/temperature/index":{"id":"products/sensor-gateways/temperature/index","title":"Temperature Sensors","description":"","sidebar":"productsSidebar"}}}}')}}]); \ No newline at end of file diff --git a/assets/js/1034e1fe.3d2b46d2.js b/assets/js/1034e1fe.3d2b46d2.js new file mode 100644 index 00000000..3eb2582f --- /dev/null +++ b/assets/js/1034e1fe.3d2b46d2.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[136],{8882:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>o,contentTitle:()=>d,default:()=>c,frontMatter:()=>r,metadata:()=>l,toc:()=>a});var i=t(4848),s=t(8453);const r={sidebar_position:3},d="CRON Configuration",l={id:"configuration/cron-configuration",title:"CRON Configuration",description:"We use CRON expressions configure the behavioral timing of our devices. This CRON configuration can be adjusted during",source:"@site/docs/configuration/cron-configuration.md",sourceDirName:"configuration",slug:"/configuration/cron-configuration",permalink:"/iot/configuration/cron-configuration",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/cron-configuration.md",tags:[],version:"current",sidebarPosition:3,frontMatter:{sidebar_position:3},sidebar:"configurationSidebar",previous:{title:"Lobaro Config Tool",permalink:"/iot/configuration/lobaro-tool/"},next:{title:"LoRaWAN Downlink Config",permalink:"/iot/configuration/lorawan-downlink-config"}},o={},a=[{value:"Meaning of the six fields",id:"meaning-of-the-six-fields",level:2},{value:"Star (Asterisk) *",id:"star-asterisk-",level:3},{value:"Question mark (?)",id:"question-mark-",level:3},{value:"Dash, minus (-)",id:"dash-minus--",level:3},{value:"Comma (,)",id:"comma-",level:3},{value:"Slash (/)",id:"slash-",level:3},{value:"Weekday (W)",id:"weekday-w",level:3},{value:"Last (L)",id:"last-l",level:3},{value:"Hash (H)",id:"hash-h",level:3},{value:"Pitfalls with using H",id:"pitfalls-with-using-h",level:4},{value:"Examples",id:"examples",level:2},{value:"Standard CRON Syntax",id:"standard-cron-syntax",level:3},{value:"Extended CRON Syntax",id:"extended-cron-syntax",level:3},{value:"Further Reading",id:"further-reading",level:2},{value:"Online CRON Generators",id:"online-cron-generators",level:3}];function h(e){const n={a:"a",admonition:"admonition",br:"br",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"cron-configuration",children:"CRON Configuration"}),"\n",(0,i.jsxs)(n.p,{children:["We use CRON expressions configure the behavioral timing of our devices. This CRON configuration can be adjusted during\ndevice configuration using the ",(0,i.jsx)(n.a,{href:"./lobaro-tool",children:"Lobaro Maintenance Tool"}),"\nor remotely over the air."]}),"\n",(0,i.jsxs)(n.p,{children:["The CRON expressions consists of 6 fields, separated by space: e.g. ",(0,i.jsx)(n.code,{children:"0 0/15 * * * *"})," , which describes time points every\n15 minutes starting from minute 0."]}),"\n",(0,i.jsxs)(n.p,{children:["CRON expression allow you to define specific ",(0,i.jsx)(n.strong,{children:"POINTS in time"})," they are NOT helpful to define time durations. They can\nbe seen\nhas the start time to trigger an action, for example initiating the sensor measurement or wireless sendout. The duration\nof an action is defined by a separate configuration parameter if needed."]}),"\n",(0,i.jsxs)(n.admonition,{title:"Timezone and Daylight Saving",type:"warning",children:[(0,i.jsx)(n.p,{children:"All times are referenced to UTC+0 timezone! Keep this in mind when setting CRON configurations on Lobaro devices."}),(0,i.jsxs)(n.p,{children:["This implementation detail implies that daylight saving time switches will change the behavior of the device by one\nhour.",(0,i.jsx)(n.br,{}),"\n","Example for Central Europe:"]}),(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Winter: UTC+1 (Central European Time)"}),"\n",(0,i.jsx)(n.li,{children:"Summer: UTC+2 (Central European Summer Time)"}),"\n"]})]}),"\n",(0,i.jsx)(n.h2,{id:"meaning-of-the-six-fields",children:"Meaning of the six fields"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"0 0/15 * * * *"})," - time points every 15 minutes starting from minute 0."]}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.th,{}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Second"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Minute"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Hour"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Day of Month"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Month of year"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Day of Week"})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:"Range"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(0-59)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(0-59)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(0-23)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(1-31)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(1-12)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(1-7)"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:"Alternative"}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"JAN-DEC"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"MON-SUN"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:", - * /"})," special chars"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:"?"})," special char"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:"H L"})," special chars"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:"W"})," special char"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:"Example"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)(n.strong,{children:"0"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)(n.strong,{children:"0/15"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})})]})]})]}),"\n",(0,i.jsx)(n.admonition,{type:"warning",children:(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"H L W"})," are only supported on recent firmware releases, check product description for details."]})}),"\n",(0,i.jsxs)(n.admonition,{type:"tip",children:[(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Day of Month"})," and ",(0,i.jsx)(n.strong,{children:"Day of Week"})," ",(0,i.jsx)(n.em,{children:"should"})," be treated ",(0,i.jsx)(n.strong,{children:"mutually exclusive"})," and one of them should be set to ",(0,i.jsx)(n.code,{children:"?"}),".",(0,i.jsx)(n.br,{}),"\n","As an example the following CRON may not have the intended behaviour if not following this advice:"]}),(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"0 0 1 1 * MON"})," Would only trigger on 1st of every month ",(0,i.jsx)(n.strong,{children:"that is"})," a Monday."]})]}),"\n",(0,i.jsx)(n.h3,{id:"star-asterisk-",children:"Star (Asterisk) *"}),"\n",(0,i.jsx)(n.p,{children:'Used to select all values within a field. For example, "*" in the minute field means "every minute".'}),"\n",(0,i.jsx)(n.h3,{id:"question-mark-",children:"Question mark (?)"}),"\n",(0,i.jsx)(n.p,{children:"Useful when you need to specify something in one of the two fields in which the character is allowed, but not the other.\nFor example, if I want my trigger to fire on a particular day of the month (say, the 10th), but don\u2019t care what day of\nthe week that happens to be, I would put \u201c10\u201d in the day-of-month field, and \u201c?\u201d in the day-of-week field. See the\nexamples below for clarification."}),"\n",(0,i.jsx)(n.h3,{id:"dash-minus--",children:"Dash, minus (-)"}),"\n",(0,i.jsx)(n.p,{children:"Used to specify ranges. For example, \u201c10-12\u201d in the hour field means \u201cthe hours 10, 11 and 12\u201d."}),"\n",(0,i.jsx)(n.h3,{id:"comma-",children:"Comma (,)"}),"\n",(0,i.jsx)(n.p,{children:'Used to specify multiple explicit values. For example, \u201cMON,WED,FRI\u201d in the day-of-week field means \u201cthe days Monday,\nWednesday, and Friday\u201d, "1,15" in the day-of-month field means "on the first and 15th of the month".'}),"\n",(0,i.jsx)(n.h3,{id:"slash-",children:"Slash (/)"}),"\n",(0,i.jsx)(n.p,{children:'Used to specify increments. For example, "0/15" in the seconds field means "0 and then every 15", that is "the seconds\n0, 15, 30, and 45". And "5/15" in the seconds field means "the seconds 5, 20, 35, and 50". You can also use "/" for\nother fields. "1/3" in the day-of-month field means "fire every 3 days starting on the first day of the month".'}),"\n",(0,i.jsx)(n.h3,{id:"weekday-w",children:"Weekday (W)"}),"\n",(0,i.jsxs)(n.p,{children:["Only valid in the day-of-month field. Used as a modifier added after a given day, e.g. ",(0,i.jsx)(n.code,{children:"15W"}),". This will execute on the\nnearest weekday (Monday to Friday) around that day. So ",(0,i.jsx)(n.code,{children:"0 0 12 15W * *"})," will execute on 12h UTC of the 15th of a month,\nif that day is a Monday, Tuesday, Wednesday, Thursday, of Friday. If the 15th is a Saturday, it will execute on 12h UTC\non Friday the 14th. If the 15th is a Sunday, it will execute on 12h UTC on Monday the 16th. It will however never jump\ninto another month. If you use ",(0,i.jsx)(n.code,{children:"1W"}),", and the first day of the month is a Saturday, it will execute on Monday the 3rd."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:['Can be used in combination with lists (comma ","), must be used for each individual value of the list you want to use\nit on, e.g. ',(0,i.jsx)(n.code,{children:"1W,15W"}),"."]}),"\n",(0,i.jsx)(n.li,{children:'Cannot be used with ranges (dash, "-") or increments (slash "/").'}),"\n",(0,i.jsxs)(n.li,{children:['Can be used in combination is hash ("H"), in the form ',(0,i.jsx)(n.code,{children:"HW"})," or e.g. ",(0,i.jsx)(n.code,{children:"H(6-9)W"}),"."]}),"\n",(0,i.jsxs)(n.li,{children:['Can be used in combination with "L", but only as ',(0,i.jsx)(n.code,{children:"LW"}),", to execute on the last weekday of a month."]}),"\n"]})}),"\n",(0,i.jsx)(n.h3,{id:"last-l",children:"Last (L)"}),"\n",(0,i.jsx)(n.p,{children:"Has a different meaning, depending on where you use it."}),"\n",(0,i.jsxs)(n.p,{children:["A simple ",(0,i.jsx)(n.code,{children:"L"}),' means "the last of something". This is useful for the day-of-month field, as the last day of a month is\ndependent on the current month and year. ',(0,i.jsx)(n.code,{children:"0 0 12 L ?"})," will execute on the 31st of January, on the 28th or 29th (for leap\nyears) of February, on the 31st of March, on the 30th of April, and so on. You can also specify offsets from the last\nvalue, like this: ",(0,i.jsx)(n.code,{children:"0 0 12 L-3 * ?"}),". This executes on the 28th of January, on the 25th of 26th of February, and so on."]}),"\n",(0,i.jsxs)(n.p,{children:["In the day-of-week field ",(0,i.jsx)(n.code,{children:"L"})," simply refers to Sunday. But in combination with a number, it can be used to execute on the\nlast specific weekday of a month, like this: ",(0,i.jsx)(n.code,{children:"0 0 12 ? * 1L"})," will execute at 12h on the last Monday of every month."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:["Can be used in combination with ",(0,i.jsx)(n.code,{children:"W"}),", as ",(0,i.jsx)(n.code,{children:"LW"}),", to execute on the last weekday of a month."]}),"\n"]})}),"\n",(0,i.jsx)(n.h3,{id:"hash-h",children:"Hash (H)"}),"\n",(0,i.jsxs)(n.p,{children:["The character ",(0,i.jsx)(n.code,{children:"H"})," can be used in place of a number in any field of the cron. The ",(0,i.jsx)(n.code,{children:"H"})," wil be replaced with a consistent\npseudo random number, that fits into that field. On any given device this number will always be the same for a field,\nbut it\nwill differ for different devices. This can be used as a simple mechanism for load balancing, or to avoid collisions, if\nyou use a lot of devices."]}),"\n",(0,i.jsx)(n.p,{children:"Numbers will be 0-59 for second and minute fields, 0-23 for the hour field, 0-28 for the day-of-month field (it will\nnever activate on 29th, 30th, or 31st), 1-12 for the month field, and 1-7 for the day-of-week field."}),"\n",(0,i.jsxs)(n.p,{children:["When you, for example, set many devices to the cron ",(0,i.jsx)(n.code,{children:"0 0 4 * * *"}),", they will all activate at 4 AM UTC in the same\nsecond. For LoRaWAN devices, this will lead to a lot of packet collisions and therefore data loss, if the devices are in\nthe same area. For NB-IoT/LTE-M devices, it will lead to a concentrated workload on the server handling the requests and\nthe system evaluating the data. This can lead to bad system performance during that spike, while the system is idle most\nof the day."]}),"\n",(0,i.jsxs)(n.p,{children:["If instead of ",(0,i.jsx)(n.code,{children:"0 0 4 * * *"})," you set the devices to ",(0,i.jsx)(n.code,{children:"H H 4 * * *"}),", the two H characters will be replaced with a\nper-device-consistent random number in the range of 0-59, for example ",(0,i.jsx)(n.code,{children:"31 47 4 * * *"})," for one and ",(0,i.jsx)(n.code,{children:"17 0 4 * * *"})," for\nanother device. With this, the devices will all activate in the hour between 4 AM and 5 AM UTC and distribute the\nworkload."]}),"\n",(0,i.jsxs)(n.p,{children:["You can use ",(0,i.jsx)(n.code,{children:"H"})," to pick a pseudo random number from a specific range by specifying the range in parenthesis like this:\n",(0,i.jsx)(n.code,{children:"H(4-8)"})," will be replaced with any of the numbers 4, 5, 6, 7, 8. The range must only use numbers that are valid for the\nfield ",(0,i.jsx)(n.code,{children:"H"})," is used in."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:'Can be used inside lists (comma ","), but the generated value could collide with other entries in list (see below).'}),"\n",(0,i.jsx)(n.li,{children:'Cannot be used with ranges (dash, "-").'}),"\n",(0,i.jsx)(n.li,{children:'Can be used with increments (slash, "/"), but only before the slash, as in "H(0-2)/3", not after it.'}),"\n"]})}),"\n",(0,i.jsx)(n.h4,{id:"pitfalls-with-using-h",children:"Pitfalls with using H"}),"\n",(0,i.jsx)(n.admonition,{type:"warning",children:(0,i.jsxs)(n.p,{children:["Working with ",(0,i.jsx)(n.code,{children:"H"})," can be confusing and lead to unexpected results. It can be used in many places, but not all of them are\nuseful."]})}),"\n",(0,i.jsxs)(n.p,{children:["Writing ",(0,i.jsx)(n.code,{children:"0 H/10 * * * *"})," will on most devices create a cron that does not activate every 10 minutes. It\ncould evaluate to the expression ",(0,i.jsx)(n.code,{children:"0 47/10 * * * *"}),", which will only activate twice each hour, in minutes 47 and 57, but\nnot during minutes 0-46 at all. To have devices activate every 10 minutes at distributed times,\nuse ",(0,i.jsx)(n.code,{children:"0 H(0-9)/10 * * * *"})," or better yet: ",(0,i.jsx)(n.code,{children:"H H(0-9)/10 * * * *"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["Using ",(0,i.jsx)(n.code,{children:"H"})," in a list works, but it might lead to fewer activations as intended. Putting it in a list twice will not\nproduce multiple activations, because both ",(0,i.jsx)(n.code,{children:"H"})," will evaluate to the same number: ",(0,i.jsx)(n.code,{children:"0 0 H,H * * *"})," could turn into ",(0,i.jsx)(n.code,{children:"0 0 3,3 * * *"}),", which is the same as ",(0,i.jsx)(n.code,{children:"0 0 3 * * *"}),". Using ",(0,i.jsx)(n.code,{children:"0 0 H(0-4),H(8-12) * * *"})," would work to produce two activations\nper day."]}),"\n",(0,i.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,i.jsx)(n.h3,{id:"standard-cron-syntax",children:"Standard CRON Syntax"}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.th,{children:["Cron definition",(0,i.jsx)("div",{style:{width:"185px"}})]}),(0,i.jsx)(n.th,{children:"Description"}),(0,i.jsxs)(n.th,{children:["Trigger time points (hh:mm",":ss",")"]})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 5 * * * * "})}),(0,i.jsx)(n.td,{children:"Hourly at minute 5, second 0"}),(0,i.jsx)(n.td,{children:"00:05:00, 01:05:00, 02:05:00..."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 1/10 * * * * "})}),(0,i.jsx)(n.td,{children:"Every 10 minutes starting from minute 1, second 0"}),(0,i.jsx)(n.td,{children:"00:01:00, 00:11:00, 00:21:00, [...], 01:01:00, [...]"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 6 * * * "})}),(0,i.jsx)(n.td,{children:"Daily on hour 6, minute 0, second 0"}),(0,i.jsx)(n.td,{children:"06:00:00"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 13 1,15 * * "})}),(0,i.jsx)(n.td,{children:"Hour 13, minute 0, second 0 on day 1 and 15"}),(0,i.jsx)(n.td,{children:"13:00:00 at 1st and 15th of month"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 15 9 1-5 * * "})}),(0,i.jsx)(n.td,{children:"Hour 9, minute 15, second 0 on day 1 to 5"}),(0,i.jsx)(n.td,{children:"09:15:00 at 1st to 5th of month"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 6 * * 1 "})}),(0,i.jsx)(n.td,{children:"Weekly on Monday at 06:00:00"}),(0,i.jsx)(n.td,{children:"Monday, 06:00:00"})]})]})]}),"\n",(0,i.jsx)(n.h3,{id:"extended-cron-syntax",children:"Extended CRON Syntax"}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.th,{children:["Cron definition ",(0,i.jsx)("div",{style:{width:"185px"}})]}),(0,i.jsx)(n.th,{children:"Description"})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 11 1W,15W * * "})}),(0,i.jsx)(n.td,{children:"11am on the days closest to the 1st and the 15th day each month that are not Saturdays or Sundays."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 15 1,L * * "})}),(0,i.jsx)(n.td,{children:"3pm on the first and last day of each month."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 1 ? * 2L "})}),(0,i.jsx)(n.td,{children:"1am on the last Tuesday of each month."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"H H H(0-2) * * * "})}),(0,i.jsx)(n.td,{children:"Every day at a fixed pseudo random time between 00:00:00 and 02:59:59.Same time each day for a given device, but different time for different devices."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:" H H(0-9)/10 * * * *"})}),(0,i.jsx)(n.td,{children:"Every 10 minutes, but at a fixed time, randomly but consistently picked for each device."})]})]})]}),"\n",(0,i.jsx)(n.admonition,{type:"info",children:(0,i.jsx)(n.p,{children:"The Extended CRON Syntax will only work on recent firmware versions, e.g. the wMBus Gateways V3 versions 0.15.4 and\nnewer.\nCheck the specific product manual to see if the extended syntax is implemented in the firmware."})}),"\n",(0,i.jsx)(n.h2,{id:"further-reading",children:"Further Reading"}),"\n",(0,i.jsxs)(n.p,{children:["All our CRON expressions are in the same format as the ",(0,i.jsx)(n.strong,{children:"Java Quarz scheduler"}),", without the optional ",(0,i.jsx)(n.code,{children:"year"})," field and a\ndifferent way of numbering weekdays. Also the extended CRON field have been added by Lobaro. A good documentation\nincluding\nexamples can be found here:"]}),"\n",(0,i.jsx)(n.p,{children:(0,i.jsx)(n.a,{href:"http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html",children:"http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html"})}),"\n",(0,i.jsx)(n.h3,{id:"online-cron-generators",children:"Online CRON Generators"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"https://www.freeformatter.com/cron-expression-generator-quartz.html",children:"https://www.freeformatter.com/cron-expression-generator-quartz.html"})}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.a,{href:"https://crontab-generator.org/",children:"https://crontab-generator.org/"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:'"command" need to be set to some random string'}),"\n",(0,i.jsx)(n.li,{children:'The generated CRON has no "seconds" field'}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.a,{href:"https://crontab.guru/",children:"https://crontab.guru/"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:'The generated CRON has no "seconds" field'}),"\n"]}),"\n"]}),"\n"]})]})}function c(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(h,{...e})}):h(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>d,x:()=>l});var i=t(6540);const s={},r=i.createContext(s);function d(e){const n=i.useContext(r);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:d(e.components),i.createElement(r.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/2f1957c9.128d2478.js b/assets/js/2f1957c9.128d2478.js deleted file mode 100644 index c01eec7c..00000000 --- a/assets/js/2f1957c9.128d2478.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[341],{1991:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>o,contentTitle:()=>d,default:()=>c,frontMatter:()=>r,metadata:()=>l,toc:()=>a});var i=t(4848),s=t(8453);const r={sidebar_position:3},d="CRON Expressions",l={id:"configuration/cron-expressions",title:"CRON Expressions",description:"We use CRON expressions configure the behavioral timing of our devices. This CRON configuration can be adjusted during",source:"@site/docs/configuration/cron-expressions.md",sourceDirName:"configuration",slug:"/configuration/cron-expressions",permalink:"/iot/configuration/cron-expressions",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/cron-expressions.md",tags:[],version:"current",sidebarPosition:3,frontMatter:{sidebar_position:3},sidebar:"configurationSidebar",previous:{title:"Lobaro Maintenance Tool",permalink:"/iot/configuration/lobaro-tool/"},next:{title:"Remote Config (LoRaWAN)",permalink:"/iot/configuration/remote-config-lorawan"}},o={},a=[{value:"Meaning of the six fields",id:"meaning-of-the-six-fields",level:2},{value:"Star (Asterisk) *",id:"star-asterisk-",level:3},{value:"Question mark (?)",id:"question-mark-",level:3},{value:"Dash, minus (-)",id:"dash-minus--",level:3},{value:"Comma (,)",id:"comma-",level:3},{value:"Slash (/)",id:"slash-",level:3},{value:"Weekday (W)",id:"weekday-w",level:3},{value:"Last (L)",id:"last-l",level:3},{value:"Hash (H)",id:"hash-h",level:3},{value:"Pitfalls with using H",id:"pitfalls-with-using-h",level:4},{value:"Examples",id:"examples",level:2},{value:"Standard CRON Syntax",id:"standard-cron-syntax",level:3},{value:"Extended CRON Syntax",id:"extended-cron-syntax",level:3},{value:"Further Reading",id:"further-reading",level:2},{value:"Online CRON Generators",id:"online-cron-generators",level:3}];function h(e){const n={a:"a",admonition:"admonition",br:"br",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"cron-expressions",children:"CRON Expressions"}),"\n",(0,i.jsxs)(n.p,{children:["We use CRON expressions configure the behavioral timing of our devices. This CRON configuration can be adjusted during\ndevice configuration using the ",(0,i.jsx)(n.a,{href:"./lobaro-tool",children:"Lobaro Maintenance Tool"}),"\nor remotely over the air."]}),"\n",(0,i.jsxs)(n.p,{children:["The CRON expressions consists of 6 fields, separated by space: e.g. ",(0,i.jsx)(n.code,{children:"0 0/15 * * * *"})," , which describes time points every\n15 minutes starting from minute 0."]}),"\n",(0,i.jsxs)(n.p,{children:["CRON expression allow you to define specific ",(0,i.jsx)(n.strong,{children:"POINTS in time"})," they are NOT helpful to define time durations. They can\nbe seen\nhas the start time to trigger an action, for example initiating the sensor measurement or wireless sendout. The duration\nof an action is defined by a separate configuration parameter if needed."]}),"\n",(0,i.jsxs)(n.admonition,{title:"Timezone and Daylight Saving",type:"warning",children:[(0,i.jsx)(n.p,{children:"All times are referenced to UTC+0 timezone! Keep this in mind when setting CRON configurations on Lobaro devices."}),(0,i.jsxs)(n.p,{children:["This implementation detail implies that daylight saving time switches will change the behavior of the device by one\nhour.",(0,i.jsx)(n.br,{}),"\n","Example for Central Europe:"]}),(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Winter: UTC+1 (Central European Time)"}),"\n",(0,i.jsx)(n.li,{children:"Summer: UTC+2 (Central European Summer Time)"}),"\n"]})]}),"\n",(0,i.jsx)(n.h2,{id:"meaning-of-the-six-fields",children:"Meaning of the six fields"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"0 0/15 * * * *"})," - time points every 15 minutes starting from minute 0."]}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.th,{}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Second"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Minute"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Hour"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Day of Month"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Month of year"}),(0,i.jsx)(n.th,{style:{textAlign:"center"},children:"Day of Week"})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:"Range"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(0-59)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(0-59)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(0-23)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(1-31)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(1-12)"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"(1-7)"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:"Alternative"}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"JAN-DEC"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"MON-SUN"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:", - * /"})," special chars"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:"?"})," special char"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:"H L"})," special chars"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.td,{children:[(0,i.jsx)(n.code,{children:"W"})," special char"]}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:"yes"}),(0,i.jsx)(n.td,{style:{textAlign:"center"}}),(0,i.jsx)(n.td,{style:{textAlign:"center"}})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:"Example"}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)(n.strong,{children:"0"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)(n.strong,{children:"0/15"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})}),(0,i.jsx)(n.td,{style:{textAlign:"center"},children:(0,i.jsx)("b",{children:"*"})})]})]})]}),"\n",(0,i.jsx)(n.admonition,{type:"warning",children:(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"H L W"})," are only supported on recent firmware releases, check product description for details."]})}),"\n",(0,i.jsxs)(n.admonition,{type:"tip",children:[(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Day of Month"})," and ",(0,i.jsx)(n.strong,{children:"Day of Week"})," ",(0,i.jsx)(n.em,{children:"should"})," be treated ",(0,i.jsx)(n.strong,{children:"mutually exclusive"})," and one of them should be set to ",(0,i.jsx)(n.code,{children:"?"}),".",(0,i.jsx)(n.br,{}),"\n","As an example the following CRON may not have the intended behaviour if not following this advice:"]}),(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"0 0 1 1 * MON"})," Would only trigger on 1st of every month ",(0,i.jsx)(n.strong,{children:"that is"})," a Monday."]})]}),"\n",(0,i.jsx)(n.h3,{id:"star-asterisk-",children:"Star (Asterisk) *"}),"\n",(0,i.jsx)(n.p,{children:'Used to select all values within a field. For example, "*" in the minute field means "every minute".'}),"\n",(0,i.jsx)(n.h3,{id:"question-mark-",children:"Question mark (?)"}),"\n",(0,i.jsx)(n.p,{children:"Useful when you need to specify something in one of the two fields in which the character is allowed, but not the other.\nFor example, if I want my trigger to fire on a particular day of the month (say, the 10th), but don\u2019t care what day of\nthe week that happens to be, I would put \u201c10\u201d in the day-of-month field, and \u201c?\u201d in the day-of-week field. See the\nexamples below for clarification."}),"\n",(0,i.jsx)(n.h3,{id:"dash-minus--",children:"Dash, minus (-)"}),"\n",(0,i.jsx)(n.p,{children:"Used to specify ranges. For example, \u201c10-12\u201d in the hour field means \u201cthe hours 10, 11 and 12\u201d."}),"\n",(0,i.jsx)(n.h3,{id:"comma-",children:"Comma (,)"}),"\n",(0,i.jsx)(n.p,{children:'Used to specify multiple explicit values. For example, \u201cMON,WED,FRI\u201d in the day-of-week field means \u201cthe days Monday,\nWednesday, and Friday\u201d, "1,15" in the day-of-month field means "on the first and 15th of the month".'}),"\n",(0,i.jsx)(n.h3,{id:"slash-",children:"Slash (/)"}),"\n",(0,i.jsx)(n.p,{children:'Used to specify increments. For example, "0/15" in the seconds field means "0 and then every 15", that is "the seconds\n0, 15, 30, and 45". And "5/15" in the seconds field means "the seconds 5, 20, 35, and 50". You can also use "/" for\nother fields. "1/3" in the day-of-month field means "fire every 3 days starting on the first day of the month".'}),"\n",(0,i.jsx)(n.h3,{id:"weekday-w",children:"Weekday (W)"}),"\n",(0,i.jsxs)(n.p,{children:["Only valid in the day-of-month field. Used as a modifier added after a given day, e.g. ",(0,i.jsx)(n.code,{children:"15W"}),". This will execute on the\nnearest weekday (Monday to Friday) around that day. So ",(0,i.jsx)(n.code,{children:"0 0 12 15W * *"})," will execute on 12h UTC of the 15th of a month,\nif that day is a Monday, Tuesday, Wednesday, Thursday, of Friday. If the 15th is a Saturday, it will execute on 12h UTC\non Friday the 14th. If the 15th is a Sunday, it will execute on 12h UTC on Monday the 16th. It will however never jump\ninto another month. If you use ",(0,i.jsx)(n.code,{children:"1W"}),", and the first day of the month is a Saturday, it will execute on Monday the 3rd."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:['Can be used in combination with lists (comma ","), must be used for each individual value of the list you want to use\nit on, e.g. ',(0,i.jsx)(n.code,{children:"1W,15W"}),"."]}),"\n",(0,i.jsx)(n.li,{children:'Cannot be used with ranges (dash, "-") or increments (slash "/").'}),"\n",(0,i.jsxs)(n.li,{children:['Can be used in combination is hash ("H"), in the form ',(0,i.jsx)(n.code,{children:"HW"})," or e.g. ",(0,i.jsx)(n.code,{children:"H(6-9)W"}),"."]}),"\n",(0,i.jsxs)(n.li,{children:['Can be used in combination with "L", but only as ',(0,i.jsx)(n.code,{children:"LW"}),", to execute on the last weekday of a month."]}),"\n"]})}),"\n",(0,i.jsx)(n.h3,{id:"last-l",children:"Last (L)"}),"\n",(0,i.jsx)(n.p,{children:"Has a different meaning, depending on where you use it."}),"\n",(0,i.jsxs)(n.p,{children:["A simple ",(0,i.jsx)(n.code,{children:"L"}),' means "the last of something". This is useful for the day-of-month field, as the last day of a month is\ndependent on the current month and year. ',(0,i.jsx)(n.code,{children:"0 0 12 L ?"})," will execute on the 31st of January, on the 28th or 29th (for leap\nyears) of February, on the 31st of March, on the 30th of April, and so on. You can also specify offsets from the last\nvalue, like this: ",(0,i.jsx)(n.code,{children:"0 0 12 L-3 * ?"}),". This executes on the 28th of January, on the 25th of 26th of February, and so on."]}),"\n",(0,i.jsxs)(n.p,{children:["In the day-of-week field ",(0,i.jsx)(n.code,{children:"L"})," simply refers to Sunday. But in combination with a number, it can be used to execute on the\nlast specific weekday of a month, like this: ",(0,i.jsx)(n.code,{children:"0 0 12 ? * 1L"})," will execute at 12h on the last Monday of every month."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:["Can be used in combination with ",(0,i.jsx)(n.code,{children:"W"}),", as ",(0,i.jsx)(n.code,{children:"LW"}),", to execute on the last weekday of a month."]}),"\n"]})}),"\n",(0,i.jsx)(n.h3,{id:"hash-h",children:"Hash (H)"}),"\n",(0,i.jsxs)(n.p,{children:["The character ",(0,i.jsx)(n.code,{children:"H"})," can be used in place of a number in any field of the cron. The ",(0,i.jsx)(n.code,{children:"H"})," wil be replaced with a consistent\npseudo random number, that fits into that field. On any given device this number will always be the same for a field,\nbut it\nwill differ for different devices. This can be used as a simple mechanism for load balancing, or to avoid collisions, if\nyou use a lot of devices."]}),"\n",(0,i.jsx)(n.p,{children:"Numbers will be 0-59 for second and minute fields, 0-23 for the hour field, 0-28 for the day-of-month field (it will\nnever activate on 29th, 30th, or 31st), 1-12 for the month field, and 1-7 for the day-of-week field."}),"\n",(0,i.jsxs)(n.p,{children:["When you, for example, set many devices to the cron ",(0,i.jsx)(n.code,{children:"0 0 4 * * *"}),", they will all activate at 4 AM UTC in the same\nsecond. For LoRaWAN devices, this will lead to a lot of packet collisions and therefore data loss, if the devices are in\nthe same area. For NB-IoT/LTE-M devices, it will lead to a concentrated workload on the server handling the requests and\nthe system evaluating the data. This can lead to bad system performance during that spike, while the system is idle most\nof the day."]}),"\n",(0,i.jsxs)(n.p,{children:["If instead of ",(0,i.jsx)(n.code,{children:"0 0 4 * * *"})," you set the devices to ",(0,i.jsx)(n.code,{children:"H H 4 * * *"}),", the two H characters will be replaced with a\nper-device-consistent random number in the range of 0-59, for example ",(0,i.jsx)(n.code,{children:"31 47 4 * * *"})," for one and ",(0,i.jsx)(n.code,{children:"17 0 4 * * *"})," for\nanother device. With this, the devices will all activate in the hour between 4 AM and 5 AM UTC and distribute the\nworkload."]}),"\n",(0,i.jsxs)(n.p,{children:["You can use ",(0,i.jsx)(n.code,{children:"H"})," to pick a pseudo random number from a specific range by specifying the range in parenthesis like this:\n",(0,i.jsx)(n.code,{children:"H(4-8)"})," will be replaced with any of the numbers 4, 5, 6, 7, 8. The range must only use numbers that are valid for the\nfield ",(0,i.jsx)(n.code,{children:"H"})," is used in."]}),"\n",(0,i.jsx)(n.admonition,{type:"note",children:(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:'Can be used inside lists (comma ","), but the generated value could collide with other entries in list (see below).'}),"\n",(0,i.jsx)(n.li,{children:'Cannot be used with ranges (dash, "-").'}),"\n",(0,i.jsx)(n.li,{children:'Can be used with increments (slash, "/"), but only before the slash, as in "H(0-2)/3", not after it.'}),"\n"]})}),"\n",(0,i.jsx)(n.h4,{id:"pitfalls-with-using-h",children:"Pitfalls with using H"}),"\n",(0,i.jsx)(n.admonition,{type:"warning",children:(0,i.jsxs)(n.p,{children:["Working with ",(0,i.jsx)(n.code,{children:"H"})," can be confusing and lead to unexpected results. It can be used in many places, but not all of them are\nuseful."]})}),"\n",(0,i.jsxs)(n.p,{children:["Writing ",(0,i.jsx)(n.code,{children:"0 H/10 * * * *"})," will on most devices create a cron that does not activate every 10 minutes. It\ncould evaluate to the expression ",(0,i.jsx)(n.code,{children:"0 47/10 * * * *"}),", which will only activate twice each hour, in minutes 47 and 57, but\nnot during minutes 0-46 at all. To have devices activate every 10 minutes at distributed times,\nuse ",(0,i.jsx)(n.code,{children:"0 H(0-9)/10 * * * *"})," or better yet: ",(0,i.jsx)(n.code,{children:"H H(0-9)/10 * * * *"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["Using ",(0,i.jsx)(n.code,{children:"H"})," in a list works, but it might lead to fewer activations as intended. Putting it in a list twice will not\nproduce multiple activations, because both ",(0,i.jsx)(n.code,{children:"H"})," will evaluate to the same number: ",(0,i.jsx)(n.code,{children:"0 0 H,H * * *"})," could turn into ",(0,i.jsx)(n.code,{children:"0 0 3,3 * * *"}),", which is the same as ",(0,i.jsx)(n.code,{children:"0 0 3 * * *"}),". Using ",(0,i.jsx)(n.code,{children:"0 0 H(0-4),H(8-12) * * *"})," would work to produce two activations\nper day."]}),"\n",(0,i.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,i.jsx)(n.h3,{id:"standard-cron-syntax",children:"Standard CRON Syntax"}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.th,{children:["Cron definition",(0,i.jsx)("div",{style:{width:"185px"}})]}),(0,i.jsx)(n.th,{children:"Description"}),(0,i.jsxs)(n.th,{children:["Trigger time points (hh:mm",":ss",")"]})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 5 * * * * "})}),(0,i.jsx)(n.td,{children:"Hourly at minute 5, second 0"}),(0,i.jsx)(n.td,{children:"00:05:00, 01:05:00, 02:05:00..."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 1/10 * * * * "})}),(0,i.jsx)(n.td,{children:"Every 10 minutes starting from minute 1, second 0"}),(0,i.jsx)(n.td,{children:"00:01:00, 00:11:00, 00:21:00, [...], 01:01:00, [...]"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 6 * * * "})}),(0,i.jsx)(n.td,{children:"Daily on hour 6, minute 0, second 0"}),(0,i.jsx)(n.td,{children:"06:00:00"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 13 1,15 * * "})}),(0,i.jsx)(n.td,{children:"Hour 13, minute 0, second 0 on day 1 and 15"}),(0,i.jsx)(n.td,{children:"13:00:00 at 1st and 15th of month"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 15 9 1-5 * * "})}),(0,i.jsx)(n.td,{children:"Hour 9, minute 15, second 0 on day 1 to 5"}),(0,i.jsx)(n.td,{children:"09:15:00 at 1st to 5th of month"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 6 * * 1 "})}),(0,i.jsx)(n.td,{children:"Weekly on Monday at 06:00:00"}),(0,i.jsx)(n.td,{children:"Monday, 06:00:00"})]})]})]}),"\n",(0,i.jsx)(n.h3,{id:"extended-cron-syntax",children:"Extended CRON Syntax"}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsxs)(n.th,{children:["Cron definition ",(0,i.jsx)("div",{style:{width:"185px"}})]}),(0,i.jsx)(n.th,{children:"Description"})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 11 1W,15W * * "})}),(0,i.jsx)(n.td,{children:"11am on the days closest to the 1st and the 15th day each month that are not Saturdays or Sundays."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 15 1,L * * "})}),(0,i.jsx)(n.td,{children:"3pm on the first and last day of each month."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"0 0 1 ? * 2L "})}),(0,i.jsx)(n.td,{children:"1am on the last Tuesday of each month."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"H H H(0-2) * * * "})}),(0,i.jsx)(n.td,{children:"Every day at a fixed pseudo random time between 00:00:00 and 02:59:59.Same time each day for a given device, but different time for different devices."})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:" H H(0-9)/10 * * * *"})}),(0,i.jsx)(n.td,{children:"Every 10 minutes, but at a fixed time, randomly but consistently picked for each device."})]})]})]}),"\n",(0,i.jsx)(n.admonition,{type:"info",children:(0,i.jsx)(n.p,{children:"The Extended CRON Syntax will only work on recent firmware versions, e.g. the wMBus Gateways V3 versions 0.15.4 and\nnewer.\nCheck the specific product manual to see if the extended syntax is implemented in the firmware."})}),"\n",(0,i.jsx)(n.h2,{id:"further-reading",children:"Further Reading"}),"\n",(0,i.jsxs)(n.p,{children:["All our CRON expressions are in the same format as the ",(0,i.jsx)(n.strong,{children:"Java Quarz scheduler"}),", without the optional ",(0,i.jsx)(n.code,{children:"year"})," field and a\ndifferent way of numbering weekdays. Also the extended CRON field have been added by Lobaro. A good documentation\nincluding\nexamples can be found here:"]}),"\n",(0,i.jsx)(n.p,{children:(0,i.jsx)(n.a,{href:"http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html",children:"http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html"})}),"\n",(0,i.jsx)(n.h3,{id:"online-cron-generators",children:"Online CRON Generators"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"https://www.freeformatter.com/cron-expression-generator-quartz.html",children:"https://www.freeformatter.com/cron-expression-generator-quartz.html"})}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.a,{href:"https://crontab-generator.org/",children:"https://crontab-generator.org/"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:'"command" need to be set to some random string'}),"\n",(0,i.jsx)(n.li,{children:'The generated CRON has no "seconds" field'}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.a,{href:"https://crontab.guru/",children:"https://crontab.guru/"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:'The generated CRON has no "seconds" field'}),"\n"]}),"\n"]}),"\n"]})]})}function c(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(h,{...e})}):h(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>d,x:()=>l});var i=t(6540);const s={},r=i.createContext(s);function d(e){const n=i.useContext(r);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:d(e.components),i.createElement(r.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/49425f7e.ccbf429c.js b/assets/js/49425f7e.ccbf429c.js new file mode 100644 index 00000000..89b1b2ec --- /dev/null +++ b/assets/js/49425f7e.ccbf429c.js @@ -0,0 +1 @@ +(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[7237],{2371:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png 300w,"+i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.c09dea3.600.png 600w,"+i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.18a3bd5.900.png 900w,"+i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.699e2d7.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png",width:300,height:179},{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.c09dea3.600.png",width:600,height:358},{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.18a3bd5.900.png",width:900,height:537},{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.699e2d7.1200.png",width:1200,height:716}],src:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png",toString:function(){return i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png"},placeholder:void 0,width:300,height:179},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAGCAIAAAB1kpiRAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAgklEQVR4nC2MQQ7CMAwE8/8HwoEi7kW0SZTG9q6doCDmNHOZdOacSzZVACDhvgSUdtX3nuq+15KP2i6RXks/PqYipi3n8nyksm3a2iWq9OP1Ou83cl0IwJmMHhEiMiIM4BjuPuckqaoJZu7svUfEiJjjD0kzS4ABZqbu68cf7uQq+wK1c63N5QE9AAAAAABJRU5ErkJggg=="}},900:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png 300w,"+i.p+"assets/images/ideal-img/tool-config-flash.6eb2cd7.600.png 600w,"+i.p+"assets/images/ideal-img/tool-config-flash.d81da13.900.png 900w,"+i.p+"assets/images/ideal-img/tool-config-flash.c404633.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png",width:300,height:148},{path:i.p+"assets/images/ideal-img/tool-config-flash.6eb2cd7.600.png",width:600,height:296},{path:i.p+"assets/images/ideal-img/tool-config-flash.d81da13.900.png",width:900,height:443},{path:i.p+"assets/images/ideal-img/tool-config-flash.c404633.1200.png",width:1200,height:591}],src:i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png"},placeholder:void 0,width:300,height:148},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAFCAYAAAB8ZH1oAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAgElEQVR4nG3JUQqCQBhF4dl/EASllUKtooeIIGgPtQIfzTSb/446J5AgAi983Ifjrpczp+OBzXpJnqXsd/kozxKybUK6WpDMZ9GpbQkSQ4xMLUp0RYEr7zeaR0VZv6ie1ahparx/j8w8FgxnZgxxwJshGfp+CPqR4STR991/mPABrsC4zAIkdt8AAAAASUVORK5CYII="}},3407:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png 300w,"+i.p+"assets/images/ideal-img/tool-config-loaded.4114a82.600.png 600w,"+i.p+"assets/images/ideal-img/tool-config-loaded.aa13a16.900.png 900w,"+i.p+"assets/images/ideal-img/tool-config-loaded.a03c7c0.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png",width:300,height:155},{path:i.p+"assets/images/ideal-img/tool-config-loaded.4114a82.600.png",width:600,height:309},{path:i.p+"assets/images/ideal-img/tool-config-loaded.aa13a16.900.png",width:900,height:464},{path:i.p+"assets/images/ideal-img/tool-config-loaded.a03c7c0.1200.png",width:1200,height:618}],src:i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png"},placeholder:void 0,width:300,height:155},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAFCAYAAAB8ZH1oAAAACXBIWXMAAAsTAAALEwEAmpwYAAAArklEQVR4nB2KwUoDQRBE55+j4q6yCIkHf2Bv6tEf8KYgcT0mUSEEwXUOih4lGNLuzHTPC5mCRz2Kcpc3V7TXLcfjivr8hObirFBNaqpxzUFzyNHpKLupf+HBv3LXPzP9XPLYL+je5zzt/WvF/duMrrvFSf9B2mwRSViG9P3D4D0l2UrZZo0T2RJjZAgDakoy5T8MJNWyS4zEv19cCAHVhIhgOWNm5ZD3rkqIEUuJHXKrsKwTcDxUAAAAAElFTkSuQmCC"}},1741:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png 300w,"+i.p+"assets/images/ideal-img/tool-config-logs.af58ae6.600.png 600w,"+i.p+"assets/images/ideal-img/tool-config-logs.06701a1.900.png 900w,"+i.p+"assets/images/ideal-img/tool-config-logs.1fd3d4d.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png",width:300,height:206},{path:i.p+"assets/images/ideal-img/tool-config-logs.af58ae6.600.png",width:600,height:412},{path:i.p+"assets/images/ideal-img/tool-config-logs.06701a1.900.png",width:900,height:619},{path:i.p+"assets/images/ideal-img/tool-config-logs.1fd3d4d.1200.png",width:1200,height:825}],src:i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png"},placeholder:void 0,width:300,height:206},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAYAAAAxrNxjAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAxUlEQVR4nGWOu07EMAAE/d8UILhAwnEtDaKmgW86KYnz1In4lTh2yCBMhVhptMVOseLj/Y3Xl2fy+1uORcbp+MDpKeexyCjyO7LDDYfrq13E2bFtG/u+s/M/XzESxgGhzmdW7/mcFJM2KG3QRmOdwznLPDuW4BEhRrYYaaRESklVVanbtk1M04Q1BhFDYF09UtbUdZ3Esixpmoau635FZxExBha/pKHve4ZhQCmFtRZjTOofRAgr3i8MreQyjmitmdO/v3wDWVgAL2Yh6GYAAAAASUVORK5CYII="}},309:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png 300w,"+i.p+"assets/images/ideal-img/tool-connect-auto.8e919af.600.png 600w,"+i.p+"assets/images/ideal-img/tool-connect-auto.9baaf14.900.png 900w,"+i.p+"assets/images/ideal-img/tool-connect-auto.478ac37.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png",width:300,height:148},{path:i.p+"assets/images/ideal-img/tool-connect-auto.8e919af.600.png",width:600,height:297},{path:i.p+"assets/images/ideal-img/tool-connect-auto.9baaf14.900.png",width:900,height:445},{path:i.p+"assets/images/ideal-img/tool-connect-auto.478ac37.1200.png",width:1200,height:593}],src:i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png"},placeholder:void 0,width:300,height:148},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAFCAYAAAB8ZH1oAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAlklEQVR4nD2NywpBURhG90OT+yUPYaBOyfuIgQxESQYGctrnwn/hLB1ksPpaa/KFxTwhmU0Z9luMBm0m496H2vvdJp12g26nUYXqKajcKYocM8Hd8Kfjpqg7ZYzEw56wWq7JzjtimlKoE09H0u0GVUFq7iWSZ4Tr5YLlN0wfqBlSFkgWMVNM5btuhOr1ooJv+MX6+u8/3nV9s9SCuj06AAAAAElFTkSuQmCC"}},7624:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png 300w,"+i.p+"assets/images/ideal-img/tool-show-logfiles.7348375.321.png 321w",images:[{path:i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png",width:300,height:89},{path:i.p+"assets/images/ideal-img/tool-show-logfiles.7348375.321.png",width:321,height:95}],src:i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png"},placeholder:void 0,width:300,height:89},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAADCAIAAAAlXwkiAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAW0lEQVR4nB3CQQpAUBQF0L82K5AFWIip/ZgoE2NF5lYg+aLeu+++LzNxOsEAty//BkAVIgaoSCAQ9T4knZouf7DHuSjHLF+qGkAgaXT3RLqnm6pb169NG4fJyBfVF0/moQP9/AAAAABJRU5ErkJggg=="}},662:(e,o,i)=>{"use strict";i.r(o),i.d(o,{assets:()=>l,contentTitle:()=>s,default:()=>g,frontMatter:()=>a,metadata:()=>r,toc:()=>d});var t=i(4848),n=i(8453);const a={sidebar_position:1},s="Lobaro Config Tool",r={id:"configuration/lobaro-tool/index",title:"Lobaro Config Tool",description:"The Lobaro Config Tool (a.k.a. Lobaro Maintenance Tool) can be used to configure and diagnose Lobaro devices locally using a PC and our special",source:"@site/docs/configuration/lobaro-tool/index.md",sourceDirName:"configuration/lobaro-tool",slug:"/configuration/lobaro-tool/",permalink:"/iot/configuration/lobaro-tool/",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/lobaro-tool/index.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"configurationSidebar",previous:{title:"Lobaro USB Config Adapter",permalink:"/iot/configuration/usb-config-adapter"},next:{title:"CRON Configuration",permalink:"/iot/configuration/cron-configuration"}},l={},d=[{value:"System Requirements",id:"system-requirements",level:2},{value:"Operating systems",id:"operating-systems",level:3},{value:"Default UART config",id:"default-uart-config",level:3},{value:"Download",id:"download",level:2},{value:"Installation",id:"installation",level:2},{value:"Windows",id:"windows",level:3},{value:"macOS / Linux",id:"macos--linux",level:3},{value:"Connection Setup",id:"connection-setup",level:2},{value:"Device Configuration",id:"device-configuration",level:2},{value:"Device Uart Logging",id:"device-uart-logging",level:2},{value:"Restarting",id:"restarting",level:3},{value:"Log-Files",id:"log-files",level:3},{value:"Sending to the device",id:"sending-to-the-device",level:3},{value:"Log parsing",id:"log-parsing",level:3},{value:"Device Firmwareupdate",id:"device-firmwareupdate",level:2},{value:"Getting the firmware",id:"getting-the-firmware",level:3},{value:"Installing new firmware",id:"installing-new-firmware",level:3}];function c(e){const o={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,n.R)(),...e.components},{Image:a}=o;return a||function(e,o){throw new Error("Expected "+(o?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(o.h1,{id:"lobaro-config-tool",children:"Lobaro Config Tool"}),"\n",(0,t.jsxs)(o.p,{children:["The Lobaro Config Tool (a.k.a. Lobaro Maintenance Tool) can be used to configure and diagnose Lobaro devices locally using a PC and our special\n",(0,t.jsx)(o.a,{href:"../usb-config-adapter",children:"USB configuration adapter"}),". It's available as free ",(0,t.jsx)(o.a,{href:"#download",children:"download"})," for all common\noperating systems."]}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool",img:i(2371),style:{width:"60%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(o.h2,{id:"system-requirements",children:"System Requirements"}),"\n",(0,t.jsx)(o.p,{children:"The tools runs as local webserver and the user frontend is accessed using a standard browser."}),"\n",(0,t.jsx)(o.h3,{id:"operating-systems",children:"Operating systems"}),"\n",(0,t.jsx)(o.p,{children:"The tools is available for the following operating systems:"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"macOS"}),"\n",(0,t.jsx)(o.li,{children:"Windows 7/10/11"}),"\n",(0,t.jsx)(o.li,{children:"Linux"}),"\n"]}),"\n",(0,t.jsx)(o.h3,{id:"default-uart-config",children:"Default UART config"}),"\n",(0,t.jsx)(o.p,{children:"The default uart configuration is:"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"115200 Baud"}),"\n",(0,t.jsx)(o.li,{children:"8 data bits"}),"\n",(0,t.jsx)(o.li,{children:"Even parity"}),"\n",(0,t.jsx)(o.li,{children:"1 stop bot"}),"\n"]}),"\n",(0,t.jsxs)(o.p,{children:["This UART configuration is used by ",(0,t.jsx)(o.strong,{children:"all Lobaro devices"}),' on the "Config" port.']}),"\n",(0,t.jsx)(o.h2,{id:"download",children:"Download"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:(0,t.jsx)(o.a,{href:"https://github.com/lobaro/flash-tool-release/releases",children:"https://github.com/lobaro/flash-tool-release/releases"})}),"\n"]}),"\n",(0,t.jsx)(o.admonition,{title:"Correct Download for your OS",type:"tip",children:(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsxs)(o.li,{children:["Windows: ",(0,t.jsx)(o.code,{children:"...windows_x86_64.zip"})]}),"\n",(0,t.jsxs)(o.li,{children:["Linux: ",(0,t.jsx)(o.code,{children:"...linux_x86_64.zip"})]}),"\n",(0,t.jsxs)(o.li,{children:["macOS (ARM): ",(0,t.jsx)(o.code,{children:"...mac_arm64.zip"})]}),"\n",(0,t.jsxs)(o.li,{children:["macOS (INTEL): ",(0,t.jsx)(o.code,{children:"...mac_x86_64.zip"})]}),"\n"]})}),"\n",(0,t.jsx)(o.h2,{id:"installation",children:"Installation"}),"\n",(0,t.jsx)(o.h3,{id:"windows",children:"Windows"}),"\n",(0,t.jsx)(o.p,{children:'After downloading unzip and simply start the "lobaro-tool.exe" with double click.'}),"\n",(0,t.jsx)(o.admonition,{type:"info",children:(0,t.jsx)(o.p,{children:"Windows might show up a security warning and ask you to proceed anyway. This behavior is normal."})}),"\n",(0,t.jsx)(o.h3,{id:"macos--linux",children:"macOS / Linux"}),"\n",(0,t.jsx)(o.p,{children:'After downloading and unzip the "lobaro-tool" file, e.g. to a directory "lobaro" in your home path. Then make the tool\nfile executable:'}),"\n",(0,t.jsx)(o.pre,{children:(0,t.jsx)(o.code,{className:'language-bash"',children:"cd ~/lobaro\nchmod +x lobaro-tool\n./lobaro-tool\n"})}),"\n",(0,t.jsx)(o.h2,{id:"connection-setup",children:"Connection Setup"}),"\n",(0,t.jsxs)(o.p,{children:["Connect your Lobaro Device using the ",(0,t.jsx)(o.a,{href:"../usb-config-adapter",children:"Lobaro Config Adapter"})," to the USB-port of your computer."]}),"\n",(0,t.jsx)(o.p,{children:"When your device is successfully attached to your computer, you can build a connection with the Lobaro Maintenance Tool."}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(309),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["Under Hardware Connection select ",(0,t.jsx)(o.em,{children:"auto"})," and click ",(0,t.jsx)(o.em,{children:"Connect"}),", as seen in the screenshot above. If you know to which port\nthe\ndevice is connected to your computer (either COM or ttyUSB), you can alternatively select it explicitly instead of using\nauto."]}),"\n",(0,t.jsx)(o.h2,{id:"device-configuration",children:"Device Configuration"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(3407),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["When you are connected to a Lobaro Device, you can use the Tab named ",(0,t.jsx)(o.strong,{children:"CONFIGURATION"})," to read and change the\nconfiguration\nparameters of the Device. You can read out the current configuration from the device by pressing the Reload Config\nbutton (reading takes a few seconds)."]}),"\n",(0,t.jsxs)(o.admonition,{title:"Automatic device reboot",type:"warning",children:[(0,t.jsx)(o.p,{children:"Every time you use one of the buttons Reload Config. Write to Device, or Restore Default, the connected device will be\nrebooted! Also keep in mind that the operations triggered by pressing the buttons include communication with the device\nover a serial bus and they will take a few seconds."}),(0,t.jsx)(o.p,{children:"To avoid errors, please do not press those buttons repeatedly!"})]}),"\n",(0,t.jsxs)(o.p,{children:["When the configuration is read, you can alter the parameters by clicking on the pencil icon on the right. Values that\nyou changed will printed in bold font. When you have adjusted all values you want to change, you ",(0,t.jsx)(o.strong,{children:"must"})," press\n",(0,t.jsx)(o.em,{children:"Write to Device"})," to actually change anything in the device internal memory! Writing the values will also reboot the\ndevice."]}),"\n",(0,t.jsxs)(o.p,{children:["The Button ",(0,t.jsx)(o.em,{children:"Restore Default"})," will reset all config parameters of the connected Device to their internal default values.\nThe device will reboot, and the listed values of the configuration in the Lobaro Maintenance Tool well be updated."]}),"\n",(0,t.jsx)(o.admonition,{title:"Always reload the config before changing it!",type:"danger",children:(0,t.jsxs)(o.p,{children:["When you are working with multiple devices, make sure that your always press Reload Config after attaching a new device\nbefore you start updating values. If you fail to do so, you might accidentally transfer values from the previously\nattached device to the newly connected. This is especially a problem when working with LoRaWAN sensors, as you will copy\nthe DevEUI from one device to the other! This can be reverted by using the ",(0,t.jsx)(o.em,{children:"Restore Default"})," functionality."]})}),"\n",(0,t.jsxs)(o.p,{children:["You can watch the rebooting of the Device and check the altered configuration parameters by locking in the ",(0,t.jsx)(o.strong,{children:"LOGS"})," Tab."]}),"\n",(0,t.jsx)(o.h2,{id:"device-uart-logging",children:"Device Uart Logging"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(1741),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsx)(o.p,{children:"All of our Devices provide extensive logging information over the CONFIG port. When you are connected to a Device in the\nLobaro Maintenance Tool, you can read the log messages in the LOGS Tab. This feature is helpful if you try to find out\nthe cause of problems you experience. You can also find out a lot of information about your Device, for example you can\nfind the parameters used to connect your LoRaWAN Devices to your Network Server (DevEUI, AppKey, etc.)."}),"\n",(0,t.jsx)(o.p,{children:"All messages are displayed in the big text area, each line is prefixed by the time it is received (using the clock of\nyour computer). You can use Clear Log to start again with an empty text area. The cleared messages will still be\navailable through the log files that the tool creates."}),"\n",(0,t.jsx)(o.p,{children:"When starting, our devices print out their current configuration parameter values. Most Devices also have a power on\ntest, that checks if attached sensors can be read successfully. Any Problems that the Device detects will be printed to\nthe log."}),"\n",(0,t.jsx)(o.h3,{id:"restarting",children:"Restarting"}),"\n",(0,t.jsx)(o.p,{children:"The LOGS Tab also contains a button Run (reset). This button triggers a reboot of the attached device. This can be\nuseful when you start working with your device or if you try to fix issues with connected sensors."}),"\n",(0,t.jsx)(o.h3,{id:"log-files",children:"Log-Files"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(7624),style:{width:"25%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["The logs are also written to files on your computer. Every time you start the Lobaro Maintenance Tool, a new log file is\ncreated. When you press the button ",(0,t.jsx)(o.strong,{children:"Show Log Files"})," in the upper right location of the tool, a file browser is opened\nat the location where log files are kept."]}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsxs)(o.li,{children:["Windows: ",(0,t.jsx)(o.code,{children:"%homepath%\\.lobaro\\logs"})]}),"\n",(0,t.jsxs)(o.li,{children:["Linux / Mac: ",(0,t.jsx)(o.code,{children:"~/.lobaro/logs"})]}),"\n",(0,t.jsxs)(o.li,{children:["File Name: ",(0,t.jsx)(o.code,{children:"-uart-log.txt"})]}),"\n"]}),"\n",(0,t.jsx)(o.h3,{id:"sending-to-the-device",children:"Sending to the device"}),"\n",(0,t.jsx)(o.p,{children:"Below the text area is an input field Send via UART. Text entered here (and confirmed with Enter) will be sent to the\nconnected Device via UART. Some of our Devices use this feature, for example the LoRaWAN Modbus Bridge for its\ninteractive Dialog Mode."}),"\n",(0,t.jsx)(o.h3,{id:"log-parsing",children:"Log parsing"}),"\n",(0,t.jsx)(o.p,{children:"If you need to parse the log messages of one of our Devices with your own tools, you can connect to it without the\nMaintenance Tool by using any serial UART reader. You can find the UART parameters above. Take care on the additional\ncontrol lines (DTR, RTS) to have the right state to keep the device run the firmware."}),"\n",(0,t.jsx)(o.h2,{id:"device-firmwareupdate",children:"Device Firmwareupdate"}),"\n",(0,t.jsx)(o.p,{children:"Our devices are shipped ready to use with firmware installed on them, so normally you do not need to install firmware\nyourself. However, over time we sometimes add new features to our devices or fix bugs that come up over time. If you\nwant to use those improvements for devices all ready shipped to you, you can update the firmware yourself."}),"\n",(0,t.jsx)(o.p,{children:"This page describes how you install firmware on devices that you have physical access to. This can be done for most of\nour devices, those using LoRaWAN and those using NB-IoT/LTE-M."}),"\n",(0,t.jsxs)(o.p,{children:["Our NB-IoT/LTE-M devices also support installing firmware over the air, without physical access. Check the ",(0,t.jsx)(o.a,{href:"/cloud",children:"platform\ndocumentation"})," for details."]}),"\n",(0,t.jsx)(o.h3,{id:"getting-the-firmware",children:"Getting the firmware"}),"\n",(0,t.jsx)(o.p,{children:"You will need the Firmware you want to install to your device as a file on your computer."}),"\n",(0,t.jsxs)(o.p,{children:["You can get the latest firmware files from this documentation on the firmware subpage for your specific Lobaro product.\nThe files are\nin a format called Hex and are therefore also called Hex-File. The filename always starts with app- and contains the\nversion number as well as a short description of its function and the hardware it is used for. So, for example,\n",(0,t.jsx)(o.code,{children:"app-nrf9160-wmbus-TZ2-0.3.1-mcuboot-slot0.hex"})," contains firmware for our wMBus-Gateway on NB-IoT-Hardware (nrf9160) in\nversion 0.3.1."]}),"\n",(0,t.jsx)(o.h3,{id:"installing-new-firmware",children:"Installing new firmware"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Flash new firmware",img:i(900),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["Make sure your Device is successfully attached to your computer and the Maintenance Tool is connected, as described\nabove. In the Tab ",(0,t.jsx)(o.strong,{children:"FIRMWARE"})," you can select the Firmware file you want to install using the button ",(0,t.jsx)(o.em,{children:"Select Hex File"}),".\nThis\nwill open a file selection dialog, where you can select the hex-file with the Firmware you want to install to your\nDevice. To start installing you need to press ",(0,t.jsx)(o.em,{children:"Flash Hex File"}),". The upload will take several seconds; progress will be\ndisplayed by the blue progress bar. It turns green on successful completion. You can verify the installation succeeded\nand your Device is now running the correct version by checking the ",(0,t.jsx)(o.strong,{children:"LOGS"})," Tab."]}),"\n",(0,t.jsx)(o.p,{children:"You should also take a look at the Configuration Parameters. When an update adds new features, there might be new\nConfiguration Parameters to set, or some existing Parameters might work differently. Check the Firmware's Changelog to\nsee what changed between versions and what you have to look out for, for your individual Firmware update."})]})}function g(e={}){const{wrapper:o}={...(0,n.R)(),...e.components};return o?(0,t.jsx)(o,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},8453:(e,o,i)=>{"use strict";i.d(o,{R:()=>s,x:()=>r});var t=i(6540);const n={},a=t.createContext(n);function s(e){const o=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(o):{...o,...e}}),[o,e])}function r(e){let o;return o=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:s(e.components),t.createElement(a.Provider,{value:o},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/49425f7e.f8d531d8.js b/assets/js/49425f7e.f8d531d8.js deleted file mode 100644 index ef17b515..00000000 --- a/assets/js/49425f7e.f8d531d8.js +++ /dev/null @@ -1 +0,0 @@ -(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[7237],{2371:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png 300w,"+i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.c09dea3.600.png 600w,"+i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.18a3bd5.900.png 900w,"+i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.699e2d7.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png",width:300,height:179},{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.c09dea3.600.png",width:600,height:358},{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.18a3bd5.900.png",width:900,height:537},{path:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.699e2d7.1200.png",width:1200,height:716}],src:i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png",toString:function(){return i.p+"assets/images/ideal-img/Lobaro_Tool_ConfigFeature.d6a9d01.300.png"},placeholder:void 0,width:300,height:179},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAGCAIAAAB1kpiRAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAgklEQVR4nC2MQQ7CMAwE8/8HwoEi7kW0SZTG9q6doCDmNHOZdOacSzZVACDhvgSUdtX3nuq+15KP2i6RXks/PqYipi3n8nyksm3a2iWq9OP1Ou83cl0IwJmMHhEiMiIM4BjuPuckqaoJZu7svUfEiJjjD0kzS4ABZqbu68cf7uQq+wK1c63N5QE9AAAAAABJRU5ErkJggg=="}},900:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png 300w,"+i.p+"assets/images/ideal-img/tool-config-flash.6eb2cd7.600.png 600w,"+i.p+"assets/images/ideal-img/tool-config-flash.d81da13.900.png 900w,"+i.p+"assets/images/ideal-img/tool-config-flash.c404633.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png",width:300,height:148},{path:i.p+"assets/images/ideal-img/tool-config-flash.6eb2cd7.600.png",width:600,height:296},{path:i.p+"assets/images/ideal-img/tool-config-flash.d81da13.900.png",width:900,height:443},{path:i.p+"assets/images/ideal-img/tool-config-flash.c404633.1200.png",width:1200,height:591}],src:i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-config-flash.9a69a9b.300.png"},placeholder:void 0,width:300,height:148},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAFCAYAAAB8ZH1oAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAgElEQVR4nG3JUQqCQBhF4dl/EASllUKtooeIIGgPtQIfzTSb/446J5AgAi983Ifjrpczp+OBzXpJnqXsd/kozxKybUK6WpDMZ9GpbQkSQ4xMLUp0RYEr7zeaR0VZv6ie1ahparx/j8w8FgxnZgxxwJshGfp+CPqR4STR991/mPABrsC4zAIkdt8AAAAASUVORK5CYII="}},3407:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png 300w,"+i.p+"assets/images/ideal-img/tool-config-loaded.4114a82.600.png 600w,"+i.p+"assets/images/ideal-img/tool-config-loaded.aa13a16.900.png 900w,"+i.p+"assets/images/ideal-img/tool-config-loaded.a03c7c0.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png",width:300,height:155},{path:i.p+"assets/images/ideal-img/tool-config-loaded.4114a82.600.png",width:600,height:309},{path:i.p+"assets/images/ideal-img/tool-config-loaded.aa13a16.900.png",width:900,height:464},{path:i.p+"assets/images/ideal-img/tool-config-loaded.a03c7c0.1200.png",width:1200,height:618}],src:i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-config-loaded.c0dac26.300.png"},placeholder:void 0,width:300,height:155},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAFCAYAAAB8ZH1oAAAACXBIWXMAAAsTAAALEwEAmpwYAAAArklEQVR4nB2KwUoDQRBE55+j4q6yCIkHf2Bv6tEf8KYgcT0mUSEEwXUOih4lGNLuzHTPC5mCRz2Kcpc3V7TXLcfjivr8hObirFBNaqpxzUFzyNHpKLupf+HBv3LXPzP9XPLYL+je5zzt/WvF/duMrrvFSf9B2mwRSViG9P3D4D0l2UrZZo0T2RJjZAgDakoy5T8MJNWyS4zEv19cCAHVhIhgOWNm5ZD3rkqIEUuJHXKrsKwTcDxUAAAAAElFTkSuQmCC"}},1741:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png 300w,"+i.p+"assets/images/ideal-img/tool-config-logs.af58ae6.600.png 600w,"+i.p+"assets/images/ideal-img/tool-config-logs.06701a1.900.png 900w,"+i.p+"assets/images/ideal-img/tool-config-logs.1fd3d4d.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png",width:300,height:206},{path:i.p+"assets/images/ideal-img/tool-config-logs.af58ae6.600.png",width:600,height:412},{path:i.p+"assets/images/ideal-img/tool-config-logs.06701a1.900.png",width:900,height:619},{path:i.p+"assets/images/ideal-img/tool-config-logs.1fd3d4d.1200.png",width:1200,height:825}],src:i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-config-logs.e732294.300.png"},placeholder:void 0,width:300,height:206},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAYAAAAxrNxjAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAxUlEQVR4nGWOu07EMAAE/d8UILhAwnEtDaKmgW86KYnz1In4lTh2yCBMhVhptMVOseLj/Y3Xl2fy+1uORcbp+MDpKeexyCjyO7LDDYfrq13E2bFtG/u+s/M/XzESxgGhzmdW7/mcFJM2KG3QRmOdwznLPDuW4BEhRrYYaaRESklVVanbtk1M04Q1BhFDYF09UtbUdZ3Esixpmoau635FZxExBha/pKHve4ZhQCmFtRZjTOofRAgr3i8MreQyjmitmdO/v3wDWVgAL2Yh6GYAAAAASUVORK5CYII="}},309:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png 300w,"+i.p+"assets/images/ideal-img/tool-connect-auto.8e919af.600.png 600w,"+i.p+"assets/images/ideal-img/tool-connect-auto.9baaf14.900.png 900w,"+i.p+"assets/images/ideal-img/tool-connect-auto.478ac37.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png",width:300,height:148},{path:i.p+"assets/images/ideal-img/tool-connect-auto.8e919af.600.png",width:600,height:297},{path:i.p+"assets/images/ideal-img/tool-connect-auto.9baaf14.900.png",width:900,height:445},{path:i.p+"assets/images/ideal-img/tool-connect-auto.478ac37.1200.png",width:1200,height:593}],src:i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-connect-auto.e6e9dcb.300.png"},placeholder:void 0,width:300,height:148},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAFCAYAAAB8ZH1oAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAlklEQVR4nD2NywpBURhG90OT+yUPYaBOyfuIgQxESQYGctrnwn/hLB1ksPpaa/KFxTwhmU0Z9luMBm0m496H2vvdJp12g26nUYXqKajcKYocM8Hd8Kfjpqg7ZYzEw56wWq7JzjtimlKoE09H0u0GVUFq7iWSZ4Tr5YLlN0wfqBlSFkgWMVNM5btuhOr1ooJv+MX6+u8/3nV9s9SCuj06AAAAAElFTkSuQmCC"}},7624:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png 300w,"+i.p+"assets/images/ideal-img/tool-show-logfiles.7348375.321.png 321w",images:[{path:i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png",width:300,height:89},{path:i.p+"assets/images/ideal-img/tool-show-logfiles.7348375.321.png",width:321,height:95}],src:i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png",toString:function(){return i.p+"assets/images/ideal-img/tool-show-logfiles.3584076.300.png"},placeholder:void 0,width:300,height:89},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAADCAIAAAAlXwkiAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAW0lEQVR4nB3CQQpAUBQF0L82K5AFWIip/ZgoE2NF5lYg+aLeu+++LzNxOsEAty//BkAVIgaoSCAQ9T4knZouf7DHuSjHLF+qGkAgaXT3RLqnm6pb169NG4fJyBfVF0/moQP9/AAAAABJRU5ErkJggg=="}},662:(e,o,i)=>{"use strict";i.r(o),i.d(o,{assets:()=>r,contentTitle:()=>s,default:()=>h,frontMatter:()=>a,metadata:()=>l,toc:()=>d});var t=i(4848),n=i(8453);const a={sidebar_position:1},s="Lobaro Maintenance Tool",l={id:"configuration/lobaro-tool/index",title:"Lobaro Maintenance Tool",description:"The Lobaro Maintenance Tool can be used to configure and diagnose Lobaro devices locally using a PC and our special",source:"@site/docs/configuration/lobaro-tool/index.md",sourceDirName:"configuration/lobaro-tool",slug:"/configuration/lobaro-tool/",permalink:"/iot/configuration/lobaro-tool/",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/lobaro-tool/index.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"configurationSidebar",previous:{title:"USB Config Adapter",permalink:"/iot/configuration/usb-config-adapter"},next:{title:"CRON Expressions",permalink:"/iot/configuration/cron-expressions"}},r={},d=[{value:"System Requirements",id:"system-requirements",level:2},{value:"Operating systems",id:"operating-systems",level:3},{value:"Default UART config",id:"default-uart-config",level:3},{value:"Download",id:"download",level:2},{value:"Installation",id:"installation",level:2},{value:"Windows",id:"windows",level:3},{value:"macOS / Linux",id:"macos--linux",level:3},{value:"Connection Setup",id:"connection-setup",level:2},{value:"Device Configuration",id:"device-configuration",level:2},{value:"Device Uart Logging",id:"device-uart-logging",level:2},{value:"Restarting",id:"restarting",level:3},{value:"Log-Files",id:"log-files",level:3},{value:"Sending to the device",id:"sending-to-the-device",level:3},{value:"Log parsing",id:"log-parsing",level:3},{value:"Device Firmwareupdate",id:"device-firmwareupdate",level:2},{value:"Getting the firmware",id:"getting-the-firmware",level:3},{value:"Installing new firmware",id:"installing-new-firmware",level:3}];function c(e){const o={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,n.R)(),...e.components},{Image:a}=o;return a||function(e,o){throw new Error("Expected "+(o?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(o.h1,{id:"lobaro-maintenance-tool",children:"Lobaro Maintenance Tool"}),"\n",(0,t.jsxs)(o.p,{children:["The Lobaro Maintenance Tool can be used to configure and diagnose Lobaro devices locally using a PC and our special\n",(0,t.jsx)(o.a,{href:"../usb-config-adapter",children:"USB configuration adapter"}),". It's available as free ",(0,t.jsx)(o.a,{href:"#download",children:"download"})," for all common\noperating systems."]}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool",img:i(2371),style:{width:"60%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(o.h2,{id:"system-requirements",children:"System Requirements"}),"\n",(0,t.jsx)(o.p,{children:"The tools runs as local webserver and the user frontend is accessed using a standard browser."}),"\n",(0,t.jsx)(o.h3,{id:"operating-systems",children:"Operating systems"}),"\n",(0,t.jsx)(o.p,{children:"The tools is available for the following operating systems:"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"macOS"}),"\n",(0,t.jsx)(o.li,{children:"Windows 7/10/11"}),"\n",(0,t.jsx)(o.li,{children:"Linux"}),"\n"]}),"\n",(0,t.jsx)(o.h3,{id:"default-uart-config",children:"Default UART config"}),"\n",(0,t.jsx)(o.p,{children:"The default uart configuration is:"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"115200 Baud"}),"\n",(0,t.jsx)(o.li,{children:"8 data bits"}),"\n",(0,t.jsx)(o.li,{children:"Even parity"}),"\n",(0,t.jsx)(o.li,{children:"1 stop bot"}),"\n"]}),"\n",(0,t.jsxs)(o.p,{children:["This UART configuration is used by ",(0,t.jsx)(o.strong,{children:"all Lobaro devices"}),' on the "Config" port.']}),"\n",(0,t.jsx)(o.h2,{id:"download",children:"Download"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:(0,t.jsx)(o.a,{href:"https://github.com/lobaro/flash-tool-release/releases",children:"https://github.com/lobaro/flash-tool-release/releases"})}),"\n"]}),"\n",(0,t.jsx)(o.admonition,{title:"Correct Download for your OS",type:"tip",children:(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsxs)(o.li,{children:["Windows: ",(0,t.jsx)(o.code,{children:"...windows_x86_64.zip"})]}),"\n",(0,t.jsxs)(o.li,{children:["Linux: ",(0,t.jsx)(o.code,{children:"...linux_x86_64.zip"})]}),"\n",(0,t.jsxs)(o.li,{children:["macOS (ARM): ",(0,t.jsx)(o.code,{children:"...mac_arm64.zip"})]}),"\n",(0,t.jsxs)(o.li,{children:["macOS (INTEL): ",(0,t.jsx)(o.code,{children:"...mac_x86_64.zip"})]}),"\n"]})}),"\n",(0,t.jsx)(o.h2,{id:"installation",children:"Installation"}),"\n",(0,t.jsx)(o.h3,{id:"windows",children:"Windows"}),"\n",(0,t.jsx)(o.p,{children:'After downloading unzip and simply start the "lobaro-tool.exe" with double click.'}),"\n",(0,t.jsx)(o.admonition,{type:"info",children:(0,t.jsx)(o.p,{children:"Windows might show up a security warning and ask you to proceed anyway. This behavior is normal."})}),"\n",(0,t.jsx)(o.h3,{id:"macos--linux",children:"macOS / Linux"}),"\n",(0,t.jsx)(o.p,{children:'After downloading and unzip the "lobaro-tool" file, e.g. to a directory "lobaro" in your home path. Then make the tool\nfile executable:'}),"\n",(0,t.jsx)(o.pre,{children:(0,t.jsx)(o.code,{className:'language-bash"',children:"cd ~/lobaro\nchmod +x lobaro-tool\n./lobaro-tool\n"})}),"\n",(0,t.jsx)(o.h2,{id:"connection-setup",children:"Connection Setup"}),"\n",(0,t.jsxs)(o.p,{children:["Connect your Lobaro Device using the ",(0,t.jsx)(o.a,{href:"../usb-config-adapter",children:"Lobaro Config Adapter"})," to the USB-port of your computer."]}),"\n",(0,t.jsx)(o.p,{children:"When your device is successfully attached to your computer, you can build a connection with the Lobaro Maintenance Tool."}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(309),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["Under Hardware Connection select ",(0,t.jsx)(o.em,{children:"auto"})," and click ",(0,t.jsx)(o.em,{children:"Connect"}),", as seen in the screenshot above. If you know to which port\nthe\ndevice is connected to your computer (either COM or ttyUSB), you can alternatively select it explicitly instead of using\nauto."]}),"\n",(0,t.jsx)(o.h2,{id:"device-configuration",children:"Device Configuration"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(3407),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["When you are connected to a Lobaro Device, you can use the Tab named ",(0,t.jsx)(o.strong,{children:"CONFIGURATION"})," to read and change the\nconfiguration\nparameters of the Device. You can read out the current configuration from the device by pressing the Reload Config\nbutton (reading takes a few seconds)."]}),"\n",(0,t.jsxs)(o.admonition,{title:"Automatic device reboot",type:"warning",children:[(0,t.jsx)(o.p,{children:"Every time you use one of the buttons Reload Config. Write to Device, or Restore Default, the connected device will be\nrebooted! Also keep in mind that the operations triggered by pressing the buttons include communication with the device\nover a serial bus and they will take a few seconds."}),(0,t.jsx)(o.p,{children:"To avoid errors, please do not press those buttons repeatedly!"})]}),"\n",(0,t.jsxs)(o.p,{children:["When the configuration is read, you can alter the parameters by clicking on the pencil icon on the right. Values that\nyou changed will printed in bold font. When you have adjusted all values you want to change, you ",(0,t.jsx)(o.strong,{children:"must"})," press\n",(0,t.jsx)(o.em,{children:"Write to Device"})," to actually change anything in the device internal memory! Writing the values will also reboot the\ndevice."]}),"\n",(0,t.jsxs)(o.p,{children:["The Button ",(0,t.jsx)(o.em,{children:"Restore Default"})," will reset all config parameters of the connected Device to their internal default values.\nThe device will reboot, and the listed values of the configuration in the Lobaro Maintenance Tool well be updated."]}),"\n",(0,t.jsx)(o.admonition,{title:"Always reload the config before changing it!",type:"danger",children:(0,t.jsxs)(o.p,{children:["When you are working with multiple devices, make sure that your always press Reload Config after attaching a new device\nbefore you start updating values. If you fail to do so, you might accidentally transfer values from the previously\nattached device to the newly connected. This is especially a problem when working with LoRaWAN sensors, as you will copy\nthe DevEUI from one device to the other! This can be reverted by using the ",(0,t.jsx)(o.em,{children:"Restore Default"})," functionality."]})}),"\n",(0,t.jsxs)(o.p,{children:["You can watch the rebooting of the Device and check the altered configuration parameters by locking in the ",(0,t.jsx)(o.strong,{children:"LOGS"})," Tab."]}),"\n",(0,t.jsx)(o.h2,{id:"device-uart-logging",children:"Device Uart Logging"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(1741),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsx)(o.p,{children:"All of our Devices provide extensive logging information over the CONFIG port. When you are connected to a Device in the\nLobaro Maintenance Tool, you can read the log messages in the LOGS Tab. This feature is helpful if you try to find out\nthe cause of problems you experience. You can also find out a lot of information about your Device, for example you can\nfind the parameters used to connect your LoRaWAN Devices to your Network Server (DevEUI, AppKey, etc.)."}),"\n",(0,t.jsx)(o.p,{children:"All messages are displayed in the big text area, each line is prefixed by the time it is received (using the clock of\nyour computer). You can use Clear Log to start again with an empty text area. The cleared messages will still be\navailable through the log files that the tool creates."}),"\n",(0,t.jsx)(o.p,{children:"When starting, our devices print out their current configuration parameter values. Most Devices also have a power on\ntest, that checks if attached sensors can be read successfully. Any Problems that the Device detects will be printed to\nthe log."}),"\n",(0,t.jsx)(o.h3,{id:"restarting",children:"Restarting"}),"\n",(0,t.jsx)(o.p,{children:"The LOGS Tab also contains a button Run (reset). This button triggers a reboot of the attached device. This can be\nuseful when you start working with your device or if you try to fix issues with connected sensors."}),"\n",(0,t.jsx)(o.h3,{id:"log-files",children:"Log-Files"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Automatic Connection",img:i(7624),style:{width:"25%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["The logs are also written to files on your computer. Every time you start the Lobaro Maintenance Tool, a new log file is\ncreated. When you press the button ",(0,t.jsx)(o.strong,{children:"Show Log Files"})," in the upper right location of the tool, a file browser is opened\nat the location where log files are kept."]}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsxs)(o.li,{children:["Windows: ",(0,t.jsx)(o.code,{children:"%homepath%\\.lobaro\\logs"})]}),"\n",(0,t.jsxs)(o.li,{children:["Linux / Mac: ",(0,t.jsx)(o.code,{children:"~/.lobaro/logs"})]}),"\n",(0,t.jsxs)(o.li,{children:["File Name: ",(0,t.jsx)(o.code,{children:"-uart-log.txt"})]}),"\n"]}),"\n",(0,t.jsx)(o.h3,{id:"sending-to-the-device",children:"Sending to the device"}),"\n",(0,t.jsx)(o.p,{children:"Below the text area is an input field Send via UART. Text entered here (and confirmed with Enter) will be sent to the\nconnected Device via UART. Some of our Devices use this feature, for example the LoRaWAN Modbus Bridge for its\ninteractive Dialog Mode."}),"\n",(0,t.jsx)(o.h3,{id:"log-parsing",children:"Log parsing"}),"\n",(0,t.jsx)(o.p,{children:"If you need to parse the log messages of one of our Devices with your own tools, you can connect to it without the\nMaintenance Tool by using any serial UART reader. You can find the UART parameters above. Take care on the additional\ncontrol lines (DTR, RTS) to have the right state to keep the device run the firmware."}),"\n",(0,t.jsx)(o.h2,{id:"device-firmwareupdate",children:"Device Firmwareupdate"}),"\n",(0,t.jsx)(o.p,{children:"Our devices are shipped ready to use with firmware installed on them, so normally you do not need to install firmware\nyourself. However, over time we sometimes add new features to our devices or fix bugs that come up over time. If you\nwant to use those improvements for devices all ready shipped to you, you can update the firmware yourself."}),"\n",(0,t.jsx)(o.p,{children:"This page describes how you install firmware on devices that you have physical access to. This can be done for most of\nour devices, those using LoRaWAN and those using NB-IoT/LTE-M."}),"\n",(0,t.jsxs)(o.p,{children:["Our NB-IoT/LTE-M devices also support installing firmware over the air, without physical access. Check the ",(0,t.jsx)(o.a,{href:"/cloud",children:"platform\ndocumentation"})," for details."]}),"\n",(0,t.jsx)(o.h3,{id:"getting-the-firmware",children:"Getting the firmware"}),"\n",(0,t.jsx)(o.p,{children:"You will need the Firmware you want to install to your device as a file on your computer."}),"\n",(0,t.jsxs)(o.p,{children:["You can get the latest firmware files from this documentation on the firmware subpage for your specific Lobaro product.\nThe files are\nin a format called Hex and are therefore also called Hex-File. The filename always starts with app- and contains the\nversion number as well as a short description of its function and the hardware it is used for. So, for example,\n",(0,t.jsx)(o.code,{children:"app-nrf9160-wmbus-TZ2-0.3.1-mcuboot-slot0.hex"})," contains firmware for our wMBus-Gateway on NB-IoT-Hardware (nrf9160) in\nversion 0.3.1."]}),"\n",(0,t.jsx)(o.h3,{id:"installing-new-firmware",children:"Installing new firmware"}),"\n",(0,t.jsx)(a,{alt:"Lobaro Configuration Tool - Flash new firmware",img:i(900),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,t.jsxs)(o.p,{children:["Make sure your Device is successfully attached to your computer and the Maintenance Tool is connected, as described\nabove. In the Tab ",(0,t.jsx)(o.strong,{children:"FIRMWARE"})," you can select the Firmware file you want to install using the button ",(0,t.jsx)(o.em,{children:"Select Hex File"}),".\nThis\nwill open a file selection dialog, where you can select the hex-file with the Firmware you want to install to your\nDevice. To start installing you need to press ",(0,t.jsx)(o.em,{children:"Flash Hex File"}),". The upload will take several seconds; progress will be\ndisplayed by the blue progress bar. It turns green on successful completion. You can verify the installation succeeded\nand your Device is now running the correct version by checking the ",(0,t.jsx)(o.strong,{children:"LOGS"})," Tab."]}),"\n",(0,t.jsx)(o.p,{children:"You should also take a look at the Configuration Parameters. When an update adds new features, there might be new\nConfiguration Parameters to set, or some existing Parameters might work differently. Check the Firmware's Changelog to\nsee what changed between versions and what you have to look out for, for your individual Firmware update."})]})}function h(e={}){const{wrapper:o}={...(0,n.R)(),...e.components};return o?(0,t.jsx)(o,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},8453:(e,o,i)=>{"use strict";i.d(o,{R:()=>s,x:()=>l});var t=i(6540);const n={},a=t.createContext(n);function s(e){const o=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(o):{...o,...e}}),[o,e])}function l(e){let o;return o=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:s(e.components),t.createElement(a.Provider,{value:o},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/4ddd2498.1e45c94e.js b/assets/js/4ddd2498.1e45c94e.js new file mode 100644 index 00000000..98c81b09 --- /dev/null +++ b/assets/js/4ddd2498.1e45c94e.js @@ -0,0 +1 @@ +(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[1110],{5134:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png 300w,"+i.p+"assets/images/ideal-img/3F-result-in-ascii.40566be.600.png 600w,"+i.p+"assets/images/ideal-img/3F-result-in-ascii.c89288d.619.png 619w",images:[{path:i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png",width:300,height:314},{path:i.p+"assets/images/ideal-img/3F-result-in-ascii.40566be.600.png",width:600,height:628},{path:i.p+"assets/images/ideal-img/3F-result-in-ascii.c89288d.619.png",width:619,height:648}],src:i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png",toString:function(){return i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png"},placeholder:void 0,width:300,height:314},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAIAAAACUFjqAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABDUlEQVR4nCXOzU/CMBiA8f7/B4/eTSQSNHLQSDwoJhrR3fTAh4DuA9aObv0eHeu71qDJL8/5QUIqIRQXSiptdK20aZqDc9C2znuPKEkYzRhNJcNaEC2I4ljyXHJca4rI9qvAsWS5NdRILKrUGmrNztalYgkaj0fnF73BVX81j1S5YGTKixkvjmXFFJHtIksWaTwn2zUv04omvMok24gqE+UPsjUH8G3rjjsOALoQQvA+hNBYgWpTAjhwhw7aDlzX/Wu972zNkKHJge+sxtBQsHSvsJH5HyyrGN1/3vSi3kv0FL29TibPRb7cq43miRGZLNfo9vHsdHhyN+w/DK9Hl4PVx3tF4wKvd+SbkuUv4kcPHFiK110AAAAASUVORK5CYII="}},5607:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png 300w,"+i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.208579d.600.png 600w,"+i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.b7f06e1.882.png 882w",images:[{path:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png",width:300,height:224},{path:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.208579d.600.png",width:600,height:449},{path:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.b7f06e1.882.png",width:882,height:660}],src:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png",toString:function(){return i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png"},placeholder:void 0,width:300,height:224},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAIAAAC+zks0AAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAcUlEQVR4nG2MMQ7CMBAE/f9v0fAMilAgpAT7Ysu+27tFcYEAZTTdSJNIam35du8vcQYAdwcQESSTmW7PteXKM5KaSd1V1d1P8iili9h8xuQnN9nrfpwj/p3znEcTNfQBA789ctna9bI8ljUCZgrYR5JvSz7Nn8r84TIAAAAASUVORK5CYII="}},2627:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png 300w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.25fff62.600.png 600w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.29cb7ea.900.png 900w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.31d1046.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png",width:300,height:7},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.25fff62.600.png",width:600,height:13},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.29cb7ea.900.png",width:900,height:20},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.31d1046.1200.png",width:1200,height:27}],src:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png",toString:function(){return i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png"},placeholder:void 0,width:300,height:7},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAIAAABol6gpAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAKklEQVR4nAEfAOD/APLy8vDw8Pb29vLx8fH09O3Z2ea3t/Du7vHy8vPz86+eG6M4AoFrAAAAAElFTkSuQmCC"}},8217:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png 300w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.ac16a73.600.png 600w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.80f3eb1.634.png 634w",images:[{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png",width:300,height:21},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.ac16a73.600.png",width:600,height:43},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.80f3eb1.634.png",width:634,height:45}],src:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png",toString:function(){return i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png"},placeholder:void 0,width:300,height:21},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAIAAABol6gpAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAHklEQVR4nGP4+vXrly9fPsPAz58/ISLfvn379OkTALwKHKViCz9TAAAAAElFTkSuQmCC"}},9362:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png 300w,"+i.p+"assets/images/ideal-img/ttn-downlink.6f8f05b.600.png 600w,"+i.p+"assets/images/ideal-img/ttn-downlink.7f4d85d.900.png 900w,"+i.p+"assets/images/ideal-img/ttn-downlink.307b73d.1081.png 1081w",images:[{path:i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png",width:300,height:103},{path:i.p+"assets/images/ideal-img/ttn-downlink.6f8f05b.600.png",width:600,height:205},{path:i.p+"assets/images/ideal-img/ttn-downlink.7f4d85d.900.png",width:900,height:308},{path:i.p+"assets/images/ideal-img/ttn-downlink.307b73d.1081.png",width:1081,height:370}],src:i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png",toString:function(){return i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png"},placeholder:void 0,width:300,height:103},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAADCAYAAACqPZ51AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAS0lEQVR4nEXLUQqAMAwD0N3/lB5AUBHWpNsaaUEtPPKRtO3nJZCKiDLnFEmttT7urtZ7ryIHY4zK9F4+O6kGUAbIzAoMAn7ZbfehB1MfdZx0etnTAAAAAElFTkSuQmCC"}},587:(e,n,i)=>{"use strict";i.r(n),i.d(n,{assets:()=>d,contentTitle:()=>o,default:()=>h,frontMatter:()=>s,metadata:()=>r,toc:()=>l});var t=i(4848),a=i(8453);const s={sidebar_position:4},o="LoRaWAN Downlink Config",r={id:"configuration/lorawan-downlink-config",title:"LoRaWAN Downlink Config",description:"This article describes the technical details how to remotely configure Lobaro devices that are using LoRaWAN as",source:"@site/docs/configuration/lorawan-downlink-config.md",sourceDirName:"configuration",slug:"/configuration/lorawan-downlink-config",permalink:"/iot/configuration/lorawan-downlink-config",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/lorawan-downlink-config.md",tags:[],version:"current",sidebarPosition:4,frontMatter:{sidebar_position:4},sidebar:"configurationSidebar",previous:{title:"CRON Configuration",permalink:"/iot/configuration/cron-configuration"}},d={},l=[{value:"Protocol Description",id:"protocol-description",level:2},{value:"Downlink Commands (Port 128)",id:"downlink-commands-port-128",level:3},{value:"?",id:"",level:4},{value:"g<name>",id:"gname",level:4},{value:"r<name> / r*",id:"rname--r",level:4},{value:"s<name>=<value>",id:"snamevalue",level:4},{value:"a<name>=<value>",id:"anamevalue",level:4},{value:"b",id:"b",level:4},{value:"w or wFORCE",id:"w-or-wforce",level:4},{value:"Examples",id:"examples",level:2},{value:"Changing device configuration",id:"changing-device-configuration",level:3},{value:"Downlink on TTN",id:"downlink-on-ttn",level:4},{value:"Getting the firmware version",id:"getting-the-firmware-version",level:3},{value:"Downlink on TTN",id:"downlink-on-ttn-1",level:4},{value:"Uplink on TTN",id:"uplink-on-ttn",level:4},{value:"Configure a device via script",id:"configure-a-device-via-script",level:3},{value:"Example configuration command to be send",id:"example-configuration-command-to-be-send",level:4},{value:"Curl Script for TTN",id:"curl-script-for-ttn",level:4},{value:"Chirpstack V3",id:"chirpstack-v3",level:4},{value:"Chirpstack V4",id:"chirpstack-v4",level:4}];function c(e){const n={a:"a",admonition:"admonition",br:"br",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,a.R)(),...e.components},{Image:s}=n;return s||function(e,n){throw new Error("Expected "+(n?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"lorawan-downlink-config",children:"LoRaWAN Downlink Config"}),"\n",(0,t.jsxs)(n.p,{children:["This article describes the technical details how to remotely configure Lobaro devices that are using ",(0,t.jsx)(n.strong,{children:"LoRaWAN"})," as\nupload technology."]}),"\n",(0,t.jsx)(n.p,{children:"IoT devices are often installed at places that are difficult to reach. If you need to change the settings of such a\ndevice it is often not easily possible to get physical access to attach a config adapter."}),"\n",(0,t.jsx)(n.p,{children:"Many of our devices support LoRaWAN remote configuration that allows you to change the configuration of the device by\nsending downlink messages."}),"\n",(0,t.jsx)(n.admonition,{type:"note",children:(0,t.jsx)(n.p,{children:"If you are using cellular IoT (NB-IoT, LTE-M) as communication technology any configuration updates are done in a\ndifferent way."})}),"\n",(0,t.jsx)(n.h2,{id:"protocol-description",children:"Protocol Description"}),"\n",(0,t.jsxs)(n.p,{children:["Lobaro LoRaWAN devices receive remote configuration commands as Downlinks on port 128. Responses to those commands will\nbe sent as Uplinks on ",(0,t.jsx)(n.code,{children:"Port 128"})," (and 129-131 for long responses). ",(0,t.jsx)(n.strong,{children:"The remote commands and their responses are all\nencoded in ASCII"}),", to make it easier for humans to use them. The ASCII string must be converted to hex or Base64\npayload bytes, depending on the used LoRaWAN network server."]}),"\n",(0,t.jsxs)(n.p,{children:["The first byte of a Downlink message on ",(0,t.jsx)(n.code,{children:"Port 128"})," contains a single character that identifies the command you want to\nsend. Some commands take a parameter following the command char."]}),"\n",(0,t.jsx)(n.p,{children:"The responses to a command start with the same character as the command followed by an optional parameter. If a command\nis unknown, or it fails for some reason, an error response is sent via Uplink that contains with a ! followed by a\nreadable error message."}),"\n",(0,t.jsx)(n.p,{children:"Changing configuration does nothing until you save the changes and reboot the device. The device has a safety feature\nthat prevents configurations that make the device unusable. A new configuration is tested in the first run after\nrebooting. Only after the device reaches a stable state will the configuration be adopted and used permanently. If a\nproblem occurs the device will restore its last stable connection and reboot. If the device uses OTAA (which we\nrecommend) the device will only adopt the new configuration only after a join request is accepted, to make sure the\nLoRaWAN parameters are correct. After a few failed attempts it will restore the previous configuration. This can take up\nto about 10 minutes."}),"\n",(0,t.jsx)(n.admonition,{type:"info",children:(0,t.jsx)(n.p,{children:"Downlinks should only be used to a limited extent depending on the infrastructure. In the free version of TTN, the Fair\nuse policy says, that no more than 10 downlinks should be made. You also have to observe the regulations within the\nLimit of the duty cycle limitation. That is why downlinks are only to be carried out with caution and when absolutely\nnecessary. The number of possible characters that can be sent is limited by the respective spreading factor (With a SF\nof 12 only 51 characters)."})}),"\n",(0,t.jsx)(n.h3,{id:"downlink-commands-port-128",children:"Downlink Commands (Port 128)"}),"\n",(0,t.jsxs)(n.p,{children:["Configurations are normally communicated as downlinks and uplinks (responses) on ",(0,t.jsx)(n.code,{children:"Port 128"}),". For longer responses, that\ndon't can be send as single uplink on ",(0,t.jsx)(n.code,{children:"Port 128"}),", the ",(0,t.jsx)(n.code,{children:"Ports 129-131"})," are used. The first response part is sent\non ",(0,t.jsx)(n.code,{children:"Port 129"}),", the middle parts (if exist) on ",(0,t.jsx)(n.code,{children:"Port 130"})," and the last part on ",(0,t.jsx)(n.code,{children:"Port 131"}),". A stateful parser can\nconcatenate long responses based on Port and FCnt."]}),"\n",(0,t.jsxs)(n.table,{children:[(0,t.jsx)(n.thead,{children:(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.th,{children:"Char"}),(0,t.jsx)(n.th,{children:"Command"}),(0,t.jsx)(n.th,{children:"Parameter"}),(0,t.jsx)(n.th,{children:"HEX"}),(0,t.jsx)(n.th,{children:"Info"})]})}),(0,t.jsxs)(n.tbody,{children:[(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"?"}),(0,t.jsx)(n.td,{children:"Request firmware and version"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"None "})}),(0,t.jsx)(n.td,{children:"3F"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"a"}),(0,t.jsx)(n.td,{children:"Append to config parameter val"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"= "})}),(0,t.jsx)(n.td,{children:"61"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"b"}),(0,t.jsx)(n.td,{children:"Reboot device without saving"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"None "})}),(0,t.jsx)(n.td,{children:"62"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"g"}),(0,t.jsx)(n.td,{children:"Get config parameter value"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"Name of parameter"})}),(0,t.jsx)(n.td,{children:"67"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"r"}),(0,t.jsx)(n.td,{children:"Reset config parameter value"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"Name of parameter"})}),(0,t.jsx)(n.td,{children:"72"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"s"}),(0,t.jsx)(n.td,{children:"Set config parameter value"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"= "})}),(0,t.jsx)(n.td,{children:"73"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"S"}),(0,t.jsx)(n.td,{children:"Set config parameter value & Save and reboot"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"= "})}),(0,t.jsx)(n.td,{children:"53"}),(0,t.jsx)(n.td,{children:"Not supported on all devices"})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"w"}),(0,t.jsx)(n.td,{children:"Save config and reboot device"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"None "})}),(0,t.jsx)(n.td,{children:"77"}),(0,t.jsx)(n.td,{})]})]})]}),"\n",(0,t.jsx)(n.admonition,{type:"warning",children:(0,t.jsx)(n.p,{children:"Depending on the firmware version not all commands might be supported on all devices.\nPlease refer to the manual of your product for more details."})}),"\n",(0,t.jsx)(n.h4,{id:"",children:(0,t.jsx)(n.code,{children:"?"})}),"\n",(0,t.jsx)(n.p,{children:"Request firmware and version. This command triggers the device to send what firmware it is running and in which version.\nThis can be used to test if the remote configuration is working."}),"\n",(0,t.jsx)(n.h4,{id:"gname",children:(0,t.jsx)(n.code,{children:"g"})}),"\n",(0,t.jsxs)(n.p,{children:["Get the value of the config parameter ",(0,t.jsx)(n.code,{children:""}),". This command makes the device sent a response\ncontaining ",(0,t.jsx)(n.code,{children:"="})," as\nparameter giving you the current value of a configuration parameter."]}),"\n",(0,t.jsx)(n.h4,{id:"rname--r",children:(0,t.jsx)(n.code,{children:"r / r*"})}),"\n",(0,t.jsxs)(n.p,{children:["Reset config parameter ",(0,t.jsx)(n.code,{children:""})," to its default value. As a confirmation the device sends a response\ncontaining ",(0,t.jsx)(n.code,{children:"="}),", reporting the new value of the parameter.Sending the special value * will reset all config\nparameters."]}),"\n",(0,t.jsx)(n.h4,{id:"snamevalue",children:(0,t.jsx)(n.code,{children:"s="})}),"\n",(0,t.jsxs)(n.p,{children:["Set config parameter ",(0,t.jsx)(n.code,{children:""})," to ",(0,t.jsx)(n.code,{children:""}),". Sets the parameter to the value given in the parameter. As a confirmation it\nsends a response containing ",(0,t.jsx)(n.code,{children:"="}),", reporting the new value of the parameter."]}),"\n",(0,t.jsx)(n.h4,{id:"anamevalue",children:(0,t.jsx)(n.code,{children:"a="})}),"\n",(0,t.jsxs)(n.p,{children:["Append ",(0,t.jsx)(n.code,{children:""})," to the config parameter ",(0,t.jsx)(n.code,{children:""}),". This command appends the value given to the current value of the\nparameter. This is intended to allow setting values that are too long for a single Downlink message. As a confirmation\nit sends the length of the config parameter's value after the appending. Append works for config parameters of type\nstring."]}),"\n",(0,t.jsx)(n.h4,{id:"b",children:(0,t.jsx)(n.code,{children:"b"})}),"\n",(0,t.jsx)(n.p,{children:"Reboot device without saving. This command restarts the device. Any changes too the config that have been committed\nbefore will be lost! This command does not send a Response."}),"\n",(0,t.jsx)(n.h4,{id:"w-or-wforce",children:(0,t.jsx)(n.code,{children:"w or wFORCE"})}),"\n",(0,t.jsx)(n.p,{children:"Save config and reboot device. This command saves all configuration changes to a temporarily configuration and restarts\nthe device. Only if the device boots successfully and reaches normal operation mode is the new configuration made\npermanent. If any fatal configuration error occurs or if the LoRaWAN OTAA Join does not succeed, the previous\nconfiguration will be restored and the device restarted again. This command does not send a Response.If you add the\nspecial argument FORCE to the command, the configuration will be made permanent without testing the configuration."}),"\n",(0,t.jsxs)(n.admonition,{type:"danger",children:[(0,t.jsxs)(n.p,{children:["Using ",(0,t.jsx)(n.strong,{children:"wFORCE"})," can leave your device useless and unreachable!"]}),(0,t.jsxs)(n.p,{children:["Do not use ",(0,t.jsx)(n.strong,{children:"wFORCE"})," unless you have a very good reason. If the device is set to an invalid configuration it will no\nlonger\nbe reachable by the Network Server. From such a state it can only be recovered with physical access and a config\nadapter. It will also most likely drain the battery quickly."]})]}),"\n",(0,t.jsxs)(n.admonition,{type:"warning",children:[(0,t.jsxs)(n.p,{children:["For commands ",(0,t.jsx)(n.code,{children:"s"}),", ",(0,t.jsx)(n.code,{children:"S"})," and ",(0,t.jsx)(n.code,{children:"a"})," make sure the number of characters to send matches with the possibilities your devices\nspreading factor:"]}),(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"SF 7 = 242 bytes max. LoRaWAN downlink payload"}),"\n",(0,t.jsx)(n.li,{children:"SF 12 = 51 bytes max. LoRaWAN downlink payload"}),"\n"]}),(0,t.jsx)(n.p,{children:"Consider splitting bigger configuration changed in multiple smaller downlinks."})]}),"\n",(0,t.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,t.jsx)(n.h3,{id:"changing-device-configuration",children:"Changing device configuration"}),"\n",(0,t.jsx)(n.p,{children:"The following is a short example of how you can update two configuration values remotely (that includes rebooting the\ndevice)."}),"\n",(0,t.jsx)(n.p,{children:"Most LoRaWAN devices (all that are running in Class A, which are by fast the most) can only be reached when they contact\nthe network. Network Servers (like The Things Network) provide a mechanism to enqueue messages for a specific device.\nThe messages will be sent as downlink the next time that device contacts the network. Normally, multiple messages can be\nenqueued and will all be transmitted as soon as possible. Please be advised that the gateways communicating with your\ndevice must respect their duty cycle, so there is a very limited amount of downlinks that can be sent for a given time (\ndownlinks are expensive)."}),"\n",(0,t.jsx)(n.p,{children:"For this example we want to set Time Synchronization to sync the internal clock every 10 days, and we want to deactivate\nAdaptive Date Rate (ADR). These are both LoRaWAN configuration parameters that are present on most devices (find details\nunder LoRaWAN Configuration), but you can of course also change parameters specific to your device, e.g. Modbus\nconfiguration or wMBus configuration, with this feature."}),"\n",(0,t.jsx)(n.p,{children:"We will need to send three commands:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"s"}),"TimeSync=10","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"set time synchronization to 10 day interval"}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"s"}),"ADR=false","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"disable adaptive data rate"}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"w"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"write changes to device configuration and reboot"}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["The actual s-commands will of course differ for your case, but the w command at the end ",(0,t.jsx)(n.strong,{children:"must"})," always be the same."]}),"\n",(0,t.jsx)(n.p,{children:"After sending the final command, the device will reboot and try the new configuration. If the boot process and the\nconnection to the network are successful, the device will make the changes permanent. If there is a problem (if you\naccidentally set an invalid value, e.g. sADR=flase or if you changed your AppKey to wrong value and your OTAA fails),\nthe device will revert to the previous configuration."}),"\n",(0,t.jsx)(n.h4,{id:"downlink-on-ttn",children:"Downlink on TTN"}),"\n",(0,t.jsx)(n.p,{children:"How you sent your downlinks depends on the LoRaWAN Network Server you use to connect your devices. You will most likely\nneed to convert the commands (that are all ASCII) to some different representation, e.g. Hex or Base64."}),"\n",(0,t.jsx)(n.p,{children:'In The Things Network you find the downlink panel on the "Device Overview" page for each device, directly below the\npanel that shows you OTAA/ABP information (DevEUI, AppKey, ...). It is shown in the following screenshot.'}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN downlink configuration",img:i(9362),style:{width:"60%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsxs)(n.p,{children:["You will have to encode the commands in hex. In the screenshot you see ",(0,t.jsx)(n.code,{children:"73 54 69 6d 65 53 79 6e 63 3d 31 30"})," as the\nmessage to send; that is the hex representation of ",(0,t.jsx)(n.code,{children:"sTimeSync=10"}),". The Port used for remote configuration for our\ndevices\nis 128. When you enter multiple messages to send, be sure to set the correct scheduling (last). The preselected replace\nwill overwrite your previously enqueued messages."]}),"\n",(0,t.jsx)(n.h3,{id:"getting-the-firmware-version",children:"Getting the firmware version"}),"\n",(0,t.jsxs)(n.p,{children:['For this example the "Request firmware and version" ',(0,t.jsx)(n.code,{children:"?"})," (0x3F) command has to used. We use TTN as network server."]}),"\n",(0,t.jsx)(n.h4,{id:"downlink-on-ttn-1",children:"Downlink on TTN"}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN downlink get firmware version",img:i(5607),style:{width:"50%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(n.p,{children:"Will result in:"}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN downlink get firmware version",img:i(8217),style:{width:"50%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(n.h4,{id:"uplink-on-ttn",children:"Uplink on TTN"}),"\n",(0,t.jsx)(n.p,{children:"The device answers with this uplink:"}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN uplink get firmware version",img:i(2627),style:{width:"95%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsxs)(n.p,{children:["This response can be converted to ASCII again, e.g. using\nany ",(0,t.jsx)(n.a,{href:"https://www.rapidtables.com/convert/number/hex-to-ascii.html",children:"online converter"}),":"]}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN uplink to ascii conversion get firmware version",img:i(5134),style:{width:"30%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsxs)(n.p,{children:["The result is: ",(0,t.jsx)(n.code,{children:"?app-hybrid-modbus v0.4.0+battery"})]}),"\n",(0,t.jsx)(n.h3,{id:"configure-a-device-via-script",children:"Configure a device via script"}),"\n",(0,t.jsx)(n.h4,{id:"example-configuration-command-to-be-send",children:"Example configuration command to be send"}),"\n",(0,t.jsxs)(n.p,{children:["Example command (ASCII encoding):",(0,t.jsx)(n.br,{}),"\n",(0,t.jsx)(n.code,{children:"SMbCmd=0 0/10 * * * *:R,9600,8N1:010300160002,010300260002,fa0400050001"})]}),"\n",(0,t.jsxs)(n.admonition,{type:"warning",children:[(0,t.jsxs)(n.p,{children:["For commands ",(0,t.jsx)(n.code,{children:"s"}),", ",(0,t.jsx)(n.code,{children:"S"})," and ",(0,t.jsx)(n.code,{children:"a"})," make sure the number of characters to send matches with the possibilities your devices\nspreading factor:"]}),(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"SF 7 = 242 bytes max. LoRaWAN downlink payload"}),"\n",(0,t.jsx)(n.li,{children:"SF 12 = 51 bytes max. LoRaWAN downlink payload"}),"\n"]}),(0,t.jsx)(n.p,{children:"Consider splitting bigger configuration changed in multiple smaller downlinks."})]}),"\n",(0,t.jsxs)(n.p,{children:["Example command (Base64 encoding):",(0,t.jsx)(n.br,{}),"\n",(0,t.jsx)(n.code,{children:"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE="})]}),"\n",(0,t.jsx)(n.h4,{id:"curl-script-for-ttn",children:"Curl Script for TTN"}),"\n",(0,t.jsx)(n.p,{children:"Curl script to be used with TTN:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-shell",children:"curl --location \\ --header 'Authorization: Bearer NNSXS.XJAZK3VF3YBMXX_API_KEY_KR2HFG6ABXXXXXX.CP4WZUOXXXXXXXB5WW4UUSMNXRLUJ7LVO2U' \\\n--header 'Content-Type: application/json' \\\n--header 'User-Agent: my-integration/my-integration-version' \\\n--request POST \\ --data '{\"downlinks\":[{ \"frm_payload\":\n\"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE=\",\n\"f_port\":128 }] }' \\\n'https://eu1.cloud.thethings.network/api/v3/as/applications/your-ttn-applicationID/devices/eui-your_TTN_end_deviceID/down/push'\n"})}),"\n",(0,t.jsxs)(n.p,{children:["See also: ",(0,t.jsx)(n.a,{href:"https://www.thethingsindustries.com/docs/integrations/webhooks/scheduling-downlinks/",children:"https://www.thethingsindustries.com/docs/integrations/webhooks/scheduling-downlinks/"})]}),"\n",(0,t.jsx)(n.admonition,{type:"tip",children:(0,t.jsx)(n.p,{children:"You should use your own data for the API KEY, your-ttn-applicationID and your your_TTN_end_deviceID"})}),"\n",(0,t.jsx)(n.h4,{id:"chirpstack-v3",children:"Chirpstack V3"}),"\n",(0,t.jsx)(n.p,{children:"Curl script to be used with Chirpstack V3:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-shell",children:"curl -X POST --header 'Content-Type: application/json'\n--header 'Accept: application/json'\n--header 'Grpc-Metadata-Authorization:\nBearer xxxxxxxxx_API_KEY_xxxxxxx' -d\n'{ \"deviceQueueItem\": { \"confirmed\": false, \"data\":\n\"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE=\",\n\"fPort\": 128\n } }'\n'http://192.198.0.101:8080/api/devices/ChirpStack_DevEUI/queue'\n"})}),"\n",(0,t.jsx)(n.admonition,{type:"tip",children:(0,t.jsx)(n.p,{children:"You should use your own data for the API KEY, your Chirpstack_IP_Adress and your your_ChirpStack_DevEUI"})}),"\n",(0,t.jsx)(n.h4,{id:"chirpstack-v4",children:"Chirpstack V4"}),"\n",(0,t.jsx)(n.p,{children:'The actual API has now switched from the Swagger API with UI to gRPC integration, but for compatibility and transition\nreasons the chirpstack-rest-api can be installed as an additional component. However, experience has shown that there\nare changes that need to be considered. "deviceQueueItem" became ""queueItem" and by default the API can now be reached\non port 8090 and no longer 8080.'}),"\n",(0,t.jsx)(n.p,{children:"Curl script to be used with Chirpstack V4:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-shell",children:"curl -X POST --header 'Content-Type: application/json'\n--header 'Accept: application/json'\n--header 'Grpc-Metadata-Authorization:\nBearer xxxxxxxxx_API_KEY_xxxxxxx' -d\n'{ \"queueItem\": { \"confirmed\": false, \"data\":\n\"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE=\",\n\"fPort\": 128\n } }'\n'http://192.198.0.101:8090/api/devices/ChirpStack_DevEUI/queue'\n"})})]})}function h(e={}){const{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},8453:(e,n,i)=>{"use strict";i.d(n,{R:()=>o,x:()=>r});var t=i(6540);const a={},s=t.createContext(a);function o(e){const n=t.useContext(s);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:o(e.components),t.createElement(s.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/a5b914f3.5622e817.js b/assets/js/a5b914f3.5622e817.js new file mode 100644 index 00000000..bfa69174 --- /dev/null +++ b/assets/js/a5b914f3.5622e817.js @@ -0,0 +1 @@ +(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[7244],{8754:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg 300w,"+i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.7d4f4c8.600.jpg 600w,"+i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.baf7698.800.jpg 800w",images:[{path:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg",width:300,height:300},{path:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.7d4f4c8.600.jpg",width:600,height:600},{path:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.baf7698.800.jpg",width:800,height:800}],src:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg",toString:function(){return i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg"},placeholder:void 0,width:300,height:300},preSrc:"data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAKAAoDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAABAYH/8QAIBAAAgEEAQUAAAAAAAAAAAAAAQIDAAQFESESFDFCUf/EABQBAQAAAAAAAAAAAAAAAAAAAAH/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwDcs2mSGQyLxQX/AHiuJba6VtQRQqqkrrq5JIcEFdkt8AIs7aRpraKVlKM6Bip9SR4omWRJHskkVXU3A2GGweCafSH/2Q=="}},4847:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg 300w,"+i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.dac8c66.600.jpg 600w,"+i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0b8f4f0.900.jpg 900w,"+i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.164d51e.1200.jpg 1200w",images:[{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg",width:300,height:35},{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.dac8c66.600.jpg",width:600,height:70},{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0b8f4f0.900.jpg",width:900,height:105},{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.164d51e.1200.jpg",width:1200,height:140}],src:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg",toString:function(){return i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg"},placeholder:void 0,width:300,height:35},preSrc:"data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAoDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAAAAQH/8QAHRAAAQIHAAAAAAAAAAAAAAAAAAECBgcyNnFysv/EABQBAQAAAAAAAAAAAAAAAAAAAAH/xAAWEQEBAQAAAAAAAAAAAAAAAAAAAUH/2gAMAwEAAhEDEQA/AJ5v3DEWicNM5fW7IA3BH//Z"}},7189:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg 300w,"+i.p+"assets/images/ideal-img/adapter1low.9350fd9.469.jpg 469w",images:[{path:i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg",width:300,height:253},{path:i.p+"assets/images/ideal-img/adapter1low.9350fd9.469.jpg",width:469,height:395}],src:i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg",toString:function(){return i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg"},placeholder:void 0,width:300,height:253},preSrc:"data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAIAAoDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAf/xAAhEAACAQMDBQAAAAAAAAAAAAABAgUAAwQGERQSEzFBwf/EABUBAQEAAAAAAAAAAAAAAAAAAAAC/8QAFxEBAQEBAAAAAAAAAAAAAAAAAQACEf/aAAwDAQACEQMRAD8Ar+LES+oJuUlcaS42LynxBjtuens3GQuCD5O2/wAqkW1K21VmLEAAk+6UpykyCt//2Q=="}},6581:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png 300w,"+i.p+"assets/images/ideal-img/config-adapter-schematic.0152809.600.png 600w,"+i.p+"assets/images/ideal-img/config-adapter-schematic.58af7f3.900.png 900w,"+i.p+"assets/images/ideal-img/config-adapter-schematic.e65cd5e.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png",width:300,height:113},{path:i.p+"assets/images/ideal-img/config-adapter-schematic.0152809.600.png",width:600,height:225},{path:i.p+"assets/images/ideal-img/config-adapter-schematic.58af7f3.900.png",width:900,height:338},{path:i.p+"assets/images/ideal-img/config-adapter-schematic.e65cd5e.1200.png",width:1200,height:450}],src:i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png",toString:function(){return i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png"},placeholder:void 0,width:300,height:113},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAECAYAAAC3OK7NAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAdklEQVR4nDWNSwoCMRAFc/9jufQQggyioCTOdD7dk6RLHPEtiqI2LwCMObDeWdOCbHf6mDh+9P/CF85kVyPnSN5u2L4j7wW1zCoJrU9C7x3VSkwRkQsiJ6o1HtczrcTDsyRCKwXVRtWG6UazF+6ONWGO37U7fADQ+5tBzCyAbwAAAABJRU5ErkJggg=="}},2608:(e,o,i)=>{"use strict";i.r(o),i.d(o,{assets:()=>A,contentTitle:()=>r,default:()=>c,frontMatter:()=>n,metadata:()=>s,toc:()=>d});var t=i(4848),a=i(8453);const n={sidebar_position:1},r="Lobaro USB Config Adapter",s={id:"configuration/usb-config-adapter",title:"Lobaro USB Config Adapter",description:"The Lobaro USB configuration adapters connects the configuration serial uart of our devices to a PC. It is used for:",source:"@site/docs/configuration/usb-config-adapter.md",sourceDirName:"configuration",slug:"/configuration/usb-config-adapter",permalink:"/iot/configuration/usb-config-adapter",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/usb-config-adapter.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"configurationSidebar",previous:{title:"Introduction",permalink:"/iot/configuration/"},next:{title:"Lobaro Config Tool",permalink:"/iot/configuration/lobaro-tool/"}},A={},d=[{value:"Adapter V1",id:"adapter-v1",level:2},{value:"Order-Code",id:"order-code",level:3},{value:"Installation",id:"installation",level:3},{value:"Physical connection",id:"physical-connection",level:3},{value:"Schematic",id:"schematic",level:3},{value:"Connector Type",id:"connector-type",level:3},{value:"Control Lines",id:"control-lines",level:3},{value:"DTR control line",id:"dtr-control-line",level:4},{value:"RTS control line",id:"rts-control-line",level:4},{value:"Adapter V2",id:"adapter-v2",level:2}];function g(e){const o={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",strong:"strong",ul:"ul",...(0,a.R)(),...e.components},{Image:n}=o;return n||function(e,o){throw new Error("Expected "+(o?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(o.h1,{id:"lobaro-usb-config-adapter",children:"Lobaro USB Config Adapter"}),"\n",(0,t.jsx)(o.p,{children:"The Lobaro USB configuration adapters connects the configuration serial uart of our devices to a PC. It is used for:"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"Sensor initial configuration, e.g. network parameters like LTE APN point"}),"\n",(0,t.jsx)(o.li,{children:"Viewing firmware log/debug diagnostic output"}),"\n",(0,t.jsx)(o.li,{children:"Firmware updates"}),"\n",(0,t.jsx)(o.li,{children:"Powering some of our devices (Boot and Reset must be disconnected to use as USB power supply)"}),"\n",(0,t.jsxs)(o.li,{children:["using our free ",(0,t.jsx)(o.a,{href:"/iot/configuration/lobaro-tool/",children:"Lobaro Maintenance Tool"})," PC software."]}),"\n"]}),"\n",(0,t.jsx)(o.h2,{id:"adapter-v1",children:"Adapter V1"}),"\n",(0,t.jsx)(n,{alt:"Lobaro USB Configuration Adapter V1",img:i(8754),style:{width:"30%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(o.h3,{id:"order-code",children:"Order-Code"}),"\n",(0,t.jsxs)(o.p,{children:["The configuration adapter including a 1 m USB cable can be ordered using its article number: ",(0,t.jsx)(o.code,{children:"#8000005"}),"."]}),"\n",(0,t.jsx)(o.h3,{id:"installation",children:"Installation"}),"\n",(0,t.jsxs)(o.p,{children:["The CP2102 uart serial USB driver ",(0,t.jsx)(o.strong,{children:"must"})," be installed, it can be\ndownloaded at\nthe ",(0,t.jsx)(o.a,{href:"https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads",children:"Silicon Labs Homepage"}),"."]}),"\n",(0,t.jsx)(o.admonition,{title:"Download",type:"tip",children:(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"CP210x_Universal_Windows_Driver.zip for Windows 11+"}),"\n",(0,t.jsx)(o.li,{children:"CP210x Windows Drivers v6.7.6 for Windows 10 and earlier"}),"\n"]})}),"\n",(0,t.jsx)(o.h3,{id:"physical-connection",children:"Physical connection"}),"\n",(0,t.jsx)(n,{alt:"Connection example lobaro usb configuration adaptr",img:i(7189),style:{width:"40%",paddingTop:"10px",paddingBottom:"20px"}}),"\n",(0,t.jsx)(o.p,{children:"Connect your Lobaro Device to the USB-port of your computer using the Lobaro Config Adapter. The 6-pin connector must be\nplugged into the white rectangular socket on the device that is labeled with the word CONFIG. The location of the socket\nis dependent on the specific device and hardware version you are trying to attach. See the hardware specific product\ndescription for the individual connector location."}),"\n",(0,t.jsx)(o.admonition,{title:"Device power supply over USB",type:"note",children:(0,t.jsx)(o.p,{children:"Some devices can be powered by the 3.3V the config adapter can provide out of the USB Port. Other devices, mostly the\nNB-IoT/LTE-M enabled cellular IoT boards or the need their normal power supply connected as well. If in doubt, just make\nsure you have the device powered!"})}),"\n",(0,t.jsx)(o.h3,{id:"schematic",children:"Schematic"}),"\n",(0,t.jsx)(n,{alt:"Schematic Lobaro USB Configuration Adapter V1",img:i(6581),style:{width:"100%",paddingTop:"10px",paddingBottom:"20px"}}),"\n",(0,t.jsx)(o.h3,{id:"connector-type",children:"Connector Type"}),"\n",(0,t.jsxs)(o.p,{children:["The USB adapter uses a six-wire ",(0,t.jsx)(o.a,{href:"https://www.jst-mfg.com/product/index.php?series=287",children:"JST-ZH series connector"})," for\nattaching to Lobaro hardware at the config connector."]}),"\n",(0,t.jsx)(n,{alt:"Lobaro USB Configuration Adapter V1",img:i(4847),style:{width:"90%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(o.h3,{id:"control-lines",children:"Control Lines"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"Boot0 of Lobaro sensors is connected to DTR line of the PC uart"}),"\n",(0,t.jsx)(o.li,{children:"Reset (active low) of Lobaro sensors is connected to RTS line of the PC uart"}),"\n"]}),"\n",(0,t.jsx)(o.admonition,{type:"info",children:(0,t.jsx)(o.p,{children:"Normally the handling of these uart control lines is done automatically by the Lobaro PC tool. When using an alternative\nuart terminal tool make sure you setup the RTS and DTR lines correctly or simply cut the DTR/RTS wires from\nthe USB adapter if the reset and/or bootloader control lines are not needed and you simply want to look at the devices\nlog output."})}),"\n",(0,t.jsx)(o.h4,{id:"dtr-control-line",children:"DTR control line"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"Low / true => Run Firmware after Reset (Default since BOOT0 has internal pull-down)"}),"\n",(0,t.jsx)(o.li,{children:"High / false => Run Bootloader after Reset"}),"\n"]}),"\n",(0,t.jsx)(o.h4,{id:"rts-control-line",children:"RTS control line"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"High / false => Run Firmware / Bootloader (Default since RESET has internal pull-up)"}),"\n",(0,t.jsx)(o.li,{children:"Low / true => Chip in RESET mode (not running)"}),"\n"]}),"\n",(0,t.jsx)(o.h2,{id:"adapter-v2",children:"Adapter V2"}),"\n",(0,t.jsx)(o.admonition,{type:"note",children:(0,t.jsx)(o.p,{children:"The usb adapter in version 2 will be available latest end of 2024."})})]})}function c(e={}){const{wrapper:o}={...(0,a.R)(),...e.components};return o?(0,t.jsx)(o,{...e,children:(0,t.jsx)(g,{...e})}):g(e)}},8453:(e,o,i)=>{"use strict";i.d(o,{R:()=>r,x:()=>s});var t=i(6540);const a={},n=t.createContext(a);function r(e){const o=t.useContext(n);return t.useMemo((function(){return"function"==typeof e?e(o):{...o,...e}}),[o,e])}function s(e){let o;return o=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:r(e.components),t.createElement(n.Provider,{value:o},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/a5b914f3.e7788a87.js b/assets/js/a5b914f3.e7788a87.js deleted file mode 100644 index c7b34e82..00000000 --- a/assets/js/a5b914f3.e7788a87.js +++ /dev/null @@ -1 +0,0 @@ -(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[7244],{8754:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg 300w,"+i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.7d4f4c8.600.jpg 600w,"+i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.baf7698.800.jpg 800w",images:[{path:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg",width:300,height:300},{path:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.7d4f4c8.600.jpg",width:600,height:600},{path:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.baf7698.800.jpg",width:800,height:800}],src:i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg",toString:function(){return i.p+"assets/images/ideal-img/8000005_Lobaro_Configuration Adapter.0d17aeb.300.jpg"},placeholder:void 0,width:300,height:300},preSrc:"data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAKAAoDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAABAYH/8QAIBAAAgEEAQUAAAAAAAAAAAAAAQIDAAQFESESFDFCUf/EABQBAQAAAAAAAAAAAAAAAAAAAAH/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwDcs2mSGQyLxQX/AHiuJba6VtQRQqqkrrq5JIcEFdkt8AIs7aRpraKVlKM6Bip9SR4omWRJHskkVXU3A2GGweCafSH/2Q=="}},4847:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg 300w,"+i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.dac8c66.600.jpg 600w,"+i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0b8f4f0.900.jpg 900w,"+i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.164d51e.1200.jpg 1200w",images:[{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg",width:300,height:35},{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.dac8c66.600.jpg",width:600,height:70},{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0b8f4f0.900.jpg",width:900,height:105},{path:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.164d51e.1200.jpg",width:1200,height:140}],src:i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg",toString:function(){return i.p+"assets/images/ideal-img/Lobaro-KonfigAdapter-Anot.0380da5.300.jpg"},placeholder:void 0,width:300,height:35},preSrc:"data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAoDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAAAAQH/8QAHRAAAQIHAAAAAAAAAAAAAAAAAAECBgcyNnFysv/EABQBAQAAAAAAAAAAAAAAAAAAAAH/xAAWEQEBAQAAAAAAAAAAAAAAAAAAAUH/2gAMAwEAAhEDEQA/AJ5v3DEWicNM5fW7IA3BH//Z"}},7189:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg 300w,"+i.p+"assets/images/ideal-img/adapter1low.9350fd9.469.jpg 469w",images:[{path:i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg",width:300,height:253},{path:i.p+"assets/images/ideal-img/adapter1low.9350fd9.469.jpg",width:469,height:395}],src:i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg",toString:function(){return i.p+"assets/images/ideal-img/adapter1low.f34a141.300.jpg"},placeholder:void 0,width:300,height:253},preSrc:"data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAIAAoDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAf/xAAhEAACAQMDBQAAAAAAAAAAAAABAgUAAwQGERQSEzFBwf/EABUBAQEAAAAAAAAAAAAAAAAAAAAC/8QAFxEBAQEBAAAAAAAAAAAAAAAAAQACEf/aAAwDAQACEQMRAD8Ar+LES+oJuUlcaS42LynxBjtuens3GQuCD5O2/wAqkW1K21VmLEAAk+6UpykyCt//2Q=="}},6581:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png 300w,"+i.p+"assets/images/ideal-img/config-adapter-schematic.0152809.600.png 600w,"+i.p+"assets/images/ideal-img/config-adapter-schematic.58af7f3.900.png 900w,"+i.p+"assets/images/ideal-img/config-adapter-schematic.e65cd5e.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png",width:300,height:113},{path:i.p+"assets/images/ideal-img/config-adapter-schematic.0152809.600.png",width:600,height:225},{path:i.p+"assets/images/ideal-img/config-adapter-schematic.58af7f3.900.png",width:900,height:338},{path:i.p+"assets/images/ideal-img/config-adapter-schematic.e65cd5e.1200.png",width:1200,height:450}],src:i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png",toString:function(){return i.p+"assets/images/ideal-img/config-adapter-schematic.413f5f7.300.png"},placeholder:void 0,width:300,height:113},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAECAYAAAC3OK7NAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAdklEQVR4nDWNSwoCMRAFc/9jufQQggyioCTOdD7dk6RLHPEtiqI2LwCMObDeWdOCbHf6mDh+9P/CF85kVyPnSN5u2L4j7wW1zCoJrU9C7x3VSkwRkQsiJ6o1HtczrcTDsyRCKwXVRtWG6UazF+6ONWGO37U7fADQ+5tBzCyAbwAAAABJRU5ErkJggg=="}},2608:(e,o,i)=>{"use strict";i.r(o),i.d(o,{assets:()=>A,contentTitle:()=>r,default:()=>c,frontMatter:()=>n,metadata:()=>s,toc:()=>d});var t=i(4848),a=i(8453);const n={sidebar_position:1},r="USB Config Adapter",s={id:"configuration/usb-config-adapter",title:"USB Config Adapter",description:"The Lobaro USB configuration adapters connects the configuration serial uart of our devices to a PC. It is used for:",source:"@site/docs/configuration/usb-config-adapter.md",sourceDirName:"configuration",slug:"/configuration/usb-config-adapter",permalink:"/iot/configuration/usb-config-adapter",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/usb-config-adapter.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"configurationSidebar",previous:{title:"Introduction",permalink:"/iot/configuration/"},next:{title:"Lobaro Maintenance Tool",permalink:"/iot/configuration/lobaro-tool/"}},A={},d=[{value:"Adapter V1",id:"adapter-v1",level:2},{value:"Order-Code",id:"order-code",level:3},{value:"Installation",id:"installation",level:3},{value:"Physical connection",id:"physical-connection",level:3},{value:"Schematic",id:"schematic",level:3},{value:"Connector Type",id:"connector-type",level:3},{value:"Control Lines",id:"control-lines",level:3},{value:"DTR control line",id:"dtr-control-line",level:4},{value:"RTS control line",id:"rts-control-line",level:4},{value:"Adapter V2",id:"adapter-v2",level:2}];function g(e){const o={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",strong:"strong",ul:"ul",...(0,a.R)(),...e.components},{Image:n}=o;return n||function(e,o){throw new Error("Expected "+(o?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(o.h1,{id:"usb-config-adapter",children:"USB Config Adapter"}),"\n",(0,t.jsx)(o.p,{children:"The Lobaro USB configuration adapters connects the configuration serial uart of our devices to a PC. It is used for:"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"Sensor initial configuration, e.g. network parameters like LTE APN point"}),"\n",(0,t.jsx)(o.li,{children:"Viewing firmware log/debug diagnostic output"}),"\n",(0,t.jsx)(o.li,{children:"Firmware updates"}),"\n",(0,t.jsx)(o.li,{children:"Powering some of our devices (Boot and Reset must be disconnected to use as USB power supply)"}),"\n",(0,t.jsxs)(o.li,{children:["using our free ",(0,t.jsx)(o.a,{href:"/iot/configuration/lobaro-tool/",children:"Lobaro Maintenance Tool"})," PC software."]}),"\n"]}),"\n",(0,t.jsx)(o.h2,{id:"adapter-v1",children:"Adapter V1"}),"\n",(0,t.jsx)(n,{alt:"Lobaro USB Configuration Adapter V1",img:i(8754),style:{width:"30%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(o.h3,{id:"order-code",children:"Order-Code"}),"\n",(0,t.jsxs)(o.p,{children:["The configuration adapter including a 1 m USB cable can be ordered using its article number: ",(0,t.jsx)(o.code,{children:"#8000005"}),"."]}),"\n",(0,t.jsx)(o.h3,{id:"installation",children:"Installation"}),"\n",(0,t.jsxs)(o.p,{children:["The CP2102 uart serial USB driver ",(0,t.jsx)(o.strong,{children:"must"})," be installed, it can be\ndownloaded at\nthe ",(0,t.jsx)(o.a,{href:"https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads",children:"Silicon Labs Homepage"}),"."]}),"\n",(0,t.jsx)(o.admonition,{title:"Download",type:"tip",children:(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"CP210x_Universal_Windows_Driver.zip for Windows 11+"}),"\n",(0,t.jsx)(o.li,{children:"CP210x Windows Drivers v6.7.6 for Windows 10 and earlier"}),"\n"]})}),"\n",(0,t.jsx)(o.h3,{id:"physical-connection",children:"Physical connection"}),"\n",(0,t.jsx)(n,{alt:"Connection example lobaro usb configuration adaptr",img:i(7189),style:{width:"40%",paddingTop:"10px",paddingBottom:"20px"}}),"\n",(0,t.jsx)(o.p,{children:"Connect your Lobaro Device to the USB-port of your computer using the Lobaro Config Adapter. The 6-pin connector must be\nplugged into the white rectangular socket on the device that is labeled with the word CONFIG. The location of the socket\nis dependent on the specific device and hardware version you are trying to attach. See the hardware specific product\ndescription for the individual connector location."}),"\n",(0,t.jsx)(o.admonition,{title:"Device power supply over USB",type:"note",children:(0,t.jsx)(o.p,{children:"Some devices can be powered by the 3.3V the config adapter can provide out of the USB Port. Other devices, mostly the\nNB-IoT/LTE-M enabled cellular IoT boards or the need their normal power supply connected as well. If in doubt, just make\nsure you have the device powered!"})}),"\n",(0,t.jsx)(o.h3,{id:"schematic",children:"Schematic"}),"\n",(0,t.jsx)(n,{alt:"Schematic Lobaro USB Configuration Adapter V1",img:i(6581),style:{width:"100%",paddingTop:"10px",paddingBottom:"20px"}}),"\n",(0,t.jsx)(o.h3,{id:"connector-type",children:"Connector Type"}),"\n",(0,t.jsxs)(o.p,{children:["The USB adapter uses a six-wire ",(0,t.jsx)(o.a,{href:"https://www.jst-mfg.com/product/index.php?series=287",children:"JST-ZH series connector"})," for\nattaching to Lobaro hardware at the config connector."]}),"\n",(0,t.jsx)(n,{alt:"Lobaro USB Configuration Adapter V1",img:i(4847),style:{width:"90%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(o.h3,{id:"control-lines",children:"Control Lines"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"Boot0 of Lobaro sensors is connected to DTR line of the PC uart"}),"\n",(0,t.jsx)(o.li,{children:"Reset (active low) of Lobaro sensors is connected to RTS line of the PC uart"}),"\n"]}),"\n",(0,t.jsx)(o.admonition,{type:"info",children:(0,t.jsx)(o.p,{children:"Normally the handling of these uart control lines is done automatically by the Lobaro PC tool. When using an alternative\nuart terminal tool make sure you setup the RTS and DTR lines correctly or simply cut the DTR/RTS wires from\nthe USB adapter if the reset and/or bootloader control lines are not needed and you simply want to look at the devices\nlog output."})}),"\n",(0,t.jsx)(o.h4,{id:"dtr-control-line",children:"DTR control line"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"Low / true => Run Firmware after Reset (Default since BOOT0 has internal pull-down)"}),"\n",(0,t.jsx)(o.li,{children:"High / false => Run Bootloader after Reset"}),"\n"]}),"\n",(0,t.jsx)(o.h4,{id:"rts-control-line",children:"RTS control line"}),"\n",(0,t.jsxs)(o.ul,{children:["\n",(0,t.jsx)(o.li,{children:"High / false => Run Firmware / Bootloader (Default since RESET has internal pull-up)"}),"\n",(0,t.jsx)(o.li,{children:"Low / true => Chip in RESET mode (not running)"}),"\n"]}),"\n",(0,t.jsx)(o.h2,{id:"adapter-v2",children:"Adapter V2"}),"\n",(0,t.jsx)(o.admonition,{type:"note",children:(0,t.jsx)(o.p,{children:"The usb adapter in version 2 will be available latest end of 2024."})})]})}function c(e={}){const{wrapper:o}={...(0,a.R)(),...e.components};return o?(0,t.jsx)(o,{...e,children:(0,t.jsx)(g,{...e})}):g(e)}},8453:(e,o,i)=>{"use strict";i.d(o,{R:()=>r,x:()=>s});var t=i(6540);const a={},n=t.createContext(a);function r(e){const o=t.useContext(n);return t.useMemo((function(){return"function"==typeof e?e(o):{...o,...e}}),[o,e])}function s(e){let o;return o=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:r(e.components),t.createElement(n.Provider,{value:o},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/de2b644d.40cf7a8c.js b/assets/js/de2b644d.40cf7a8c.js deleted file mode 100644 index 13a524ca..00000000 --- a/assets/js/de2b644d.40cf7a8c.js +++ /dev/null @@ -1 +0,0 @@ -(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[4124],{5134:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png 300w,"+i.p+"assets/images/ideal-img/3F-result-in-ascii.40566be.600.png 600w,"+i.p+"assets/images/ideal-img/3F-result-in-ascii.c89288d.619.png 619w",images:[{path:i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png",width:300,height:314},{path:i.p+"assets/images/ideal-img/3F-result-in-ascii.40566be.600.png",width:600,height:628},{path:i.p+"assets/images/ideal-img/3F-result-in-ascii.c89288d.619.png",width:619,height:648}],src:i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png",toString:function(){return i.p+"assets/images/ideal-img/3F-result-in-ascii.8f086ec.300.png"},placeholder:void 0,width:300,height:314},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAIAAAACUFjqAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABDUlEQVR4nCXOzU/CMBiA8f7/B4/eTSQSNHLQSDwoJhrR3fTAh4DuA9aObv0eHeu71qDJL8/5QUIqIRQXSiptdK20aZqDc9C2znuPKEkYzRhNJcNaEC2I4ljyXHJca4rI9qvAsWS5NdRILKrUGmrNztalYgkaj0fnF73BVX81j1S5YGTKixkvjmXFFJHtIksWaTwn2zUv04omvMok24gqE+UPsjUH8G3rjjsOALoQQvA+hNBYgWpTAjhwhw7aDlzX/Wu972zNkKHJge+sxtBQsHSvsJH5HyyrGN1/3vSi3kv0FL29TibPRb7cq43miRGZLNfo9vHsdHhyN+w/DK9Hl4PVx3tF4wKvd+SbkuUv4kcPHFiK110AAAAASUVORK5CYII="}},5607:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png 300w,"+i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.208579d.600.png 600w,"+i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.b7f06e1.882.png 882w",images:[{path:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png",width:300,height:224},{path:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.208579d.600.png",width:600,height:449},{path:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.b7f06e1.882.png",width:882,height:660}],src:i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png",toString:function(){return i.p+"assets/images/ideal-img/Downlink-TTN-get-fw.2856aac.300.png"},placeholder:void 0,width:300,height:224},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAIAAAC+zks0AAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAcUlEQVR4nG2MMQ7CMBAE/f9v0fAMilAgpAT7Ysu+27tFcYEAZTTdSJNIam35du8vcQYAdwcQESSTmW7PteXKM5KaSd1V1d1P8iili9h8xuQnN9nrfpwj/p3znEcTNfQBA789ctna9bI8ljUCZgrYR5JvSz7Nn8r84TIAAAAASUVORK5CYII="}},2627:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png 300w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.25fff62.600.png 600w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.29cb7ea.900.png 900w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.31d1046.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png",width:300,height:7},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.25fff62.600.png",width:600,height:13},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.29cb7ea.900.png",width:900,height:20},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.31d1046.1200.png",width:1200,height:27}],src:i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png",toString:function(){return i.p+"assets/images/ideal-img/lorawan-downlink-3F-answer.89a212a.300.png"},placeholder:void 0,width:300,height:7},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAIAAABol6gpAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAKklEQVR4nAEfAOD/APLy8vDw8Pb29vLx8fH09O3Z2ea3t/Du7vHy8vPz86+eG6M4AoFrAAAAAElFTkSuQmCC"}},8217:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png 300w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.ac16a73.600.png 600w,"+i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.80f3eb1.634.png 634w",images:[{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png",width:300,height:21},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.ac16a73.600.png",width:600,height:43},{path:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.80f3eb1.634.png",width:634,height:45}],src:i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png",toString:function(){return i.p+"assets/images/ideal-img/lorawan-downlink-3F-downlink.13ce5f6.300.png"},placeholder:void 0,width:300,height:21},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAABCAIAAABol6gpAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAHklEQVR4nGP4+vXrly9fPsPAz58/ISLfvn379OkTALwKHKViCz9TAAAAAElFTkSuQmCC"}},9362:(e,n,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png 300w,"+i.p+"assets/images/ideal-img/ttn-downlink.6f8f05b.600.png 600w,"+i.p+"assets/images/ideal-img/ttn-downlink.7f4d85d.900.png 900w,"+i.p+"assets/images/ideal-img/ttn-downlink.307b73d.1081.png 1081w",images:[{path:i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png",width:300,height:103},{path:i.p+"assets/images/ideal-img/ttn-downlink.6f8f05b.600.png",width:600,height:205},{path:i.p+"assets/images/ideal-img/ttn-downlink.7f4d85d.900.png",width:900,height:308},{path:i.p+"assets/images/ideal-img/ttn-downlink.307b73d.1081.png",width:1081,height:370}],src:i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png",toString:function(){return i.p+"assets/images/ideal-img/ttn-downlink.bd44598.300.png"},placeholder:void 0,width:300,height:103},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAADCAYAAACqPZ51AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAS0lEQVR4nEXLUQqAMAwD0N3/lB5AUBHWpNsaaUEtPPKRtO3nJZCKiDLnFEmttT7urtZ7ryIHY4zK9F4+O6kGUAbIzAoMAn7ZbfehB1MfdZx0etnTAAAAAElFTkSuQmCC"}},1797:(e,n,i)=>{"use strict";i.r(n),i.d(n,{assets:()=>d,contentTitle:()=>o,default:()=>h,frontMatter:()=>s,metadata:()=>r,toc:()=>l});var t=i(4848),a=i(8453);const s={sidebar_position:4},o="Remote Config (LoRaWAN)",r={id:"configuration/remote-config-lorawan",title:"Remote Config (LoRaWAN)",description:"This article describes the technical details how to remotely configure Lobaro devices that are using LoRaWAN as",source:"@site/docs/configuration/remote-config-lorawan.md",sourceDirName:"configuration",slug:"/configuration/remote-config-lorawan",permalink:"/iot/configuration/remote-config-lorawan",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/remote-config-lorawan.md",tags:[],version:"current",sidebarPosition:4,frontMatter:{sidebar_position:4},sidebar:"configurationSidebar",previous:{title:"CRON Expressions",permalink:"/iot/configuration/cron-expressions"}},d={},l=[{value:"Protocol Description",id:"protocol-description",level:2},{value:"Downlink Commands (Port 128)",id:"downlink-commands-port-128",level:3},{value:"?",id:"",level:4},{value:"g<name>",id:"gname",level:4},{value:"r<name> / r*",id:"rname--r",level:4},{value:"s<name>=<value>",id:"snamevalue",level:4},{value:"a<name>=<value>",id:"anamevalue",level:4},{value:"b",id:"b",level:4},{value:"w or wFORCE",id:"w-or-wforce",level:4},{value:"Examples",id:"examples",level:2},{value:"Changing device configuration",id:"changing-device-configuration",level:3},{value:"Downlink on TTN",id:"downlink-on-ttn",level:4},{value:"Getting the firmware version",id:"getting-the-firmware-version",level:3},{value:"Downlink on TTN",id:"downlink-on-ttn-1",level:4},{value:"Uplink on TTN",id:"uplink-on-ttn",level:4},{value:"Configure a device via script",id:"configure-a-device-via-script",level:3},{value:"Example configuration command to be send",id:"example-configuration-command-to-be-send",level:4},{value:"Curl Script for TTN",id:"curl-script-for-ttn",level:4},{value:"Chirpstack V3",id:"chirpstack-v3",level:4},{value:"Chirpstack V4",id:"chirpstack-v4",level:4}];function c(e){const n={a:"a",admonition:"admonition",br:"br",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,a.R)(),...e.components},{Image:s}=n;return s||function(e,n){throw new Error("Expected "+(n?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"remote-config-lorawan",children:"Remote Config (LoRaWAN)"}),"\n",(0,t.jsxs)(n.p,{children:["This article describes the technical details how to remotely configure Lobaro devices that are using ",(0,t.jsx)(n.strong,{children:"LoRaWAN"})," as\nupload technology."]}),"\n",(0,t.jsx)(n.p,{children:"IoT devices are often installed at places that are difficult to reach. If you need to change the settings of such a\ndevice it is often not easily possible to get physical access to attach a config adapter."}),"\n",(0,t.jsx)(n.p,{children:"Many of our devices support LoRaWAN remote configuration that allows you to change the configuration of the device by\nsending downlink messages."}),"\n",(0,t.jsx)(n.admonition,{type:"note",children:(0,t.jsx)(n.p,{children:"If you are using cellular IoT (NB-IoT, LTE-M) as communication technology any configuration updates are done in a\ndifferent way."})}),"\n",(0,t.jsx)(n.h2,{id:"protocol-description",children:"Protocol Description"}),"\n",(0,t.jsxs)(n.p,{children:["Lobaro LoRaWAN devices receive remote configuration commands as Downlinks on port 128. Responses to those commands will\nbe sent as Uplinks on ",(0,t.jsx)(n.code,{children:"Port 128"})," (and 129-131 for long responses). ",(0,t.jsx)(n.strong,{children:"The remote commands and their responses are all\nencoded in ASCII"}),", to make it easier for humans to use them. The ASCII string must be converted to hex or Base64\npayload bytes, depending on the used LoRaWAN network server."]}),"\n",(0,t.jsxs)(n.p,{children:["The first byte of a Downlink message on ",(0,t.jsx)(n.code,{children:"Port 128"})," contains a single character that identifies the command you want to\nsend. Some commands take a parameter following the command char."]}),"\n",(0,t.jsx)(n.p,{children:"The responses to a command start with the same character as the command followed by an optional parameter. If a command\nis unknown, or it fails for some reason, an error response is sent via Uplink that contains with a ! followed by a\nreadable error message."}),"\n",(0,t.jsx)(n.p,{children:"Changing configuration does nothing until you save the changes and reboot the device. The device has a safety feature\nthat prevents configurations that make the device unusable. A new configuration is tested in the first run after\nrebooting. Only after the device reaches a stable state will the configuration be adopted and used permanently. If a\nproblem occurs the device will restore its last stable connection and reboot. If the device uses OTAA (which we\nrecommend) the device will only adopt the new configuration only after a join request is accepted, to make sure the\nLoRaWAN parameters are correct. After a few failed attempts it will restore the previous configuration. This can take up\nto about 10 minutes."}),"\n",(0,t.jsx)(n.admonition,{type:"info",children:(0,t.jsx)(n.p,{children:"Downlinks should only be used to a limited extent depending on the infrastructure. In the free version of TTN, the Fair\nuse policy says, that no more than 10 downlinks should be made. You also have to observe the regulations within the\nLimit of the duty cycle limitation. That is why downlinks are only to be carried out with caution and when absolutely\nnecessary. The number of possible characters that can be sent is limited by the respective spreading factor (With a SF\nof 12 only 51 characters)."})}),"\n",(0,t.jsx)(n.h3,{id:"downlink-commands-port-128",children:"Downlink Commands (Port 128)"}),"\n",(0,t.jsxs)(n.p,{children:["Configurations are normally communicated as downlinks and uplinks (responses) on ",(0,t.jsx)(n.code,{children:"Port 128"}),". For longer responses, that\ndon't can be send as single uplink on ",(0,t.jsx)(n.code,{children:"Port 128"}),", the ",(0,t.jsx)(n.code,{children:"Ports 129-131"})," are used. The first response part is sent\non ",(0,t.jsx)(n.code,{children:"Port 129"}),", the middle parts (if exist) on ",(0,t.jsx)(n.code,{children:"Port 130"})," and the last part on ",(0,t.jsx)(n.code,{children:"Port 131"}),". A stateful parser can\nconcatenate long responses based on Port and FCnt."]}),"\n",(0,t.jsxs)(n.table,{children:[(0,t.jsx)(n.thead,{children:(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.th,{children:"Char"}),(0,t.jsx)(n.th,{children:"Command"}),(0,t.jsx)(n.th,{children:"Parameter"}),(0,t.jsx)(n.th,{children:"HEX"}),(0,t.jsx)(n.th,{children:"Info"})]})}),(0,t.jsxs)(n.tbody,{children:[(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"?"}),(0,t.jsx)(n.td,{children:"Request firmware and version"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"None "})}),(0,t.jsx)(n.td,{children:"3F"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"a"}),(0,t.jsx)(n.td,{children:"Append to config parameter val"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"= "})}),(0,t.jsx)(n.td,{children:"61"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"b"}),(0,t.jsx)(n.td,{children:"Reboot device without saving"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"None "})}),(0,t.jsx)(n.td,{children:"62"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"g"}),(0,t.jsx)(n.td,{children:"Get config parameter value"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"Name of parameter"})}),(0,t.jsx)(n.td,{children:"67"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"r"}),(0,t.jsx)(n.td,{children:"Reset config parameter value"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"Name of parameter"})}),(0,t.jsx)(n.td,{children:"72"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"s"}),(0,t.jsx)(n.td,{children:"Set config parameter value"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"= "})}),(0,t.jsx)(n.td,{children:"73"}),(0,t.jsx)(n.td,{})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"S"}),(0,t.jsx)(n.td,{children:"Set config parameter value & Save and reboot"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"= "})}),(0,t.jsx)(n.td,{children:"53"}),(0,t.jsx)(n.td,{children:"Not supported on all devices"})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"w"}),(0,t.jsx)(n.td,{children:"Save config and reboot device"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"None "})}),(0,t.jsx)(n.td,{children:"77"}),(0,t.jsx)(n.td,{})]})]})]}),"\n",(0,t.jsx)(n.admonition,{type:"warning",children:(0,t.jsx)(n.p,{children:"Depending on the firmware version not all commands might be supported on all devices.\nPlease refer to the manual of your product for more details."})}),"\n",(0,t.jsx)(n.h4,{id:"",children:(0,t.jsx)(n.code,{children:"?"})}),"\n",(0,t.jsx)(n.p,{children:"Request firmware and version. This command triggers the device to send what firmware it is running and in which version.\nThis can be used to test if the remote configuration is working."}),"\n",(0,t.jsx)(n.h4,{id:"gname",children:(0,t.jsx)(n.code,{children:"g"})}),"\n",(0,t.jsxs)(n.p,{children:["Get the value of the config parameter ",(0,t.jsx)(n.code,{children:""}),". This command makes the device sent a response\ncontaining ",(0,t.jsx)(n.code,{children:"="})," as\nparameter giving you the current value of a configuration parameter."]}),"\n",(0,t.jsx)(n.h4,{id:"rname--r",children:(0,t.jsx)(n.code,{children:"r / r*"})}),"\n",(0,t.jsxs)(n.p,{children:["Reset config parameter ",(0,t.jsx)(n.code,{children:""})," to its default value. As a confirmation the device sends a response\ncontaining ",(0,t.jsx)(n.code,{children:"="}),", reporting the new value of the parameter.Sending the special value * will reset all config\nparameters."]}),"\n",(0,t.jsx)(n.h4,{id:"snamevalue",children:(0,t.jsx)(n.code,{children:"s="})}),"\n",(0,t.jsxs)(n.p,{children:["Set config parameter ",(0,t.jsx)(n.code,{children:""})," to ",(0,t.jsx)(n.code,{children:""}),". Sets the parameter to the value given in the parameter. As a confirmation it\nsends a response containing ",(0,t.jsx)(n.code,{children:"="}),", reporting the new value of the parameter."]}),"\n",(0,t.jsx)(n.h4,{id:"anamevalue",children:(0,t.jsx)(n.code,{children:"a="})}),"\n",(0,t.jsxs)(n.p,{children:["Append ",(0,t.jsx)(n.code,{children:""})," to the config parameter ",(0,t.jsx)(n.code,{children:""}),". This command appends the value given to the current value of the\nparameter. This is intended to allow setting values that are too long for a single Downlink message. As a confirmation\nit sends the length of the config parameter's value after the appending. Append works for config parameters of type\nstring."]}),"\n",(0,t.jsx)(n.h4,{id:"b",children:(0,t.jsx)(n.code,{children:"b"})}),"\n",(0,t.jsx)(n.p,{children:"Reboot device without saving. This command restarts the device. Any changes too the config that have been committed\nbefore will be lost! This command does not send a Response."}),"\n",(0,t.jsx)(n.h4,{id:"w-or-wforce",children:(0,t.jsx)(n.code,{children:"w or wFORCE"})}),"\n",(0,t.jsx)(n.p,{children:"Save config and reboot device. This command saves all configuration changes to a temporarily configuration and restarts\nthe device. Only if the device boots successfully and reaches normal operation mode is the new configuration made\npermanent. If any fatal configuration error occurs or if the LoRaWAN OTAA Join does not succeed, the previous\nconfiguration will be restored and the device restarted again. This command does not send a Response.If you add the\nspecial argument FORCE to the command, the configuration will be made permanent without testing the configuration."}),"\n",(0,t.jsxs)(n.admonition,{type:"danger",children:[(0,t.jsxs)(n.p,{children:["Using ",(0,t.jsx)(n.strong,{children:"wFORCE"})," can leave your device useless and unreachable!"]}),(0,t.jsxs)(n.p,{children:["Do not use ",(0,t.jsx)(n.strong,{children:"wFORCE"})," unless you have a very good reason. If the device is set to an invalid configuration it will no\nlonger\nbe reachable by the Network Server. From such a state it can only be recovered with physical access and a config\nadapter. It will also most likely drain the battery quickly."]})]}),"\n",(0,t.jsxs)(n.admonition,{type:"warning",children:[(0,t.jsxs)(n.p,{children:["For commands ",(0,t.jsx)(n.code,{children:"s"}),", ",(0,t.jsx)(n.code,{children:"S"})," and ",(0,t.jsx)(n.code,{children:"a"})," make sure the number of characters to send matches with the possibilities your devices\nspreading factor:"]}),(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"SF 7 = 242 bytes max. LoRaWAN downlink payload"}),"\n",(0,t.jsx)(n.li,{children:"SF 12 = 51 bytes max. LoRaWAN downlink payload"}),"\n"]}),(0,t.jsx)(n.p,{children:"Consider splitting bigger configuration changed in multiple smaller downlinks."})]}),"\n",(0,t.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,t.jsx)(n.h3,{id:"changing-device-configuration",children:"Changing device configuration"}),"\n",(0,t.jsx)(n.p,{children:"The following is a short example of how you can update two configuration values remotely (that includes rebooting the\ndevice)."}),"\n",(0,t.jsx)(n.p,{children:"Most LoRaWAN devices (all that are running in Class A, which are by fast the most) can only be reached when they contact\nthe network. Network Servers (like The Things Network) provide a mechanism to enqueue messages for a specific device.\nThe messages will be sent as downlink the next time that device contacts the network. Normally, multiple messages can be\nenqueued and will all be transmitted as soon as possible. Please be advised that the gateways communicating with your\ndevice must respect their duty cycle, so there is a very limited amount of downlinks that can be sent for a given time (\ndownlinks are expensive)."}),"\n",(0,t.jsx)(n.p,{children:"For this example we want to set Time Synchronization to sync the internal clock every 10 days, and we want to deactivate\nAdaptive Date Rate (ADR). These are both LoRaWAN configuration parameters that are present on most devices (find details\nunder LoRaWAN Configuration), but you can of course also change parameters specific to your device, e.g. Modbus\nconfiguration or wMBus configuration, with this feature."}),"\n",(0,t.jsx)(n.p,{children:"We will need to send three commands:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"s"}),"TimeSync=10","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"set time synchronization to 10 day interval"}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"s"}),"ADR=false","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"disable adaptive data rate"}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"w"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"write changes to device configuration and reboot"}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["The actual s-commands will of course differ for your case, but the w command at the end ",(0,t.jsx)(n.strong,{children:"must"})," always be the same."]}),"\n",(0,t.jsx)(n.p,{children:"After sending the final command, the device will reboot and try the new configuration. If the boot process and the\nconnection to the network are successful, the device will make the changes permanent. If there is a problem (if you\naccidentally set an invalid value, e.g. sADR=flase or if you changed your AppKey to wrong value and your OTAA fails),\nthe device will revert to the previous configuration."}),"\n",(0,t.jsx)(n.h4,{id:"downlink-on-ttn",children:"Downlink on TTN"}),"\n",(0,t.jsx)(n.p,{children:"How you sent your downlinks depends on the LoRaWAN Network Server you use to connect your devices. You will most likely\nneed to convert the commands (that are all ASCII) to some different representation, e.g. Hex or Base64."}),"\n",(0,t.jsx)(n.p,{children:'In The Things Network you find the downlink panel on the "Device Overview" page for each device, directly below the\npanel that shows you OTAA/ABP information (DevEUI, AppKey, ...). It is shown in the following screenshot.'}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN downlink configuration",img:i(9362),style:{width:"60%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsxs)(n.p,{children:["You will have to encode the commands in hex. In the screenshot you see ",(0,t.jsx)(n.code,{children:"73 54 69 6d 65 53 79 6e 63 3d 31 30"})," as the\nmessage to send; that is the hex representation of ",(0,t.jsx)(n.code,{children:"sTimeSync=10"}),". The Port used for remote configuration for our\ndevices\nis 128. When you enter multiple messages to send, be sure to set the correct scheduling (last). The preselected replace\nwill overwrite your previously enqueued messages."]}),"\n",(0,t.jsx)(n.h3,{id:"getting-the-firmware-version",children:"Getting the firmware version"}),"\n",(0,t.jsxs)(n.p,{children:['For this example the "Request firmware and version" ',(0,t.jsx)(n.code,{children:"?"})," (0x3F) command has to used. We use TTN as network server."]}),"\n",(0,t.jsx)(n.h4,{id:"downlink-on-ttn-1",children:"Downlink on TTN"}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN downlink get firmware version",img:i(5607),style:{width:"50%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(n.p,{children:"Will result in:"}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN downlink get firmware version",img:i(8217),style:{width:"50%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsx)(n.h4,{id:"uplink-on-ttn",children:"Uplink on TTN"}),"\n",(0,t.jsx)(n.p,{children:"The device answers with this uplink:"}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN uplink get firmware version",img:i(2627),style:{width:"95%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsxs)(n.p,{children:["This response can be converted to ASCII again, e.g. using\nany ",(0,t.jsx)(n.a,{href:"https://www.rapidtables.com/convert/number/hex-to-ascii.html",children:"online converter"}),":"]}),"\n",(0,t.jsx)(s,{alt:"TTN LoRaWAN uplink to ascii conversion get firmware version",img:i(5134),style:{width:"30%",paddingTop:"5px",paddingBottom:"5px"}}),"\n",(0,t.jsxs)(n.p,{children:["The result is: ",(0,t.jsx)(n.code,{children:"?app-hybrid-modbus v0.4.0+battery"})]}),"\n",(0,t.jsx)(n.h3,{id:"configure-a-device-via-script",children:"Configure a device via script"}),"\n",(0,t.jsx)(n.h4,{id:"example-configuration-command-to-be-send",children:"Example configuration command to be send"}),"\n",(0,t.jsxs)(n.p,{children:["Example command (ASCII encoding):",(0,t.jsx)(n.br,{}),"\n",(0,t.jsx)(n.code,{children:"SMbCmd=0 0/10 * * * *:R,9600,8N1:010300160002,010300260002,fa0400050001"})]}),"\n",(0,t.jsxs)(n.admonition,{type:"warning",children:[(0,t.jsxs)(n.p,{children:["For commands ",(0,t.jsx)(n.code,{children:"s"}),", ",(0,t.jsx)(n.code,{children:"S"})," and ",(0,t.jsx)(n.code,{children:"a"})," make sure the number of characters to send matches with the possibilities your devices\nspreading factor:"]}),(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"SF 7 = 242 bytes max. LoRaWAN downlink payload"}),"\n",(0,t.jsx)(n.li,{children:"SF 12 = 51 bytes max. LoRaWAN downlink payload"}),"\n"]}),(0,t.jsx)(n.p,{children:"Consider splitting bigger configuration changed in multiple smaller downlinks."})]}),"\n",(0,t.jsxs)(n.p,{children:["Example command (Base64 encoding):",(0,t.jsx)(n.br,{}),"\n",(0,t.jsx)(n.code,{children:"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE="})]}),"\n",(0,t.jsx)(n.h4,{id:"curl-script-for-ttn",children:"Curl Script for TTN"}),"\n",(0,t.jsx)(n.p,{children:"Curl script to be used with TTN:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-shell",children:"curl --location \\ --header 'Authorization: Bearer NNSXS.XJAZK3VF3YBMXX_API_KEY_KR2HFG6ABXXXXXX.CP4WZUOXXXXXXXB5WW4UUSMNXRLUJ7LVO2U' \\\n--header 'Content-Type: application/json' \\\n--header 'User-Agent: my-integration/my-integration-version' \\\n--request POST \\ --data '{\"downlinks\":[{ \"frm_payload\":\n\"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE=\",\n\"f_port\":128 }] }' \\\n'https://eu1.cloud.thethings.network/api/v3/as/applications/your-ttn-applicationID/devices/eui-your_TTN_end_deviceID/down/push'\n"})}),"\n",(0,t.jsxs)(n.p,{children:["See also: ",(0,t.jsx)(n.a,{href:"https://www.thethingsindustries.com/docs/integrations/webhooks/scheduling-downlinks/",children:"https://www.thethingsindustries.com/docs/integrations/webhooks/scheduling-downlinks/"})]}),"\n",(0,t.jsx)(n.admonition,{type:"tip",children:(0,t.jsx)(n.p,{children:"You should use your own data for the API KEY, your-ttn-applicationID and your your_TTN_end_deviceID"})}),"\n",(0,t.jsx)(n.h4,{id:"chirpstack-v3",children:"Chirpstack V3"}),"\n",(0,t.jsx)(n.p,{children:"Curl script to be used with Chirpstack V3:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-shell",children:"curl -X POST --header 'Content-Type: application/json'\n--header 'Accept: application/json'\n--header 'Grpc-Metadata-Authorization:\nBearer xxxxxxxxx_API_KEY_xxxxxxx' -d\n'{ \"deviceQueueItem\": { \"confirmed\": false, \"data\":\n\"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE=\",\n\"fPort\": 128\n } }'\n'http://192.198.0.101:8080/api/devices/ChirpStack_DevEUI/queue'\n"})}),"\n",(0,t.jsx)(n.admonition,{type:"tip",children:(0,t.jsx)(n.p,{children:"You should use your own data for the API KEY, your Chirpstack_IP_Adress and your your_ChirpStack_DevEUI"})}),"\n",(0,t.jsx)(n.h4,{id:"chirpstack-v4",children:"Chirpstack V4"}),"\n",(0,t.jsx)(n.p,{children:'The actual API has now switched from the Swagger API with UI to gRPC integration, but for compatibility and transition\nreasons the chirpstack-rest-api can be installed as an additional component. However, experience has shown that there\nare changes that need to be considered. "deviceQueueItem" became ""queueItem" and by default the API can now be reached\non port 8090 and no longer 8080.'}),"\n",(0,t.jsx)(n.p,{children:"Curl script to be used with Chirpstack V4:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-shell",children:"curl -X POST --header 'Content-Type: application/json'\n--header 'Accept: application/json'\n--header 'Grpc-Metadata-Authorization:\nBearer xxxxxxxxx_API_KEY_xxxxxxx' -d\n'{ \"queueItem\": { \"confirmed\": false, \"data\":\n\"U01iQ21kPTAgMC8xMCAqICogKiAqOlIsOTYwMCw4TjE6MDEwMzAwMTYwMDAyLDAxMDMwMDI2MDAwMixmYTA0MDAwNTAwMDE=\",\n\"fPort\": 128\n } }'\n'http://192.198.0.101:8090/api/devices/ChirpStack_DevEUI/queue'\n"})})]})}function h(e={}){const{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},8453:(e,n,i)=>{"use strict";i.d(n,{R:()=>o,x:()=>r});var t=i(6540);const a={},s=t.createContext(a);function o(e){const n=t.useContext(s);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:o(e.components),t.createElement(s.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/f6d78023.9759d006.js b/assets/js/f6d78023.9759d006.js deleted file mode 100644 index 8ec7f4fa..00000000 --- a/assets/js/f6d78023.9759d006.js +++ /dev/null @@ -1 +0,0 @@ -(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[4545],{9536:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png 300w,"+i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.cc600dd.600.png 600w,"+i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.c94c9bf.900.png 900w,"+i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.faaf604.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png",width:300,height:182},{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.cc600dd.600.png",width:600,height:363},{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.c94c9bf.900.png",width:900,height:545},{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.faaf604.1200.png",width:1200,height:726}],src:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png",toString:function(){return i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png"},placeholder:void 0,width:300,height:182},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAGCAYAAAD68A/GAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAqElEQVR4nEWP0YqDMBBF8/+/tijoU3xoE3Ylbl1DUpNoldCzdKD04TAMc+/cGfX3/cPt90YuRSilsG3vupHWjL9YlPtqeew7PkTWvIl43x8cx/GhFNRRqzTWGK7XC3rQWGuZpol5nokxknJG8XyK0BhD3/c0TcMwDIzjyLIspJTkDAVwnidaa7quo21b4WV6Gbz3ZNkI1FqZnJM455wMYwiEEFjvd3nqH8gU4VJFWyncAAAAAElFTkSuQmCC"}},3046:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png 300w,"+i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.46f51b5.600.png 600w,"+i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.b3f9a4a.900.png 900w,"+i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.446b0a4.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png",width:300,height:200},{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.46f51b5.600.png",width:600,height:401},{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.b3f9a4a.900.png",width:900,height:601},{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.446b0a4.1200.png",width:1200,height:801}],src:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png",toString:function(){return i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png"},placeholder:void 0,width:300,height:200},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAYAAAAxrNxjAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAl0lEQVR4nFWO2woDIQxE/f/vbCnFddU1JvHCTklgHxoIOJmTieETM95HxVkqWAeIFTIWdO6/Dq/vgXQWXNRxNUJnAYtC9OnhOuRSsdYCUYeqwkpVfHbfN4gIIoJwxIjeO5jZB3tv13NOB1NKGGMgtNbcfAwrWzDTdCnF00Ot1UEzbclMS7Rv/CXGGB2y0zlnfxv4JBpo1347Cg/vyVyimgAAAABJRU5ErkJggg=="}},5117:(e,o,i)=>{"use strict";i.r(o),i.d(o,{assets:()=>g,contentTitle:()=>r,default:()=>p,frontMatter:()=>t,metadata:()=>s,toc:()=>l});var a=i(4848),n=i(8453);const t={sidebar_position:0},r="Introduction",s={id:"configuration/index",title:"Introduction",description:"Lobaro devices allow a wide range of internal configuration adjustments.",source:"@site/docs/configuration/index.md",sourceDirName:"configuration",slug:"/configuration/",permalink:"/iot/configuration/",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/index.md",tags:[],version:"current",sidebarPosition:0,frontMatter:{sidebar_position:0},sidebar:"configurationSidebar",next:{title:"USB Config Adapter",permalink:"/iot/configuration/usb-config-adapter"}},g={},l=[{value:"How to configure",id:"how-to-configure",level:2}];function d(e){const o={a:"a",h1:"h1",h2:"h2",p:"p",...(0,n.R)(),...e.components},{Image:t}=o;return t||function(e,o){throw new Error("Expected "+(o?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(o.h1,{id:"introduction",children:"Introduction"}),"\n",(0,a.jsx)(o.p,{children:"Lobaro devices allow a wide range of internal configuration adjustments.\nThese chapter describes some generally valid tools and parameters that are used in the same way for many Lobaro devices.\nAll configuration parameters are stored non-volatile independently of the power supply in the Lobaro devices."}),"\n",(0,a.jsx)(o.p,{children:"Device and firmware specific parameters are explained in the respective documentation."}),"\n",(0,a.jsx)(o.h2,{id:"how-to-configure",children:"How to configure"}),"\n",(0,a.jsx)(t,{alt:"Lobaro Configuration Tool",img:i(9536),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,a.jsxs)(o.p,{children:["Any Lobaro device configuration can be set and read out either locally via a PC with the ",(0,a.jsx)(o.a,{href:"./usb-config-adapter",children:"Lobaro configuration USB\nadapter"})," and the ",(0,a.jsx)(o.a,{href:"/iot/configuration/lobaro-tool/",children:"Lobaro Maintenance Tool"})," or over the air remotely\nusing the Lobaro IoT platform and mobile radio (NB-IoT, LTE-M) or any LoRaWAN network server using downlinks on the\nspecial cfg port."]}),"\n",(0,a.jsx)(t,{alt:"Lobaro Platform Configuration Tab",img:i(3046),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,a.jsx)(o.p,{children:"Some network related parameters, such as the APN of the mobile cellular network provider, must usually\nfirst be configured correctly locally before the device can get online."}),"\n",(0,a.jsx)(o.p,{children:"Alternatively, possible on request for larger orders, an customer specific configuration agreed with the customer can\nalso be installed by Lobaro during\nproduction provisioning."})]})}function p(e={}){const{wrapper:o}={...(0,n.R)(),...e.components};return o?(0,a.jsx)(o,{...e,children:(0,a.jsx)(d,{...e})}):d(e)}},8453:(e,o,i)=>{"use strict";i.d(o,{R:()=>r,x:()=>s});var a=i(6540);const n={},t=a.createContext(n);function r(e){const o=a.useContext(t);return a.useMemo((function(){return"function"==typeof e?e(o):{...o,...e}}),[o,e])}function s(e){let o;return o=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:r(e.components),a.createElement(t.Provider,{value:o},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/f6d78023.f0300329.js b/assets/js/f6d78023.f0300329.js new file mode 100644 index 00000000..9603c25f --- /dev/null +++ b/assets/js/f6d78023.f0300329.js @@ -0,0 +1 @@ +(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[4545],{9536:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png 300w,"+i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.cc600dd.600.png 600w,"+i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.c94c9bf.900.png 900w,"+i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.faaf604.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png",width:300,height:182},{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.cc600dd.600.png",width:600,height:363},{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.c94c9bf.900.png",width:900,height:545},{path:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.faaf604.1200.png",width:1200,height:726}],src:i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png",toString:function(){return i.p+"assets/images/ideal-img/Lobaro-Config-in-Log.2d179d4.300.png"},placeholder:void 0,width:300,height:182},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAGCAYAAAD68A/GAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAqElEQVR4nEWP0YqDMBBF8/+/tijoU3xoE3Ylbl1DUpNoldCzdKD04TAMc+/cGfX3/cPt90YuRSilsG3vupHWjL9YlPtqeew7PkTWvIl43x8cx/GhFNRRqzTWGK7XC3rQWGuZpol5nokxknJG8XyK0BhD3/c0TcMwDIzjyLIspJTkDAVwnidaa7quo21b4WV6Gbz3ZNkI1FqZnJM455wMYwiEEFjvd3nqH8gU4VJFWyncAAAAAElFTkSuQmCC"}},3046:(e,o,i)=>{e.exports={src:{srcSet:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png 300w,"+i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.46f51b5.600.png 600w,"+i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.b3f9a4a.900.png 900w,"+i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.446b0a4.1200.png 1200w",images:[{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png",width:300,height:200},{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.46f51b5.600.png",width:600,height:401},{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.b3f9a4a.900.png",width:900,height:601},{path:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.446b0a4.1200.png",width:1200,height:801}],src:i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png",toString:function(){return i.p+"assets/images/ideal-img/configuration-example-lobaro-platform.35ae3a7.300.png"},placeholder:void 0,width:300,height:200},preSrc:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAYAAAAxrNxjAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAl0lEQVR4nFWO2woDIQxE/f/vbCnFddU1JvHCTklgHxoIOJmTieETM95HxVkqWAeIFTIWdO6/Dq/vgXQWXNRxNUJnAYtC9OnhOuRSsdYCUYeqwkpVfHbfN4gIIoJwxIjeO5jZB3tv13NOB1NKGGMgtNbcfAwrWzDTdCnF00Ot1UEzbclMS7Rv/CXGGB2y0zlnfxv4JBpo1347Cg/vyVyimgAAAABJRU5ErkJggg=="}},5117:(e,o,i)=>{"use strict";i.r(o),i.d(o,{assets:()=>l,contentTitle:()=>r,default:()=>c,frontMatter:()=>t,metadata:()=>s,toc:()=>d});var n=i(4848),a=i(8453);const t={sidebar_position:0},r="Introduction",s={id:"configuration/index",title:"Introduction",description:"Lobaro devices allow a wide range and flexible way of internal configuration adjustments.",source:"@site/docs/configuration/index.md",sourceDirName:"configuration",slug:"/configuration/",permalink:"/iot/configuration/",draft:!1,unlisted:!1,editUrl:"https://github.com/lobaro/iot/tree/master/docs/configuration/index.md",tags:[],version:"current",sidebarPosition:0,frontMatter:{sidebar_position:0},sidebar:"configurationSidebar",next:{title:"Lobaro USB Config Adapter",permalink:"/iot/configuration/usb-config-adapter"}},l={},d=[{value:"Different ways to configure",id:"different-ways-to-configure",level:2},{value:"Locally",id:"locally",level:3},{value:"Remotely",id:"remotely",level:3}];function g(e){const o={a:"a",admonition:"admonition",h1:"h1",h2:"h2",h3:"h3",p:"p",strong:"strong",...(0,a.R)(),...e.components},{Image:t}=o;return t||function(e,o){throw new Error("Expected "+(o?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Image",!0),(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(o.h1,{id:"introduction",children:"Introduction"}),"\n",(0,n.jsx)(o.p,{children:"Lobaro devices allow a wide range and flexible way of internal configuration adjustments.\nThese chapter generally describes our tools, common configuration parameters and workflows that are used in the same way\nfor many\nLobaro devices to adjust the used configuration."}),"\n",(0,n.jsx)(o.admonition,{title:"This is a general doc",type:"info",children:(0,n.jsxs)(o.p,{children:["Device and firmware ",(0,n.jsx)(o.strong,{children:"specific"})," parameters are explained in the respective product documentation."]})}),"\n",(0,n.jsx)(o.h2,{id:"different-ways-to-configure",children:"Different ways to configure"}),"\n",(0,n.jsx)(o.p,{children:"There are two ways of configuring our devices in existence. On the one hand locally where you need physical access to a\ndevice and on the other hand remotely over the air. For larger rollouts only remote updates of configuration showed to\nbe a feasible way to go."}),"\n",(0,n.jsx)(o.h3,{id:"locally",children:"Locally"}),"\n",(0,n.jsxs)(o.p,{children:["Any Lobaro device configuration can be set and read out locally via a PC with the ",(0,n.jsx)(o.a,{href:"./usb-config-adapter",children:"Lobaro configuration USB\nadapter"})," and the ",(0,n.jsx)(o.a,{href:"/iot/configuration/lobaro-tool/",children:"Lobaro Maintenance Tool"}),"."]}),"\n",(0,n.jsx)(t,{alt:"Lobaro Configuration Tool",img:i(9536),style:{width:"60%",paddingTop:"10px",paddingBottom:"10px"}}),"\n",(0,n.jsxs)(o.p,{children:["Some network related parameters, such as the APN of the mobile cellular network provider, ",(0,n.jsx)(o.strong,{children:"must"})," usually\nfirst be configured correctly locally before the device can get online for the first time."]}),"\n",(0,n.jsx)(o.h3,{id:"remotely",children:"Remotely"}),"\n",(0,n.jsx)(o.p,{children:"Once the device has connectivity the configuration can be changed remotely over the air using various methods, e.g. the Lobaro Cloud, MQTT or any LoRaWAN network server\nusing initiated special downlink communication:"}),"\n",(0,n.jsx)(t,{alt:"Lobaro Platform Configuration Tab",img:i(3046),style:{width:"60%",paddingTop:"10px",paddingBottom:"20px"}}),"\n",(0,n.jsx)(o.admonition,{title:"Bigger Rollouts",type:"info",children:(0,n.jsx)(o.p,{children:"For larger orders, a customer specific configuration agreed upon can\nalso be installed by Lobaro during production provisioning. This way manual reconfiguration from the firmware defaults\ncan be avoided before installing the devices in the field and over the air configuration will work out of the box."})})]})}function c(e={}){const{wrapper:o}={...(0,a.R)(),...e.components};return o?(0,n.jsx)(o,{...e,children:(0,n.jsx)(g,{...e})}):g(e)}},8453:(e,o,i)=>{"use strict";i.d(o,{R:()=>r,x:()=>s});var n=i(6540);const a={},t=n.createContext(a);function r(e){const o=n.useContext(t);return n.useMemo((function(){return"function"==typeof e?e(o):{...o,...e}}),[o,e])}function s(e){let o;return o=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:r(e.components),n.createElement(t.Provider,{value:o},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/main.5093ece0.js b/assets/js/main.5093ece0.js new file mode 100644 index 00000000..54bc4ca5 --- /dev/null +++ b/assets/js/main.5093ece0.js @@ -0,0 +1,2 @@ +/*! For license information please see main.5093ece0.js.LICENSE.txt */ +(self.webpackChunklobaro_docs=self.webpackChunklobaro_docs||[]).push([[8792],{2413:(e,t,n)=>{"use strict";n.d(t,{A:()=>p});n(6540);var r=n(3259),a=n.n(r),o=n(4054);const i={"01233d77":[()=>n.e(804).then(n.bind(n,6460)),"@site/docs/cloud/platform/index.md",6460],"055ec3b1":[()=>n.e(9233).then(n.bind(n,3306)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index.md",3306],"0b02251e":[()=>n.e(3830).then(n.t.bind(n,5570,19)),"@generated/docusaurus-plugin-content-docs/default/p/iot-6a9.json",5570],"1034e1fe":[()=>n.e(136).then(n.bind(n,8882)),"@site/docs/configuration/cron-configuration.md",8882],"13593b98":[()=>n.e(7213).then(n.bind(n,5518)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index.md",5518],17896441:[()=>Promise.all([n.e(1869),n.e(6949),n.e(8401)]).then(n.bind(n,7138)),"@theme/DocItem",7138],"1c619603":[()=>n.e(2582).then(n.bind(n,8847)),"@site/docs/products/sensor-gateways/current-loop/index.md",8847],"1d947975":[()=>n.e(5171).then(n.bind(n,4177)),"@site/docs/products/metering-gateways/wireless-mbus-g3/index.md",4177],"1f391b9e":[()=>Promise.all([n.e(1869),n.e(6949),n.e(6061)]).then(n.bind(n,7591)),"@theme/MDXPage",7591],"21e5f94e":[()=>n.e(7820).then(n.bind(n,1325)),"@site/docs/products/sensor-gateways/level/index.md",1325],"242bce50":[()=>n.e(8238).then(n.bind(n,1407)),"@site/docs/products/metering-gateways/wireless-mbus-g2/manual/cfg.md",1407],26827644:[()=>n.e(6042).then(n.bind(n,6656)),"@site/docs/products/metering-gateways/wired-mbus-g1/index.md",6656],"27118f4d":[()=>n.e(5946).then(n.bind(n,9519)),"@site/docs/knowledge-base/wireless-mbus.md",9519],"2a77de52":[()=>n.e(6082).then(n.bind(n,1132)),"@site/docs/firmware/index.md",1132],"2fe986c2":[()=>n.e(564).then(n.bind(n,4853)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index.md",4853],"337e0e25":[()=>n.e(7191).then(n.bind(n,6995)),"@site/docs/cloud/direct+/index.md",6995],"36a327fc":[()=>n.e(1104).then(n.bind(n,5836)),"@site/docs/firmware/app-nrf9160-wmbus/index.md",5836],"393be207":[()=>n.e(4134).then(n.bind(n,633)),"@site/src/pages/markdown-page.md",633],"3be75a1f":[()=>n.e(7607).then(n.bind(n,7690)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc.md",7690],"42b10abd":[()=>n.e(5277).then(n.bind(n,8697)),"@site/docs/products/metering-gateways/wired-mbus-g1/manual/cfg.md",8697],"49425f7e":[()=>n.e(7237).then(n.bind(n,662)),"@site/docs/configuration/lobaro-tool/index.md",662],"4ddd2498":[()=>n.e(1110).then(n.bind(n,587)),"@site/docs/configuration/lorawan-downlink-config.md",587],"5a4e9d38":[()=>n.e(7154).then(n.bind(n,7035)),"@site/docs/products/sensor-gateways/modbus/index.md",7035],"5bdce6a8":[()=>n.e(1979).then(n.bind(n,3308)),"@site/docs/knowledge-base/doc-playground/index.md",3308],"5e95c892":[()=>n.e(9647).then(n.bind(n,3124)),"@theme/DocsRoot",3124],"697ac668":[()=>n.e(1381).then(n.bind(n,1327)),"@site/docs/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index.md",1327],"6be0cd09":[()=>n.e(5792).then(n.bind(n,5434)),"@site/docs/hardware/mainboards/index.md",5434],"701ba69e":[()=>n.e(1876).then(n.bind(n,2387)),"@site/docs/products/metering-gateways/wireless-mbus-g3/manual/workflow.md",2387],"72346f2a":[()=>n.e(8034).then(n.bind(n,6507)),"@site/docs/products/metering-gateways/wired-mbus-g1/manual/index.md",6507],"74c9afa6":[()=>n.e(9010).then(n.bind(n,1204)),"@site/docs/products/metering-gateways/wireless-mbus-g2/manual/workflow.md",1204],75439747:[()=>n.e(8027).then(n.bind(n,8141)),"@site/docs/hardware/index.md",8141],"754583dd":[()=>n.e(5633).then(n.bind(n,7173)),"@site/docs/products/index.md",7173],"7eb7d3d5":[()=>n.e(4752).then(n.bind(n,5152)),"@site/docs/products/sensor-gateways/index.md",5152],83120900:[()=>n.e(6052).then(n.bind(n,2667)),"@site/docs/hardware/extension-modules/index.md",2667],"91ae8846":[()=>n.e(189).then(n.bind(n,4355)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/index.md",4355],"963797ee":[()=>n.e(5534).then(n.bind(n,3390)),"@site/docs/cloud/index.md",3390],"9be4ba06":[()=>n.e(4900).then(n.bind(n,8e3)),"@site/docs/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index.md",8e3],a2e35eca:[()=>n.e(8592).then(n.bind(n,3356)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index.md",3356],a5b914f3:[()=>n.e(7244).then(n.bind(n,2608)),"@site/docs/configuration/usb-config-adapter.md",2608],a7456010:[()=>n.e(1235).then(n.t.bind(n,8552,19)),"@generated/docusaurus-plugin-content-pages/default/__plugin.json",8552],a7bd4aaa:[()=>n.e(7098).then(n.bind(n,2881)),"@theme/DocVersionRoot",2881],a94703ab:[()=>Promise.all([n.e(1869),n.e(9048)]).then(n.bind(n,4644)),"@theme/DocRoot",4644],aba21aa0:[()=>n.e(5742).then(n.t.bind(n,7093,19)),"@generated/docusaurus-plugin-content-docs/default/__plugin.json",7093],abd6da72:[()=>n.e(3694).then(n.bind(n,1155)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index.md",1155],acb1f41f:[()=>n.e(731).then(n.bind(n,3233)),"@site/docs/products/sensor-gateways/temperature/index.md",3233],b39b0327:[()=>n.e(1617).then(n.bind(n,5470)),"@site/docs/hardware/housings/index.md",5470],b5423acd:[()=>n.e(7451).then(n.bind(n,1442)),"@site/docs/products/metering-gateways/wired-mbus-g1/manual/workflow.md",1442],bd96cf98:[()=>n.e(6588).then(n.bind(n,2979)),"@site/docs/products/metering-gateways/index.md",2979],c377a04b:[()=>n.e(3361).then(n.bind(n,1776)),"@site/docs/index.md",1776],d9226a6c:[()=>n.e(2400).then(n.bind(n,6530)),"@site/docs/products/metering-gateways/wireless-mbus-g2/index.md",6530],db471313:[()=>n.e(8474).then(n.bind(n,8436)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index.md",8436],dcd34b43:[()=>n.e(7022).then(n.bind(n,2374)),"@site/docs/firmware/app-hybrid-modbus/index.md",2374],dfeebc90:[()=>n.e(8442).then(n.bind(n,6175)),"@site/docs/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/index.md",6175],e091b4aa:[()=>n.e(482).then(n.bind(n,6453)),"@site/docs/knowledge-base/modbus.md",6453],e6b8ea22:[()=>n.e(7986).then(n.bind(n,3977)),"@site/docs/products/metering-gateways/wireless-mbus-g2/manual/index.md",3977],eb5375eb:[()=>n.e(727).then(n.bind(n,3200)),"@site/docs/products/metering-gateways/wireless-mbus-g3/manual/index.md",3200],f6d78023:[()=>n.e(4545).then(n.bind(n,5117)),"@site/docs/configuration/index.md",5117],fe17bb44:[()=>n.e(9444).then(n.bind(n,3290)),"@site/docs/products/metering-gateways/wireless-mbus-g3/manual/cfg.md",3290]};var s=n(4848);function l(e){let{error:t,retry:n,pastDelay:r}=e;return t?(0,s.jsxs)("div",{style:{textAlign:"center",color:"#fff",backgroundColor:"#fa383e",borderColor:"#fa383e",borderStyle:"solid",borderRadius:"0.25rem",borderWidth:"1px",boxSizing:"border-box",display:"block",padding:"1rem",flex:"0 0 50%",marginLeft:"25%",marginRight:"25%",marginTop:"5rem",maxWidth:"50%",width:"100%"},children:[(0,s.jsx)("p",{children:String(t)}),(0,s.jsx)("div",{children:(0,s.jsx)("button",{type:"button",onClick:n,children:"Retry"})})]}):r?(0,s.jsx)("div",{style:{display:"flex",justifyContent:"center",alignItems:"center",height:"100vh"},children:(0,s.jsx)("svg",{id:"loader",style:{width:128,height:110,position:"absolute",top:"calc(100vh - 64%)"},viewBox:"0 0 45 45",xmlns:"http://www.w3.org/2000/svg",stroke:"#61dafb",children:(0,s.jsxs)("g",{fill:"none",fillRule:"evenodd",transform:"translate(1 1)",strokeWidth:"2",children:[(0,s.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,s.jsx)("animate",{attributeName:"r",begin:"1.5s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,s.jsx)("animate",{attributeName:"stroke-opacity",begin:"1.5s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,s.jsx)("animate",{attributeName:"stroke-width",begin:"1.5s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,s.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,s.jsx)("animate",{attributeName:"r",begin:"3s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,s.jsx)("animate",{attributeName:"stroke-opacity",begin:"3s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,s.jsx)("animate",{attributeName:"stroke-width",begin:"3s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,s.jsx)("circle",{cx:"22",cy:"22",r:"8",children:(0,s.jsx)("animate",{attributeName:"r",begin:"0s",dur:"1.5s",values:"6;1;2;3;4;5;6",calcMode:"linear",repeatCount:"indefinite"})})]})})}):null}var u=n(1604),c=n(3363);function d(e,t){if("*"===e)return a()({loading:l,loader:()=>n.e(2560).then(n.bind(n,2560)),modules:["@theme/NotFound"],webpack:()=>[2560],render(e,t){const n=e.default;return(0,s.jsx)(c.W,{value:{plugin:{name:"native",id:"default"}},children:(0,s.jsx)(n,{...t})})}});const r=o[`${e}-${t}`],d={},p=[],f=[],g=(0,u.A)(r);return Object.entries(g).forEach((e=>{let[t,n]=e;const r=i[n];r&&(d[t]=r[0],p.push(r[1]),f.push(r[2]))})),a().Map({loading:l,loader:d,modules:p,webpack:()=>f,render(t,n){const a=JSON.parse(JSON.stringify(r));Object.entries(t).forEach((t=>{let[n,r]=t;const o=r.default;if(!o)throw new Error(`The page component at ${e} doesn't have a default export. This makes it impossible to render anything. Consider default-exporting a React component.`);"object"!=typeof o&&"function"!=typeof o||Object.keys(r).filter((e=>"default"!==e)).forEach((e=>{o[e]=r[e]}));let i=a;const s=n.split(".");s.slice(0,-1).forEach((e=>{i=i[e]})),i[s[s.length-1]]=o}));const o=a.__comp;delete a.__comp;const i=a.__context;delete a.__context;const l=a.__props;return delete a.__props,(0,s.jsx)(c.W,{value:i,children:(0,s.jsx)(o,{...a,...l,...n})})}})}const p=[{path:"/iot/markdown-page",component:d("/iot/markdown-page","bbd"),exact:!0},{path:"/iot/",component:d("/iot/","57a"),routes:[{path:"/iot/",component:d("/iot/","49e"),routes:[{path:"/iot/",component:d("/iot/","34a"),routes:[{path:"/iot/cloud/",component:d("/iot/cloud/","660"),exact:!0,sidebar:"cloudSidebar"},{path:"/iot/cloud/direct+/",component:d("/iot/cloud/direct+/","3a8"),exact:!0,sidebar:"cloudSidebar"},{path:"/iot/cloud/platform/",component:d("/iot/cloud/platform/","927"),exact:!0,sidebar:"cloudSidebar"},{path:"/iot/configuration/",component:d("/iot/configuration/","11e"),exact:!0,sidebar:"configurationSidebar"},{path:"/iot/configuration/cron-configuration",component:d("/iot/configuration/cron-configuration","5ce"),exact:!0,sidebar:"configurationSidebar"},{path:"/iot/configuration/lobaro-tool/",component:d("/iot/configuration/lobaro-tool/","e5f"),exact:!0,sidebar:"configurationSidebar"},{path:"/iot/configuration/lorawan-downlink-config",component:d("/iot/configuration/lorawan-downlink-config","aca"),exact:!0,sidebar:"configurationSidebar"},{path:"/iot/configuration/usb-config-adapter",component:d("/iot/configuration/usb-config-adapter","397"),exact:!0,sidebar:"configurationSidebar"},{path:"/iot/firmware/",component:d("/iot/firmware/","54a"),exact:!0,sidebar:"firmwareSidebar"},{path:"/iot/firmware/app-hybrid-modbus/",component:d("/iot/firmware/app-hybrid-modbus/","83c"),exact:!0,sidebar:"firmwareSidebar"},{path:"/iot/firmware/app-nrf9160-wmbus/",component:d("/iot/firmware/app-nrf9160-wmbus/","e3c"),exact:!0,sidebar:"firmwareSidebar"},{path:"/iot/hardware/",component:d("/iot/hardware/","9ae"),exact:!0,sidebar:"hardwareSidebar"},{path:"/iot/hardware/extension-modules/",component:d("/iot/hardware/extension-modules/","e0e"),exact:!0,sidebar:"hardwareSidebar"},{path:"/iot/hardware/housings/",component:d("/iot/hardware/housings/","3d1"),exact:!0,sidebar:"hardwareSidebar"},{path:"/iot/hardware/mainboards/",component:d("/iot/hardware/mainboards/","2a3"),exact:!0,sidebar:"hardwareSidebar"},{path:"/iot/knowledge-base/doc-playground/",component:d("/iot/knowledge-base/doc-playground/","0e6"),exact:!0,sidebar:"knowledgeBaseSidebar"},{path:"/iot/knowledge-base/modbus",component:d("/iot/knowledge-base/modbus","b9c"),exact:!0,sidebar:"knowledgeBaseSidebar"},{path:"/iot/knowledge-base/wireless-mbus",component:d("/iot/knowledge-base/wireless-mbus","a10"),exact:!0,sidebar:"knowledgeBaseSidebar"},{path:"/iot/products/",component:d("/iot/products/","eda"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/",component:d("/iot/products/metering-gateways/","99e"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wired-mbus-g1/",component:d("/iot/products/metering-gateways/wired-mbus-g1/","b23"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/",component:d("/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/","485"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wired-mbus-g1/manual/",component:d("/iot/products/metering-gateways/wired-mbus-g1/manual/","179"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wired-mbus-g1/manual/cfg",component:d("/iot/products/metering-gateways/wired-mbus-g1/manual/cfg","f9d"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wired-mbus-g1/manual/workflow",component:d("/iot/products/metering-gateways/wired-mbus-g1/manual/workflow","956"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g2/",component:d("/iot/products/metering-gateways/wireless-mbus-g2/","8f9"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/",component:d("/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/","9c8"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g2/manual/",component:d("/iot/products/metering-gateways/wireless-mbus-g2/manual/","a39"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg",component:d("/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg","42a"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow",component:d("/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow","8c9"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/","1ab"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/","b41"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/","233"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/","e2d"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/","010"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/","50b"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/","733"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/","dc3"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","495"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/","8bb"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/manual/",component:d("/iot/products/metering-gateways/wireless-mbus-g3/manual/","f22"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg",component:d("/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg","713"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow",component:d("/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow","5bf"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/sensor-gateways/",component:d("/iot/products/sensor-gateways/","b5a"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/sensor-gateways/current-loop/",component:d("/iot/products/sensor-gateways/current-loop/","f74"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/sensor-gateways/level/",component:d("/iot/products/sensor-gateways/level/","301"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/sensor-gateways/modbus/",component:d("/iot/products/sensor-gateways/modbus/","b18"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/products/sensor-gateways/temperature/",component:d("/iot/products/sensor-gateways/temperature/","f95"),exact:!0,sidebar:"productsSidebar"},{path:"/iot/",component:d("/iot/","dcd"),exact:!0,sidebar:"allDocSidebar"}]}]}]},{path:"*",component:d("*")}]},8848:(e,t,n)=>{"use strict";n.d(t,{o:()=>o,x:()=>i});var r=n(6540),a=n(4848);const o=r.createContext(!1);function i(e){let{children:t}=e;const[n,i]=(0,r.useState)(!1);return(0,r.useEffect)((()=>{i(!0)}),[]),(0,a.jsx)(o.Provider,{value:n,children:t})}},5022:(e,t,n)=>{"use strict";var r=n(6540),a=n(5338),o=n(545),i=n(4625),s=n(4784),l=n(1712);const u=[n(5300),n(4753),n(5729),n(8252)];var c=n(2413),d=n(6347),p=n(2831),f=n(4848);function g(e){let{children:t}=e;return(0,f.jsx)(f.Fragment,{children:t})}var m=n(1141),h=n(7639),b=n(8180),y=n(6957),v=n(9817),w=n(2098),k=n(9503),x=n(1482),S=n(4609),E=n(1210);function _(){const{i18n:{currentLocale:e,defaultLocale:t,localeConfigs:n}}=(0,h.A)(),r=(0,w.o)(),a=n[e].htmlLang,o=e=>e.replace("-","_");return(0,f.jsxs)(m.A,{children:[Object.entries(n).map((e=>{let[t,{htmlLang:n}]=e;return(0,f.jsx)("link",{rel:"alternate",href:r.createUrl({locale:t,fullyQualified:!0}),hrefLang:n},t)})),(0,f.jsx)("link",{rel:"alternate",href:r.createUrl({locale:t,fullyQualified:!0}),hrefLang:"x-default"}),(0,f.jsx)("meta",{property:"og:locale",content:o(a)}),Object.values(n).filter((e=>a!==e.htmlLang)).map((e=>(0,f.jsx)("meta",{property:"og:locale:alternate",content:o(e.htmlLang)},`meta-og-${e.htmlLang}`)))]})}function C(e){let{permalink:t}=e;const{siteConfig:{url:n}}=(0,h.A)(),r=function(){const{siteConfig:{url:e,baseUrl:t,trailingSlash:n}}=(0,h.A)(),{pathname:r}=(0,d.zy)();return e+(0,S.applyTrailingSlash)((0,b.Ay)(r),{trailingSlash:n,baseUrl:t})}(),a=t?`${n}${t}`:r;return(0,f.jsxs)(m.A,{children:[(0,f.jsx)("meta",{property:"og:url",content:a}),(0,f.jsx)("link",{rel:"canonical",href:a})]})}function A(){const{i18n:{currentLocale:e}}=(0,h.A)(),{metadata:t,image:n}=(0,y.p)();return(0,f.jsxs)(f.Fragment,{children:[(0,f.jsxs)(m.A,{children:[(0,f.jsx)("meta",{name:"twitter:card",content:"summary_large_image"}),(0,f.jsx)("body",{className:k.w})]}),n&&(0,f.jsx)(v.be,{image:n}),(0,f.jsx)(C,{}),(0,f.jsx)(_,{}),(0,f.jsx)(E.A,{tag:x.Cy,locale:e}),(0,f.jsx)(m.A,{children:t.map(((e,t)=>(0,f.jsx)("meta",{...e},t)))})]})}const T=new Map;var N=n(8848),L=n(3366),O=n(6494);function P(e){for(var t=arguments.length,n=new Array(t>1?t-1:0),r=1;r{const r=t.default?.[e]??t[e];return r?.(...n)}));return()=>a.forEach((e=>e?.()))}const j=function(e){let{children:t,location:n,previousLocation:r}=e;return(0,O.A)((()=>{r!==n&&(!function(e){let{location:t,previousLocation:n}=e;if(!n)return;const r=t.pathname===n.pathname,a=t.hash===n.hash,o=t.search===n.search;if(r&&a&&!o)return;const{hash:i}=t;if(i){const e=decodeURIComponent(i.substring(1)),t=document.getElementById(e);t?.scrollIntoView()}else window.scrollTo(0,0)}({location:n,previousLocation:r}),P("onRouteDidUpdate",{previousLocation:r,location:n}))}),[r,n]),t};function R(e){const t=Array.from(new Set([e,decodeURI(e)])).map((e=>(0,p.u)(c.A,e))).flat();return Promise.all(t.map((e=>e.route.component.preload?.())))}class I extends r.Component{previousLocation;routeUpdateCleanupCb;constructor(e){super(e),this.previousLocation=null,this.routeUpdateCleanupCb=l.A.canUseDOM?P("onRouteUpdate",{previousLocation:null,location:this.props.location}):()=>{},this.state={nextRouteHasLoaded:!0}}shouldComponentUpdate(e,t){if(e.location===this.props.location)return t.nextRouteHasLoaded;const n=e.location;return this.previousLocation=this.props.location,this.setState({nextRouteHasLoaded:!1}),this.routeUpdateCleanupCb=P("onRouteUpdate",{previousLocation:this.previousLocation,location:n}),R(n.pathname).then((()=>{this.routeUpdateCleanupCb(),this.setState({nextRouteHasLoaded:!0})})).catch((e=>{console.warn(e),window.location.reload()})),!1}render(){const{children:e,location:t}=this.props;return(0,f.jsx)(j,{previousLocation:this.previousLocation,location:t,children:(0,f.jsx)(d.qh,{location:t,render:()=>e})})}}const D=I,F="__docusaurus-base-url-issue-banner-container",M="__docusaurus-base-url-issue-banner",z="__docusaurus-base-url-issue-banner-suggestion-container";function B(e){return`\ndocument.addEventListener('DOMContentLoaded', function maybeInsertBanner() {\n var shouldInsert = typeof window['docusaurus'] === 'undefined';\n shouldInsert && insertBanner();\n});\n\nfunction insertBanner() {\n var bannerContainer = document.createElement('div');\n bannerContainer.id = '${F}';\n var bannerHtml = ${JSON.stringify(function(e){return`\n
\n

Your Docusaurus site did not load properly.

\n

A very common reason is a wrong site baseUrl configuration.

\n

Current configured baseUrl = ${e} ${"/"===e?" (default value)":""}

\n

We suggest trying baseUrl =

\n
\n`}(e)).replace(/{let{route:t}=e;return!0===t.exact})))return T.set(e.pathname,e.pathname),e;const t=e.pathname.trim().replace(/(?:\/index)?\.html$/,"")||"/";return T.set(e.pathname,t),{...e,pathname:t}}((0,d.zy)());return(0,f.jsx)(D,{location:e,children:q})}function K(){return(0,f.jsx)(V.A,{children:(0,f.jsx)(L.l,{children:(0,f.jsxs)(N.x,{children:[(0,f.jsxs)(g,{children:[(0,f.jsx)(H,{}),(0,f.jsx)(A,{}),(0,f.jsx)(U,{}),(0,f.jsx)(Y,{})]}),(0,f.jsx)(G,{})]})})})}var Q=n(4054);const Z=function(e){try{return document.createElement("link").relList.supports(e)}catch{return!1}}("prefetch")?function(e){return new Promise(((t,n)=>{if("undefined"==typeof document)return void n();const r=document.createElement("link");r.setAttribute("rel","prefetch"),r.setAttribute("href",e),r.onload=()=>t(),r.onerror=()=>n();const a=document.getElementsByTagName("head")[0]??document.getElementsByName("script")[0]?.parentNode;a?.appendChild(r)}))}:function(e){return new Promise(((t,n)=>{const r=new XMLHttpRequest;r.open("GET",e,!0),r.withCredentials=!0,r.onload=()=>{200===r.status?t():n()},r.send(null)}))};var X=n(1604);const J=new Set,ee=new Set,te=()=>navigator.connection?.effectiveType.includes("2g")||navigator.connection?.saveData,ne={prefetch:e=>{if(!(e=>!te()&&!ee.has(e)&&!J.has(e))(e))return!1;J.add(e);const t=(0,p.u)(c.A,e).flatMap((e=>{return t=e.route.path,Object.entries(Q).filter((e=>{let[n]=e;return n.replace(/-[^-]+$/,"")===t})).flatMap((e=>{let[,t]=e;return Object.values((0,X.A)(t))}));var t}));return Promise.all(t.map((e=>{const t=n.gca(e);return t&&!t.includes("undefined")?Z(t).catch((()=>{})):Promise.resolve()})))},preload:e=>!!(e=>!te()&&!ee.has(e))(e)&&(ee.add(e),R(e))},re=Object.freeze(ne);function ae(e){let{children:t}=e;return"hash"===s.A.future.experimental_router?(0,f.jsx)(i.I9,{children:t}):(0,f.jsx)(i.Kd,{children:t})}const oe=Boolean(!0);if(l.A.canUseDOM){window.docusaurus=re;const e=document.getElementById("__docusaurus"),t=(0,f.jsx)(o.vd,{children:(0,f.jsx)(ae,{children:(0,f.jsx)(K,{})})}),n=(e,t)=>{console.error("Docusaurus React Root onRecoverableError:",e,t)},i=()=>{if(window.docusaurusRoot)window.docusaurusRoot.render(t);else if(oe)window.docusaurusRoot=a.hydrateRoot(e,t,{onRecoverableError:n});else{const r=a.createRoot(e,{onRecoverableError:n});r.render(t),window.docusaurusRoot=r}};R(window.location.pathname).then((()=>{(0,r.startTransition)(i)}))}},3366:(e,t,n)=>{"use strict";n.d(t,{o:()=>d,l:()=>p});var r=n(6540),a=n(4784);const o=JSON.parse('{"docusaurus-plugin-content-docs":{"default":{"path":"/iot/","versions":[{"name":"current","label":"Next","isLast":true,"path":"/iot/","mainDocId":"index","docs":[{"id":"cloud/direct+/index","path":"/iot/cloud/direct+/","sidebar":"cloudSidebar"},{"id":"cloud/index","path":"/iot/cloud/","sidebar":"cloudSidebar"},{"id":"cloud/platform/index","path":"/iot/cloud/platform/","sidebar":"cloudSidebar"},{"id":"configuration/cron-configuration","path":"/iot/configuration/cron-configuration","sidebar":"configurationSidebar"},{"id":"configuration/index","path":"/iot/configuration/","sidebar":"configurationSidebar"},{"id":"configuration/lobaro-tool/index","path":"/iot/configuration/lobaro-tool/","sidebar":"configurationSidebar"},{"id":"configuration/lorawan-downlink-config","path":"/iot/configuration/lorawan-downlink-config","sidebar":"configurationSidebar"},{"id":"configuration/usb-config-adapter","path":"/iot/configuration/usb-config-adapter","sidebar":"configurationSidebar"},{"id":"firmware/app-hybrid-modbus/index","path":"/iot/firmware/app-hybrid-modbus/","sidebar":"firmwareSidebar"},{"id":"firmware/app-nrf9160-wmbus/index","path":"/iot/firmware/app-nrf9160-wmbus/","sidebar":"firmwareSidebar"},{"id":"firmware/index","path":"/iot/firmware/","sidebar":"firmwareSidebar"},{"id":"hardware/extension-modules/index","path":"/iot/hardware/extension-modules/","sidebar":"hardwareSidebar"},{"id":"hardware/housings/index","path":"/iot/hardware/housings/","sidebar":"hardwareSidebar"},{"id":"hardware/index","path":"/iot/hardware/","sidebar":"hardwareSidebar"},{"id":"hardware/mainboards/index","path":"/iot/hardware/mainboards/","sidebar":"hardwareSidebar"},{"id":"index","path":"/iot/","sidebar":"allDocSidebar"},{"id":"knowledge-base/doc-playground/index","path":"/iot/knowledge-base/doc-playground/","sidebar":"knowledgeBaseSidebar"},{"id":"knowledge-base/modbus","path":"/iot/knowledge-base/modbus","sidebar":"knowledgeBaseSidebar"},{"id":"knowledge-base/wireless-mbus","path":"/iot/knowledge-base/wireless-mbus","sidebar":"knowledgeBaseSidebar"},{"id":"products/index","path":"/iot/products/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/index","path":"/iot/products/metering-gateways/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/index","path":"/iot/products/metering-gateways/wired-mbus-g1/hardware-variants/dinrail-v1/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wired-mbus-g1/index","path":"/iot/products/metering-gateways/wired-mbus-g1/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wired-mbus-g1/manual/cfg","path":"/iot/products/metering-gateways/wired-mbus-g1/manual/cfg","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wired-mbus-g1/manual/index","path":"/iot/products/metering-gateways/wired-mbus-g1/manual/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wired-mbus-g1/manual/workflow","path":"/iot/products/metering-gateways/wired-mbus-g1/manual/workflow","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/index","path":"/iot/products/metering-gateways/wireless-mbus-g2/hardware-variants/bridge-v2/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g2/index","path":"/iot/products/metering-gateways/wireless-mbus-g2/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g2/manual/cfg","path":"/iot/products/metering-gateways/wireless-mbus-g2/manual/cfg","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g2/manual/index","path":"/iot/products/metering-gateways/wireless-mbus-g2/manual/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g2/manual/workflow","path":"/iot/products/metering-gateways/wireless-mbus-g2/manual/workflow","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/concentrator-v1/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/dinrail-v1/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/bridge-v2/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/gw-v2/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/discontinued/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v3/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/desc","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/gw-v4/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/hardware-variants/sun-v1/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/manual/cfg","path":"/iot/products/metering-gateways/wireless-mbus-g3/manual/cfg","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/manual/index","path":"/iot/products/metering-gateways/wireless-mbus-g3/manual/","sidebar":"productsSidebar"},{"id":"products/metering-gateways/wireless-mbus-g3/manual/workflow","path":"/iot/products/metering-gateways/wireless-mbus-g3/manual/workflow","sidebar":"productsSidebar"},{"id":"products/sensor-gateways/current-loop/index","path":"/iot/products/sensor-gateways/current-loop/","sidebar":"productsSidebar"},{"id":"products/sensor-gateways/index","path":"/iot/products/sensor-gateways/","sidebar":"productsSidebar"},{"id":"products/sensor-gateways/level/index","path":"/iot/products/sensor-gateways/level/","sidebar":"productsSidebar"},{"id":"products/sensor-gateways/modbus/index","path":"/iot/products/sensor-gateways/modbus/","sidebar":"productsSidebar"},{"id":"products/sensor-gateways/temperature/index","path":"/iot/products/sensor-gateways/temperature/","sidebar":"productsSidebar"}],"draftIds":[],"sidebars":{"htmlSidebar":{},"allDocSidebar":{"link":{"path":"/iot/","label":"index"}},"productsSidebar":{"link":{"path":"/iot/products/","label":"products/index"}},"configurationSidebar":{"link":{"path":"/iot/configuration/","label":"configuration/index"}},"firmwareSidebar":{"link":{"path":"/iot/firmware/","label":"firmware/index"}},"hardwareSidebar":{"link":{"path":"/iot/hardware/","label":"hardware/index"}},"cloudSidebar":{"link":{"path":"/iot/cloud/","label":"cloud/index"}},"knowledgeBaseSidebar":{"link":{"path":"/iot/knowledge-base/modbus","label":"knowledge-base/modbus"}}}}],"breadcrumbs":true}}}'),i=JSON.parse('{"defaultLocale":"en","locales":["en"],"path":"i18n","currentLocale":"en","localeConfigs":{"en":{"label":"English","direction":"ltr","htmlLang":"en","calendar":"gregory","path":"en"}}}');var s=n(2654);const l=JSON.parse('{"docusaurusVersion":"3.4.0","siteVersion":"0.0.0","pluginVersions":{"docusaurus-plugin-content-docs":{"type":"package","name":"@docusaurus/plugin-content-docs","version":"3.4.0"},"docusaurus-plugin-content-pages":{"type":"package","name":"@docusaurus/plugin-content-pages","version":"3.4.0"},"docusaurus-plugin-sitemap":{"type":"package","name":"@docusaurus/plugin-sitemap","version":"3.4.0"},"docusaurus-theme-classic":{"type":"package","name":"@docusaurus/theme-classic","version":"3.4.0"},"docusaurus-plugin-ideal-image":{"type":"package","name":"@docusaurus/plugin-ideal-image","version":"3.4.0"}}}');var u=n(4848);const c={siteConfig:a.A,siteMetadata:l,globalData:o,i18n:i,codeTranslations:s},d=r.createContext(c);function p(e){let{children:t}=e;return(0,u.jsx)(d.Provider,{value:c,children:t})}},3832:(e,t,n)=>{"use strict";n.d(t,{A:()=>m});var r=n(6540),a=n(1712),o=n(1141),i=n(4609),s=n(3844),l=n(3363),u=n(4848);function c(e){let{error:t,tryAgain:n}=e;return(0,u.jsxs)("div",{style:{display:"flex",flexDirection:"column",justifyContent:"center",alignItems:"flex-start",minHeight:"100vh",width:"100%",maxWidth:"80ch",fontSize:"20px",margin:"0 auto",padding:"1rem"},children:[(0,u.jsx)("h1",{style:{fontSize:"3rem"},children:"This page crashed"}),(0,u.jsx)("button",{type:"button",onClick:n,style:{margin:"1rem 0",fontSize:"2rem",cursor:"pointer",borderRadius:20,padding:"1rem"},children:"Try again"}),(0,u.jsx)(d,{error:t})]})}function d(e){let{error:t}=e;const n=(0,i.getErrorCausalChain)(t).map((e=>e.message)).join("\n\nCause:\n");return(0,u.jsx)("p",{style:{whiteSpace:"pre-wrap"},children:n})}function p(e){let{children:t}=e;return(0,u.jsx)(l.W,{value:{plugin:{name:"docusaurus-core-error-boundary",id:"default"}},children:t})}function f(e){let{error:t,tryAgain:n}=e;return(0,u.jsx)(p,{children:(0,u.jsxs)(m,{fallback:()=>(0,u.jsx)(c,{error:t,tryAgain:n}),children:[(0,u.jsx)(o.A,{children:(0,u.jsx)("title",{children:"Page Error"})}),(0,u.jsx)(s.A,{children:(0,u.jsx)(c,{error:t,tryAgain:n})})]})})}const g=e=>(0,u.jsx)(f,{...e});class m extends r.Component{constructor(e){super(e),this.state={error:null}}componentDidCatch(e){a.A.canUseDOM&&this.setState({error:e})}render(){const{children:e}=this.props,{error:t}=this.state;if(t){const e={error:t,tryAgain:()=>this.setState({error:null})};return(this.props.fallback??g)(e)}return e??null}}},1712:(e,t,n)=>{"use strict";n.d(t,{A:()=>a});const r="undefined"!=typeof window&&"document"in window&&"createElement"in window.document,a={canUseDOM:r,canUseEventListeners:r&&("addEventListener"in window||"attachEvent"in window),canUseIntersectionObserver:r&&"IntersectionObserver"in window,canUseViewport:r&&"screen"in window}},1141:(e,t,n)=>{"use strict";n.d(t,{A:()=>o});n(6540);var r=n(545),a=n(4848);function o(e){return(0,a.jsx)(r.mg,{...e})}},4783:(e,t,n)=>{"use strict";n.d(t,{A:()=>f});var r=n(6540),a=n(4625),o=n(4609),i=n(7639),s=n(877),l=n(1712),u=n(7344),c=n(8180),d=n(4848);function p(e,t){let{isNavLink:n,to:p,href:f,activeClassName:g,isActive:m,"data-noBrokenLinkCheck":h,autoAddBaseUrl:b=!0,...y}=e;const{siteConfig:v}=(0,i.A)(),{trailingSlash:w,baseUrl:k}=v,x=v.future.experimental_router,{withBaseUrl:S}=(0,c.hH)(),E=(0,u.A)(),_=(0,r.useRef)(null);(0,r.useImperativeHandle)(t,(()=>_.current));const C=p||f;const A=(0,s.A)(C),T=C?.replace("pathname://","");let N=void 0!==T?(L=T,b&&(e=>e.startsWith("/"))(L)?S(L):L):void 0;var L;"hash"===x&&N?.startsWith("./")&&(N=N?.slice(1)),N&&A&&(N=(0,o.applyTrailingSlash)(N,{trailingSlash:w,baseUrl:k}));const O=(0,r.useRef)(!1),P=n?a.k2:a.N_,j=l.A.canUseIntersectionObserver,R=(0,r.useRef)(),I=()=>{O.current||null==N||(window.docusaurus.preload(N),O.current=!0)};(0,r.useEffect)((()=>(!j&&A&&null!=N&&window.docusaurus.prefetch(N),()=>{j&&R.current&&R.current.disconnect()})),[R,N,j,A]);const D=N?.startsWith("#")??!1,F=!y.target||"_self"===y.target,M=!N||!A||!F;return h||!D&&M||E.collectLink(N),y.id&&E.collectAnchor(y.id),M?(0,d.jsx)("a",{ref:_,href:N,...C&&!A&&{target:"_blank",rel:"noopener noreferrer"},...y}):(0,d.jsx)(P,{...y,onMouseEnter:I,onTouchStart:I,innerRef:e=>{_.current=e,j&&e&&A&&(R.current=new window.IntersectionObserver((t=>{t.forEach((t=>{e===t.target&&(t.isIntersecting||t.intersectionRatio>0)&&(R.current.unobserve(e),R.current.disconnect(),null!=N&&window.docusaurus.prefetch(N))}))})),R.current.observe(e))},to:N,...n&&{isActive:m,activeClassName:g}})}const f=r.forwardRef(p)},9175:(e,t,n)=>{"use strict";n.d(t,{A:()=>r});const r=()=>null},3230:(e,t,n)=>{"use strict";n.d(t,{A:()=>u,T:()=>l});var r=n(6540),a=n(4848);function o(e,t){const n=e.split(/(\{\w+\})/).map(((e,n)=>{if(n%2==1){const n=t?.[e.slice(1,-1)];if(void 0!==n)return n}return e}));return n.some((e=>(0,r.isValidElement)(e)))?n.map(((e,t)=>(0,r.isValidElement)(e)?r.cloneElement(e,{key:t}):e)).filter((e=>""!==e)):n.join("")}var i=n(2654);function s(e){let{id:t,message:n}=e;if(void 0===t&&void 0===n)throw new Error("Docusaurus translation declarations must have at least a translation id or a default translation message");return i[t??n]??n??t}function l(e,t){let{message:n,id:r}=e;return o(s({message:n,id:r}),t)}function u(e){let{children:t,id:n,values:r}=e;if(t&&"string"!=typeof t)throw console.warn("Illegal children",t),new Error("The Docusaurus component only accept simple string values");const i=s({message:t,id:n});return(0,a.jsx)(a.Fragment,{children:o(i,r)})}},4598:(e,t,n)=>{"use strict";n.d(t,{W:()=>r});const r="default"},877:(e,t,n)=>{"use strict";function r(e){return/^(?:\w*:|\/\/)/.test(e)}function a(e){return void 0!==e&&!r(e)}n.d(t,{A:()=>a,z:()=>r})},8180:(e,t,n)=>{"use strict";n.d(t,{Ay:()=>s,hH:()=>i});var r=n(6540),a=n(7639),o=n(877);function i(){const{siteConfig:e}=(0,a.A)(),{baseUrl:t,url:n}=e,i=e.future.experimental_router,s=(0,r.useCallback)(((e,r)=>function(e){let{siteUrl:t,baseUrl:n,url:r,options:{forcePrependBaseUrl:a=!1,absolute:i=!1}={},router:s}=e;if(!r||r.startsWith("#")||(0,o.z)(r))return r;if("hash"===s)return r.startsWith("/")?`.${r}`:`./${r}`;if(a)return n+r.replace(/^\//,"");if(r===n.replace(/\/$/,""))return n;const l=r.startsWith(n)?r:n+r.replace(/^\//,"");return i?t+l:l}({siteUrl:n,baseUrl:t,url:e,options:r,router:i})),[n,t,i]);return{withBaseUrl:s}}function s(e,t){void 0===t&&(t={});const{withBaseUrl:n}=i();return n(e,t)}},7344:(e,t,n)=>{"use strict";n.d(t,{A:()=>i});var r=n(6540);n(4848);const a=r.createContext({collectAnchor:()=>{},collectLink:()=>{}}),o=()=>(0,r.useContext)(a);function i(){return o()}},7639:(e,t,n)=>{"use strict";n.d(t,{A:()=>o});var r=n(6540),a=n(3366);function o(){return(0,r.useContext)(a.o)}},1062:(e,t,n)=>{"use strict";n.d(t,{A:()=>o});var r=n(6540),a=n(8848);function o(){return(0,r.useContext)(a.o)}},6494:(e,t,n)=>{"use strict";n.d(t,{A:()=>a});var r=n(6540);const a=n(1712).A.canUseDOM?r.useLayoutEffect:r.useEffect},1604:(e,t,n)=>{"use strict";n.d(t,{A:()=>a});const r=e=>"object"==typeof e&&!!e&&Object.keys(e).length>0;function a(e){const t={};return function e(n,a){Object.entries(n).forEach((n=>{let[o,i]=n;const s=a?`${a}.${o}`:o;r(i)?e(i,s):t[s]=i}))}(e),t}},3363:(e,t,n)=>{"use strict";n.d(t,{W:()=>i,o:()=>o});var r=n(6540),a=n(4848);const o=r.createContext(null);function i(e){let{children:t,value:n}=e;const i=r.useContext(o),s=(0,r.useMemo)((()=>function(e){let{parent:t,value:n}=e;if(!t){if(!n)throw new Error("Unexpected: no Docusaurus route context found");if(!("plugin"in n))throw new Error("Unexpected: Docusaurus topmost route context has no `plugin` attribute");return n}const r={...t.data,...n?.data};return{plugin:t.plugin,data:r}}({parent:i,value:n})),[i,n]);return(0,a.jsx)(o.Provider,{value:s,children:t})}},4721:(e,t,n)=>{"use strict";n.d(t,{zK:()=>m,vT:()=>p,Gy:()=>c,HW:()=>h,ht:()=>d,r7:()=>g,jh:()=>f});var r=n(6347),a=n(7639),o=n(4598);function i(e,t){void 0===t&&(t={});const n=function(){const{globalData:e}=(0,a.A)();return e}()[e];if(!n&&t.failfast)throw new Error(`Docusaurus plugin global data not found for "${e}" plugin.`);return n}const s=e=>e.versions.find((e=>e.isLast));function l(e,t){const n=function(e,t){const n=s(e);return[...e.versions.filter((e=>e!==n)),n].find((e=>!!(0,r.B6)(t,{path:e.path,exact:!1,strict:!1})))}(e,t),a=n?.docs.find((e=>!!(0,r.B6)(t,{path:e.path,exact:!0,strict:!1})));return{activeVersion:n,activeDoc:a,alternateDocVersions:a?function(t){const n={};return e.versions.forEach((e=>{e.docs.forEach((r=>{r.id===t&&(n[e.name]=r)}))})),n}(a.id):{}}}const u={},c=()=>i("docusaurus-plugin-content-docs")??u,d=e=>{try{return function(e,t,n){void 0===t&&(t=o.W),void 0===n&&(n={});const r=i(e),a=r?.[t];if(!a&&n.failfast)throw new Error(`Docusaurus plugin global data not found for "${e}" plugin with id "${t}".`);return a}("docusaurus-plugin-content-docs",e,{failfast:!0})}catch(t){throw new Error("You are using a feature of the Docusaurus docs plugin, but this plugin does not seem to be enabled"+("Default"===e?"":` (pluginId=${e}`),{cause:t})}};function p(e){void 0===e&&(e={});const t=c(),{pathname:n}=(0,r.zy)();return function(e,t,n){void 0===n&&(n={});const a=Object.entries(e).sort(((e,t)=>t[1].path.localeCompare(e[1].path))).find((e=>{let[,n]=e;return!!(0,r.B6)(t,{path:n.path,exact:!1,strict:!1})})),o=a?{pluginId:a[0],pluginData:a[1]}:void 0;if(!o&&n.failfast)throw new Error(`Can't find active docs plugin for "${t}" pathname, while it was expected to be found. Maybe you tried to use a docs feature that can only be used on a docs-related page? Existing docs plugin paths are: ${Object.values(e).map((e=>e.path)).join(", ")}`);return o}(t,n,e)}function f(e){return d(e).versions}function g(e){const t=d(e);return s(t)}function m(e){const t=d(e),{pathname:n}=(0,r.zy)();return l(t,n)}function h(e){const t=d(e),{pathname:n}=(0,r.zy)();return function(e,t){const n=s(e);return{latestDocSuggestion:l(e,t).alternateDocVersions[n.name],latestVersionSuggestion:n}}(t,n)}},5729:(e,t,n)=>{"use strict";n.r(t),n.d(t,{default:()=>o});var r=n(5947),a=n.n(r);a().configure({showSpinner:!1});const o={onRouteUpdate(e){let{location:t,previousLocation:n}=e;if(n&&t.pathname!==n.pathname){const e=window.setTimeout((()=>{a().start()}),200);return()=>window.clearTimeout(e)}},onRouteDidUpdate(){a().done()}}},4753:(e,t,n)=>{"use strict";n.r(t);var r=n(1765),a=n(4784);!function(e){const{themeConfig:{prism:t}}=a.A,{additionalLanguages:r}=t;globalThis.Prism=e,r.forEach((e=>{"php"===e&&n(9700),n(2318)(`./prism-${e}`)})),delete globalThis.Prism}(r.My)},5225:(e,t,n)=>{"use strict";n.d(t,{A:()=>c});n(6540);var r=n(4164),a=n(3230),o=n(6957),i=n(4783),s=n(7344);const l={anchorWithStickyNavbar:"anchorWithStickyNavbar_LWe7",anchorWithHideOnScrollNavbar:"anchorWithHideOnScrollNavbar_WYt5"};var u=n(4848);function c(e){let{as:t,id:n,...c}=e;const d=(0,s.A)(),{navbar:{hideOnScroll:p}}=(0,o.p)();if("h1"===t||!n)return(0,u.jsx)(t,{...c,id:void 0});d.collectAnchor(n);const f=(0,a.T)({id:"theme.common.headingLinkTitle",message:"Direct link to {heading}",description:"Title for link to heading"},{heading:"string"==typeof c.children?c.children:n});return(0,u.jsxs)(t,{...c,className:(0,r.A)("anchor",p?l.anchorWithHideOnScrollNavbar:l.anchorWithStickyNavbar,c.className),id:n,children:[c.children,(0,u.jsx)(i.A,{className:"hash-link",to:`#${n}`,"aria-label":f,title:f,children:"\u200b"})]})}},716:(e,t,n)=>{"use strict";n.d(t,{A:()=>o});n(6540);const r={iconExternalLink:"iconExternalLink_nPIU"};var a=n(4848);function o(e){let{width:t=13.5,height:n=13.5}=e;return(0,a.jsx)("svg",{width:t,height:n,"aria-hidden":"true",viewBox:"0 0 24 24",className:r.iconExternalLink,children:(0,a.jsx)("path",{fill:"currentColor",d:"M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"})})}},3844:(e,t,n)=>{"use strict";n.d(t,{A:()=>ft});var r=n(6540),a=n(4164),o=n(3832),i=n(9817),s=n(6347),l=n(3230),u=n(4067),c=n(4848);const d="__docusaurus_skipToContent_fallback";function p(e){e.setAttribute("tabindex","-1"),e.focus(),e.removeAttribute("tabindex")}function f(){const e=(0,r.useRef)(null),{action:t}=(0,s.W6)(),n=(0,r.useCallback)((e=>{e.preventDefault();const t=document.querySelector("main:first-of-type")??document.getElementById(d);t&&p(t)}),[]);return(0,u.$)((n=>{let{location:r}=n;e.current&&!r.hash&&"PUSH"===t&&p(e.current)})),{containerRef:e,onClick:n}}const g=(0,l.T)({id:"theme.common.skipToMainContent",description:"The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation",message:"Skip to main content"});function m(e){const t=e.children??g,{containerRef:n,onClick:r}=f();return(0,c.jsx)("div",{ref:n,role:"region","aria-label":g,children:(0,c.jsx)("a",{...e,href:`#${d}`,onClick:r,children:t})})}var h=n(8630),b=n(9503);const y={skipToContent:"skipToContent_fXgn"};function v(){return(0,c.jsx)(m,{className:y.skipToContent})}var w=n(6957),k=n(2);function x(e){let{width:t=21,height:n=21,color:r="currentColor",strokeWidth:a=1.2,className:o,...i}=e;return(0,c.jsx)("svg",{viewBox:"0 0 15 15",width:t,height:n,...i,children:(0,c.jsx)("g",{stroke:r,strokeWidth:a,children:(0,c.jsx)("path",{d:"M.75.75l13.5 13.5M14.25.75L.75 14.25"})})})}const S={closeButton:"closeButton_CVFx"};function E(e){return(0,c.jsx)("button",{type:"button","aria-label":(0,l.T)({id:"theme.AnnouncementBar.closeButtonAriaLabel",message:"Close",description:"The ARIA label for close button of announcement bar"}),...e,className:(0,a.A)("clean-btn close",S.closeButton,e.className),children:(0,c.jsx)(x,{width:14,height:14,strokeWidth:3.1})})}const _={content:"content_knG7"};function C(e){const{announcementBar:t}=(0,w.p)(),{content:n}=t;return(0,c.jsx)("div",{...e,className:(0,a.A)(_.content,e.className),dangerouslySetInnerHTML:{__html:n}})}const A={announcementBar:"announcementBar_mb4j",announcementBarPlaceholder:"announcementBarPlaceholder_vyr4",announcementBarClose:"announcementBarClose_gvF7",announcementBarContent:"announcementBarContent_xLdY"};function T(){const{announcementBar:e}=(0,w.p)(),{isActive:t,close:n}=(0,k.M)();if(!t)return null;const{backgroundColor:r,textColor:a,isCloseable:o}=e;return(0,c.jsxs)("div",{className:A.announcementBar,style:{backgroundColor:r,color:a},role:"banner",children:[o&&(0,c.jsx)("div",{className:A.announcementBarPlaceholder}),(0,c.jsx)(C,{className:A.announcementBarContent}),o&&(0,c.jsx)(E,{onClick:n,className:A.announcementBarClose})]})}var N=n(1938),L=n(4245);var O=n(4799),P=n(763);const j=r.createContext(null);function R(e){let{children:t}=e;const n=function(){const e=(0,N.M)(),t=(0,P.YL)(),[n,a]=(0,r.useState)(!1),o=null!==t.component,i=(0,O.ZC)(o);return(0,r.useEffect)((()=>{o&&!i&&a(!0)}),[o,i]),(0,r.useEffect)((()=>{o?e.shown||a(!0):a(!1)}),[e.shown,o]),(0,r.useMemo)((()=>[n,a]),[n])}();return(0,c.jsx)(j.Provider,{value:n,children:t})}function I(e){if(e.component){const t=e.component;return(0,c.jsx)(t,{...e.props})}}function D(){const e=(0,r.useContext)(j);if(!e)throw new O.dV("NavbarSecondaryMenuDisplayProvider");const[t,n]=e,a=(0,r.useCallback)((()=>n(!1)),[n]),o=(0,P.YL)();return(0,r.useMemo)((()=>({shown:t,hide:a,content:I(o)})),[a,o,t])}function F(e){let{header:t,primaryMenu:n,secondaryMenu:r}=e;const{shown:o}=D();return(0,c.jsxs)("div",{className:"navbar-sidebar",children:[t,(0,c.jsxs)("div",{className:(0,a.A)("navbar-sidebar__items",{"navbar-sidebar__items--show-secondary":o}),children:[(0,c.jsx)("div",{className:"navbar-sidebar__item menu",children:n}),(0,c.jsx)("div",{className:"navbar-sidebar__item menu",children:r})]})]})}var M=n(7710),z=n(1062);function B(e){return(0,c.jsx)("svg",{viewBox:"0 0 24 24",width:24,height:24,...e,children:(0,c.jsx)("path",{fill:"currentColor",d:"M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"})})}function $(e){return(0,c.jsx)("svg",{viewBox:"0 0 24 24",width:24,height:24,...e,children:(0,c.jsx)("path",{fill:"currentColor",d:"M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"})})}const U={toggle:"toggle_vylO",toggleButton:"toggleButton_gllP",darkToggleIcon:"darkToggleIcon_wfgR",lightToggleIcon:"lightToggleIcon_pyhR",toggleButtonDisabled:"toggleButtonDisabled_aARS"};function H(e){let{className:t,buttonClassName:n,value:r,onChange:o}=e;const i=(0,z.A)(),s=(0,l.T)({message:"Switch between dark and light mode (currently {mode})",id:"theme.colorToggle.ariaLabel",description:"The ARIA label for the navbar color mode toggle"},{mode:"dark"===r?(0,l.T)({message:"dark mode",id:"theme.colorToggle.ariaLabel.mode.dark",description:"The name for the dark color mode"}):(0,l.T)({message:"light mode",id:"theme.colorToggle.ariaLabel.mode.light",description:"The name for the light color mode"})});return(0,c.jsx)("div",{className:(0,a.A)(U.toggle,t),children:(0,c.jsxs)("button",{className:(0,a.A)("clean-btn",U.toggleButton,!i&&U.toggleButtonDisabled,n),type:"button",onClick:()=>o("dark"===r?"light":"dark"),disabled:!i,title:s,"aria-label":s,"aria-live":"polite",children:[(0,c.jsx)(B,{className:(0,a.A)(U.toggleIcon,U.lightToggleIcon)}),(0,c.jsx)($,{className:(0,a.A)(U.toggleIcon,U.darkToggleIcon)})]})})}const V=r.memo(H),W={darkNavbarColorModeToggle:"darkNavbarColorModeToggle_X3D1"};function G(e){let{className:t}=e;const n=(0,w.p)().navbar.style,r=(0,w.p)().colorMode.disableSwitch,{colorMode:a,setColorMode:o}=(0,M.G)();return r?null:(0,c.jsx)(V,{className:t,buttonClassName:"dark"===n?W.darkNavbarColorModeToggle:void 0,value:a,onChange:o})}var q=n(20);function Y(){return(0,c.jsx)(q.A,{className:"navbar__brand",imageClassName:"navbar__logo",titleClassName:"navbar__title text--truncate"})}function K(){const e=(0,N.M)();return(0,c.jsx)("button",{type:"button","aria-label":(0,l.T)({id:"theme.docs.sidebar.closeSidebarButtonAriaLabel",message:"Close navigation bar",description:"The ARIA label for close button of mobile sidebar"}),className:"clean-btn navbar-sidebar__close",onClick:()=>e.toggle(),children:(0,c.jsx)(x,{color:"var(--ifm-color-emphasis-600)"})})}function Q(){return(0,c.jsxs)("div",{className:"navbar-sidebar__brand",children:[(0,c.jsx)(Y,{}),(0,c.jsx)(G,{className:"margin-right--md"}),(0,c.jsx)(K,{})]})}var Z=n(4783),X=n(8180),J=n(877);function ee(e,t){return void 0!==e&&void 0!==t&&new RegExp(e,"gi").test(t)}var te=n(716);function ne(e){let{activeBasePath:t,activeBaseRegex:n,to:r,href:a,label:o,html:i,isDropdownLink:s,prependBaseUrlToHref:l,...u}=e;const d=(0,X.Ay)(r),p=(0,X.Ay)(t),f=(0,X.Ay)(a,{forcePrependBaseUrl:!0}),g=o&&a&&!(0,J.A)(a),m=i?{dangerouslySetInnerHTML:{__html:i}}:{children:(0,c.jsxs)(c.Fragment,{children:[o,g&&(0,c.jsx)(te.A,{...s&&{width:12,height:12}})]})};return a?(0,c.jsx)(Z.A,{href:l?f:a,...u,...m}):(0,c.jsx)(Z.A,{to:d,isNavLink:!0,...(t||n)&&{isActive:(e,t)=>n?ee(n,t.pathname):t.pathname.startsWith(p)},...u,...m})}function re(e){let{className:t,isDropdownItem:n=!1,...r}=e;const o=(0,c.jsx)(ne,{className:(0,a.A)(n?"dropdown__link":"navbar__item navbar__link",t),isDropdownLink:n,...r});return n?(0,c.jsx)("li",{children:o}):o}function ae(e){let{className:t,isDropdownItem:n,...r}=e;return(0,c.jsx)("li",{className:"menu__list-item",children:(0,c.jsx)(ne,{className:(0,a.A)("menu__link",t),...r})})}function oe(e){let{mobile:t=!1,position:n,...r}=e;const a=t?ae:re;return(0,c.jsx)(a,{...r,activeClassName:r.activeClassName??(t?"menu__link--active":"navbar__link--active")})}var ie=n(4549),se=n(260),le=n(7639);const ue={dropdownNavbarItemMobile:"dropdownNavbarItemMobile_S0Fm"};function ce(e,t){return e.some((e=>function(e,t){return!!(0,se.ys)(e.to,t)||!!ee(e.activeBaseRegex,t)||!(!e.activeBasePath||!t.startsWith(e.activeBasePath))}(e,t)))}function de(e){let{items:t,position:n,className:o,onClick:i,...s}=e;const l=(0,r.useRef)(null),[u,d]=(0,r.useState)(!1);return(0,r.useEffect)((()=>{const e=e=>{l.current&&!l.current.contains(e.target)&&d(!1)};return document.addEventListener("mousedown",e),document.addEventListener("touchstart",e),document.addEventListener("focusin",e),()=>{document.removeEventListener("mousedown",e),document.removeEventListener("touchstart",e),document.removeEventListener("focusin",e)}}),[l]),(0,c.jsxs)("div",{ref:l,className:(0,a.A)("navbar__item","dropdown","dropdown--hoverable",{"dropdown--right":"right"===n,"dropdown--show":u}),children:[(0,c.jsx)(ne,{"aria-haspopup":"true","aria-expanded":u,role:"button",href:s.to?void 0:"#",className:(0,a.A)("navbar__link",o),...s,onClick:s.to?void 0:e=>e.preventDefault(),onKeyDown:e=>{"Enter"===e.key&&(e.preventDefault(),d(!u))},children:s.children??s.label}),(0,c.jsx)("ul",{className:"dropdown__menu",children:t.map(((e,t)=>(0,r.createElement)(_e,{isDropdownItem:!0,activeClassName:"dropdown__link--active",...e,key:t})))})]})}function pe(e){let{items:t,className:n,position:o,onClick:i,...l}=e;const u=function(){const{siteConfig:{baseUrl:e}}=(0,le.A)(),{pathname:t}=(0,s.zy)();return t.replace(e,"/")}(),d=ce(t,u),{collapsed:p,toggleCollapsed:f,setCollapsed:g}=(0,ie.u)({initialState:()=>!d});return(0,r.useEffect)((()=>{d&&g(!d)}),[u,d,g]),(0,c.jsxs)("li",{className:(0,a.A)("menu__list-item",{"menu__list-item--collapsed":p}),children:[(0,c.jsx)(ne,{role:"button",className:(0,a.A)(ue.dropdownNavbarItemMobile,"menu__link menu__link--sublist menu__link--sublist-caret",n),...l,onClick:e=>{e.preventDefault(),f()},children:l.children??l.label}),(0,c.jsx)(ie.N,{lazy:!0,as:"ul",className:"menu__list",collapsed:p,children:t.map(((e,t)=>(0,r.createElement)(_e,{mobile:!0,isDropdownItem:!0,onClick:i,activeClassName:"menu__link--active",...e,key:t})))})]})}function fe(e){let{mobile:t=!1,...n}=e;const r=t?pe:de;return(0,c.jsx)(r,{...n})}var ge=n(2098);function me(e){let{width:t=20,height:n=20,...r}=e;return(0,c.jsx)("svg",{viewBox:"0 0 24 24",width:t,height:n,"aria-hidden":!0,...r,children:(0,c.jsx)("path",{fill:"currentColor",d:"M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"})})}const he="iconLanguage_nlXk";var be=n(9175);const ye={navbarSearchContainer:"navbarSearchContainer_Bca1"};function ve(e){let{children:t,className:n}=e;return(0,c.jsx)("div",{className:(0,a.A)(n,ye.navbarSearchContainer),children:t})}var we=n(4721),ke=n(5215);var xe=n(2780);const Se=e=>e.docs.find((t=>t.id===e.mainDocId));const Ee={default:oe,localeDropdown:function(e){let{mobile:t,dropdownItemsBefore:n,dropdownItemsAfter:r,queryString:a="",...o}=e;const{i18n:{currentLocale:i,locales:u,localeConfigs:d}}=(0,le.A)(),p=(0,ge.o)(),{search:f,hash:g}=(0,s.zy)(),m=[...n,...u.map((e=>{const n=`${`pathname://${p.createUrl({locale:e,fullyQualified:!1})}`}${f}${g}${a}`;return{label:d[e].label,lang:d[e].htmlLang,to:n,target:"_self",autoAddBaseUrl:!1,className:e===i?t?"menu__link--active":"dropdown__link--active":""}})),...r],h=t?(0,l.T)({message:"Languages",id:"theme.navbar.mobileLanguageDropdown.label",description:"The label for the mobile language switcher dropdown"}):d[i].label;return(0,c.jsx)(fe,{...o,mobile:t,label:(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(me,{className:he}),h]}),items:m})},search:function(e){let{mobile:t,className:n}=e;return t?null:(0,c.jsx)(ve,{className:n,children:(0,c.jsx)(be.A,{})})},dropdown:fe,html:function(e){let{value:t,className:n,mobile:r=!1,isDropdownItem:o=!1}=e;const i=o?"li":"div";return(0,c.jsx)(i,{className:(0,a.A)({navbar__item:!r&&!o,"menu__list-item":r},n),dangerouslySetInnerHTML:{__html:t}})},doc:function(e){let{docId:t,label:n,docsPluginId:r,...a}=e;const{activeDoc:o}=(0,we.zK)(r),i=(0,ke.QB)(t,r),s=o?.path===i?.path;return null===i||i.unlisted&&!s?null:(0,c.jsx)(oe,{exact:!0,...a,isActive:()=>s||!!o?.sidebar&&o.sidebar===i.sidebar,label:n??i.id,to:i.path})},docSidebar:function(e){let{sidebarId:t,label:n,docsPluginId:r,...a}=e;const{activeDoc:o}=(0,we.zK)(r),i=(0,ke.fW)(t,r).link;if(!i)throw new Error(`DocSidebarNavbarItem: Sidebar with ID "${t}" doesn't have anything to be linked to.`);return(0,c.jsx)(oe,{exact:!0,...a,isActive:()=>o?.sidebar===t,label:n??i.label,to:i.path})},docsVersion:function(e){let{label:t,to:n,docsPluginId:r,...a}=e;const o=(0,ke.Vd)(r)[0],i=t??o.label,s=n??(e=>e.docs.find((t=>t.id===e.mainDocId)))(o).path;return(0,c.jsx)(oe,{...a,label:i,to:s})},docsVersionDropdown:function(e){let{mobile:t,docsPluginId:n,dropdownActiveClassDisabled:r,dropdownItemsBefore:a,dropdownItemsAfter:o,...i}=e;const{search:u,hash:d}=(0,s.zy)(),p=(0,we.zK)(n),f=(0,we.jh)(n),{savePreferredVersionName:g}=(0,xe.g1)(n),m=[...a,...f.map((e=>{const t=p.alternateDocVersions[e.name]??Se(e);return{label:e.label,to:`${t.path}${u}${d}`,isActive:()=>e===p.activeVersion,onClick:()=>g(e.name)}})),...o],h=(0,ke.Vd)(n)[0],b=t&&m.length>1?(0,l.T)({id:"theme.navbar.mobileVersionsDropdown.label",message:"Versions",description:"The label for the navbar versions dropdown on mobile view"}):h.label,y=t&&m.length>1?void 0:Se(h).path;return m.length<=1?(0,c.jsx)(oe,{...i,mobile:t,label:b,to:y,isActive:r?()=>!1:void 0}):(0,c.jsx)(fe,{...i,mobile:t,label:b,to:y,items:m,isActive:r?()=>!1:void 0})}};function _e(e){let{type:t,...n}=e;const r=function(e,t){return e&&"default"!==e?e:"items"in t?"dropdown":"default"}(t,n),a=Ee[r];if(!a)throw new Error(`No NavbarItem component found for type "${t}".`);return(0,c.jsx)(a,{...n})}function Ce(){const e=(0,N.M)(),t=(0,w.p)().navbar.items;return(0,c.jsx)("ul",{className:"menu__list",children:t.map(((t,n)=>(0,r.createElement)(_e,{mobile:!0,...t,onClick:()=>e.toggle(),key:n})))})}function Ae(e){return(0,c.jsx)("button",{...e,type:"button",className:"clean-btn navbar-sidebar__back",children:(0,c.jsx)(l.A,{id:"theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel",description:"The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)",children:"\u2190 Back to main menu"})})}function Te(){const e=0===(0,w.p)().navbar.items.length,t=D();return(0,c.jsxs)(c.Fragment,{children:[!e&&(0,c.jsx)(Ae,{onClick:()=>t.hide()}),t.content]})}function Ne(){const e=(0,N.M)();var t;return void 0===(t=e.shown)&&(t=!0),(0,r.useEffect)((()=>(document.body.style.overflow=t?"hidden":"visible",()=>{document.body.style.overflow="visible"})),[t]),e.shouldRender?(0,c.jsx)(F,{header:(0,c.jsx)(Q,{}),primaryMenu:(0,c.jsx)(Ce,{}),secondaryMenu:(0,c.jsx)(Te,{})}):null}const Le={navbarHideable:"navbarHideable_m1mJ",navbarHidden:"navbarHidden_jGov"};function Oe(e){return(0,c.jsx)("div",{role:"presentation",...e,className:(0,a.A)("navbar-sidebar__backdrop",e.className)})}function Pe(e){let{children:t}=e;const{navbar:{hideOnScroll:n,style:o}}=(0,w.p)(),i=(0,N.M)(),{navbarRef:s,isNavbarVisible:d}=function(e){const[t,n]=(0,r.useState)(e),a=(0,r.useRef)(!1),o=(0,r.useRef)(0),i=(0,r.useCallback)((e=>{null!==e&&(o.current=e.getBoundingClientRect().height)}),[]);return(0,L.Mq)(((t,r)=>{let{scrollY:i}=t;if(!e)return;if(i=s?n(!1):i+u{if(!e)return;const r=t.location.hash;if(r?document.getElementById(r.substring(1)):void 0)return a.current=!0,void n(!1);n(!0)})),{navbarRef:i,isNavbarVisible:t}}(n);return(0,c.jsxs)("nav",{ref:s,"aria-label":(0,l.T)({id:"theme.NavBar.navAriaLabel",message:"Main",description:"The ARIA label for the main navigation"}),className:(0,a.A)("navbar","navbar--fixed-top",n&&[Le.navbarHideable,!d&&Le.navbarHidden],{"navbar--dark":"dark"===o,"navbar--primary":"primary"===o,"navbar-sidebar--show":i.shown}),children:[t,(0,c.jsx)(Oe,{onClick:i.toggle}),(0,c.jsx)(Ne,{})]})}var je=n(4609);const Re={errorBoundaryError:"errorBoundaryError_a6uf",errorBoundaryFallback:"errorBoundaryFallback_VBag"};function Ie(e){return(0,c.jsx)("button",{type:"button",...e,children:(0,c.jsx)(l.A,{id:"theme.ErrorPageContent.tryAgain",description:"The label of the button to try again rendering when the React error boundary captures an error",children:"Try again"})})}function De(e){let{error:t}=e;const n=(0,je.getErrorCausalChain)(t).map((e=>e.message)).join("\n\nCause:\n");return(0,c.jsx)("p",{className:Re.errorBoundaryError,children:n})}class Fe extends r.Component{componentDidCatch(e,t){throw this.props.onError(e,t)}render(){return this.props.children}}const Me="right";function ze(e){let{width:t=30,height:n=30,className:r,...a}=e;return(0,c.jsx)("svg",{className:r,width:t,height:n,viewBox:"0 0 30 30","aria-hidden":"true",...a,children:(0,c.jsx)("path",{stroke:"currentColor",strokeLinecap:"round",strokeMiterlimit:"10",strokeWidth:"2",d:"M4 7h22M4 15h22M4 23h22"})})}function Be(){const{toggle:e,shown:t}=(0,N.M)();return(0,c.jsx)("button",{onClick:e,"aria-label":(0,l.T)({id:"theme.docs.sidebar.toggleSidebarButtonAriaLabel",message:"Toggle navigation bar",description:"The ARIA label for hamburger menu button of mobile navigation"}),"aria-expanded":t,className:"navbar__toggle clean-btn",type:"button",children:(0,c.jsx)(ze,{})})}const $e={colorModeToggle:"colorModeToggle_DEke"};function Ue(e){let{items:t}=e;return(0,c.jsx)(c.Fragment,{children:t.map(((e,t)=>(0,c.jsx)(Fe,{onError:t=>new Error(`A theme navbar item failed to render.\nPlease double-check the following navbar item (themeConfig.navbar.items) of your Docusaurus config:\n${JSON.stringify(e,null,2)}`,{cause:t}),children:(0,c.jsx)(_e,{...e})},t)))})}function He(e){let{left:t,right:n}=e;return(0,c.jsxs)("div",{className:"navbar__inner",children:[(0,c.jsx)("div",{className:"navbar__items",children:t}),(0,c.jsx)("div",{className:"navbar__items navbar__items--right",children:n})]})}function Ve(){const e=(0,N.M)(),t=(0,w.p)().navbar.items,[n,r]=function(e){function t(e){return"left"===(e.position??Me)}return[e.filter(t),e.filter((e=>!t(e)))]}(t),a=t.find((e=>"search"===e.type));return(0,c.jsx)(He,{left:(0,c.jsxs)(c.Fragment,{children:[!e.disabled&&(0,c.jsx)(Be,{}),(0,c.jsx)(Y,{}),(0,c.jsx)(Ue,{items:n})]}),right:(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(Ue,{items:r}),(0,c.jsx)(G,{className:$e.colorModeToggle}),!a&&(0,c.jsx)(ve,{children:(0,c.jsx)(be.A,{})})]})})}function We(){return(0,c.jsx)(Pe,{children:(0,c.jsx)(Ve,{})})}function Ge(e){let{item:t}=e;const{to:n,href:r,label:a,prependBaseUrlToHref:o,...i}=t,s=(0,X.Ay)(n),l=(0,X.Ay)(r,{forcePrependBaseUrl:!0});return(0,c.jsxs)(Z.A,{className:"footer__link-item",...r?{href:o?l:r}:{to:s},...i,children:[a,r&&!(0,J.A)(r)&&(0,c.jsx)(te.A,{})]})}function qe(e){let{item:t}=e;return t.html?(0,c.jsx)("li",{className:"footer__item",dangerouslySetInnerHTML:{__html:t.html}}):(0,c.jsx)("li",{className:"footer__item",children:(0,c.jsx)(Ge,{item:t})},t.href??t.to)}function Ye(e){let{column:t}=e;return(0,c.jsxs)("div",{className:"col footer__col",children:[(0,c.jsx)("div",{className:"footer__title",children:t.title}),(0,c.jsx)("ul",{className:"footer__items clean-list",children:t.items.map(((e,t)=>(0,c.jsx)(qe,{item:e},t)))})]})}function Ke(e){let{columns:t}=e;return(0,c.jsx)("div",{className:"row footer__links",children:t.map(((e,t)=>(0,c.jsx)(Ye,{column:e},t)))})}function Qe(){return(0,c.jsx)("span",{className:"footer__link-separator",children:"\xb7"})}function Ze(e){let{item:t}=e;return t.html?(0,c.jsx)("span",{className:"footer__link-item",dangerouslySetInnerHTML:{__html:t.html}}):(0,c.jsx)(Ge,{item:t})}function Xe(e){let{links:t}=e;return(0,c.jsx)("div",{className:"footer__links text--center",children:(0,c.jsx)("div",{className:"footer__links",children:t.map(((e,n)=>(0,c.jsxs)(r.Fragment,{children:[(0,c.jsx)(Ze,{item:e}),t.length!==n+1&&(0,c.jsx)(Qe,{})]},n)))})})}function Je(e){let{links:t}=e;return function(e){return"title"in e[0]}(t)?(0,c.jsx)(Ke,{columns:t}):(0,c.jsx)(Xe,{links:t})}var et=n(975);const tt={footerLogoLink:"footerLogoLink_BH7S"};function nt(e){let{logo:t}=e;const{withBaseUrl:n}=(0,X.hH)(),r={light:n(t.src),dark:n(t.srcDark??t.src)};return(0,c.jsx)(et.A,{className:(0,a.A)("footer__logo",t.className),alt:t.alt,sources:r,width:t.width,height:t.height,style:t.style})}function rt(e){let{logo:t}=e;return t.href?(0,c.jsx)(Z.A,{href:t.href,className:tt.footerLogoLink,target:t.target,children:(0,c.jsx)(nt,{logo:t})}):(0,c.jsx)(nt,{logo:t})}function at(e){let{copyright:t}=e;return(0,c.jsx)("div",{className:"footer__copyright",dangerouslySetInnerHTML:{__html:t}})}function ot(e){let{style:t,links:n,logo:r,copyright:o}=e;return(0,c.jsx)("footer",{className:(0,a.A)("footer",{"footer--dark":"dark"===t}),children:(0,c.jsxs)("div",{className:"container container-fluid",children:[n,(r||o)&&(0,c.jsxs)("div",{className:"footer__bottom text--center",children:[r&&(0,c.jsx)("div",{className:"margin-bottom--sm",children:r}),o]})]})})}function it(){const{footer:e}=(0,w.p)();if(!e)return null;const{copyright:t,links:n,logo:r,style:a}=e;return(0,c.jsx)(ot,{style:a,links:n&&n.length>0&&(0,c.jsx)(Je,{links:n}),logo:r&&(0,c.jsx)(rt,{logo:r}),copyright:t&&(0,c.jsx)(at,{copyright:t})})}const st=r.memo(it),lt=(0,O.fM)([M.a,k.o,L.Tv,xe.VQ,i.Jx,function(e){let{children:t}=e;return(0,c.jsx)(P.y_,{children:(0,c.jsx)(N.e,{children:(0,c.jsx)(R,{children:t})})})}]);function ut(e){let{children:t}=e;return(0,c.jsx)(lt,{children:t})}var ct=n(5225);function dt(e){let{error:t,tryAgain:n}=e;return(0,c.jsx)("main",{className:"container margin-vert--xl",children:(0,c.jsx)("div",{className:"row",children:(0,c.jsxs)("div",{className:"col col--6 col--offset-3",children:[(0,c.jsx)(ct.A,{as:"h1",className:"hero__title",children:(0,c.jsx)(l.A,{id:"theme.ErrorPageContent.title",description:"The title of the fallback page when the page crashed",children:"This page crashed."})}),(0,c.jsx)("div",{className:"margin-vert--lg",children:(0,c.jsx)(Ie,{onClick:n,className:"button button--primary shadow--lw"})}),(0,c.jsx)("hr",{}),(0,c.jsx)("div",{className:"margin-vert--md",children:(0,c.jsx)(De,{error:t})})]})})})}const pt={mainWrapper:"mainWrapper_z2l0"};function ft(e){const{children:t,noFooter:n,wrapperClassName:r,title:s,description:l}=e;return(0,b.J)(),(0,c.jsxs)(ut,{children:[(0,c.jsx)(i.be,{title:s,description:l}),(0,c.jsx)(v,{}),(0,c.jsx)(T,{}),(0,c.jsx)(We,{}),(0,c.jsx)("div",{id:d,className:(0,a.A)(h.G.wrapper.main,pt.mainWrapper,r),children:(0,c.jsx)(o.A,{fallback:e=>(0,c.jsx)(dt,{...e}),children:t})}),!n&&(0,c.jsx)(st,{})]})}},20:(e,t,n)=>{"use strict";n.d(t,{A:()=>c});n(6540);var r=n(4783),a=n(8180),o=n(7639),i=n(6957),s=n(975),l=n(4848);function u(e){let{logo:t,alt:n,imageClassName:r}=e;const o={light:(0,a.Ay)(t.src),dark:(0,a.Ay)(t.srcDark||t.src)},i=(0,l.jsx)(s.A,{className:t.className,sources:o,height:t.height,width:t.width,alt:n,style:t.style});return r?(0,l.jsx)("div",{className:r,children:i}):i}function c(e){const{siteConfig:{title:t}}=(0,o.A)(),{navbar:{title:n,logo:s}}=(0,i.p)(),{imageClassName:c,titleClassName:d,...p}=e,f=(0,a.Ay)(s?.href||"/"),g=n?"":t,m=s?.alt??g;return(0,l.jsxs)(r.A,{to:f,...p,...s?.target&&{target:s.target},children:[s&&(0,l.jsx)(u,{logo:s,alt:m,imageClassName:c}),null!=n&&(0,l.jsx)("b",{className:d,children:n})]})}},1210:(e,t,n)=>{"use strict";n.d(t,{A:()=>o});n(6540);var r=n(1141),a=n(4848);function o(e){let{locale:t,version:n,tag:o}=e;const i=t;return(0,a.jsxs)(r.A,{children:[t&&(0,a.jsx)("meta",{name:"docusaurus_locale",content:t}),n&&(0,a.jsx)("meta",{name:"docusaurus_version",content:n}),o&&(0,a.jsx)("meta",{name:"docusaurus_tag",content:o}),i&&(0,a.jsx)("meta",{name:"docsearch:language",content:i}),n&&(0,a.jsx)("meta",{name:"docsearch:version",content:n}),o&&(0,a.jsx)("meta",{name:"docsearch:docusaurus_tag",content:o})]})}},975:(e,t,n)=>{"use strict";n.d(t,{A:()=>c});var r=n(6540),a=n(4164),o=n(1062),i=n(7710);const s={themedComponent:"themedComponent_mlkZ","themedComponent--light":"themedComponent--light_NVdE","themedComponent--dark":"themedComponent--dark_xIcU"};var l=n(4848);function u(e){let{className:t,children:n}=e;const u=(0,o.A)(),{colorMode:c}=(0,i.G)();return(0,l.jsx)(l.Fragment,{children:(u?"dark"===c?["dark"]:["light"]:["light","dark"]).map((e=>{const o=n({theme:e,className:(0,a.A)(t,s.themedComponent,s[`themedComponent--${e}`])});return(0,l.jsx)(r.Fragment,{children:o},e)}))})}function c(e){const{sources:t,className:n,alt:r,...a}=e;return(0,l.jsx)(u,{className:n,children:e=>{let{theme:n,className:o}=e;return(0,l.jsx)("img",{src:t[n],alt:r,className:o,...a})}})}},4549:(e,t,n)=>{"use strict";n.d(t,{N:()=>b,u:()=>u});var r=n(6540),a=n(1712),o=n(6494),i=n(6350),s=n(4848);const l="ease-in-out";function u(e){let{initialState:t}=e;const[n,a]=(0,r.useState)(t??!1),o=(0,r.useCallback)((()=>{a((e=>!e))}),[]);return{collapsed:n,setCollapsed:a,toggleCollapsed:o}}const c={display:"none",overflow:"hidden",height:"0px"},d={display:"block",overflow:"visible",height:"auto"};function p(e,t){const n=t?c:d;e.style.display=n.display,e.style.overflow=n.overflow,e.style.height=n.height}function f(e){let{collapsibleRef:t,collapsed:n,animation:a}=e;const o=(0,r.useRef)(!1);(0,r.useEffect)((()=>{const e=t.current;function r(){const t=e.scrollHeight,n=a?.duration??function(e){if((0,i.O)())return 1;const t=e/36;return Math.round(10*(4+15*t**.25+t/5))}(t);return{transition:`height ${n}ms ${a?.easing??l}`,height:`${t}px`}}function s(){const t=r();e.style.transition=t.transition,e.style.height=t.height}if(!o.current)return p(e,n),void(o.current=!0);return e.style.willChange="height",function(){const t=requestAnimationFrame((()=>{n?(s(),requestAnimationFrame((()=>{e.style.height=c.height,e.style.overflow=c.overflow}))):(e.style.display="block",requestAnimationFrame((()=>{s()})))}));return()=>cancelAnimationFrame(t)}()}),[t,n,a])}function g(e){if(!a.A.canUseDOM)return e?c:d}function m(e){let{as:t="div",collapsed:n,children:a,animation:o,onCollapseTransitionEnd:i,className:l,disableSSRStyle:u}=e;const c=(0,r.useRef)(null);return f({collapsibleRef:c,collapsed:n,animation:o}),(0,s.jsx)(t,{ref:c,style:u?void 0:g(n),onTransitionEnd:e=>{"height"===e.propertyName&&(p(c.current,n),i?.(n))},className:l,children:a})}function h(e){let{collapsed:t,...n}=e;const[a,i]=(0,r.useState)(!t),[l,u]=(0,r.useState)(t);return(0,o.A)((()=>{t||i(!0)}),[t]),(0,o.A)((()=>{a&&u(t)}),[a,t]),a?(0,s.jsx)(m,{...n,collapsed:l}):null}function b(e){let{lazy:t,...n}=e;const r=t?h:m;return(0,s.jsx)(r,{...n})}},2:(e,t,n)=>{"use strict";n.d(t,{M:()=>m,o:()=>g});var r=n(6540),a=n(1062),o=n(9900),i=n(4799),s=n(6957),l=n(4848);const u=(0,o.Wf)("docusaurus.announcement.dismiss"),c=(0,o.Wf)("docusaurus.announcement.id"),d=()=>"true"===u.get(),p=e=>u.set(String(e)),f=r.createContext(null);function g(e){let{children:t}=e;const n=function(){const{announcementBar:e}=(0,s.p)(),t=(0,a.A)(),[n,o]=(0,r.useState)((()=>!!t&&d()));(0,r.useEffect)((()=>{o(d())}),[]);const i=(0,r.useCallback)((()=>{p(!0),o(!0)}),[]);return(0,r.useEffect)((()=>{if(!e)return;const{id:t}=e;let n=c.get();"annoucement-bar"===n&&(n="announcement-bar");const r=t!==n;c.set(t),r&&p(!1),!r&&d()||o(!1)}),[e]),(0,r.useMemo)((()=>({isActive:!!e&&!n,close:i})),[e,n,i])}();return(0,l.jsx)(f.Provider,{value:n,children:t})}function m(){const e=(0,r.useContext)(f);if(!e)throw new i.dV("AnnouncementBarProvider");return e}},7710:(e,t,n)=>{"use strict";n.d(t,{G:()=>b,a:()=>h});var r=n(6540),a=n(1712),o=n(4799),i=n(9900),s=n(6957),l=n(4848);const u=r.createContext(void 0),c="theme",d=(0,i.Wf)(c),p={light:"light",dark:"dark"},f=e=>e===p.dark?p.dark:p.light,g=e=>a.A.canUseDOM?f(document.documentElement.getAttribute("data-theme")):f(e),m=e=>{d.set(f(e))};function h(e){let{children:t}=e;const n=function(){const{colorMode:{defaultMode:e,disableSwitch:t,respectPrefersColorScheme:n}}=(0,s.p)(),[a,o]=(0,r.useState)(g(e));(0,r.useEffect)((()=>{t&&d.del()}),[t]);const i=(0,r.useCallback)((function(t,r){void 0===r&&(r={});const{persist:a=!0}=r;t?(o(t),a&&m(t)):(o(n?window.matchMedia("(prefers-color-scheme: dark)").matches?p.dark:p.light:e),d.del())}),[n,e]);(0,r.useEffect)((()=>{document.documentElement.setAttribute("data-theme",f(a))}),[a]),(0,r.useEffect)((()=>{if(t)return;const e=e=>{if(e.key!==c)return;const t=d.get();null!==t&&i(f(t))};return window.addEventListener("storage",e),()=>window.removeEventListener("storage",e)}),[t,i]);const l=(0,r.useRef)(!1);return(0,r.useEffect)((()=>{if(t&&!n)return;const e=window.matchMedia("(prefers-color-scheme: dark)"),r=()=>{window.matchMedia("print").matches||l.current?l.current=window.matchMedia("print").matches:i(null)};return e.addListener(r),()=>e.removeListener(r)}),[i,t,n]),(0,r.useMemo)((()=>({colorMode:a,setColorMode:i,get isDarkTheme(){return a===p.dark},setLightTheme(){i(p.light)},setDarkTheme(){i(p.dark)}})),[a,i])}();return(0,l.jsx)(u.Provider,{value:n,children:t})}function b(){const e=(0,r.useContext)(u);if(null==e)throw new o.dV("ColorModeProvider","Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.");return e}},2780:(e,t,n)=>{"use strict";n.d(t,{VQ:()=>b,g1:()=>v});var r=n(6540),a=n(4721),o=n(4598),i=n(6957),s=n(5215),l=n(4799),u=n(9900),c=n(4848);const d=e=>`docs-preferred-version-${e}`,p={save:(e,t,n)=>{(0,u.Wf)(d(e),{persistence:t}).set(n)},read:(e,t)=>(0,u.Wf)(d(e),{persistence:t}).get(),clear:(e,t)=>{(0,u.Wf)(d(e),{persistence:t}).del()}},f=e=>Object.fromEntries(e.map((e=>[e,{preferredVersionName:null}])));const g=r.createContext(null);function m(){const e=(0,a.Gy)(),t=(0,i.p)().docs.versionPersistence,n=(0,r.useMemo)((()=>Object.keys(e)),[e]),[o,s]=(0,r.useState)((()=>f(n)));(0,r.useEffect)((()=>{s(function(e){let{pluginIds:t,versionPersistence:n,allDocsData:r}=e;function a(e){const t=p.read(e,n);return r[e].versions.some((e=>e.name===t))?{preferredVersionName:t}:(p.clear(e,n),{preferredVersionName:null})}return Object.fromEntries(t.map((e=>[e,a(e)])))}({allDocsData:e,versionPersistence:t,pluginIds:n}))}),[e,t,n]);return[o,(0,r.useMemo)((()=>({savePreferredVersion:function(e,n){p.save(e,t,n),s((t=>({...t,[e]:{preferredVersionName:n}})))}})),[t])]}function h(e){let{children:t}=e;const n=m();return(0,c.jsx)(g.Provider,{value:n,children:t})}function b(e){let{children:t}=e;return s.C5?(0,c.jsx)(h,{children:t}):(0,c.jsx)(c.Fragment,{children:t})}function y(){const e=(0,r.useContext)(g);if(!e)throw new l.dV("DocsPreferredVersionContextProvider");return e}function v(e){void 0===e&&(e=o.W);const t=(0,a.ht)(e),[n,i]=y(),{preferredVersionName:s}=n[e];return{preferredVersion:t.versions.find((e=>e.name===s))??null,savePreferredVersionName:(0,r.useCallback)((t=>{i.savePreferredVersion(e,t)}),[i,e])}}},403:(e,t,n)=>{"use strict";n.d(t,{V:()=>l,t:()=>u});var r=n(6540),a=n(4799),o=n(4848);const i=Symbol("EmptyContext"),s=r.createContext(i);function l(e){let{children:t,name:n,items:a}=e;const i=(0,r.useMemo)((()=>n&&a?{name:n,items:a}:null),[n,a]);return(0,o.jsx)(s.Provider,{value:i,children:t})}function u(){const e=(0,r.useContext)(s);if(e===i)throw new a.dV("DocsSidebarProvider");return e}},3403:(e,t,n)=>{"use strict";n.d(t,{n:()=>s,r:()=>l});var r=n(6540),a=n(4799),o=n(4848);const i=r.createContext(null);function s(e){let{children:t,version:n}=e;return(0,o.jsx)(i.Provider,{value:n,children:t})}function l(){const e=(0,r.useContext)(i);if(null===e)throw new a.dV("DocsVersionProvider");return e}},1938:(e,t,n)=>{"use strict";n.d(t,{M:()=>f,e:()=>p});var r=n(6540),a=n(763),o=n(2216),i=n(2814),s=n(6957),l=n(4799),u=n(4848);const c=r.createContext(void 0);function d(){const e=function(){const e=(0,a.YL)(),{items:t}=(0,s.p)().navbar;return 0===t.length&&!e.component}(),t=(0,o.l)(),n=!e&&"mobile"===t,[l,u]=(0,r.useState)(!1);(0,i.$Z)((()=>{if(l)return u(!1),!1}));const c=(0,r.useCallback)((()=>{u((e=>!e))}),[]);return(0,r.useEffect)((()=>{"desktop"===t&&u(!1)}),[t]),(0,r.useMemo)((()=>({disabled:e,shouldRender:n,toggle:c,shown:l})),[e,n,c,l])}function p(e){let{children:t}=e;const n=d();return(0,u.jsx)(c.Provider,{value:n,children:t})}function f(){const e=r.useContext(c);if(void 0===e)throw new l.dV("NavbarMobileSidebarProvider");return e}},763:(e,t,n)=>{"use strict";n.d(t,{GX:()=>u,YL:()=>l,y_:()=>s});var r=n(6540),a=n(4799),o=n(4848);const i=r.createContext(null);function s(e){let{children:t}=e;const n=(0,r.useState)({component:null,props:null});return(0,o.jsx)(i.Provider,{value:n,children:t})}function l(){const e=(0,r.useContext)(i);if(!e)throw new a.dV("NavbarSecondaryMenuContentProvider");return e[0]}function u(e){let{component:t,props:n}=e;const o=(0,r.useContext)(i);if(!o)throw new a.dV("NavbarSecondaryMenuContentProvider");const[,s]=o,l=(0,a.Be)(n);return(0,r.useEffect)((()=>{s({component:t,props:l})}),[s,t,l]),(0,r.useEffect)((()=>()=>s({component:null,props:null})),[s]),null}},9503:(e,t,n)=>{"use strict";n.d(t,{w:()=>a,J:()=>o});var r=n(6540);const a="navigation-with-keyboard";function o(){(0,r.useEffect)((()=>{function e(e){"keydown"===e.type&&"Tab"===e.key&&document.body.classList.add(a),"mousedown"===e.type&&document.body.classList.remove(a)}return document.addEventListener("keydown",e),document.addEventListener("mousedown",e),()=>{document.body.classList.remove(a),document.removeEventListener("keydown",e),document.removeEventListener("mousedown",e)}}),[])}},2216:(e,t,n)=>{"use strict";n.d(t,{l:()=>s});var r=n(6540),a=n(1712);const o={desktop:"desktop",mobile:"mobile",ssr:"ssr"},i=996;function s(e){let{desktopBreakpoint:t=i}=void 0===e?{}:e;const[n,s]=(0,r.useState)((()=>"ssr"));return(0,r.useEffect)((()=>{function e(){s(function(e){if(!a.A.canUseDOM)throw new Error("getWindowSize() should only be called after React hydration");return window.innerWidth>e?o.desktop:o.mobile}(t))}return e(),window.addEventListener("resize",e),()=>{window.removeEventListener("resize",e)}}),[t]),n}},8630:(e,t,n)=>{"use strict";n.d(t,{G:()=>r});const r={page:{blogListPage:"blog-list-page",blogPostPage:"blog-post-page",blogTagsListPage:"blog-tags-list-page",blogTagPostListPage:"blog-tags-post-list-page",docsDocPage:"docs-doc-page",docsTagsListPage:"docs-tags-list-page",docsTagDocListPage:"docs-tags-doc-list-page",mdxPage:"mdx-page"},wrapper:{main:"main-wrapper",blogPages:"blog-wrapper",docsPages:"docs-wrapper",mdxPages:"mdx-wrapper"},common:{editThisPage:"theme-edit-this-page",lastUpdated:"theme-last-updated",backToTopButton:"theme-back-to-top-button",codeBlock:"theme-code-block",admonition:"theme-admonition",unlistedBanner:"theme-unlisted-banner",admonitionType:e=>`theme-admonition-${e}`},layout:{},docs:{docVersionBanner:"theme-doc-version-banner",docVersionBadge:"theme-doc-version-badge",docBreadcrumbs:"theme-doc-breadcrumbs",docMarkdown:"theme-doc-markdown",docTocMobile:"theme-doc-toc-mobile",docTocDesktop:"theme-doc-toc-desktop",docFooter:"theme-doc-footer",docFooterTagsRow:"theme-doc-footer-tags-row",docFooterEditMetaRow:"theme-doc-footer-edit-meta-row",docSidebarContainer:"theme-doc-sidebar-container",docSidebarMenu:"theme-doc-sidebar-menu",docSidebarItemCategory:"theme-doc-sidebar-item-category",docSidebarItemLink:"theme-doc-sidebar-item-link",docSidebarItemCategoryLevel:e=>`theme-doc-sidebar-item-category-level-${e}`,docSidebarItemLinkLevel:e=>`theme-doc-sidebar-item-link-level-${e}`},blog:{blogFooterTagsRow:"theme-blog-footer-tags-row",blogFooterEditMetaRow:"theme-blog-footer-edit-meta-row"},pages:{pageFooterEditMetaRow:"theme-pages-footer-edit-meta-row"}}},6350:(e,t,n)=>{"use strict";function r(){return window.matchMedia("(prefers-reduced-motion: reduce)").matches}n.d(t,{O:()=>r})},5215:(e,t,n)=>{"use strict";n.d(t,{B5:()=>E,C5:()=>p,Nr:()=>f,OF:()=>w,QB:()=>S,Vd:()=>k,Y:()=>y,fW:()=>x,w8:()=>h});var r=n(6540),a=n(6347),o=n(2831),i=n(4721),s=n(2780),l=n(3403),u=n(403),c=n(5167),d=n(260);const p=!!i.Gy;function f(e){return"link"!==e.type||e.unlisted?"category"===e.type?function(e){if(e.href&&!e.linkUnlisted)return e.href;for(const t of e.items){const e=f(t);if(e)return e}}(e):void 0:e.href}const g=(e,t)=>void 0!==e&&(0,d.ys)(e,t),m=(e,t)=>e.some((e=>h(e,t)));function h(e,t){return"link"===e.type?g(e.href,t):"category"===e.type&&(g(e.href,t)||m(e.items,t))}function b(e,t){switch(e.type){case"category":return h(e,t)||e.items.some((e=>b(e,t)));case"link":return!e.unlisted||h(e,t);default:return!0}}function y(e,t){return(0,r.useMemo)((()=>e.filter((e=>b(e,t)))),[e,t])}function v(e){let{sidebarItems:t,pathname:n,onlyCategories:r=!1}=e;const a=[];return function e(t){for(const o of t)if("category"===o.type&&((0,d.ys)(o.href,n)||e(o.items))||"link"===o.type&&(0,d.ys)(o.href,n)){return r&&"category"!==o.type||a.unshift(o),!0}return!1}(t),a}function w(){const e=(0,u.t)(),{pathname:t}=(0,a.zy)(),n=(0,i.vT)()?.pluginData.breadcrumbs;return!1!==n&&e?v({sidebarItems:e.items,pathname:t}):null}function k(e){const{activeVersion:t}=(0,i.zK)(e),{preferredVersion:n}=(0,s.g1)(e),a=(0,i.r7)(e);return(0,r.useMemo)((()=>(0,c.s)([t,n,a].filter(Boolean))),[t,n,a])}function x(e,t){const n=k(t);return(0,r.useMemo)((()=>{const t=n.flatMap((e=>e.sidebars?Object.entries(e.sidebars):[])),r=t.find((t=>t[0]===e));if(!r)throw new Error(`Can't find any sidebar with id "${e}" in version${n.length>1?"s":""} ${n.map((e=>e.name)).join(", ")}".\nAvailable sidebar ids are:\n- ${t.map((e=>e[0])).join("\n- ")}`);return r[1]}),[e,n])}function S(e,t){const n=k(t);return(0,r.useMemo)((()=>{const t=n.flatMap((e=>e.docs)),r=t.find((t=>t.id===e));if(!r){if(n.flatMap((e=>e.draftIds)).includes(e))return null;throw new Error(`Couldn't find any doc with id "${e}" in version${n.length>1?"s":""} "${n.map((e=>e.name)).join(", ")}".\nAvailable doc ids are:\n- ${(0,c.s)(t.map((e=>e.id))).join("\n- ")}`)}return r}),[e,n])}function E(e){let{route:t}=e;const n=(0,a.zy)(),r=(0,l.r)(),i=t.routes,s=i.find((e=>(0,a.B6)(n.pathname,e)));if(!s)return null;const u=s.sidebar,c=u?r.docsSidebars[u]:void 0;return{docElement:(0,o.v)(i),sidebarName:u,sidebarItems:c}}},2814:(e,t,n)=>{"use strict";n.d(t,{$Z:()=>i,aZ:()=>l});var r=n(6540),a=n(6347),o=n(4799);function i(e){!function(e){const t=(0,a.W6)(),n=(0,o._q)(e);(0,r.useEffect)((()=>t.block(((e,t)=>n(e,t)))),[t,n])}(((t,n)=>{if("POP"===n)return e(t,n)}))}function s(e){const t=(0,a.W6)();return(0,r.useSyncExternalStore)(t.listen,(()=>e(t)),(()=>e(t)))}function l(e){return s((t=>null===e?null:new URLSearchParams(t.location.search).get(e)))}},5167:(e,t,n)=>{"use strict";function r(e,t){return void 0===t&&(t=(e,t)=>e===t),e.filter(((n,r)=>e.findIndex((e=>t(e,n)))!==r))}function a(e){return Array.from(new Set(e))}n.d(t,{X:()=>r,s:()=>a})},9817:(e,t,n)=>{"use strict";n.d(t,{e3:()=>f,be:()=>d,Jx:()=>g});var r=n(6540),a=n(4164),o=n(1141),i=n(3363);function s(){const e=r.useContext(i.o);if(!e)throw new Error("Unexpected: no Docusaurus route context found");return e}var l=n(8180),u=n(7639);var c=n(4848);function d(e){let{title:t,description:n,keywords:r,image:a,children:i}=e;const s=function(e){const{siteConfig:t}=(0,u.A)(),{title:n,titleDelimiter:r}=t;return e?.trim().length?`${e.trim()} ${r} ${n}`:n}(t),{withBaseUrl:d}=(0,l.hH)(),p=a?d(a,{absolute:!0}):void 0;return(0,c.jsxs)(o.A,{children:[t&&(0,c.jsx)("title",{children:s}),t&&(0,c.jsx)("meta",{property:"og:title",content:s}),n&&(0,c.jsx)("meta",{name:"description",content:n}),n&&(0,c.jsx)("meta",{property:"og:description",content:n}),r&&(0,c.jsx)("meta",{name:"keywords",content:Array.isArray(r)?r.join(","):r}),p&&(0,c.jsx)("meta",{property:"og:image",content:p}),p&&(0,c.jsx)("meta",{name:"twitter:image",content:p}),i]})}const p=r.createContext(void 0);function f(e){let{className:t,children:n}=e;const i=r.useContext(p),s=(0,a.A)(i,t);return(0,c.jsxs)(p.Provider,{value:s,children:[(0,c.jsx)(o.A,{children:(0,c.jsx)("html",{className:s})}),n]})}function g(e){let{children:t}=e;const n=s(),r=`plugin-${n.plugin.name.replace(/docusaurus-(?:plugin|theme)-(?:content-)?/gi,"")}`;const o=`plugin-id-${n.plugin.id}`;return(0,c.jsx)(f,{className:(0,a.A)(r,o),children:t})}},4799:(e,t,n)=>{"use strict";n.d(t,{Be:()=>u,ZC:()=>s,_q:()=>i,dV:()=>l,fM:()=>c});var r=n(6540),a=n(6494),o=n(4848);function i(e){const t=(0,r.useRef)(e);return(0,a.A)((()=>{t.current=e}),[e]),(0,r.useCallback)((function(){return t.current(...arguments)}),[])}function s(e){const t=(0,r.useRef)();return(0,a.A)((()=>{t.current=e})),t.current}class l extends Error{constructor(e,t){super(),this.name="ReactContextError",this.message=`Hook ${this.stack?.split("\n")[1]?.match(/at (?:\w+\.)?(?\w+)/)?.groups.name??""} is called outside the <${e}>. ${t??""}`}}function u(e){const t=Object.entries(e);return t.sort(((e,t)=>e[0].localeCompare(t[0]))),(0,r.useMemo)((()=>e),t.flat())}function c(e){return t=>{let{children:n}=t;return(0,o.jsx)(o.Fragment,{children:e.reduceRight(((e,t)=>(0,o.jsx)(t,{children:e})),n)})}}},260:(e,t,n)=>{"use strict";n.d(t,{Dt:()=>s,ys:()=>i});var r=n(6540),a=n(2413),o=n(7639);function i(e,t){const n=e=>(!e||e.endsWith("/")?e:`${e}/`)?.toLowerCase();return n(e)===n(t)}function s(){const{baseUrl:e}=(0,o.A)().siteConfig;return(0,r.useMemo)((()=>function(e){let{baseUrl:t,routes:n}=e;function r(e){return e.path===t&&!0===e.exact}function a(e){return e.path===t&&!e.exact}return function e(t){if(0===t.length)return;return t.find(r)||e(t.filter(a).flatMap((e=>e.routes??[])))}(n)}({routes:a.A,baseUrl:e})),[e])}},4245:(e,t,n)=>{"use strict";n.d(t,{Mq:()=>f,Tv:()=>c,a_:()=>g,gk:()=>m});var r=n(6540),a=n(1712),o=n(1062),i=n(6494),s=n(4799),l=n(4848);const u=r.createContext(void 0);function c(e){let{children:t}=e;const n=function(){const e=(0,r.useRef)(!0);return(0,r.useMemo)((()=>({scrollEventsEnabledRef:e,enableScrollEvents:()=>{e.current=!0},disableScrollEvents:()=>{e.current=!1}})),[])}();return(0,l.jsx)(u.Provider,{value:n,children:t})}function d(){const e=(0,r.useContext)(u);if(null==e)throw new s.dV("ScrollControllerProvider");return e}const p=()=>a.A.canUseDOM?{scrollX:window.pageXOffset,scrollY:window.pageYOffset}:null;function f(e,t){void 0===t&&(t=[]);const{scrollEventsEnabledRef:n}=d(),a=(0,r.useRef)(p()),o=(0,s._q)(e);(0,r.useEffect)((()=>{const e=()=>{if(!n.current)return;const e=p();o(e,a.current),a.current=e},t={passive:!0};return e(),window.addEventListener("scroll",e,t),()=>window.removeEventListener("scroll",e,t)}),[o,n,...t])}function g(){const e=d(),t=function(){const e=(0,r.useRef)({elem:null,top:0}),t=(0,r.useCallback)((t=>{e.current={elem:t,top:t.getBoundingClientRect().top}}),[]),n=(0,r.useCallback)((()=>{const{current:{elem:t,top:n}}=e;if(!t)return{restored:!1};const r=t.getBoundingClientRect().top-n;return r&&window.scrollBy({left:0,top:r}),e.current={elem:null,top:0},{restored:0!==r}}),[]);return(0,r.useMemo)((()=>({save:t,restore:n})),[n,t])}(),n=(0,r.useRef)(void 0),a=(0,r.useCallback)((r=>{t.save(r),e.disableScrollEvents(),n.current=()=>{const{restored:r}=t.restore();if(n.current=void 0,r){const t=()=>{e.enableScrollEvents(),window.removeEventListener("scroll",t)};window.addEventListener("scroll",t)}else e.enableScrollEvents()}}),[e,t]);return(0,i.A)((()=>{queueMicrotask((()=>n.current?.()))})),{blockElementScrollPositionUntilNextRender:a}}function m(){const e=(0,r.useRef)(null),t=(0,o.A)()&&"smooth"===getComputedStyle(document.documentElement).scrollBehavior;return{startScroll:n=>{e.current=t?function(e){return window.scrollTo({top:e,behavior:"smooth"}),()=>{}}(n):function(e){let t=null;const n=document.documentElement.scrollTop>e;return function r(){const a=document.documentElement.scrollTop;(n&&a>e||!n&&at&&cancelAnimationFrame(t)}(n)},cancelScroll:()=>e.current?.()}}},1482:(e,t,n)=>{"use strict";n.d(t,{Cy:()=>r,tU:()=>a});n(7639);const r="default";function a(e,t){return`docs-${e}-${t}`}},9900:(e,t,n)=>{"use strict";n.d(t,{Wf:()=>c,Dv:()=>d});var r=n(6540);const a=JSON.parse('{"N":"localStorage","M":""}'),o=a.N;function i(e){let{key:t,oldValue:n,newValue:r,storage:a}=e;if(n===r)return;const o=document.createEvent("StorageEvent");o.initStorageEvent("storage",!1,!1,t,n,r,window.location.href,a),window.dispatchEvent(o)}function s(e){if(void 0===e&&(e=o),"undefined"==typeof window)throw new Error("Browser storage is not available on Node.js/Docusaurus SSR process.");if("none"===e)return null;try{return window[e]}catch(n){return t=n,l||(console.warn("Docusaurus browser storage is not available.\nPossible reasons: running Docusaurus in an iframe, in an incognito browser session, or using too strict browser privacy settings.",t),l=!0),null}var t}let l=!1;const u={get:()=>null,set:()=>{},del:()=>{},listen:()=>()=>{}};function c(e,t){const n=`${e}${a.M}`;if("undefined"==typeof window)return function(e){function t(){throw new Error(`Illegal storage API usage for storage key "${e}".\nDocusaurus storage APIs are not supposed to be called on the server-rendering process.\nPlease only call storage APIs in effects and event handlers.`)}return{get:t,set:t,del:t,listen:t}}(n);const r=s(t?.persistence);return null===r?u:{get:()=>{try{return r.getItem(n)}catch(e){return console.error(`Docusaurus storage error, can't get key=${n}`,e),null}},set:e=>{try{const t=r.getItem(n);r.setItem(n,e),i({key:n,oldValue:t,newValue:e,storage:r})}catch(t){console.error(`Docusaurus storage error, can't set ${n}=${e}`,t)}},del:()=>{try{const e=r.getItem(n);r.removeItem(n),i({key:n,oldValue:e,newValue:null,storage:r})}catch(e){console.error(`Docusaurus storage error, can't delete key=${n}`,e)}},listen:e=>{try{const t=t=>{t.storageArea===r&&t.key===n&&e(t)};return window.addEventListener("storage",t),()=>window.removeEventListener("storage",t)}catch(t){return console.error(`Docusaurus storage error, can't listen for changes of key=${n}`,t),()=>{}}}}}function d(e,t){const n=(0,r.useRef)((()=>null===e?u:c(e,t))).current(),a=(0,r.useCallback)((e=>"undefined"==typeof window?()=>{}:n.listen(e)),[n]);return[(0,r.useSyncExternalStore)(a,(()=>"undefined"==typeof window?null:n.get()),(()=>null)),n]}},2098:(e,t,n)=>{"use strict";n.d(t,{o:()=>i});var r=n(7639),a=n(6347),o=n(4609);function i(){const{siteConfig:{baseUrl:e,url:t,trailingSlash:n},i18n:{defaultLocale:i,currentLocale:s}}=(0,r.A)(),{pathname:l}=(0,a.zy)(),u=(0,o.applyTrailingSlash)(l,{trailingSlash:n,baseUrl:e}),c=s===i?e:e.replace(`/${s}/`,"/"),d=u.replace(e,"");return{createUrl:function(e){let{locale:n,fullyQualified:r}=e;return`${r?t:""}${function(e){return e===i?`${c}`:`${c}${e}/`}(n)}${d}`}}}},4067:(e,t,n)=>{"use strict";n.d(t,{$:()=>i});var r=n(6540),a=n(6347),o=n(4799);function i(e){const t=(0,a.zy)(),n=(0,o.ZC)(t),i=(0,o._q)(e);(0,r.useEffect)((()=>{n&&t!==n&&i({location:t,previousLocation:n})}),[i,t,n])}},6957:(e,t,n)=>{"use strict";n.d(t,{p:()=>a});var r=n(7639);function a(){return(0,r.A)().siteConfig.themeConfig}},4356:(e,t,n)=>{"use strict";Object.defineProperty(t,"__esModule",{value:!0}),t.removeTrailingSlash=t.addLeadingSlash=t.addTrailingSlash=void 0;const r=n(835);function a(e){return e.endsWith("/")?e:`${e}/`}function o(e){return(0,r.removeSuffix)(e,"/")}t.addTrailingSlash=a,t.default=function(e,t){const{trailingSlash:n,baseUrl:r}=t;if(e.startsWith("#"))return e;if(void 0===n)return e;const[i]=e.split(/[#?]/),s="/"===i||i===r?i:(l=i,n?a(l):o(l));var l;return e.replace(i,s)},t.addLeadingSlash=function(e){return(0,r.addPrefix)(e,"/")},t.removeTrailingSlash=o},8274:(e,t)=>{"use strict";Object.defineProperty(t,"__esModule",{value:!0}),t.getErrorCausalChain=void 0,t.getErrorCausalChain=function e(t){return t.cause?[t,...e(t.cause)]:[t]}},4609:function(e,t,n){"use strict";var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0}),t.getErrorCausalChain=t.removePrefix=t.addSuffix=t.removeSuffix=t.addPrefix=t.removeTrailingSlash=t.addLeadingSlash=t.addTrailingSlash=t.applyTrailingSlash=t.blogPostContainerID=void 0,t.blogPostContainerID="__blog-post-container";var a=n(4356);Object.defineProperty(t,"applyTrailingSlash",{enumerable:!0,get:function(){return r(a).default}}),Object.defineProperty(t,"addTrailingSlash",{enumerable:!0,get:function(){return a.addTrailingSlash}}),Object.defineProperty(t,"addLeadingSlash",{enumerable:!0,get:function(){return a.addLeadingSlash}}),Object.defineProperty(t,"removeTrailingSlash",{enumerable:!0,get:function(){return a.removeTrailingSlash}});var o=n(835);Object.defineProperty(t,"addPrefix",{enumerable:!0,get:function(){return o.addPrefix}}),Object.defineProperty(t,"removeSuffix",{enumerable:!0,get:function(){return o.removeSuffix}}),Object.defineProperty(t,"addSuffix",{enumerable:!0,get:function(){return o.addSuffix}}),Object.defineProperty(t,"removePrefix",{enumerable:!0,get:function(){return o.removePrefix}});var i=n(8274);Object.defineProperty(t,"getErrorCausalChain",{enumerable:!0,get:function(){return i.getErrorCausalChain}})},835:(e,t)=>{"use strict";Object.defineProperty(t,"__esModule",{value:!0}),t.removePrefix=t.addSuffix=t.removeSuffix=t.addPrefix=void 0,t.addPrefix=function(e,t){return e.startsWith(t)?e:`${t}${e}`},t.removeSuffix=function(e,t){return""===t?e:e.endsWith(t)?e.slice(0,-t.length):e},t.addSuffix=function(e,t){return e.endsWith(t)?e:`${e}${t}`},t.removePrefix=function(e,t){return e.startsWith(t)?e.slice(t.length):e}},1513:(e,t,n)=>{"use strict";n.d(t,{zR:()=>w,TM:()=>C,yJ:()=>f,sC:()=>T,AO:()=>p});var r=n(8168);function a(e){return"/"===e.charAt(0)}function o(e,t){for(var n=t,r=n+1,a=e.length;r=0;p--){var f=i[p];"."===f?o(i,p):".."===f?(o(i,p),d++):d&&(o(i,p),d--)}if(!u)for(;d--;d)i.unshift("..");!u||""===i[0]||i[0]&&a(i[0])||i.unshift("");var g=i.join("/");return n&&"/"!==g.substr(-1)&&(g+="/"),g};var s=n(1561);function l(e){return"/"===e.charAt(0)?e:"/"+e}function u(e){return"/"===e.charAt(0)?e.substr(1):e}function c(e,t){return function(e,t){return 0===e.toLowerCase().indexOf(t.toLowerCase())&&-1!=="/?#".indexOf(e.charAt(t.length))}(e,t)?e.substr(t.length):e}function d(e){return"/"===e.charAt(e.length-1)?e.slice(0,-1):e}function p(e){var t=e.pathname,n=e.search,r=e.hash,a=t||"/";return n&&"?"!==n&&(a+="?"===n.charAt(0)?n:"?"+n),r&&"#"!==r&&(a+="#"===r.charAt(0)?r:"#"+r),a}function f(e,t,n,a){var o;"string"==typeof e?(o=function(e){var t=e||"/",n="",r="",a=t.indexOf("#");-1!==a&&(r=t.substr(a),t=t.substr(0,a));var o=t.indexOf("?");return-1!==o&&(n=t.substr(o),t=t.substr(0,o)),{pathname:t,search:"?"===n?"":n,hash:"#"===r?"":r}}(e),o.state=t):(void 0===(o=(0,r.A)({},e)).pathname&&(o.pathname=""),o.search?"?"!==o.search.charAt(0)&&(o.search="?"+o.search):o.search="",o.hash?"#"!==o.hash.charAt(0)&&(o.hash="#"+o.hash):o.hash="",void 0!==t&&void 0===o.state&&(o.state=t));try{o.pathname=decodeURI(o.pathname)}catch(s){throw s instanceof URIError?new URIError('Pathname "'+o.pathname+'" could not be decoded. This is likely caused by an invalid percent-encoding.'):s}return n&&(o.key=n),a?o.pathname?"/"!==o.pathname.charAt(0)&&(o.pathname=i(o.pathname,a.pathname)):o.pathname=a.pathname:o.pathname||(o.pathname="/"),o}function g(){var e=null;var t=[];return{setPrompt:function(t){return e=t,function(){e===t&&(e=null)}},confirmTransitionTo:function(t,n,r,a){if(null!=e){var o="function"==typeof e?e(t,n):e;"string"==typeof o?"function"==typeof r?r(o,a):a(!0):a(!1!==o)}else a(!0)},appendListener:function(e){var n=!0;function r(){n&&e.apply(void 0,arguments)}return t.push(r),function(){n=!1,t=t.filter((function(e){return e!==r}))}},notifyListeners:function(){for(var e=arguments.length,n=new Array(e),r=0;rt?n.splice(t,n.length-t,a):n.push(a),d({action:r,location:a,index:t,entries:n})}}))},replace:function(e,t){var r="REPLACE",a=f(e,t,m(),w.location);c.confirmTransitionTo(a,r,n,(function(e){e&&(w.entries[w.index]=a,d({action:r,location:a}))}))},go:v,goBack:function(){v(-1)},goForward:function(){v(1)},canGo:function(e){var t=w.index+e;return t>=0&&t{"use strict";var r=n(4363),a={childContextTypes:!0,contextType:!0,contextTypes:!0,defaultProps:!0,displayName:!0,getDefaultProps:!0,getDerivedStateFromError:!0,getDerivedStateFromProps:!0,mixins:!0,propTypes:!0,type:!0},o={name:!0,length:!0,prototype:!0,caller:!0,callee:!0,arguments:!0,arity:!0},i={$$typeof:!0,compare:!0,defaultProps:!0,displayName:!0,propTypes:!0,type:!0},s={};function l(e){return r.isMemo(e)?i:s[e.$$typeof]||a}s[r.ForwardRef]={$$typeof:!0,render:!0,defaultProps:!0,displayName:!0,propTypes:!0},s[r.Memo]=i;var u=Object.defineProperty,c=Object.getOwnPropertyNames,d=Object.getOwnPropertySymbols,p=Object.getOwnPropertyDescriptor,f=Object.getPrototypeOf,g=Object.prototype;e.exports=function e(t,n,r){if("string"!=typeof n){if(g){var a=f(n);a&&a!==g&&e(t,a,r)}var i=c(n);d&&(i=i.concat(d(n)));for(var s=l(t),m=l(n),h=0;h{"use strict";e.exports=function(e,t,n,r,a,o,i,s){if(!e){var l;if(void 0===t)l=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var u=[n,r,a,o,i,s],c=0;(l=new Error(t.replace(/%s/g,(function(){return u[c++]})))).name="Invariant Violation"}throw l.framesToPop=1,l}}},4634:e=>{e.exports=Array.isArray||function(e){return"[object Array]"==Object.prototype.toString.call(e)}},5300:(e,t,n)=>{"use strict";n.r(t)},8252:(e,t,n)=>{"use strict";n.r(t)},5947:function(e,t,n){var r,a;r=function(){var e,t,n={version:"0.2.0"},r=n.settings={minimum:.08,easing:"ease",positionUsing:"",speed:200,trickle:!0,trickleRate:.02,trickleSpeed:800,showSpinner:!0,barSelector:'[role="bar"]',spinnerSelector:'[role="spinner"]',parent:"body",template:'
'};function a(e,t,n){return en?n:e}function o(e){return 100*(-1+e)}function i(e,t,n){var a;return(a="translate3d"===r.positionUsing?{transform:"translate3d("+o(e)+"%,0,0)"}:"translate"===r.positionUsing?{transform:"translate("+o(e)+"%,0)"}:{"margin-left":o(e)+"%"}).transition="all "+t+"ms "+n,a}n.configure=function(e){var t,n;for(t in e)void 0!==(n=e[t])&&e.hasOwnProperty(t)&&(r[t]=n);return this},n.status=null,n.set=function(e){var t=n.isStarted();e=a(e,r.minimum,1),n.status=1===e?null:e;var o=n.render(!t),u=o.querySelector(r.barSelector),c=r.speed,d=r.easing;return o.offsetWidth,s((function(t){""===r.positionUsing&&(r.positionUsing=n.getPositioningCSS()),l(u,i(e,c,d)),1===e?(l(o,{transition:"none",opacity:1}),o.offsetWidth,setTimeout((function(){l(o,{transition:"all "+c+"ms linear",opacity:0}),setTimeout((function(){n.remove(),t()}),c)}),c)):setTimeout(t,c)})),this},n.isStarted=function(){return"number"==typeof n.status},n.start=function(){n.status||n.set(0);var e=function(){setTimeout((function(){n.status&&(n.trickle(),e())}),r.trickleSpeed)};return r.trickle&&e(),this},n.done=function(e){return e||n.status?n.inc(.3+.5*Math.random()).set(1):this},n.inc=function(e){var t=n.status;return t?("number"!=typeof e&&(e=(1-t)*a(Math.random()*t,.1,.95)),t=a(t+e,0,.994),n.set(t)):n.start()},n.trickle=function(){return n.inc(Math.random()*r.trickleRate)},e=0,t=0,n.promise=function(r){return r&&"resolved"!==r.state()?(0===t&&n.start(),e++,t++,r.always((function(){0==--t?(e=0,n.done()):n.set((e-t)/e)})),this):this},n.render=function(e){if(n.isRendered())return document.getElementById("nprogress");c(document.documentElement,"nprogress-busy");var t=document.createElement("div");t.id="nprogress",t.innerHTML=r.template;var a,i=t.querySelector(r.barSelector),s=e?"-100":o(n.status||0),u=document.querySelector(r.parent);return l(i,{transition:"all 0 linear",transform:"translate3d("+s+"%,0,0)"}),r.showSpinner||(a=t.querySelector(r.spinnerSelector))&&f(a),u!=document.body&&c(u,"nprogress-custom-parent"),u.appendChild(t),t},n.remove=function(){d(document.documentElement,"nprogress-busy"),d(document.querySelector(r.parent),"nprogress-custom-parent");var e=document.getElementById("nprogress");e&&f(e)},n.isRendered=function(){return!!document.getElementById("nprogress")},n.getPositioningCSS=function(){var e=document.body.style,t="WebkitTransform"in e?"Webkit":"MozTransform"in e?"Moz":"msTransform"in e?"ms":"OTransform"in e?"O":"";return t+"Perspective"in e?"translate3d":t+"Transform"in e?"translate":"margin"};var s=function(){var e=[];function t(){var n=e.shift();n&&n(t)}return function(n){e.push(n),1==e.length&&t()}}(),l=function(){var e=["Webkit","O","Moz","ms"],t={};function n(e){return e.replace(/^-ms-/,"ms-").replace(/-([\da-z])/gi,(function(e,t){return t.toUpperCase()}))}function r(t){var n=document.body.style;if(t in n)return t;for(var r,a=e.length,o=t.charAt(0).toUpperCase()+t.slice(1);a--;)if((r=e[a]+o)in n)return r;return t}function a(e){return e=n(e),t[e]||(t[e]=r(e))}function o(e,t,n){t=a(t),e.style[t]=n}return function(e,t){var n,r,a=arguments;if(2==a.length)for(n in t)void 0!==(r=t[n])&&t.hasOwnProperty(n)&&o(e,n,r);else o(e,a[1],a[2])}}();function u(e,t){return("string"==typeof e?e:p(e)).indexOf(" "+t+" ")>=0}function c(e,t){var n=p(e),r=n+t;u(n,t)||(e.className=r.substring(1))}function d(e,t){var n,r=p(e);u(e,t)&&(n=r.replace(" "+t+" "," "),e.className=n.substring(1,n.length-1))}function p(e){return(" "+(e.className||"")+" ").replace(/\s+/gi," ")}function f(e){e&&e.parentNode&&e.parentNode.removeChild(e)}return n},void 0===(a="function"==typeof r?r.call(t,n,t,e):r)||(e.exports=a)},5302:(e,t,n)=>{var r=n(4634);e.exports=f,e.exports.parse=o,e.exports.compile=function(e,t){return s(o(e,t),t)},e.exports.tokensToFunction=s,e.exports.tokensToRegExp=p;var a=new RegExp(["(\\\\.)","([\\/.])?(?:(?:\\:(\\w+)(?:\\(((?:\\\\.|[^\\\\()])+)\\))?|\\(((?:\\\\.|[^\\\\()])+)\\))([+*?])?|(\\*))"].join("|"),"g");function o(e,t){for(var n,r=[],o=0,i=0,s="",c=t&&t.delimiter||"/";null!=(n=a.exec(e));){var d=n[0],p=n[1],f=n.index;if(s+=e.slice(i,f),i=f+d.length,p)s+=p[1];else{var g=e[i],m=n[2],h=n[3],b=n[4],y=n[5],v=n[6],w=n[7];s&&(r.push(s),s="");var k=null!=m&&null!=g&&g!==m,x="+"===v||"*"===v,S="?"===v||"*"===v,E=n[2]||c,_=b||y;r.push({name:h||o++,prefix:m||"",delimiter:E,optional:S,repeat:x,partial:k,asterisk:!!w,pattern:_?u(_):w?".*":"[^"+l(E)+"]+?"})}}return i{!function(e){var t="\\b(?:BASH|BASHOPTS|BASH_ALIASES|BASH_ARGC|BASH_ARGV|BASH_CMDS|BASH_COMPLETION_COMPAT_DIR|BASH_LINENO|BASH_REMATCH|BASH_SOURCE|BASH_VERSINFO|BASH_VERSION|COLORTERM|COLUMNS|COMP_WORDBREAKS|DBUS_SESSION_BUS_ADDRESS|DEFAULTS_PATH|DESKTOP_SESSION|DIRSTACK|DISPLAY|EUID|GDMSESSION|GDM_LANG|GNOME_KEYRING_CONTROL|GNOME_KEYRING_PID|GPG_AGENT_INFO|GROUPS|HISTCONTROL|HISTFILE|HISTFILESIZE|HISTSIZE|HOME|HOSTNAME|HOSTTYPE|IFS|INSTANCE|JOB|LANG|LANGUAGE|LC_ADDRESS|LC_ALL|LC_IDENTIFICATION|LC_MEASUREMENT|LC_MONETARY|LC_NAME|LC_NUMERIC|LC_PAPER|LC_TELEPHONE|LC_TIME|LESSCLOSE|LESSOPEN|LINES|LOGNAME|LS_COLORS|MACHTYPE|MAILCHECK|MANDATORY_PATH|NO_AT_BRIDGE|OLDPWD|OPTERR|OPTIND|ORBIT_SOCKETDIR|OSTYPE|PAPERSIZE|PATH|PIPESTATUS|PPID|PS1|PS2|PS3|PS4|PWD|RANDOM|REPLY|SECONDS|SELINUX_INIT|SESSION|SESSIONTYPE|SESSION_MANAGER|SHELL|SHELLOPTS|SHLVL|SSH_AUTH_SOCK|TERM|UID|UPSTART_EVENTS|UPSTART_INSTANCE|UPSTART_JOB|UPSTART_SESSION|USER|WINDOWID|XAUTHORITY|XDG_CONFIG_DIRS|XDG_CURRENT_DESKTOP|XDG_DATA_DIRS|XDG_GREETER_DATA_DIR|XDG_MENU_PREFIX|XDG_RUNTIME_DIR|XDG_SEAT|XDG_SEAT_PATH|XDG_SESSION_DESKTOP|XDG_SESSION_ID|XDG_SESSION_PATH|XDG_SESSION_TYPE|XDG_VTNR|XMODIFIERS)\\b",n={pattern:/(^(["']?)\w+\2)[ \t]+\S.*/,lookbehind:!0,alias:"punctuation",inside:null},r={bash:n,environment:{pattern:RegExp("\\$"+t),alias:"constant"},variable:[{pattern:/\$?\(\([\s\S]+?\)\)/,greedy:!0,inside:{variable:[{pattern:/(^\$\(\([\s\S]+)\)\)/,lookbehind:!0},/^\$\(\(/],number:/\b0x[\dA-Fa-f]+\b|(?:\b\d+(?:\.\d*)?|\B\.\d+)(?:[Ee]-?\d+)?/,operator:/--|\+\+|\*\*=?|<<=?|>>=?|&&|\|\||[=!+\-*/%<>^&|]=?|[?~:]/,punctuation:/\(\(?|\)\)?|,|;/}},{pattern:/\$\((?:\([^)]+\)|[^()])+\)|`[^`]+`/,greedy:!0,inside:{variable:/^\$\(|^`|\)$|`$/}},{pattern:/\$\{[^}]+\}/,greedy:!0,inside:{operator:/:[-=?+]?|[!\/]|##?|%%?|\^\^?|,,?/,punctuation:/[\[\]]/,environment:{pattern:RegExp("(\\{)"+t),lookbehind:!0,alias:"constant"}}},/\$(?:\w+|[#?*!@$])/],entity:/\\(?:[abceEfnrtv\\"]|O?[0-7]{1,3}|U[0-9a-fA-F]{8}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{1,2})/};e.languages.bash={shebang:{pattern:/^#!\s*\/.*/,alias:"important"},comment:{pattern:/(^|[^"{\\$])#.*/,lookbehind:!0},"function-name":[{pattern:/(\bfunction\s+)[\w-]+(?=(?:\s*\(?:\s*\))?\s*\{)/,lookbehind:!0,alias:"function"},{pattern:/\b[\w-]+(?=\s*\(\s*\)\s*\{)/,alias:"function"}],"for-or-select":{pattern:/(\b(?:for|select)\s+)\w+(?=\s+in\s)/,alias:"variable",lookbehind:!0},"assign-left":{pattern:/(^|[\s;|&]|[<>]\()\w+(?:\.\w+)*(?=\+?=)/,inside:{environment:{pattern:RegExp("(^|[\\s;|&]|[<>]\\()"+t),lookbehind:!0,alias:"constant"}},alias:"variable",lookbehind:!0},parameter:{pattern:/(^|\s)-{1,2}(?:\w+:[+-]?)?\w+(?:\.\w+)*(?=[=\s]|$)/,alias:"variable",lookbehind:!0},string:[{pattern:/((?:^|[^<])<<-?\s*)(\w+)\s[\s\S]*?(?:\r?\n|\r)\2/,lookbehind:!0,greedy:!0,inside:r},{pattern:/((?:^|[^<])<<-?\s*)(["'])(\w+)\2\s[\s\S]*?(?:\r?\n|\r)\3/,lookbehind:!0,greedy:!0,inside:{bash:n}},{pattern:/(^|[^\\](?:\\\\)*)"(?:\\[\s\S]|\$\([^)]+\)|\$(?!\()|`[^`]+`|[^"\\`$])*"/,lookbehind:!0,greedy:!0,inside:r},{pattern:/(^|[^$\\])'[^']*'/,lookbehind:!0,greedy:!0},{pattern:/\$'(?:[^'\\]|\\[\s\S])*'/,greedy:!0,inside:{entity:r.entity}}],environment:{pattern:RegExp("\\$?"+t),alias:"constant"},variable:r.variable,function:{pattern:/(^|[\s;|&]|[<>]\()(?:add|apropos|apt|apt-cache|apt-get|aptitude|aspell|automysqlbackup|awk|basename|bash|bc|bconsole|bg|bzip2|cal|cargo|cat|cfdisk|chgrp|chkconfig|chmod|chown|chroot|cksum|clear|cmp|column|comm|composer|cp|cron|crontab|csplit|curl|cut|date|dc|dd|ddrescue|debootstrap|df|diff|diff3|dig|dir|dircolors|dirname|dirs|dmesg|docker|docker-compose|du|egrep|eject|env|ethtool|expand|expect|expr|fdformat|fdisk|fg|fgrep|file|find|fmt|fold|format|free|fsck|ftp|fuser|gawk|git|gparted|grep|groupadd|groupdel|groupmod|groups|grub-mkconfig|gzip|halt|head|hg|history|host|hostname|htop|iconv|id|ifconfig|ifdown|ifup|import|install|ip|java|jobs|join|kill|killall|less|link|ln|locate|logname|logrotate|look|lpc|lpr|lprint|lprintd|lprintq|lprm|ls|lsof|lynx|make|man|mc|mdadm|mkconfig|mkdir|mke2fs|mkfifo|mkfs|mkisofs|mknod|mkswap|mmv|more|most|mount|mtools|mtr|mutt|mv|nano|nc|netstat|nice|nl|node|nohup|notify-send|npm|nslookup|op|open|parted|passwd|paste|pathchk|ping|pkill|pnpm|podman|podman-compose|popd|pr|printcap|printenv|ps|pushd|pv|quota|quotacheck|quotactl|ram|rar|rcp|reboot|remsync|rename|renice|rev|rm|rmdir|rpm|rsync|scp|screen|sdiff|sed|sendmail|seq|service|sftp|sh|shellcheck|shuf|shutdown|sleep|slocate|sort|split|ssh|stat|strace|su|sudo|sum|suspend|swapon|sync|sysctl|tac|tail|tar|tee|time|timeout|top|touch|tr|traceroute|tsort|tty|umount|uname|unexpand|uniq|units|unrar|unshar|unzip|update-grub|uptime|useradd|userdel|usermod|users|uudecode|uuencode|v|vcpkg|vdir|vi|vim|virsh|vmstat|wait|watch|wc|wget|whereis|which|who|whoami|write|xargs|xdg-open|yarn|yes|zenity|zip|zsh|zypper)(?=$|[)\s;|&])/,lookbehind:!0},keyword:{pattern:/(^|[\s;|&]|[<>]\()(?:case|do|done|elif|else|esac|fi|for|function|if|in|select|then|until|while)(?=$|[)\s;|&])/,lookbehind:!0},builtin:{pattern:/(^|[\s;|&]|[<>]\()(?:\.|:|alias|bind|break|builtin|caller|cd|command|continue|declare|echo|enable|eval|exec|exit|export|getopts|hash|help|let|local|logout|mapfile|printf|pwd|read|readarray|readonly|return|set|shift|shopt|source|test|times|trap|type|typeset|ulimit|umask|unalias|unset)(?=$|[)\s;|&])/,lookbehind:!0,alias:"class-name"},boolean:{pattern:/(^|[\s;|&]|[<>]\()(?:false|true)(?=$|[)\s;|&])/,lookbehind:!0},"file-descriptor":{pattern:/\B&\d\b/,alias:"important"},operator:{pattern:/\d?<>|>\||\+=|=[=~]?|!=?|<<[<-]?|[&\d]?>>|\d[<>]&?|[<>][&=]?|&[>&]?|\|[&|]?/,inside:{"file-descriptor":{pattern:/^\d/,alias:"important"}}},punctuation:/\$?\(\(?|\)\)?|\.\.|[{}[\];\\]/,number:{pattern:/(^|\s)(?:[1-9]\d*|0)(?:[.,]\d+)?\b/,lookbehind:!0}},n.inside=e.languages.bash;for(var a=["comment","function-name","for-or-select","assign-left","parameter","string","environment","function","keyword","builtin","boolean","file-descriptor","operator","punctuation","number"],o=r.variable[1].inside,i=0;i{!function(e){function t(e,t){return"___"+e.toUpperCase()+t+"___"}Object.defineProperties(e.languages["markup-templating"]={},{buildPlaceholders:{value:function(n,r,a,o){if(n.language===r){var i=n.tokenStack=[];n.code=n.code.replace(a,(function(e){if("function"==typeof o&&!o(e))return e;for(var a,s=i.length;-1!==n.code.indexOf(a=t(r,s));)++s;return i[s]=e,a})),n.grammar=e.languages.markup}}},tokenizePlaceholders:{value:function(n,r){if(n.language===r&&n.tokenStack){n.grammar=e.languages[r];var a=0,o=Object.keys(n.tokenStack);!function i(s){for(var l=0;l=o.length);l++){var u=s[l];if("string"==typeof u||u.content&&"string"==typeof u.content){var c=o[a],d=n.tokenStack[c],p="string"==typeof u?u:u.content,f=t(r,c),g=p.indexOf(f);if(g>-1){++a;var m=p.substring(0,g),h=new e.Token(r,e.tokenize(d,n.grammar),"language-"+r,d),b=p.substring(g+f.length),y=[];m&&y.push.apply(y,i([m])),y.push(h),b&&y.push.apply(y,i([b])),"string"==typeof u?s.splice.apply(s,[l,1].concat(y)):u.content=y}}else u.content&&i(u.content)}return s}(n.tokens)}}}})}(Prism)},2318:(e,t,n)=>{var r={"./prism-bash":7022};function a(e){var t=o(e);return n(t)}function o(e){if(!n.o(r,e)){var t=new Error("Cannot find module '"+e+"'");throw t.code="MODULE_NOT_FOUND",t}return r[e]}a.keys=function(){return Object.keys(r)},a.resolve=o,e.exports=a,a.id=2318},2694:(e,t,n)=>{"use strict";var r=n(6925);function a(){}function o(){}o.resetWarningCache=a,e.exports=function(){function e(e,t,n,a,o,i){if(i!==r){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:a};return n.PropTypes=n,n}},5556:(e,t,n)=>{e.exports=n(2694)()},6925:e=>{"use strict";e.exports="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED"},2551:(e,t,n)=>{"use strict";var r=n(6540),a=n(9982);function o(e){for(var t="https://reactjs.org/docs/error-decoder.html?invariant="+e,n=1;n