Getting Started

The Aranet Rust ecosystem provides a complete solution for interacting with Aranet environmental sensors via Bluetooth Low Energy (BLE).

Prerequisites

Before you begin, ensure you have:

Rust 1.90+ installed (rustup.rs)
A Bluetooth-enabled computer (macOS, Windows, or Linux)
An Aranet sensor device

Supported Devices

Device	Sensors	Status
Aranet4	CO₂, Temperature, Humidity, Pressure	Full Support
Aranet2	Temperature, Humidity	Full Support
AranetRn+	Radon, Temperature, Pressure, Humidity	Full Support
Aranet Radiation	Dose Rate, Total Dose	Full Support

Project Structure

The Aranet ecosystem consists of seven crates:

aranet/
├── crates/
│   ├── aranet-types/    # Shared types (platform-agnostic)
│   ├── aranet-core/     # Core BLE library
│   ├── aranet-store/    # Local SQLite data persistence
│   ├── aranet-service/  # Background collector and REST API
│   ├── aranet-cli/      # Command-line interface
│   ├── aranet-tui/      # Terminal UI dashboard
│   └── aranet-gui/      # Desktop GUI (egui)
└── docs/                # Protocol documentation

Next Steps

Install the CLI using Homebrew, the release installers, crates.io, or source
Scan for devices nearby
Read sensor data from your Aranet device
Explore the BLE Protocol documentation