# ESP-IDF Project Setup Guide

Your zonebridge project is configured to use ESP-IDF v5.5.1 located at `/Users/brent/esp/v5.5.1/esp-idf`.

## Environment Setup

### Option 1: Per-Session Setup (Quick)
Run this in your terminal before building:
```bash
export IDF_PATH=/Users/brent/esp/v5.5.1/esp-idf
export IDF_TOOLS_PATH=/Users/brent/.espressif
. $IDF_PATH/export.sh
```

### Option 2: Permanent Shell Profile Setup
Add this to your `~/.zshrc` file:
```bash
# ESP-IDF Setup
export IDF_PATH="/Users/brent/esp/v5.5.1/esp-idf"
export IDF_TOOLS_PATH="/Users/brent/.espressif"

# Source ESP-IDF export script
if [ -f "$IDF_PATH/export.sh" ]; then
    . "$IDF_PATH/export.sh"
fi
```

Then reload your shell:
```bash
source ~/.zshrc
```

## Project Configuration

Your project is already configured with:
- **ESP-IDF Setup**: `/Users/brent/esp/v5.5.1/esp-idf`
- **Target**: ESP32-S3
- **Toolchain**: xtensa-esp-elf-gcc (in `~/.espressif/tools/`)
- **Clangd**: Located at `~/.espressif/tools/esp-clang/`

## Building the Project

Once environment variables are set, you can:

1. **Build with VS Code**: Use Command Palette (`Cmd+Shift+P`) → "ESP-IDF: Build Project"
2. **Build from Terminal**:
   ```bash
   cd /Users/brent/zonebridge/zonebridge
   idf.py build
   ```

## Flashing & Monitoring

```bash
idf.py flash monitor        # Flash and monitor output
idf.py menuconfig          # Open SDK configuration
idf.py clean               # Clean build artifacts
```

## Troubleshooting

If you see "IDF_PATH not set" errors:
1. Verify the export.sh script was sourced
2. Check that `echo $IDF_PATH` returns `/Users/brent/esp/v5.5.1/esp-idf`
3. Run `idf.py doctor` to diagnose any issues