HawkEYE PLUS

Raspberry Pi installation

 

The instructions in this page will help you to (re) install the Pi in the HawkEYE PLUS to the same configuration it is in when it leaves mmix.

Any changes or updates to the configuration will also be placed on this page as they are implemented.

Once these Pi installation steps are complete you can then add Python support for the GPIO (SPI interface) and ST7735 TFTcontroller. The instructions are here.

Install and configure Raspbian

The Raspberry Pi 3 supplied with the HawkEYE PLUS is installed with Raspbian and the following configuration steps have been applied. These instructions will help you if you decide to re-install the Pi.

It is assumed that you have installed a Pi before and understand the steps needed. It is recommended that you perform the installation on a separate or "hosting" Raspberry Pi (not the one installed in the HawkEYE PLUS). This will be a lot easier for the initial part of the setup where you will require a USB keyboard and an HDMI cable connected to the Pi.


WARNING!   Before opening the HawkEYE PLUS you must disconnect the power and Relay connectors.


  1. Get the latest version of Raspbian Stretch Lite from the Raspberry Pi Download site.

  2. Install the operating system following the instructions on the Raspberry Pi installation page.

  3. Insert the Micro SD card into the hosting Pi then connect the HDMI, USB keyboard and network cable.

  4. Power on the hosting Pi and wait for the initial installation to complete.

  5. Login with the default credentials (pi, raspberry) and wait while the login completes. This first login can take upwards of 30 seconds to complete so be patient.

  6. Start raspi-config

    $ sudo raspi-config

    and change the keyboard layout to match the keyboard you are using. Do this from 4 Localisation Options and selecting I3 Change Keyboard Layout. First select the Keyboard model (the default is usually fine) and then select the layout from the provided list (you may need to choose Other to see the full list).

  7. Now it is safe to change the password for the current user (pi) to something very secure. This is an important security step to prevent hackers from being able to log in to your HawkEYE PLUS using the default credentials.

  8. Still within raspi-config, select 5 Interfacing Options and enable the SSH server by selecting P2 SSH. This is necessary so that you can connect to the Pi remotely once you have put the SD card into the HawkEYE PLUS.

  9. It is heavily recommended that you set a fixed IP address for the HawkEYE PLUS on your network so that it is easy to connect to and will help if access lists need to be changed on your firewall equipment. Follow the instructions from the Raspberry Pi Network training documentation using the information for your own network. If you decide to continue with a DHCP assigned address you will need to be able to locate the Pi's IP address after the SD card has been moved from the hosting Pi to the HawkEYE PLUS. There are some pointers for doing this in the Raspberry Pi documentation.

    Please note that although the Raspberry Pi 3 has WLAN capability it's use is not recommended as the metal box of the HawkEYE PLUS severely reduces the radio capabilities of the device.

  10. Update the Pi

    $ sudo apt-get update
    $ sudo apt-get upgrade

    Answer Y if prompted to continue. This may take several minutes to complete depending on how up to date the used installation image is.

  11. Shutdown the hosting Pi

    $ sudo shutdown now

  12. Move the SD card to the HawkEYE PLUS and connect the power connector

Configure the Pi hardware

The SPI interface needs to be enabled for communication with the HawkEYE PLUS and the TFT. There are also some recommendations to reduce the attack surfaces to hackers which also quieten the amount of radio noise emitted from the HawkEYE PLUS.


  1. Connect to the SSH server on the HawkEYE PLUS using the SSH client of your choice (PuTTY is recommended for Windows users).
  2. Enable the SPI interface by starting raspi-config

    $ sudo raspi-config

    and selecting 5 Interfacing Options and then P4 SPI.

  3. Optionally (recommended) disable the WIFI and Bluetooth devices by adding them to the Pi's kernel module blacklist.

    $ sudo nano /etc/modprobe.d/raspi-blacklist.conf

    Append the following lines to raspi-blacklist.conf

    #wifi
    blacklist brcmfmac
    blacklist brcmutil
    #bt
    blacklist btbcm
    blacklist hci_uart

    Close and save the raspi-blacklist.conf file

  4. Reboot the Pi

    $ sudo reboot

The Pi is now ready to communicate with the HawkEYE PLUS frequency monitorand the installed TFTdisplay.

Optional extras

These are some additional configuration steps that while not essential, may help with the daily use of the Pi in the HawkEYE plus.


  1. Configure a unique hostname on the Pi and add the Pi to your DNS servers.

    $ sudo raspi-config

    Select 2 Network Options and then N1 Hostname. Now enter your selected hostname and inform your network administrator of the name and ip address so that they can add it to your DNS.

  2. Select the correct Timezone for your Pi.

    $ sudo raspi-config

    Select 4 Localisation Options and then I2 Change Timezone. Follow the instructions to select the correct time zone for the location of the HawkEYE PLUS.
  3. Ensure all of the SD card is being used for the Pi.

    $ sudo raspi-config

    Select 7 Advanced Options and then A1 Expand Filesystem. All of the SD card will be available after the next reboot.