Difference between revisions of "DreamCatcher"

From RadioNerds
Jump to navigation Jump to search
Line 12: Line 12:
  
 
==Burning the image to an SD Card==
 
==Burning the image to an SD Card==
 +
A microSD greater than 4GB in size is required.
  
−
A microSD greater than 4GB in size is required. The latest Armbian image for Dreamcatcher is found here:
+
===Extract the image===
−
https://archive.outernet.is/images/
+
It is compressed using "gzip.", many common Unzipping tools on your chosen OS can un-compress these. 
−
Instructions:
 
−
1. Extract the image. it is compressed using "gzip." You can use gunzip on Linux or 7zip on Windows to extract it:
 
  
−
gunzip image_name.img.gz
+
;Linux / OSx
 +
:gunzip [filename.gz]
  
−
2. Write the image to the SD card using any normal writing process.
+
;Windows
−
On Linux you can use  
+
:use 7Zip
  
−
sudo dd if=image_name.img of=/dev/device bs=4M status=progress ; sync ; sync; sync
 
  
−
device can be obtained by inserting SD card and then immediately checking the
+
===Write the image to the SD card===
−
output of "dmesg | tail". Or just use "usb image creator" on windows/linux etc. Detailed instructions can be found on RPI website:
 
  
−
Linux: https://www.raspberrypi.org/documentation/installation/installing-images/linux.md
+
the best way to burn the SD card is by using etcher here---> https://etcher.io/
−
Windows: https://www.raspberrypi.org/documentation/installation/installing-images/windows.md
 
−
Mac: https://www.raspberrypi.org/documentation/installation/installing-images/mac.md
 
  
−
3. Insert SD card into Dreamcatcher board slot marked "SD0_OS," next to LED array.
 
−
Make sure wifi dongle is also inserted already. Attach uart (optional, only needed if you have trouble booting). Boot dreamcatcher by powering it using microusb. It should start booting as soon as power is applied. If not, press the "power" button for a couple seconds.
 
  
−
4a. On uart, you should arrive at regular "Dreamcatcher login:" prompt. If you see anything related to "panic", rebooting, etc, instead of the login prompt, and board keeps rebooting,
 
−
your sdcard is corrupt and you need to burn it again. Or use another card. Make sure you use atleast 4GB sdcard, and a fast, good quality one.
 
  
−
4b. The image also supports console on usb-serial. This is the easiest way to initially setup the board after burning a new sdcard. Insert the OS sdcard and connect the board via microusb to your Laptop/PC. Once the board finishes booting up (takes about a minute), you should be able to see ttyACM0 device (on linux). You can access it using any serial terminal programs like picocom, minicom, screen or putty (on windows, for example).
 
  
−
5. Use "root" as username and "1234" as password. On first login, it will ask for new password and change root password. It will also ask for a new username to create a regular user, and for user password and other info. You can just press "enter" for the other info (but not for the  new username or password). This user is what you should login as normally.
 
−
Recommend you use outernet and outernet as username/password for this, so you don't forget.
 
−
(unless you plan to expose the board to outside your Lan, in which case use more secure settings!)
 
  
−
6. To connect to wifi network, use command line:
+
===Startup the DreamCatcher with Armbian Distro===
 +
 
 +
1) Insert SD card into Dreamcatcher board slot marked "SD0_OS," next to LED array.  
 +
 
 +
2) insert the USB Wifi Dongle, or other USB network device if you have it.
 +
 
 +
3) Optionally - connect the USB Cable to your PC with a terminal application open.
 +
 
 +
4) connect power to a USB port, or alternatively the USB cable to PC can provide power
 +
 
 +
after the bootup process you should see a "Dreamcatcher Login:" prompt
 +
 
 +
;Default Username
 +
:root
 +
;Default Password
 +
:1234
 +
 
 +
 
 +
===Configure Wifi===
 +
To connect to wifi network, use command line:
  
 
nmcli d wifi connect your_ssid password your_password
 
