lkml.org 
[lkml]   [2010]   [Dec]   [13]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 1/3] IIO: Direct digital synthesis abi documentation
    Date
    From: Michael Hennerich <michael.hennerich@analog.com>

    Changes since RFC/v1:
    IIO: Apply list review feedback:

    Apply list review feedback:
    Restructure documentation according to list feedback.
    Rename attributes to fit IIO convention used in other drivers.
    Fix typos.
    Provide ddsX_out_enable as opposed to ddsX_out_disable

    Signed-off-by: Michael Hennerich <michael.hennerich@analog.com>
    Reviewed-by: Jonathan Cameron <jic23@cam.ac.uk>
    ---
    .../staging/iio/Documentation/sysfs-bus-iio-dds | 94 ++++++++++++++++++++
    1 files changed, 94 insertions(+), 0 deletions(-)
    create mode 100644 drivers/staging/iio/Documentation/sysfs-bus-iio-dds

    diff --git a/drivers/staging/iio/Documentation/sysfs-bus-iio-dds b/drivers/staging/iio/Documentation/sysfs-bus-iio-dds
    new file mode 100644
    index 0000000..6791174
    --- /dev/null
    +++ b/drivers/staging/iio/Documentation/sysfs-bus-iio-dds
    @@ -0,0 +1,94 @@
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_freqY
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Stores frequency into tuning word register Y.
    + There can be more than one ddsX_freqY file, which allows for
    + pin controlled FSK Frequency Shift Keying
    + (ddsX_pincontrol_freq_en is active) or the user can control
    + the desired active tuning word by writing Y to the
    + ddsX_freqsymbol file.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_freqY_scale
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Scale to be applied to ddsX_freqY in order to obtain the
    + desired value in Hz. If shared across all frequency registers
    + Y is not present. It is also possible X is not present if
    + shared across all channels.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_freqsymbol
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Specifies the active output frequency tuning word. The value
    + corresponds to the Y in ddsX_freqY. To exit this mode the user
    + can write ddsX_pincontrol_freq_en or ddsX_out_disable file.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_phaseY
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Stores phase into phase register Y.
    + There can be more than one ddsX_phaseY file, which allows for
    + pin controlled PSK Phase Shift Keying
    + (ddsX_pincontrol_phase_en is active) or the user can
    + control the desired phase Y which is added to the phase
    + accumulator output by writing Y to the en_phase file.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_phaseY_scale
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Scale to be applied to ddsX_phaseY in order to obtain the
    + desired value in rad. If shared across all phase registers
    + Y is not present. It is also possible X is not present if
    + shared across all channels.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_phasesymbol
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Specifies the active phase Y which is added to the phase
    + accumulator output. The value corresponds to the Y in
    + ddsX_phaseY. To exit this mode the user can write
    + ddsX_pincontrol_phase_en or disable file.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_pincontrol_en
    +What: /sys/bus/iio/devices/device[n]/ddsX_pincontrol_freq_en
    +What: /sys/bus/iio/devices/device[n]/ddsX_pincontrol_phase_en
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + ddsX_pincontrol_en: Both, the active frequency and phase is
    + controlled by the respective phase and frequency control inputs.
    + In case the device in question allows to independent controls,
    + then there are dedicated files (ddsX_pincontrol_freq_en,
    + ddsX_pincontrol_phase_en).
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_out_enable
    +What: /sys/bus/iio/devices/device[n]/ddsX_outY_enable
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + ddsX_out_enable: Enables signal generation on all outputs
    + of channel X.
    + ddsX_outY_enable: Enables signal generation on output Y,
    + of channel X.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_outY_wavetype
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Specifies the output waveform.
    + (sine, triangle, ramp, square, ...)
    + For a list of available output waveform options read
    + available_output_modes.
    +
    +What: /sys/bus/iio/devices/device[n]/ddsX_outY_wavetype_available
    +KernelVersion: 2.6.37
    +Contact: linux-iio@vger.kernel.org
    +Description:
    + Lists all available output waveform options.
    --
    1.6.0.2


    \
     
     \ /
      Last update: 2010-12-13 17:39    [W:0.027 / U:0.348 seconds]
    ©2003-2016 Jasper Spaans. hosted at Digital OceanAdvertise on this site