Skip to content

Commit 530c73d

Browse files
authored
Fix broken symlinks for esp32s3 void_app (#10)
Fix a bug that caused the void_app's bootloader and app images not correctly signed. Improve documentation.
1 parent a18845e commit 530c73d

File tree

4 files changed

+39
-9
lines changed

4 files changed

+39
-9
lines changed

README.md

Lines changed: 37 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -419,19 +419,19 @@ Both the IDF bootloader image and the application image are verified against
419419
- Run container
420420

421421
```bash
422-
docker run --rm -it esp32s3:latest
422+
# Adjust the --device value to appropriate port
423+
docker run --rm -it --device=/dev/ttyUSB0 esp32s3:latest
423424
```
424425

425-
- Build sample app inside container
426+
- Build sample void app inside container. Note that the app specific
427+
`sdkconfig.defaults` is symlinked to `../sdkconfig.apps`.
426428

427429
```bash
428430
$ pwd
429431
/home/esp
430432
# Set up environment
431433
. esp-idf/export.sh
432-
# Get sample app - hello_world and build for esp32s3 target
433-
$ cp -r esp-idf/examples/get-started/hello_world/ .
434-
$ cd hello_world
434+
$ cd apps/avoid_app
435435
$ idf.py set-target esp32s3
436436
$ idf.py build
437437
```
@@ -449,11 +449,41 @@ Both the IDF bootloader image and the application image are verified against
449449
Inside container, you can interact with the device using esp-idf tools, e.g.,
450450

451451
```bash
452+
cd apps/void_app
452453
# Display serial output
453454
idf.py monitor
454-
# Flash app and partition table images
455-
idf.py flash
455+
# Flash bootloader - idf.py flash cannot be used if secure boot is enabled
456+
# Adjust device node (-p option) as needed
457+
# Second-stage bootloader shall be flashed at offset 0x0000
458+
esptool.py --chip esp32s3 \
459+
--port=/dev/ttyUSB0 \
460+
--baud=460800 \
461+
--before=default_reset \
462+
--after=no_reset \
463+
--no-stub \
464+
write_flash \
465+
--flash_mode dio \
466+
--flash_freq 80m \
467+
--flash_size keep \
468+
0x0 build/bootloader/bootloader.bin
469+
# Flash app and partition table images. Can use `idf.py flash` or explicitly
470+
# as below. Adjust device node (-p option) as needed
471+
esptool.py -c esp32s3 \
472+
-p /dev/ttyUSB0 \
473+
-b 460800 \
474+
--before=default_reset \
475+
--after=no_reset \
476+
--no-stub \
477+
write_flash \
478+
--flash_mode dio \
479+
--flash_freq 80m \
480+
--flash_size keep \
481+
0x20000 build/void_app.bin \
482+
0x10000 build/partition_table/partition-table.bin
456483
```
484+
485+
Please refer to the void app's [flashing
486+
instructions](./esp32s3/apps/void_app/README.md) for more detail.
457487
</details>
458488
459489
<details>
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
../sbv2_private_pem.app
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
../fusing/efuse_configs/sdkconfig.dev-sbv2_with_jtag
1+
../sdkconfig.apps

esp32s3/apps/void_app/secure_boot_signing_key_private-dev.pem

Lines changed: 0 additions & 1 deletion
This file was deleted.

0 commit comments

Comments
 (0)