Re: [PATCH v8 6/9] iio: accel: mma8452: Add comment block for struct mma8452_data
From: Andy Shevchenko
Date: Tue Sep 08 2026 - 07:16:02 EST
On Mon, Sep 07, 2026 at 04:51:01PM +0200, Esben Haabendal wrote:
> The struct mma8452_data is central for this driver, and it makes sense to
> have a description of the fields in it to make it easier to work with the
> driver.
...
> +/**
> + * struct mma8452_data - IIO device private data structure
> + * @client: the I2C client object
> + * @lock: mutex for synchronziation of register
> + * read-modify-write and holding chip in STANDBY
> + * mode while writing to registers
> + * @orientation: mounting matrix, flipped axis etc
> + * @chip_info: chip specific data
> + * @vdd_reg: reference to VDD regulator
> + * @vddio_reg: reference to VDDIO regulator
> + * @buffer: triggered buffer
> + * @sleep_val: time in ms to sleep while waiting for drdy
> + * @ctrl_reg1: CTRL_REG1 register shadow value
> + * @data_cfg: DATA_CFG register shadow value
> + * @open_drain: true for irq pin in open-drain mode
> + */
Have you tried to generate *.html and *.pdf out of this? Does rendering look
okay in both cases?
--
With Best Regards,
Andy Shevchenko