# Pi 5 + IMX219 OS Image Setup Guide

This guide walks you through setting up a **Raspberry Pi 5** with an **IMX219** camera module (Camera Module v2) to run the PiCam streamer.

## Option A: Easy Method — Run Setup on a Live Pi (Recommended)

If you already have Raspberry Pi OS running on your Pi 5:

1.  **Copy the project** to your Pi (via USB drive, `scp`, or `git clone`).
2.  **Run the setup script:**
    ```bash
    cd piCam/image-setup
    chmod +x setup-pi.sh
    ./setup-pi.sh
    ```
3.  **Done.** The streamer will start automatically and will auto-start on every boot.

Open `http://<pi-ip>:5000` in your browser.

---

## Option B: Prepare an SD Card Image from Scratch

### 1. Download Raspberry Pi OS

Download the latest **Raspberry Pi OS (64-bit)** from the official site:

```
https://www.raspberrypi.com/software/operating-systems/
```

Recommended: **Raspberry Pi OS with Desktop** or **Lite** if you want a headless server.

### 2. Flash the OS to SD Card

Use the official **Raspberry Pi Imager**:

```
https://www.raspberrypi.com/software/
```

Steps in Imager:
1. Choose OS → Raspberry Pi OS (64-bit)
2. Choose Storage → Your SD card
3. Click the **gear icon (⚙️)** to open Advanced Options and configure:
   - **Hostname**: `picam` (or your preference)
   - **Enable SSH**: ☑️ (Use password authentication or public key)
   - **Set username/password**: `pi` / your-password
   - **Configure Wi-Fi**: Enter your SSID and password
   - **Set locale**: Your timezone and keyboard layout
4. Click **Write**

### 3. Enable Camera Hardware

After flashing, the SD card will show a `bootfs` partition. You need to ensure camera support is enabled.

#### For Raspberry Pi OS Bookworm and later:

The IMX219 is usually auto-detected. However, if you need to force it, open `bootfs/config.txt` and add to the end:

```ini
# IMX219 Camera Module v2
dtoverlay=imx219
```

> **Note:** On Pi 5, the camera uses the CSI/DSI connector. Make sure the flat cable is oriented correctly (blue tape facing away from the USB ports on Pi 5).

### 4. Copy the Project Files

Copy the contents of this `image-setup` folder to the SD card:

```bash
# Linux/macOS example (adjust paths as needed)
cp -r /path/to/piCam/image-setup/* /media/YOUR_USERNAME/bootfs/
```

Specifically, ensure these files are placed on the `bootfs` partition:
- `autosetup.sh` → root of `bootfs/`
- `firstrun.sh` → root of `bootfs/`

### 5. Boot the Pi

Insert the SD card into the Pi 5, connect power, and wait 2-3 minutes for the first-boot setup to complete.

### 6. Access the Stream

Once booted, find the Pi on your network:
```bash
ping picam.local
```

Then open in a browser:
```
http://picam.local:5000
```

---

## Troubleshooting

| Issue | Solution |
|-------|----------|
| Camera not detected | Run `libcamera-hello --list-cameras` to verify hardware detection |
| Green tint on image | Normal under some lighting; adjust AWB in picamera2 config |
| Low framerate | Reduce resolution or ensure GPU memory isn't too low |
| `picamera2` not found | Run `sudo apt install -y python3-picamera2` |

## Automated First-Boot Setup

If you copied the provided files to `bootfs`, the system will:
1. Expand the filesystem
2. Update all packages
3. Install camera drivers, Python dependencies, and Flask
4. Enable the camera interface
5. Auto-start the streaming server on boot

Monitor progress by SSHing in:
```bash
ssh pi@picam.local
tail -f /var/log/picam-setup.log
```