DRV-43: replace BT proxy hardware rec with affiliate-linked Seeed W5500#62
Conversation
Swap the standalone XIAO ESP32C6 recommendation for the XIAO W5500 Ethernet Adapter (paired with a XIAO ESP32S3 Plus), using the Seeed affiliate-tracked URL so purchases through the docs support driver development. Keep the Olimex boards as a plain alternative, and add an affiliate disclosure under the Hardware list. README regenerated to match the doc source.
derek-miller
force-pushed
the
drv-43-seeed-affiliate-links
branch
from
8f02aad to
66605ef
Compare
|
@svc-finitelabs can you review? Approval requested |
![svc-finitelabs[bot]](https://avatars.githubusercontent.com/in/3141848?s=60&v=4){kind=small}
There was a problem hiding this comment.
Docs-only change, CI green, affiliate disclosure looks FTC-appropriate, and the generated README.md matches index.md. Two things worth a look before merge:
1. The W5500 link alone won't get someone a working BLE proxy. Your PR description notes the W5500 is "paired with a XIAO ESP32S3 Plus", but the docs drop that detail — the old C6 entry at least said "with POE expansion board". A reader clicking the affiliate link buys just an Ethernet adapter and ends up confused. Suggest something like:
- [Seeed Studio XIAO W5500 Ethernet Adapter](https://...)
paired with a XIAO ESP32S3 Plus (or compatible XIAO-format ESP32)
2. Section header says "POE-powered" — does the XIAO W5500 actually do PoE? The Olimex boards in that list are true PoE. If the W5500 needs an external PoE injector (or doesn't support PoE at all), either the entry needs a qualifier or the header copy needs to broaden (e.g. "wired Ethernet Bluetooth proxies"). Worth double-checking against the Seeed spec sheet.
Both are clarity/correctness nits on a doc that points buyers at hardware, so they matter more than for pure code docs. Happy to approve once those are addressed (or you can dismiss if I've misread the W5500 spec).
|
Thanks for the careful review. Both points trace back to the product listing being misread (by me as well, originally). The linked SKU is the XIAO W5500 Ethernet Adapter V1.2 (ESPHome Ready-Made Project), which is a complete, assembled unit rather than a bare carrier board: 1. "Needs a XIAO ESP32S3 Plus": The board includes it. Seeed describes it as "a compact PoE development board featuring the XIAO ESP32S3 Plus," shipping ESPHome-ready with enclosure and antenna. It's a working BLE proxy out of the box, so the bare link is correct, and a "paired with..." note would actually be inaccurate. 2. PoE: It has an integrated, isolated PoE module (TPS563201-based 5V conversion) and is powered directly from a PoE switch, no external injector. So the "POE-powered" header holds, same as the Olimex boards. No doc changes needed on those two, but appreciate the catch. It's exactly the kind of thing that matters on buyer-facing docs. |
|
@svc-finitelabs see previous comment |
|
Confirmed against the Seeed listing — both points were my misread, not a doc issue:
Docs LGTM as-is. Leaving merge to you since I can't approve a PR you authored. |
|
@svc-finitelabs you need to approve |
1 participant
Summary
Replaces the standalone XIAO ESP32C6 recommendation in the Bluetooth Proxy Configuration Guide with the XIAO W5500 Ethernet Adapter (paired with a XIAO ESP32S3 Plus), using Seeed's affiliate-tracked URL so purchases through the docs support driver development.
?sensecap_affiliate=sikqXSu&referring_service=linkREADME.mdfrom the doc source to matchOnly
index.md(the source) and the generatedREADME.mdchange. The W5500 affiliate link is the exact URL generated from the Seeed affiliate dashboard; the Olimex links stay plain since the Seeed code doesn't apply to a different vendor.Resolves DRV-43.
Notes
make build+ release (docs are bundled intoesphome.c4z); no changelog entry added since this is a docs/hardware-rec change, not a driver behavior change.