fiwi_monitor/PUSH_TO_UMBER.md

Push to Umber Git Repository

Current Status

✅ Git repository initialized
✅ All files staged
✅ Ready to commit and push

Steps to Push

1. Create Repository on Umber Git Server

First, create a new repository on your Umber Git server (Gitea/GitLab/etc.):

• Repository name: wireless-monitor (or your preferred name)
• Visibility: Private or Public (your choice)
• Do NOT initialize with README (we already have one)

2. Commit Locally

cd /home/rjmcmahon/Code/esp32/esp32-iperf-shell/wireless-monitor-template

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

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.

Features:
- Monitor mode setup using libnl3
- Packet capture using libpcap
- 802.11 frame parsing (RA, TA, duration, retry flag)
- MAC address filtering (matches ESP32 filter behavior)
- Output format matches ESP32 debug logs for easy comparison"

3. Add Remote Repository

Replace YOUR_REPO_URL with your actual Umber Git repository URL:

# Example URLs:
# https://git.umber.com/rjmcmahon/wireless-monitor.git
# git@git.umber.com:rjmcmahon/wireless-monitor.git

git remote add origin YOUR_REPO_URL

# Verify remote
git remote -v

4. Push to Repository

# Set default branch name (if needed)
git branch -M main

# Push to repository
git push -u origin main

# If your default branch is 'master' instead:
# git branch -M master
# git push -u origin master

Building on Raspberry Pi 5 After Clone

Once pushed, you can clone and build on Raspberry Pi 5:

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

# Build (automated)
./build_pi5.sh

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

# Run
sudo ./src/wireless_monitor wlan0 11

Troubleshooting

Authentication Issues

If you get authentication errors:

# For HTTPS (will prompt for username/password)
git remote set-url origin https://git.umber.com/rjmcmahon/wireless-monitor.git

# For SSH (requires SSH key setup)
git remote set-url origin git@git.umber.com:rjmcmahon/wireless-monitor.git

Branch Name Mismatch

If you get "branch name mismatch" error:

# Check what branch you're on
git branch

# Rename if needed
git branch -M main  # or 'master'

Push Rejected

If push is rejected because remote has content:

# Pull first (if remote has initial commit)
git pull origin main --allow-unrelated-histories

# Then push
git push -u origin main