Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions src/content/docs/reference/OpenIPC-Glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -141,3 +141,6 @@ description: Here is a glossary of terms related to OpenIPC

- **Yaml-CLI**
A command-line interface tool used to change settings.
- **NIC**
Network Interface Controller (also commonly called Network Interface Card).
It is the hardware component (either built into your device or an external adapter) that allows your computer, phone, laptop, or any device to connect to a Wi-Fi network.
92 changes: 46 additions & 46 deletions src/content/docs/use-cases/fpv/apfpv/APFPV.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ description: "Simple WiFi-based FPV video transmission for beginners. Easy setup
:::


APFPV stands for "Access Point FPV" - it's a simple way to get video from your drone to your phone, tablet, or computer using regular WiFi. Think of it like your drone creating its own WiFi hotspot that you connect to for live video.
APFPV stands for "Access Point FPV" - it's a simple way to get video from your VTX to your phone, tablet, or computer using regular WiFi. Think of it like your VTX creating its own WiFi hotspot that you connect to for live video.

## What is APFPV?

The APFPV firmware from the OpenIPC team creates direct WiFi communication between your drone's video transmitter (VTX) and your ground station. Instead of complex solutions, your drone simply acts like a WiFi router that you connect to directly.
The APFPV firmware from the OpenIPC team creates direct WiFi communication between your VTX's video transmitter (VTX) and your ground station. Instead of complex solutions, your VTX simply acts like a WiFi router that you connect to directly.

This isn't meant to be revolutionary technology - it's designed to be **simple and accessible**, especially for people who find other FPV systems too complicated to set up.

Expand All @@ -37,7 +37,7 @@ This isn't meant to be revolutionary technology - it's designed to be **simple a

## What You'll Need

### For Your Drone (VTX):
### For Your (VTX):
- OpenIPC-compatible camera/board
- WiFi chip (RTL8812AU, RTL8812EU or RTL8733BU)

Expand All @@ -51,49 +51,49 @@ This isn't meant to be revolutionary technology - it's designed to be **simple a

### Step 1: Installing APFPV Firmware

There are two ways to install APFPV firmware on your drone. The internet method is much easier if your drone can connect to WiFi.
There are two ways to install APFPV firmware on your VTX. The internet method is much easier if your VTX can connect to WiFi.

## Method 1: Easy Internet Installation (Recommended)

### Step 1: Connect Your Drone to Internet
### Step 1: Connect Your VTX to Internet

**Physical connection:**
1. Connect your drone to your computer using a Ethernet cable, USB adapter or UART adapter
2. Power on your drone
1. Connect your VTX to your computer using a Ethernet cable, USB adapter or UART adapter
2. Power on your VTX
3. Wait for it to fully boot up (about 1-2 minutes)

**Connect to your WiFi router:**
1. Your drone needs to connect to your home WiFi to download the firmware
2. Use SSH to connect to your drone (see "How to SSH" below)
3. Configure your drone to connect to your home WiFi network
1. Your VTX needs to connect to your home WiFi to download the firmware
2. Use SSH to connect to your VTX (see "How to SSH" below)
3. Configure your VTX to connect to your home WiFi network

### Step 2: How to SSH Into Your Drone
### Step 2: How to SSH Into Your VTX

**What is SSH?** SSH is a way to type commands directly into your drone from your computer.
**What is SSH?** SSH is a way to type commands directly into your VTX from your computer.

