public inbox for linux-doc@vger.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Cameron <jic23@kernel.org>
To: Rodrigo Alencar <455.rodrigo.alencar@gmail.com>
Cc: Rodrigo Alencar <rodrigo.alencar@analog.com>,
	linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org,
	devicetree@vger.kernel.org, linux-doc@vger.kernel.org,
	David Lechner <dlechner@baylibre.com>,
	Andy Shevchenko <andy@kernel.org>,
	Lars-Peter Clausen <lars@metafoo.de>,
	Michael Hennerich <Michael.Hennerich@analog.com>,
	Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Jonathan Corbet <corbet@lwn.net>,
	Andrew Morton <akpm@linux-foundation.org>,
	Petr Mladek <pmladek@suse.com>,
	Steven Rostedt <rostedt@goodmis.org>,
	Andy Shevchenko <andriy.shevchenko@linux.intel.com>,
	Rasmus Villemoes <linux@rasmusvillemoes.dk>,
	Sergey Senozhatsky <senozhatsky@chromium.org>,
	Shuah Khan <skhan@linuxfoundation.org>
Subject: Re: [PATCH v10 05/11] iio: core: add decimal value formatting into 64-bit value
Date: Tue, 5 May 2026 17:42:30 +0100	[thread overview]
Message-ID: <20260505174230.5a5020fb@jic23-huawei> (raw)
In-Reply-To: <keeskqikjulxcgc36zpzzvqw2osvm437hlchgcuovh5gkvmdr3@ishisbiujrrn>

On Mon, 4 May 2026 11:42:38 +0100
Rodrigo Alencar <455.rodrigo.alencar@gmail.com> wrote:

> On 26/04/15 10:51AM, Rodrigo Alencar wrote:
> > Create new format types for iio values (IIO_VAL_DECIMAL64_*), which
> > defines the representation of fixed decimal point values into a single
> > 64-bit number. This new format increases the range of represented values,
> > allowing for integer parts greater than 2^32, as bits are not "wasted"
> > in the fractional part, which can be seen in IIO_VAL_INT_PLUS_MICRO and
> > IIO_VAL_INT_PLUS_NANO. Helper macros are created to compose and decompose
> > 64-bit decimals into integer values used in IIO formatting interfaces,
> > which creates consistency and avoid error-prone manual assignments when
> > using wordpart macros. When doing the parsing, kstrtodec64() is used with
> > the scale defined by the specific decimal format type.
> > 
> > Signed-off-by: Rodrigo Alencar <rodrigo.alencar@analog.com>  
> 
> ...
> 
> > --- a/include/linux/iio/types.h
> > +++ b/include/linux/iio/types.h
> > @@ -7,6 +7,7 @@
> >  #ifndef _IIO_TYPES_H_
> >  #define _IIO_TYPES_H_
> >  
> > +#include <linux/wordpart.h>
> >  #include <uapi/linux/iio/types.h>
> >  
> >  enum iio_event_info {
> > @@ -34,6 +35,38 @@ enum iio_event_info {
> >  #define IIO_VAL_FRACTIONAL_LOG2 11
> >  #define IIO_VAL_CHAR 12
> >  
> > +#define IIO_VAL_DECIMAL64_BASE		100
> > +#define IIO_VAL_DECIMAL64_MILLI		(IIO_VAL_DECIMAL64_BASE + 3)
> > +#define IIO_VAL_DECIMAL64_MICRO		(IIO_VAL_DECIMAL64_BASE + 6)
> > +#define IIO_VAL_DECIMAL64_NANO		(IIO_VAL_DECIMAL64_BASE + 9)
> > +#define IIO_VAL_DECIMAL64_PICO		(IIO_VAL_DECIMAL64_BASE + 12)
> > +
> > +#define iio_val_s64_compose(_val0, _val1)				\
> > +	({ (s64)((((u64)(_val1)) << 32) | (u32)(_val0)); })
> > +
> > +#define iio_val_s64_from_array(_vals)					\
> > +	({								\
> > +		const int *_arr = (const int *)(_vals);			\
> > +		s64 _dec64 = iio_val_s64_compose(_arr[0], _arr[1]);	\
> > +									\
> > +		_dec64;							\
> > +	})
> > +
> > +#define iio_val_s64_decompose(_dec64, _val0, _val1)			\
> > +	do {								\
> > +		s64 _tmp64 = (s64)(_dec64);				\
> > +									\
> > +		*(_val0) = lower_32_bits(_tmp64);			\
> > +		*(_val1) = upper_32_bits(_tmp64);			\
> > +	} while (0)
> > +
> > +#define iio_val_s64_array_populate(_dec64, _vals)			\
> > +	do {								\
> > +		int *_arr = (int *)(_vals);				\
> > +									\
> > +		iio_val_s64_decompose((_dec64), &_arr[0], &_arr[1]);	\
> > +	} while (0)  
> 
> Hi Jonathan,
> 
> Are those macros ok? in terms of where they are declared or whether they
> should be static inline functions? any preferences?

My preference would be for static inline functions rather than macros given
all the types are known here.

> 
> > +
> >  enum iio_available_type {
> >  	IIO_AVAIL_LIST,
> >  	IIO_AVAIL_RANGE,
> > 
> > -- 
> > 2.43.0
> >   
> 


  reply	other threads:[~2026-05-05 16:42 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-04-15  9:51 [PATCH v10 00/11] ADF41513/ADF41510 PLL frequency synthesizers Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 01/11] dt-bindings: iio: frequency: add adf41513 Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 02/11] lib: kstrtox: add kstrtoudec64() and kstrtodec64() Rodrigo Alencar via B4 Relay
2026-04-17  8:36   ` Rodrigo Alencar
2026-04-25 15:40     ` Jonathan Cameron
2026-04-25 22:33       ` David Laight
2026-04-26  8:02         ` Rodrigo Alencar
2026-04-27  6:56           ` Andy Shevchenko
2026-04-15  9:51 ` [PATCH v10 03/11] lib: test-kstrtox: tests for kstrtodec64() and kstrtoudec64() Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 04/11] lib: math: div64: add div64_s64_rem() Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 05/11] iio: core: add decimal value formatting into 64-bit value Rodrigo Alencar via B4 Relay
2026-05-04 10:42   ` Rodrigo Alencar
2026-05-05 16:42     ` Jonathan Cameron [this message]
2026-04-15  9:51 ` [PATCH v10 06/11] iio: test: iio-test-format: add test case for decimal format Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 07/11] iio: frequency: adf41513: driver implementation Rodrigo Alencar via B4 Relay
2026-04-25 16:33   ` Jonathan Cameron
2026-04-15  9:51 ` [PATCH v10 08/11] iio: frequency: adf41513: handle LE synchronization feature Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 09/11] iio: frequency: adf41513: features on frequency change Rodrigo Alencar via B4 Relay
2026-04-15  9:51 ` [PATCH v10 10/11] docs: iio: add documentation for adf41513 driver Rodrigo Alencar via B4 Relay
2026-04-25 16:40   ` Jonathan Cameron
2026-04-15  9:51 ` [PATCH v10 11/11] Documentation: ABI: testing: add common ABI file for iio/frequency Rodrigo Alencar via B4 Relay
2026-04-15 10:24 ` [PATCH v10 00/11] ADF41513/ADF41510 PLL frequency synthesizers Andy Shevchenko

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260505174230.5a5020fb@jic23-huawei \
    --to=jic23@kernel.org \
    --cc=455.rodrigo.alencar@gmail.com \
    --cc=Michael.Hennerich@analog.com \
    --cc=akpm@linux-foundation.org \
    --cc=andriy.shevchenko@linux.intel.com \
    --cc=andy@kernel.org \
    --cc=conor+dt@kernel.org \
    --cc=corbet@lwn.net \
    --cc=devicetree@vger.kernel.org \
    --cc=dlechner@baylibre.com \
    --cc=krzk+dt@kernel.org \
    --cc=lars@metafoo.de \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-iio@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux@rasmusvillemoes.dk \
    --cc=pmladek@suse.com \
    --cc=robh@kernel.org \
    --cc=rodrigo.alencar@analog.com \
    --cc=rostedt@goodmis.org \
    --cc=senozhatsky@chromium.org \
    --cc=skhan@linuxfoundation.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox