OCTv2/raspberry_pi_server

OCTv2 (Oreo Cookie Thrower v2) - Raspberry Pi Server

Python server to control your Oreo Cookie Thrower hardware from the iOS app.

🚀 Quick Setup

1. Install on Raspberry Pi

# Copy files to your Pi
scp -r raspberry_pi_server/ pi@your-pi-ip:~/octv2/

# SSH into your Pi
ssh pi@your-pi-ip
cd ~/octv2

2. Install Dependencies

# Update system
sudo apt update

# Install Python camera library
sudo apt install python3-picamera2

# Install GPIO library (usually pre-installed)
sudo apt install python3-rpi.gpio

# Or install from requirements
pip3 install -r requirements.txt

3. Configure Hardware

Edit octv2_server.py to match your hardware:

# GPIO pins (adjust for your hardware)
self.SERVO_PIN = 18        # Servo for aiming
self.STEPPER_PINS = [19, 20, 21, 22]  # Stepper motor pins
self.FIRE_PIN = 23         # Fire mechanism trigger

4. Run the Server

# Make executable
chmod +x octv2_server.py

# Run the server
python3 octv2_server.py

# Or run in background
nohup python3 octv2_server.py &

5. Connect from iOS App

1. Find your Pi's IP address:

   hostname -I
   

2. In OCTv2 iOS app:

   • Tap the ⚙️ settings button
   • Enter your Pi's IP address
   • Port: 8080 (default)
   • Tap "Connect to Launcher"

🎮 Supported Commands

The server handles these commands from the iOS app:

Command	Description
aim_left	Move aim left by 5°
aim_right	Move aim right by 5°
fire	Fire Oreo at specified angle
home	Home device to reference position
set_mode	Set auto/manual mode
capture_photo	Take high-res photo
start_video_stream	Begin video streaming
stop_video_stream	Stop video streaming
status	Get device status

🔧 Hardware Configuration

Servo Control (Aiming)

• Pin: GPIO 18 (default)
• Type: Standard servo (0-60° range)
• PWM: 50Hz frequency

Fire Mechanism

• Pin: GPIO 23 (default)
• Type: Digital output (relay/solenoid)
• Trigger: 100ms pulse

Camera

• Type: Pi Camera Module
• Streaming: 320x240 @ ~10fps
• Photos: Full resolution saved to Pi

🐛 Troubleshooting

"Camera not available"

# Enable camera
sudo raspi-config
# Interface Options → Camera → Enable

# Test camera
libcamera-hello

"Permission denied" GPIO

# Add user to gpio group
sudo usermod -a -G gpio $USER
# Logout and login again

"Connection refused" from app

# Check if server is running
ps aux | grep octv2_server

# Check firewall
sudo ufw status

# Test connectivity
telnet your-pi-ip 8080

Server won't start

# Check Python version
python3 --version

# Check dependencies
pip3 list | grep -E "(picamera2|RPi.GPIO)"

# Run with verbose logging
python3 octv2_server.py --debug

📝 Log Files

Server logs are displayed in the terminal. To save logs:

python3 octv2_server.py 2>&1 | tee octv2.log

🔒 Security Note

The server runs on port 8080 without authentication. For local network use only.

🍪 Happy Oreo Launching!

Your OCTv2 is ready to launch cookies with precision control from your iPhone!