Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758200Ab0LMQfG (ORCPT ); Mon, 13 Dec 2010 11:35:06 -0500 Received: from nwd2mail10.analog.com ([137.71.25.55]:26298 "EHLO nwd2mail10.analog.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1758050Ab0LMQfB (ORCPT ); Mon, 13 Dec 2010 11:35:01 -0500 X-IronPort-AV: E=Sophos;i="4.59,336,1288584000"; d="scan'208";a="26123851" From: To: linux-iio@vger.kernel.org, jic23@cam.ac.uk CC: linux-kernel@vger.kernel.org, drivers@analog.com, device-drivers-devel@blackfin.uclinux.org, Michael Hennerich Subject: [PATCH 2/3] IIO: dds.h convenience macros Date: Mon, 13 Dec 2010 17:27:23 +0100 Message-ID: <1292257644-26477-2-git-send-email-michael.hennerich@analog.com> X-Mailer: git-send-email 1.6.0.2 In-Reply-To: <1292257644-26477-1-git-send-email-michael.hennerich@analog.com> References: <1292257644-26477-1-git-send-email-michael.hennerich@analog.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 6030 Lines: 182 From: Michael Hennerich Changes since RFC/v1: IIO: Apply list review feedback Apply list review feedback: Rename attributes to fit IIO convention used in other drivers. Provide ddsX_out_enable as opposed to ddsX_out_disable. Fix typos. Signed-off-by: Michael Hennerich --- drivers/staging/iio/dds/dds.h | 152 +++++++++++++++++++++++++++++++++++++++++ 1 files changed, 152 insertions(+), 0 deletions(-) create mode 100644 drivers/staging/iio/dds/dds.h diff --git a/drivers/staging/iio/dds/dds.h b/drivers/staging/iio/dds/dds.h new file mode 100644 index 0000000..a8dd7be --- /dev/null +++ b/drivers/staging/iio/dds/dds.h @@ -0,0 +1,152 @@ +/* + * dds.h - sysfs attributes associated with DDS devices + * + * Copyright (c) 2010 Analog Devices Inc. + * + * Licensed under the GPL-2 or later. + */ + +/** + * /sys/bus/iio/devices/device[n]/ddsX_freqY + * 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. + */ + +#define IIO_DEV_ATTR_FREQ(_device, _num, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_freq##_num, S_IWUSR, NULL, _store, _addr) + +/** + * /sys/bus/iio/devices/device[n]/ddsX_freqY_scale + * 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. + */ + +#define IIO_CONST_ATTR_FREQ_SCALE(_device, _string) \ + IIO_CONST_ATTR(dds##_device##_freq_scale, _string) + +/** + * /sys/bus/iio/devices/device[n]/ddsX_freqsymbol + * 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. + */ + +#define IIO_DEV_ATTR_FREQSYMBOL(_device, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_freqsymbol, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_phaseY + * 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. + */ + +#define IIO_DEV_ATTR_PHASE(_device, _num, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_phase##_num, \ + S_IWUSR, NULL, _store, _addr) + +/** + * /sys/bus/iio/devices/device[n]/ddsX_phaseY_scale + * 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. + */ + +#define IIO_CONST_ATTR_PHASE_SCALE(_device, _string) \ + IIO_CONST_ATTR(dds##_device##_phase_scale, _string) + +/** + * /sys/bus/iio/devices/device[n]/ddsX_phasesymbol + * 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. + */ + +#define IIO_DEV_ATTR_PHASESYMBOL(_device, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_phasesymbol, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_pincontrol_en + * Description: + * Both, the active frequency and phase is controlled by the respective + * phase and frequency control inputs. + */ + +#define IIO_DEV_ATTR_PINCONTROL_EN(_device, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_pincontrol_en, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_pincontrol_freq_en + * Description: + * The active frequency is controlled by the respective + * frequency control/select inputs. + */ + +#define IIO_DEV_ATTR_PINCONTROL_FREQ_EN(_device, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_pincontrol_freq_en, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_pincontrol_phase_en + * Description: + * The active phase is controlled by the respective + * phase control/select inputs. + */ + +#define IIO_DEV_ATTR_PINCONTROL_PHASE_EN(_device, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_pincontrol_phase_en, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_out_enable + * Description: + * Disables any signal generation on all outputs. + */ + +#define IIO_DEV_ATTR_OUT_ENABLE(_device, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_out_enable, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_outY_enable + * Description: + * Disables any signal generation on output Y. + */ + +#define IIO_DEV_ATTR_OUTY_ENABLE(_device, _output, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_out##_output##_enable, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_outY_wavetype + * Description: + * Specifies the output waveform. (sine, triangle, ramp, square, ...) + * For a list of available output waveform options read available_output_modes. + */ +#define IIO_DEV_ATTR_OUT_WAVETYPE(_device, _output, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_device##_out##_output##_wavetype, \ + S_IWUSR, NULL, _store, _addr); + +/** + * /sys/bus/iio/devices/device[n]/ddsX_outY_wavetype_available + * Description: + * Lists all available output waveform options. + */ +#define IIO_CONST_ATTR_OUT_WAVETYPES_AVAILABLE(_device, _output, _modes)\ + IIO_CONST_ATTR(dds##_device##_out##_output##_wavetype_available,\ + _modes); -- 1.6.0.2 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/