Radarcape:Installation Guide: Difference between revisions

From Beast Wiki
Jump to navigation Jump to search
imported>Dl4mea
Nunojpg (talk | contribs)
No edit summary
 
(60 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__TOC__
{{#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]]
|[[File:Beginner.png|For Beginners]]
|''The tasks described in this manual require little to medium Unix/Linux experience.''
|''Required computer skills to execute these tasks: Beginner''
|}
|}


=Connect Radarcape Hardware=
__TOC__
 
=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
* GPS antenna
* Ethernet/LAN cable
* Power cable


# Mode-S antenna
Connect the power supply with the electrical outlet.
# 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.


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


==Some words about the Radarcape as a network device - the HOSTNAME==
==GPS Antenna Placement==


In an network environment there are basically two ways how to identify a device
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.
* hostname, which is a text string, a given name
* IP address, something like 192.168.1.157


The '''IP address''' is given to your device during startup from either a DHPC server or from predefined fixed settings. Mostly your DSL or internet router is also working as DHCP. You can look into your router's user interface, IP list, in order to obtain the Radarcape's IP address. Mind that the IP address is only unique in your network segment. If behind a firewall or router, your devices might be summarized under one common and different IP address. That is when port mapping plays a role.<br \>Fixed IP addresses are currently only available by reconfiguring the Linux, you will find plenty of information here in the internet. Mind that the Radarcape normally runs with Linux 3.8 or later.
=First time access to the web interface=


The '''hostname''' is a given name internally in your device (it is located in the file /etc/hostname). During the process of getting the IP address, the devices tells the DHCP server its name. If there is no label on the back side of your Radarcape, the hostname is always '''''radarcape'''''. Other names might be '''''rc<nn>''''', with <nn> beeing a number.
The typical way to access the device is via a Ethernet connection to a Router/Switch.


This is how you identify your device in the network. Take care on an probable issue with Windows, described here [[Radarcape:ConnectivityFailures]]
If your network have DHCP enabled your device will obtain a IP address automatically.


We will develop a Radarcape finder pretty soon, so you don't have do obtain it in this manual ways.
If your network does not have DHCP enable, continue to USB network access.


==Configuration Interfaces==
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.


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


==Get DNS Name and IP Address of the Radarcape==
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]).


The Radarcape obtains its IP address via DHCP. Usually, the Internet router provides [http://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] services in small networks (e.g., home network) and a list of distributed IP addresses can be obtained via its web interface.
Additionally on the Air!Squitter you can use the [[Radarcape:OLED_display|front panel OLED display]] to check the assigned IP address.


==Set Root Password==
=USB network access=


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. Please remind 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.
'''NOTE: you need a Debian 10 image to use this feature'''


First you must login to your Radarcape via [http://en.wikipedia.org/wiki/Secure_Shell SSH].
The Radarcape/Air!Squitter exposes a USB RNDIS network interface, compatible with typical Linux Distributions and Windows 7 and Windows 10.


* Windows users can use the free SSH client [http://www.putty.org Putty].
Plug the device into your computer and access it from a Web Browser at http://192.168.73.1
* Linux/Unix users may use SSH from the command line.


<source lang="bash">ssh [email protected]</source>
=Wi-Fi Access Point Access=


Please replace ''rs11.home'' with the DNS name or IP address of your personal Radarcape.
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.


An initial root password has not been set. Therefore, you can login with user ''root'' and no password.
=Login to the Radarcape/Air!Squitter Web Interface=


After you have logged in on your Radarcape, you can set a new ''root'' password with the following command:
The default credentials for the device web interface are:


<source lang="bash">passwd</source>
* User: Administrator
* Password: radarcape


[[File:PasswordChange.png|550px|Radarcape Password Change]]
'''NOTE: the password is also radarcape for the Air!Squitter'''


The message ''passwd: password updated successfully'' will indicate that the new password has been set.
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.