Cosmic Pi V1.5 Setup Instructions

Getting started – how to set up your unit

Congratulations if you have received a Cosmic Pi V1.5 unit. Setting it up is very simple, just follow this guide! If you get stuck please check www.cosmicpi.org for help or to get in touch with us.

 

Setup procedure:

1)               Remove the unit from the packaging and place on a flat surface.

2)               Open the GPS antenna packet and screw the SMA connector to the GPS port on the unit front, indicated by the arrow. The GPS antenna must be able to see the sky (place it on a window sill or carefully pass it through an open window) in order to work.

3)               Unwrap the power adapter and plug it in to the power port on the unit, indicated by the arrow.

4)               Connect the power adapter to a socket outlet. The unit will power up and the Power and Event lights will illuminate. The power light will remain constantly illuminated until a GPS fix is obtained (up to 5 minutes, depending upon conditions), while the event light will flash each time a cosmic ray is detected.

5)               To activate the web interface you will need to log on to the device using Wi-Fi. There are two ways which this can be done, either with a Wi-Fi network or Android phone.

 

 

Connection Method 1 – Using an android phone with a data connection (mobile data)

 

Enable the mobile hotspot connection on your telephone. Configure the access point to have the name “CosmicPiTest”. The unit will connect automatically and depending upon the version of Android you are using, the connection will be indicated on your mobile hotspot screen, together with the IP address allocated to the Cosmic Pi. The Cosmic Pi unit has the host name “cosmicpi” to allow you to differentiate it from other devices which might be connected to your hotspot.

Once connected to the hotspot you should connect via SSH. This can be done using an SSH application, such as JuiceSSH, connectbot or SSHDroid which are available free from the Google playstore. The login details for the device are indicated by a sticker on the back of your unit.

When connected you will be presented with the cryptographic hash representing the unique identity of your Cosmic Pi. Please accept this identity in order to connect. Once connected you will be greeted by the prompt “cosmicpi@cosmicpi:~$”.

 

At the prompt you should enter the following commands:

1)               To check the internet connectivity

ping cern.ch –c 5

You should be presented with the ping times for 5 packets, followed by a summary of the packet loss. If the loss is 0%, you are connected correctly to the internet and may proceed to the next stage. If the ping is not successful check your internet connection.

2)               To install the graphical user interface (web)

git clone https://github.com/CosmicPi/cosmicpi-rpi_V1.5

cd cosmicpi-rpi_V1.5

chmod +x install

sudo ./install

The installer will now take over and the unit will reboot when completed. When the installation is completed you should turn off your wireless hotspot. You will be able to complete the configuration of your unit with a web browser by connecting to the “CosmicPi” wireless network and navigating to the address http://cosmicpi.local or http://192.168.12.1 in your browser. For best results use Google Chrome, Chromium or Firefox.

 

Method 2 – Using a fixed wireless connection (wireless access point with internet access) and a computer with a Wi-Fi adapter

 

Connect to the “CosmicPi” wireless network with your computer. Note that while you are connected to the Cosmic Pi Wi-Fi access point you will not be able to access the internet.

Connect to the Cosmic Pi via SSH. This can be done via any SSH client:

In Windows you can make SSH connections via putty:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

On an Apple or Linux computer the SSH client is included in the standard distribution and is accessible via terminal.  At the terminal type: “SSH cosmicpi@10.0.0.1” to connect

The login details for the device are indicated by a sticker on the back of your unit.

 

When connected you will be presented with the cryptographic hash representing the unique identity of your Cosmic Pi. Please accept this identity in order to connect. Once connected you will be greeted by the prompt “cosmicpi@cosmicpi:~$”.

To connect to a fixed wireless network you should enter the following command at the terminal:

sudo raspi-config

From the menu select the Network option and then choose connect to wireless network. The interface will prompt you to enter the identity of the wireless network (SSID) and any access credentials. Unsecured, WEP, WPA and WPA-2 networks are all supported by the device. When you have entered the credentials you can exit the configuration utility and return to the command prompt. Enter the following command to reboot and connect to your fixed wireless infrastructure:

sudo reboot now

The SSH connection will be severed and the “CosmicPi” Wi-Fi access point will disappear. Upon reboot the Cosmic Pi will connect to your fixed network. If the connection is unsuccessful then the unit will re-create the “CosmicPi” Wi-Fi access point to enable you to try again.

When the Cosmic Pi is connected to your fixed wireless connection you can re-connect via SSH using either the address “cosmicpi.local” or the IP address allocated by your router or DHCP server (this can be found by connecting to your router to view connected devices and current DHCP leases).

You can now re-connect to the Cosmic Pi and complete the update procedure as follows:

At the prompt you should enter the following commands:

1)               To check the internet connectivity

ping cern.ch –c 5

You should be presented with the ping times for 5 packets, followed by a summary of the packet loss. If the loss is 0%, you are connected correctly to the internet and may proceed to the next stage. If the ping is not successful check your internet connection.

2)               To install the graphical user interface (web)

git clone https://github.com/CosmicPi/cosmicpi-rpi_V1.5

cd cosmicpi-rpi_V1.5

chmod +x install

sudo ./install

The installer will now take over and the unit will reboot when completed. You will be able to connect and view the data generated of your unit with a web browser connected to your fixed Wi-Fi network, navigating to the address http://cosmicpi.local or http://192.168.12.1 in your browser. For best results use Google Chrome, Chromium or Firefox.