"""
Bluetooth-specific constants for the unified scanner.
"""

from __future__ import annotations

# =============================================================================
# SCANNER SETTINGS
# =============================================================================

# Default scan duration in seconds
DEFAULT_SCAN_DURATION = 10

# Maximum concurrent observations per device before pruning
MAX_RSSI_SAMPLES = 300

# Device expiration time (seconds since last seen)
DEVICE_STALE_TIMEOUT = 300  # 5 minutes

# Observation history retention (seconds)
OBSERVATION_HISTORY_RETENTION = 3600  # 1 hour

# =============================================================================
# RSSI THRESHOLDS FOR RANGE BANDS
# =============================================================================

# RSSI ranges for distance estimation (dBm)
RSSI_VERY_CLOSE = -40   # >= -40 dBm
RSSI_CLOSE = -55        # -40 to -55 dBm
RSSI_NEARBY = -70       # -55 to -70 dBm
RSSI_FAR = -85          # -70 to -85 dBm

# Minimum confidence levels for each range band
CONFIDENCE_VERY_CLOSE = 0.7
CONFIDENCE_CLOSE = 0.6
CONFIDENCE_NEARBY = 0.5
CONFIDENCE_FAR = 0.4

# =============================================================================
# HEURISTIC THRESHOLDS
# =============================================================================

# Persistent detection: minimum seen count in analysis window
PERSISTENT_MIN_SEEN_COUNT = 10
PERSISTENT_WINDOW_SECONDS = 300  # 5 minutes

# Beacon-like detection: maximum advertisement interval variance (ratio)
BEACON_INTERVAL_MAX_VARIANCE = 0.10  # 10%

# Strong + Stable detection thresholds
STRONG_RSSI_THRESHOLD = -50  # dBm
STABLE_VARIANCE_THRESHOLD = 5  # dBm variance

# New device window (seconds since baseline set)
NEW_DEVICE_WINDOW = 60

# =============================================================================
# DBUS SETTINGS (BlueZ)
# =============================================================================

# BlueZ DBus service names
BLUEZ_SERVICE = 'org.bluez'
BLUEZ_ADAPTER_INTERFACE = 'org.bluez.Adapter1'
BLUEZ_DEVICE_INTERFACE = 'org.bluez.Device1'
DBUS_PROPERTIES_INTERFACE = 'org.freedesktop.DBus.Properties'
DBUS_OBJECT_MANAGER_INTERFACE = 'org.freedesktop.DBus.ObjectManager'

# DBus paths
BLUEZ_PATH = '/org/bluez'

# Discovery filter settings
DISCOVERY_FILTER_TRANSPORT = 'auto'  # 'bredr', 'le', or 'auto'
DISCOVERY_FILTER_RSSI = -100  # Minimum RSSI for discovery
DISCOVERY_FILTER_DUPLICATE_DATA = True

# =============================================================================
# FALLBACK SCANNER SETTINGS
# =============================================================================

# bleak scan timeout
BLEAK_SCAN_TIMEOUT = 10.0

# hcitool command timeout
HCITOOL_TIMEOUT = 15.0

# bluetoothctl command timeout
BLUETOOTHCTL_TIMEOUT = 10.0

# btmgmt command timeout
BTMGMT_TIMEOUT = 10.0

# Generic subprocess timeout (short operations)
SUBPROCESS_TIMEOUT_SHORT = 5.0

# =============================================================================
# ADDRESS TYPE CLASSIFICATIONS
# =============================================================================

ADDRESS_TYPE_PUBLIC = 'public'
ADDRESS_TYPE_RANDOM = 'random'
ADDRESS_TYPE_RANDOM_STATIC = 'random_static'
ADDRESS_TYPE_RPA = 'rpa'  # Resolvable Private Address
ADDRESS_TYPE_NRPA = 'nrpa'  # Non-Resolvable Private Address
ADDRESS_TYPE_UUID = 'uuid'  # CoreBluetooth platform UUID (macOS, no real MAC available)