**On Windows:**
1. Download and install [PuTTY](https://www.putty.org/) (free SSH program)
2. Open PuTTY
3. In "Host Name" field, enter your drone's IP address
3. In "Host Name" field, enter your VTX's IP address
4. Port: 22
5. Connection type: SSH
6. Click "Open"
7. Login with your drone's username (root) and password (12345)
7. Login with your VTX's username (root) and password (12345)

**On Mac/Linux:**
1. Open Terminal
2. Type: `ssh root@[drone-ip-address]`
2. Type: `ssh root@[VTX-ip-address]`
3. Press Enter
4. Enter password when prompted

**Finding your drone's IP address:**
**Finding your VTX's IP address:**
- Check your router's admin page for connected devices
- Or use network scanning apps on your phone
- Common default: 192.168.1.24 or 192.168.0.24

### Step 3: Install Firmware with One Command

Once you're connected via SSH and your drone has internet access:
Once you're connected via SSH and your VTX has internet access:

1. Copy and paste this exact command:
```bash
Expand All @@ -104,15 +104,15 @@ sysupgrade -k -r -n --url=https://github.com/OpenIPC/builder/releases/download/l

3. Wait for the download and installation (5-10 minutes)

4. Your drone will automatically reboot when finished
4. Your VTX will automatically reboot when finished

**That's it!** Your drone now has APFPV firmware installed. Make sure you unplug the ethernet cable after you finish for the stream to work properly.
**That's it!** Your VTX now has APFPV firmware installed. Make sure you unplug the ethernet cable after you finish for the stream to work properly.

---

## Method 2: Manual Installation (No Internet Required)

Use this method if your drone cannot connect to internet or you prefer manual installation.
Use this method if your VTX cannot connect to internet or you prefer manual installation.

### Step 1: Download Firmware Files

Expand All @@ -122,48 +122,48 @@ Use this method if your drone cannot connect to internet or you prefer manual in
- `uImage.ssc338q`
- `rootfs.squashfs.ssc338q`

### Step 2: Copy Files to Drone
### Step 2: Copy Files to VTX

**Using WinSCP (Windows):**
1. Download and install WinSCP
2. Open WinSCP
3. Protocol: SCP
4. Host name: Your drone's IP address
5. Username and password: Your drone's login credentials
4. Host name: Your VTX's IP address
5. Username and password: Your VTX's login credentials
6. Click "Login"
7. Navigate to `/tmp` folder on drone side
7. Navigate to `/tmp` folder on VTX side
8. Copy both firmware files to `/tmp`

**Using SCP command (Mac/Linux):**
```bash
scp uImage.ssc338q root@[drone-ip]:/tmp/
scp rootfs.squashfs.ssc338q root@[drone-ip]:/tmp/
scp uImage.ssc338q root@[VTX-ip]:/tmp/
scp rootfs.squashfs.ssc338q root@[VTX-ip]:/tmp/
```

### Step 3: Install Firmware

1. SSH into your drone (see "How to SSH" above)
1. SSH into your VTX (see "How to SSH" above)
2. Type this command:
```bash
sysupgrade -z -n --kernel=/tmp/uImage.ssc338q --rootfs=/tmp/rootfs.squashfs.ssc338q
```
3. Press Enter
4. Wait for installation to complete (5-10 minutes)
5. Drone will reboot automatically
5. VTX will reboot automatically

---

### Step 4: Connect to Your Drone
### Step 4: Connect to Your VTX

After your drone reboots:
After your VTX reboots:

1. On your phone/computer, look for WiFi networks
2. Connect to: **"OpenIPC"**
3. Password: **"12345678"**
4. Your device will automatically get an IP address (192.168.0.X)

**Network details:**
- Your drone's IP: `192.168.0.1`
- Your VTX's IP: `192.168.0.1`
- Video stream goes to: `192.168.0.10`
- Network range: `192.168.0.0/24`

Expand All @@ -176,7 +176,7 @@ After your drone reboots:
**On Any Computer:**
- Open web browser
- Go to: `http://192.168.0.1`
- You'll see the drone's beautiful WebUI with live video
- You'll see the VTX's beautiful WebUI with live video

**On Linux:**
Use GStreamer command:
Expand All @@ -191,24 +191,24 @@ Use any program that can receive RTP streams over UDP on port 5600.

**Change your WiFi name and password:**

Connect to your drone via UART or SSH and run:
Connect to your VTX via UART or SSH and run:
```bash
fw_setenv wlanssid Drone
fw_setenv wlanssid VTX
fw_setenv wlanpass openipcfpv
```
Replace "Drone" with your preferred network name and "openipcfpv" with your chosen password.
Replace "VTX" with your preferred network name and "openipcfpv" with your chosen password.

**Change your WiFi Band and Frequency:**

Connect to your drone via UART or SSH and run:
Connect to your VTX via UART or SSH and run:
```bash
fw_setenv wlanfreq 5700
```
Set the frequency you need in the 2.4GHz or 5GHz range

**Change your WiFi Transmitter Power:**

Connect to your drone via UART or SSH and run:
Connect to your VTX via UART or SSH and run:
```bash
fw_setenv wlanpwr 2000
```
Expand All @@ -220,9 +220,9 @@ Reboot your VTX for changes to take effect.
## Understanding the Setup

Think of your setup like this:
- **Your drone** = WiFi router (192.168.0.1)
- **Your VTX** = WiFi router (192.168.0.1)
- **Your ground station** = Connected device (192.168.0.10)
- **Video stream** = Data flowing from drone to your device
- **Video stream** = Data flowing from VTX to your device
- **Web interface** = Control panel at http://192.168.0.1

## Supported Hardware
Expand All @@ -243,7 +243,7 @@ Think of your setup like this:

### "What's the video delay?"
Expect 40-70ms delay. This varies based on:
- Distance between drone and ground station
- Distance between VTX and ground station
- WiFi interference in the area
- Processing power of your ground station device
- Video quality settings
Expand All @@ -264,10 +264,10 @@ Range depends entirely on your equipment:
## Troubleshooting

### Can't See "OpenIPC" WiFi Network
1. Make sure drone is powered and firmware installed correctly
2. Wait 1-2 minutes after drone boots up
3. Try restarting the drone
4. Move closer to the drone
1. Make sure VTX is powered and firmware installed correctly
2. Wait 1-2 minutes after VTX boots up
3. Try restarting the VTX
4. Move closer to the VTX

### Connected but No Video
1. Open web browser and go to `http://192.168.0.1`
Expand All @@ -282,7 +282,7 @@ Range depends entirely on your equipment:
4. Adjust video quality in the web interface

### Web Interface Won't Load
1. Confirm you're connected to drone's WiFi
1. Confirm you're connected to VTX's WiFi
2. Try `http://192.168.0.1` in different browsers
3. Clear browser cache and cookies
4. Restart both devices
Expand All @@ -291,7 +291,7 @@ Range depends entirely on your equipment:

### Optimizing Your Setup
- Use 5GHz WiFi when possible (less crowded than 2.4GHz)
- Keep line of sight between drone and ground station
- Keep line of sight between VTX and ground station
- Use devices with good WiFi antennas. Use mix of directional and omnidirectional antennas.
- Test everything on the ground before flying

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/use-cases/fpv/apfpv/Greg's_APFPV.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,4 +103,4 @@ curl -L -o /tmp/openipc.ssc338q-nor-apfpv-greg08RC2.tgz https://github.com/sickg
**That's it!** Your VTX now has APFPV firmware installed. Make sure you unplug the ethernet cable after you finish for the stream to work properly.
## From this point forward, the setup process follows the same structure and conventions as the OpenIPC APFPV firmware. Please refer to the corresponding APFPV section in the official OpenIPC documentation.
### For a more detailed explanation, please refer to Greg’s official guide on GitHub:
[Sickgreg OpenIPC_sickgregFPV_apfpv ](https://github.com/OpenIPC/firmware/wiki/APFPV](https://github.com/sickgreg/OpenIPC_sickgregFPV_apfpv))
[Sickgreg OpenIPC_sickgregFPV_apfpv ](https://github.com/sickgreg/OpenIPC_sickgregFPV_apfpv))