iio: adc: ti-ads1298: Fix incorrect timeout comment
PATCH v2 1/1 iio: adc: ti-ads1298: Fix incorrect timeout comment
In reply to a message not in the archiveAt the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
--- drivers/iio/adc/ti-ads1298.c | 4 ++-- 1 file changed, 3 insertions(+), 1 deletion(-)
drivers/iio/adc/ti-ads1298.c +3 -1
@@ -210,7 +210,9 @@ static int ads1298_read_one(struct ads1298_private *priv, int chan_index)return ret; } -/* Cannot take longer than 40ms (250Hz) */ +/* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 ));if (!ret)return -ETIMEDOUT ;
--
2.54.0.windows.1
Quoted 9 lines · Md Shofiqul Islam
At the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
...
drivers/iio/adc/ti-ads1298.c static int ads1298_read_one(struct ads1298_private *priv, int chan_index) · line 215
Quoted 4 lines
drivers/iio/adc/ti-ads1298.c +3
-1-/* Cannot take longer than 40ms (250Hz) */ +/* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/
/*
* This is wrong style of multi-line comments in the IIO
* subsystem. Use this example on how to fix it. */
Signature · 2 lines
With Best Regards, Andy Shevchenko
PATCH v3 1/1 iio: adc: ti-ads1298: Fix incorrect timeout comment
In reply to a message not in the archiveAt the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
--- drivers/iio/adc/ti-ads1298.c | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-)
drivers/iio/adc/ti-ads1298.c +4 -1
@@ -210,7 +210,11 @@ static int ads1298_read_one(struct ads1298_private *priv, int chan_index)return ret; } -/* Cannot take longer than 40ms (250Hz) */ +/* +* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 ));if (!ret)return -ETIMEDOUT ;
--
2.54.0.windows.1
Quoted 5 lines · Md Shofiqul Islam
At the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Quoted 7 lines
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
Signed-off-by Md Shofiqul Islam <[email protected]>---
Here should be a changelog. What's different to v2 to v1?
drivers/iio/adc/ti-ads1298.c static int ads1298_read_one(struct ads1298_private *priv, int chan_index) · line 219
Quoted 8 lines
drivers/iio/adc/ti-ads1298.c +4
-1-/* Cannot take longer than 40ms (250Hz) */ +/* +* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 ));if (!ret)return -ETIMEDOUT ;
It's also better to drop a ret assignment here as it's counter intuitive.
if (!wait_for_completion_timeout(&priv->completion, msecs_to_jiffies(50))) return -ETIMEDOUT;
(This might require more changes related to this ret drop.)
Signature · 2 lines
With Best Regards, Andy Shevchenko
PATCH v4 1/1 iio: adc: ti-ads1298: Fix incorrect timeout comment
In reply to Md Shofiqul IslamAt the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
Also drop the redundant ret variable assignment by using the return value of wait_for_completion_timeout() directly in the if() condition.
---
Changes in v4:
- Drop the ret assignment for wait_for_completion_timeout(); use the return value directly in the if() condition (Andy Shevchenko)
Changes in v3:
- Fix multi-line comment style: move comment text to its own line after '/*' (Andy Shevchenko)
Changes in v2:
- Correct conversion time to 4ms (was wrong 40ms), add scheduling latency explanation, clarify "lowest sample rate" (David Lechner, Andy Shevchenko)
drivers/iio/adc/ti-ads1298.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)
drivers/iio/adc/ti-ads1298.c +5 -3
@@ -210,9 +210,11 @@ static int ads1298_read_one(struct ads1298_private *priv, int chan_index)return ret; } -/* Cannot take longer than 40ms (250Hz) */ - ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )); -if (!ret) +/* +* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ +if (!wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )))return -ETIMEDOUT ;return 0 ;
Signature · 1 line
2.54.0.windows.1
PATCH v4 1/1 iio: adc: ti-ads1298: Fix incorrect timeout comment
In reply to Md Shofiqul IslamAt the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
Also drop the redundant ret variable assignment by using the return value of wait_for_completion_timeout() directly in the if() condition.
---
Changes in v4:
- Drop the ret assignment for wait_for_completion_timeout(); use the return value directly in the if() condition (Andy Shevchenko)
Changes in v3:
- Fix multi-line comment style: move comment text to its own line after '/*' (Andy Shevchenko)
Changes in v2:
- Correct conversion time to 4ms (was wrong 40ms), add scheduling latency explanation, clarify "lowest sample rate" (David Lechner, Andy Shevchenko)
drivers/iio/adc/ti-ads1298.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)
drivers/iio/adc/ti-ads1298.c +5 -3
@@ -210,9 +210,11 @@ static int ads1298_read_one(struct ads1298_private *priv, int chan_index)return ret; } -/* Cannot take longer than 40ms (250Hz) */ - ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )); -if (!ret) +/* +* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ +if (!wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )))return -ETIMEDOUT ;return 0 ;
Signature · 1 line
2.54.0.windows.1
Jonathan Cameron
maintainerQuoted 10 lines · On Sun, 10 May 2026 22:36:45 +0300 Md Shofiqul Islam <[email protected]>…
At the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
Quoted 4 lines
Also drop the redundant ret variable assignment by using the return value of
wait_for_completion_timeout()directly in theif()condition.Signed-off-by Md Shofiqul Islam <[email protected]>
Given the versioning mess - please check I got the right one on the testing branch of iio.git.
Probably applied this one - it broke b4 btw as that picked up two near identical patches as a single series.
Jonathan
Quoted 36 lines
---
Changes in v4:
- Drop the ret assignment forwait_for_completion_timeout(); use the return value directly in theif()condition (Andy Shevchenko)Changes in v3:
- Fix multi-line comment style: move comment text to its own line after '/*' (Andy Shevchenko)Changes in v2:
- Correct conversion time to 4ms (was wrong 40ms), add scheduling latency explanation, clarify "lowest sample rate" (David Lechner, Andy Shevchenko)drivers/iio/adc/ti-ads1298.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)drivers/iio/adc/ti-ads1298.c +5
-3@@ -210,9 +210,11 @@ static int ads1298_read_one(struct ads1298_private *priv, int chan_index)return ret; } -/* Cannot take longer than 40ms (250Hz) */ - ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )); -if (!ret) +/* +* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ +if (!wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )))return -ETIMEDOUT ;return 0 ;
Jonathan Cameron
maintainerQuoted 10 lines · On Sun, 10 May 2026 22:34:35 +0300 Md Shofiqul Islam <[email protected]>…
At the lowest supported data rate of 250Hz, one conversion period is 4ms, not 40ms. The 50ms timeout is deliberately conservative to allow for kernel scheduling latency, which can be significant under load or on slow machines.
Fix the comment to state the correct conversion time, use "lowest sample rate" for clarity, and explain that the extra margin exists to absorb scheduling latency so that no one is tempted to shrink the timeout to match the conversion period.
Quoted 4 lines
Also drop the redundant ret variable assignment by using the return value of
wait_for_completion_timeout()directly in theif()condition.Signed-off-by Md Shofiqul Islam <[email protected]>
Hi. Please slow down a bit and perhaps more importantly be careful with your various series numbers etc. I see the same patch in a series label v4 then as a patch on it's own labelled v2, one labelled v3 and 2 patches labeled v4 sent a few minute apart
I'm going to pick up the most recent one probably but that might well be the wrong one!
Quoted 36 lines
---
Changes in v4:
- Drop the ret assignment forwait_for_completion_timeout(); use the return value directly in theif()condition (Andy Shevchenko)Changes in v3:
- Fix multi-line comment style: move comment text to its own line after '/*' (Andy Shevchenko)Changes in v2:
- Correct conversion time to 4ms (was wrong 40ms), add scheduling latency explanation, clarify "lowest sample rate" (David Lechner, Andy Shevchenko)drivers/iio/adc/ti-ads1298.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)drivers/iio/adc/ti-ads1298.c +5
-3@@ -210,9 +210,11 @@ static int ads1298_read_one(struct ads1298_private *priv, int chan_index)return ret; } -/* Cannot take longer than 40ms (250Hz) */ - ret =wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )); -if (!ret) +/* +* One conversion takes at most 4ms at the lowest sample rate (250Hz). +* Use 50ms to allow for kernel scheduling latency. +*/ +if (!wait_for_completion_timeout (&priv->completion,msecs_to_jiffies (50 )))return -ETIMEDOUT ;return 0 ;