You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

29 lines
1.6 KiB

  1. < [Why custom firmware?](why_custom_firmware.md) | [Index](../README.md) | [Configuration guide](configuration.md) >
  2. # Installation guide
  3. The code must be compiled into a firmware using ESPHome 2021.8.0 or later. Therefore, a prerequisite
  4. is that you have ESPHome up and running in some form (command line, docker container, web dashboard,
  5. possibly from within Home Assistant as an add-on). For information on this, please refer to the
  6. documentation on the [ESPHome website](https://esphome.io).
  7. The component code is distributed directly from GitHub. You will not have to download and install
  8. the code manually. This leverages the [external components](https://esphome.io/components/external_components.html)
  9. feature.
  10. Before you can compile the firmware, you will have to create the YAML configuration file for your
  11. device. You can take the [`example.yaml`](../example.yaml) from this repository as a starting point, and
  12. modify that one to your needs. Detailed information about the YAML configuration options can be
  13. found in the [Configuration guide](configuration.md).
  14. After these steps you can let ESPHome compile your firmware (`firmware.bin`) file. This firmware
  15. can then be flashed onto the device.
  16. Like normal with ESPHome, the first time you will have to flash the device using a serial interface.
  17. After this initial flashing operation, you can flash new versions of the firmware using the OTA
  18. (Over The Air) method.
  19. See [the flashing guide](flashing.md) for hints on opening up the device and flashing its firmware
  20. using the serial interface.
  21. < [Why custom firmware?](why_custom_firmware.md) | [Index](../README.md) | [Configuration guide](configuration.md) >