LoRa P2P Interoperability Suite — BitDogLab (RP2040)

High-performance LoRa Point-to-Point (P2P) communication firmware for the BitDogLab platform (Raspberry Pi Pico / RP2040) and the SX1276 radio.

🌟 Project Highlights

• Modular Architecture: Clear separation between application logic, hardware drivers (LoRa, OLED, Buttons), and configuration layers.
• Cross-Platform Interoperability: Designed to communicate natively with the ROS2_LR (ESP32) stack.
• Intelligent Handshake: Binary Ping-Pong protocol for precise real-time latency measurement.

📊 Telemetry and Diagnostics

• RSSI & SNR: Complete monitoring of signal strength and clarity.
• Moving Average: RSSI smoothing for stable distance estimation.
• PDR (Packet Delivery Ratio): Real-time packet success rate calculation.
• Auto-Retransmission: Automatic packet resend upon acknowledgment failure.
• Watchdog Timer: Hardware protection against Radio/SPI hangs.

🎮 User Interface

• Combo A+B: Toggles between Gateway and Target modes.
• Button A: Changes the Spreading Factor (SF7 to SF12) on the fly.
• 4-Line OLED: Displays latency, average RSSI, SNR, distance, and PDR statistics.

---

📂 Project Structure

LoRa/
├── main.c                # Application logic & state machine
├── include/
│   └── config.h          # Configuration tokens & pin mapping
└── drivers/
    ├── lora/             # SX1276 Radio abstraction layer
    ├── display/          # Optimized SSD1306 OLED driver
    └── buttons/          # Debounce & combo detection logic

🛠️ Requirements

• Raspberry Pi Pico SDK (v2.0.0+)
• CMake & Ninja/Make
• Picotool (for CLI flashing)

🔨 Build & Deploy

1. Initialize build folder: mkdir build && cd build
2. Generate build files: cmake -G Ninja ..
3. Compile: ninja
4. Flash (PowerShell): ./flash_all.ps1

🔗 References

• Base Repository: iglesiojunior/ROS2_LR

---

Developed for advanced LoRa P2P network analysis.