From nobody Sat Jun 13 00:38:11 2026 Received: from mail-pj1-f44.google.com (mail-pj1-f44.google.com [209.85.216.44]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E85193FFAD5 for ; Mon, 11 May 2026 17:13:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.44 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778519588; cv=none; b=owVQZQU+fx7gofjn3jafpQa/0s75uxS26Ac07On2Y4urvw7G50PGrACvo5aXykXrrg3jgbHzxw1Q7+57LtWpMpCmSkV+ry4gyy/qnaFqkYfRN4sWUBtGEqqqaoTfGFbi9y83vw3S2Kr9GtUVn8JGIwVvVk1yHgpzG6PyOa+Mhxg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778519588; c=relaxed/simple; bh=N0B6aeBfvO3+5jUCRXLgc9fs4gJYVndcLiF0eEoluaI=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=uaSHJAv6Gh0JYRaiB03LihzevEbyJeUK5gMRqEaCZUe1VF5q543ZxaOFlANjNAwhsId4x6ZXlZu8PHRvWVa26b6RCykGfUcJHvZrfG8nfFnosx3T9LSyo2UXt+RwtMy485ieGej3Hr0ZBpyymD8BaXcZNOLFWgzTzpldT3BoRiE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Vd7oYNv9; arc=none smtp.client-ip=209.85.216.44 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Vd7oYNv9" Received: by mail-pj1-f44.google.com with SMTP id 98e67ed59e1d1-368977e33b1so483091a91.1 for ; Mon, 11 May 2026 10:13:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1778519585; x=1779124385; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=dkzJ/hC822piYaCvNo19iUpPViiOD5q0JLp4DMc5nn0=; b=Vd7oYNv9q6S6lz4VYEdEzeXW5ZsU2/DHn59381sLq8JB+JE4X5xpPQAmkzxSlaX/3y vn6BpyA6X4JxP0axG7byqkw1b794DzeKLahWWFrKpXwco0AxMl/MSSSrOL2cBq5R7ACG l6n+OtlmqukUuQvJUQGLKr3vvgJ4dIVvh3WZEgoY28yxgM3Oe0WLvVR6Yo4U32NhZ+QF MAFnya7asD7TinDiBc9nIQVCRvLA0V5gfTehvQ46+Hmx7jCXO4x3JkR2gI5sqiNNurSG IdUqzPF0mSasS6py7V3XlfWXrD1hl0slVGSXpu+OyalvOsacihAQrgD25y7FuzuATz06 X18g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778519585; x=1779124385; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=dkzJ/hC822piYaCvNo19iUpPViiOD5q0JLp4DMc5nn0=; b=ZhUiifM05f8MiCX+kSg9W+uLxUkLVTUk4Ecdi69EEg6lz1Jmdg77C3Viiu3l/4AGnu /J8HghjKh8sClmoG5eq1CjMvdJEcLOesKb0XdLfjHV2codrIluVJej28wwyycjO625BX QoRq8BLH9NjfTUAhclghePBd2+akLIrEUDTworF36+2STRrh32l7k/Einda8uXK38Pc2 S5a8UhYgwk9PSpuXRSxxjYro/yq97tVGnYaVZgnOgpSYkdZs9aQt/HQs/jhPuPn4kO88 uPp/oI+fmIBvY0mM4zDivaQz6w4nTSYDn909j3W6FMSt+4wyG/CQHwdV3bEmAsSjesvo sxvQ== X-Forwarded-Encrypted: i=1; AFNElJ/ARm5qqV6aeE+5wmQUIEoENiyZx7V8719lSxJ7+qaY44d4AjqdLz9YjMTYzuppv9j/dmw67De0XNTTIro=@vger.kernel.org X-Gm-Message-State: AOJu0YwWr0VTCRR4DKaY9NpF57PDCrvWi5ynh3JIu3SuCaTcyhZv8PZ+ O3/gDgHnPiUp1RlyYF9bbb46Z9coL9kG0T0C/HPxrDCLsEVqsJhH6SC2 X-Gm-Gg: Acq92OE5DEBqIW/9mE4fq9ltbRc4UrSAAte/Vri7UF2MRs4spq6J2cFoOQHmxPjx3R5 1XP11+D9cnXGQBt98z4or2Red//d0PHZd26IXRvmbXj8XIQ2UsomUMaJhUeSz+nUnuDojU9bCzX CTFmFnm4qMDEKbxpvj1PKe9Giv/rhDWh1PZph+0uN/UEFGfQdNsvnB1huAkA5E9HYKw6IoMl5NU s99SfENSCya4MXFF5tcZSCYiUX9/znoJ5YV+JSOXHwt+ATkuykNPCmlmVL0UMdh2862vQVEJwUN wtRuMcOg5b8znFeZqB4sbPiorOgRCr4Vofm1JWZPPTjgsfo+lDVqu7wG0EkzS6MVim7rgeXx2nr tLfe3PUroj5QpXq7LcEvkygcEA/m7WLjIJrnmNhscpMOQh0vBx2NfIFrO5ZWgeDeUT+rvoocBAO gABdgNpq/fH7NU4ZwzYU+kc+ZwGnmOK8mDL34ZBpil7Loh+0gvmES/WAhPcQSVonL+WKQIRjK9L g== X-Received: by 2002:a17:90b:2d4f:b0:368:65bc:e32b with SMTP id 98e67ed59e1d1-36865bce380mr4105229a91.15.1778519584761; Mon, 11 May 2026 10:13:04 -0700 (PDT) Received: from avinash-INBOOK-Y2-PLUS.bbrouter ([115.99.181.159]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-367d683fb92sm8055704a91.12.2026.05.11.10.13.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 11 May 2026 10:13:04 -0700 (PDT) From: Abinash Singh To: jic23@kernel.org, gregkh@linuxfoundation.org Cc: dlechner@baylibre.com, nuno.sa@analog.com, andy@kernel.org, linux-iio@vger.kernel.org, linux-staging@lists.linux.dev, linux-kernel@vger.kernel.org, Abinash Singh Subject: [PATCH] staging: Documentation: dds: replace frequencyY with frequency Date: Mon, 11 May 2026 22:42:55 +0530 Message-ID: <20260511171255.9668-1-abinashsinghlalotra@gmail.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Abinash Singh The documented frequencyY attribute naming is implementation specific and differs from common IIO sysfs attribute conventions. Replace the non-standard frequencyY attribute documentation with out_altvoltageX_frequency and document tuning word selection through out_altvoltageX_frequencysymbol This makes the documented ABI naming consistent with standard IIO sysfs attribute conventions and clarifies how tuning word registers are selected and programmed. Signed-off-by: Abinash Singh --- The out_altvoltageX_frequencysymbol and out_altvoltageX_frequency_scale attributes can be added through extended channel attributes (.ext_info in channel_spec struct of II= O) Feedback on this approach would be appreciated, and if there is some other way in your mind. I would like to=20 work on that. I am also interested in working on the sysfs-bus-iio-dds documentation and the ad9834 driver. I recently bought an AD9833 IC for experimentation and testing. Thanks .../iio/Documentation/sysfs-bus-iio-dds | 31 ++++++++++--------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/drivers/staging/iio/Documentation/sysfs-bus-iio-dds b/drivers/= staging/iio/Documentation/sysfs-bus-iio-dds index ee8c509c6733..dfc6ae3964d1 100644 --- a/drivers/staging/iio/Documentation/sysfs-bus-iio-dds +++ b/drivers/staging/iio/Documentation/sysfs-bus-iio-dds @@ -1,33 +1,34 @@ =20 -What: /sys/bus/iio/devices/.../out_altvoltageX_frequencyY +What: /sys/bus/iio/devices/.../out_altvoltageX_frequency KernelVersion: 2.6.37 Contact: linux-iio@vger.kernel.org Description: - Stores frequency into tuning word Y. - There will be more than one out_altvoltageX_frequencyY file, - which allows for pin controlled FSK Frequency Shift Keying - (out_altvoltageX_pincontrol_frequency_en is active) or the user - can control the desired active tuning word by writing Y to the + Stores frequency into active tuning word register. + To select active tuning word register, the user + must write the desired index to the out_altvoltageX_frequencysymbol file. + For pin controlled FSK (Frequency Shift Keying), + tuning word registers must be loaded by selecting + each via out_altvoltageX_frequencysymbol before enabling + out_altvoltageX_pincontrol_frequency_en. =20 -What: /sys/bus/iio/devices/.../out_altvoltageX_frequencyY_scale +What: /sys/bus/iio/devices/.../out_altvoltageX_frequency_scale KernelVersion: 2.6.37 Contact: linux-iio@vger.kernel.org Description: - Scale to be applied to out_altvoltageX_frequencyY 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 + Scale to be applied to out_altvoltageX_frequency in order to + obtain the desired value in Hz. It is also possible X is not present if shared across all channels. =20 What: /sys/bus/iio/devices/.../out_altvoltageX_frequencysymbol 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 out_altvoltageX_frequencyY. - To exit this mode the user can write - out_altvoltageX_pincontrol_frequency_en or - out_altvoltageX_out_enable file. + Specifies the active output frequency tuning word index. + Writing an index here selects which tuning word register + is written by out_altvoltageX_frequency. To exit this mode + the user can write out_altvoltageX_pincontrol_frequency_en + or out_altvoltageX_out_enable file. =20 What: /sys/bus/iio/devices/.../out_altvoltageX_phaseY KernelVersion: 2.6.37 --=20 2.43.0