Skip to content

Commit

Permalink
Fix broken symlinks for esp32s3 void_app (#10)
Browse files Browse the repository at this point in the history
Fix a bug that caused the void_app's bootloader and app images not
correctly signed.

Improve documentation.
  • Loading branch information
syncom authored Sep 24, 2024
1 parent a18845e commit 530c73d
Show file tree
Hide file tree
Showing 4 changed files with 39 additions and 9 deletions.
44 changes: 37 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -419,19 +419,19 @@ Both the IDF bootloader image and the application image are verified against
- Run container

```bash
docker run --rm -it esp32s3:latest
# Adjust the --device value to appropriate port
docker run --rm -it --device=/dev/ttyUSB0 esp32s3:latest
```

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

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

```bash
cd apps/void_app
# Display serial output
idf.py monitor
# Flash app and partition table images
idf.py flash
# Flash bootloader - idf.py flash cannot be used if secure boot is enabled
# Adjust device node (-p option) as needed
# Second-stage bootloader shall be flashed at offset 0x0000
esptool.py --chip esp32s3 \
--port=/dev/ttyUSB0 \
--baud=460800 \
--before=default_reset \
--after=no_reset \
--no-stub \
write_flash \
--flash_mode dio \
--flash_freq 80m \
--flash_size keep \
0x0 build/bootloader/bootloader.bin
# Flash app and partition table images. Can use `idf.py flash` or explicitly
# as below. Adjust device node (-p option) as needed
esptool.py -c esp32s3 \
-p /dev/ttyUSB0 \
-b 460800 \
--before=default_reset \
--after=no_reset \
--no-stub \
write_flash \
--flash_mode dio \
--flash_freq 80m \
--flash_size keep \
0x20000 build/void_app.bin \
0x10000 build/partition_table/partition-table.bin
```

Please refer to the void app's [flashing
instructions](./esp32s3/apps/void_app/README.md) for more detail.
</details>
<details>
Expand Down
1 change: 1 addition & 0 deletions esp32s3/apps/void_app/sbv2_private.pem
2 changes: 1 addition & 1 deletion esp32s3/apps/void_app/sdkconfig.defaults

This file was deleted.

0 comments on commit 530c73d

Please sign in to comment.