Radarcape:Installation Guide: Difference between revisions

From Beast Wiki
Jump to navigation Jump to search
imported>Beastadmin
No edit summary
No edit summary
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{#seo:
|title=Radarcape Installation Guide
|titlemode=replace
|keywords=radarcape,installation,guide,help,support
|description=How to install and configure the Radarcape
}}
{|
|[[File:Beginner.png|For Beginners]]
|''Required computer skills to execute these tasks: Beginner''
|}
__TOC__
__TOC__


=Connect Radarcape Hardware=
=Radarcape Hardware Installation=


[[File:Radarcape-back.png|450px|Radarcape backside explained]]
[[File:Radarcape-back.png|450px|Radarcape backside explained]]




Plug the following connectors into the Radarcape
Plug the following connectors into the Radarcape:
 
* Mode-S antenna
# Mode-S antenna
* GPS antenna
# GPS antenna
* Ethernet/LAN cable
# Ethernet/LAN cable
* Power cable
# Power cable


Connect the power supply with the electrical outlet.
Connect the power supply with the electrical outlet.


=Antenna placement=
=Mode-S-Antenna Placement=
 
==Mode-S Antenna==


The Mode-S antenna should be placed as free and as high as possible.
The Mode-S antenna should be placed as free and as high as possible.


==GPS Antenna==
Make sure the Mode-S antenna has a conductive connection with protective ground. Otherwise, static electricity may cause damage to your Radarcape.
 
The GPS antenna should be placed to a point with at least half of the sky in free sight, for example a window sill.
 
Some users reported running the GPS antenna indoors. This is not guaranteed to work.
 
=Software Configuration=
 
==The Radarcape as a network device - the hostname or DNS name==
 
Network devices can be accessed in two ways:
* via '''IP address''' (e.g., ''192.168.1.157'')
* via '''hostname''' (e.g., ''radarcape'')
 
