Skip to content

Releases

1.3.2

Choose a tag to compare

@balloobbot balloobbot released this 08 Nov 14:23
6fc279c

Bug fixes

  • Translate ChirpStack discovery and inventory failures into library authentication and connection exceptions, preserving the original gRPC error as the cause.
  • Preserve exception causes during connection startup.

1.3.1

Choose a tag to compare

@balloobbot balloobbot released this 07 Nov 12:29
38e3a09

Bug fixes

  • Distinguish ChirpStack HTTP/2 negotiation and TLS certificate failures from other connection errors.
  • Do not notify disconnect listeners when intentionally closing a ChirpStack connection.

Documentation

  • Update Home Assistant integration guides and backend lifecycle guidance.

1.3.0

Choose a tag to compare

@balloobbot balloobbot released this 22 Oct 00:03

The Things Network regions

Export TTN_REGIONS from lorawan_connection.backend.tts so clients can use the library's hosted region IDs in connection selectors.

Optional subscription brand filters

The brands argument to async_subscribe() now defaults to None. Omit it to subscribe to all devices.

1.2.0

Choose a tag to compare

@balloobbot balloobbot released this 16 Oct 17:45
4b97004

Gateway receptions

Uplink events now include each receiving gateway’s ID, RSSI, and SNR through GatewayReception. ChirpStack and The Things Stack populate these measurements. TTS also supports gateways identified only by EUI.

Existing callers remain compatible: UplinkEvent.receptions defaults to an empty tuple.

1.1.0

Choose a tag to compare

@balloobbot balloobbot released this 16 Oct 14:12

The Things Stack application discovery

Add TTSConnection.applications() to validate API keys and discover available applications. Application-scoped keys return their application directly; user and organization keys list applications with pagination.

Connections accept an empty application list for discovery. Select applications before reading inventory or connecting.

1.0.0

Choose a tag to compare

@balloobbot balloobbot released this 16 Oct 03:08
5b99091

Stable public API

Promote the backend-neutral connection, typed event, and device collection APIs to version 1.0. This release contains the same implementation as 0.14.1 and is compatible with existing callers.

ChirpStack and The Things Stack adapters remain available through optional dependency extras.

0.14.1

Choose a tag to compare

@balloobbot balloobbot released this 16 Oct 03:05
5b99091

Optional inventory timestamps

AddedEvent, UpdatedEvent, and RemovedEvent now default received_at to the current UTC time. Explicit timestamps remain supported; activity events still require a timestamp.

Shared subscriptions

ChirpStack, The Things Stack, and MockConnection share subscriber registration and event delivery. Existing filtering, replay, and unsubscribe behavior is preserved.

Documentation

Clarify event fields and simplify the guides and release checklist.

0.14.0

Choose a tag to compare

@balloobbot balloobbot released this 12 Oct 02:50

Connection stack type

Connections now expose stack_type: "chirpstack" or "tts" for the included backends.

Custom backends must expose this value before connecting and use it for each descriptor's stack.

MockConnection accepts a stack_type keyword argument, defaulting to "chirpstack".

0.13.0

Choose a tag to compare

@balloobbot balloobbot released this 10 Oct 03:47

Subscription listeners

Rename subscription parameters from callback to listener across connections, collections, and the subscribe() helper.

Replace callback= with listener= in calls and custom backend method signatures. Existing positional calls continue to work. ChirpStack, The Things Stack, and MockConnection use the new names.

0.12.0

Choose a tag to compare

@balloobbot balloobbot released this 08 Oct 15:41

Generic device collections

Create DeviceCollection(connection) without model classes to track every device exposed by the connection, including devices without a known catalog identity. Collections with registered models continue to select matching devices. Pass an explicit empty model list to select none.

Stored LoRaWAN status

Device stores incoming status reports before calling the model's handle_event(). Read latest_status, battery_level, external_power_source, and downlink_margin without calling a superclass handler. Vendor-specific battery readings remain separate from LoRaWAN MAC status.

Common status and model updates notify listeners after the event has been handled. The CLI includes the common status properties in its output.

Device library examples

The examples add SenseCAP S2102 illuminance, Dragino LHT65 telemetry, and Milesight TS201 and UC51x telemetry with official catalog identities. SenseCAP S2101 and S2102 accept FPorts 1 and 2. UC51x support reports state without sending valve commands.

Captured S2101, S2102, and TS201 payloads are included as offline regression fixtures. These device libraries are examples; the installed package remains the shared connection library.

Documentation

Each event class now has its own field table. The modelling and testing guides cover generic collections, common status, and captured payload fixtures.