26  * ZPA2326 hardware supports 2 sampling mode: one shot and continuous.
28  * A complete one shot sampling cycle gets device out of low power mode,
30  * back to low power mode. It is meant for on demand sampling with optimal power
31  * saving at the cost of lower sampling rate and higher software overhead.
43  * - setup hardware sampling period,
46  * - when no longer needed, stop sampling process by putting device into
52  * Note that hardware sampling frequency is taken into account only when
53  * internal hardware trigger is attached as the highest sampling rate seems to
58  *   differential pressure sampling ;
85  * struct zpa2326_frequency - Hardware sampling frequency descriptor
96  * correspond to the highest sampling frequency.
105 /* Return the highest hardware sampling frequency available. */
117  * @result:     Allows sampling logic to get completion status of operations
119  * @data_ready: Interrupt handler uses this to wake user context up at sampling
125  *              DT, in which case sampling logic keeps polling status register
127  * @frequency:  Current hardware sampling frequency.
220  * Required to access complete register space and to perform any sampling
272  * Disable sampling and empty hardware FIFO.
297  * zpa2326_start_oneshot() - Start a single sampling cycle, i.e. in one shot
299  * @indio_dev: The IIO device associated with the sampling hardware.
328  * @indio_dev: The IIO device associated with the sampling hardware.
331  * Sampling will be disabled, preventing strange things from happening in our
378  * @indio_dev: The IIO device associated with the sampling hardware.
394  * @indio_dev: The IIO device associated with the sampling hardware.
441  * @indio_dev: The IIO device associated with the sampling hardware.
512  * @indio_dev: The IIO device associated with the sampling hardware.
581  * @indio_dev: The IIO device associated with the sampling hardware.
663  * @indio_dev: The IIO device associated with the sampling hardware.
696  * @indio_dev: The IIO device associated with the sampling hardware.
747  * @data: The IIO device associated with the sampling hardware.
759 		/* Timestamping needed for buffered sampling only. */  in zpa2326_handle_irq()
770  * @data: The IIO device associated with the sampling hardware.
777  * When device is using its own internal hardware trigger in continuous sampling
784  * hook. This means one of the latter is currently waiting for sampling
803 	 * currently working in continuous sampling mode ?  in zpa2326_handle_threaded_irq()
862  * @indio_dev: The IIO device associated with the sampling hardware.
936  * @indio_dev: The IIO device associated with the sampling hardware.
938  * Loop over registers content to detect end of sampling cycle. Used when DT
1005  * @indio_dev: The IIO device associated with the sampling hardware.
1058  * zpa2326_sample_oneshot() - Perform a complete one shot sampling cycle.
1059  * @indio_dev: The IIO device associated with the sampling hardware.
1086 		 * Sampling operation always generates both temperature and  in zpa2326_sample_oneshot()
1110 	/* Start a sampling cycle in oneshot mode. */  in zpa2326_sample_oneshot()
1115 	/* Wait for sampling cycle to complete. */  in zpa2326_sample_oneshot()
1136  * zpa2326_trigger_handler() - Perform an IIO buffered sampling round in one
1143  * currently attached. Allows us to synchronize this device buffered sampling
1172 	 * hardware sampling mode.  in zpa2326_trigger_handler()
1177 		/* On demand sampling : start a one shot cycle. */  in zpa2326_trigger_handler()
1181 		/* Wait for sampling cycle to complete. */  in zpa2326_trigger_handler()
1201 		/* Don't switch to low power if sampling continuously. */  in zpa2326_trigger_handler()
1212  *                              sampling
1214  * @indio_dev: The IIO device associated with the sampling hardware.
1236  * zpa2326_postenable_buffer() - Configure device for triggered sampling.
1237  * @indio_dev: The IIO device associated with the sampling hardware.
1240  * Otherwise, let internal trigger configure continuous sampling :
1304  * zpa2326_set_trigger_state() - Start / stop continuous sampling.
1305  * @trig:  The trigger being attached to IIO device associated with the sampling
1309  * Basically enable / disable hardware continuous sampling mode.
1340 		 * Disable continuous sampling mode to restore settings for  in zpa2326_set_trigger_state()
1341 		 * one shot / direct sampling operations.  in zpa2326_set_trigger_state()
1367 		 * Switch trigger on : start continuous sampling at required  in zpa2326_set_trigger_state()
1380 		/* Enable continuous sampling at specified frequency. */  in zpa2326_set_trigger_state()
1402  * @parent:    Hardware sampling device @indio_dev is a child of.
1403  * @indio_dev: The IIO device associated with the sampling hardware.
1462 	/* Don't allow changing frequency if buffered sampling is ongoing. */  in zpa2326_set_frequency()
1474 /* Expose supported hardware sampling frequencies (Hz) through sysfs. */
1611 	/* Setup for userspace synchronous on demand sampling. */  in zpa2326_create_managed_iiodev()
1647 	/* Set default hardware sampling frequency to highest rate supported. */  in zpa2326_probe()