nmcli d wifi connect your_ssid password your_password
Line 59: Line 66:
 
SSID/password, once configured, will be stored, and should be applied automatically at next boot.
 
SSID/password, once configured, will be stored, and should be applied automatically at next boot.
  
−
7. To install librtlsdr and sdr utilities like rtl_fm etc, use:
+
 
 +
===Install The RTL-SDR Libraires and Utilities===
 +
To install librtlsdr and sdr utilities like rtl_fm etc, use:
  
 
apt update; apt install rtl-sdr
 
apt update; apt install rtl-sdr
Line 65: Line 74:
 
(you will need to have already connected to network for this to work)
 
(you will need to have already connected to network for this to work)
  
−
8. Note that unlike Skylark, the root filesystem here is modified and is writeable, so it is important you shut this down properly:
+
 
 +
===Shutting Down===
 +
Unlike Skylark, the root filesystem here is modified and is writeable, so it is important you shut this down properly:
  
 
sudo poweroff
 
sudo poweroff
  
−
Chances of corrupting your sdcard are much higher than in skylark. Use a good sdcard.
 
−
 
−
9. This is regular debian. apt update, apt upgrade, etc should all work as normal.
 
−
 
−
10. LEDs: The leds from the SMA connector down to Sdcard slot, in order:
 
  
−
a. USB HUB Enable: green LED, on when the usb hub is on. On by default at boot.
 
−
to turn off:
 
  
−
echo 0 | sudo tee /sys/class/leds/usbhuben/brightness
+
==BOARD LEDS==
 +
The LEDs from the SMA connector down to Sd card slot, in order:
  
−
(this will also turn off the usb hub: no rtlsdr, no wifi!)
+
;USB HUB
 +
:Enable = green
 +
:This is Turned on when the usb hub is on.
 +
:Default at boot: ON.
 +
:To turn off: echo 0 | sudo tee /sys/class/leds/usbhuben/brightness (this will also turn off the usb hub: no rtlsdr, no wifi!)
  
−
b. Packet indicator: flashes when Outernet packets are received. Unused under armbian. Default off.
+
;Packet indicator:
 +
:flashes when Outernet packets are received.  
 +
:Default at boot: OFF
 +
:Unused under armbian
  
−
c. Lock indicator: On when there is a signal lock. Unused under Armbian. Default off.  
+
;Lock indicator:
 +
:On when there is a signal lock.  
 +
:Default at boot: OFF
 +
Unused under Armbian.  
  
 
d. SNR1, SNR2, SNR3, SNR4: SNR indicators, unused under Armbian. Default off.
 
d. SNR1, SNR2, SNR3, SNR4: SNR indicators, unused under Armbian. Default off.

Revision as of 19:13, 13 July 2017

Setting up the OS

There are two OSs that you can use on the DreamCatcher.

Armbian
Standard ARM Linux OS based on Debian, Highly supported but does NOT have build in support for Outernet. This OS requires lots of tweaking to up and going...
Compress_plain_32x32.png Armbian for DreamCatcher, V5.27


Skylark
Os based on Busybox is read only and has the full Outernet system ready to go. This is the one to use if you want to play with outernet with no tweaking
Compress_plain_32x32.png Skylark, for the Passive Antenna, Released May 14, 2017
Compress_plain_32x32.png Skylark, for the Active Antenna, Released June 22, 2017

Burning the image to an SD Card

A microSD greater than 4GB in size is required.

Extract the image

It is compressed using "gzip.", many common Unzipping tools on your chosen OS can un-compress these.

Linux / OSx
gunzip [filename.gz]
Windows
use 7Zip


Write the image to the SD card

the best way to burn the SD card is by using etcher here---> https://etcher.io/



Startup the DreamCatcher with Armbian Distro

1) Insert SD card into Dreamcatcher board slot marked "SD0_OS," next to LED array.

2) insert the USB Wifi Dongle, or other USB network device if you have it.

