Skip to content

Commit 5b9c9cd

Browse files
UnexpectedMakerdpgeorge
UnexpectedMaker
authored and
dpgeorge
committed
esp32/boards: Update board and deploy metadata for UM_xxx boards.
1 parent 590ec2c commit 5b9c9cd

File tree

12 files changed

+242
-8
lines changed

12 files changed

+242
-8
lines changed

‎ports/esp32/boards/UM_FEATHERS2/board.json‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,19 @@
11
{
22
"deploy": [
3-
"../deploy_s2.md"
3+
"deploy.md"
44
],
55
"docs": "",
66
"features": [
77
"WiFi",
88
"Feather",
99
"Battery Charging",
1010
"STEMMA QT/QWIIC",
11-
"USB-C"
11+
"USB-C",
12+
"RGB LED",
13+
"SPIRAM"
14+
],
15+
"features_non_filterable": [
16+
"Second LDO"
1217
],
1318
"id": "featherS2",
1419
"images": [

‎ports/esp32/boards/UM_FEATHERS2/board.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
The following files are daily firmware for the FeatherS2. This firmware is
2+
compiled using ESP-IDF v4.3 or later.

‎ports/esp32/boards/UM_FEATHERS2/deploy.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).
2+
3+
To flash or erase your FeatherS2, you have to first put it into download mode.
4+
To do this, follow these steps:
5+
6+
- Press and hold the [BOOT] button
7+
- Press and release the [RESET] button
8+
- Release the [BOOT] button
9+
10+
Now the board is in download mode and the native USB will have enumerated as a serial device.
11+
12+
If you are putting MicroPython on your board for the first time then you should
13+
first erase the entire flash using:
14+
15+
### Linux
16+
```bash
17+
esptool.py --chip esp32s2 --port /dev/ttyACM0 erase_flash
18+
```
19+
20+
### Mac
21+
```bash
22+
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 erase_flash
23+
```
24+
25+
### Windows
26+
Change (X) to whatever COM port is being used by the board
27+
```bash
28+
esptool --chip esp32s2 --port COM(X) erase_flash
29+
```
30+
31+
Now download the version of the firmware you would like to install from the options
32+
below, then use the following command to program the firmware starting at address
33+
0x1000, remembering to replace `feathers2-micropython-firmware-version.bin` with the
34+
name of the firmware you just downloaded:
35+
36+
### Linux
37+
```bash
38+
esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
39+
```
40+
41+
### Mac
42+
```bash
43+
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
44+
```
45+
46+
### Windows
47+
Change (X) to whatever COM port is being used by the board
48+
```bash
49+
esptool --chip esp32s2 --port COM(X) write_flash -z 0x1000 feathers2-micropython-firmware-version.bin
50+
```

‎ports/esp32/boards/UM_FEATHERS2NEO/board.json‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"deploy": [
3-
"../deploy_s2.md"
3+
"deploy.md"
44
],
55
"docs": "",
66
"features": [
@@ -9,10 +9,16 @@
99
"Battery Charging",
1010
"STEMMA QT/QWIIC",
1111
"USB-C",
12-
"Neopixels"
12+
"RGB LED",
13+
"SPIRAM"
14+
],
15+
"features_non_filterable": [
16+
"5x5 RGB LED Matrix"
1317
],
1418
"id": "featherS2neo",
15-
"images": [],
19+
"images": [
20+
"FeatherS2_Neo_White_Product2.jpg"
21+
],
1622
"mcu": "esp32s2",
1723
"product": "Feather S2 Neo",
1824
"thumbnail": "",

‎ports/esp32/boards/UM_FEATHERS2NEO/board.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
The following files are daily firmware for the FeatherS2 Neo. This firmware is
2+
compiled using ESP-IDF v4.3 or later.

‎ports/esp32/boards/UM_FEATHERS2NEO/deploy.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).
2+
3+
To flash or erase your FeatherS2 Neo, you have to first put it into download mode.
4+
To do this, follow these steps:
5+
6+
- Press and hold the [BOOT] button
7+
- Press and release the [RESET] button
8+
- Release the [BOOT] button
9+
10+
Now the board is in download mode and the native USB will have enumerated as a serial device.
11+
12+
If you are putting MicroPython on your board for the first time then you should
13+
first erase the entire flash using:
14+
15+
### Linux
16+
```bash
17+
esptool.py --chip esp32s2 --port /dev/ttyACM0 erase_flash
18+
```
19+
20+
### Mac
21+
```bash
22+
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 erase_flash
23+
```
24+
25+
### Windows
26+
Change (X) to whatever COM port is being used by the board
27+
```bash
28+
esptool --chip esp32s2 --port COM(X) erase_flash
29+
```
30+
31+
Now download the version of the firmware you would like to install from the options below,
32+
then use the following command to program the firmware starting at address 0x1000,
33+
remembering to replace `feathers2neo-micropython-firmware-version.bin` with the name of
34+
the firmware you just downloaded:
35+
36+
### Linux
37+
```bash
38+
esptool.py --chip esp32s2 --port /dev/ttyACM0 write_flash -z 0x1000 feathers2neo-micropython-firmware-version.bin
39+
```
40+
41+
### Mac
42+
```bash
43+
esptool.py --chip esp32s2 --port /dev/cu.usbmodem01 write_flash -z 0x1000 feathers2neo-micropython-firmware-version.bin
44+
```
45+
46+
### Windows
47+
Change (X) to whatever COM port is being used by the board
48+
```bash
49+
esptool --chip esp32s2 --port COM(X) write_flash -z 0x1000 feathers2-feathers2neo-firmware-version.bin
50+
```

