mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-08-05 07:28:02 +00:00
ESPHome: migrate Bluetooth and media player pages
- Add pages to docs to improve visibility
This commit is contained in:
c0ffeeca7
parent
d9a2b3e4a9
commit
b1aa68d8dc
@ -184,6 +184,16 @@
|
|||||||
<li>{% active_link /integrations/mqtt/#logging Logging %}</li>
|
<li>{% active_link /integrations/mqtt/#logging Logging %}</li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
|
<li>
|
||||||
|
<b>{% active_link /integrations/esphome ESPHome %}</b>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
{% active_link /docs/esphome/increasing_bluetooth_reach Increasing bluetooth reach %}
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
{% active_link /docs/esphome/adding_esphome_media_players Adding media players %}
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<b>Hardware</b>
|
<b>Hardware</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
|||||||
29
source/_includes/esphome/flash_firmware_steps.markdown
Normal file
29
source/_includes/esphome/flash_firmware_steps.markdown
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
|
||||||
|
3. Connect the device to your computer.
|
||||||
|
* In the popup window, view the available ports.
|
||||||
|
* Plug the USB cable into the device and connect it to your computer.
|
||||||
|
* In the pop-up window, there should now appear a new entry. Select this USB serial port and select **Connect**.
|
||||||
|
* Depending on your computer, the entry might look different.
|
||||||
|
|
||||||
|
* If no new port shows, your system may be missing a driver. Close the pop-up window.
|
||||||
|
* In the dialog, select the CH342 driver, install it, then **Try again**.
|
||||||
|
|
||||||
|
1. Select your device, then **Install**.
|
||||||
|
* Follow the instructions provided by the installation wizard.
|
||||||
|
* Add the device to your Wi-Fi:
|
||||||
|
* When prompted, select your network from the list and enter the credentials to your 2.4 GHz Wi-Fi network.
|
||||||
|
* Select **Connect**.
|
||||||
|
* The device now joined your network. Select **Add to Home Assistant**.
|
||||||
|
1. This opens the **My** link to Home Assistant.
|
||||||
|
* If you have not used My Home Assistant before, you will need to configure it. If your Home Assistant URL is not accessible on `http://homeassistant.local:8123`, replace it with the URL to your Home Assistant instance.
|
||||||
|
* Open the link.
|
||||||
|
|
||||||
|
1. Select **OK**.
|
||||||
|
|
||||||
|
|
||||||
|
1. To add the newly discovered device, select the device from the list.
|
||||||
|
* Add your device to a room and select **Finish**.
|
||||||
|
1. You should now see a new integration.
|
||||||
|
|
||||||
|
|
||||||
|
* Your device is connected to Home Assistant over Wi-Fi. You can now move it to any place in your home with a USB power supply.
|
||||||
256
source/docs/esphome/adding_esphome_media_players.markdown
Normal file
256
source/docs/esphome/adding_esphome_media_players.markdown
Normal file
@ -0,0 +1,256 @@
|
|||||||
|
---
|
||||||
|
title: "Adding ESPHome media players"
|
||||||
|
---
|
||||||
|
|
||||||
|
Ready-made firmware to turn devices into ESPHome media players
|
||||||
|
|
||||||
|
<head>
|
||||||
|
<style>
|
||||||
|
body {
|
||||||
|
font-family: -apple-system, system-ui, BlinkMacSystemFont, "Segoe UI",
|
||||||
|
Roboto, Ubuntu, sans-serif;
|
||||||
|
padding: 0;
|
||||||
|
margin: 0;
|
||||||
|
line-height: 1.4;
|
||||||
|
}
|
||||||
|
.content {
|
||||||
|
max-width: 600px;
|
||||||
|
margin: 0 auto;
|
||||||
|
padding: 12px;
|
||||||
|
}
|
||||||
|
.hidden {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
esp-web-install-button[install-unsupported] {
|
||||||
|
visibility: inherit;
|
||||||
|
}
|
||||||
|
.content pre {
|
||||||
|
max-width: 100%;
|
||||||
|
overflow-y: scroll;
|
||||||
|
}
|
||||||
|
li {
|
||||||
|
padding: 4px 0;
|
||||||
|
}
|
||||||
|
.footer {
|
||||||
|
margin-top: 24px;
|
||||||
|
border-top: 1px solid #ccc;
|
||||||
|
padding-top: 24px;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
.footer .initiative {
|
||||||
|
font-style: italic;
|
||||||
|
margin-top: 16px;
|
||||||
|
}
|
||||||
|
table {
|
||||||
|
border-spacing: 0;
|
||||||
|
}
|
||||||
|
td {
|
||||||
|
padding: 8px;
|
||||||
|
border-bottom: 1px solid #ccc;
|
||||||
|
}
|
||||||
|
.radios {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: row;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
.radios label {
|
||||||
|
padding: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
width: calc(50% - 16px);
|
||||||
|
max-width: 184px;
|
||||||
|
display: block;
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
.radios input {
|
||||||
|
position: absolute;
|
||||||
|
top: 12px;
|
||||||
|
left: 12px;
|
||||||
|
}
|
||||||
|
.radios img {
|
||||||
|
display: block;
|
||||||
|
width: calc(100% - 8px);
|
||||||
|
border: 4px solid rgba(0, 0, 0, 0);
|
||||||
|
aspect-ratio: 1;
|
||||||
|
}
|
||||||
|
input:checked + img {
|
||||||
|
border-color: #58a6ff;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme: dark) {
|
||||||
|
body {
|
||||||
|
background-color: #333;
|
||||||
|
color: #fff;
|
||||||
|
}
|
||||||
|
a {
|
||||||
|
color: #58a6ff;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/* Remove this once we add a fifth media player */
|
||||||
|
@media only screen and (min-height: 1000px) {
|
||||||
|
.radios label {
|
||||||
|
max-width: initial;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
<script
|
||||||
|
type="module"
|
||||||
|
src="https://unpkg.com/esp-web-tools@9/dist/web/install-button.js?module"
|
||||||
|
></script>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
## Adding an ESPHome Media Player to Home Assistant
|
||||||
|
|
||||||
|
Pick your product and install [ESPHome](https://esphome.io) on it to use it directly as a media player inside Home Assistant. No programming required.
|
||||||
|
|
||||||
|
To install the ESPHome software on the device, follow these steps:
|
||||||
|
|
||||||
|
1. Open this page in a Chromium-based browser (for example Google Chrome or MS Edge) on a desktop. It does not work on a tablet or phone.
|
||||||
|
1. Pick your product.
|
||||||
|
|
||||||
|
|
||||||
|
<div class="content">
|
||||||
|
<div class="radios">
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="raspiaudio-muse-luxe" checked />
|
||||||
|
<img src="/images/docs/esphome/esp_muse_luxe.png" alt="Raspiaudio ESP Muse Luxe" />
|
||||||
|
</label>
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="raspiaudio-muse-proto" />
|
||||||
|
<img src="/images/docs/esphome/esp_muse_proto.png" alt="Raspiaudio ESP Muse Proto" />
|
||||||
|
</label>
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="m5stack-atom-speaker-kit" />
|
||||||
|
<img src="/images/docs/esphome/atom_speaker_kit.png" alt="M5Stack Atom Speaker Kit" />
|
||||||
|
</label>
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="m5stack-atom-echo" />
|
||||||
|
<img src="/images/docs/esphome/atom_echo.png" alt="M5Stack Atom Echo Development Kit" />
|
||||||
|
</label>
|
||||||
|
</div>
|
||||||
|
<br />
|
||||||
|
<p class="button-row" align="center">
|
||||||
|
<esp-web-install-button></esp-web-install-button>
|
||||||
|
</p>
|
||||||
|
<div class="hidden info raspiaudio-muse-luxe">
|
||||||
|
<h3>Raspiaudio ESP Muse Luxe</h3>
|
||||||
|
<p>
|
||||||
|
Portable speaker with two 5 Watt speakers built-in. Can run 4 hours
|
||||||
|
off the built-in battery or be powered by a cable.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
This is a powerful device. If you want to use it solely as a media
|
||||||
|
player, we recommend to use the
|
||||||
|
<a href="https://raspiaudio.github.io/">Squeezelite-ESP32 firmware</a
|
||||||
|
>.
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href="https://raspiaudio.com/produit/esp-muse-luxe"
|
||||||
|
>Raspiaudio</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.amazon.com/gp/product/B09N3S9S29/?&_encoding=UTF8&tag=homeassista0e-20&linkCode=ur2&linkId=71c80756dcd782eba9f1a80dc576c7d3&camp=1789&creative=9325"
|
||||||
|
>Amazon</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="hidden info raspiaudio-muse-proto">
|
||||||
|
<h3>Raspiaudio ESP Muse Proto</h3>
|
||||||
|
<p>
|
||||||
|
Powerful audio prototyping board to create your own smart speakers.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
This is a powerful device. If you want to use it solely as a media
|
||||||
|
player, we recommend to use the
|
||||||
|
<a href="https://raspiaudio.github.io/">Squeezelite-ESP32 firmware</a
|
||||||
|
>.
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href="https://raspiaudio.com/produit/muse-proto">Raspiaudio</a>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.amazon.com/gp/product/B097F884WL/?&_encoding=UTF8&tag=homeassista0e-20&linkCode=ur2&linkId=71c80756dcd782eba9f1a80dc576c7d3&camp=1789&creative=9325"
|
||||||
|
>Amazon</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="hidden info m5stack-atom-speaker-kit">
|
||||||
|
<h3>M5Stack Atom Speaker Kit</h3>
|
||||||
|
<p>Small ESP32 board with a built-in speaker and a headphone jack.</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://shop.m5stack.com/products/atom-speaker-kit-ns4168?ref=NabuCasa"
|
||||||
|
>M5Stack Shop</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.aliexpress.com/item/1005003297368240.html?aff_platform=portals-tool&sk=_A8G2YF&aff_trace_key=90326d2a90444b4887632f62dd533ce4-1654058373639-07963-_A8G2YF&terminal_id=c5517a8c9bb44b4fb32147398fbc2576&aff_fcid=90326d2a90444b4887632f62dd533ce4-1654058373639-07963-_A8G2YF&tt=CPS_NORMAL&aff_fsk=_A8G2YF"
|
||||||
|
>AliExpress</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="hidden info m5stack-atom-echo">
|
||||||
|
<h3>M5Stack Atom Echo Development Kit</h3>
|
||||||
|
<p>Tiny ESP32 board with a built-in speaker.</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://shop.m5stack.com/collections/m5-controllers/products/atom-echo-smart-speaker-dev-kit?ref=NabuCasa"
|
||||||
|
>M5Stack Shop</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.aliexpress.com/item/1005003299332198.html?aff_platform=portals-tool&sk=_A8G2YF&aff_trace_key=90326d2a90444b4887632f62dd533ce4-1654058373639-07963-_A8G2YF&terminal_id=c5517a8c9bb44b4fb32147398fbc2576&aff_fcid=90326d2a90444b4887632f62dd533ce4-1654058373639-07963-_A8G2YF&tt=CPS_NORMAL&aff_fsk=_A8G2YF"
|
||||||
|
>AliExpress</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
{% include /esphome/flash_firmware_steps.markdown %}
|
||||||
|
|
||||||
|
### Advanced Users
|
||||||
|
|
||||||
|
* The device is adoptable in [the ESPHome dashboard](https://my.home-assistant.io/redirect/supervisor_addon/?addon=5c53de3b_esphome&repository_url=https%3A%2F%2Fgithub.com%2Fesphome%2Fhome-assistant-addon).
|
||||||
|
* The YAML configuration is on [GitHub](https://github.com/esphome/media-players/)
|
||||||
|
|
||||||
|
### Affiliated links
|
||||||
|
|
||||||
|
Affiliated links are used on this website to support ESPHome development. Use Coupon code `NABUCASA` on [M5Stack](https://shop.m5stack.com/discount/NABUCASA?ref=NabuCasa) for 5% off your order.
|
||||||
|
|
||||||
|
[ESPHome](https://esphome.io)— Installer powered by [ESP Web Tools](https://esphome.github.io/esp-web-tools/)
|
||||||
|
|
||||||
|
<script>
|
||||||
|
document.querySelectorAll('input[name="type"]').forEach((radio) =>
|
||||||
|
radio.addEventListener("change", () => {
|
||||||
|
const button = document.querySelector("esp-web-install-button");
|
||||||
|
button.manifest = `https://esphome.github.io/media-players/${radio.value}-manifest.json`;
|
||||||
|
document.querySelectorAll(".info").forEach((info) => {
|
||||||
|
info.classList.add("hidden");
|
||||||
|
});
|
||||||
|
document
|
||||||
|
.querySelector(`.info.${radio.value}`)
|
||||||
|
.classList.remove("hidden");
|
||||||
|
})
|
||||||
|
);
|
||||||
|
document
|
||||||
|
.querySelector('input[name="type"]:checked')
|
||||||
|
.dispatchEvent(new Event("change"));
|
||||||
|
</script>
|
||||||
339
source/docs/esphome/increasing_bluetooth_reach.markdown
Normal file
339
source/docs/esphome/increasing_bluetooth_reach.markdown
Normal file
@ -0,0 +1,339 @@
|
|||||||
|
---
|
||||||
|
title: "Increasing the reach of bluetooth devices"
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<head>
|
||||||
|
<style>
|
||||||
|
body {
|
||||||
|
font-family: -apple-system, system-ui, BlinkMacSystemFont, "Segoe UI",
|
||||||
|
Roboto, Ubuntu, sans-serif;
|
||||||
|
padding: 0;
|
||||||
|
margin: 0;
|
||||||
|
line-height: 1.4;
|
||||||
|
}
|
||||||
|
.content {
|
||||||
|
max-width: 600px;
|
||||||
|
margin: 0 auto;
|
||||||
|
padding: 12px;
|
||||||
|
}
|
||||||
|
.header {
|
||||||
|
display: block;
|
||||||
|
width: 100%;
|
||||||
|
aspect-ratio: 1200 / 675;
|
||||||
|
border-radius: 12px;
|
||||||
|
}
|
||||||
|
.hidden {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
li {
|
||||||
|
padding: 4px 0;
|
||||||
|
}
|
||||||
|
.radios {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: row;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
.radios label {
|
||||||
|
padding: 4px;
|
||||||
|
cursor: pointer;
|
||||||
|
width: calc(33.3% - 16px);
|
||||||
|
display: block;
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
.radios input {
|
||||||
|
position: absolute;
|
||||||
|
top: 12px;
|
||||||
|
left: 12px;
|
||||||
|
}
|
||||||
|
.radios img {
|
||||||
|
display: block;
|
||||||
|
width: calc(100% - 8px);
|
||||||
|
border: 4px solid rgba(0, 0, 0, 0);
|
||||||
|
aspect-ratio: 1;
|
||||||
|
}
|
||||||
|
input:checked + img {
|
||||||
|
border-color: #58a6ff;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme: dark) {
|
||||||
|
body {
|
||||||
|
background-color: #333;
|
||||||
|
color: #fff;
|
||||||
|
}
|
||||||
|
a {
|
||||||
|
color: #58a6ff;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
@media only screen and (max-width: 450px) {
|
||||||
|
.radios label {
|
||||||
|
width: calc(50% - 16px);
|
||||||
|
max-width: initial;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
.diy::after {
|
||||||
|
content: "DIY";
|
||||||
|
background-color: #f44336;
|
||||||
|
color: #fff;
|
||||||
|
padding: 2px 4px;
|
||||||
|
border-radius: 4px;
|
||||||
|
font-size: 0.8em;
|
||||||
|
position: absolute;
|
||||||
|
bottom: 12px;
|
||||||
|
left: 12px;
|
||||||
|
}
|
||||||
|
body .diy {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
body.show-diy .diy {
|
||||||
|
display: initial;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
<script
|
||||||
|
type="module"
|
||||||
|
src="https://unpkg.com/esp-web-tools@9/dist/web/install-button.js?module"
|
||||||
|
></script>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
|
||||||
|
Bluetooth technology has a limited range. Home Assistant can expand the reach of its Bluetooth devices by communicating via Bluetooth proxy devices powered by [ESPHome](https://esphome.io/).
|
||||||
|
|
||||||
|
Pick your product to turn it into a Bluetooth proxy for Home Assistant. No programming or other software required.
|
||||||
|
|
||||||
|
To install the ESPHome software on the device, follow these steps:
|
||||||
|
|
||||||
|
1. Open this page in a Chromium-based browser (for example Google Chrome or MS Edge) on a desktop. It does not work on a tablet or phone.
|
||||||
|
1. Pick your product.
|
||||||
|
|
||||||
|
<div class="content">
|
||||||
|
<div class="radios">
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="esp32-generic" checked />
|
||||||
|
<img src="/images/docs/esphome/esp32_generic.png" alt="ESP32 Generic" />
|
||||||
|
</label>
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="m5stack-atom-lite" />
|
||||||
|
<img src="/images/docs/esphome/m5stack_atom_lite.png" alt="M5Stack Atom Lite" />
|
||||||
|
</label>
|
||||||
|
<label>
|
||||||
|
<input type="radio" name="type" value="olimex-esp32-poe-iso" />
|
||||||
|
<img
|
||||||
|
src="/images/docs/esphome/olimex_esp32_poe_iso.png"
|
||||||
|
alt="Olimex ESP32 Power-over-Ethernet ISO"
|
||||||
|
/>
|
||||||
|
</label>
|
||||||
|
<label class="diy">
|
||||||
|
<input type="radio" name="type" value="lilygo-t-eth-poe" />
|
||||||
|
<img src="/images/docs/esphome/lilygo-eth-poe.png" alt="LilyGO T-ETH-POE" />
|
||||||
|
</label>
|
||||||
|
<label class="diy">
|
||||||
|
<input type="radio" name="type" value="gl-s10" />
|
||||||
|
<img src="/images/docs/esphome/gl-s10.png" alt="GL.iNet GL-S10" />
|
||||||
|
</label>
|
||||||
|
<label class="diy">
|
||||||
|
<input type="radio" name="type" value="wt32-eth01" />
|
||||||
|
<img src="/images/docs/esphome/wt32-eth01.png" alt="Wireless-Tag WT32-ETH01" />
|
||||||
|
</label>
|
||||||
|
</div>
|
||||||
|
<br />
|
||||||
|
<p class="button-row" align="center">
|
||||||
|
<esp-web-install-button></esp-web-install-button>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<div class="hidden info esp32-generic">
|
||||||
|
<h3>Generic ESP32</h3>
|
||||||
|
<p>
|
||||||
|
Turn any ESP32 into a Bluetooth proxy for Home Assistant. This option
|
||||||
|
only works for "plain" ESP32 and not for ESP32-C3 or other variants.
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.amazon.com/ESP-WROOM-32-Development-Microcontroller-Integrated-Compatible/dp/B08D5ZD528/?&_encoding=UTF8&tag=homeassista0e-20&linkCode=ur2&linkId=f9087b654cd5735f0761ae5db99e1e1a&camp=1789&creative=9325"
|
||||||
|
>Amazon</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="hidden info gl-s10">
|
||||||
|
<h3>GL.iNet GL-S10</h3>
|
||||||
|
<p>
|
||||||
|
ESP32 in a case with external antenna and wired Ethernet connection
|
||||||
|
that can also be powered using Power over Ethernet 802.3af. Note that
|
||||||
|
when installed via this website, Wi-Fi is disabled and it needs to be
|
||||||
|
connected via Ethernet.
|
||||||
|
</p>
|
||||||
|
<b>Warning: This board requires extra work.</b>
|
||||||
|
This device requires you to disassemble the device to be able to
|
||||||
|
install it as a Bluetooth proxy. This installation method is for
|
||||||
|
revision 2.X of their board. See instructions for the configuration of
|
||||||
|
other revisions.
|
||||||
|
<a href="https://blakadder.com/gl-s10/">Read DIY instructions.</a>
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://store.gl-inet.com/collections/iot-gateway/products/gl-s10-bluetooth-iot-gateway"
|
||||||
|
>GL.iNet Shop</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="hidden info m5stack-atom-lite">
|
||||||
|
<h3>M5Stack Atom Lite</h3>
|
||||||
|
<p>Small ESP32 board with a case.</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://shop.m5stack.com/products/atom-lite-esp32-development-kit?ref=NabuCasa"
|
||||||
|
>M5Stack Shop</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.aliexpress.com/item/1005003299215808.html?aff_platform=portals-tool&sk=_A8G2YF&aff_trace_key=90326d2a90444b4887632f62dd533ce4-1654058373639-07963-_A8G2YF&terminal_id=c5517a8c9bb44b4fb32147398fbc2576&aff_fcid=90326d2a90444b4887632f62dd533ce4-1654058373639-07963-_A8G2YF&tt=CPS_NORMAL&aff_fsk=_A8G2YF"
|
||||||
|
>AliExpress</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="hidden info olimex-esp32-poe-iso">
|
||||||
|
<h3>Olimex ESP32 Power-over-Ethernet ISO</h3>
|
||||||
|
<p>
|
||||||
|
ESP32 board with wired Ethernet connection that can also be powered
|
||||||
|
using Power over Ethernet 802.3af. Note that when installed via this
|
||||||
|
website, Wi-Fi is disabled and it needs to be connected via Ethernet.
|
||||||
|
The <i>ESP32-POE-ISO-EA</i> variant may provide better Bluetooth range
|
||||||
|
since it has an external antennae.
|
||||||
|
<a href="https://www.thingiverse.com/thing:3857281"
|
||||||
|
>Case on Thingiverse.</a
|
||||||
|
>
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.olimex.com/Products/IoT/ESP32/ESP32-POE-ISO-EA/open-source-hardware"
|
||||||
|
>Olimex</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.mouser.com/ProductDetail/Olimex-Ltd/ESP32-POE-ISO?qs=sGAEpiMZZMuqBwn8WqcFUj2aNd7i9W7uc087HzBKguU1UBkflb3j3w%3D%3D"
|
||||||
|
>Mouser</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="hidden info wt32-eth01">
|
||||||
|
<h3>Wireless-Tag WT32-ETH01</h3>
|
||||||
|
<p>
|
||||||
|
ESP32 board with wired Ethernet connection. Note that when installed
|
||||||
|
via this website, Wi-Fi is disabled and it needs to be connected via
|
||||||
|
Ethernet.
|
||||||
|
<a href="https://www.thingiverse.com/search?q=WT32-ETH01"
|
||||||
|
>Various enclosures on Thingiverse.</a
|
||||||
|
>
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
<b>Warning: This board requires extra work.</b>
|
||||||
|
This device requires you to create a special flash tool to be able to
|
||||||
|
install it as a Bluetooth proxy.
|
||||||
|
<a
|
||||||
|
href="https://community.home-assistant.io/t/how-i-installed-esphome-on-the-wt32-eth01/359027"
|
||||||
|
>Read DIY instructions.</a
|
||||||
|
>
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href="https://www.aliexpress.com/wholesale?SearchText=WT32-ETH01"
|
||||||
|
>AliExpress</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://eu.mouser.com/ProductDetail/Seeed-Studio/102991455?qs=hd1VzrDQEGjybZ4QAH35DA%3D%3D"
|
||||||
|
>Mouser</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.tubeszb.com/product/wt32-eth01-bluetooth-proxy-kit/53"
|
||||||
|
>TubesZB - Kit with enlosure and USB-C</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="hidden info lilygo-t-eth-poe">
|
||||||
|
<h3>LilyGO T-ETH-POE ESP32-WROOM</h3>
|
||||||
|
<p>
|
||||||
|
A compact board with an ESP32-WROOM module and wired Ethernet
|
||||||
|
connection. Can be powered via Power over Ethernet 802.3af or via the
|
||||||
|
built in USB-C port. Note that when installed via this website, Wi-Fi
|
||||||
|
is disabled and it needs to be connected via Ethernet.
|
||||||
|
<a
|
||||||
|
href="https://www.thingiverse.com/search?q=LILYGO TTGO T-Internet-POE ESP32"
|
||||||
|
>Various enclosures on Thingiverse.</a
|
||||||
|
>
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
<b>Warning: This board requires extra work.</b>
|
||||||
|
This device comes with a special "download tool" that needs to be used
|
||||||
|
to install it as a Bluetooth proxy.
|
||||||
|
</p>
|
||||||
|
<p>Buy</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a
|
||||||
|
href="https://www.aliexpress.com/item/2255800936677694.html?pdp_ext_f=%7B%22sku_id%22%3A%2210000014557692201%22%7D"
|
||||||
|
>AliExpress</a
|
||||||
|
>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{% include /esphome/flash_firmware_steps.markdown %}
|
||||||
|
|
||||||
|
### Advanced Users
|
||||||
|
|
||||||
|
DIY Expert? [Show advanced boards](?diy)
|
||||||
|
|
||||||
|
* The device is adoptable in [the ESPHome dashboard](https://my.home-assistant.io/redirect/supervisor_addon/?addon=5c53de3b_esphome&repository_url=https%3A%2F%2Fgithub.com%2Fesphome%2Fhome-assistant-addon).
|
||||||
|
* The YAML configuration is on [GitHub](https://github.com/esphome/bluetooth-proxies/)
|
||||||
|
|
||||||
|
|
||||||
|
### Affiliated links
|
||||||
|
|
||||||
|
Affiliated links are used on this website to support ESPHome development. Use Coupon code `NABUCASA` on [M5Stack](https://shop.m5stack.com/discount/NABUCASA?ref=NabuCasa) for 5% off your order.
|
||||||
|
|
||||||
|
[ESPHome](https://esphome.io)— Installer powered by [ESP Web Tools](https://esphome.github.io/esp-web-tools/)
|
||||||
|
|
||||||
|
<script>
|
||||||
|
document.querySelectorAll('input[name="type"]').forEach((radio) => radio.addEventListener("change", () => {
|
||||||
|
const button = document.querySelector("esp-web-install-button");
|
||||||
|
button.manifest = `https://esphome.github.io/bluetooth-proxies/${radio.value}-manifest.json`;
|
||||||
|
document.querySelectorAll(".info").forEach((info) => {
|
||||||
|
info.classList.add("hidden");
|
||||||
|
});
|
||||||
|
document
|
||||||
|
.querySelector(`.info.${radio.value}`)
|
||||||
|
.classList.remove("hidden");
|
||||||
|
})
|
||||||
|
);
|
||||||
|
document
|
||||||
|
.querySelector('input[name="type"]:checked')
|
||||||
|
.dispatchEvent(new Event("change"));
|
||||||
|
if (new URLSearchParams(document.location.search).has("diy")) {
|
||||||
|
document.body.classList.add("show-diy");
|
||||||
|
}
|
||||||
|
</script>
|
||||||
BIN
source/images/docs/esphome/atom_echo.png
Normal file
BIN
source/images/docs/esphome/atom_echo.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 58 KiB |
BIN
source/images/docs/esphome/atom_speaker_kit.png
Normal file
BIN
source/images/docs/esphome/atom_speaker_kit.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 60 KiB |
BIN
source/images/docs/esphome/esp32_generic.png
Normal file
BIN
source/images/docs/esphome/esp32_generic.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
BIN
source/images/docs/esphome/esp_muse_luxe.png
Normal file
BIN
source/images/docs/esphome/esp_muse_luxe.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 134 KiB |
BIN
source/images/docs/esphome/esp_muse_proto.png
Normal file
BIN
source/images/docs/esphome/esp_muse_proto.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 114 KiB |
BIN
source/images/docs/esphome/gl-s10.png
Normal file
BIN
source/images/docs/esphome/gl-s10.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 29 KiB |
BIN
source/images/docs/esphome/lilygo-eth-poe.png
Normal file
BIN
source/images/docs/esphome/lilygo-eth-poe.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 117 KiB |
BIN
source/images/docs/esphome/m5stack_atom_lite.png
Normal file
BIN
source/images/docs/esphome/m5stack_atom_lite.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 57 KiB |
BIN
source/images/docs/esphome/olimex_esp32_poe_iso.png
Normal file
BIN
source/images/docs/esphome/olimex_esp32_poe_iso.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 266 KiB |
BIN
source/images/docs/esphome/wt32-eth01.png
Normal file
BIN
source/images/docs/esphome/wt32-eth01.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 108 KiB |
Loading…
x
Reference in New Issue
Block a user