industrial solutions - ugcs · ugcs ucs custom payload monitor wi-fi usb uart / rs-232 figure 1.1...

83
Industrial Solutions SkyHub User Manual industrial.ugcs.com September 2020 Revision 4

Upload: others

Post on 26-Jan-2021

5 views

Category:

Documents


0 download

TRANSCRIPT

  • Industrial Solutions

    SkyHubUser Manual

    industrial.ugcs.comSeptember 2020 Revision 4

  • Revision History

    Revision Date Description

    4 05.11.2020 • Added the True Terrain Following v2.0 settings• Added the resuming and pausing TTF from UgCS-CPM

    description• Added the Geonics EM-61 metal detector description• Added the IGNORE_ERRORS to common altimeter settings• Added the SEG-Y Postprocessing Tool description• Changed the MAV/COMPONENT_ID default value• Changed the default DJI flight mode for Grasshopper• Updated the minimum required UgCS-CPM version• Updated the table of contents• Removed the MAX_FLIGHT_SPEED_MPS config parameter

    3 03.09.2020 • Added the ArduPilot connection description• Added the Grasshopper Mode• Added the firmware uninstalling description• Added the payload plugin start delay description• Added the Lighware SF11/C laser altimeter description• Changed default Payload and Autopilot plugins loading

    settings to false• Updated the RadSys Zond description related to the new

    Lite version• Updated the desktop application using description• Updated the configuration description

    2 29.05.2020 • Added the Gas detector kit description• Added the Echosounder kit description• Fixed typos

    1 20.04.2020 • Initial release

    SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 2 Revision 4 • September 2020

  • Table of Contents

    51 • Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Features

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Applications

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Kits

    72 • SkyHub Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Overview

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Specifications

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Connectors

    133 • True Terrain Following Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Radar Altimeter: Nanoradar NRA24

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Laser Altimeter: Attollo WASP-200

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Laser Altimeter: Lightware SF11/C

    164 • Ground-Penetrating Radar Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Low Frequency GPR: Radarteam Cobra

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17High Frequency GPR: RadSys Zond

    185 • Echosounder Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Echologger ECT400 Echosounder

    196 • Gas Detector Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Gas Detector: Pergam Falcon

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Gas Detector: Pergam LMm

    217 • Metal Detector Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Metal Detector: Geonics EM-61

    238 • Assembling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23DJI M600 / M600 Pro

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26DJI M210 / M210 V2

    329 • Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Prerequisites

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Setup the SkyHub Device

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Setup the Mobile Application

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Setup Interface to DJI Autopilot

    SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 3 Revision 4 • September 2020

  • . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Setup Interface to ArduPilot

    4310 • Payloads Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Altimeter Setup

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Ground-Penetrating Radar Setup

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Echosounder Setup

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Gas Detector Setup

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Metal Detector Setup

    5411 • Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54True Terrain Following

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Grasshopper Mode (beta)

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59About Log Files

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Log Files Management

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62SEG-Y Postprocessing Tool

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Update Firmware

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Uninstall Firmware

    6712 • Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67SkyHub Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Autopilot Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Flight Control Mode Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Altimeter Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76GPR Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Echosounder Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Gas Detector Configuration

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Metal Detector Configuration

    8313 • Legal Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Disclaimer

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Trademarks

    . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Document License

    SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 4 Revision 4 • September 2020

  • 1 • Description

    The SkyHub solution is a hardware and software set designed to enhance UAV capabilities forindustrial purposes.

    SkyHub solution functions:

    • Getting data from an external payload• Getting flight parameters from a flight controller• Data converting and recording in a format convenient for processing and analysis• Implementing custom flight control algorithms• Extended UAV diagnostics

    Features• Fully isolated and ESD-protected

    external interfaces• Reliable and convenient connectors

    with lock, ideal for airborne applications• 12 V power output with switch-off

    function for payload connecting

    • 3× UART / 1x RS-232 / 1× I²C / Ethernet/ Wi-Fi / Bluetooth interfaces (dependson the SkyHub edition, see Kits)

    • Protection against input power’sinverse polarity

    • Extended operating temperature rangefrom −25°C to +85°C

    Applications• Custom payload integration with drone• Advanced UAV flight control scenarios

    • Using drones in an adverseenvironment

    1 • Description SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 5 Revision 4 • September 2020

  • DJI GNSSReceiver

    DJI FlightController

    DJI AirDownlink

    DJI C

    AN B

    us

    API Port UART

    Laser / RadioAltimeter

    I²C / UART

    Onboard Software(UgCS SkyHub)

    PayloadDataLog

    DronePosition

    Log

    SystemLog

    Payload Payload

    Ethernet Bluetooth / Wi-Fi

    DJI OnboardSDK

    UgCS SkyHub

    Drone

    Ground

    DJI RemoteController

    Radio Link

    UgCS for DJI Mobile Application

    Mobile Device

    Laptop

    Wi-Fi / Bluetooth

    UgCSClient

    UgCSUCS

    CustomPayloadMonitor

    Wi-Fi

    USB

    UART / RS-232

    Figure 1.1 — Interaction diagram

    KitsSPH Engineering provides various kits for different usage scenarios:

    • True Terrain Following (TTF) kit• Ground Penetrating Radar (GPR) kit (includes TTF kit)• Gas Detector kit (with or without TTF kit)• Echosounder kit (includes TTF kit)

    Any kit provided includes the SkyHub device, cables, and related software.

    One may extend the SkyHub solution capabilities by adding custom payloads using SkyHubSDK. Find more details here: https://github.com/ugcs/skyhub-sdk

    The SkyHub device has several editions allowing to connect different payloads:

    • 3× UART edition• 2× UART / 1× I²C edition• 2× UART / 1× RS-232 edition

    Also, one UART / RS-232 can provide either 5 V or 12 V voltage up to 1 A for the payloadpowering.

    Kits SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 6 Revision 4 • September 2020

    https://github.com/ugcs/skyhub-sdk

  • 2 • SkyHub Device

    OverviewThe main device elements are illustrated below.

    1 5432

    1 Ethernet connector

    Communicates with Ethernet-basedpayloads (see Ethernet)

    2 Antenna connector

    For connecting Wi-Fi/Bluetoothantenna or antenna cable (seeAntenna)

    3 12V LED (red)

    Indicates the presence of 12V poweroutput

    4 12V power output

    Feeds the payload (see 12V PowerOutput)

    5 Power input

    Main power input (see Power Input)

    54 1086

    97 6 UART2 / RS-232 / I²C combined

    Depends on the edition selected (seeUART2 / RS-232 / I²C)

    7 Core power LED (green)

    Indicates the presence of core power

    8 UART1

    Communicates with UART-basedpayloads (see UART1)

    9 Power LED (green)

    Indicates the presence of inputpower

    10 UART0

    Communicates with the flightcontroller (see UART0)

    2 • SkyHub Device SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 7 Revision 4 • September 2020

  • SpecificationsGeneral

    Compatible drones• DJI M210 / M210 V2• DJI M600 / M600 Pro• Custom frames based on DJI A3 flight controller

    Temperature range −25°C to +85°C

    Power input 15 V to 36 V, 3 W without payload, up to 15 W with payload

    Power output 12 V, up to 1 A

    Computational Core

    System-on-Module Digi ConnectCore 6UL

    CPU NXP i.MX6UL

    CPU frequency up to 528 MHz

    RAM 256 Mbytes

    Flash 256 Mbytes

    MicroSD 32 Gbytes, industrial grade

    OS Yocto Project Linux

    Interfaces

    UART up to 3 (depends on the edition selected)

    RS-232 up to 1 (depends on the edition selected)

    I²C up to 1 (depends on the edition selected)

    Wi-Fi Dual-band 802.11ac

    Bluetooth 4.2 with BLE support

    Ethernet 10/100 Mbit

    Mechanical

    Dimensions (L × W × H) 109 × 69 × 34 mm

    Weight 245 g with mountings

    Specifications SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 8 Revision 4 • September 2020

  • Mechanical

    TTF kit total weight 413 g

    ConnectorsPower Input

    • Mating connector on the cable side: Amass XT30U-F• Voltage range: 15 V to 36 V• Protected against reverse polarity

    12

    Pinout (device side)

    Pin Name Description

    1 +V Power supply voltage

    2 GND Power supply ground

    12V Power Output• Mating connector on the cable side: Amass XT30U-M• Voltage: 12 V ± 1%• Current: up to 1 A

    1 2

    Pinout (device side)

    Pin Name Description

    1 +12V Power output voltage

    2 GND Power output ground

    UART0Dedicated to communicating with the flight controller.

    • Mating connector on the cable side: Lemo FGG.0B.303• Logic level: 3.3 V• Serial device path: /dev/ttymxc3• Isolated from the CPU• ESD-protected

    Connectors SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 9 Revision 4 • September 2020

  • 1

    2 3

    Pinout (device side)

    Pin Name Description

    1 UART0_TX UART0 transmit line

    2 UART0_RX UART0 receive line

    3 GND Ground

    UART1Dedicated to communicating with the payload equipped with the UART interface.

    • Mating connector on the cable side: Lemo FGG.0B.305• Logic level: 3.3 V• Serial device path: /dev/ttymxc5• Isolated from the CPU• ESD-protected

    12

    3 4

    5

    Pinout (device side)

    Pin Name Description

    1 +5V 5 V output voltage

    2 +3V3 3.3 V output voltage

    3 UART1_TX UART1 transmit line

    4 UART1_RX UART1 receive line

    5 GND Ground

    UART2 / RS-232 / I²CThe function of this connector depends on the selected edition while ordering. Also, one maychoose the power output voltage of either 5 V or 12 V.

    Attention! Only one particular interface is available after the purchase and it can’t bechanged.

    Connectors SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 10 Revision 4 • September 2020

  • UART2Dedicated to communicating with the payload equipped with the UART interface.

    • Mating connector on the cable side: Lemo FGG.0B.304• Logic level: 3.3 V• Serial device path: /dev/ttymxc1• Isolated from the CPU• ESD-protected

    1

    2 3

    4

    Pinout (device side)

    Pin Name Description

    1 +5V or +12V 5 V / 12 V output voltage up to 1 A(depends on the edition)

    2 UART2_RX UART2 receive line

    3 UART2_TX UART2 transmit line

    4 GND Ground

    RS-232Dedicated to communicating with the payload equipped with the RS-232 interface.

    • Mating connector on the cable side: Lemo FGG.0B.304• Logic level (typical): −5.4 V to +5.4 V• Serial device path: /dev/ttymxc1• Isolated from the CPU• ESD-protected

    1

    2 3

    4

    Pinout (device side)

    Pin Name Description

    1 +5V or +12V 5 V / 12 V output voltage up to 1 A(depends on the edition)

    2 RS232_RX RS-232 receive line

    3 RS232_TX RS-232 transmit line

    4 GND Ground

    Connectors SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 11 Revision 4 • September 2020

  • I²CDedicated to communicating with the payload equipped with the I²C interface.

    • Mating connector on the cable side: Lemo FGG.0B.304• Logic level: 3.3 V• Isolated from the CPU• ESD-protected

    1

    2 3

    4

    Pinout (device side)

    Pin Name Description

    1 +5V 5 V output voltage

    2 SDA I²C data line

    3 SCL I²C clock line

    4 GND Ground

    EthernetDedicated to communicating with the payload equipped with the Ethernet interface.

    • Mating connector on the cable side: RJ-45• Bitrate: 10/100 Mbit

    Antenna• Mating connector on the cable side: Reverse-Polarity (RP) SMA Male• Frequency: combined 2.4 and 5 GHz

    Connectors SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 12 Revision 4 • September 2020

  • 3 • True Terrain Following Kit

    The True Terrain Following (TTF) enables the drone (UAV) to accurately follow the terrainduring the flight, based on data received from the laser or radar altimeter. True TerrainFollowing enables the drone to fly at low and constant AGL altitudes (up to 1 meter) without aneed to import precise Digital Elevation Model (DEM) height-map into UgCS.

    Components:

    • SkyHub device• Laser altimeter: Attollo WASP-200, Lightware SF11/C, or• Radar altimeter: Nanoradar NRA24• Mounting kit, cables

    Radar Altimeter: Nanoradar NRA24Nanoradar NRA24 is the compact K-band radar altimeter. It adopts 24GHz-ISM frequencyband with the advantages of 2 cm measuring accuracy, small size, high sensitivity,lightweight, and stable performance.

    Figure 3.1 — Nanoradar NRA24 altimeter

    Specifications

    Interface UART

    Effective measurementrange 0.1 m to 30 m

    Measuring accuracy 2 cm

    Power input 5 V to 20 V, 1.5 W

    Temperature range −40°C to +85°C

    Weight 168 g with mountings

    3 • True Terrain Following Kit SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 13 Revision 4 • September 2020

  • Laser Altimeter: Attollo WASP-200Attollo WASP-200 is the ultra-compact laser rangefinder device. It is capable to measure thedistance quickly and accurately and supports range update rates of up to 56ranges-per-second with improved accuracy at lower repetition rates with a variety of filteringand averaging features.

    Figure 3.2 — Attollo WASP-200 altimeter

    Specifications

    Interface UART

    Effective measurementrange 0.2 m to 125 m

    Measuring accuracy < 10 cm

    Power input 5 V to 16 V, < 75 mA

    Temperature range −40°C to +60°C

    Weight 30 g

    Laser Altimeter: Attollo WASP-200 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 14 Revision 4 • September 2020

  • Laser Altimeter: Lightware SF11/CLightWare SF11/C LIDAR Range Sensor is a compact, lightweight altimeter forabove-ground-level measurement. It supports range update rates of 20 ranges-per-second,includes serial, I²C and USB interfaces.

    Figure 3.3 — Lightware SF11/C altimeter

    Specifications

    Interface I²C, UART, USB

    Effective measurementrange 0 m to 120 m

    Measuring accuracy ± 10 cm

    Power input 5 V, < 200 mA

    Temperature range 0°C to +40°C

    Weight 35 g

    Laser Altimeter: Lightware SF11/C SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 15 Revision 4 • September 2020

  • 4 • Ground-Penetrating Radar Kit

    Ground-penetrating radar (GPR) kit aims to locate underground objects, explore soil layers, forbathymetry purposes.

    Components:

    • SkyHub device with True Terrain Following Kit• Low frequency or high frequency GPR• Cables

    Low Frequency GPR: Radarteam CobraLow frequency GPR is more appropriate for detecting large objects, soil profiling, bathymetry.It is characterized by larger penetrating depth and larger detectable object dimensions.

    Figure 4.1 — Low frequency GPR

    Specifications

    Center frequency 80 MHz 124 MHz

    Frequency range 20 MHz to 140 MHz 20 MHz to 280 MHz

    Bandwidth 120 MHz 260 MHz

    Dimensions (L × W × H) 139 × 15 × 21 cm 92 × 22 × 22 cm

    Weight 4.9 kg 4.6 kg

    4 • Ground-Penetrating Radar Kit SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 16 Revision 4 • September 2020

  • High Frequency GPR: RadSys ZondHigh frequency GPR it characterized by increased resolution allowing to detect smallerobjects. Also, it is more compact and lightweight. The drawback is lower penetrating depth.High frequency GPR is ideal for small object detection, surface layer soil profiling.

    Figure 4.2 — High Frequency GPR

    Specifications

    Center frequency 1000 MHz 500 MHz

    Frequency range 600 MHz to 1300 MHz 200 MHz to 900 MHz

    Bandwidth 700 MHz 800 MHz

    Dimensions (L × W × H) 41 × 31 × 18 cm 41 × 31 × 18 cm

    Weight 3.2 kg 3.2 kg

    High Frequency GPR: RadSys Zond SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 17 Revision 4 • September 2020

  • 5 • Echosounder Kit

    Echosounder kit is designed for bathymetric purposes, detection of underwater objects.

    Components:

    • SkyHub device with True Terrain Following Kit• Echosounder Echologger ECT400 with load• Mounting kit and cable

    Echologger ECT400 EchosounderEchologger ECT400 is one of the smallest and lightest precision echosounders capable ofmeasuring both accurate backscatter and depth data.

    Figure 5.1 — Echologger ECT400 with load, mounting kit, and cable

    Specifications

    Interface RS-232

    Effective measurement range 0.15 m to 100 m

    Measuring accuracy > 7.5 mm

    Power input 8 V to 75 V, 2 W

    Temperature range −10°C to +50°C

    Sensor weight 270 g

    Total kit weight 2500 g

    5 • Echosounder Kit SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 18 Revision 4 • September 2020

  • 6 • Gas Detector Kit

    Gas detecor kit aims to detecting methane gas leaks from a distance. Applications are gasline and tank inspections, landfill emission monitoring, and surveys in difficult to accessareas.

    Components:

    • SkyHub device with or without True Terrain Following Kit• Gas detector: Pergam Falcon or Pergam LMm• Mounting kit and cable

    Gas Detector: Pergam FalconLaser Falcon is a laser-type methane gas detector. Weight of the product allows airbornemethane monitoring.

    Figure 6.1 — Pergam Falcon

    Specifications

    Interface USB

    Effective measurementrange 1 ppm×m to 50000 ppm×m

    Measuring accuracy ±10%

    Detection distance 0.5 m to 100 m

    Power input 5 V to 18 V

    Temperature range −17°C to +50°C

    Weight 230 g

    6 • Gas Detector Kit SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 19 Revision 4 • September 2020

  • Gas Detector: Pergam LMmThe LMm (Laser Methane mini) is designed to remotely detect methane, as well as other gasmixtures containing methane (natural gas or similar gases). It allows to quickly and safely findthe point of gas leakage by pointing the laser beam at the studied area.

    Figure 6.2 — Pergam LMm

    Specifications

    Interface UART

    Effective measurementrange 1 ppm×m to 50000 ppm×m

    Measuring accuracy ±10%

    Detection distance 0.5 m to 30 m

    Power supply Battery pack

    Battery life per charge 5 h

    Temperature range −17°C to +50°C

    Weight 600 g (including battery unit)

    Gas Detector: Pergam LMm SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 20 Revision 4 • September 2020

  • 7 • Metal Detector Kit

    Metal detector kit aims to locate underground metal objects, for geo-research purposes.

    Components:

    • SkyHub device with or without True Terrain Following Kit• Metal detector: Geonics EM-61• Mounting kit and cable

    Metal Detector: Geonics EM-61Geonics EM-61 Metal Detector is high power, high sensitivity metal detector suitable forapplications in the detection of both ferrous and non-ferrous metal. Insensitive to commonsources of both geologic and cultural noise, the metal detector can be operated withoutcompromise to data quality in most survey environments.

    Figure 7.1 — Geonics EM-61

    Specifications

    Interface RS232, USB (USB-RS232 adapter required)

    Power input 12 V

    Detection depth 5 m

    Device dimensions (L × Wx H) 14 x 28 x 9 cm

    Antenna dimensions (L ×W) 105 x 54 cm

    Weight 6 kg with mountings and antenna

    7 • Metal Detector Kit SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 21 Revision 4 • September 2020

  • Specifications

    Temperature range −30°C to +60°C

    7 • Metal Detector Kit SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 22 Revision 4 • September 2020

  • 8 • Assembling

    Assembling instructions differ depending on the drone used:

    • DJI M600 / M600 Pro• DJI M210 / M210 V2

    DJI M600 / M600 ProSkyHub Device

    1. Stick a velcro to the SkyHub’s top side.

    Figure 8.1 — Velcro on the top side of the SkyHub

    2. Stick the second part of the velcro to the bottom side of the drone.

    8 • Assembling SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 23 Revision 4 • September 2020

  • Figure 8.2 — Velcro on the bottom side of the drone

    3. Mount the SkyHub onto the drone and connect the cables.

    4. Connect the SkyHub to the drone’s power outlet (DC-18V) using included power cable.

    Attention! Do not connect any payload to this connector unless you are sure about thepayload’s power voltage range.

    8 • Assembling SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 24 Revision 4 • September 2020

  • Figure 8.3 — Connecting the SkyHub to power

    5. Connect the SkyHub to the flight controller’s API port using included interface cable.Pay attention to the correct connector orientation (left pin should be empty as on thephoto).

    Figure 8.4 — Connecting the SkyHub to the flight controller

    6. The mounted SkyHub with connected cables is shown on the Figure 8.5.

    Figure 8.5 — The SkyHub mounted onto the M600 drone

    8 • Assembling SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 25 Revision 4 • September 2020

  • DJI M210 / M210 V2SkyHub Device

    1. Unscrew the original cable cover using a 1.5 hex driver. The screws will be used to fixthe customized cable cover in place.

    Figure 8.6 — M210 TTF kit

    2. Snap the SkyHub on the right leg of the drone.

    Figure 8.7 — SkyHub on the M210 leg

    DJI M210 / M210 V2 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 26 Revision 4 • September 2020

  • 3. Open the leg brace, slide the SkyHub up and close the leg brace. Check that theretaining tab is fixed by the leg brace and the brace is closed completely.

    Figure 8.8 — M210 leg brace

    4. Snap the wire assembly onto the rear right propeller arm. Ensure that the gray SkyHubconnectors are on the SkyHub side.

    Figure 8.9 — Wire assembly

    5. Put the 3-pin rectangular connector through the hole in the cable cover. Pushing it inas far as it goes will make it easier to plug the connector into the drone.

    DJI M210 / M210 V2 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 27 Revision 4 • September 2020

  • Figure 8.10 — 3-pin rectangular connector to be plugged into the drone

    6. Plug the connector into the drone. The white stripe is on the top.

    Figure 8.11 — 3-pin rectangular connector plugged into the drone

    7. Push the cable cover over the connector making sure that the connector is fullyseated.

    DJI M210 / M210 V2 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 28 Revision 4 • September 2020

  • Figure 8.12 — M210 cable cover to be pushed

    8. Push the cable cover fully into place. Screw the cable cover to the drone using thescrews from the original.

    Figure 8.13 — M210 cable cover installed

    9. Make the connections to the SkyHub. Attention! The data connectors have a differentnumber of pins. Be sure to use the appropriate connectors and to line up the red dots.

    DJI M210 / M210 V2 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 29 Revision 4 • September 2020

  • Figure 8.14 — SkyHub installed and connected

    10. Plug the power cable into the drone.

    Figure 8.15 — Power cable connected to the M210

    11. The installation is complete. The end result is shown on the Figure 8.16

    DJI M210 / M210 V2 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 30 Revision 4 • September 2020

  • Figure 8.16 — The SkyHub mounted onto the M210 drone

    DJI M210 / M210 V2 SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 31 Revision 4 • September 2020

  • 9 • Preparation

    PrerequisitesRequired desktop software:

    • DJI Assistant 2 for Autopilot or DJI Assistant 2 for Matrice• UgCS v3.7 or higher (referred below as UgCS)• UgCS Custom Payload Monitor v3.11.0 or higher (referred below as UgCS-CPM)• Putty SSH Client• WinSCP

    Required mobile software:

    • For DJI A3 / M600 / M600 Pro: DJI GO• For DJI M210 / M210 V2: DJI Pilot• UgCS for DJI v2.23 or higher (referred below as UgCS for DJI)

    Connect to SkyHub Using Wi-FiImportant: It is strongly recommended to switch off DJI Remote Controller before anyoperations with the SkyHub Wi-Fi.

    After powering on the SkyHub operates as Wi-Fi access point with following credentials:

    • SSID: UgCS-SkyHub-****** (where ****** is the SkyHub serial number)• Passphrase: 12341234

    One may connect to the SkyHub via SSH protocol (e.g. using PuTTY or WinSCP).

    • IP address: 10.1.0.1• Port: 22• Username: root• Password:

    Connect to SkyHub Using EthernetParameters for wired connection are:

    • IP address: 192.168.0.33• Port: 22• Username: root• Password:

    9 • Preparation SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 32 Revision 4 • September 2020

    https://www.dji.com/a3/info#downloadshttps://www.dji.com/matrice-200-series/info#downloadshttps://www.ugcs.com/downloadhttps://industrial.ugcs.com/dl/s/ugcs-cpm-windowshttps://www.chiark.greenend.org.uk/~sgtatham/putty/latest.htmlhttps://winscp.net/eng/download.phphttps://play.google.com/store/apps/details?id=dji.pilothttps://play.google.com/store/apps/details?id=com.dji.industry.pilothttps://www.ugcs.com/direct-download-ugcs-for-dji

  • SkyHub runs DHCP service onboard, therefore, the PC’s IP address will be assignedautomatically after connection.

    Access to Onboard File SystemOne may use any SCP client to access the SkyHub file system. For example, one may useWinSCP.

    Figure 9.1 — WinSCP settings

    While pressing the Login button one may choose between login via SCP (to have access to thefile system) or opening with PuTTY (for SSH access).

    • Home directory for root user: /home/root/• MicroSD root: /run/media/mmcblk1p1/• Configuration file: /etc/skyhub/skyhub.conf• Logs directory: /run/media/mmcblk1p1/skyhub_logs/

    9 • Preparation SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 33 Revision 4 • September 2020

  • Setup the SkyHub DeviceIn order to configure the SkyHub software one should edit skyhub.conf file located in/etc/skyhub/ directory. This configuration file has a widely used INI like file format. Thedefault configuration file created automatically if the configuration file doesn’t exist.

    The first step is to enable the only used autopilot and disable others. Go to [AUTOPILOTS]sections and set the corresponding field to true. For example, when using the solution withDJI drones:

    [AUTOPILOTS]DJI=true

    The second important step is to configure used autopilot and payloads. For example, DJIautopilot related parameters are collected within the [DJI] section:

    [DJI]APP_ID=1071019APP_KEY=42873781474d507ebf72353187ea0af50cbd926b3b790e6cf0cdf8292330b25dBAUD_RATE=230400RESPONSE_TIMEOUT_S=1SENDING_PERIOD_MS=20SERIAL_DEVICE=/dev/ttymxc3

    Within [PAYLOADS] section set to true for the only used payloads and false for theunused ones. For example, when using the high frequency GPR with the radar altimeter:

    [PAYLOADS]ATTOLLO_WASP=falseECHOLOGGER_ECT=falseNANORADAR_NRA=truePERGAM_LMM=falseRADARTEAM_COBRA=falseRADSYS_ZOND=true

    Enable the one requiered flight algorithm. The default configuraton is:

    [ALGORITHMS]GRASSHOPPER=trueTERRAIN_FOLLOWING=true

    Only one flight algorithm can be used during one flight. This is determined at the missionsettings step in the UgCS Client and UgCS-CPM. If the algorithm is not used, it isrecommended to set false to disabling unused algorithms.

    TTF and GH settings are collected within the [TF] or [GH] section. Most of the parametersare to be kept with default values while getting started.

    Setup the SkyHub Device SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 34 Revision 4 • September 2020

  • One may choose the altitude source for the flight algorithm. The AUTOPILOT value is usefulwhen trying to run algorithm in simulator mode:

    [TF]ALTITUDE_SOURCE=AUTOPILOT[GH]ALTITUDE_SOURCE=AUTOPILOT

    Do not forget to restore the ALTIMETER value before the real flight:

    [TF]ALTITUDE_SOURCE=ALTIMETER[GH]ALTITUDE_SOURCE=ALTIMETER

    For a more detailed description of the configuration file, see Configuration Parameters.

    Setup the Mobile ApplicationOne should enable custom payload support in the UgCS for DJI mobile application. Afterstarting the application go to Menu > Drone Specific Settings and enable the correspondingcheckbox.

    Figure 9.2 — Enable Custom Payload checkbox

    Setup the Mobile Application SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 35 Revision 4 • September 2020

  • Setup Interface to DJI AutopilotTo allow the SkyHub to connect to the DJI autopilot, one should activate and setup theOnboard SDK for its device. The following steps are described for the DJI A3 flight controllerbut may be applied to another DJI product with a minor difference.

    Option 1: Using Default Credentials (Recommended)It is recommended to use default credentials provided with the software pack:

    • Login: [email protected]• Password: request when ordering the kit

    1. Connect the DJI flight controller to the PC, run the DJI Assistant 2, and press the Loginbutton.

    Figure 9.3 — DJI Assistant 2 start window

    2. Enter the credentials mentioned above and press Sign in.

    Setup Interface to DJI Autopilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 36 Revision 4 • September 2020

  • Figure 9.4 — DJI Assistant 2 login window

    3. Switch on the drone, wait for the device to appear, open the main window, thenchoose the SDK tab and check Enable API Control and Ground Station Statuscheckboxes.

    Figure 9.5 — Enable API control in DJI Assistant 2

    Setup Interface to DJI Autopilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 37 Revision 4 • September 2020

  • 4. When available: Choose the Basic Settings > Remote Controller tab, check the EnableMultiple Flight Mode checkbox, and configure the flight mode switch to be in P-modefor left and right positions while being in A-mode for the middle position.

    Figure 9.6 — Enable API control in DJI Assistant 2

    5. An alternative way to activate the Multiple Flight Mode is to go to the DJI GO app >Camera View > > Enable Multiple Flight Mode.

    6. Switch on the DJI Remote Controller, run DJI GO (DJI Pilot), choose Me tab, pressLogin button.

    7. Enter the credentials mentioned above and press Login.

    8. Choose Equipment tab, wait for A3 / M600 / M600 Pro / M210 / M210 V2, then pressCamera button.

    Figure 9.7 — DJI GO screens

    Setup Interface to DJI Autopilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 38 Revision 4 • September 2020

  • 9. Restart the drone by a power cycle. The SkyHub device should be properly connectedto the flight controller.

    10. Wait for the SkyHub firmware loads and starts. The DJI mobile application mayrequest you about additional permissions for the Onboard SDK. Confirm all of themallowing the SkyHub to access the DJI autopilot.

    Now the flight controller is ready to be connected via Onboard SDK. Default DJI App ID andKey are used.

    Important: The DJI flight controller may not activate from the first attempt. If there is noconnection with flight controller after full system setup, try to repeat steps from 8 to 10several times with the drone power cycling.

    Option 2: Using User’s CredentialsOtherwise, one may use his credentials while the DJI flight controller activating. In this case,follow the steps described below.

    1. Create an account on https://developer.dji.com/ then enter to Apps tab in thedeveloper area.

    2. Choose ONBOARD SDK and press CREATE APP.

    Figure 9.8 — DJI Developer area

    3. Enter corresponding information and press CREATE.

    Setup Interface to DJI Autopilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 39 Revision 4 • September 2020

    https://developer.dji.com/

  • Figure 9.9 — Create app

    4. Follow steps from received activation email.

    5. Return to the DJI Developer area and open app details. Remember APP ID and AppKey values.

    Figure 9.10 — Getting App ID and Key from App Information

    6. Write these values to corresponding configuration fields in skyhub.conf (APP_IDand APP_KEY accordingly in [DJI] section) as described in Setup the SkyHubDevice. Do not forget to restart the SkyHub after changing parameters.

    7. Follow the steps from 1 to 9 from the previous section but using own DJI credentials.

    Setup Interface to DJI Autopilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 40 Revision 4 • September 2020

  • Important: The DJI flight controller may not activate from the first attempt. If there is noconnection with flight controller after full system setup, try to repeat steps from 7 to 9 fromthe previous section several times with the drone power cycling.

    Setup Interface to DJI Autopilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 41 Revision 4 • September 2020

  • Setup Interface to ArduPilotSkyHub can be connected to the flight controller flashed with the ArduPilot firmware.

    1. Check UgCS version. Make sure you have the UgCS version 3.7.167 or higher(download links can be found in Prerequisites section).

    2. Ardupilot VSM configuration. Open vsm-ardupilot.conf in text editor. Find anduncomment the following settings:

    mavlink.vsm_system_id = 255mavlink.protocol_version = 2vehicle.ardupilot.custom_payload.enable = yesvehicle.ardupilot.custom_payload.onboard.system_id = 2vehicle.ardupilot.custom_payload.onboard.component_id = 5vehicle.ardupilot.custom_payload.onboard.network = 0

    3. ArduPilot configuration. ArduPilot must have one of its telemetry ports configured tosupport MAVLink2 protocol and with the baud rate equal to the one defined in SkyHubBAUD_RATE property in [MAV] section:

    [AUTOPILOTS]MAVPILOT=true[MAV]SERIAL_PROTOCOL=2SERIAL_BAUD=57600

    4. Match configured values with the SkyHub configuration file accordingly:COMPONENT_ID, SYSTEM_ID, BAUD_RATE (see ArduPilot Configuration section formore detail).

    5. NRA24 configuration. To connect altimeter directly to the autopilot and use theproprietary flight algorithm is needed to set the following fields in the ArduPilotconfiguration:

    RNGFND1_TYPE,11SERIAL4_BAUD,115SERIAL4_PROTOCOL,9

    Setup Interface to ArduPilot SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 42 Revision 4 • September 2020

  • 10 • Payloads Setup

    Choose the usage scenario below:

    • Altimeter Setup• Nanoradar NRA24 Altimeter Setup• Attollo WASP-200 Altimeter Setup• Lightware SF11/C Altimeter Setup

    • Ground-Penetrating Radar Setup• Low Frequency GPR Setup• High Frequency GPR Setup

    • Echosounder Setup• Echologger ECT400 Setup

    • Gas Detector Setup• Pergam Falcon Setup• Pergam LMm Setup

    Altimeter SetupThere are common altimeter settings in the [ALTIMETER] section. Check whether minimumand maximum values correspond to your needs:

    [ALTIMETER]MIN_ALTITUDE_M=0.5MAX_ALTITUDE_M=20

    These values are used to bound valid drone altitude values. When the drone flies out of thelimits, the operator will be notified. Also, while flying in TF mode, descending belowMIN_ALTITUDE_M or ascending above MAX_ALTITUDE_M make the drone hover and go tothe safe altitude.

    Another parameter to be set is the sensor’s zero-level above ground when the drone stands atthe surface:

    [ALTIMETER]ZERO_LEVEL_M=0.4

    The ZERO_LEVEL_M value will be subtracted from the distance reported by the rangefinderresulting in the true drone’s altitude above ground level.

    10 • Payloads Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 43 Revision 4 • September 2020

  • Nanoradar NRA24 Altimeter Setup

    1. Set NANORADAR_NRA item to true in [PAYLOADS] section:

    [PAYLOADS]NANORADAR_NRA=true

    2. Choose the appropriate SERIAL_DEVICE in the [NANORADAR_NRA] sectiondepending on which connector it is connected to. Set it to /dev/ttymxc5 whenconnecting to the 5-pin Lemo connector (see UART1) or to /dev/ttymxc1 whenconnecting to the 4-pin Lemo connector (see UART2):

    [NANORADAR_NRA]SERIAL_DEVICE=/dev/ttymxc5 ; UART1 (5-pin Lemo); orSERIAL_DEVICE=/dev/ttymxc1 ; UART2 (4-pin Lemo)

    Important: Nanoradar NRA24 radar altimeter doesn’t detect any reflection from the groundwhen there is no motion due to technological limitations. Therefore, it starts to measure thealtitude only after takeoff. Move the drone by hands before a flight to be sure the altimeteroperates well.

    See the Nanoradar NRA24 Altimeter Configuration section to find all available settings withdefault values and descriptions.

    Attollo WASP-200 Altimeter Setup

    1. Set ATTOLLO_WASP item to true in [PAYLOADS] section:

    [PAYLOADS]ATTOLLO_WASP=true

    2. Choose the appropriate SERIAL_DEVICE in the [ATTOLLO_WASP] sectiondepending on which connector it is connected to. Set it to /dev/ttymxc5 whenconnecting to the 5-pin Lemo connector (see UART1) or to /dev/ttymxc1 whenconnecting to the 4-pin Lemo connector (see UART2):

    [ATTOLLO_WASP]SERIAL_DEVICE=/dev/ttymxc5 ; UART1 (5-pin Lemo); orSERIAL_DEVICE=/dev/ttymxc1 ; UART2 (4-pin Lemo)

    10 • Payloads Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 44 Revision 4 • September 2020

  • See Attollo WASP-200 Altimeter Configuration to find all available settings with default valuesand descriptions.

    Lightware SF11/C Altimeter Setup

    1. Set LIGHTWARE_SF item to true in [PAYLOADS] section:

    [PAYLOADS]LIGHTWARE_SF=true

    2. Choose the appropriate CONNECTION_TYPE in the [LIGHTWARE_SF] sectiondepending on which SkyHub connectors it is used to. Set it to I2C when usedconnector configured as an I²C interface or to UART when used connector configuredas an UART interface:

    [LIGHTWARE_SF]CONNECTION_TYPE=I2C; orCONNECTION_TYPE=UART

    3. Choose the appropriate SERIAL_DEVICE in the [LIGHTWARE_SF] section if theUART connection type has been chosen. Set it to /dev/ttymxc5 when connecting tothe 5-pin Lemo connector (see UART1) or to /dev/ttymxc1 when connecting to the4-pin Lemo connector (see UART2):

    [LIGHTWARE_SF]SERIAL_DEVICE=/dev/ttymxc5 ; UART1 (5-pin Lemo); orSERIAL_DEVICE=/dev/ttymxc1 ; UART2 (4-pin Lemo)

    See Lightware SF11/C Altimeter Configuration to find all available settings with default valuesand descriptions.

    10 • Payloads Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 45 Revision 4 • September 2020

  • Ground-Penetrating Radar SetupLow Frequency GPR Setup

    1. Set RADARTEAM_COBRA item to true in [PAYLOADS] section:

    [PAYLOADS]RADARTEAM_COBRA=true

    2. Set MODEL and TIME_RANGE parameters in the [RADARTEAM_COBRA] sectionaccording to concrete GPR model used:

    [RADARTEAM_COBRA]MODEL=SE-150TIME_RANGE_NS=800

    See Low Frequency GPR Configuration to find all available settings with default values anddescriptions.

    Ground-Penetrating Radar Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 46 Revision 4 • September 2020

  • High Frequency GPR Setup

    1. Every new device is to be calibrated before using. One should find the appropriatevalues of the pulse delay. Connect the GPR to the PC, run the Prism 2 software, andfind the required pulse delay while using the desired mode, time range, sample count.

    Figure 10.1 — Prism 2 setup window

    2. While using dual-channel GPR model one may choose either single-channel ordual-channel mode by setting the MODE parameter in the [RADSYS_ZOND] section:

    [RADSYS_ZOND]MODE=CHANNEL_1 ; Single-channel; orMODE=TWO_CHANNELS ; Dual-channel

    Ground-Penetrating Radar Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 47 Revision 4 • September 2020

  • 3. Set the trace time range, sample count, pulse delay, and filter in the correspondingfields in the [RADSYS_ZOND] section:

    [RADSYS_ZOND]FILTER_1=OFFFILTER_2=OFFMODE=TWO_CHANNELSPULSE_DELAY_1=297PULSE_DELAY_2=301SAMPLE_COUNT=256TIME_RANGE_NS_1=300TIME_RANGE_NS_2=300

    Note: When using the Lite version of RadSys Zond radar, fields MODE, SAMPLE_COUNT, andTIME_RANGE are ignored.

    4. While using dual-channel mode one may setup the antenna offsets in thecorresponding fields:

    [RADSYS_ZOND]OFFSET_FORWARD_M_1=0.1 ; 10 cm alongside the heading lineOFFSET_FORWARD_M_2=0.1OFFSET_RIGHT_M_1=0.25 ; 25 cm alongside the traverse lineOFFSET_RIGHT_M_2=-0.25 ; -25 cm alongside the traverse line (left offset)

    See High Frequency GPR Configuration to find all available settings with default values anddescriptions.

    Ground-Penetrating Radar Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 48 Revision 4 • September 2020

  • Echosounder SetupThere are common echosounder settings in the [ECHOSOUNDER] section. Check whetherminimum and maximum values correspond to your needs:

    [ECHOSOUNDER]MIN_DEPTH_M=0.5MAX_DEPTH_M=20

    These values are used to bound valid echosounder depth values. When the depth value is outof the limits, the operator will be notified.

    Another parameter to be set is the length of the echosounder cable:

    [ECHOSOUNDER]CABLE_LENGTH_M=0

    This parameter is set to zero by default. If set to the value greater than zero, it is used todetermine whether the echo sounder is immersed in water. When the drone altitude becomeslower than the cable length, it means the echosounder is immersed in water.

    Also, the cable length parameter is used to find the True Depth value. True Depth is acalculated value of depth from the surface resulting from the echosounder’s value and thecurrent altitude using the specified cable length parameter.

    The True Depth value is recorded as a separate column in the position log file andechosounder NMEA log (see About Log Files). Also, this data is sent to the PC application.

    Echologger ECT400 Setup

    1. Set ECHOLOGGER_ECT item to true in [PAYLOADS] section:

    [PAYLOADS]ECHOLOGGER_ECT=true

    2. Set the MAX_SENSOR_ANGLE_DEG parameter in the [ECHOLOGGER_ECT] section fordata filtering by echosounder tilt while recording. Set to 90 degrees for disabling.

    3. Set the MIN_SENSOR_DEPTH_M parameter in the [ECHOLOGGER_ECT] section fordata filtering by echosounder depth value while recording. Set to zero for disabling:

    [ECHOLOGGER_ECT]MAX_SENSOR_ANGLE_DEG=10MIN_SENSOR_DEPTH_M=0.1

    Echosounder Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 49 Revision 4 • September 2020

  • 4. Set the RANGE_M, DEADZONE_MM parameters in the [ECHOLOGGER_ECT] sectionaccording to the water body to be explored:

    [ECHOLOGGER_ECT]DEADZONE_MM=300RANGE_M=10

    5. One may choose the output data format for Echologger ECT400. The NMEA value isuseful when only NMEA log file should be recorded. The ECHOSOUNDER mode is usedto record both NMEA and SEG-Y logs:

    [ECHOLOGGER_ECT]MODE=NMEA; orMODE=ECHOSOUNDER

    Note the data rate in the ECHOSOUNDER mode is significantly lower than in the NMEA one.

    Table 10.1 — Maximum data rate against range in NMEA and Echosounder mode

    Range NMEA mode Echosounder mode

    2 m 10 Hz 4 Hz

    10 m 10 Hz 2 Hz

    20 m 1 Hz

    40 m 5 Hz

    80 m 4 Hz 0.5 Hz

    100 m 3 Hz 0.4 Hz

    See Echologger ECT400 Configuration to find all available settings with default values anddescriptions.

    Echosounder Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 50 Revision 4 • September 2020

  • Gas Detector SetupThere are common gas detector settings in the [GAS_DETECTOR] section. Check whetherminimum and maximum values correspond to your needs:

    [GAS_DETECTOR]MIN_CONCENTRATION_PPM=0MAX_CONCENTRATION_PPM=1000

    These values are used to bound valid gas detector values. When the gas concentration is outof the limits, the operator will be notified.

    Another parameter to be set is the sensor’s background value:

    [GAS_DETECTOR]ZERO_LEVEL_PPM=0

    The ZERO_LEVEL_PPM value will be subtracted from the gas concentration reported by thegas detector resulting in the true gas concentration.

    Pergam Falcon Setup

    1. Set PERGAM_FALCON item to true in [PAYLOADS] section:

    [PAYLOADS]PERGAM_FALCON=true

    2. Choose the appropriate SERIAL_DEVICE in the [PERGAM_FALCON] section:

    [PERGAM_FALCON]SERIAL_DEVICE=/dev/ttyUSB0

    See Pergam Falcon Configuration to find all available settings with default values anddescriptions.

    Pergam LMm Setup

    1. Set PERGAM_LMM item to true in [PAYLOADS] section:

    [PAYLOADS]PERGAM_LMM=true

    Gas Detector Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 51 Revision 4 • September 2020

  • 2. Choose the appropriate SERIAL_DEVICE in the [PERGAM_LMM] section dependingon which connector it is connected to. Set it to /dev/ttymxc5 when connecting tothe 5-pin Lemo connector (see UART1) or to /dev/ttymxc1 when connecting to the4-pin Lemo connector (see UART2):

    [PERGAM_LMM]SERIAL_DEVICE=/dev/ttymxc5 ; UART1 (5-pin Lemo); orSERIAL_DEVICE=/dev/ttymxc1 ; UART2 (4-pin Lemo)

    See Pergam LMm Configuration to find all available settings with default values anddescriptions.

    Gas Detector Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 52 Revision 4 • September 2020

  • Metal Detector SetupThere are common metal detector settings in the [METAL_DETECTOR] section. Checkwhether minimum and maximum values correspond to your needs:

    [METAL_DETECTOR]MIN_OUTPUT_VALUE_MV=0MAX_OUTPUT_VALUE_MV=1000

    These values are used to bound valid metal detector values. When the output value is out ofthe limits, the operator will be notified.

    Geonics EM-61 Setup

    1. Set GEONICS_EM_61 item to true in [PAYLOADS] section:

    [PAYLOADS]GEONICS_EM_61=true

    2. Choose the appropriate SERIAL_DEVICE in the [GEONICS_EM_61] section:

    [GEONICS_EM_61]GEONICS_EM_61=/dev/ttyUSB0 ; USB-RS232 connection; orGEONICS_EM_61=/dev/ttymxc1 ; onboard RS232 connection

    Important: in current version we recommended to use USB connection with USB-RS232adapter based on CH341 or FTDI FT232RQ.

    See Geonics EM-61 Configuration to find all available settings with default values anddescriptions.

    Metal Detector Setup SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 53 Revision 4 • September 2020

  • 11 • Getting Started

    It is strongly recommended to verify any usage scenario using the simulator before startingthe real flight. There is a dedicated simulator mode in the UgCS for DJI mobile application. Goto Menu > Simulator to enable or disable it.

    Figure 11.1 — Enable Simulator mode

    True Terrain FollowingSimulator Mode

    1. Connect to the SkyHub (see Connect to SkyHub Using Wi-Fi or Connect to SkyHubUsing Ethernet) and set the ALTITUDE_SOURCE field in the [TF] section toAUTOPILOT (see True Terrain Following Configuration for additional options).Disconnect from the SkyHub.

    2. Start the PC and connect it to the Wi-Fi network. Start the UgCS and plan a mission forthe drone.

    3. Turn on the drone, the payload, and SkyHub device.

    4. Connect the mobile device to the same Wi-Fi network as the PC. Turn on the DJIRemote Controller. Be sure that the flight mode switch on the remote controller is inthe P-mode. Run the UgCS for DJI mobile application. Wait for the application showsthe main window and connects to the UgCS. UCS connection indicator in the UgCS forDJI should become green.

    5. Click Menu, choose Simulator, and enable the Simulator checkbox.

    11 • Getting Started SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 54 Revision 4 • September 2020

  • 6. Make sure that the drone with a correct profile appears in the UgCS on the PC and alldrone indicators (battery, uplink, downlink, satellites) are green. Select the drone andthe mission.

    Figure 11.2 — Good (left) and bad (right) vehicle state in UgCS

    7. Start the UgCS-CPM application and connect to the UgCS with default credentials.Check the UgCS, Drone, and SkyHub indicators are green. Add the Terrain Followingwidget and other widgets related to connected payloads by clicking the plus button.

    Figure 11.3 — UgCS and UgCS-CPM application open side-by-side

    8. Upload the route to the drone. After that, click the Read button in the Terrain Followingwidget (UgCS-CPM), then click Configure and make sure theTerrain Following ENABLED message appears in the UgCS-CPM log window atthe bottom side. If not, toggle the flight mode switch to A-mode and back then tryagain to press the Configure button.

    9. Arm the drone using the remote controller then take off at the valid altitude (seeAltimeter Setup for details).

    10. Click the Activate button in the Terrain Following widget to activate the terrainfollowing algorithm. Check the drone simulator has started a mission.

    11 • Getting Started SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 55 Revision 4 • September 2020

  • 11. Make sure the data from connected payloads are displayed in UgCS-CPM. Try tomove the UAV and check the sensors’ response.

    12. Land the drone simulator after the mission has been completed and try to downloadlog files (see Log Files Management below). Check the log files for validity.

    13. Erase all log files.

    14. Restore the SkyHub settings in the [TF] section before the real flight. Set theALTITUDE_SOURCE field back to ALTIMETER. For more details about configurationsettings, see True Terrain Following Configuration.

    FlightConfiguration steps to be done before the real flight are similar to ones described above forsimulator mode. Use the checklist below:

    1. Make sure the ALTITUDE_SOURCE field in the [TF] section is set to ALTIMETER.

    2. Check the altitude limits MIN_ALTITUDE_M and MAX_ALTITUDE_M in the[ALTIMETER] section.

    3. Set the ZERO_LEVEL_M value in the [ALTIMETER] section according to the realposition of the altimeter.

    4. Make sure the only used payloads are true in the [PAYLOADS] section. Everypayload should be properly configured (see Payloads Setup).

    5. Erase old log files if they are not more needed (see Log Files Management below fordetails).

    6. Connect both the PC and the mobile device to the same Wi-Fi network.

    7. Switch on the drone and the remote controller. Make sure the flight mode switch is inP-mode. Run UgCS, UgCS for DJI, and make sure the drone has a good status inUgCS.

    8. Run UgCS-CPM, wait for all indicators become green, and press the Start button.

    9. Check the Altimeter widget for it displays the altimeter data. Note that there is no datafrom the radar altimeter until the drone is moving. Gently shake the drone by handuntil the altitude starts to change. Note the altitude limits may be changed in Settings> Altimeter window.

    10. Upload the route to the drone using UgCS.

    11. Go to the Terrain Following widget, press Read to read current TTF settings.

    12. Set the Target Altitude, Safe Altitude, and Speed to desired values.

    13. Press the Configure button. Wait for the Terrain Following ENABLED message.

    14. If there is no message mentioned above, change the flight mode switch to A-modethen return it back to P-Mode. Repeat steps from 10 to 13 until Terrain Followingbecomes enabled.

    11 • Getting Started SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 56 Revision 4 • September 2020

  • 15. Take off using the remote controller or from the UgCS and rise up to the appropriatealtitude (see limits from step 2).

    16. Press the Activate button in the Terrain Following widget to start the flight interrain-following mode. The alternative way to activate it is to move the flight modeswitch to A-Mode then to F-mode. The alternative way doesn’t support with M210series DJI drones.

    17. You may interrupt the flight by moving the flight mode switch to A-Mode then toP-mode. The flight can be resumed by moving the flight mode switch to A-mode thento F-mode. During pause you may manually control the drone, for example fly aroundan obstacle. In this case the drone returns to the nearest point on the route by theshortest way after resumption. Interruption and resumption using the remotecontroller don’t support with M210 series DJI drones. You might use buttons Pauseand Resume in the Terrain Following widget (UgCS-CPM).

    18. If the drone descends below the minimum allowed altitude or ascends above themaximum allowed altitude (see step 2), it stops then climbs to increase its altitude tovalue configured at step 12.

    19. After the mission has been completed the drone stops at the last waypoint thenclimbs to increase its altitude to value configured at step 12.

    20. Move the flight mode switch to P-Mode to take control, then return the drone to thedesired landing position, and land. If the flight has been ended over the desiredlanding point, press the Land button in UgCS.

    21. Download log files (see Log Files Management).

    Grasshopper Mode (beta)Simulator Mode

    1. Connect to the SkyHub (see Connect to SkyHub Using Wi-Fi or Connect to SkyHubUsing Ethernet) and set the ALTITUDE_SOURCE field in the [GH] section toAUTOPILOT (see Grasshopper Mode Configuration (beta) for additional options).Disconnect from the SkyHub

    2. Start the PC and connect it to the Wi-Fi network. Start the UgCS and plan a mission forthe drone. The descent points must be set as camera shot action.

    3. Turn on the drone, the payload, and SkyHub device. Be sure that the flight modeswitch on the remote controller is in the P-mode.

    4. Connect the mobile device to the same Wi-Fi network as the PC. Turn on the DJIRemote Controller. Be sure that the flight mode switch on the remote controller is inthe P-mode. Run the UgCS for DJI mobile application. Wait for the application showsthe main window and connects to the UgCS. UCS connection indicator in the UgCS forDJI should become green.

    5. Click Menu, choose Simulator and enable the Simulator checkbox.

    Grasshopper Mode (beta) SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 57 Revision 4 • September 2020

  • 6. Make sure that the drone with a correct profile appears in the UgCS on the PC and alldrone indicators (battery, uplink, downlink, satellites) are green. Select the drone andthe mission.

    7. Start the UgCS-CPM application and connect to the UgCS with default credentials.Check the UgCS, Drone, and SkyHub indicators are green. Add the Grasshopperwidget and other widgets related to connected payloads by clicking the plus button.

    8. Upload the route to the drone. The descent points must be set as camera shotaction. After that, click the Read button in the Grasshopper widget (UgCS-CPM), thenclick Configure and make sure the Grasshopper ENABLED message appears in theUgCS-CPM log window at the bottom side. If not, toggle the flight mode switch toA-mode and back then try again to press the Configure button.

    9. Make sure the data from connected payloads are displayed in UgCS-CPM andpayloads send data.

    10. Run the Auto Mode from UgCS-Client to activate the Grasshopper Mode algorithm.Check the drone simulator has started a mission.

    11. Land the drone simulator after the mission has been completed and try to downloadlog files (see Log Files Management below). Check the log files for validity.

    12. Erase all log files.

    13. Restore the SkyHub settings in the [GH] section before the real flight. Set theALTITUDE_SOURCE field back to ALTIMETER. For more details about configurationsettings, see Grasshopper Mode Configuration (beta).

    FlightConfiguration steps to be done before the real flight are similar to ones described above forsimulator mode. Use the checklist below:

    1. Make sure the ALTITUDE_SOURCE field in the [GH] section is set to ALTIMETER.

    2. Check the altitude limits MIN_ALTITUDE_M and MAX_ALTITUDE_M in the[ALTIMETER] section.

    3. Set the ZERO_LEVEL_M value in the [ALTIMETER] section according to the realposition of the altimeter.

    4. Make sure the only used payloads are true in the [PAYLOADS] section. Everypayload should be properly configured (see Payloads Setup).

    5. Erase old log files if they are not more needed (see Log Files Management below fordetails).

    6. Connect both the PC and the mobile device to the same Wi-Fi network.

    7. Switch on the drone and the remote controller. Make sure the flight mode switch is inP-mode. Run UgCS, UgCS for DJI, and make sure the drone has a good status inUgCS.

    Grasshopper Mode (beta) SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 58 Revision 4 • September 2020

  • 8. Run UgCS-CPM, wait for all indicators become green, and press the Start button.

    9. Check the Altimeter widget for it displays the altimeter data. Note that there is no datafrom the radar altimeter until the drone is moving. Gently shake the drone by handuntil the altitude starts to change. Note the altitude limits may be changed in Settings> Altimeter window.

    10. Upload the route to the drone using UgCS.

    11. Go to the Grasshopper widget, press Read to read current PM settings.

    12. Set the Target Altitude and Hover Time. If Hover Time is negative drone will behovered on each descent point, to continue mission you should move the flight modeswitch from P to central position and backward to P-mode.

    13. Press the Configure button. Wait for the Grasshopper ENABLED message.

    14. Run the Auto Mode from UgCS-Client to activate the Grasshopper algorithm.

    15. If emergency situation occurs, you may interrupt the flight by moving the flight modeswitch to A-Mode or press button Return To Home. The mission can’t be resumedafter emergency interruption, you should reload the route (see step 10).

    16. If the drone descends below the minimum allowed altitude or ascends above themaximum allowed altitude (see step 2), it stops and the route pauses. You maymanually correct drone position. The flight can be resumed by moving the flight modeswitch to A-mode then to P-mode.

    17. After the mission has been completed the drone stops at the last waypoint.

    18. Return the drone to the desired landing position, and land. If the flight has been endedover the desired landing point, press the Land button in UgCS.

    19. Download log files (see Log Files Management).

    About Log FilesLogs are stored in the skyhub_logs folder on the microSD card.

    There are two types of obligatory log files:

    • Position log: *-position.csv• System log: *-system.log

    Position logs (-position.csv suffix) contain drone position data (GPS coordinates,attitude, altitude, etc.) followed with the payload’s specific parameters, if any.

    System logs (-system.log extension) is a journal of various system events. Please keep itwhile contacting our support team.

    Also, depending on the concrete payload used one may get following log files:

    • GPR data log in SEG-Y format: *-gpr.sgy• Echosounder data log in SEG-Y format: *-echo.sgy

    About Log Files SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 59 Revision 4 • September 2020

  • • Echosounder data log in NMEA format: *-nmea.txt• Gas detector data log in NMEA format: *-pergam.txt

    GPR data logs (-gpr.sgy suffix) contain radar trace data in SEG-Y format. These files can beanalyzed in PC applications such as Prism2 or similar software capable to read and processGPR data in SEG-Y format.

    Echosounder data logs in SEG-Y format (-echo.sgy suffix) contain sounding trace data.These file can also be analyzed in the SEG-Y data processing software.

    Echosounder data logs in NMEA 0183 format (-nmea.txt suffix) contain bathymetric data.These files can be processed in any software capable of handling data in NMEA 0183 format(e.g. ReefMaster).

    Gas detector data logs in mixed NMEA 0183 + raw messages format (-pergam.txt suffix)contain measured concentration data. These files can be processed in Pergam’s proprietarysoftware.

    The filename contains the sequential numbers (000001, 000002, etc.) before the timesynchronization and date/time (in YEAR-MONTH-DAY-HOUR-MIN-SEC format) after thesynchronization with the GPS. The time is UTC.

    Logging (except system log) is started only by command from UgCS-CPM (using theRecord/Stop button) or automatically after taking off. The system log begins after onboardsoftware is started.

    The logs with the same file names have been created simultaneously. When the filename is tobe changed (e.g. after the time synchronization) a new set of logs is created.

    The logs can be automatically divided by file size, time, trace count (GPR or echosounderonly), and waypoints. This option is turned off by default. To enable it, set correspondingparameters to values greater than zero in the [APP] section. More than one parameter can beset simultaneously, in this case splitting will be fulfilled when the first of selected conditionsoccurs:

    [APP]LOG_SPLIT_SIZE_MB=0 ; megabytesLOG_SPLIT_TIME_S=0 ; secondsLOG_SPLIT_TRACES=0LOG_SPLIT_WAYPOINTS=0 ; 0 or 1

    When LOG_SPLIT_WAYPOINTS is set to 1 or another value greater than zero, each log file willcontain one flight line with two waypoints.

    There are two ways to download log files:

    • Using UgCS-CPM (see Log Files Management)• With any web browser via HTTP protocol

    About Log Files SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 60 Revision 4 • September 2020

  • When the second way is chosen, open http://10.1.0.1 (Wi-Fi) or http://192.168.0.33 (Ethernet)in your browser and choose the required log file from a list of all recorded ones.

    Log Files Management

    1. Connect the PC to the SkyHub using Wi-Fi (see Connect to SkyHub Using Wi-Fi) or bywire (see Connect to SkyHub Using Ethernet).

    2. Go to Settings > SkyHub and make sure the IP-address corresponds to the connectionway.

    3. Open UgCS-CPM and go to Tools > Manage Logs.

    4. Press the Browse button to choose the destination folder for log files.

    5. Use the date and file extension filters to choose log files to be downloaded.

    6. You can write custom extension if needed in the corresponding textbox.

    7. Press the Download button and wait for downloading has been finished.

    8. After the log files are not more needed you may delete them all using the Erase Allbutton.

    9. If you need to delete only certain files you may set the date and file extension filtersthen press the Erase button.

    10. You also have 2 options for downloading and deleting depending on logs creationdate: All dates and Today.

    11. Note, if you choose Today, UgCS-CPM will work not only with today’s logs but withyesterday’s and tomorrow’s. The reason is the possible difference between local dateand the UTC one used in log file names.

    Log Files Management SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 61 Revision 4 • September 2020

    http://10.1.0.1http://192.168.0.33

  • Figure 11.4 — UgCS-CPM. Manage logs window

    SEG-Y Postprocessing ToolThe SkyHub writes *.sgy files with GPS coordinates received from drone. If it’s nessessaryto have more precise coordinates of drone you can use optional external PPK device (e.g.Emlid R2). The UgCS-CPM SEG-Y Postprocessing Tool can replace GPS coordinates in *.sgyfiles with PPK using the *-position.csv log file and *.pos PPK log. GPS coordinatesreplacement is fulfilled by linear interpolation.

    1. Get all required log files to your desktop with installed UgCS-CPM: SEG-Y log (*.sgy),Position log (*-position.csv) and PPK log from PPK device (*.pos). See LogFiles Management to find instructions how to download logs from SkyHub device.

    2. Open UgCS-CPM and go to Tools > SEG-Y Postprocessing.

    3. Press the Browse buttons to choose the required log files.

    SEG-Y Postprocessing Tool SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 62 Revision 4 • September 2020

  • Figure 11.5 — UgCS-CPM SEG-Y Postprocessing Tool

    4. Press the Start button. After few seconds UgCS-CPM will create a new *-ppk.sgyfile near with original SEG-Y file.

    5. Open created file by compatible software.

    SEG-Y Postprocessing Tool SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 63 Revision 4 • September 2020

  • Update Firmware

    1. Connect the PC to the SkyHub using Wi-Fi (see Connect to SkyHub Using Wi-Fi) or bywire (see Connect to SkyHub Using Ethernet).

    2. Open UgCS-CPM and go to Tools > Manage SkyHub

    Figure 11.6 — SkyHub settings window

    3. The SkyHub (Aux) indicator is green when there is the connection to the SkyHubdevice via Ethernet or Wi-Fi and red otherwise.

    4. The latest SkyHub firmware compatible with the installed UgCS-CPM is located inUgCS-CPM/firmware folder. Also, the latest SkyHub firmware is available here:https://industrial.ugcs.com/dl/s/skyhub-armhf

    5. Click the Browse button and choose the firmware archive file then press the Updatebutton.

    6. Wait for the progress bar becomes filled and check the firmware version after itappears.

    Update Firmware SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 64 Revision 4 • September 2020

    https://industrial.ugcs.com/dl/s/skyhub-armhf

  • Figure 11.7 — Updated firmware

    Update Firmware SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 65 Revision 4 • September 2020

  • Uninstall FirmwareImportant: This article is intended for advanced users only.

    1. Connect the PC to the SkyHub using Wi-Fi (see Connect to SkyHub Using Wi-Fi) or bywire (see Connect to SkyHub Using Ethernet).

    2. Download the latest firmware from our website:https://industrial.ugcs.com/dl/s/skyhub-armhf

    3. Upload manually the firmware to MicroSD root (path: /run/media/mmcblk1p1) byFTP/SCP client.

    4. Connect to the SkyHub via ssh and move to the MicroSD root.

    5. Unpack the firmware package and manually run the script to uninstall the SkyHubfirmware from the device:

    $ tar -xvf skyhub-armhf-*.tar.gz$ skyhub-armhf-*/uninstall.sh

    If the firmware is uninstalled, the configuration file is also deleted, but log files in the folder/run/media/mmcblk1p1/skyhub_logs/ are kept.

    Uninstall Firmware SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 66 Revision 4 • September 2020

    https://industrial.ugcs.com/dl/s/skyhub-armhf

  • 12 • Configuration Parameters

    • Configuration file location: /etc/skyhub/skyhub.conf• File format: INI (https://en.wikipedia.org/wiki/INI_file)

    Important: The SkyHub device should be restarted after any change in the configuration fileby reboot command or by power cycling.

    SkyHub Configuration

    Table 12.1 — SkyHub settings

    ParameterDefaultValue

    Description

    [ALGORITHMS]

    GRASSHOPPER true Using the Grasshopper algorithm.Set to false if not used.

    TERRAIN_FOLLOWING trueUsing the True Terrain Followingalgorithm.Set to false if not used.

    [APP]

    DISABLE_WIFI_IN_AIR falseDisable Wi-Fi when the drone is in air.Set to true for Wi-Fi stops workingafter takeoff.

    LOG_SPLIT_SIZE_MB 0 Log splitting by file size, MB

    LOG_SPLIT_TIME_S 0 Period of log splitting, s

    LOG_SPLIT_TRACES 0Log splitting by trace number(applicable to GPR and echosounderonly)

    LOG_SPLIT_WAYPOINTS 0Log splitting by waypoint count. Whenset to 1, each log will contain one linewith two waypoints.

    MIN_FREE_SPACE_MB 300 Minimum allowable free space on themicroSD card, MB

    PAYLOAD_START_DELAY_S 5 Start payload plugins delay, s

    12 • Configuration Parameters SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 67 Revision 4 • September 2020

    https://en.wikipedia.org/wiki/INI_file

  • ParameterDefaultValue

    Description

    POSITION_LOG_PERIOD_MS 100 Period of writing to position log, ms

    STATUS_PERIOD_MS 500 Period of payload status sending toground, ms

    TELEMETRY_PERIOD_MS 200 Telemetry data refresh period, ms

    [AUTOPILOTS]

    DJI false Using the DJI autopilot.Set to true if DJI drone is used.

    MAVPILOT falseUsing the MAVLink-based autopilot.Set to true if ArduPilot-driven drone isused.

    [PAYLOADS]

    ATTOLLO_WASP falseUsing the Attollo WASP-200 laseraltimeter.Set to true if used.

    ECHOLOGGER_ECT falseUsing the Echologger ECT400echosounder.Set to true if used.

    LIGHTWARE_SF falseUsing the Lightware SF11/C laseraltimeter.Set to true if used.

    NANORADAR_NRA falseUsing the Nanoradar NRA24 radaraltimeter.Set to true if used.

    PERGAM_FALCON false Using the Pergam Falcon gas detector.Set to true if used.

    PERGAM_LMM false Using the Pergam LMM gas detector.Set to true if used.

    RADARTEAM_COBRA falseUsing the Radarteam Cobra lowfrequency GPR.Set to true if used.

    RADSYS_ZOND falseUsing the RadSys Zond-12e highfrequency GPR.Set to true if used.

    12 • Configuration Parameters SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 68 Revision 4 • September 2020

  • Table 12.2 — SkyHub advanced settings

    ParameterDefaultValue

    Description

    [APP]

    VERBOSE false Log the debug info to the system log(used for debugging only)

    12 • Configuration Parameters SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 69 Revision 4 • September 2020

  • Autopilot ConfigurationDJI Autopilot Configuration

    Table 12.3 — DJI autopilot settings

    ParameterDefaultValue

    Description

    [DJI]

    APP_ID 1071019 DJI App ID

    APP_KEY 42873…30b25 DJI App Key

    BAUD_RATE 230400 UART baud rate, bps

    RESPONSE_TIMEOUT_S 1 DJI response timeout, s

    SENDING_PERIOD_MS 20 Period of data sending to ground, ms

    SERIAL_DEVICE /dev/ttymxc3 UART serial device

    ArduPilot Configuration

    Table 12.4 — ArduPilot connection settings

    ParameterDefaultValue

    Description

    [MAV]

    BAUD_RATE 57600 UART baud rate, bps

    COMPONENT_ID 5 MAVLink component Id of SkyHub

    SENDING_PERIOD_MS 20Delay between sends of sensor datafrom internal queue to the groundstation.

    SERIAL_DEVICE /dev/ttymxc3 UART serial device

    SYSTEM_ID 2 MAVLink system Id of SkyHub

    V2_EXTENSION falseUsing MAVLink V2_EXTENSIONmessages.Set to true to enable it.

    Autopilot Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 70 Revision 4 • September 2020

  • Flight Control Mode ConfigurationTrue Terrain Following Configuration

    Table 12.5 — TTF settings

    ParameterDefaultValue

    Description

    [TF]

    ACCEL_XY 0.5 Horizontal acceleration, m/s²

    ACCEPTANCE_RADIUS_M 1Radius of waypoint neighborhood inwhich it is considered the vehiclereached the waypoint, m

    ALTITUDE_SOURCE ALTIMETER

    • ALTIMETER: Use externalaltimeter as altitude source

    • AUTOPILOT: Use autopiot asaltitude source

    ALT_ACCEL 0.5 Vertical acceleration, m/s²

    ALT_P 1 Proportional term of the PID altitudecontroller, m/s²

    CLIMB_RATE 1 Climb rate, m/s

    DESCENT_RATE 1 Descent rate, m/s

    FAIL_SAFE_ALTITUDE_M 20 Fail safe altitude, m

    FLIGHT_SPEED_MPS 1

    Fligh speed, m/s. Maximum allowedvalue is 3.5 m/s when whenVELOCITY_CONTROL is set to false andequals 20 m/s whenVELOCITY_CONTROL is set to true

    POS_P 0.5

    Proportional term of the PID positioncontroller, m/s². The higher value, thefaster the vehicle approaches to thewaypoint. Recommended range is from0.4 to 0.7

    TARGET_ALTITUDE_M 3 Target flight altitude, m

    Flight Control Mode Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 71 Revision 4 • September 2020

  • ParameterDefaultValue

    Description

    TURN_TYPE SPLINE

    • SPLINE: Spline turn mode• STRAIGHT: Straight turn mode• STOP_AND_TURN: Turn mode

    with stop

    VELOCITY_CONTROL false

    • false: Flight is controlled byposition (TTF v1.0)

    • true: Flight is controlled byvelocities (TTF v2.0)

    Grasshopper Mode Configuration (beta)

    Table 12.6 — GH settings

    ParameterDefaultValue

    Description

    [GH]

    ALTITUDE_SOURCE ALTIMETER

    • ALTIMETER: Use externalaltimeter as altitude source

    • AUTOPILOT: Use autopilot asaltitude source

    HOVER_TIME_S 3

    Drone hover time at the measuringpoint, s.Set the negative value (ex. -1) formanual operation mode.

    TARGET_ALTITUDE_M 2 Target descending altitude, m

    VERTICAL_SPEED_MPS 1Vertical speed, m/s.Doesn’t set in current version. Defaultvalue is used only.

    Flight Control Mode Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 72 Revision 4 • September 2020

  • Altimeter Configuration

    Table 12.7 — Common altimeter settings

    ParameterDefaultValue

    Description

    [ALTIMETER]

    IGNORE_ERRORS 0 Maximum number of ignoring failsreceived in a row

    MAX_ALTITUDE_M 20 Max altitude value, m

    MIN_ALTITUDE_M 0.5 Min altitude value, m

    ZERO_LEVEL_M 0 Altimeter position above ground level

    LP_FILTER_LENGTH 0

    (experimental option) Low-pass filterlength. Filter disabled by default (i.e.length equals 0). Available options are:0, 8, 12, 16, 20, 24, 28, 32

    Altimeter Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 73 Revision 4 • September 2020

  • Nanoradar NRA24 Altimeter Configuration

    Table 12.8 — Nanoradar NRA24 altimeter settings

    ParameterDefaultValue

    Description

    [NANORADAR_NRA]

    AVERAGING 2 Averaging factor. The more is thesmoother but rarer.

    BAUD_RATE 115200 UART baud rate, bps

    SERIAL_DEVICE /dev/ttymxc5UART serial device:

    • /dev/ttymxc5 for UART1 (5-pin)• /dev/ttymxc1 for UART2 (4-pin)

    Attollo WASP-200 Altimeter Configuration

    Table 12.9 — Attollo WASP-200 altimeter settings

    ParameterDefaultValue

    Description

    [ATTOLLO_WASP]

    AVERAGING 8 Averaging factor. The more is thesmoother but rarer.

    BAUD_RATE 115200 UART baud rate, bps

    FREQUENCY_HZ 7 Measuring frequency, Hz

    SERIAL_DEVICE /dev/ttymxc5UART serial device:

    • /dev/ttymxc5 for UART1 (5-pin)• /dev/ttymxc1 for UART2 (4-pin)

    Altimeter Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 74 Revision 4 • September 2020

  • Lightware SF11/C Altimeter Configuration

    Table 12.10 — Lightware SF11/C altimeter settings

    ParameterDefaultValue

    Description

    [LIGHTWARE_SF]

    CONNECTION_TYPE I2CConnection type:

    • I2C for I²C connection• UART for serial connection

    I2C_DEVICE_ADDRESS 0x66 I²C device address in hexadecimalnotation

    UART_BAUD_RATE 115200 UART baud rate, bps

    SERIAL_DEVICE /dev/ttymxc5UART serial device:

    • /dev/ttymxc5 for UART1 (5-pin)• /dev/ttymxc1 for UART2 (4-pin)

    Altimeter Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 75 Revision 4 • September 2020

  • GPR ConfigurationLow Frequency GPR Configuration

    Table 12.11 — Low Frequency GPR settings

    ParameterDefaultValue

    Description

    [RADARTEAM_COBRA]

    BLUETOOTH_NAME RT[0-9]+ Bluetooth name of GPR device. May bea regular expression.

    MODEL SE-150 GPR model. Added to the SEG-Y logheader.

    TELEMETRY_PERIOD_MS 2000 Telemetry data refresh rate, ms

    TIME_RANGE_NS 800Trace time range, ns:

    • 800 for newer devices• 1600 for older devices

    High Frequency GPR Configuration

    Table 12.12 — High Frequency GPR settings

    ParameterDefaultValue

    Description

    [RADSYS_ZOND]

    FILTER_1 OFF

    High pass filter for the first channel:• OFF: High pass filter is off• WEAK: Weak high pass filter• STRONG: Strong high pass filter• SUPER_STRONG: Super strong

    high pass filterThis parameter is also applicable insingle-channel mode.

    FILTER_2 OFF High pass filter for the second channel.See FILTER_1 values.

    IP_ADDRESS 192.168.0.10 IP-address of the GPR

    GPR Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 76 Revision 4 • September 2020

  • ParameterDefaultValue

    Description

    MODE CHANNEL_1

    GPR channel mode:• CHANNEL_1: Single-channel, the

    first channel is active• CHANNEL_2: Single-channel, the

    second channel is active• TWO_CHANNELS: Dual-channel,

    both channels are active• TX1_RX2: The first channel

    transmitter to the second channelreceiver

    • TX2_RX1: The second channeltransmitter to the first channelreceiver

    • CIRCLE: Circle mode

    OFFSET_FORWARD_M_1 0 Offset of the first antenna alongside theheading line, m

    OFFSET_FORWARD_M_2 0 Offset of the second antenna alongsidethe heading line, m

    OFFSET_RIGHT_M_1 0 Offset of the first antenna alongside thetraverse line, m

    OFFSET_RIGHT_M_2 0 Offset of the second antenna alongsidethe traverse line, m

    PORT 23 TCP-port of the GPR

    PULSE_DELAY_1 0

    Pulse delay for the first channel. Shouldbe set up during the calibration.From 0 to 1023.This parameter is also applicable insingle-channel mode.

    PULSE_DELAY_2 0 Pulse delay for the second channel.See PULSE_DELAY_1 values.

    RAW_LOG false Log the raw data from echosounder(used for debugging only)

    GPR Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 77 Revision 4 • September 2020

  • ParameterDefaultValue

    Description

    SOUNDING_MODE SOUNDING

    Possible values are:• SOUNDING: Normal operation

    mode• CALIBRATION: Sine wave with

    frequency 20 MHz• TEST: Sine wave with constant

    period for any settings

    SAMPLE_COUNT 256 Sample count per trace:128, 256, 512, 1024

    TELEMETRY_PERIOD_MS 2000 Telemetry data refresh rate, ms

    TIME_RANGE_NS_1 300

    Trace time range for the first channel,ns:12, 25, 50, 100, 200, 300, 500, 800,1200, 2000.This parameter is also applicable insingle-channel mode.

    TIME_RANGE_NS_2 300Trace time range for the secondchannel, ns.See TIME_RANGE_1 values.

    GPR Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 78 Revision 4 • September 2020

  • Echosounder Configuration

    Table 12.13 — Common echosounder settings

    ParameterDefaultValue

    Description

    [ECHOSOUNDER]

    CABLE_LENGTH_M 0 Echosounder cable length, m

    MAX_DEPTH_M 20 Max depth value, m

    MIN_DEPTH_M 0.5 Min depth value, m

    Echologger ECT400 Configuration

    Table 12.14 — Echologger ECT400 settings

    ParameterDefaultValue

    Description

    [ECHOLOGGER_ECT]

    ALT_THRESHOLD_PCT 10 Altimeter threshold in percents of a fullscale

    BAUD_RATE 115200 UART baud rate, bps

    DEADZONE_MM 300 Near field zone where detection isignored, mm

    FREQUENCY_HZ 10 Measuring frequency, Hz

    GAIN_DB 0 Amplifying gain, dB

    MODE NMEA

    • NMEA: Ouptut data in NMEAformat only

    • ECHOSOUNDER: Output data inNMEA and SEG-Y formats

    RANGE_M 8 Measuring range, m

    RAW_LOG false Log the raw data from echosounder(used for debugging only)

    Echosounder Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 79 Revision 4 • September 2020

  • ParameterDefaultValue

    Description

    SERIAL_DEVICE /dev/ttymxc1 Serial device name. Use UART2 (4-pin)only.

    START_DELAY_S 45 Start delay, s

    TXLENGTH_US 50

    Transmitted pulse length, microsecond.The value is automatically increased ifit is less than the required value.

    MAX_SENSOR_ANGLE_DEG 10Data filtering by tilt. The data are notrecorded if the sensor tilt value isgreater than the specified value, degree.

    MIN_SENSOR_DEPTH_M 0.1

    Data filtering by sensor dept in thewater.Sensor depth is calculated as adifference between the length of thecable (set by CABLE_LENGTH_Mparameter in the ECHOSOUNDERsection) and current altitude.The data are not recorded if the sensordepth is lower than specified value, m.

    Echosounder Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 80 Revision 4 • September 2020

  • Gas Detector Configuration

    Table 12.15 — Common gas detector settings

    ParameterDefaultValue

    Description

    [GAS_DETECTOR]

    MAX_CONCENTRATION_PPM 1000 Max gas concentration, PPM

    MIN_CONCENTRATION_PPM 0 Min gas concentration, PPM

    ZERO_LEVEL_PPM 0 Background gas concentration value tobe subtracted, PPM

    Pergam Falcon Configuration

    Table 12.16 — Pergam Falcon settings

    ParameterDefaultValue

    Description

    [PERGAM_FALCON]

    FREQUENCY_HZ 2 Measuring frequency, Hz

    SERIAL_DEVICE /dev/ttyUSB0 UART serial device. The built-in PergamFalcon UART adapter is used.

    Pergam LMm Configuration

    Table 12.17 — Pergam LMm settings

    ParameterDefaultValue

    Description

    [PERGAM_LMM]

    FREQUENCY_HZ 2 Measuring frequency, Hz

    SERIAL_DEVICE /dev/ttymxc5UART serial device:

    • /dev/ttymxc5 for UART1 (5-pin)• /dev/ttymxc1 for UART2 (4-pin)

    Gas Detector Configuration SkyHub User Manual

    Copyright © 2019—2020, SPH Engineering 81 Revision 4 • September 2020

  • Metal Detector Configuration

    Table 12.18 — Common metal detector settings

    ParameterDefaultValue

    Description

    [METAL_DETECTOR]

    MAX_OUTPUT_VALUE_MV 1000 Max output metal detector value, mV

    MIN_OUTPUT_VALUE_MV 0 Min output metal detector value, mV

    Geonics EM-61 Configuration

    Table 12.19 — Geonics EM-61 setting