QUERY · ISSUE

utime.sleep_us() overflow

openby socketpairopened 2022-09-11updated 2022-09-12

docs

>>> from utime import sleep_us
>>> sleep_us(24*3600*1000_000)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
OverflowError: overflow converting long int to machine word

It's not documented about any limits on the argument. Either fix in documentation or fix. Fixing is better.

CANDIDATE · PULL REQUEST

utime module documentation fixes and cleanup

closedby SpotlightKidopened 2017-03-05updated 2017-03-18

Fix mis-spelling of ticks_add in code examples.
Be consistent about parentheses after function names.
Be consistent about formatting of function, variable and constant names.
Be consistent about spaces and punctuation.
Fix some language errors (missing or wrong words, wrong word order).
Keep line length under 90 chars.

Signed-off-by: Christopher Arndt chris@chrisarndt.de

Assessment

Q Qwen · high

The query (issue #9280) reports a functional bug where utime.sleep_us() raises an OverflowError with large values and requests either documentation of limits or a fix to handle large values. The candidate (PR #2939) is a documentation cleanup that fixes typos and formatting in the utime module documentation. While both items concern the utime module and sleep_us, the PR does not address the overflow bug itself, nor does it document the limits on sleep_us() arguments. The PR is tangentially related as it touches the same module's documentation, but it does not resolve the reported issue.

Suggested action

Keep issue #9280 open. The PR #2939 does not fix the overflow bug or document the limits. Consider creating a new PR to either implement support for larger values in sleep_us() or add clear documentation about the maximum argument value.

utime.sleep_us() overflow

utime module documentation fixes and cleanup

Keyboard