3) Optionally - connect the USB Cable to your PC with a terminal application open.

4) connect power to a USB port, or alternatively the USB cable to PC can provide power

after the bootup process you should see a "Dreamcatcher Login:" prompt

Default Username
root
Default Password
1234


Configure Wifi

To connect to wifi network, use command line:

nmcli d wifi connect your_ssid password your_password

or using the text UI:

nmtui


to check assigned ip use:

/sbin/ifconfig

SSID/password, once configured, will be stored, and should be applied automatically at next boot.


Install The RTL-SDR Libraires and Utilities

To install librtlsdr and sdr utilities like rtl_fm etc, use:

apt update; apt install rtl-sdr

(you will need to have already connected to network for this to work)


Shutting Down

Unlike Skylark, the root filesystem here is modified and is writeable, so it is important you shut this down properly:

sudo poweroff


BOARD LEDS

The LEDs from the SMA connector down to Sd card slot, in order:

USB HUB
Enable = green
This is Turned on when the usb hub is on.
Default at boot: ON.
To turn off: echo 0 | sudo tee /sys/class/leds/usbhuben/brightness (this will also turn off the usb hub: no rtlsdr, no wifi!)
Packet indicator
flashes when Outernet packets are received.
Default at boot: OFF
Unused under armbian
Lock indicator
On when there is a signal lock.
Default at boot: OFF

Unused under Armbian.

d. SNR1, SNR2, SNR3, SNR4: SNR indicators, unused under Armbian. Default off.

e. USR1: sdcard activity indicator. equivalent of the HDD activity light on laptops/desktops

f. USR2: heartbeat: flashes when kernel is booted and working normally. The flash pattern is:

long off, N short flashes, long off, repeat.

N = 2 * loadavg.

g. Power: White LED, on when board is powered.

11. The default armbian image enables the "LNA bypass" RF input port, to allow usage as a normal, unfiltered RTLSDR. to switch to the Outernet LNA (L Band) RF input:

echo 0 | sudo tee /sys/class/leds/rfswitch1/brightness echo 1 | sudo tee /sys/class/leds/rfswitch2/brightness


ONDD Setup

FTP to a DreamCatcher, copy the following files off of the system... be SURE to FORCE binary transfer.
/usr/sbin/ondd (md5:207723be33f4da57bd64a6549e11e95d)
/usr/sbin/ontimeout (md5:5092f17f0152ca352799290999ba7a6c)


Create an empty conf file
/etc/ondd/ondd.conf
Create a place to place downloads
/home/downloads (or wherever)
Create a place for download cache
/home/download_cache
Run ondd with the following command:
/usr/sbin/ondd -d --pid_file /var/run/ondd.pid --cfg-gile [empty cfg file you created] -c [location for download cache] -o [location for completed downloads] -D /var/run/ondd.data --sdr-timeout-handler /usr/sbin/ontimeout

Command Help

[Skylark][outernet@outernet:/usr/sbin]$ /usr/sbin/ondd -h

00:11:21.099 [main] Unable to load config: /etc/ondd.conf (null)
Usage: ondd
--cfg-file CONFIG_FILE override default config file location
--pid-file PID_FILE override default pid file location
--ctrl-sock SOCK_FILE override default control socket path used for ipc
--status-sock SOCK_FILE override default status report socket path - status e
--cert-file CERT_FILE override default ceritificate file location
-D SOCK_FILE data socket path to which the demodulator sends raw s
--sdr-timeout-handler script to execute if no data arrives through the date
-o PATH path to output directory where downloaded files are d
-c PATH path to cache directory where partially downloaded fd
-O PATH if specified, files which path does not begin with td
-b N set the maximum number of download completion eventsy
-d start ondd in daemon mode
-i print to stdout the current signal strength and snr,d
-V enable verbose mode
-v display ondd version info
-h display this helptext
Retrieved from "http://www.radionerds.com/index.php?title=DreamCatcher&oldid=24318"