Skip to content

Commit 52282ad

Browse files
committed
docs: Update programming instructions for FoBE Quill ESP32S3 Mesh
Updated the programming guide to reflect changes in firmware links and installation instructions for the FoBE Quill ESP32S3 Mesh. Adjusted references from nRF52840 to ESP32S3 and modified the installation steps to include the use of esptool for flashing firmware. Signed-off-by: ChihoSin [email protected]
1 parent e8eb2cc commit 52282ad

File tree

2 files changed

+20
-28
lines changed

2 files changed

+20
-28
lines changed

docs/product/f1101/programming.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ The following describes how to program the FoBE Quill nRF52840 Mesh with MicroPy
5858

5959
#### Preview builds
6060

61-
[v1.26.0-preview(2025-07-19).uf2](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_nrf52840_mesh/FOBE_QUILL_NRF52840_MESH-20250719-v1.26.0-preview.uf2) / [[.hex]](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_nrf52840_mesh/FOBE_QUILL_NRF52840_MESH-20250719-v1.26.0-preview.hex)
61+
[v1.26.0-preview(2025-08-07).uf2](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_nrf52840_mesh/FOBE_QUILL_NRF52840_MESH-20250807-v1.26.0-preview.uf2) / [[.hex]](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_nrf52840_mesh/FOBE_QUILL_NRF52840_MESH-20250807-v1.26.0-preview.hex)
6262

6363
### Install
6464

@@ -72,7 +72,7 @@ To install the MicroPython firmware, follow these steps:
7272

7373
<br/><div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-21-10-48-27.png" alt="2025-07-21-10-48-27.png" style={{ width: '80%', height: 'auto' }} /></div><br/>
7474

75-
3. Copy the `.uf2` file to the device storage "FOBE BOOT".
75+
3. Copy the `.uf2` file to the device storage "FoBE Boot".
7676
4. The device will reboot automatically, and the MicroPython firmware will be installed.
7777

7878
#### HEX with OpenOCD (CMSIS-DAP)

docs/product/f1102/programming.mdx

Lines changed: 18 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ This guide describes how to program the FoBE Quill ESP32S3 Mesh.
88

99
If you use the Arduino IDE for programming, please see [Quick Start - Setup the board](/product/f1102/quickstart#setup-the-board).
1010

11-
The following describes how to program the FoBE Quill nRF52840 Mesh with Arduino using PlatformIO.
11+
The following describes how to program the FoBE Quill ESP32S3 Mesh with Arduino using PlatformIO.
1212

1313
### Install PlatformIO
1414

@@ -54,42 +54,34 @@ The following describes how to program the FoBE Quill ESP32S3 Mesh with MicroPyt
5454

5555
#### Releases
5656

57-
[FoBE MicroPython Index](https://micropython.fobestudio.com/?path=firmwares/fobe_quill_nrf52840_mesh)
57+
[FoBE MicroPython Index](https://micropython.fobestudio.com/?path=firmwares/fobe_quill_esp32s3_mesh)
5858

5959
#### Preview builds
6060

61-
[v1.26.0-preview(2025-07-19).uf2](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_nrf52840_mesh/FOBE_QUILL_NRF52840_MESH-20250719-v1.26.0-preview.uf2) / [[.hex]](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_nrf52840_mesh/FOBE_QUILL_NRF52840_MESH-20250719-v1.26.0-preview.hex)
61+
[v1.26.0-preview(2025-08-07).bin](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_esp32s3_mesh/FOBE_QUILL_ESP32S3_MESH-20250807-v1.26.0-preview.bin) / [[.elf]](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_esp32s3_mesh/FOBE_QUILL_ESP32S3_MESH-20250807-v1.26.0-preview.elf) / [[.map]](https://raw.githubusercontent.com/fobe-projects/fobe-micropython-index/refs/heads/gh-pages/firmwares/fobe_quill_esp32s3_mesh/FOBE_QUILL_ESP32S3_MESH-20250807-v1.26.0-preview.map)
6262

6363
### Install
6464

6565
To install the MicroPython firmware, follow these steps:
6666

67-
#### UF2 with USB Storage
67+
#### BIN with esptool
6868

69-
1. Download the latest firmware file with the `.uf2` extension.
70-
2. Connect the FoBE Quill nRF52840 Mesh to your computer.
71-
3. Double-click the reset button on the device to enter bootloader mode.
72-
73-
<br/><div style={{ textAlign: 'center' }}><img src="/img/screenshot/2025-07-21-10-48-27.png" alt="2025-07-21-10-48-27.png" style={{ width: '80%', height: 'auto' }} /></div><br/>
74-
75-
3. Copy the `.uf2` file to the device storage "FOBE BOOT".
76-
4. The device will reboot automatically, and the MicroPython firmware will be installed.
77-
78-
#### HEX with OpenOCD (CMSIS-DAP)
79-
80-
Hex files are used for programming the device using OpenOCD. Please make sure OpenOCD is installed and configured correctly.
81-
82-
1. Download the latest firmware file with the `.hex` extension.
83-
2. Connect the FoBE Quill nRF52840 Mesh to your computer.
84-
3. Connect the debug interface (CMSIS-DAP) to the FoBE Quill nRF52840 Mesh.
85-
4. Open a terminal and run the following command:
69+
:::important
70+
Program your board using the esptool.py program, found [here](https://docs.espressif.com/projects/esptool/en/latest/esp32s3/).
71+
:::
8672

73+
1. Download the latest firmware file with the `.bin` extension.
74+
2. Connect the FoBE Quill ESP32S3 Mesh to your computer.
75+
3. If you are putting MicroPython on your board for the first time then you should first erase the entire flash using:
8776
```bash
88-
openocd -f interface/cmsis-dap.cfg -f target/nrf52.cfg \
89-
-c "init" -c "program <path_to_firmware.hex> verify reset" -c "exit"
77+
python3 -m esptool erase-flash
9078
```
91-
92-
Replace `<path_to_firmware.hex>` with the path to the downloaded `.hex` file.
79+
4. Flash the firmware to the device using the following command:
80+
```bash
81+
python3 -m esptool --chip esp32s3 -b 921600 --before default-reset --after hard-reset \
82+
write-flash --flash-mode dio --flash-size 4MB --flash-freq 80m 0x0 [firmware].bin
83+
```
84+
5. The device will reboot automatically, and the MicroPython firmware will be installed.
9385

9486
### Create a new project
9587

@@ -274,7 +266,7 @@ Before you start, make sure you have Python installed on your system.
274266

275267
```bash
276268
# Build the project for the FoBE Quill ESP32S3 Mesh board
277-
west build -b fobe_quill_esp32s3/esp32s3/procpu/w ./app
269+
west build -b fobe_quill_esp32s3_mesh/esp32s3/procpu ./app
278270
279271
# Flash the project to the board
280272
west flash

0 commit comments

Comments
 (0)