[nrf52] minimum examples

[tomaszduda23]

Description:

Add troubleshooting for nrf52 so people can reference it easier.

Related issue (if applicable): fixes

Pull request in esphome with YAML changes (if applicable):

• esphome/esphome#

Checklist:

• I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
  or

• I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

• Link added in /components/index.rst when creating new documents for new components or cookbook.

New Component Images

If you are adding a new component to ESPHome, you can automatically generate a standardized black and white component name image for the documentation.

To generate a component image:

1. Comment on this pull request with the following command, replacing COMPONENT_NAME with your component name in UPPER_CASE format with underscores (e.g., BME280, SHT3X, DALLAS_TEMP):

   @esphomebot generate image COMPONENT_NAME
   

2. The ESPHome bot will respond with a downloadable ZIP file containing the SVG image.

3. Extract the SVG file and place it in the images/ folder of this repository.

4. Use the image in your component's index table entry in /components/index.rst.

Example: For a component called "DHT22 Temperature Sensor", use:

@esphomebot generate image DHT22

[netlify]

✅ Deploy Preview for esphome ready!

Name	Link
🔨 Latest commit	ccd9dc7
🔍 Latest deploy log	https://app.netlify.com/projects/esphome/deploys/68f368bd3857fd000847c086
😎 Deploy Preview	https://deploy-preview-5493--esphome.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Walkthrough

A Troubleshooting section is added to the nrf52.md documentation with bootloader upgrade guidance and a "How to start" subsection containing LED-blink ESPHome configuration examples for nrf52840-based boards.

Changes

Cohort / File(s)	Change Summary
nrf52 Documentation Updates content/components/nrf52.md	Added Troubleshooting section with bootloader upgrade note and "How to start" subsection featuring LED-blink ESPHome YAML examples for supermini-nrf52840 and xiao_ble boards

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Suggested reviewers

• jesserockz
• frenck

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The title "[nrf52] minimum examples" is directly related to the changeset. The raw summary indicates that the changes add a "How to start" subsection containing example LED-blink ESPHome configurations, which corresponds to the "minimum examples" referenced in the title. While the title emphasizes the examples aspect rather than the broader troubleshooting context mentioned in the PR description, it clearly identifies a real and significant part of the change with a specific, understandable phrase rather than generic wording. The title effectively communicates one of the main components added to the documentation.
Description Check	✅ Passed	The PR description "Add troubleshooting for nrf52 so people can reference it easier" is clearly related to the changeset. The raw summary explicitly states that the changes add a new Troubleshooting section to the nrf52 documentation, which directly aligns with the stated purpose. The description, while brief, accurately captures the intent of the changes and is not off-topic or unrelated to the documentation additions being made. This satisfies the lenient criteria for passing the description check.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

content/components/nrf52.md (1)

106-106: Minor text clarity improvement.

The phrase "Try minimum LED blinking sketch for the board:" is slightly awkward. Consider rephrasing to: "Try this minimal LED blinking sketch for your board:" for better readability.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 87f9442 and ccd9dc7.

📒 Files selected for processing (1)

• content/components/nrf52.md (1 hunks)

🧰 Additional context used

📓 Path-based instructions (1)

**

⚙️ CodeRabbit configuration file

• Do not generate or add any sequence diagrams

Files:

• content/components/nrf52.md

🔇 Additional comments (2)

content/components/nrf52.md (2)

98-156: Comprehensive troubleshooting and examples structure looks good.

The addition of a Troubleshooting section with bootloader upgrade guidance and "How to start" examples with concrete YAML configurations is a solid improvement to the documentation. The YAML syntax is correct, GPIO pin references are valid per the GPIO Pin Numbering section, and the interval/output configuration patterns are idiomatic to ESPHome. Once the board naming clarification is addressed, this section should be highly useful for users getting started with nrf52 boards.

---

106-131: ---

Clarify board naming inconsistency in the supermini example.

The header references "supermini-nrf52840" but the configuration specifies board: adafruit_itsybitsy_nrf52840. This mismatch will confuse users about which board identifier to use. Either update the header to indicate this is an alternative board using the adafruit_itsybitsy_nrf52840 configuration, or clarify the relationship between the supermini board and the adafruit configuration being used.

[optimusprimespace]

This is great for newbies. What would be even better is if somebody would include the nrf52 to the "add new device" option at the dashboard.