Skip to content

Update Windows firmware installation guide #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update Windows firmware installation guide #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 22 additions & 8 deletions docs/02_ENTROPY_ZERO/07_firmware_guides/02_windows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,3 @@
---
sidebar_position: 3
---

# Windows

Instructions to onboard your DIY miner using Windows
Expand All @@ -22,6 +18,10 @@ Instructions to onboard your DIY miner using Windows
```
pip install esptool
```
* Verify if `esptool` is installed correctly by typing `esptool.py -h` in the command prompt.
* If `esptool` is not present or the installation fails, download the Windows package from [here](https://github.com/espressif/esptool/releases).
* After downloading, extract the ZIP file to any directory of your choice.
* Inside the extracted folder, you will find the `esptool.exe` binary. Use the path to this binary (e.g., `/PATH/TO/ESPTOOL/PACKAGE/esptool.exe`) in the subsequent steps.

* Connect your ESP32 or ESP32-S3
* You may have multiple connection ports on the device; the correct one is likely labeled `USB`
Expand All @@ -42,16 +42,28 @@ Instructions to onboard your DIY miner using Windows

* Change your working directory to the location of the firmware binary `YOUR_FIRMWARE.bin`

* Clear the board of any previous software if necessary
* Clear the board of any previous software if necessary:
* If you have installed the `esptool` Python package:
```
esptool.py --chip esp32* --port COM* erase_flash
```
* You may need to drop `.py` and just use `esptool`
* `esp32*` is `esp32` or `esp32s3`, depending on your board
* Flash the firmware
* If you are using the `esptool.exe` from the downloaded ZIP package:
```
/PATH/TO/ESPTOOL/PACKAGE/esptool.exe --chip esp32* --port COM* erase_flash
```

* `esp32*` is `esp32` or `esp32s3`, depending on your board.

* Flash the firmware:
* If you have installed the `esptool` Python package:
```
esptool.py --chip esp32* --port COM* --baud 115200 write_flash --flash_mode dio 0x0 YOUR_FIRMWARE.bin
```
* If you are using the `esptool.exe` from the downloaded ZIP package:
```
/PATH/TO/ESPTOOL/PACKAGE/esptool.exe --chip esp32* --port COM* --baud 115200 write_flash --flash_mode dio 0x0 YOUR_FIRMWARE.bin
```

* To monitor the device, install and run [PuTTY](https://www.putty.org/)
* Under <kbd>Session</kbd> select the <kbd>Serial</kbd> radio button
* Enter your device port `COM*` under <kbd>Serial line</kbd>
Expand All @@ -60,6 +72,8 @@ Instructions to onboard your DIY miner using Windows

### Step 3: Connect to WiFi [ESP32 boards only support the 2.4GHz band]

**IMPORTANT:** Ensure that your WiFi access point is configured to use only the 2.4GHz band. If both 2.4GHz and 5GHz bands are enabled, disable the 5GHz band to avoid connection issues.

* Download an ESP WiFi config app from your app store
* The following have been tested
* [Android](https://play.google.com/store/apps/details?id=com.techbot.smart_config)
Expand Down