* ESP32 Sequencer
A basic step sequencer based on the esp32-s3.

** Project Setup
Clone the repository
#+BEGIN_SRC shell
git clone git@gitea.rkcf.me:rkcf/esp32-sequencer.git
cd esp32-sequencer
#+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

Add the dependencies. They will install upon building the project the first time.
#+BEGIN_SRC shell
idf.py add-dependency "espressif/esp_lcd_ili9341>=1.0.2"
idf.py add-dependency "lvgl/lvgl>=8.3.0"
#+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

** Pinout
| ESP32 Pin | Function            | Peripheral Pin |
|-----------+---------------------+----------------|
|         5 | Clock LED           |                |
|         6 | Gate LED            |                |
|         7 | Clock CV Out        |                |
|         8 | Gate CV Out         |                |
|         9 | Mutate Button In    |                |
|        10 | Tap Tempo Button In |                |
|           |                     |                |
|        36 | CS                  | LCD 3          |
|        37 | RESET               | LCD 4          |
|        38 | DC/RS               | LCD 5          |
|        39 | SDI/MOSI            | LCD 6          |
|        40 | SCK                 | LCD 7          |
|        41 | LED                 | LCD 8          |
|        42 | SDO/MISO            | LCD 9          |

*** TFT LCD Screen
| LCD Pin | ESP32 Pin | Function  |
|---------+-----------+-----------|
|       1 |           | VCC (3V3) |
|       2 |           | GND       |
|       3 |        36 | CS        |
|       4 |        37 | RESET     |
|       5 |        38 | DC/RS     |
|       6 |        39 | SDI/MOSI  |
|       7 |        40 | SCK       |
|       8 |        41 | LED       |
|       9 |        42 | SDO/MISO  |

* 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.
- Commit messages should follow [[https:www.conventionalcommits.org/en/v1.0.0/][Conventional Commits 1.0.0]]

* License
This project is licensed under the [[https://choosealicense.com/licenses/mit/][MIT License]]