[docs] Move tools docs to a subdirectory
This commit is contained in:
Kuba Szczodrzyński
@@ -2,9 +2,9 @@
|
||||
|
||||
* [Flashing PlatformIO projects](platformio.md)
|
||||
* [Flashing ESPHome](esphome.md)
|
||||
* [Using ltchiptool GUI](ltchiptool.md)
|
||||
* [Converting with tuya-cloudcutter](cloudcutter.md)
|
||||
* Chip connection guide
|
||||
* [Using ltchiptool GUI](tools/ltchiptool.md)
|
||||
* [Converting with tuya-cloudcutter](tools/cloudcutter.md)
|
||||
* 🔌 Chip connection guide
|
||||
* [Beken BK72xx](../platform/beken-72xx/flashing.md)
|
||||
* [Realtek RTL8710Bx](../platform/realtek-ambz/flashing.md)
|
||||
* [Auto-download-reboot](adr.md)
|
||||
* [Auto-download-reboot](tools/adr.md)
|
||||
|
||||
@@ -2,6 +2,11 @@
|
||||
|
||||
ESPHome can be flashed in few different ways, depending on your needs.
|
||||
|
||||
!!! abstract
|
||||
All binary files generated by ESPHome will be in `.esphome/build/<yourdevice>/.pioenvs/<yourdevice>/`. The methods described below may require you to get a file from that directory.
|
||||
|
||||
This path will be referred to as **build directory**.
|
||||
|
||||
## Built-in flasher
|
||||
|
||||
The flasher program built-in LibreTuya is also available for ESPHome.
|
||||
@@ -15,13 +20,6 @@ The flasher program built-in LibreTuya is also available for ESPHome.
|
||||
|
||||
If your device is already running ESPHome, refer to the OTA guide below.
|
||||
|
||||
## Other methods
|
||||
|
||||
!!! abstract
|
||||
All binary files generated by ESPHome will be in `.esphome/build/<yourdevice>/.pioenvs/<yourdevice>/`. The methods described below may require you to get a file from that directory.
|
||||
|
||||
This path will be referred to as **build directory**.
|
||||
|
||||
## Over-the-Air (OTA)
|
||||
|
||||
This method requires having ESPHome already installed on your device.
|
||||
|
||||
@@ -5,4 +5,4 @@
|
||||
|
||||
Grab the `bk7231x_app.ota.ug.bin` file from the build directory - take care to choose the correct file. It must have "OTA" and "UG" in its name.
|
||||
|
||||
Next, refer to [Using tuya-cloudcutter](../cloudcutter.md) guide.
|
||||
Next, refer to [Using tuya-cloudcutter](../tools/cloudcutter.md) guide.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
## Using ltchiptool (wired, via UART)
|
||||
|
||||
You can use the [ltchiptool](https://github.com/libretuya/ltchiptool) GUI or CLI to manually flash the firmware. Grab the `firmware.uf2` file from the build directory. Then, follow the [ltchiptool usage guide](../ltchiptool.md) to flash it to the device.
|
||||
You can use the [ltchiptool](https://github.com/libretuya/ltchiptool) GUI or CLI to manually flash the firmware. Grab the `firmware.uf2` file from the build directory. Then, follow the [ltchiptool usage guide](../tools/ltchiptool.md) to flash it to the device.
|
||||
|
||||
!!! tip
|
||||
The UF2 file may have a different name, depending on the project you're building. Usually it's best to grab the latest (sorted by date) file with UF2 extension from the build directory.
|
||||
|
||||
@@ -2,9 +2,14 @@
|
||||
|
||||
PlatformIO projects developed with LibreTuya can be flashed just like any other PIO project.
|
||||
|
||||
!!! abstract
|
||||
All binary files generated by PlatformIO will be in `.pio/build/<my_board>/`. The methods described below may require you to get a file from that directory.
|
||||
|
||||
This path will be referred to as **build directory**.
|
||||
|
||||
## Built-in flasher
|
||||
|
||||
LibreTuya has a built-in firmware uploader, based on [ltchiptool](ltchiptool.md). Pressing `Upload` in PlatformIO IDE does all the work for you.
|
||||
LibreTuya has a built-in firmware uploader, based on [ltchiptool](tool/ltchiptool.md). Pressing `Upload` in PlatformIO IDE does all the work for you.
|
||||
|
||||
If you have more than one COM port, configure your PIO project first:
|
||||
|
||||
@@ -18,13 +23,6 @@ upload_port = COM96
|
||||
include-markdown "inc/uart-info.md"
|
||||
%}
|
||||
|
||||
## Other methods
|
||||
|
||||
!!! abstract
|
||||
All binary files generated by PlatformIO will be in `.pio/build/<my_board>/`. The methods described below may require you to get a file from that directory.
|
||||
|
||||
This path will be referred to as **build directory**.
|
||||
|
||||
{%
|
||||
include-markdown "inc/uart-ltchiptool.md"
|
||||
%}
|
||||
|
||||
@@ -22,7 +22,7 @@ If your device doesn't have a profile yet, it will probably not work. You can co
|
||||
|
||||
### Firmware building
|
||||
|
||||
1. [Compile ESPHome](../projects/esphome.md), or your custom firmware based on LibreTuya.
|
||||
1. [Compile ESPHome](../../projects/esphome.md), or your custom firmware based on LibreTuya.
|
||||
2. Get the firmware binary, named `bk7231x_app.ota.ug.bin` from the build directory (`.pio/build/<board>/` or `.esphome/build/<board>/.pioenvs/<board>/`).
|
||||
3. Put it in the `custom-firmware` directory of tuya-cloudcutter.
|
||||
|
||||
Reference in New Issue
Block a user