https://github.com/oxdabit/oxflasher

Script for flash devices with HAA or Tasmota Firmware (Linux & mac osx)
https://github.com/oxdabit/oxflasher

esp-idf esp32 esp8266 homekit-support python3 script tasmota tasmota-driver

Last synced: 6 months ago
JSON representation

Script for flash devices with HAA or Tasmota Firmware (Linux & mac osx)

• Host: GitHub
• URL: https://github.com/oxdabit/oxflasher
• Owner: OxDAbit
• License: gpl-3.0
• Created: 2022-02-08T23:24:00.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-03-02T12:49:15.000Z (almost 4 years ago)
• Last Synced: 2025-03-10T19:28:11.815Z (11 months ago)
• Topics: esp-idf, esp32, esp8266, homekit-support, python3, script, tasmota, tasmota-driver
• Language: Python
• Homepage:
• Size: 245 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Release](https://img.shields.io/github/v/tag/OxDAbit/oxflasher?color=red&label=release)](https://github.com/OxDAbit/oxflasher/releases/latest)

[![Twitter](https://img.shields.io/twitter/follow/0xDA_bit.svg?style=social)](https://twitter.com/0xDA_bit)

# oxflasher

Manage ESP devices to backup, erase or flash with firmwares like Tasmota, HAA,... using `esptool.py`

# Application

## Installation

1. Download github repository or just a [**oxflasher.py**](https://github.com/OxDAbit/oxflasher/blob/main/src/oxflasher.py) script

	```

	git clone https://github.com/OxDAbit/oxflasher

	```

2. Python packages required for `oxflasher.py`:

	```

	pip install PyInquirer

	```

---

## Script execution

First of all you need to locate your backup path and binary location.

```

├── LICENSE

├── README.md

├── backup

│   └── sonoff_basic.bin

├── haa

│   └── fullhaaboot.bin

├── src

│   └── oxflasher.py

└── tasmota

	└── tasmota.bin

```

This is the structure that I've used where:

- backup -> Content backups from different devices

- tasmota -> Content tasmota binaries

- haa -> Content HAA binaries

---

## Run `oxflasher.py`

```

$ python3 oxflasher.py

```

At the beginning, the script will display the USB ports detected.

![first_menu](/images/01-first_menu.png)

Connect your device and press `Refresh Ports` option

![refresh_ports](/images/02-refresh_ports.png)

Your device should appears in list **Ports detected**

Press the option `Connect to Port` and then add the index of the USB port where your device is connected (Ex: Port nº 2 -> /dev/tty.usbserial-14310)

![connect_port](/images/03-connect_port.png)

At this point you can create a backup of your device, erase your device or flash it with the desired binary.

![create_backup](/images/04-create_backup.png)

### Create backup

Script will ask you for:

- Path where to save the backup file

- Name of your backup file

By default the backup path will be the path where script `oxflasher.py` are executed and the default name will be **backup.bin**

You can leave fields empty and the default parameters will be selected.

After that, the script will show you the backup information before ask you if you want continue.

![backup_menu](/images/05-backup_menu.png)

### Erase device

Script will show you the USB port selected for erase process before ask you if you want continue.

![erase_menu](/images/06-erase_menu.png)

### Flash device

Script will ask you for:

- Path where to load the binary file

- Name of binary file

By default the backup path will be the path where script `oxflasher.py` are executed and the default name will be **fullhaaboot.bin** (HAA binary)

You can leave fields empty and the default parameters will be selected.

After that, the script will show you the backup information before ask you if you want continue.

![flash_menu](/images/07-flash_menu.png)

Contact

=======

- Twitter. [**@0xDA_bit**](https://twitter.com/0xDA_bit)

- Github. [**OxDAbit**](https://github.com/OxDAbit)

- Mail. **oxdabit@protonmail.com**