Skip to content

Document the board detection settings, rename getBoardCandidate to getCandidateBoard, translate recent comments - #361

Merged
lovyan03 merged 2 commits into
m5stack:developfrom
ainyan03:docs_comments
Oct 16, 2026
Merged

lovyan03 merged 2 commits into
m5stack:developfrom
ainyan03:docs_comments

Conversation

@ainyan03

@ainyan03 ainyan03 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Document the board detection settings in M5GFX.h: when setDetectConfig() takes effect (before the first init()), what fallback_board and fixed_board do, and what getCandidateBoard() / getFixedBoard() report.
  • Rename getBoardCandidate() to getCandidateBoard() so it pairs with getFixedBoard(). These APIs are not in a release yet, so no alias is kept.
  • Translate the comments added since 0.2.33 to English and update the error_t descriptions (mode_mismatch is also returned for a nested beginTransaction and for a call from a task that does not own the I2C transaction).

M5Unified calls the renamed getter and needs the matching change (m5stack/M5Unified #409); please merge both together.

Test

  • extras/board_spec: npm test and npm run check pass
  • Built with the M5Unified change for the chips and IDF / Arduino versions used by the upstream CI; no new warnings
  • fork CI passed

…tCandidateBoard

detect_config_t and its accessors had no description of when the settings
apply (before the first init) or how fallback_board, fixed_board and the
candidate interact. The getter is renamed to pair with getFixedBoard; the
API has not been released yet, so no alias is kept.
Comments added for SCT, external RAM DMA, the LP I2C pads and board
detection were written in Japanese. mode_mismatch is also returned for a
nested beginTransaction and for a call from a task that does not own the I2C
transaction, which its old description did not mention. Comments only; no
code change.
@lovyan03
lovyan03 merged commit 6f81929 into m5stack:develop Oct 16, 2026
26 checks passed
@ainyan03
ainyan03 deleted the docs_comments branch October 16, 2026 05:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants