Repository navigation
Releases
1.3.2
1.3.1
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
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
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
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
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
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
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
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
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.