DOCUMENTATION Stations / H2 LoRaWAN / Setup Guide

Onboard H2 Open Edition to The Things Network

Quick start guide to connect your WeatherXM H2 Open Edition 8-in-1 weather station to The Things Network (TTN), ChirpStack, or any LoRaWAN Network Server.

ℹ

Hardware note: The H2 uses the same hardware as the SenseCAP S2120 8-in-1 Weather Sensor ↗, but runs WeatherXM's own firmware, which does more: wind gust, a lifetime rain total and the maximum rain rate in one compact 24-byte frame, periodically signed by the station's secure element. Register it manually (OTAA) and decode it with the WeatherXM decoder, not an S2120 device profile.

TOOLS & DOCUMENTATION

Updated October 2026

Everything you need for the Open Edition

This page is the quick start. The full guide and the configuration tool are live:

Official Docs Available Now

H2 Open Edition Guide

The complete H2 Open documentation is published at docs.weatherxm.com/wxm-devices/h2-open: box contents, assembly, connecting to your network, TTN and ChirpStack setup, the payload format and decoder, installation and troubleshooting.

docs.weatherxm.com/wxm-devices/h2-open ↗

Web Flasher Available Now

Configure & Update over Bluetooth

flasher.weatherxm.com updates the station to the latest firmware and points it at your own LoRaWAN network, from Chrome or Edge with Web Bluetooth. The station keeps its WeatherXM settings, so it can potentially return to the WeatherXM network later.

flasher.weatherxm.com ↗

Mobile Apps Coming Soon

iOS & Android App Updates

We are updating the WeatherXM Android and iOS mobile applications to directly include the Open Editions of our products, enabling seamless BLE diagnostics, frequency management, and local telemetry checks.

WeatherXM Mobile App Update

Before You Begin

Prerequisites

Have your hardware, a Bluetooth-capable browser and your network account ready.

✓
Station sticker: Every H2 (Open and Helium edition) ships with a sticker showing its EUI (DevEUI), KEY, BT ID and S/N. You register the station on your network with its DevEUI. You do not need the KEY for TTN or ChirpStack: you choose your own JoinEUI and AppKey and write them to the station with the web flasher. Keep the S/N for support requests.
✓
Batteries: 6× AA 1.5 V non-rechargeable batteries for the external battery box (not included). Lithium batteries are recommended where temperatures often drop below 0 °C / 32 °F. See Station Assembly ↗.
✓
Computer or Android phone: with Bluetooth and Google Chrome or Microsoft Edge, for the web flasher ↗. Safari, Firefox and iPhone/iPad browsers do not support Web Bluetooth.
✓
LoRaWAN coverage: a public The Things Network gateway or your own gateway connected to TTN or ChirpStack, in range of the installation site.

Step 1

Assemble & Power On

Install the batteries and check that the station starts.

Install batteries: Insert the 6× AA batteries into the external battery box, observing the +/- polarity, then fit the dummy battery and the battery door supplied with the box to the bottom of the station. The assembly guide ↗ has diagrams.
Check the LED: The red LED at the bottom of the station lights up when power is connected. While the station tries to join a network the LED breathes (slowly fades in and out); once joined it turns off.

Step 2

Connect & Update Firmware

Connect over Bluetooth with the web flasher; it brings the station to the latest firmware.

Open flasher.weatherxm.com ↗ and choose WS2001 (H2). Leave Update the station firmware automatically ticked.
Click Connect and select WeatherXM WS2001 XXXXXX (older units: WeatherXM WS2000 XXXXXX), where XXXXXX is the end of the DevEUI.
The flasher shows the station's DevEUI, region, firmware version, battery and upload interval. Copy the DevEUI for the next step.

Pairing window: a computer or phone that has never connected to this station can pair only during the first 5 minutes after the station starts. If needed, restart it with one short press of the button at the bottom. Do not hold the button for 10 seconds: that is a factory reset.

Firmware update: if the station runs older firmware, the flasher installs the latest WeatherXM release (signed for the H2 bootloader). The station restarts into update mode and appears as DfuWX plus six characters (or DfuTarg) instead of "WeatherXM WS2001 …": select that name when asked. Settings, keys and the rain counter are kept.

Step 3

Register Device in TTN

Add the station to your application on The Things Stack Console.

1. Log in to The Things Stack Console and choose your cluster (e.g. Europe 1, North America 1 or Australia 1).

2. Navigate to Applications and select or create an application (for example: weatherxm-open-stations).

3. Click + Register end device and choose Enter end device specifics manually.

Manual Device Registration Settings (OTAA)

Activation Mode: Over the air activation (OTAA)

LoRaWAN Version: LoRaWAN Specification 1.0.4

