feat: device enumeration and sensor API

[abc8747]

Previously, opening a device by index was unreliable.

• added a new DeviceDescriptors struct that provides an iterator over only supported RTL-SDR devices, ensuring that DeviceId::Index(n) reliably refers to the nth known RTL-SDR
• a new Sensor API is introduced to provide an interface for querying device state like tuner type and gain
• the rtl_test example has also been updated to use the new enumeration logic, supporting device selection by either filtered index or serial number

Tested with blog V4:

$ cargo run --example rtl_test
Found 1 device(s):
  0:  RTLSDRBlog, Blog V4, SN: 00000001

Using device 0: RTLSDRBlog, Blog V4, SN: 00000001
Found r828d tuner
Supported gain values (29): 0.0 0.9 1.4 2.7 3.7 7.7 8.7 12.5 14.4 15.7 16.6 19.7 20.7 22.9 25.4 28.0 29.7 32.8 33.8 36.4 37.2 38.6 40.2 42.1 43.4 43.9 44.5 48.0 49.6
Sampling at 2048000 S/s.
Reading samples in sync mode...

Addresses xoolive/jet1090#264 (comment), xoolive/jet1090#294 (impl Send for Tuner and Error will be in a separate PR)
cc: @xoolive

[xoolive]

I just added some logic in the rtl_test example program to use a -f flag and select devices based on manufacturer/product/serial.
rust-soapysdr offers something similar and I find it very convenient as far as I am concerned.

[tkj666]

I think it is better to add serial as another variant of DeviceId and move the filtering and opening to DeviceHandle like index and fd. It also avoids duplicate device enumeration.

[xoolive]

@tkj666 sorry for the delayed reply

There is actually more than serial (there is manufacturer, product, and serial), but I can try to add one more item in the enum to try to cover it all if that's ok with you.

[abc8747]

I think it is better to add serial as another variant of DeviceId and move the filtering and opening to DeviceHandle like index and fd. It also avoids duplicate device enumeration.

@tkj666 I've just implemented this, do you mind taking a look?

cc @xoolive

[tkj666]

I think it is better to add serial as another variant of DeviceId and move the filtering and opening to DeviceHandle like index and fd. It also avoids duplicate device enumeration.

@tkj666 I've just implemented this, do you mind taking a look?

cc @xoolive

Fantastic job! That should solve the problem.