Thread Rating:
  • 0 Vote(s) - 0 Average
  • 1
  • 2
  • 3
  • 4
  • 5
Class: Tuner
#1
General Description

This thread is for discussion of the device class for radio tuners, over the air or virtual and so forth. The functionality here is fairly limited. Dedicated tuner devices, many A/V processors, and some other media type devices are likely to implement this class.

Fields Provided
[INDENT]The fields provided by this device class have pre-determined names, and these MUST be implemented as indicated here. They are all prefixed by the device class prefix in one of these forms:

TUNR#fieldname
TUNR#sub~fieldname

where TUNR# indicates it is a field of this device class, and fieldname meets the general requirements of CQC field names. It will not be uncommon that there will be multi-unit concerns, since many devices that support multiple internal powered units. See below for multi-unit concerns.

The fields provided by this class are:
  • CurPreset. This field supports the common functionality of tuners to support presets. This field MUST be a string type. It MUST be readable, so that the current preset can be displayed. If the device doesn't make this information available, then leave it blank. If the device supports direct setting of presets, then it MAY be writeable and have an enumerated limit that indicates the available presets.
  • CurFrequency. This field MUST be read only, and be a text field into which the current selected frequency is placed. If the device doesn't make this information available, the driver MUST leave the field blank.
  • NextPrevPreset. This field MUST be Boolean, and write only. Writing False to it will move to the previous preset, and writing True will move to the next preset. If toggling in one or both directions is unavailable, then do nothing. If this sort of toggling isn't directly supported, the driver should where possible fake it via reading, incrementing/decrementing, and writing back out the current preset.
[/INDENT]

Power Management Issues
[INDENT]Any drivers that implements this class MUST also implement Power.[/INDENT]

Multi-Unit Considerations

[INDENT]It is not unlikely that this device class will be used within a device that supports multiple, independent sub-units. Where that is the case, apply the same per-sub-unit prefix to these fields that are otherwise being used in that driver, or user provided sub-unit names.[/INDENT]


Backdoor Commands/Queries

[INDENT]None are required at this time.[/INDENT]
Dean Roddey
Explorans limites defectum
Reply
#2
(reserved for expansion)
Dean Roddey
Explorans limites defectum
Reply
#3
(reserved for expansion 2)
Dean Roddey
Explorans limites defectum
Reply
#4
Took a basic whack at this one. Though obviously more could be provided, this is probably enough for generic control and wide support. Is there anything else that could be reasonably expected to be supported widely?

I guess maybe it needs to deal with the issue not only of multi-unit support, but also multi-source support? I.e. there's an over the air tuner, an HD Radio tuner, etc... in the same machine. Not sure now to best deal with that.
Dean Roddey
Explorans limites defectum
Reply


Possibly Related Threads…
Thread Author Replies Views Last Post
  Class: Security Dean Roddey 34 35,414 01-02-2019, 12:26 PM
Last Post: Dean Roddey
  Class: Weather Dean Roddey 6 6,687 10-11-2018, 11:09 AM
Last Post: Dean Roddey
  Class: Thermostat Dean Roddey 17 26,466 01-29-2016, 10:15 AM
Last Post: Dean Roddey
  Class: SceneCtrl Dean Roddey 20 20,826 03-31-2015, 12:38 PM
Last Post: Dean Roddey
  Class: Irrigation Dean Roddey 8 9,526 01-28-2015, 12:09 PM
Last Post: Dean Roddey
  Class: NowPlaying Dean Roddey 8 9,780 09-23-2014, 02:01 PM
Last Post: Dean Roddey
  Class: Switcher Dean Roddey 9 10,621 08-20-2014, 08:17 AM
Last Post: Dean Roddey
  Class: Projector Dean Roddey 29 27,001 08-11-2014, 08:56 AM
Last Post: Dean Roddey
  Class: Lock Dean Roddey 5 7,189 07-31-2014, 01:24 PM
Last Post: Dean Roddey
  Class: ContactClosure Dean Roddey 7 8,738 07-31-2014, 10:14 AM
Last Post: Dean Roddey

Forum Jump:


Users browsing this thread: 1 Guest(s)