mirror of
https://github.com/meshtastic/firmware.git
synced 2026-01-24 18:57:43 +00:00
73932dd1c3
* flash scripts: Unify indentation * flash scripts: Support esptool v4 and v5 esptool v5 supports commands with dashes and deprecates commands with underscores. Prior versions only support commands with underscores.
101 lines
2.6 KiB
Bash
Executable File
101 lines
2.6 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
|
|
PYTHON=${PYTHON:-$(which python3 python|head -n 1)}
|
|
CHANGE_MODE=false
|
|
|
|
# Constants
|
|
FLASH_BAUD=115200
|
|
RESET_BAUD=1200
|
|
UPDATE_OFFSET=0x10000
|
|
|
|
# Determine the correct esptool command to use
|
|
if "$PYTHON" -m esptool version >/dev/null 2>&1; then
|
|
ESPTOOL_CMD="$PYTHON -m esptool"
|
|
elif command -v esptool >/dev/null 2>&1; then
|
|
ESPTOOL_CMD="esptool"
|
|
elif command -v esptool.py >/dev/null 2>&1; then
|
|
ESPTOOL_CMD="esptool.py"
|
|
else
|
|
echo "Error: esptool not found"
|
|
exit 1
|
|
fi
|
|
|
|
# esptool v5 supports commands with dashes and deprecates commands with
|
|
# underscores. Prior versions only support commands with underscores
|
|
if ${ESPTOOL_CMD} | grep --quiet write-flash
|
|
then
|
|
ESPTOOL_WRITE_FLASH=write-flash
|
|
ESPTOOL_READ_FLASH_STATUS=read-flash-status
|
|
else
|
|
ESPTOOL_WRITE_FLASH=write_flash
|
|
ESPTOOL_READ_FLASH_STATUS=read_flash_status
|
|
fi
|
|
|
|
# Usage info
|
|
show_help() {
|
|
cat << EOF
|
|
Usage: $(basename "$0") [-h] [-p ESPTOOL_PORT] [-P PYTHON] [-f FILENAME|FILENAME] [--change-mode]
|
|
Flash image file to device, leave existing system intact."
|
|
|
|
-h Display this help and exit
|
|
-p ESPTOOL_PORT Set the environment variable for ESPTOOL_PORT. If not set, ESPTOOL iterates all ports (Dangerous).
|
|
-P PYTHON Specify alternate python interpreter to use to invoke esptool. (Default: "$PYTHON")
|
|
-f FILENAME The *.bin file to flash. Custom to your device type.
|
|
--change-mode Attempt to place the device in correct mode. Some hardware requires this twice. (1200bps Reset)
|
|
|
|
EOF
|
|
}
|
|
|
|
# Check for --change-mode and remove it from arguments
|
|
NEW_ARGS=()
|
|
for arg in "$@"; do
|
|
if [ "$arg" = "--change-mode" ]; then
|
|
CHANGE_MODE=true
|
|
else
|
|
NEW_ARGS+=("$arg")
|
|
fi
|
|
done
|
|
|
|
set -- "${NEW_ARGS[@]}"
|
|
|
|
while getopts ":hp:P:f:" opt; do
|
|
case "${opt}" in
|
|
h)
|
|
show_help
|
|
exit 0
|
|
;;
|
|
p) ESPTOOL_CMD="$ESPTOOL_CMD --port ${OPTARG}"
|
|
;;
|
|
P) PYTHON=${OPTARG}
|
|
;;
|
|
f) FILENAME=${OPTARG}
|
|
;;
|
|
*)
|
|
echo "Invalid flag."
|
|
show_help >&2
|
|
exit 1
|
|
;;
|
|
esac
|
|
done
|
|
shift "$((OPTIND-1))"
|
|
|
|
if [ "$CHANGE_MODE" = true ]; then
|
|
$ESPTOOL_CMD --baud $RESET_BAUD --after no_reset ${ESPTOOL_READ_FLASH_STATUS}
|
|
exit 0
|
|
fi
|
|
|
|
[ -z "$FILENAME" ] && [ -n "$1" ] && {
|
|
FILENAME="$1"
|
|
shift
|
|
}
|
|
|
|
if [[ -f "$FILENAME" && "$FILENAME" != *.factory.bin ]]; then
|
|
echo "Trying to flash update ${FILENAME}"
|
|
$ESPTOOL_CMD --baud $FLASH_BAUD ${ESPTOOL_WRITE_FLASH} $UPDATE_OFFSET "${FILENAME}"
|
|
else
|
|
show_help
|
|
echo "Invalid file: ${FILENAME}"
|
|
fi
|
|
|
|
exit 0
|