Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add entities to support per-device and per-scanner options for ref_power and to exclude proxies from calculations #45

Open
agittins opened this issue Oct 15, 2023 · 1 comment
Assignees
Labels
enhancement New feature or request

Comments

@agittins
Copy link
Owner

agittins commented Oct 15, 2023

TL/DR:

  • Allow certain proxies (or local bluetooth adaptors) to be excluded from Bermuda's calculations
  • Provide per-receiver calibration via a ref_power_offset setting to account for varying receiver sensitivity
  • Provide per-device ref_power setting to allow overriding the default ref_power value.

This will allow us to account for varying beacon and receiver sensitivities caused by radio design, antenna and enclosure variations, while still allowing use of defaults for easier basic setup.

Original description:

Currently all devices use the global ref_power setting, and device names only come from local_name advertisement data, which seems unreliable but is also limiting for users, especially when doing initial setup.

Effective ref_power is a function of these variables

  • device transmitter power (as well as "reported" device tx power)
  • device antenna design, placement and enclosure
  • receiver sensitivity
  • receiver antenna design, placement and enclosure

It makes sense to be able to specify a ref power @1m value for each transmitter (device), and also an offset value for each receiver (or receiver type).

Devices:

  • Allow the user to specify a name for the device (helpful if local_name isn't known, and save renaming sensors later) (no, just let them rename in the UI. Naming seems stable now).
  • Global ref_power should be set to match one's most common transmitter/beacon.
  • Each device can optionally have a custom ref-power defined.
  • Unsure if better to define per-device setting as an offset from global ref_power or as an absolute. The latter might be less confusing.

Scanners:

  • Will eventually need a setting for co-ords anyway
  • A ref_power_offset makes more sense for scanners, since one is likely to have multiple identical scanners, but a wide range of devices. Also an absolute value wouldn't make sense as it's a function of the combination of tx/rx pair.
  • max_radius as a per-area setting makes sense, so you don't need to enter an adjacent area in order to no longer be in "this" area.
@agittins agittins self-assigned this Jan 6, 2024
@agittins agittins added the enhancement New feature or request label Jan 6, 2024
@agittins agittins changed the title Update options flow to support per-device and per-scanner options for name, ref_power Add entities to support per-device and per-scanner options for name, ref_power Mar 15, 2024
@agittins agittins changed the title Add entities to support per-device and per-scanner options for name, ref_power Add entities to support per-device and per-scanner options for ref_power Mar 25, 2024
@agittins
Copy link
Owner Author

Issue #164 is dependent on this being resolved.

@agittins agittins changed the title Add entities to support per-device and per-scanner options for ref_power Add entities to support per-device and per-scanner options for ref_power and to exclude proxies from calculations Jun 29, 2024
@agittins agittins pinned this issue Jun 29, 2024
@agittins agittins added this to the Trilateration Feature Release milestone Jul 3, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant