IIO: Direct digital synthesis abi documentation
Subsystems (4)
[email protected]
maintainerPATCH 1/3 IIO: Direct digital synthesis abi documentation
From: Michael Hennerich <[email protected]>
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
Changes since v2:
IIO: sysfs-bus-iio-dds: Apply more list review feedback
Fix mixture of X and [n] notation for indices. Fix some wording in the descriptions.
--- .../staging/iio/Documentation/sysfs-bus-iio-dds | 93 ++++++++++++++++++++ 1 files changed, 93 insertions(+), 0 deletions(-) create mode 100644 drivers/staging/iio/Documentation/sysfs-bus-iio-dds
drivers/staging/iio/Documentation/sysfs-bus-iio-dds new file +93 -0
@@ -0,0 +1,93 @@ + +What: /sys/bus/iio/devices/.../ddsX_freqY +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + Stores frequency into tuning word Y. + There will 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/.../ddsX_freqY_scale +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_freqsymbol +KernelVersion: 2.6.37 +Contact: [email protected] +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_enable file. + +What: /sys/bus/iio/devices/.../ddsX_phaseY +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + Stores phase into Y. + There will 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/.../ddsX_phaseY_scale +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_phasesymbol +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_pincontrol_en +What: /sys/bus/iio/devices/.../ddsX_pincontrol_freq_en +What: /sys/bus/iio/devices/.../ddsX_pincontrol_phase_en +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_out_enable +What: /sys/bus/iio/devices/.../ddsX_outY_enable +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + ddsX_outY_enable controls signal generation on output Y of + channel X. Y may be suppressed if all channels are + controlled together. + +What: /sys/bus/iio/devices/.../ddsX_outY_wavetype +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_outY_wavetype_available +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + Lists all available output waveform options.
--
1.6.0.2
[email protected]
maintainerPATCH 2/3 IIO: dds.h convenience macros
From: Michael Hennerich <[email protected]>
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.
Changes since v2:
IIO: dds.h: Apply more list review feedback
Fix mixture of X and [n] notation for indices. Remove duplicated descriptions.
Add store methods to some dds convenience macros.
--- drivers/staging/iio/dds/dds.h | 110 +++++++++++++++++++++++++++++++++++++++++ 1 files changed, 110 insertions(+), 0 deletions(-) create mode 100644 drivers/staging/iio/dds/dds.h
drivers/staging/iio/dds/dds.h new file +110 -0
@@ -0,0 +1,110 @@ +/* +* 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/.../ddsX_freqY +*/ + +#define IIO_DEV_ATTR_FREQ (_channel, _num, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_freq##_num, \ + _mode, _show, _store, _addr) + +/** +* /sys/bus/iio/devices/.../ddsX_freqY_scale +*/ + +#define IIO_CONST_ATTR_FREQ_SCALE (_channel, _string) \ + IIO_CONST_ATTR(dds##_channel##_freq_scale, _string) + +/** +* /sys/bus/iio/devices/.../ddsX_freqsymbol +*/ + +#define IIO_DEV_ATTR_FREQSYMBOL (_channel, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_freqsymbol, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_phaseY +*/ + +#define IIO_DEV_ATTR_PHASE (_channel, _num, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_phase##_num, \ + _mode, _show, _store, _addr) + +/** +* /sys/bus/iio/devices/.../ddsX_phaseY_scale +*/ + +#define IIO_CONST_ATTR_PHASE_SCALE (_channel, _string) \ + IIO_CONST_ATTR(dds##_channel##_phase_scale, _string) + +/** +* /sys/bus/iio/devices/.../ddsX_phasesymbol +*/ + +#define IIO_DEV_ATTR_PHASESYMBOL (_channel, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_phasesymbol, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_pincontrol_en +*/ + +#define IIO_DEV_ATTR_PINCONTROL_EN (_channel, _mode, _show, _store, _addr)\ + IIO_DEVICE_ATTR(dds##_channel##_pincontrol_en, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_pincontrol_freq_en +*/ + +#define IIO_DEV_ATTR_PINCONTROL_FREQ_EN (_channel, _mode, _show, _store, _addr)\ + IIO_DEVICE_ATTR(dds##_channel##_pincontrol_freq_en, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_pincontrol_phase_en +*/ + +#define IIO_DEV_ATTR_PINCONTROL_PHASE_EN (_channel, _mode, _show, _store, _addr)\ + IIO_DEVICE_ATTR(dds##_channel##_pincontrol_phase_en, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_out_enable +*/ + +#define IIO_DEV_ATTR_OUT_ENABLE (_channel, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_out_enable, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_outY_enable +*/ + +#define IIO_DEV_ATTR_OUTY_ENABLE (_channel, _output, \ + _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_out##_output##_enable, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_outY_wavetype +*/ + +#define IIO_DEV_ATTR_OUT_WAVETYPE (_channel, _output, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_out##_output##_wavetype, \ + S_IWUSR, NULL, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_outY_wavetype_available +*/ + +#define IIO_CONST_ATTR_OUT_WAVETYPES_AVAILABLE (_channel, _output, _modes)\ + IIO_CONST_ATTR(dds##_channel##_out##_output##_wavetype_available,\ + _modes);
--
1.6.0.2
Re: [PATCH 2/3] IIO: dds.h convenience macros
Quoted 10 lines · On 12/14/10 14:54, [email protected] wrote:
From: Michael Hennerich <[email protected]>
Changes since RFC/v1:
IIO: Apply list review feedbackApply list review feedback:
Rename attributes to fit IIO convention used in other drivers. ProvideddsX_out_enableas opposed toddsX_out_disable. Fix typos.
Quoted 8 lines
Changes since v2:
IIO:dds.h: Apply more list review feedbackFix mixture of X and [n] notation for indices. Remove duplicated descriptions.
Add store methods to some dds convenience macros.Signed-off-by Michael Hennerich <[email protected]>
Quoted 125 lines
--- drivers/staging/iio/dds/dds.h | 110 +++++++++++++++++++++++++++++++++++++++++ 1 files changed, 110 insertions(+), 0 deletions(-) create mode 100644 drivers/staging/iio/dds/dds.hdrivers/staging/iio/dds/dds.h new file +110
-1@@ -0,0 +1,110 @@ +/* +* 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/.../ddsX_freqY +*/ + +#define IIO_DEV_ATTR_FREQ (_channel, _num, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_freq##_num, \ + _mode, _show, _store, _addr) + +/** +* /sys/bus/iio/devices/.../ddsX_freqY_scale +*/ + +#define IIO_CONST_ATTR_FREQ_SCALE (_channel, _string) \ + IIO_CONST_ATTR(dds##_channel##_freq_scale, _string) + +/** +* /sys/bus/iio/devices/.../ddsX_freqsymbol +*/ + +#define IIO_DEV_ATTR_FREQSYMBOL (_channel, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_freqsymbol, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_phaseY +*/ + +#define IIO_DEV_ATTR_PHASE (_channel, _num, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_phase##_num, \ + _mode, _show, _store, _addr) + +/** +* /sys/bus/iio/devices/.../ddsX_phaseY_scale +*/ + +#define IIO_CONST_ATTR_PHASE_SCALE (_channel, _string) \ + IIO_CONST_ATTR(dds##_channel##_phase_scale, _string) + +/** +* /sys/bus/iio/devices/.../ddsX_phasesymbol +*/ + +#define IIO_DEV_ATTR_PHASESYMBOL (_channel, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_phasesymbol, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_pincontrol_en +*/ + +#define IIO_DEV_ATTR_PINCONTROL_EN (_channel, _mode, _show, _store, _addr)\ + IIO_DEVICE_ATTR(dds##_channel##_pincontrol_en, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_pincontrol_freq_en +*/ + +#define IIO_DEV_ATTR_PINCONTROL_FREQ_EN (_channel, _mode, _show, _store, _addr)\ + IIO_DEVICE_ATTR(dds##_channel##_pincontrol_freq_en, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_pincontrol_phase_en +*/ + +#define IIO_DEV_ATTR_PINCONTROL_PHASE_EN (_channel, _mode, _show, _store, _addr)\ + IIO_DEVICE_ATTR(dds##_channel##_pincontrol_phase_en, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_out_enable +*/ + +#define IIO_DEV_ATTR_OUT_ENABLE (_channel, _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_out_enable, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_outY_enable +*/ + +#define IIO_DEV_ATTR_OUTY_ENABLE (_channel, _output, \ + _mode, _show, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_out##_output##_enable, \ + _mode, _show, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_outY_wavetype +*/ + +#define IIO_DEV_ATTR_OUT_WAVETYPE (_channel, _output, _store, _addr) \ + IIO_DEVICE_ATTR(dds##_channel##_out##_output##_wavetype, \ + S_IWUSR, NULL, _store, _addr); + +/** +* /sys/bus/iio/devices/.../ddsX_outY_wavetype_available +*/ + +#define IIO_CONST_ATTR_OUT_WAVETYPES_AVAILABLE (_channel, _output, _modes)\ + IIO_CONST_ATTR(dds##_channel##_out##_output##_wavetype_available,\ + _modes); --1.6.0.2
[email protected]
maintainerPATCH 3/3 IIO: DDS: AD9833 / AD9834 driver
In reply to [email protected]From: Michael Hennerich <[email protected]>
Changes since RFC/v1:
IIO: Apply list review feedback
Apply list review feedback:
Rename attributes to fit IIO convention used in other drivers. Fix typos.
Provide ddsX_out_enable as opposed to ddsX_out_disable. Use proper __devexit marking.
Use strict_strtoul() to avoid negatives.
Changes since v2:
IIO: ad9834.c: Apply more list review feedback
Update use of dds convenience macros.
Fix tabbing.
Remove superfluous brackets.
Keep output disabled after probe.
Remove unnecessary code.
--- drivers/staging/iio/dds/Kconfig | 10 + drivers/staging/iio/dds/Makefile | 1 + drivers/staging/iio/dds/ad9834.c | 477 ++++++++++++++++++++++++++++++++++++++ drivers/staging/iio/dds/ad9834.h | 112 +++++++++ 4 files changed, 600 insertions(+), 0 deletions(-) create mode 100644 drivers/staging/iio/dds/ad9834.c create mode 100644 drivers/staging/iio/dds/ad9834.h
drivers/staging/iio/dds/Kconfig +10 -0
@@ -17,6 +17,16 @@ config AD9832 Say yes here to build support for Analog Devices DDS chip ad9832 and ad9835, provides direct access via sysfs. +config AD9834 + tristate "Analog Devices ad9833/4/ driver" + depends on SPI + help + Say yes here to build support for Analog Devices DDS chip + AD9833 and AD9834, provides direct access via sysfs. + + To compile this driver as a module, choose M here: the + module will be called ad9834. + config AD9850 tristate "Analog Devices ad9850/1 driver" depends on SPI
drivers/staging/iio/dds/Makefile +1 -0
@@ -4,6 +4,7 @@ obj-$(CONFIG_AD5930) += ad5930.o obj-$(CONFIG_AD9832) += ad9832.o +obj-$(CONFIG_AD9834) += ad9834.o obj-$(CONFIG_AD9850) += ad9850.o obj-$(CONFIG_AD9852) += ad9852.o obj-$(CONFIG_AD9910) += ad9910.o
drivers/staging/iio/dds/ad9834.c new file +477 -0
477 lines not on this page · raw message
drivers/staging/iio/dds/ad9834.h new file +112 -0
112 lines not on this page · raw message
--
1.6.0.2
Quoted 11 lines · On 12/14/10 14:54, [email protected] wrote:
From: Michael Hennerich <[email protected]>
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.
ProvideddsX_out_enableas opposed toddsX_out_disable
Quoted 5 lines
Changes since v2:
IIO: sysfs-bus-iio-dds: Apply more list review feedbackFix mixture of X and [n] notation for indices. Fix some wording in the descriptions.
Looks good.
Quoted 1 line
Signed-off-by Michael Hennerich <[email protected]>
Quoted 108 lines
--- .../staging/iio/Documentation/sysfs-bus-iio-dds | 93 ++++++++++++++++++++ 1 files changed, 93 insertions(+), 0 deletions(-) create mode 100644 drivers/staging/iio/Documentation/sysfs-bus-iio-ddsdrivers/staging/iio/Documentation/sysfs-bus-iio-dds new file +93
-1@@ -0,0 +1,93 @@ + +What: /sys/bus/iio/devices/.../ddsX_freqY +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + Stores frequency into tuning word Y. + There will 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/.../ddsX_freqY_scale +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_freqsymbol +KernelVersion: 2.6.37 +Contact: [email protected] +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_enable file. + +What: /sys/bus/iio/devices/.../ddsX_phaseY +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + Stores phase into Y. + There will 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/.../ddsX_phaseY_scale +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_phasesymbol +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_pincontrol_en +What: /sys/bus/iio/devices/.../ddsX_pincontrol_freq_en +What: /sys/bus/iio/devices/.../ddsX_pincontrol_phase_en +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_out_enable +What: /sys/bus/iio/devices/.../ddsX_outY_enable +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + ddsX_outY_enable controls signal generation on output Y of + channel X. Y may be suppressed if all channels are + controlled together. + +What: /sys/bus/iio/devices/.../ddsX_outY_wavetype +KernelVersion: 2.6.37 +Contact: [email protected] +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/.../ddsX_outY_wavetype_available +KernelVersion: 2.6.37 +Contact: [email protected] +Description: + Lists all available output waveform options. --1.6.0.2