Skip to content

Commit

Permalink
esp32/boards: Update board and deploy metadata for UM_xxx boards.
Browse files Browse the repository at this point in the history
  • Loading branch information
UnexpectedMaker authored and dpgeorge committed Oct 28, 2021
1 parent 590ec2c commit 5b9c9cd
Show file tree
Hide file tree
Showing 12 changed files with 242 additions and 8 deletions.
9 changes: 7 additions & 2 deletions ports/esp32/boards/UM_FEATHERS2/board.json
Original file line number Diff line number Diff line change
@@ -1,14 +1,19 @@
{
"deploy": [
"../deploy_s2.md"
"deploy.md"
],
"docs": "",
"features": [
"WiFi",
"Feather",
"Battery Charging",
"STEMMA QT/QWIIC",
"USB-C"
"USB-C",
"RGB LED",
"SPIRAM"
],
"features_non_filterable": [
"Second LDO"
],
"id": "featherS2",
"images": [
Expand Down
2 changes: 2 additions & 0 deletions ports/esp32/boards/UM_FEATHERS2/board.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
The following files are daily firmware for the FeatherS2. This firmware is
compiled using ESP-IDF v4.3 or later.
50 changes: 50 additions & 0 deletions ports/esp32/boards/UM_FEATHERS2/deploy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).

To flash or erase your FeatherS2, you have to first put it into download mode.
To do this, follow these steps:

- Press and hold the [BOOT] button
- Press and release the [RESET] button
- Release the [BOOT] button

Now the board is in download mode and the native USB will have enumerated as a serial device.

If you are putting MicroPython on your board for the first time then you should
first erase the entire flash using:

### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 erase_flash
```

### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 erase_flash
```

### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) erase_flash
```

Now download the version of the firmware you would like to install from the options
below, then use the following command to program the firmware starting at address
0x1000, remembering to replace `feathers2-micropython-firmware-version.bin` with the
name of the firmware you just downloaded:

### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
```

### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
```

### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
```
12 changes: 9 additions & 3 deletions ports/esp32/boards/UM_FEATHERS2NEO/board.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"deploy": [
"../deploy_s2.md"
"deploy.md"
],
"docs": "",
"features": [
Expand All @@ -9,10 +9,16 @@
"Battery Charging",
"STEMMA QT/QWIIC",
"USB-C",
"Neopixels"
"RGB LED",
"SPIRAM"
],
"features_non_filterable": [
"5x5 RGB LED Matrix"
],
"id": "featherS2neo",
"images": [],
"images": [
"FeatherS2_Neo_White_Product2.jpg"
],
"mcu": "esp32s2",
"product": "Feather S2 Neo",
"thumbnail": "",
Expand Down
2 changes: 2 additions & 0 deletions ports/esp32/boards/UM_FEATHERS2NEO/board.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
The following files are daily firmware for the FeatherS2 Neo. This firmware is
compiled using ESP-IDF v4.3 or later.
50 changes: 50 additions & 0 deletions ports/esp32/boards/UM_FEATHERS2NEO/deploy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).

To flash or erase your FeatherS2 Neo, you have to first put it into download mode.
To do this, follow these steps:

- Press and hold the [BOOT] button
- Press and release the [RESET] button
- Release the [BOOT] button

Now the board is in download mode and the native USB will have enumerated as a serial device.

If you are putting MicroPython on your board for the first time then you should
first erase the entire flash using:

### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 erase_flash
```

### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 erase_flash
```

### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) erase_flash
```

Now download the version of the firmware you would like to install from the options below,
then use the following command to program the firmware starting at address 0x1000,
remembering to replace `feathers2neo-micropython-firmware-version.bin` with the name of
the firmware you just downloaded:

### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 feathers2neo-micropython-firmware-version.bin
```

### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 write_flash -z 0x1000 feathers2neo-micropython-firmware-version.bin
```

### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) write_flash -z 0x1000 feathers2-feathers2neo-firmware-version.bin
```
14 changes: 12 additions & 2 deletions ports/esp32/boards/UM_TINYPICO/board.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,19 @@
{
"deploy": [
"../deploy.md"
"deploy.md"
],
"docs": "",
"features": [],
"features": [
"BLE",
"WiFi",
"Battery Charging",
"USB-C",
"RGB LED",
"SPIRAM"
],
"features_non_filterable": [
"TinyPICO Compatible"
],
"id": "tinypico",
"images": [
"tinypico-v2-both.jpg"
Expand Down
3 changes: 3 additions & 0 deletions ports/esp32/boards/UM_TINYPICO/board.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
The following files are daily firmware for the TinyPICO. This firmware is compiled
using ESP-IDF v4.2 or later. Some older releases are also provided that are
compiled with ESP-IDF v3.x.
46 changes: 46 additions & 0 deletions ports/esp32/boards/UM_TINYPICO/deploy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).

Your TinyPICO has an auto-reset circuit on it, so there is no need to put it into a
download mode first to erase or flash it.

If you are putting MicroPython on your board for the first time then you should
first erase the entire flash using:

### Linux
```bash
esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash
```

### Mac
```bash
esptool.py --chip esp32 --port /dev/tty.SLAB_USBtoUART erase_flash
```

### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32 --port COM(X) erase_flash
```

Now download the version of the firmware you would like to install from the options below,
then use the following command to program the firmware starting at address 0x1000,
remembering to replace `tinypico-micropython-firmware-version.bin` with the name of the
firmware you just downloaded:

From then on program the firmware starting at address 0x1000:

### Linux
```bash
esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 912600 write_flash -z 0x1000 tinypico-micropython-firmware-version.bin
```

### Mac
```bash
esptool.py --chip esp32 --port /dev/tty.SLAB_USBtoUART --baud 912600 write_flash -z 0x1000 tinypico-micropython-firmware-version.bin
```

### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32 --port COM(X) --baud 912600 write_flash -z 0x1000 tinypico-micropython-firmware-version.bin
```
10 changes: 9 additions & 1 deletion ports/esp32/boards/UM_TINYS2/board.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,19 @@
{
"deploy": [
"../deploy_s2.md"
"deploy.md"
],
"docs": "",
"features": [
"WiFi",
"USB-C"
"Battery Charging",
"STEMMA QT/QWIIC",
"USB-C",
"RGB LED",
"SPIRAM"
],
"features_non_filterable": [
"TinyPICO Compatible"
],
"id": "tinys2",
"images": [
Expand Down
2 changes: 2 additions & 0 deletions ports/esp32/boards/UM_TINYS2/board.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
The following files are daily firmware for the TinyS2. This firmware is compiled
using ESP-IDF v4.3 or later.
50 changes: 50 additions & 0 deletions ports/esp32/boards/UM_TINYS2/deploy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).

To flash or erase your TinyS2, you have to first put it into download mode.
To do this, follow these steps:

- Press and hold the [BOOT] button
- Press and release the [RESET] button
- Release the [BOOT] button

Now the board is in download mode and the native USB will have enumerated as a serial device.

If you are putting MicroPython on your board for the first time then you should
first erase the entire flash using:

### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 erase_flash
```

### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 erase_flash
```

#### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) erase_flash
```

Now download the version of the firmware you would like to install from the options below,
then use the following command to program the firmware starting at address 0x1000,
remembering to replace `tinys2-micropython-firmware-version.bin` with the name of the
firmware you just downloaded:

#### Linux
```bash
esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 tinys2-micropython-firmware-version.bin
```

#### Mac
```bash
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 write_flash -z 0x1000 tinys2-micropython-firmware-version.bin
```

#### Windows
Change (X) to whatever COM port is being used by the board
```bash
esptool --chip esp32s2 --port COM(X) write_flash -z 0x1000 tinys2-micropython-firmware-version.bin
```

0 comments on commit 5b9c9cd

Please sign in to comment.