-
-
Notifications
You must be signed in to change notification settings - Fork 4k
Update USERMOD BME68X to version 1.0.2 #4620
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update USERMOD BME68X to version 1.0.2 #4620
Conversation
WalkthroughThe changes update the BME68X usermod documentation and configuration. The README now features improved formatting with clearer sections, including a new "Compilation" section and an expanded revision history reflecting version 1.0.2. A new function, Changes
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
CodeRabbit Configuration File (
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Nitpick comments (8)
usermods/BME68X_v2/library.json (1)
2-2: Typo in JSON Key:
The key is defined as"name:"(with an extra colon) instead of the expected"name". This could lead to misconfiguration or lookup issues within the build system. Please remove the colon to ensure the key conforms to the standard JSON configuration.usermods/BME68X_v2/README.md (7)
5-5: Add Alternative Text for Images:
Several<img>tags (at lines 5, 9, 13, and 17) lack alt attributes, which hurts accessibility and does not comply with markdownlint (MD045) guidelines. Please add descriptive alt text (e.g.alt="Diagram of sensor placement") to all image tags.Also applies to: 9-9, 13-13, 17-17
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
5-5: Images should have alternate text (alt text)
null(MD045, no-alt-text)
57-58: Remove Duplicate Sentence:
The sentence about sensor calibration is repeated (lines 57 and 58). Removing the duplicate will enhance clarity and reduce redundancy.
64-64: Consistent Terminology:
In line 64, consider hyphenating “GAS based” to “gas-based” for improved consistency and readability.🧰 Tools
🪛 LanguageTool
[uncategorized] ~64-~64: This expression is usually spelled with a hyphen.
Context: ...ation is finished (1) Furthermore, all GAS based values have their own accuracy value. T...(BASED_HYPHEN)
66-67: Correct Typo in Calibration Details:
In line 67, the word “chaning” appears; it should be corrected to “changing.”🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
66-66: Hard tabs
Column: 20(MD010, no-hard-tabs)
67-67: Hard tabs
Column: 19(MD010, no-hard-tabs)
144-145: Revision History Formatting:
In the Version 1.0.2 section (lines 144–145), unordered list items are marked with asterisks. For consistency with repository guidelines, please replace the asterisks with dashes (-).
23-29: Replace Hard Tabs with Spaces:
Several sections (e.g., within the sensor tables and settings lists) contain hard tabs. Replacing these with spaces will ensure consistent formatting across editors and viewers, and it addresses several markdownlint (MD010) warnings.Also applies to: 85-93
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
23-23: Heading style
Expected: atx; Actual: setext(MD003, heading-style)
23-23: Hard tabs
Column: 7(MD010, no-hard-tabs)
23-23: Hard tabs
Column: 17(MD010, no-hard-tabs)
23-23: Hard tabs
Column: 23(MD010, no-hard-tabs)
26-26: Hard tabs
Column: 12(MD010, no-hard-tabs)
26-26: Hard tabs
Column: 20(MD010, no-hard-tabs)
26-26: Hard tabs
Column: 27(MD010, no-hard-tabs)
27-27: Hard tabs
Column: 9(MD010, no-hard-tabs)
27-27: Hard tabs
Column: 16(MD010, no-hard-tabs)
27-27: Hard tabs
Column: 19(MD010, no-hard-tabs)
28-28: Hard tabs
Column: 9(MD010, no-hard-tabs)
28-28: Hard tabs
Column: 16(MD010, no-hard-tabs)
28-28: Hard tabs
Column: 21(MD010, no-hard-tabs)
29-29: Hard tabs
Column: 15(MD010, no-hard-tabs)
23-23: Standardize Heading Style:
Static analysis indicates that some headings are rendered in setext style instead of the repository’s preferred atx style (with#). Converting these headings to atx style can improve consistency and readability.Also applies to: 32-32, 42-42
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)
23-23: Heading style
Expected: atx; Actual: setext(MD003, heading-style)
23-23: Hard tabs
Column: 7(MD010, no-hard-tabs)
23-23: Hard tabs
Column: 17(MD010, no-hard-tabs)
23-23: Hard tabs
Column: 23(MD010, no-hard-tabs)
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (2)
usermods/BME68X_v2/README.md(3 hunks)usermods/BME68X_v2/library.json(1 hunks)
🧰 Additional context used
🪛 LanguageTool
usermods/BME68X_v2/README.md
[style] ~3-~3: Consider using “incompatible” to avoid wordiness.
Context: ...r a BME680/BME68X sensor. The BME68X is not compatible with the BME280/BMP280 chip. It has its...
(NOT_ABLE_PREMIUM)
[uncategorized] ~64-~64: This expression is usually spelled with a hyphen.
Context: ...ation is finished (1) Furthermore, all GAS based values have their own accuracy value. T...
(BASED_HYPHEN)
[style] ~88-~88: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ... the gas values are also published. - Pub Calib State: If this item is active,...
(ENGLISH_WORD_REPEAT_BEGINNING_RULE)
[grammar] ~109-~109: The verb ‘to depend’ requires the preposition ‘(up)on’.
Context: ... - getTemperature(); The scale °C/°F is depended to the settings - getHumidity(); - getPres...
(DEPEND_ON)
🪛 markdownlint-cli2 (0.17.2)
usermods/BME68X_v2/README.md
5-5: Images should have alternate text (alt text)
null
(MD045, no-alt-text)
9-9: Images should have alternate text (alt text)
null
(MD045, no-alt-text)
13-13: Images should have alternate text (alt text)
null
(MD045, no-alt-text)
17-17: Images should have alternate text (alt text)
null
(MD045, no-alt-text)
23-23: Heading style
Expected: atx; Actual: setext
(MD003, heading-style)
23-23: Hard tabs
Column: 7
(MD010, no-hard-tabs)
23-23: Hard tabs
Column: 17
(MD010, no-hard-tabs)
23-23: Hard tabs
Column: 23
(MD010, no-hard-tabs)
26-26: Hard tabs
Column: 12
(MD010, no-hard-tabs)
26-26: Hard tabs
Column: 20
(MD010, no-hard-tabs)
26-26: Hard tabs
Column: 27
(MD010, no-hard-tabs)
27-27: Hard tabs
Column: 9
(MD010, no-hard-tabs)
27-27: Hard tabs
Column: 16
(MD010, no-hard-tabs)
27-27: Hard tabs
Column: 19
(MD010, no-hard-tabs)
28-28: Hard tabs
Column: 9
(MD010, no-hard-tabs)
28-28: Hard tabs
Column: 16
(MD010, no-hard-tabs)
28-28: Hard tabs
Column: 21
(MD010, no-hard-tabs)
29-29: Hard tabs
Column: 15
(MD010, no-hard-tabs)
32-32: Heading style
Expected: atx; Actual: setext
(MD003, heading-style)
32-32: Hard tabs
Column: 7
(MD010, no-hard-tabs)
32-32: Hard tabs
Column: 17
(MD010, no-hard-tabs)
32-32: Hard tabs
Column: 23
(MD010, no-hard-tabs)
32-32: Multiple headings with the same content
null
(MD024, no-duplicate-heading)
35-35: Hard tabs
Column: 5
(MD010, no-hard-tabs)
36-36: Hard tabs
Column: 12
(MD010, no-hard-tabs)
37-37: Hard tabs
Column: 5
(MD010, no-hard-tabs)
38-38: Hard tabs
Column: 5
(MD010, no-hard-tabs)
39-39: Hard tabs
Column: 16
(MD010, no-hard-tabs)
42-42: Heading style
Expected: atx; Actual: setext
(MD003, heading-style)
42-42: Hard tabs
Column: 7
(MD010, no-hard-tabs)
42-42: Hard tabs
Column: 17
(MD010, no-hard-tabs)
42-42: Hard tabs
Column: 23
(MD010, no-hard-tabs)
42-42: Multiple headings with the same content
null
(MD024, no-duplicate-heading)
45-45: Hard tabs
Column: 18
(MD010, no-hard-tabs)
45-45: Hard tabs
Column: 20
(MD010, no-hard-tabs)
46-46: Hard tabs
Column: 11
(MD010, no-hard-tabs)
52-52: Images should have alternate text (alt text)
null
(MD045, no-alt-text)
62-62: Hard tabs
Column: 22
(MD010, no-hard-tabs)
66-66: Hard tabs
Column: 20
(MD010, no-hard-tabs)
67-67: Hard tabs
Column: 19
(MD010, no-hard-tabs)
68-68: Hard tabs
Column: 19
(MD010, no-hard-tabs)
69-69: Hard tabs
Column: 19
(MD010, no-hard-tabs)
79-79: Images should have alternate text (alt text)
null
(MD045, no-alt-text)
83-83: Hard tabs
Column: 14
(MD010, no-hard-tabs)
84-84: Hard tabs
Column: 19
(MD010, no-hard-tabs)
85-85: Hard tabs
Column: 16
(MD010, no-hard-tabs)
86-86: Hard tabs
Column: 23
(MD010, no-hard-tabs)
87-87: Hard tabs
Column: 20
(MD010, no-hard-tabs)
88-88: Hard tabs
Column: 23
(MD010, no-hard-tabs)
89-89: Hard tabs
Column: 18
(MD010, no-hard-tabs)
90-90: Hard tabs
Column: 19
(MD010, no-hard-tabs)
91-91: Hard tabs
Column: 20
(MD010, no-hard-tabs)
92-92: Hard tabs
Column: 31
(MD010, no-hard-tabs)
93-93: Hard tabs
Column: 28
(MD010, no-hard-tabs)
109-109: Hard tabs
Column: 20
(MD010, no-hard-tabs)
153-153: Unordered list style
Expected: dash; Actual: asterisk
(MD004, ul-style)
154-154: Unordered list style
Expected: dash; Actual: asterisk
(MD004, ul-style)
🔇 Additional comments (2)
usermods/BME68X_v2/README.md (2)
107-112: Improve Method Description Grammar:
The phrase “The scale °C/°F is depended to the settings” (for bothgetTemperature();andgetDewPoint();) is grammatically incorrect. A clearer phrasing would be “The scale °C/°F depends on the settings” or “is set according to the settings.”
[grammar, suggest_nitpick]🧰 Tools
🪛 LanguageTool
[grammar] ~109-~109: The verb ‘to depend’ requires the preposition ‘(up)on’.
Context: ... - getTemperature(); The scale °C/°F is depended to the settings - getHumidity(); - getPres...(DEPEND_ON)
🪛 markdownlint-cli2 (0.17.2)
109-109: Hard tabs
Column: 20(MD010, no-hard-tabs)
126-133: Clear Compilation Instructions:
The new Compilation section clearly explains how to enable the usermod viaplatformio_override.ini. This addition improves usability by guiding users through the build process.
willmmiles
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice job, you beat me to it!
I have updated the USERMOD_BME68X from version 1.0.1 version 1.0.2.
The following was modified:
Greetings and have a nice weekend
Gabriel
Summary by CodeRabbit
Documentation
Chores