lighthouse-manager 0.1.0

Control SteamVR Lighthouse base stations (V1 & V2) via Bluetooth LE
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use anyhow::Result;
use tracing::info;

use crate::{lighthouse::LighthouseVersion, storage};

/// Discover nearby lighthouses and save them to the database.
/// Newly discovered units are added unmanaged; existing entries are preserved (dedup by address).
///
/// # Errors
///
/// Returns an error if no Bluetooth adapter is available, BLE scanning fails,
/// or the database cannot be loaded or saved.
pub async fn run(timeout_secs: u64) -> Result<()> {
    let adapter = crate::bluetooth::get_adapter().await?;

    let discovered = crate::bluetooth::discover_lighthouses(&adapter, timeout_secs).await?;

    if discovered.is_empty() {
        info!("No Lighthouse base stations found.");
        return Ok(());
    }

    // Load the database (creates it if doesn't exist)
    let mut db = storage::load()?;
    let new_count = storage::add_new(&mut db, &discovered);

    storage::save(&db)?;

    info!(
        discovered = discovered.len(),
        new_entries = new_count,
        "discovery complete"
    );

    info!("Lighthouses found:");
    for lh in &discovered {
        info!(name = %lh.name, address = %lh.address, managed = lh.managed, "found");
        let id_info = match (lh.version() == LighthouseVersion::V1, &lh.id) {
            (true, Some(id)) => format!(" V1 ID: {id}"),
            (true, None) => " WARNING: missing V1 ID - edit config".to_string(),
            _ => String::new(),
        };
        if !id_info.is_empty() {
            info!(device = %lh.name, details = %id_info);
        }
    }

    if new_count > 0 {
        info!("Use `lighthouse-manager list --managed` to see managed lighthouses.");
    }

    Ok(())
}