Skip to content

Commit

Permalink
Rename ESPHome Dashboard to ESPHome Compiler (#675)
Browse files Browse the repository at this point in the history
  • Loading branch information
klaasnicolaas authored Dec 3, 2024
1 parent 4122735 commit 1f49f05
Show file tree
Hide file tree
Showing 4 changed files with 10 additions and 10 deletions.
2 changes: 1 addition & 1 deletion docs/blog/2024-01-11-fresh-new-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ TL;DR - A lot 😅 ... v4.0.0 has been released, the most important changes are
1. The pulse meter pin for ESP32 boards has been changed from GPIO `13` to GPIO `26`.
2. The `home_assistant_glow.yaml` file no longer exists.

This would break the **package_import** for existing configs for people in the ESPHome dashboard. If you would like to use the latest version, I recommend re-flashing your ESP according to step 2 in [Getting Started](/docs/getting-started#step-2-install-firmware), and if desired, [re-adopting](/docs/advanced/firmware_changes#adopting-the-device) your device again in ESPHome dashboard (add-on).
This would break the **package_import** for existing configs for people in the ESPHome Compiler (add-on). If you would like to use the latest version, I recommend re-flashing your ESP according to step 2 in [Getting Started](/docs/getting-started#step-2-install-firmware), and if desired, [re-adopting](/docs/advanced/firmware_changes#adopting-the-device) your device again in ESPHome compiler (add-on).

### New config structure

Expand Down
6 changes: 3 additions & 3 deletions docs/docs/advanced/firmware_changes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ description: Learn how to customize the firmware of the Glow using ESPHome.

The Glow's firmware is built on [ESPHome](https://esphome.io), a platform designed for customization through simple YAML configurations. Whether you need to tweak the device's functionality or adapt it for different use cases, the process is straightforward.

This guide will walk you through how to adopt the device and customize its firmware using the [ESPHome Dashboard](https://esphome.io/guides/getting_started_hassio.html).
This guide will walk you through how to adopt the device and customize its firmware using the [ESPHome Compiler](https://esphome.io/guides/getting_started_hassio.html).

## Adopting the Device

Before making any changes to the firmware, you first need to adopt the device into the ESPHome. Once your ESPHome Dashboard is up and running, and the Glow is connected to your local network, you should see an option to adopt it.
Before making any changes to the firmware, you first need to adopt the device into the ESPHome. Once your ESPHome Compiler is up and running, and the Glow is connected to your local network, you should see an option to adopt it.

<p align="left">
<img src={require('@site/static/img/customization/adopt-esphome.png').default} />
Expand All @@ -38,7 +38,7 @@ The firmware is designed to be flexible for different ESP boards by breaking it

### Making Your First Customization

Once your device is adopted, you can start customizing its behavior by editing the configuration files. In the ESPHome dashboard, click on **EDIT** next to the device to open the YAML editor, where you can modify the configuration directly.
Once your device is adopted, you can start customizing its behavior by editing the configuration files. In the ESPHome Compiler, click on **EDIT** next to the device to open the YAML editor, where you can modify the configuration directly.

<p align="left">
<img src={require('@site/static/img/customization/edit-device.png').default} />
Expand Down
10 changes: 5 additions & 5 deletions docs/docs/advanced/firmware_updates.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ The easiest way to update the firmware of the Glow is through Home Assistant. Wh
</p>

:::note
Since ESPHome 2024.6.x, the update component can directly retrieve firmware updates from the glow energy manifest. Which has made updating even easier and eliminates the need to use ESPHome Dashboard add-on just for updates.
Since ESPHome 2024.6.x, the update component can directly retrieve firmware updates from the [glow-energy.io](https://glow-energy.io) manifest. Which has made updating even easier and eliminates the need to use ESPHome Compiler (add-on) just for updates.
:::

## Glow Web Interface
Expand All @@ -47,13 +47,13 @@ If you are unable to update the firmware through Home Assistant, you can also up

After the update is complete, the device will automatically reboot with the new firmware.

## ESPHome Dashboard
## ESPHome Compiler

_Level of Difficulty: **Advanced**_

If you are using the ESPHome Dashboard add-on in Home Assistant, you can also update the firmware through the dashboard. This method is useful if you have adopted the firmware to your ESPHome dashboard and know how to tweak the YAML configuration.
If you are using the ESPHome Compiler add-on in Home Assistant, you can also update the firmware through the compiler dashboard. This method is useful if you have adopted the firmware to your ESPHome Compiler and know how to tweak the YAML configuration.

1. Open the ESPHome Dashboard.
1. Open the ESPHome Compiler (add-on).
2. If it is possible to update the firmware, you will see an update button at the device card (see image below).
3. Click on the **UPDATE** button to start the process.
4. Select **Wirelessly** to update the firmware over-the-air (OTA).
Expand All @@ -65,6 +65,6 @@ Once the update is complete, the device will automatically reboot with the new f
<img
width="80%"
src={require('@site/static/img/advanced/glow_update-esphome.png').default}
alt="Update firmware through ESPHome Dashboard"
alt="Update firmware through ESPHome Compiler (add-on)"
/>
</p>
2 changes: 1 addition & 1 deletion docs/docs/faq/faq_nr8.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: How to set OTA password
description: How to set an OTA password for your ESPHome device
---

Since [release v4.1.0](/blog/release-4.1.0#esphome-ota-updates), the OTA component is in a separate (external) [package], so it is no longer in your config when you adopt the Home Assistant Glow in ESPHome dashboard. Fortunately, the ESPHome platform has an ID under the OTA component so you can use [!extend]. This way, you can set the OTA password in your Glow configuration.
Since [release v4.1.0](/blog/release-4.1.0#esphome-ota-updates), the OTA component is in a separate (external) [package], so it is no longer in your config when you adopt the Home Assistant Glow in ESPHome Compiler (add-on). Fortunately, the ESPHome platform has an ID under the OTA component so you can use [!extend]. This way, you can set the OTA password in your Glow configuration.

```yaml title="your_glow_config.yaml"
ota:
Expand Down

0 comments on commit 1f49f05

Please sign in to comment.