The '''IP address''' is provided to your Radarcape either during startup via the [http://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol Dynamic Host Configuration Protocol] (DHCP) service or a fixed address can be set on the device. Automatic configuration via DHCP is the default configuration of the Radarcape. Usually, your internet router provides the DHCP service in your network and assignes an IP address to your device. Fixed addresses can be assigned configured via the Linux command line. For the configuration of a fixed IP address, please refer to one of the Linux manuals you can find in the Internet.
 
The '''hostname''' is a given name that is stored internally in your device (see ''/etc/hostname''). If there is no label on the back side of your Radarcape, the hostname is either '''''radarcape'''''.
 
Most internet routers provide the DHCP and [http://en.wikipedia.org/wiki/Domain_Name_System Domain Name System] (DNS) services for local network devices. The DHCP service automatically asignes IP adresses in local networks. DNS is used by clients (e.g., your browser) to resolve host names to IP addresses. During the boot sequence, the radarcape requests an IP address from this DHCP service. It also reports it's hostname to the DHCP service on the router. At this stage, most routers automatically update their DNS database with the hostname and the IP address of your radarcape. This is strongly required if you want to access your Radarcape via the hostname.
 
If you are not able to access your Radarcape via the hostname, usually the DNS service has not been updated. Some internet routers do not support this feature. In this case you can access the Radarcape via it's IP address. To obtain the IP address, open the Web interface of your internet router. Usually, it will contain a page that lists all IP addresses that were assigned by the DHCP service.
 
This is how you identify your device in the network. Take care on an probable issue with Windows, described here [[Radarcape:ConnectivityFailures]]
 
We will develop a Radarcape finder pretty soon, so you don't have do obtain it in this manual ways.
 
{| class="wikitable"
|[[File:dhcp_ddwrt.jpg|500px|thumb|DHCP listing of a DD-WRT router showing hostnames RC70 and RC71 as 192.168.1.180 and 192.168.1.133]]
|[[File:dhcp_fritzbox.jpg|500px|thumb|DHCP listing of a Fritzbox showing hostname RC23 as 192.168.178.36]]
|}
 
==Software Configuration==
 
The Radarcape configuration can be modified via the Web interface.
 
===Basestation and Flightroute Databases===
 
The Radarcape can use external databases for displaying additional information to the 2D map and the aircraft list.
 
* '''basestation.sqb''': aircraft ''type'' and ''registration''.
* '''flightroutes.sqb''': flightplan information (''origin'' and ''destination'')
 
These databases are not installed when we ship the Radarcape. Users can download and install them from third-party sources. This can be done via the ''Software Maintenance'' menu.
 
[[File:Radarcape Software Maintenance.png|550px|none|thumb|Radarcape Software Maintenance]]
 
The databases can be obtained from these sources:
 
* [http://planebase.biz Plane Base NG] (basestation.sqb)
* [http://pp-sqb.mantma.co.uk/download.php ManTMA] (basestation.sqb)
* [http://groups.yahoo.com/neo/groups/PP-logs-and-routes/files PP Routes Yahoo Group] (flightroutes.sqb, registration required)
 
As both databases contain information that is subject to change, we recommend you to update these databases in regular intervals.
 
===Settings Web Page===


Various configuration settings can be made on the ''Settings'' menu.
==GPS Antenna Placement==


[[File:Radarcape-webconfig.jpg|750px|none|thumb|Radarcape Settings Web Page]]
The GPS antenna should be placed to a point with at least half of the sky in free sight, for example a window sill. Some users reported running the GPS antenna indoors. This is not guaranteed to work.


===Advanced Configuration Interfaces / Commandline Access===
=First time access to the web interface=


There are two ways how to connect to the Linux system:
The typical way to access the device is via a Ethernet connection to a Router/Switch.
* SSH through the network
* Back side Mini USB connector


===Set Root Password===
If your network have DHCP enabled your device will obtain a IP address automatically.


In the default configuration, no password is set for the root user (administrator) on the Radarcape. We strongly advise you to set a password for security reasons in case that you are not sure if externals can access your network segment. Please remember your password as there is currently no other password recovery method than [[Radarcape:SD Card Howto|creating a new SD card]] image for your Radarcape.
If your network does not have DHCP enable, continue to USB network access.


First you must login to your Radarcape via [http://en.wikipedia.org/wiki/Secure_Shell SSH].
After connecting the device you should be able to access it from a Web Browser at http://radarcape or http://radarcape.local. If you have a Air!Squitter use http://air-squitter or http://air-squitter.local.


* Windows users can use the free SSH client [http://www.putty.org Putty].
If you are unsuccessful accessing by name you need to find the IP address of the device.
* Linux/Unix users may use SSH from the command line.


<source lang="bash">ssh root@rc11.home</source>
To find the IP address you should access your DHCP server assignment table (for example at your local Home Gateway/Router or by contacting your Network administrator), or by using a mDNS/Bonjour smartphone app (eg. [https://play.google.com/store/apps/details?id=de.wellenvogel.bonjourbrowser Bonjour Browser]).


Please replace ''rc11.home'' with the DNS name or IP address of your personal Radarcape.
Additionally on the Air!Squitter you can use the [[Radarcape:OLED_display|front panel OLED display]] to check the assigned IP address.


An initial root password has not been set. Therefore, you can login with user ''root'' and no password.
=USB network access=


After you have logged in on your Radarcape, you can set a new ''root'' password with the following command:
'''NOTE: you need a Debian 10 image to use this feature'''


<source lang="bash">passwd</source>
The Radarcape/Air!Squitter exposes a USB RNDIS network interface, compatible with typical Linux Distributions and Windows 7 and Windows 10.


[[File:PasswordChange.png|550px|none|thumb|Radarcape Password Change]]
Plug the device into your computer and access it from a Web Browser at http://192.168.73.1


=Wi-Fi Access Point Access=


With the Air!Squitter in addition you can use the Wi-Fi Access Point Mode and connect over Wi-Fi with a smartphone or computer. To enable the Wi-Fi Access Point use the [[Radarcape:OLED_display|front panel OLED display]]. After enabling you can connect to the device with a Web Browser at http://192.168.73.1.


=Login to the Radarcape/Air!Squitter Web Interface=


The message ''passwd: password updated successfully'' will indicate that the new password has been set.
The default credentials for the device web interface are:


* User: Administrator
* Password: radarcape


----
'''NOTE: the password is also radarcape for the Air!Squitter'''


[[Radarcape:Contents]]
We strongly recommend you to '''change your password''' after the first login! For that select ''Configuration'' > ''Change Password'' in the Web configuration menu.

Latest revision as of 15:53, 20 November 2019


For Beginners Required computer skills to execute these tasks: Beginner

Radarcape Hardware Installation

Radarcape backside explained


Plug the following connectors into the Radarcape:

  • Mode-S antenna
  • GPS antenna
  • Ethernet/LAN cable
  • Power cable

Connect the power supply with the electrical outlet.

Mode-S-Antenna Placement

The Mode-S antenna should be placed as free and as high as possible.

Make sure the Mode-S antenna has a conductive connection with protective ground. Otherwise, static electricity may cause damage to your Radarcape.

GPS Antenna Placement

The GPS antenna should be placed to a point with at least half of the sky in free sight, for example a window sill. Some users reported running the GPS antenna indoors. This is not guaranteed to work.

First time access to the web interface

The typical way to access the device is via a Ethernet connection to a Router/Switch.

If your network have DHCP enabled your device will obtain a IP address automatically.

If your network does not have DHCP enable, continue to USB network access.

After connecting the device you should be able to access it from a Web Browser at http://radarcape or http://radarcape.local. If you have a Air!Squitter use http://air-squitter or http://air-squitter.local.

If you are unsuccessful accessing by name you need to find the IP address of the device.

To find the IP address you should access your DHCP server assignment table (for example at your local Home Gateway/Router or by contacting your Network administrator), or by using a mDNS/Bonjour smartphone app (eg. Bonjour Browser).

Additionally on the Air!Squitter you can use the front panel OLED display to check the assigned IP address.

USB network access

NOTE: you need a Debian 10 image to use this feature

The Radarcape/Air!Squitter exposes a USB RNDIS network interface, compatible with typical Linux Distributions and Windows 7 and Windows 10.

Plug the device into your computer and access it from a Web Browser at http://192.168.73.1

Wi-Fi Access Point Access

With the Air!Squitter in addition you can use the Wi-Fi Access Point Mode and connect over Wi-Fi with a smartphone or computer. To enable the Wi-Fi Access Point use the front panel OLED display. After enabling you can connect to the device with a Web Browser at http://192.168.73.1.

Login to the Radarcape/Air!Squitter Web Interface

The default credentials for the device web interface are:

  • User: Administrator
  • Password: radarcape

NOTE: the password is also radarcape for the Air!Squitter

We strongly recommend you to change your password after the first login! For that select Configuration > Change Password in the Web configuration menu.