# Setting Up Git Repository

This guide helps you set up this project in the Umber git repository.

## Option 1: Create New Repository

### On Your Git Server (Gitea/GitHub/etc.)

1. Create a new repository named `wireless-monitor` (or your preferred name)
2. Note the repository URL (e.g., `https://git.umber.com/rjmcmahon/wireless-monitor.git`)

### On Raspberry Pi 5

```bash
cd wireless-monitor-template

# Initialize git (if not already done)
git init

# Add all files
git add -A

# Create initial commit
git commit -m "Initial commit: Linux wireless monitor for ESP32 verification"

# Add remote repository
git remote add origin https://git.umber.com/rjmcmahon/wireless-monitor.git

# Push to repository
git push -u origin main
# Or if your default branch is 'master':
# git push -u origin master
```

## Option 2: Add to Existing Repository

If you want to add this as a subdirectory to an existing repository:

```bash
# From the parent repository
cd /path/to/parent/repo

# Copy the template
cp -r wireless-monitor-template wireless-monitor

# Add to git
cd wireless-monitor
git init
git add -A
git commit -m "Add wireless monitor tool for ESP32 verification"

# Add as submodule (if parent repo uses submodules)
# Or just add files directly to parent repo
```

## Option 3: Standalone Repository

If you want this as a completely separate repository:

```bash
cd wireless-monitor-template

# Initialize git
git init

# Create .gitignore (already included)
# Add all files
git add -A

# Initial commit
git commit -m "Initial commit: Linux wireless monitor

A C program using GNU Automake for capturing and parsing 802.11 WiFi
frame headers in monitor mode. Designed to verify ESP32 monitor code
by comparing Linux vs ESP32 frame parsing."

# Add remote (replace with your actual repository URL)
git remote add origin https://git.umber.com/rjmcmahon/wireless-monitor.git

# Push
git branch -M main  # Or 'master' if that's your default
git push -u origin main
```

## Building on Raspberry Pi 5

After cloning the repository:

```bash
# Clone repository
git clone https://git.umber.com/rjmcmahon/wireless-monitor.git
cd wireless-monitor

# Run build script
./build_pi5.sh

# Or manually:
./autogen.sh
./configure
make
```

## Repository Structure

```
wireless-monitor/
├── .gitignore
├── configure.ac
├── Makefile.am
├── autogen.sh
├── build_pi5.sh          # Automated build script for Pi 5
├── README.md
├── BUILD_PI5.md          # Build instructions
├── VERIFICATION_GUIDE.md  # ESP32 verification guide
└── src/
    ├── Makefile.am
    ├── main.c
    ├── monitor.c
    ├── monitor.h
    ├── capture.c
    ├── capture.h
    ├── frame_parser.c
    └── frame_parser.h
```

## Git Workflow

```bash
# Make changes
# ... edit files ...

# Stage changes
git add -A

# Commit
git commit -m "Description of changes"

# Push
git push origin main
```