IoThings guide

_includes/docs/devices-library/blocks/ready-to-go-devices/iobutton-panic-button-configuration-block.md

@@ -0,0 +1,49 @@
+### Device configuration
+
+To connect and send data we should configure the device and network server.  
+At first we are going to configure the device, and save required information for network server configuration.  
+To add a device to network server and get information from it, we will need the following device parameters:
+
+- **Device EUI** — device identifier
+- **Application EUI** — application identifier
+- **Application Key** — application key to identify device. We recommend to use a generated key, not from the example!
+
+The parameters above are required for connection.
+
+Depending on the network server, you may also need to provide join type (OTAA) and LoRaWAN version.
+
+### Prerequisites
+
+- **Android app & account**  
+  Install the ioTracker Configurator app from Google Play and log in with your ioTracker account.
+- **Device compatibility**  
+  Only with ioTracker accounts after February 1, 2022 are supported.
+- **Bluetooth & permissions**  
+  Enable Bluetooth and grant Location/"Nearby devices" permissions to the app.
+
+### 1. Scanning & Connecting
+
+1. Open **ioTracker Configurator** and tap **Refresh** (or **Scan**) to discover devices.
+2. Select your ioTracker or ioButton from the list and tap **Login**; enter your credentials to establish Bluetooth.
+
+### 2. LoRaWAN Menu
+
+From the **Main menu**, tap **Configuration** to access LoRaWAN functions.  
+![LoRaWAN menu screenshot](/images/devices-library/io-things-lorawan-menu.png)
+
+### Change LoRaWAN Keys
+
+- Click the **edit/pencil** icon next to **DevEUI**, **AppEUI**, and **AppKey**.
+- Enter your new LoRaWAN **DevEUI**, **AppEUI**, and **AppKey**.
+- Click **Update**.
+- **Reboot** the device to activate the new keys.  
+  ![Change LoRaWAN keys screenshot](/images/devices-library/io-things-lorawan-lorakeys.png)
+
+### Check LoRaWAN Status
+
+- **Active Region**: the frequency band in use.
+- **LoRaWAN Version**: the specification version.
+- **Join Status**: **JOINED** or **NOT JOINED**.
+- **Last Uplink**: timestamp, payload, message type, DataRate, channel, TxPower, TxToA, UpCntr.
+- **Last Downlink**: timestamp, payload, DataRate, RxSlot, port, RSSI, SNR, ACK flag, DownCntr.  
+  ![LoRaWAN status overview screenshot](/images/devices-library/io-things-lorawan-overview.png)

_includes/docs/devices-library/blocks/ready-to-go-devices/iotracker-multi-sensor-tracker-configuration-block.md

@@ -0,0 +1,49 @@
+### Device configuration
+
+To connect and send data we should configure the device and network server.  
+At first we are going to configure the device, and save required information for network server configuration.  
+To add a device to network server and get information from it, we will need the following device parameters:
+
+- **Device EUI** — device identifier
+- **Application EUI** — application identifier
+- **Application Key** — application key to identify device. We recommend to use a generated key, not from the example!
+
+The parameters above are required for connection.
+
+Depending on the network server, you may also need to provide join type (OTAA) and LoRaWAN version.
+
+### Prerequisites
+
+- **Android app & account**  
+  Install the ioTracker Configurator app from Google Play and log in with your ioTracker account.
+- **Device compatibility**  
+  Only with ioTracker accounts after February 1, 2022 are supported.
+- **Bluetooth & permissions**  
+  Enable Bluetooth and grant Location/"Nearby devices" permissions to the app.
+
+### 1. Scanning & Connecting
+
+1. Open **ioTracker Configurator** and tap **Refresh** (or **Scan**) to discover devices.
+2. Select your ioTracker or ioButton from the list and tap **Login**; enter your credentials to establish Bluetooth.
+
+### 2. LoRaWAN Menu
+
+From the **Main menu**, tap **Configuration** to access LoRaWAN functions.  
+![LoRaWAN menu screenshot](/images/devices-library/io-things-lorawan-menu.png)
+
+### Change LoRaWAN Keys
+
+- Click the **edit/pencil** icon next to **DevEUI**, **AppEUI**, and **AppKey**.
+- Enter your new LoRaWAN **DevEUI**, **AppEUI**, and **AppKey**.
+- Click **Update**.
+- **Reboot** the device to activate the new keys.  
+  ![Change LoRaWAN keys screenshot](/images/devices-library/io-things-lorawan-lorakeys.png)
+
+### Check LoRaWAN Status
+
+- **Active Region**: the frequency band in use.
+- **LoRaWAN Version**: the specification version.
+- **Join Status**: **JOINED** or **NOT JOINED**.
+- **Last Uplink**: timestamp, payload, message type, DataRate, channel, TxPower, TxToA, UpCntr.
+- **Last Downlink**: timestamp, payload, DataRate, RxSlot, port, RSSI, SNR, ACK flag, DownCntr.  
+  ![LoRaWAN status overview screenshot](/images/devices-library/io-things-lorawan-overview.png)

_includes/docs/devices-library/guides/iobutton-panic-button.md

@@ -0,0 +1,72 @@
+
+{% assign deviceName = page.title | remove: "How to connect " | remove: "to ThingsBoard?" %}
+{% assign deviceVendorLink = "https://www.iotracker.eu/products/iobutton" %}
+{% assign thingsboardHost = "https://" | append: hostName %}
+{% assign prerequisites = '
+- <a href="' | append: deviceVendorLink | append: '" target="_blank">' | append: deviceName | append: '</a>
+- LoRaWAN® gateway (in our case [UG56 LoRaWAN® Gateway](/docs/pe/devices-library/ug56-lorawan-gateway/){:target="_blank"})
+- Configured integration on networks server and ThingsBoard
+- [Network Server account](#device-connection)
+'
+ %}
+
+## Introduction
+
+![{{deviceName}}](/images/devices-library/{{page.deviceImageFileName}}){: style="float: left; max-width: 200px; max-height: 200px; margin: 0px 10px 0px 0px"}
+[ioButton Panic button]({{deviceVendorLink}}){: target="_blank"} ioButton is a versatile solution, pre-
+configured for various emergency
+scenarios. When the panic button is
+activated, users receive immediate
+notification through the prominent LED
+ring, accompanied by haptic feedback
+from the vibration motor. With a standard battery life of over 10 years, virtually no maintenance is required. 
+The ioButton can send 1,000,000 messages on SF-7 and 100,000 on SF-12!
+By default, the ioButton sends a heartbeat message every 4 hours.
+
+{% assign feature = "Platform Integrations" %}{% include templates/pe-feature-banner.md %}
+<br>
+
+## Prerequisites
+
+To continue with this guide we will need the following:  
+{{ prerequisites }}
+- [ThingsBoard account]({{ thingsboardHost }}){: target="_blank"}
+
+
+## Device connection
+
+{% if page.hasIntegrationDeviceConfiguration | downcase == "true"%}
+
+{% assign articleFilename = page.name |  replace: ".md", "" %}
+{% assign guideFilePath = "/docs/devices-library/blocks/ready-to-go-devices/" | append: articleFilename | append: "-configuration-block.md" %}
+
+{% include {{ guideFilePath }} %}
+
+{% endif %}
+
+To configure the device we also need to add it to a network server, so select the network server your gateway is connected to:  
+
+{% assign targetIntegrationTypes = '
+ChirpStack,
+TheThingsStack,
+TheThingsIndustries,
+Loriot
+'%}
+
+{% include /docs/devices-library/blocks/basic/thingsboard-add-lorawan-device-through-integration-block.liquid target-integration-types=targetIntegrationTypes %}
+
+
+## Check data on ThingsBoard
+
+After the device is connected to the network server and ThingsBoard, you can check received and converted data on the platform for this device.  
+
+To do this, open **Entities** menu section and select **Devices**.  
+Click on the device name to open the device details page.  
+Go to the **Latest telemetry** tab to see the latest telemetry data received from the device.  
+
+![LoRaWAN device data](/images/devices-library/io-button-lorawan-device-data.png)
+
+
+## Conclusion
+
+{% include /docs/devices-library/blocks/basic/conclusion-block.md %}

_includes/docs/devices-library/guides/iotracker-multi-sensor-tracker.md

@@ -0,0 +1,78 @@
+
+{% assign deviceName = page.title | remove: "How to connect " | remove: "to ThingsBoard?" %}
+{% assign deviceVendorLink = "https://www.iotracker.eu/iotracker" %}
+{% assign thingsboardHost = "https://" | append: hostName %}
+{% assign prerequisites = '
+- <a href="' | append: deviceVendorLink | append: '" target="_blank">' | append: deviceName | append: '</a>
+- LoRaWAN® gateway (in our case [UG56 LoRaWAN® Gateway](/docs/pe/devices-library/ug56-lorawan-gateway/){:target="_blank"})
+- Configured integration on networks server and ThingsBoard
+- [Network Server account](#device-connection)
+'
+ %}
+
+## Introduction
+
+![{{deviceName}}](/images/devices-library/{{page.deviceImageFileName}}){: style="float: left; max-width: 200px; max-height: 200px; margin: 0px 10px 0px 0px"}
+[ioTracker Multi-sensor tracker]({{deviceVendorLink}}){: target="_blank"} ioTracker is a compact multi‑sensor LoRaWAN® tracker with built‑in temperature, light, shock, tilt, optional humidity and pressure sensors for versatile environment monitoring.  
+The ioTracker contains multiple pre-set
+configurations, which can cover many use
+cases. If needed, the individual parameters
+can be tuned to match your business
+needs. Almost every setting of the ioTracker
+can be changed — over-the-air (OTAA) —
+allowing you to reconfigure / repurpose
+your ioTrackers wherever they are.
+The ioTracker features multiple localisation
+features: GPS, Wi-Fi, Bluetooth LE and
+LoRaWAN. This provides the best balance
+between high-accurate positioning and
+power efficiency in almost every in- and
+outdoor situation.
+
+{% assign feature = "Platform Integrations" %}{% include templates/pe-feature-banner.md %}
+<br>
+
+## Prerequisites
+
+To continue with this guide we will need the following:  
+{{ prerequisites }}
+- [ThingsBoard account]({{ thingsboardHost }}){: target="_blank"}
+
+
+## Device connection
+
+{% if page.hasIntegrationDeviceConfiguration | downcase == "true"%}
+
+{% assign articleFilename = page.name |  replace: ".md", "" %}
+{% assign guideFilePath = "/docs/devices-library/blocks/ready-to-go-devices/" | append: articleFilename | append: "-configuration-block.md" %}
+
+{% include {{ guideFilePath }} %}
+
+{% endif %}
+
+To configure the device we also need to add it to a network server, so select the network server your gateway is connected to:  
+
+{% assign targetIntegrationTypes = '
+ChirpStack,
+TheThingsStack,
+TheThingsIndustries,
+Loriot
+'%}
+
+{% include /docs/devices-library/blocks/basic/thingsboard-add-lorawan-device-through-integration-block.liquid target-integration-types=targetIntegrationTypes %}
+
+
+## Check data on ThingsBoard
+
+After the device is connected to the network server and ThingsBoard, you can check received and converted data on the platform for this device.  
+
+To do this, open **Entities** menu section and select **Devices**.  
+Click on the device name to open the device details page.  
+Go to the **Latest telemetry** tab to see the latest telemetry data received from the device.  
+
+![LoRaWAN device data](/images/devices-library/io-tracker-device-data.png)
+
+
+## Conclusion
+
+{% include /docs/devices-library/blocks/basic/conclusion-block.md %}

docs/devices-library/iobutton-panic-button.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect ioButton Panic button to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: ioThings
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: iobutton-panic-button.png
+converters20: true
+model: ioButton
+docsPrefix: pe/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/iobutton-panic-button.md %}

docs/devices-library/iotracker-multi-sensor-tracker.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect ioTracker Multi-sensor tracker to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: ioThings
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: iotracker-multi-sensor-tracker.png
+converters20: true
+model: ioTracker
+docsPrefix: pe/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/iotracker-multi-sensor-tracker.md %}

docs/paas/devices-library/iobutton-panic-button.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect ioButton Panic button to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: ioThings
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: iobutton-panic-button.png
+converters20: true
+model: ioButton
+docsPrefix: paas/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/iobutton-panic-button.md %}

docs/paas/devices-library/iotracker-multi-sensor-tracker.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect ioTracker Multi-sensor tracker to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: ioThings
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: iotracker-multi-sensor-tracker.png
+converters20: true
+model: ioTracker
+docsPrefix: paas/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/iotracker-multi-sensor-tracker.md %}

docs/pe/devices-library/iobutton-panic-button.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect ioButton Panic button to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: ioThings
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: iobutton-panic-button.png
+converters20: true
+model: ioButton
+docsPrefix: pe/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/iobutton-panic-button.md %}

docs/pe/devices-library/iotracker-multi-sensor-tracker.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect ioTracker Multi-sensor tracker to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: ioThings
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: iotracker-multi-sensor-tracker.png
+converters20: true
+model: ioTracker
+docsPrefix: pe/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/iotracker-multi-sensor-tracker.md %}