Modify idf.sh and update README.md

This commit is contained in:
Andreas Tsouchlos 2024-03-02 15:38:22 +01:00
parent 44e38aa03d
commit 3a380f9b97
2 changed files with 17 additions and 32 deletions

View File

@ -1,38 +1,23 @@
# HyperLink_SW
Firmware for the HyperLink board.
Firmware for the HyperLink project.
## Build and run
This project is built using the [ESP IDF](https://docs.espressif.com/projects/esp-idf/en/release-v5.1/esp32/index.html) toolchain.
In order to ease the build process, a custom `Dockerfile` is provided.
Any ESP IDF toolchain command can be run by replacing `idf.py` by `./idf.sh`, e.g., `./idf.sh build`,
after having built the docker image.
This project is built using the
[ESP IDF](https://docs.espressif.com/projects/esp-idf/en/release-v5.1/esp32/index.html)
toolchain. In order to ease the build process, a custom `Dockerfile` is
provided. Any ESP IDF toolchain command can be run by replacing `idf.py` by
`./idf.sh`, e.g., `./idf.sh build`.
As the docker container has to be able to access the serial device for flashing,
some configuration may have to take place.
Make sure the `USB_GUID` and `USB_DEV` in `idf.py` have the correct values.
Before the executing the following commands, make sure the docker daemon is
running:
1. Build the docker image
```bash
$ sudo docker build . --tag hyperlink
```
2. Compile the project
```bash
$ ./idf.sh build
```
3. Flash the executable
```bash
$ ./idf.sh flash
```
## Misc
### CLion Docker Setup
To configure the project to be built with docker in CLion, create a new docker
toolchain with the following settings:
![image](doc/CLion_docker_settings_screenshot.png)
1. Build the project
```bash
$ ./idf.sh build
```
1. Flash the executable
```bash
$ ./idf.sh flash monitor
```

2
idf.sh
View File

@ -35,4 +35,4 @@ done
#
docker run ${DEVICE_FLAGS} --rm --user $(id -u):${USB_GID} -v $PWD:/project -w /project -it hyperlink idf.py $@
docker build . && docker run ${DEVICE_FLAGS} --rm --user $(id -u):${USB_GID} -v $PWD:/project -w /project -it $(docker build . -q) idf.py $@