Regional Params: RP002 Regional Parameters 1.0.3

Class: Class A

4. Select the Frequency plan of your region and gateway:

Europe: Europe 863-870 MHz (SF9 for RX2 - recommended)
North America: United States 902-928 MHz, FSB 2 (used by TTN)
Australia: Australia 915-928 MHz, FSB 2

5. Enter the keys:

JoinEUI / AppEUI: 16 hex characters of your choice (TTN accepts 0000000000000000)
DevEUI: the EUI from the sticker or the web flasher
AppKey: click Generate and copy it for the next step

6. Click Register end device to complete creation.

Using ChirpStack? Create a device profile with MAC version LoRaWAN 1.0.4, regional parameters RP002-1.0.3 and OTAA, then add the device with the same DevEUI, JoinEUI and AppKey. See the ChirpStack guide ↗.

Step 4

Point the Station at Your Network

Write the same keys to the station with the web flasher.

Back in the web flasher, fill in the LoRaWAN Network Configuration form:

Frequency Region: the same plan as in TTN (US915 / AU915: Sub-Band 2)
JoinEUI / AppEUI and AppKey: exactly as registered
Upload Interval: 5 minutes (default; 10 minutes or more if the station is far from the gateway)

Click Apply & Connect to My Network and confirm. The flasher switches the station to its custom network profile, keeps the WeatherXM 24-byte frame on FPort 99, and restarts the station so it joins your network. The WeatherXM settings on the station are not overwritten. Stations with older firmware are updated first.

The Things Network allows 30 seconds of airtime per device per day. A 24-byte uplink every 5 minutes stays within it at SF7; slower data rates need longer intervals.

Step 5

Verify Telemetry Uplinks

Confirm that your station has joined and is transmitting observations.

In the Console, navigate to End devices > select your H2 > open the Live data tab:

14:02:10 - Accept join-request

14:02:15 - Forward uplink data message: FPort 99, Payload: F0 45 4E 05 19 EB 00 71 ...

The red LED stops breathing once the station has joined. The first uplink arrives within a few minutes, then one every upload interval. If nothing arrives, see Troubleshooting ↗.

Step 6

Payload Formatter

Decode the WeatherXM frame into weather values in the TTN Console.

Open Payload formatters > Uplink (for the device or the whole application) and select Custom Javascript formatter.
Paste the WeatherXM H2 decoder ↗, or use the TTN v3 copy button in the web flasher. The same script works in ChirpStack v3 and v4. S2120 decoders do not understand the WeatherXM frame.
To test it, paste this example into Byte payload, set FPort to 99 and click Test decoder:

F0454E0519EB00710E181F3400393000000C0031D4009427

It decodes to (abridged):

{
  "firmware_version": "4.5",
  "frame": "weather",
  "upload_interval_min": 5,
  "temperature": 23.5,
  "humidity": 56,
  "wind_direction": 270,
  "wind_speed": 3.1,
  "wind_gust": 5.2,
  "rain_accumulated": 12.345,
  "rain_rate": 1.2,
  "uv_index": 3,
  "lux": 54321,
  "pressure": 1013.2,
  "battery_low": false
}

The full byte layout is in the payload format reference ↗. For custom integrations (MQTT, Webhooks, Home Assistant, Node-RED), subscribe to the decoded JSON feed published by your TTN application or ChirpStack instance.

Step 7

Physical Siting & Installation

Proper siting and alignment ensure accurate observations.

•
Pole & Location: Mount the station on a firmly secured pole at least 2 m / 6.5 ft above the ground or roof, away from heat sources and shade, with a clear distance from obstacles.
•
North Alignment: Locate the N marker on top of the station and align it to point North with a compass or GPS. This calibrates wind direction.
•
Bubble Level: Use the bubble level on the station to make sure it is completely level before tightening the mounting clamp, for correct rain, wind direction, UV and light measurements.
•
Solar Panel Tilt: Set the panel angle (0°, 15°, 30°, 45° or 60°) according to your latitude, as described in the assembly guide ↗. In the southern hemisphere keep the panel flat.
•
LoRaWAN Coverage: The antenna is inside the station, so check the signal (RSSI/SNR) of a few uplinks from the final position. See Station Installation ↗ for the full best practices.

Later

Back to WeatherXM

The station can potentially return to the WeatherXM network.

The web flasher ↗ has a Switch back to WeatherXM button that activates the WeatherXM settings stored on the station. If the station does not rejoin the WeatherXM network, contact WeatherXM support ↗.

Need hardware or network accessories?

WeatherXM H2 stations and mounting accessories are available in the official shop.

← H2 Station Overview Buy H2 in Shop →