diff options
Diffstat (limited to '02.-Direction-Finding-Quickstart-Guide.md')
| -rw-r--r-- | 02.-Direction-Finding-Quickstart-Guide.md | 26 |
1 files changed, 13 insertions, 13 deletions
diff --git a/02.-Direction-Finding-Quickstart-Guide.md b/02.-Direction-Finding-Quickstart-Guide.md index 72d9afa..45bf2cb 100644 --- a/02.-Direction-Finding-Quickstart-Guide.md +++ b/02.-Direction-Finding-Quickstart-Guide.md @@ -1,13 +1,13 @@ -This QuickStart guide aims to have you connected to the Android Direction Finding App as quickly as possible with the KrakenSDR running on a Raspberry Pi 4. However, please make sure you read the rest of the manual to understand how radio direction finding works. +This QuickStart guide aims to have you connected to the Android Direction Finding App as quickly as possible with the KrakenSDR running on a Raspberry Pi 4 or Orange Pi 5B (OPI5B) (the model with WiFi). However, please make sure you read the rest of the manual to understand how radio direction finding works. ## What you will need This guide assumes that you have the following equipment * KrakenSDR -* Raspberry Pi 4 +* Raspberry Pi 4 or Orange Pi 5B * Antenna array (five identical whip antennas with five identical coax cables) -* USA-A to USB-C data cable for Pi 4 to KrakenSDR data connection -* USB-C power supplies for Pi 4 and KrakenSDR +* USA-A to USB-C data cable for Pi 4 / OPI5B to KrakenSDR data connection +* USB-C power supplies for Pi 4 / OPI5B and KrakenSDR It assumes that you will be mounting your antenna array on a vehicle for direction finding. @@ -46,10 +46,10 @@ The image below explains how the antennas should be mounted. Make sure the array # Burn SD Card Image -The next step is to burn the KrakenSDR Direction Finding (DF) image to an SD Card. You will need an 8GB or larger card, and we recommend using class 10 or faster to ensure no file system slowdowns. +The next step is to burn the KrakenSDR Direction Finding (DF) image to an SD Card. For the Pi 4 image you will need an 8GB or larger card, and for the OPI5B image you will need a 16GB or larger card. We also recommend using class 10 or faster to ensure no file system slowdowns. 1. Using a PC, download the “Etcher” software from [balena.io/etcher](https://www.balena.io/etcher/). -2. Download the latest KrakenSDR image zip file from the [Releases page](https://github.com/krakenrf/krakensdr_doa/releases) in this repository, or via the links in the repository README. +2. Download the latest Pi 4 KrakenSDR image zip file from the [Releases page](https://github.com/krakenrf/krakensdr_doa/releases) in this repository, or via the links in the repository README. The latest OPI5B image can be downloaded from this [Google Drive link](https://drive.google.com/file/d/1ilco930ar0l3vYc2c7-vx_CWz3Ks0sf2/view?usp=sharing). 3. Use [Balena Etcher](https://www.balena.io/etcher/) to burn the image onto the SD Card. Using Etcher you can burn directly from the ZIP file. (There was a report that Etcher does not properly work on MacOS, MacOS users can try [Raspberry Pi's Imager](https://www.raspberrypi.com/software) instead) 4. Insert the card into your Raspberry Pi 4. @@ -66,8 +66,8 @@ The next steps show how to run the software and get connected to the Android app </p> 2. Plug the KrakenSDR power port into a 5V/2.4A+ capable supply and plug the data port into the Raspberry Pi 4. -3. Boot up the Raspberry Pi 4 with the KrakenSDR Direction Finding SD card image installed. Keep your phone within WiFi range of the Pi 4. Once booted, if the KrakenSDR hotspot is detected by the Pi 4, it will automatically connect to the hotspot. You should be able to see the device with hostname 'krakensdr' show up under 'Connected devices' once connected. -4. Using the 'Details' button in Mobile Hotspot (or the equivalent for your particular phone), determine the IP address of the connected Raspberry Pi 4. Google Pixel phones: It has come to our attention that Pixel phones do not have any ability to show IP addresses built in to the OS. You can try a Terminal Emulator App like [Termux](https://play.google.com/store/apps/details?id=com.termux). When the device is connected type in "ip neighb" to get the IP address of the connected device. If Termux does not work for you, try the Lan Scan feature in [Network Analyzer](https://play.google.com/store/apps/details?id=net.techet.netanalyzerlite.an&hl=en_US&gl=US). In both cases make sure WiFi is off, any only the mobile connection is active. +3. Boot up the Raspberry Pi 4 / OPI5B with the KrakenSDR Direction Finding SD card image installed. Keep your phone within WiFi range of the Pi 4 / OPI5B. Once booted, if the KrakenSDR hotspot is detected by the Pi 4 / OPI5B, it will automatically connect to the hotspot. You should be able to see the device with hostname 'krakensdr' show up under 'Connected devices' once connected. +4. Using the 'Details' button in Mobile Hotspot (or the equivalent for your particular phone), determine the IP address of the connected Raspberry Pi 4 / OPI5B. Google Pixel phones: It has come to our attention that Pixel phones do not have any ability to show IP addresses built in to the OS. You can try a Terminal Emulator App like [Termux](https://play.google.com/store/apps/details?id=com.termux). When the device is connected type in "ip neighb" to get the IP address of the connected device. If Termux does not work for you, try the Lan Scan feature in [Network Analyzer](https://play.google.com/store/apps/details?id=net.techet.netanalyzerlite.an&hl=en_US&gl=US). In both cases make sure WiFi is off, any only the mobile connection is active. <p align="center"> <img src="https://user-images.githubusercontent.com/78108016/170163391-598f00cd-4536-4a42-a694-5eb5ed0a160f.jpg" width="300"> @@ -75,7 +75,7 @@ The next steps show how to run the software and get connected to the Android app ### Start and Control the KrakenSDR -1. Open a browser and connect to IP_ADDR:8080, replacing IP_ADDR with the IP Address of the Pi 4 server. You should see the Web GUI load. If it doesn't load, wait another 1-2 minutes in case the Pi 4 system is still booting. +1. Open a browser and connect to IP_ADDR:8080, replacing IP_ADDR with the IP Address of the Pi 4 / OPI5B server. You should see the Web GUI load. If it doesn't load, wait another 1-2 minutes in case the Pi 4 / OPI5B system is still booting. 2. The KrakenSDR will automatically have started processing. Ensure that the Connection Status, Sample Delay Sync and IQ Sync indicators are all green, or all turn green after a few seconds if you opened the page during calibration, and that the Frame Index is increasing. 3. Set the desired center frequency, gain, antenna array radius configuration, and other settings like VFO bandwidth and squelch for the specific signal of interest. Make sure to apply the update by clicking on “Update Receiver Parameters” after changing the centre frequency or gain settings. 4. Check the Spectrum screen to ensure that your signal is being received as expected. @@ -84,10 +84,10 @@ The next steps show how to run the software and get connected to the Android app ## Alternative: Connect to Offline Pi 4 Hotspot -Alternatively, if you do not want to create a mobile WiFi hotspot with your phone (no data plan, no mobile reception etc) you can use the hotspot created by the Pi 4. But there will be no internet connection: +Alternatively, if you do not want to create a mobile WiFi hotspot with your phone (no data plan, no mobile reception etc) you can use the hotspot created by the Pi 4 / OPI5B. But there will be no internet connection: -1. Plug in your KrakenSDR power port to a 5V 2.4A capable supply and plug the data port into the Raspberry Pi 4. -2. Boot up the Raspberry Pi 4 with the KrakenSDR Direction Finding SD card image. The Pi 4 will create its own WiFi hotspot if it does not find any external hotspot it can connect to. +1. Plug in your KrakenSDR power port to a 5V 2.4A capable supply and plug the data port into the Raspberry Pi 4 / OPI5B. +2. Boot up the Raspberry Pi 4 / OPI5B with the KrakenSDR Direction Finding SD card image. The Pi 4 / OPI5B will create its own WiFi hotspot if it does not find any external hotspot it can connect to. 3. Open the KrakenSDR Android app, and use the download offline maps feature to download the maps for the region that you will be working in. 4. Connect to the KrakenSDR Wi-Fi hotspot on your Android device, with credentials krakensdr/krakensdr. 5. The IP address of the Hotspot is fixed at 192.168.50.5 @@ -99,7 +99,7 @@ Alternatively, if you do not want to create a mobile WiFi hotspot with your phon <img src="https://user-images.githubusercontent.com/78108016/170032817-2db99bae-3787-41f8-af12-2749614951f8.png" width="200" align="right"/> <img src="https://user-images.githubusercontent.com/78108016/170030726-35ee2dba-1530-4797-a2b3-38b2b4735b15.png" width="300" align="right" /> -1. Open the KrakenSDR Android app and enter the IP Address of the Pi 4 server in the settings. +1. Open the KrakenSDR Android app and enter the IP Address of the Pi 4 / OPI5B server in the settings. 2. Create a log file by pressing on the save button. 3. Press the Start DOA button to begin logging data and generating the heatmap. The start DOA button looks like a diagonal arrow and is in the bottom right of the screen. 4. Drive around to collect bearing data from multiple locations in order to triangulate the source. |