From f634f1f204945c13905657ae901e9f88397a8e05 Mon Sep 17 00:00:00 2001 From: jaal2001 Date: Sun, 22 Jun 2025 13:25:39 +0200 Subject: [PATCH] [DOCS] Update binaries.md for the use with Mac (#2203) The baud rate seems to a common problem, so this may be a nice hint to Apple users. --- docs/upload/binaries.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/upload/binaries.md b/docs/upload/binaries.md index 55de05c..182f43b 100644 --- a/docs/upload/binaries.md +++ b/docs/upload/binaries.md @@ -67,6 +67,19 @@ If you want to upload the ready-to-go binary from Linux (or any other OS where y Hard resetting via RTS pin... * The board resets after the upload and boots the gateway firmware +### Mac - esptool.py +The approach for Mac is similiar to Linux. You need to install [Brew](https://brew.sh) for Mac to use [pip](https://docs.brew.sh/Homebrew-and-Python). +The esptool.py tool needs to be adressed explicitly with .py at the end. +If you do fail with the command, run `esptool.py chip_id` to let your Mac check for the ESP32 on your serial ports. A common failure for this looks like this: + + A fatal error occurred: Unable to verify flash chip connection (Invalid head of packet (0xE0): Possible serial noise or corruption.). + +If you receive this error + + A fatal error occurred: Unable to verify flash chip connection (Packet content transfer stopped (received 7 bytes)). + +while flashing, try to reduce the baud rate to `--baud 115200`, as this seems to help in most cases. + ## ESP8266 * Download the NodeMCU Py Flasher tool : https://github.com/marcelstoer/nodemcu-pyflasher/releases