# =============================================================================
# PROTOCOL TYPES
# =============================================================================

PROTOCOL_BLE = 'ble'
PROTOCOL_CLASSIC = 'classic'
PROTOCOL_AUTO = 'auto'

# =============================================================================
# RANGE BAND NAMES
# =============================================================================

RANGE_VERY_CLOSE = 'very_close'
RANGE_CLOSE = 'close'
RANGE_NEARBY = 'nearby'
RANGE_FAR = 'far'
RANGE_UNKNOWN = 'unknown'

# =============================================================================
# PROXIMITY BANDS (new visualization system)
# =============================================================================

PROXIMITY_IMMEDIATE = 'immediate'  # < 1m
PROXIMITY_NEAR = 'near'           # 1-3m
PROXIMITY_FAR = 'far'             # 3-10m
PROXIMITY_UNKNOWN = 'unknown'

# RSSI thresholds for proximity band classification (dBm)
PROXIMITY_RSSI_IMMEDIATE = -40  # >= -40 dBm -> immediate
PROXIMITY_RSSI_NEAR = -55       # >= -55 dBm -> near
PROXIMITY_RSSI_FAR = -75        # >= -75 dBm -> far

# =============================================================================
# DISTANCE ESTIMATION SETTINGS
# =============================================================================

# Path-loss exponent for indoor environments (typical range: 2-4)
DISTANCE_PATH_LOSS_EXPONENT = 2.5

# Reference RSSI at 1 meter (typical BLE value)
DISTANCE_RSSI_AT_1M = -59

# EMA smoothing alpha (higher = more responsive, lower = smoother)
DISTANCE_EMA_ALPHA = 0.3

# Variance thresholds for confidence scoring (dBm^2)
DISTANCE_LOW_VARIANCE = 25.0    # High confidence
DISTANCE_HIGH_VARIANCE = 100.0  # Low confidence

# =============================================================================
# RING BUFFER SETTINGS
# =============================================================================

# Observation retention period (minutes)
RING_BUFFER_RETENTION_MINUTES = 30

# Minimum interval between observations per device (seconds)
RING_BUFFER_MIN_INTERVAL_SECONDS = 2.0

# Maximum observations stored per device
RING_BUFFER_MAX_OBSERVATIONS = 1000

# =============================================================================
# HEATMAP SETTINGS
# =============================================================================

# Default time window for heatmap (minutes)
HEATMAP_DEFAULT_WINDOW_MINUTES = 10

# Default bucket size for downsampling (seconds)
HEATMAP_DEFAULT_BUCKET_SECONDS = 10

# Maximum devices to show in heatmap
HEATMAP_MAX_DEVICES = 50

# =============================================================================
# COMMON MANUFACTURER IDS (OUI -> Name mapping for common vendors)
# =============================================================================

MANUFACTURER_NAMES = {
    0x004C: 'Apple, Inc.',
    0x0006: 'Microsoft',
    0x000F: 'Broadcom',
    0x0075: 'Samsung Electronics',
    0x00E0: 'Google',
    0x0157: 'Xiaomi',
    0x0310: 'Bose Corporation',
    0x0059: 'Nordic Semiconductor',
    0x0046: 'Sony Corporation',
    0x0002: 'Intel Corporation',
    0x0087: 'Garmin International',
    0x00D2: 'Fitbit',
    0x0154: 'Huawei Technologies',
    0x038F: 'Tile, Inc.',
    0x0301: 'Jabra',
    0x01DA: 'Anker Innovations',
}

# =============================================================================
# BLUETOOTH CLASS OF DEVICE DECODING
# =============================================================================

# Major device classes (bits 12-8 of CoD)
MAJOR_DEVICE_CLASSES = {
    0x00: 'Miscellaneous',
    0x01: 'Computer',
    0x02: 'Phone',
    0x03: 'LAN/Network Access Point',
    0x04: 'Audio/Video',
    0x05: 'Peripheral',
    0x06: 'Imaging',
    0x07: 'Wearable',
    0x08: 'Toy',
    0x09: 'Health',
    0x1F: 'Uncategorized',
}

