Docs: add project setup section to README
parent
3287956c5d
commit
f960dba5a8
30
README.org
30
README.org
|
|
@ -12,6 +12,36 @@ This project aims to create a generic esp32-s3 based eurorack modular unit—rep
|
||||||
- 4 buttons
|
- 4 buttons
|
||||||
- 2.2in TFT LCD Display
|
- 2.2in TFT LCD Display
|
||||||
|
|
||||||
|
* Project Setup
|
||||||
|
Clone the repository over ssh.
|
||||||
|
#+BEGIN_SRC shell
|
||||||
|
git clone git@gitea.rkcf.me/rkcf/esp32_eurorack_generic.git
|
||||||
|
cd esp32_eurorack_generic
|
||||||
|
#+END_SRC
|
||||||
|
|
||||||
|
Source idf path. Assumes [[https://docs.espressif.com/projects/esp-idf/en/v5.0/esp32s3/get-started/index.html#installation][ESP-IDF]] properly configured on system.
|
||||||
|
#+BEGIN_SRC shell
|
||||||
|
. $YOUR_PATH_TO_ESP_IDF/export.sh
|
||||||
|
#+END_SRC
|
||||||
|
|
||||||
|
Set the target chip and configure the project. NOTE: Running menuconfig is not currently necessary for this project.
|
||||||
|
#+BEGIN_SRC shell
|
||||||
|
idf.py set-target esp32s3
|
||||||
|
idf.py menuconfig
|
||||||
|
#+END_SRC
|
||||||
|
|
||||||
|
Building and flashing the project. Where $PORT is the boards serial port system address (e.g. /dev/ttyUSB0).
|
||||||
|
#+BEGIN_SRC shell
|
||||||
|
idf.py build
|
||||||
|
idf.py -p $PORT flash
|
||||||
|
idf.py -p $PORT monitor
|
||||||
|
#+END_SRC
|
||||||
|
|
||||||
|
Or do all of this in one go with:
|
||||||
|
#+BEGIN_SRC shell
|
||||||
|
idf.py -p $PORT flash monitor
|
||||||
|
#+END_SRC
|
||||||
|
|
||||||
* Contributing
|
* Contributing
|
||||||
- Currently this branch is bleeding edge for rapid prototyping. In the future, a design will be homolugated and [[https://semver.org/][Semantic Versioning 2.0.0]] will be used. Note that schematics have their own versioning seperate from the code base.
|
- Currently this branch is bleeding edge for rapid prototyping. In the future, a design will be homolugated and [[https://semver.org/][Semantic Versioning 2.0.0]] will be used. Note that schematics have their own versioning seperate from the code base.
|
||||||
- Commit messages should follow [[https:www.conventionalcommits.org/en/v1.0.0/][Conventional Commits 1.0.0]]
|
- Commit messages should follow [[https:www.conventionalcommits.org/en/v1.0.0/][Conventional Commits 1.0.0]]
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue