Skip to content

Latest commit

 

History

History
67 lines (42 loc) · 2.41 KB

README.md

File metadata and controls

67 lines (42 loc) · 2.41 KB

idfx ⚡

While there is no support for USB devices on WSL2 for now, this tool comes to help you to flash and monitor ESP-IDF and ESP8266_SDK applications on the WSL2.

Info:
Tested on Ubuntu 20.04 LTS and Debian distributions.

Note:
As a prerequisite for using this tool, Python 🐍 needs to be installed on the Windows.

Supported ESP-IDF versions

idfx supports:

Installation

Execute next command inside of your WSL to install idfx

curl https://git.io/JyBgj --create-dirs -L -o $HOME/bin/idfx && chmod u+x $HOME/bin/idfx

Usage

Signature:

idfx COMMAND [PORT]

Where the PORT is serial COM Port on the Windows (use the Device Manager to find your port).

For the full usage please execute next command:

idfx help

Examples

For most of the cases (when you edit the code of your application) you can use idfx all COM2 because this command will build, flash and monitor your app, at once. Of course, you need to change COM2 (in previous command) with correct COM port.

Command Description
idfx all COM2 Build project, flash and monitor serial output, using port COM2
idfx build Build project
idfx flash COM2 Flashing project using port COM2
idfx monitor COM2 Display serial output of port COM2
idfx flash COM2 monitor Flash project and display serial output, using port COM2
idfx erase-flash COM2 Erase the entire flash, using port COM2
idfx help Show the idfx usage

How to install ESP-IDF on WSL2

On this link you can find complete tutorial about how to setup ESP-IDF under WSL2 and how to use idfx to build, flash and monitor your ESP application.

Preview

idfx preview

Author

abobija - abobija.com

License

MIT