Skip to content

blog: Article for promote BSP Generator#743

Open
espzav wants to merge 1 commit into
espressif:mainfrom
espzav:blog/esp-bsp-generator
Open

blog: Article for promote BSP Generator#743
espzav wants to merge 1 commit into
espressif:mainfrom
espzav:blog/esp-bsp-generator

Conversation

@espzav

@espzav espzav commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

📝 Description

This is the article about new tool - BSP Generator.

Publish date

Expected publish date: 2026-06-30 or earlier

Review process

  • Initiate technical review
    • This item is N/A
    • Add subject matter experts (your team members, experts in the field)
  • Once tech review mostly done, initiate editorial review
    • Add technical editors (@f-hollow, @FBEZ, and/or @pedrominatel)

Checks

  • Article folder and file names:
    • Folder path is content/blog/YYYY/MM/my-new-article (articles only)
    • Folder and file names have no underscores, spaces, or uppercase letters (My new_article)
  • New article's YAML frontmatter:
    • Title updated
    • Date matches the format date: 20YY-MM-DD
    • Summary updated
    • Authors added (see Add youself as an author)
    • Tags added
  • Updated article's YAML frontmatter:
    • This item is N/A
    • If article folder is moved or renamed, the field aliases: with a new URL slug is added
    • Date of update is added lastmode: 20YY-MM-DD
  • Article media files:
    • All images are in .WebP format (see Use WebP for raster images)
    • Images are compressed within 100-300 KB, with a hard limit of ≤ 500 kB
    • Where possible, Hugo shortcodes are used instead of raw HTML for content types unsupported by markdown (see Use additional content types)
  • Links in articles
    • Make sure all links are valid
    • No links to Google docs present
    • Use a specific ESP-IDF version in links (avoid stable, hard no for latest)
  • Git history
    • Commits are clean and squashed to the minimum necessary
    • Commit messages follow Conventional Commits format
    • Your feature branch is rebased on main

🔗 Related

🧪 Testing (Hugo)

  • I have run hugo server locally and verified there are no build errors.
  • I have checked the rendered output on Desktop view.
  • I have verified that internal links and syntax highlighting work correctly.

@espzav espzav force-pushed the blog/esp-bsp-generator branch from b474144 to 128c422 Compare June 11, 2026 12:07
@espzav

espzav commented Jun 11, 2026

Copy link
Copy Markdown
Contributor Author

@PetrESP, @tore-espressif, @igrr, @georgik PTAL

@espzav espzav force-pushed the blog/esp-bsp-generator branch 3 times, most recently from 07ee94e to bf6d544 Compare June 11, 2026 12:41
@pedrominatel pedrominatel requested a review from f-hollow June 11, 2026 12:44
@pedrominatel pedrominatel added the needs review Needs someone to be assigned to review label Jun 11, 2026
@espzav espzav force-pushed the blog/esp-bsp-generator branch from bf6d544 to 2b13102 Compare June 11, 2026 12:48
@georgik

georgik commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Lgtm. Just trim screenshot borders. It is visible in dark mode. There is a lot of unused whitspace. Probably only portion of ui is necessary.

@PetrESP PetrESP left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really like the pictures and that goes straight to the point. I have some comments and suggestions from my point of view

Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated
Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated
2. Click **Load configuration** and pick a starter board that matches your prototype (e.g. ESP-BOX-3, ESP32-S3-EYE, ESP32-C3-LCDKit).
3. The form fills in MCU, features, drivers, and pin assignments - the same structure as the official BSP in [esp-bsp/bsp/](https://github.com/espressif/esp-bsp/tree/master/bsp).

You are not inventing a BSP from scratch. You are **forking a known-good baseline**.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To me this is AI being AI. The paragraph already says exactly what to do and what it achieves. I think that this is unnecessary and I would remove this

Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated
Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated
Application code → largely the same #include and BSP APIs
```

You are not maintaining a fork of esp-bsp forever. You maintain a **small, generated board package** that follows the same conventions as [espressif/esp-bsp](https://github.com/espressif/esp-bsp): component layout, `bsp_*` helpers, LVGL integration via [esp_lvgl_port](https://github.com/espressif/esp-bsp/tree/master/components/esp_lvgl_port), examples you can compare under [esp-bsp/examples/](https://github.com/espressif/esp-bsp/tree/master/examples).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To me this whole paragraph does not make sense because this customer that uses BSP selector will not maintain the small, generated board package. He only has to save the json somewhere and the BSP team is maintaining the generated board package.
I think that this whole paragraph can be shortened and merged with Your application keeps calling the same BSP entry points:

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think, we can keep this paragraph.

| | [esp-bsp](https://github.com/espressif/esp-bsp) | [BSP Generator](https://bsp-generator.espressif.tools) |
|---|------------------------------------------------|------------------------------------------------------|
| **Best for** | Official Espressif & partner boards | Your custom PCB |
| **Maintained by** | Espressif BSP team | Generated from shared templates |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here I would say it is also a bit misleading. I would say that even the generated component has to be maintained by the BSP team because once you start editing the generated package you can't really do what you advertise in ESP-IDF upgraded? Regenerate, don’t rewrite

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure, if I understand right, but generated custom board cannot be maintained by BSP team.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No I mean that the customer also should not maintain it. Ideally they should not touch the generated package because of they do then it can't be re-generated in the future because it would be missing those changes that they did.

@f-hollow f-hollow left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@espzav Thank you for writing the article!

Here are a few general suggestions. Please implement them, then I will review the article content.

Comment thread content/blog/2026/06/bsp-generator-promo/img/featured.webp Outdated
Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated
Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated
Comment thread content/blog/2026/06/bsp-generator-promo/index.md Outdated

## Tune features for *your* PCB

![Starter board loaded — ESP-BOX-3 configuration ready to customize](img/03-starter-board-loaded.webp)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

About this one and all other screenshots in the article.

Consider using a dedicated syntax for including images.

Please remember that articles can be read not only by humans, but also by AI these days.

If big chunks of information are only available in a screenshot, the possible scenarios are:

  • The agent needs to process the image which takes many more tokens
  • The agent might not be able to analyze images at all

Another question: is the information in the screenshot really important in the article context (like, let's say, you want to discuss certain things that are not clear from the web interface)? If yes, write this information out in text. If no, reduce or remove the screenshot.

Also, why make screenshots of large areas of web pages if they can be easily viewed by clicking a link?

@espzav espzav force-pushed the blog/esp-bsp-generator branch from 2b13102 to d63b6b7 Compare June 12, 2026 11:42
@espzav

espzav commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

@PetrESP Thank you for review, updated by your comments.

@github-actions

Copy link
Copy Markdown

🎉 A preview for this PR is available at: https://preview-developer.espressif.com/pr743/

@espzav

espzav commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

@f-hollow Thank you for your review. I made some updates by your comments, but...:

Also, why make screenshots of large areas of web pages if they can be easily viewed by clicking a link?

I am sorry, but I really hate articles about something without images. I know that many things are clear and you can see it on the web but I don't want to change browser tabs. I want to see parts of the page that are about. I updated images a little for more focus.
We are still making it for people not for AI. Yes, we can optimize for AI but we want to make it good for reading by people. :-)

@espzav

espzav commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

@georgik Thank you for the review. I updated images.

@pedrominatel pedrominatel removed the needs review Needs someone to be assigned to review label Jun 12, 2026
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.

5 participants