Getting started with the GOOSE PC platform

A PC with Linux has to be set up in order to use GOOSE in a PC through the PCIe port. In order to set up the PC follow these steps:

Setup the GOOSE PC platform

1. Install supported Operating Systems: Ubuntu 16.04 LTS (Xenial Xerus) 64Bit

   • Download latest LTS version of https://www.ubuntu.com/download/desktop
   • Flash the ISO into a USB. i.e. under Linux: dd if=ubuntu.iso of=/dev/sdb
   • Boot PC from USB drive and install Ubuntu.
   • Upgrade Ubuntu installation: sudo apt update && sudo apt dist-upgrade
   • Installl SSH server and dependencies for GOOSE: sudo apt install python-numpy libjsoncpp1 libzmqpp3 openssh-server
   • Install latest build_goose_ubuntu sudo dpkg -i goose-1.x.0-xx-xxx-Linux.deb

2. Unmount the GOOSE LNA board with antenna and disconnect the MMCX cable

3. Replace the Single Board Computer (SBC) by the delivered riser card and connect the MMCX cable

4. Connect the prepared setup to a free PCIexpress slot of the PC. After the GOOSE board is updated and plugged in to the PCIe port on the computer, the PC has to recognize the new PCIe device. To make sure that the device is recognized you can list the pci devices:

   pci | grep -i xilinx
   

   • A line containing the name and id of the XIlinx device can be seen.

   • Type the following command to check if pci module is correctly initialized by its corresponding driver

   lspci -vv -k
   

   Memory controller: Xilinx Corporation Device 7024
   Subsystem: Xilinx Corporation Device 0007
   Control: I/O+ Mem+ BusMaster+ SpecCycle- MemWINV- VGASnoop- ParErr- Stepping- SERR- FastB2B- DisINTx-
   

   • Please note that the below mention options should be enabled, where + here shows enable and - shows disable.

   I/O+ Mem+ BusMaster+
   

   • If they are disabled type the following command to make them enable.

   sudo setpci -d 10ee:7024 COMMAND=0007
   

   • Check again if these configurations are properly enabled.
   • The PCIe GOOSE board is added as a new interface /dev/fhgpcie which needs to be added to the dialout group:

   sudo chown root:dialout /dev/fhgpcie
   

5. Connect an antenna to the SMA connector (backplane riser card)

6. Download the GOOSE Debian package for x86/64: https://github.com/Fraunhofer-IIS/ogre/releases

7. Install the package on the PC: sudo dpkg -i PACKAGE_NAME

8. Install the package dependencies: sudo apt-get -y -f install

9. Add the user to the group "dialout": sudo usermod -a -G USERNAME dialout

10. Reboot

11. Enable/disable antenna power (4.5V DC, max. 80mA). It is disabled by default. Overcurrent is indicated by the LED on the front-end board (V603).

    antenna_power_on
    antenna_power_off
    

12. Check the gain of the front-end with read_sample_rec. If it shows no Gaussian distribution, press the reset button on the front-end board (S400). With the -s option the signal can be selected.

    (goose-arm-rootfs-build)root@goose:~# read_sample_rec -s E1
    sh: 1: /usr/bin/lsof: not found
    finished
    -8|o
    -7|o
    -6|o
    -5|o
    -4|--o
    -3|--------------o
    -2|--------------------------------------------o
    -1|-------------------------------------------------------------------------------o
     0|-----------------------------------------------------------------------------o
     1|------------------------------------------o
     2|-------------o
     3|-o
     4|o
     5|o
     6|o
     7|o
    

    (goose-arm-rootfs-build)root@goose:~# read_sample_rec -s E5
    sh: 1: /usr/bin/lsof: not found
    finished
    -8|o
    -7|o
    -6|o
    -5|o
    -4|--o
    -3|---------------o
    -2|---------------------------------------------o
    -1|-------------------------------------------------------------------------------o
    0|------------------------------------------------------------------------------o
    1|-------------------------------------------o
    2|-------------o
    3|--o
    4|o
    5|o
    6|o
    7|o
    

13. The receiver program is called ogre_console. Different GNSS systems and the corresponding signals can be enabled/disabled and the receiver program can streams the measurement data to STDOUT, TCP or zeromq. To see all the option type

    ogre_console --help
    

14. The output format of the receiver is OGRP. See https://github.com/Fraunhofer-IIS/ogrp.

15. If you want access remotely to the GOOSE PC the package openssh-server has to be installed.