Repository navigation
docs: document PCAN timestamp drift after macOS sleep - #2107
Open
timothyanderson096-ocdealcheck wants to merge 1 commit into
Open
timothyanderson096-ocdealcheck wants to merge 1 commit into
timothyanderson096-ocdealcheck wants to merge 1 commit into
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary of Changes
Document the reported timestamp offset with PCBUSB 0.13 after macOS system sleep, including sleep before a capture begins. Explain the boot-time conversion, the reported reconnect/log-format limitations, and a diagnostic procedure that accounts for receive-queue delay.
This is a documentation contribution. The runtime timestamp conversion still needs a hardware-validated fix.
Related Issues / Pull Requests
Type of Change
Checklist
tox).Additional Notes
Validated on Linux with Python 3.13.16 and Sphinx 9.2.0, using the project's docs dependency group and canalystii/gs-usb extras:
python -m sphinx -E -b html -Wan --keep-going doc build/html— passed, no warnings.python -m sphinx -E -b doctest -W --keep-going doc build/doctest— 39 tests passed, no warnings.git diff --checkpassed.toxmatrix not run for this documentation-only change. No Mac/PCAN hardware validation performed.The driver counter's exact clock domain and handling of queued frames across suspend remain open questions for a runtime fix. The documentation attributes the observations to the reports and makes no claim about Windows/Linux behavior.
Prepared with AI assistance; sources, rendered output, and documentation checks were reviewed.
Timothy Anderson — Spotted Ridge Engineering / OC Labs
Using GDN — Global Decision Network
timothyanderson096@gmail.com · Engineering evidence