[WIP] Guide for Wireless solutions

_includes/docs/devices-library/blocks/ready-to-go-devices/ioke868-smart-metering-kit-configuration-block.md

@@ -0,0 +1,20 @@
+### 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.  
+
+Both, ABP and OTAA are supported by iO881A. We recommend using the OTAA process for joining the LoRaWAN network. Therefore
+configure the corresponding “Application EUI” and “Application Key” and write both into the iO881A. The keys are normally generated when
+creating a device on your LoRaWAN network account. Within the "WS Configurator" keys can only be written into the device. A read out of
+keys is not possible due to security reasons.
+
+![WS Configurator – LoRaWAN Tab](/images/devices-library/ws-configurator-lorawan.png)
+
+You can now perform an initial network reachability test on the iO881A. To do so, slide the LoRaWAN activation switch to the right—this will start the join procedure. 
+Verify the process either by checking for “Join Requests” on your network server or by watching the iO881A’s LED indicators.

_includes/docs/devices-library/guides/ioke868-smart-metering-kit.md

@@ -0,0 +1,67 @@
+
+{% assign deviceName = page.title | remove: "How to connect " | remove: "to ThingsBoard?" %}
+{% assign deviceVendorLink = "https://wireless-solutions.de/products/lora-ioke868-smart-metering-kit.html" %}
+{% 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"}
+[iOKE868 Smart Metering Kit]({{deviceVendorLink}}){: target="_blank"} compliant with LoRaWAN® leverages the long range and low power of LoRa® to provide real-time data monitoring of energy consumption and secure connectivity to a LoRaWAN® IoT network. It is compatible with most modern smart meters (compliant with IEC62056-21 and SML messages). The optical reading unit iO881A can be attached magnetically to the smart meter to read out the infrared interface, extract the desired values and transfer those to a LoRaWAN® network with a period defined by the user.  
+
+{% 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
+
+Before you begin, you must have downloaded the [WS-Configurator](https://wireless-solutions.de/downloads.html). Since this device can be operated using a LoRaWAN® gateway, we must first connect it to a network server that has an integration configured with ThingsBoard.  
+Afterward, it can be provisioned to ThingsBoard.
+
+{% 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 **Attributes** tab to see the attributes data received from the device.  
+
+![LoRaWAN device data](/images/devices-library/lorawan-ioke868-data.png)
+
+
+## Conclusion
+
+{% include /docs/devices-library/blocks/basic/conclusion-block.md %}

docs/devices-library/ioke868-smart-metering-kit.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect iOKE868 Smart Metering Kit to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: WirelessSolutions
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: ioke868-smart-metering-kit.png
+converters20: true
+model: iOKE868
+docsPrefix: pe/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/ioke868-smart-metering-kit.md %}

docs/paas/devices-library/ioke868-smart-metering-kit.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect iOKE868 Smart Metering Kit to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: WirelessSolutions
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: ioke868-smart-metering-kit.png
+converters20: true
+model: iOKE868
+docsPrefix: paas/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/ioke868-smart-metering-kit.md %}

docs/pe/devices-library/ioke868-smart-metering-kit.md

@@ -0,0 +1,18 @@
+---
+layout: devices-library-article
+title: How to connect iOKE868 Smart Metering Kit to ThingsBoard?
+category: Other devices
+connectivity: LoRaWAN®
+vendor: WirelessSolutions
+hasIntegrationDeviceConfiguration: true
+deviceImageFileName: ioke868-smart-metering-kit.png
+converters20: true
+model: iOKE868
+docsPrefix: pe/
+---
+
+* TOC
+{:toc}
+
+{% include get-hosts-name.html docsPrefix=page.docsPrefix %}
+{% include /docs/devices-library/guides/ioke868-smart-metering-kit.md %}