‎ports/esp32/boards/UM_TINYPICO/board.json‎

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,19 @@
11
{
22
"deploy": [
3-
"../deploy.md"
3+
"deploy.md"
44
],
55
"docs": "",
6-
"features": [],
6+
"features": [
7+
"BLE",
8+
"WiFi",
9+
"Battery Charging",
10+
"USB-C",
11+
"RGB LED",
12+
"SPIRAM"
13+
],
14+
"features_non_filterable": [
15+
"TinyPICO Compatible"
16+
],
717
"id": "tinypico",
818
"images": [
919
"tinypico-v2-both.jpg"

‎ports/esp32/boards/UM_TINYPICO/board.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
The following files are daily firmware for the TinyPICO. This firmware is compiled
2+
using ESP-IDF v4.2 or later. Some older releases are also provided that are
3+
compiled with ESP-IDF v3.x.

‎ports/esp32/boards/UM_TINYPICO/deploy.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).
2+
3+
Your TinyPICO has an auto-reset circuit on it, so there is no need to put it into a
4+
download mode first to erase or flash it.
5+
6+
If you are putting MicroPython on your board for the first time then you should
7+
first erase the entire flash using:
8+
9+
### Linux
10+
```bash
11+
esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash
12+
```
13+
14+
### Mac
15+
```bash
16+
esptool.py --chip esp32 --port /dev/tty.SLAB_USBtoUART erase_flash
17+
```
18+
19+
### Windows
20+
Change (X) to whatever COM port is being used by the board
21+
```bash
22+
esptool --chip esp32 --port COM(X) erase_flash
23+
```
24+
25+
Now download the version of the firmware you would like to install from the options below,
26+
then use the following command to program the firmware starting at address 0x1000,
27+
remembering to replace `tinypico-micropython-firmware-version.bin` with the name of the
28+
firmware you just downloaded:
29+
30+
From then on program the firmware starting at address 0x1000:
31+
32+
### Linux
33+
```bash
34+
esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 912600 write_flash -z 0x1000 tinypico-micropython-firmware-version.bin
35+
```
36+
37+
### Mac
38+
```bash
39+
esptool.py --chip esp32 --port /dev/tty.SLAB_USBtoUART --baud 912600 write_flash -z 0x1000 tinypico-micropython-firmware-version.bin
40+
```
41+
42+
### Windows
43+
Change (X) to whatever COM port is being used by the board
44+
```bash
45+
esptool --chip esp32 --port COM(X) --baud 912600 write_flash -z 0x1000 tinypico-micropython-firmware-version.bin
46+
```

‎ports/esp32/boards/UM_TINYS2/board.json‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,19 @@
11
{
22
"deploy": [
3-
"../deploy_s2.md"
3+
"deploy.md"
44
],
55
"docs": "",
66
"features": [
77
"WiFi",
88
"USB-C"
9+
"Battery Charging",
10+
"STEMMA QT/QWIIC",
11+
"USB-C",
12+
"RGB LED",
13+
"SPIRAM"
14+
],
15+
"features_non_filterable": [
16+
"TinyPICO Compatible"
917
],
1018
"id": "tinys2",
1119
"images": [

0 commit comments

Comments
 (0)