07-09-2014, 07:48 AM
(This post was last modified: 07-09-2014, 07:51 AM by Dean Roddey.)
General Description
This thread is for discussion of the Stereo device class. Drivers that implement this device class provide the basic sorts of controls that stereos generally offer, which are bass, treble, and balance adjustments.
This is one of those 'fractional' device classes. I.e. it's unlikely any driver would just implement this one class. It will be implemented in addition to other things.
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 the form:
STREO#sub~fieldname
where STREO# indicates it is a field of this device class, and fieldname meets the general requirements of CQC field names. If the device provides more than one set of controls, then the sub~ part will be present and will indicate the specific source instances. The same sub-unit naming convention SHOULD be applied as are used with the other related sub-units of the driver.
The fields provided by this class are listed below:
All of these fields MUST be of Int type, with a range limit of -100 to 100, where -100 represents the minimum value or the left-most balance, and 100 represents the maximum value or right-most balance. The actual range of the device MUST be mapped to this range. They MUST be readable and writeable since any really useful implementation will require display of current values for adjustment.
If the device does not implement one of these values, it MUST implement the field as read/write, default it to zero, accept writes to the field and just let written values become the current value, so that it will not cause errors, even if it doesn't function. This lacking MUST be documented in the driver docs.
Backdoor Commands/Queries
[INDENT]None are required at this time.[/INDENT]
This thread is for discussion of the Stereo device class. Drivers that implement this device class provide the basic sorts of controls that stereos generally offer, which are bass, treble, and balance adjustments.
This is one of those 'fractional' device classes. I.e. it's unlikely any driver would just implement this one class. It will be implemented in addition to other things.
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 the form:
STREO#sub~fieldname
where STREO# indicates it is a field of this device class, and fieldname meets the general requirements of CQC field names. If the device provides more than one set of controls, then the sub~ part will be present and will indicate the specific source instances. The same sub-unit naming convention SHOULD be applied as are used with the other related sub-units of the driver.
The fields provided by this class are listed below:
- Balance. This field allows for adjustment of the stereo balance
- Bass. This field allows for adjustment of the bass presence
- Treble. This field allows for adjustment of the treble presence
All of these fields MUST be of Int type, with a range limit of -100 to 100, where -100 represents the minimum value or the left-most balance, and 100 represents the maximum value or right-most balance. The actual range of the device MUST be mapped to this range. They MUST be readable and writeable since any really useful implementation will require display of current values for adjustment.
If the device does not implement one of these values, it MUST implement the field as read/write, default it to zero, accept writes to the field and just let written values become the current value, so that it will not cause errors, even if it doesn't function. This lacking MUST be documented in the driver docs.
Backdoor Commands/Queries
[INDENT]None are required at this time.[/INDENT]
Dean Roddey
Explorans limites defectum
Explorans limites defectum