# Minor device classes for Audio/Video (0x04)
MINOR_AUDIO_VIDEO = {
    0x00: 'Uncategorized',
    0x01: 'Wearable Headset',
    0x02: 'Hands-free Device',
    0x04: 'Microphone',
    0x05: 'Loudspeaker',
    0x06: 'Headphones',
    0x07: 'Portable Audio',
    0x08: 'Car Audio',
    0x09: 'Set-top Box',
    0x0A: 'HiFi Audio Device',
    0x0B: 'VCR',
    0x0C: 'Video Camera',
    0x0D: 'Camcorder',
    0x0E: 'Video Monitor',
    0x0F: 'Video Display and Loudspeaker',
    0x10: 'Video Conferencing',
    0x12: 'Gaming/Toy',
}

# Minor device classes for Phone (0x02)
MINOR_PHONE = {
    0x00: 'Uncategorized',
    0x01: 'Cellular',
    0x02: 'Cordless',
    0x03: 'Smartphone',
    0x04: 'Wired Modem',
    0x05: 'ISDN Access Point',
}

# Minor device classes for Computer (0x01)
MINOR_COMPUTER = {
    0x00: 'Uncategorized',
    0x01: 'Desktop Workstation',
    0x02: 'Server-class Computer',
    0x03: 'Laptop',
    0x04: 'Handheld PC/PDA',
    0x05: 'Palm-size PC/PDA',
    0x06: 'Wearable Computer',
    0x07: 'Tablet',
}

# Minor device classes for Peripheral (0x05)
MINOR_PERIPHERAL = {
    0x00: 'Not Keyboard/Pointing Device',
    0x01: 'Keyboard',
    0x02: 'Pointing Device',
    0x03: 'Combo Keyboard/Pointing Device',
}

# Minor device classes for Wearable (0x07)
MINOR_WEARABLE = {
    0x01: 'Wristwatch',
    0x02: 'Pager',
    0x03: 'Jacket',
    0x04: 'Helmet',
    0x05: 'Glasses',
}

# =============================================================================
# BLE APPEARANCE CODES (GAP Appearance values)
# =============================================================================

BLE_APPEARANCE_NAMES: dict[int, str] = {
    0: 'Unknown',
    64: 'Phone',
    128: 'Computer',
    192: 'Watch',
    193: 'Sports Watch',
    256: 'Clock',
    320: 'Display',
    384: 'Remote Control',
    448: 'Eye Glasses',
    512: 'Tag',
    576: 'Keyring',
    640: 'Media Player',
    704: 'Barcode Scanner',
    768: 'Thermometer',
    832: 'Heart Rate Sensor',
    896: 'Blood Pressure',
    960: 'HID',
    961: 'Keyboard',
    962: 'Mouse',
    963: 'Joystick',
    964: 'Gamepad',
    965: 'Digitizer Tablet',
    966: 'Card Reader',
    967: 'Digital Pen',
    968: 'Barcode Scanner (HID)',
    1024: 'Glucose Monitor',
    1088: 'Running Speed Sensor',
    1152: 'Cycling',
    1216: 'Control Device',
    1280: 'Network Device',
    1344: 'Sensor',
    1408: 'Light Fixture',
    1472: 'Fan',
    1536: 'HVAC',
    1600: 'Access Control',
    1664: 'Motorized Device',
    1728: 'Power Device',
    1792: 'Light Source',
    3136: 'Pulse Oximeter',
    3200: 'Weight Scale',
    3264: 'Personal Mobility',
    5184: 'Outdoor Sports Activity',
}


def get_appearance_name(code: int | None) -> str | None:
    """Look up a human-readable name for a BLE appearance code."""
    if code is None:
        return None
    return BLE_APPEARANCE_NAMES.get(code)