From 0fe2e7d136ad59a363a24a48ac01a4d8c2d503f3 Mon Sep 17 00:00:00 2001
From: Anthony Briggs <anthony.briggs@gmail.com>
Date: Mon, 7 Aug 2017 14:07:22 +1000
Subject: [PATCH 1/3] Updated ESP32 README.md installation instructions

Some gotchas that I discovered while installing and flashing.
---
 esp32/README.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/esp32/README.md b/esp32/README.md
index 9ee4bf6cb..34c47a461 100644
--- a/esp32/README.md
+++ b/esp32/README.md
@@ -91,6 +91,11 @@ $ git submodule init lib/berkeley-db-1.xx
 $ git submodule update
 ```
 
+You will also need to have PySerial installed if it isn't already.
+```bash
+$ pip install pyserial
+```
+
 Then to build MicroPython for the ESP32 run:
 ```bash
 $ cd esp32
@@ -105,6 +110,13 @@ for your particular ESP32 module for how to do this.  The serial port and
 flash settings are set in the `Makefile`, and can be overridden in your
 local `makefile`; see above for more details.
 
+You will also need to have user permissions to access the /dev/ttyUSB0 device.
+On Linux, you can enable this by adding your user to the `dialout` group,
+and rebooting or logging out and in again.
+```bash
+$ sudo adduser <username> dialout
+```
+
 If you are installing MicroPython to your module for the first time, or
 after installing any other firmware, you should first erase the flash
 completely:
@@ -126,7 +138,7 @@ You can get a prompt via the serial port, via UART0, which is the same UART
 that is used for programming the firmware.  The baudrate for the REPL is
 115200 and you can use a command such as:
 ```bash
-$ picocom /dev/ttyUSB0
+$ picocom -b 115200 /dev/ttyUSB0
 ```
 
 Configuring the WiFi and using the board

From a026ff6604b27d8c856013f8feafc32b2204c7b4 Mon Sep 17 00:00:00 2001
From: Anthony Briggs <anthony.briggs@gmail.com>
Date: Wed, 9 Aug 2017 12:28:53 +1000
Subject: [PATCH 2/3] Updated README.md

Changed pyserial to install esptool, moved it into the ESPIDF section.
---
 esp32/README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/esp32/README.md b/esp32/README.md
index 34c47a461..affdc75c6 100644
--- a/esp32/README.md
+++ b/esp32/README.md
@@ -73,6 +73,12 @@ are `PORT` for the serial port of your esp32 module, and `FLASH_MODE`
 (which may need to be `dio` for some modules)
 and `FLASH_SIZE`.  See the Makefile for further information.
 
+You will also need to have esptool installed so that the Makefile can flash
+the micropython board and set parameters.
+```bash
+$ pip install pyserial
+```
+
 Building the firmware
 ---------------------
 
@@ -91,11 +97,6 @@ $ git submodule init lib/berkeley-db-1.xx
 $ git submodule update
 ```
 
-You will also need to have PySerial installed if it isn't already.
-```bash
-$ pip install pyserial
-```
-
 Then to build MicroPython for the ESP32 run:
 ```bash
 $ cd esp32

From 18d5cdfc8f0966b1b81ca372435b1e63b9caebee Mon Sep 17 00:00:00 2001
From: Anthony Briggs <anthony.briggs@gmail.com>
Date: Fri, 11 Aug 2017 16:04:56 +1000
Subject: [PATCH 3/3] Updated esp32/README.md

Clarified the issues with Espressif's pyserial/esptool install instructions.
---
 esp32/README.md | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/esp32/README.md b/esp32/README.md
index affdc75c6..a37d66a35 100644
--- a/esp32/README.md
+++ b/esp32/README.md
@@ -44,6 +44,14 @@ $ git checkout <Current supported ESP-IDF commit hash>
 Note that you will get a warning when building the code if the ESP-IDF
 version is incorrect.
 
+The Espressif ESP-IDF instructions above only install pyserial for Python 2,
+so if you're running Python 3 or a non-system Python, you'll also need to 
+install `pyserial` or `esptool` so that the Makefile can flash the 
+micropython board and set parameters.
+```bash
+$ pip install pyserial
+```
+
 Once everything is set up you should have a functioning toolchain with
 prefix xtensa-esp32-elf- (or otherwise if you configured it differently)
 as well as a copy of the ESP-IDF repository.
@@ -73,12 +81,6 @@ are `PORT` for the serial port of your esp32 module, and `FLASH_MODE`
 (which may need to be `dio` for some modules)
 and `FLASH_SIZE`.  See the Makefile for further information.
 
-You will also need to have esptool installed so that the Makefile can flash
-the micropython board and set parameters.
-```bash
-$ pip install pyserial
-```
-
 Building the firmware
 ---------------------
 

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>pFad - Phonifier reborn</title>
<meta http-equiv='Content-Type' content='text/html; charset=utf-8' />
</head>
<body>
<h1>Pfad - The Proxy pFad of &#169; 2024 Garber Painting. All rights reserved.</h1>


<!-- Disclaimer -->
<p>Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.</p>
<br>
<p>Alternative Proxies:</p><p><a href="http://rainy.clevelandohioweatherforecast.com/php-proxy/index.php?q=https://patch-diff.githubusercontent.com/raw/micropython/micropython-esp32/pull/155.patch" target="_blank">Alternative Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/index.php?u=https://patch-diff.githubusercontent.com/raw/micropython/micropython-esp32/pull/155.patch" target="_blank">pFad Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v3index.php?u=https://patch-diff.githubusercontent.com/raw/micropython/micropython-esp32/pull/155.patch" target="_blank">pFad v3 Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v4index.php?u=https://patch-diff.githubusercontent.com/raw/micropython/micropython-esp32/pull/155.patch" target="_blank">pFad v4 Proxy</a></p></body>
</html>