Metadata-Version: 2.4
Name: awaro
Version: 0.2.1
Summary: Companion CLI of the Awaro LoRaWAN gateway (awaro.fr): discover gateways, health status, live decoded frames, USB-to-MQTT/Home Assistant bridge.
Maintainer: Awaro
License: MIT
Project-URL: Homepage, https://awaro.fr
Project-URL: Repository, https://github.com/Di-Ny/awaro
Project-URL: Software (lorawan2mqtt), https://github.com/lorawan2mqtt/lorawan2mqtt
Keywords: lorawan,awaro,gateway,mqtt,home-assistant
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Home Automation
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: lorawan2mqtt>=0.0.2

# awaro

Companion CLI of **Awaro**, an autonomous LoRaWAN gateway (hardware
product) — see <https://awaro.fr>.

```bash
pip install awaro

awaro find                      # discover gateways (LAN sweep + USB ports)
awaro status 192.168.1.68       # readable health report of one gateway
awaro backup 192.168.1.68       # save sensors/integrations/config to a file
awaro restore 192.168.1.68 f.json   # push a backup back (new or replaced box)
awaro update 192.168.1.68 --install latest   # firmware check + install
awaro lns 192.168.1.68          # LoRaWAN server overview (sensors, integrations)
awaro lns 192.168.1.68 adr off               # ADR engine kill-switch (fw 3.4.1+)
awaro lns 192.168.1.68 adr FGLR_02 9         # manual ADR: target SF for one sensor
awaro lns 192.168.1.68 test Milesight 01756403673401046865   # codec dry-run
awaro lns 192.168.1.68 downlink vanne01 03FF --fport 5       # queue a downlink
awaro log --port /dev/ttyUSB0   # live decoded sensor frames in the terminal
awaro bridge --port /dev/ttyUSB0 --mqtt-host 127.0.0.1
                                # USB "dongle" mode: MQTT + HA discovery
```

`awaro log` and `awaro bridge` read the gateway's USB serial stream: every
LoRaWAN frame arrives **already decoded** by the gateway (firmware 3.4.0+) —
named values, units, Home Assistant device classes — zero cloud, zero WiFi,
zero codec configuration on the host:

```
12:23:08  up   FGLR_02   SF12 RSSI -84  bat=3.87V  sht45_temp=24.33°C  sht45_hum=70.87%
```

The bridge implementation lives in the open-source
[lorawan2mqtt](https://github.com/lorawan2mqtt/lorawan2mqtt) project
(community codec database + bridges), installed as a dependency.
