Revert "[thethingsnetwork] Update the to v3" (#32042)

source/_integrations/thethingsnetwork.markdown

@@ -5,28 +5,32 @@ ha_category:
   - Hub
   - Sensor
 ha_release: 0.55
-ha_iot_class: Cloud Polling
+ha_iot_class: Local Push
 ha_codeowners:
-  - '@angelnu'
+  - '@fabaff'
 ha_domain: thethingsnetwork
 ha_platforms:
   - sensor
 ha_integration_type: integration
 ---
 
+<div class='note warning'>
+  This integration only supports TTNv2 that has been definitively switched off in 2022 (deprecated).
+  For TTNv3, use the [MQTT integration](/integrations/mqtt).
+</div>
+
 The `thethingsnetwork` integration allows one to interact with the [The Things Network](https://www.thethingsnetwork.org). This community-driven and open network supports [LoRaWAN](https://www.lora-alliance.org/) for long range (~5 to 15 km) communication with a low bandwidth (51 bytes/message). [Gateways](https://www.thethingsnetwork.org/docs/gateways/) transfers the received data from the sensors to the The Things Network.
 
 The Things network support various integrations to make the data available:
 
 | The Things Network Integration | Home Assistant platform |
 |---|---|
-| [MQTT](https://www.thethingsindustries.com/docs/integrations/mqtt) | [`MQTT`](integrations/mqtt) |
+| [MQTT](https://www.thethingsnetwork.org/docs/applications/mqtt/) | |
-| [Storage](https://www.thethingsindustries.com/docs/integrations/storage) | [`thethingsnetwork`](#setup) |
+| [Storage](https://www.thethingsnetwork.org/docs/applications/storage/) | [`thethingsnetwork`](#sensor) |
-| [HTTP](https://www.thethingsindustries.com/docs/integrations/webhooks) | |
+| [HTTP](https://www.thethingsnetwork.org/docs/applications/http/) | |
 
 There is currently support for the following device types within Home Assistant:
 
-- [Setup](#setup)
 - [Sensor](#sensor)
 
 ## Setup
@@ -35,25 +39,106 @@ Visit the [The Things Network Console](https://console.thethingsnetwork.org/) we
 
 The **Application ID** is used to identify the scope of your data.
 
-![Application overview](/images/integrations/thethingsnetwork/applications.png)
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/applications.png' />
+Application overview
+</p>
 
-1. Under the integrations menu, enable the storage integration:
+You need an access key to be able to read the data from your application.
 
-![Storage Integration](/images/integrations/thethingsnetwork/storage_integration.png)
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/access_key.png' />
+Access keys
+</p>
 
-2. Ensure you have an [Uplink Payload Formatter](https://www.thethingsindustries.com/docs/integrations/payload-formatters/) for your device.
+## Configuration
 
-![Payload Formatters](/images/integrations/thethingsnetwork/payload_formatters.png)
+To enable this integration, add the following lines to your `configuration.yaml`:
 
-3. You need an API key to be able to read the data from your application. 
+```yaml
-  - The minimal required right is `Read Application Traffic (uplink and downlink)`.
+# Example configuration.yaml entry
+thethingsnetwork:
+  app_id: sensor-123
+  access_key: ttn-account-v2.xxxxxxxxxxx_yyyyyyyyyyy
+```
 
-![API keys](/images/integrations/thethingsnetwork/apis_key.png)
+{% configuration %}
-
+app_id:
-
+  description: The Application ID.
-{% include integrations/config_flow.md %}
+  required: true
+  type: string
+access_key:
+  description: The access key.
+  required: true
+  type: string
+{% endconfiguration %}
 
 ## Sensor
 
-All uplink messages decoded by The Things Network (including a `decoded_payload` entry) will be processes by this integration. Each field in `decoded_payload` will be added as Home Assistant sensor entity.
+The `thethingsnetwork` sensor platform allows you to get data from a [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/).
 
+This platform requires that the [The Things Network integration](#configuration) is set up and the [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/) as well.
+
+### Prerequisites
+
+Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications** and go to **Integrations**.
+
+Add a new integration.
+
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/add_integration.png' />
+Add a The Things Network integration
+</p>
+
+Select **Data Storage**.
+
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/choose_integration.png' />
+Choose a The Things Network integration
+</p>
+
+Click **Add integration** to finish the process.
+
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/confirm_integration.png' />
+Add a The Things Network Data Storage integration
+</p>
+
+When done, the status of the integration should be **Running**. You could check the output after clicking on **go to platform** in an interactive web interface.
+
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/storage_integration.png' />
+Add a The Things Network integration
+</p>
+
+Select **Devices** to get the ID of your device that you want to use.
+
+<p class='img'>
+<img src='/images/integrations/thethingsnetwork/devices.png' />
+Devices overview
+</p>
+
+### Configuration
+
+To enable this platform, add the following lines to your `configuration.yaml`:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: thethingsnetwork
+    device_id: ha-demo
+    values:
+      current: ampere
+      voltage: V
+```
+
+{% configuration %}
+  device_id:
+    description: The ID of the device.
+    required: true
+    type: string
+  values:
+    description: The sensor values with their unit of measurement
+    required: true
+    type: list
+{% endconfiguration %}