From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-ot1-f44.google.com (mail-ot1-f44.google.com [209.85.210.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 7F2201AAE13 for ; Sun, 18 Jan 2026 19:46:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.44 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768765566; cv=none; b=WtWevDYiFQ7JfxvUMlMcVDvPskzqamDCzptOE2tg2A4w23tTxNhWIJOGpMW5vlzoMpRqswOIIM9qEp5yWKPxdzueLPvOLwbCwLm/KzFRWp7emohccFVxUtc6ewt0tVhbE0Ykk7/KzG7YpGUn6FCSJtJ33MTlvh42kdOU1Qi2+Bs= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768765566; c=relaxed/simple; bh=ujVW9sDXaLFzKGnXAu5cGf0WUh1AesvBPA/OQIeUeOU=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=GinnV3usX9qyS7ChvSu+D40bkJdkEbnbDhRXmxTvOiPFtGFXAJgRs7OQebNjo5/BPlEBKwgo+SkRMSuFWkMkwFb7Mc7WoGDP5bHuu3dHs2epONOEnmZlWZq0/QirJiEhEsCzObpPC22OJqzRgBQJyojEVHh9weg4oZwa3+NqOng= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=f2dyVcNs; arc=none smtp.client-ip=209.85.210.44 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="f2dyVcNs" Received: by mail-ot1-f44.google.com with SMTP id 46e09a7af769-7cfd9b898cdso2033496a34.2 for ; Sun, 18 Jan 2026 11:46:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1768765562; x=1769370362; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=b/oeD3cM08837+cCP+kX3EVzrbL+4w4ZA6F2chjridk=; b=f2dyVcNsFu/XRreUBCRYUe2g+JUXtgfOyM95N7z9N/Azk4J2HrOUx3xDp8CD+tZNbU YElYysyQrcoqrk5Y1B4kgamHHy49IkuEQUMBuSdzBHrzcCrNdfBRGPF+zH/RAH16GrDC SJA/PXlr8izjDlpyZM4npN/gp/fZFSKkjXv/QjL/ZfOjZNdyHrLNDv4vyUUoTQpBepVh I9TYEtRJDRus/EZAGg8TYkvYHHnd6zReD2EM6Z/IXMK4Ys2nR35GmSzyQvHUmZgioLqy 9NGADc3+sMNibgXVbbkyUtVzhxkk1h0AKYj3reYaQ4pS8E97iDzTkbmKtl5hs1ans9Km jMDQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1768765562; x=1769370362; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=b/oeD3cM08837+cCP+kX3EVzrbL+4w4ZA6F2chjridk=; b=k32tu/I4VlpmatP7A6qoTpHcugfBzPfrkLCRtfI4qHQpeP5DRyAFBYxjFCllmxkH2E xMX6XfQOC1gYjiRvV5v2elXZ3LzZsd8gMtxpk1Ig77WF5UT9aCx6qkOSXUru4504Spg1 joViic4ckQ97q7e448/QiP3uGdOYCNQCvlUBISaCNwSlv2k7zB8wSfcplA1e/RUBPSe+ hicfXbOqY9fhU/XyNRFOP6ROHKNM0Eqqwgn0DVIr3uJUgB5KuKshujRssP8ug61notH+ vjteMlJdH26cyBUmuEf9eXuDoMGEc7CoI4H/Z73MTIBkI6BsbJB+Jr+jZK2kZIhISUyH Fc3w== X-Forwarded-Encrypted: i=1; AJvYcCXSE6cUNWSUKHM41phL0efWspDAFUb/xd3HuQoJmDh/nsvp0VkCQJrDHeQGgciHbDTpZ1tZRmY0B2glVEA=@vger.kernel.org X-Gm-Message-State: AOJu0YyI//pm++UavGZHaalHoc4bHYiUBykB7Tic6+xXICcBXNh2JriM cU2/e5tUHiBgPHrOE2zzweV0r8JqFNYzRQiC6xujwfVbrDmh0Li8NDRd1JdnryXmcecj7M2TqOV sTaEC X-Gm-Gg: AY/fxX4t+crxOcwdzj0l6OG2ombKh/vLid4HpnPBlYBOVV7egFmkF3mc431F8JBJ6SN n0hra1OFmUPrCZvbFhrCvFNOPWnk+PdkyhmvGQNxgdIYH6gVAPY8+0sinfom3aJ6nqSSzVWIvVi VLUO2cfkfVOyRSjGZUJvKgGUUc/pzH1nQEgGRfniXM/E8eZjCslJ3KscXchxEseVryvKDePGdN7 5rk4j6KaESiGdy3Hnaod9ks7+mB9EIHs/LXH8HI7MOTtyUAXgXi3jclXTgvt6qBy50QwhtEj8Wb fkJSgTXIJISb5CEUXFiw8e1HAax+vzuUJcOfEvta65zEfZKfJj94e0qXGL8WaENE69HG6GVMAU6 h+gxXVNzutRl2RLbqd8WU24elnQP8QfXXdc1W0Flj+3an1g/B0qAAranAHvoxiJOu4DVN+8Uvjz fYvv01nbid6YhoCFjrDueWqYBBAsUZ2agKqDa5g2VTqMjOoGnC2iUiXcoNU4qt+z7KNtqsico= X-Received: by 2002:a05:6830:4982:b0:7cb:125d:2a47 with SMTP id 46e09a7af769-7cfded3181amr5315130a34.1.1768765562478; Sun, 18 Jan 2026 11:46:02 -0800 (PST) Received: from ?IPV6:2600:8803:e7e4:500:d542:af69:64b6:f7df? ([2600:8803:e7e4:500:d542:af69:64b6:f7df]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7cfdf0e94b2sm5493635a34.7.2026.01.18.11.46.01 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 18 Jan 2026 11:46:02 -0800 (PST) Message-ID: <2d148091-9e40-41ee-95cb-544abcbf81be@baylibre.com> Date: Sun, 18 Jan 2026 13:46:01 -0600 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [RFC PATCH v1 2/9] iio: ABI: Accurately describe in_distance_input To: Marcelo Schmitt , linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org Cc: jic23@kernel.org, Jonathan.Cameron@huawei.com, nuno.sa@analog.com, andy@kernel.org References: Content-Language: en-US From: David Lechner In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit On 1/18/26 12:20 PM, Marcelo Schmitt wrote: > There is only one driver (drivers/iio/accel/mma9553.c) that declares a > channel of type IIO_DISTANCE with an info_mask containing > IIO_CHAN_INFO_PROCESSED. Though, mma9553.c provides distance in meters (as > would be expected for the _input interface). Split in_distance_raw and > in_distance_input ABI documentation to provide accurate description for the > in_distance_input interface. > > Fixes: 7cf78db585b1 ("iio: Add ABI documentation for illuminance raw and scale values in light") > Signed-off-by: Marcelo Schmitt > --- > Added a fix tag though not sure it's needed/desired since it might not be worth > to backport documentation? > > Documentation/ABI/testing/sysfs-bus-iio | 7 +++++++ > 1 file changed, 7 insertions(+) > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio > index aec39b8e3345..27251b65ea0e 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio > +++ b/Documentation/ABI/testing/sysfs-bus-iio > @@ -1613,6 +1613,13 @@ Description: > user). Units after application of scale are Joules. > > What: /sys/.../iio:deviceX/in_distance_input > +KernelVersion: 4.0 > +Contact: linux-iio@vger.kernel.org > +Description: > + This attribute is used to read the measured distance (in meters) > + to an object or the distance covered by the user since the last > + reboot while activated. > + > What: /sys/.../iio:deviceX/in_distance_raw > KernelVersion: 4.0 > Contact: linux-iio@vger.kernel.org I'm not sure it is worth splitting these up since the documentation is just repeated except for the bit about scale. And it is common knowledge that scale only applies to raw and not input. Also, looks like raw and input are swapped. raw it the one with scale so the sentence about scale should be with the raw attribute.