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) ![Step 1](win-gui-1.png)
4. Start ```Git Bash``` as Administrator and execute the following command
- Select source and destination
```bash - Source Location: ```https://github.com/espressif/arduino-esp32.git```
python -m pip install --upgrade pip && \ - Target Directory: ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32```
pip install pyserial && \ - Click ```Clone``` to start cloning the repository
pip install requests
``` ![Step 2](win-gui-2.png)
![Git Bash As Admin](gitbash-admin-start.png) ![Step 3](win-gui-3.png)
![Git Bash Admin CMD](gitbash-admin.png)
5. Start ```Git Bash``` normally and execute the following command - Open ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32/tools``` and double-click ```get.exe```
```bash ![Step 4](win-gui-4.png)
mkdir -p ~/Documents/Arduino/hardware/espressif && \ - When ```get.exe``` finishes, you should the following files you the directory
cd ~/Documents/Arduino/hardware/espressif && \
git clone https://github.com/espressif/arduino-esp32.git esp32 && \ ![Step 5](win-gui-5.png)
cd esp32/tools/ && \
python get.py 4. Plug your ESP32 board and wait for the drivers to install (or install manually any that might be required)
``` 5. Start Arduino IDE
![Git Bash User CMD](gitbash-user.png) 6. Select your board in ```Tools > Board``` menu
6. Plug your ESP32 board and wait for the drivers to install (or install manually any that might be required) 7. Select the COM port that the board is attached to
7. Start Arduino IDE 8. Compile and upload (You might need to hold the boot button while uploading)
8. Select your board in ```Tools > Board``` menu
9. Select the COM port that the board is attached to
10. 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