esp-idf Tools and Installer/Reinstaller

installs/reinstalls full esp-idf with my own additions on linux.
pulls from master so its the very latest

built for debian-like systems only currently tested on zsh some features require user to have passwordless sudo rights

Literally the most schizophrenically overengineered thing I have ever made. idk why I did that

Quick start

cd ~ git clone https://github.com/PrincessPi3/esp-idf-tools.git ~/esp-idf-tools
bash ~/esp-idf-tools/esp-idf-tools-cmd.sh source ~/.zshrc get_idf

Features

build idf.py build
changebaud prompts to enter a new baud
changeesp prompts to type in esp32s3, esp32c6, etc
changeport opens a menu to select a serial port
clean idf.py clean
fullclean fully resets a project, 'idf.py fullclean' plus remove the build dir and delete some temp and backup files
rebuildfull does a fullclean but also an erase-flash and also setup
setup same as running idf.py set-target $ESPTARGET; idf.py menuconfig; idf.py build
flash idf.py flash
monitor idf.py monitor
erase-flash idf.py erase-flash
save-defconfig idf.py save-defconfig
step-flash-monitor attempt clean, build, flash, then monitor, dying on error
imagesize get binary size, broken down in various ways including total, by componant, and by file chipinfo get information from the esp chip espinfo get detailed information about the esp chip menuconfig run idf.py menuconfig

Usage

Modes:
	each of these arguments can be used identically on the alias run_esp_reinstall
	
	default: 
		reinstalls non-interactively with no delays, logouts, or reboots. run without any argument
			bash esp-idf-tools-cmd.sh

	test:
		tests the script. very fast. minimal actions taken. no reinstall is done
			bash esp-idf-tools-cmd.sh test
			bash esp-idf-tools-cmd.sh t

	retool:
	    reinstalls bins and export.sh, nothing else
		    bash esp-idf-tools-cmd.sh retool
			bash esp-idf-tools-cmd.sh rt

	cron:
		runs noninteractively with forced user logout and automatic reboot, plus delays
		    bash esp-idf-tools-cmd.sh cron
			bash esp-idf-tools-cmd.sh c

	interactive:
		interactively installs/reinstalls esp-idf
		    bash esp-idf-tools-cmd.sh interactive
			bash esp-idf-tools-cmd.sh i

	nuke:
		full delete and re-download and install
			bash esp-idf-tools-cmd.sh nuke
			bash esp-idf-tools-cmd.sh n
    
	clearlogs:
		clear logs
			bash esp-idf-tools-cmd.sh clearlogs
			bash esp-idf-tools-cmd.sh clear
			bash esp-idf-tools-cmd.sh clean
			bash esp-idf-tools-cmd.sh cl
			
    help:
        display this help text
            bash esp-idf-tools-cmd.sh help
			bash esp-idf-tools-cmd.sh h
			bash esp-idf-tools-cmd.sh -h
			bash esp-idf-tools-cmd.sh --help

	uninstall:
		uninstall esp-idf
			bash esp-idf-tools-cmd.sh uninstall

Ailases

run_esp_reinstall
	Updates the esp-install-custom code via git, displays the script version, then executes esp-idf-tools-cmd.sh with optional arument.
	Takes identical arguments to running esp-idf-tools-cmd.sh manually
		run_esp_reinstall
		run_esp_reinstall clean
		run_esp_reinstall nuke
		run_esp_reinstall retool
		run_esp_reinstall cron
		run_esp_reinstall interactive
		run_esp_reinstall test
		run_esp_reinstall help
		run_esp_reinstall uninstall
	Second optional argument specifies branch:
		`run_esp_reinstall nuke v5.4.1`

esp_install_monitor
	monitors install.log
	alias for tail -n 75 -f $ESPIDF_INSTALLDIR/install.log
	no arguments

esp__install_logs
	displays full text of install.log and version-data.txt
	no arguments

Helpful stuff

cron:
    reinstall from master everyday at 4am, logging out users with warn delays and rebooting after
	    `crontab -e`

	    0 4 * * * bash $HOME/esp/esp-install-custom/esp-idf-tools-cmd.sh cron

3.7 KiB Raw Blame History