LoRaPaws32

LoRa-based pet tracker with GPS tracking, LoRa radio communication, and web UI.

Repositories

This is a meta-repo. The project components are in separate repositories:

Repository	Description
lorapaws32-firmware	ESP-IDF C++ firmware for ESP32-S3/C6
lorapaws32-hardware	KiCad PCB designs and enclosure files
lorapaws32-base-station	Python Flask web app for Raspberry Pi

Quick Start

Clone all repositories at once:

bash clone-all.sh

Architecture

flowchart LR
    T[Tracker<br/>ESP32C6] <-->|BLE| P[Phone]
    T -->|LoRa| B[Base Station<br/>Raspberry Pi]
    B -->|MQTT| H[(HiveMQ<br/>Broker)]
    B -->|HTTP| W[Web UI<br/>Flask]

Loading

Contract Documents

These documents define the interfaces between components:

Document	Description
docs/hardware/PINOUT.md	Pin assignments and hardware connections
docs/PROTOCOL.md	LoRa packet binary format specification

Documentation

Document	Description
docs/hardware/PINOUT.md	Pin assignments and hardware connections
docs/PROTOCOL.md	LoRa packet format between firmware and base station

License

• Code (firmware, base station): MIT License
• Hardware designs & documentation: CC BY-NC-SA 4.0