move to binary esptool. Run get.py/get.exe to get it!

With this step we remove all dependencies, but git. Mac and Linux come
with Python by default, so they will keep using get.py to update the
toolchain and support binaries. Windows users have an "All point and
click" installation option that requires only git and Arduino to be
downloaded.
Fingers crossed :)
This commit is contained in:
me-no-dev 2017-01-19 15:58:29 +02:00
parent 93d2bc7f1e
commit 4fbee226b6
16 changed files with 84 additions and 37 deletions

2
.gitignore vendored
View File

@ -1,3 +1,5 @@
tools/xtensa-esp32-elf tools/xtensa-esp32-elf
tools/dist tools/dist
tools/esptool
tools/esptool.exe

View File

@ -30,9 +30,6 @@ Most of the framework is implemented. Most noticable is the missing analogWrite.
- Open Terminal and execute the following command (copy->paste and hit enter): - Open Terminal and execute the following command (copy->paste and hit enter):
```bash ```bash
curl -o get-pip.py https://bootstrap.pypa.io/get-pip.py && \
sudo python get-pip.py && \
sudo pip install pyserial && \
mkdir -p ~/Documents/Arduino/hardware/espressif && \ mkdir -p ~/Documents/Arduino/hardware/espressif && \
cd ~/Documents/Arduino/hardware/espressif && \ cd ~/Documents/Arduino/hardware/espressif && \
git clone https://github.com/espressif/arduino-esp32.git esp32 && \ git clone https://github.com/espressif/arduino-esp32.git esp32 && \
@ -48,9 +45,6 @@ Most of the framework is implemented. Most noticable is the missing analogWrite.
```bash ```bash
sudo usermod -a -G dialout $USER && \ sudo usermod -a -G dialout $USER && \
sudo apt-get install git && \ sudo apt-get install git && \
wget https://bootstrap.pypa.io/get-pip.py && \
sudo python get-pip.py && \
sudo pip install pyserial && \
mkdir -p ~/Arduino/hardware/espressif && \ mkdir -p ~/Arduino/hardware/espressif && \
cd ~/Arduino/hardware/espressif && \ cd ~/Arduino/hardware/espressif && \
git clone https://github.com/espressif/arduino-esp32.git esp32 && \ git clone https://github.com/espressif/arduino-esp32.git esp32 && \

Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 101 KiB

BIN
doc/win-gui-1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
doc/win-gui-2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

BIN
doc/win-gui-3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
doc/win-gui-4.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

BIN
doc/win-gui-5.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

BIN
doc/win-gui-update-1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
doc/win-gui-update-2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

View File

@ -2,34 +2,46 @@
### Tested on 32 and 64 bit Windows 10 machines ### Tested on 32 and 64 bit Windows 10 machines
1. Download and install the latest Arduino IDE ```Windows Installer``` from [arduino.cc](https://www.arduino.cc/en/Main/Software) 1. Download and install the latest Arduino IDE ```Windows Installer``` from [arduino.cc](https://www.arduino.cc/en/Main/Software)
2. Download ```Windows x86 MSI installer``` or ```Windows x86-64 MSI installer``` from [python.org](https://www.python.org/downloads/release/python-2712/). When installing: 2. Download and install Git from [git-scm.com](https://git-scm.com/download/win)
- Install for all users 3. Start ```Git GUI``` and run through the following steps:
- In ```Customize Python 2.7.X``` page, make sure you enable the last option: ```Add python.exe to Path``` - Select ```Clone Existing Repository```
![Python](python-install.png)
3. Download and install Git from [git-scm.com](https://git-scm.com/download/win)
4. Start ```Git Bash``` as Administrator and execute the following command
```bash ![Step 1](win-gui-1.png)
python -m pip install --upgrade pip && \
pip install pyserial && \
pip install requests
```
![Git Bash As Admin](gitbash-admin-start.png)
![Git Bash Admin CMD](gitbash-admin.png)
5. Start ```Git Bash``` normally and execute the following command
```bash - Select source and destination
mkdir -p ~/Documents/Arduino/hardware/espressif && \ - Source Location: ```https://github.com/espressif/arduino-esp32.git```
cd ~/Documents/Arduino/hardware/espressif && \ - Target Directory: ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32```
git clone https://github.com/espressif/arduino-esp32.git esp32 && \ - Click ```Clone``` to start cloning the repository
cd esp32/tools/ && \
python get.py ![Step 2](win-gui-2.png)
``` ![Step 3](win-gui-3.png)
![Git Bash User CMD](gitbash-user.png)
6. Plug your ESP32 board and wait for the drivers to install (or install manually any that might be required) - Open ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32/tools``` and double-click ```get.exe```
7. Start Arduino IDE
8. Select your board in ```Tools > Board``` menu ![Step 4](win-gui-4.png)
9. Select the COM port that the board is attached to - When ```get.exe``` finishes, you should the following files you the directory
10. Compile and upload (You might need to hold the boot button while uploading)
![Step 5](win-gui-5.png)
4. Plug your ESP32 board and wait for the drivers to install (or install manually any that might be required)
5. Start Arduino IDE
6. Select your board in ```Tools > Board``` menu
7. Select the COM port that the board is attached to
8. Compile and upload (You might need to hold the boot button while uploading)
![Arduino IDE Example](arduino-ide.png) ![Arduino IDE Example](arduino-ide.png)
### How to update to the latest code
1. Start ```Git GUI``` and you should see the repository under ```Open Recent Repository```. Click on it!
![Update Step 1](win-gui-update-1png)
2. From menu ```Remote``` select ```Fetch from``` > ```origin```
![Update Step 2](win-gui-update-2png)
3. Wait for git to pull any changes and close ```Git GUI```
4. Open ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32/tools``` and double-click ```get.exe```
![Step 4](win-gui-4.png)

View File

@ -34,6 +34,11 @@
"packager": "esp32", "packager": "esp32",
"name": "xtensa-esp32-elf-gcc", "name": "xtensa-esp32-elf-gcc",
"version": "1.22.0-61-gab8375a-5.2.0" "version": "1.22.0-61-gab8375a-5.2.0"
},
{
"packager": "esp32",
"name": "esptool",
"version": "fe69994"
} }
] ]
} }
@ -72,6 +77,40 @@
"size": "32734156" "size": "32734156"
} }
] ]
},
{
"name": "esptool",
"version": "fe69994",
"systems": [
{
"host": "i686-mingw32",
"url": "https://dl.espressif.com/dl/esptool-fe69994-windows.zip",
"archiveFileName": "esptool-fe69994-windows.zip",
"checksum": "SHA-256:b2702efc045f5f61f821c72495301a0f2016e87e33f49fa16e262d0522d2b021",
"size": "3389457"
},
{
"host": "x86_64-apple-darwin",
"url": "https://dl.espressif.com/dl/esptool-fe69994-macos.tar.gz",
"archiveFileName": "esptool-fe69994-macos.tar.gz",
"checksum": "SHA-256:49ab32fbdf4f855925638d4b76ffd292255a47c4445b1069737f7151f66a03aa",
"size": "3886730"
},
{
"host": "x86_64-pc-linux-gnu",
"url": "https://dl.espressif.com/dl/esptool-fe69994-linux64.tar.gz",
"archiveFileName": "esptool-fe69994-linux64.tar.gz",
"checksum": "SHA-256:6ff54604bb3e1af39a7dd4f0e54b02b0f48bcd8a0b9259bc202385fdea573e05",
"size": "3937680"
},
{
"host": "i686-pc-linux-gnu",
"url": "https://dl.espressif.com/dl/esptool-fe69994-linux32.tar.gz",
"archiveFileName": "esptool-fe69994-linux32.tar.gz",
"checksum": "SHA-256:4912aa39b3b78fbe4f959c496e52968b207e66e92cf186ad583812526a455f48",
"size": "3766885"
}
]
} }
] ]
} }

View File

@ -3,8 +3,8 @@ version=0.0.1
runtime.tools.xtensa-esp32-elf-gcc.path={runtime.platform.path}/tools/xtensa-esp32-elf runtime.tools.xtensa-esp32-elf-gcc.path={runtime.platform.path}/tools/xtensa-esp32-elf
tools.esptool.cmd=python "{runtime.platform.path}/tools/esptool.py" tools.esptool.cmd="{runtime.platform.path}/tools/esptool"
tools.esptool.cmd.windows=python.exe "{runtime.platform.path}/tools/esptool.py" tools.esptool.cmd.windows="{runtime.platform.path}/tools/esptool.exe"
compiler.warning_flags=-w compiler.warning_flags=-w
compiler.warning_flags.none=-w compiler.warning_flags.none=-w