Doodle Labs User Guide

Table of contents

1. Overview
2. Requirements
   1. Hardware
      1. VOXL 2 10-pin USB Add-on Boards
      2. Legacy 4-pin USB Add-on Boards
   2. Software
      1. VOXL 2
      2. VOXL
3. Hardware Setup
   1. VOXL Hardware Setup
      1. Using M0078
   2. Ground Station Hardware Setup
4. Software Setup
   1. VOXL 2 Software Setup
   2. Ground Station Software Setup
5. Connecting to QGroundControl

Overview

VOXL and VOXL2 support the ability to quickly and easily add a Doodle Labs wireless connection to a Ground Control Station. The following guide provides you the necessary details to do so.

Below are some helpful link from Doodle Labs:

Doodle Labs Technical Library

Doodle Labs Datasheets

Doodle Labs Helix Datasheet

Requirements

Hardware

The following ModalAI hardware is required to establish a Doodle Labs network connection between a VOXL-based product and a host device (computer, tablet, etc.).

VOXL 2 10-pin USB Add-on Boards

Compatible add-on boards for VOXL 2 (M0154 - Purchase) and MCBL-00085

Legacy 4-pin USB Add-on Boards

Software

In order for the required drivers to be available on target, the following software is required:

VOXL 2

• VOXL 2 Platform Release 1.3.1-0.8+
• voxl-modem_0.16.0+

VOXL

• VOXL Platform Release 3.8.0-0.8+
• voxl-modem_0.16.0+

Hardware Setup

Below is a list of required hardware in order to create a connection between a VOXL-based device and a ground control station via. Doodle Labs Helix modems.

Below are the pinout details for the modified 15-pin modem to 4-pin JST cable, or use MCBL-00068-1:

VOXL Hardware Setup

Using M0078

The USB Expansion Board with Fastboot v2 exposes a USB 2.0 port on VOXL and VOXL2, and provides up to 5A to peripherals.

Pictured above for your reference is a VOXL 2 flight deck with all cameras connected and Doodle Labs Helix connected.

IMPORTANT! Before modifying hardware setup, ensure power is off or disconnected.

• Attach M0078 add-on board to J3 of VOXL 2.

• Ensure jumper is set to USB PWR 5V side in order to provide sufficient power to modem.

• Attach antennas to ports on Helix modem, if doing desktop development use the attenuators between cable and antenna in order to prevent RF saturation in a bench top environment.

• Use modified 15-pin to 4-pin JST cable to connect modem to J3 of M0078

• Attach M0041 APM to VOXL 2 and provide power

• Plug in USB-C cable from desktop to VOXL 2 in order to access ADB later on.

Ground Station Hardware Setup

Pictured above for your reference is a ground station setup showing a Doodle Labs Helix modem and breakout board.

IMPORTANT! Before modifying hardware setup, ensure power is off or disconnected.

• Attach antennas to ports on Helix modem, if doing desktop development use the attenuators between cable and antenna in order to prevent RF saturation in a bench top environment.

• Use un-modified 15-pin to 15-pin cable to connect the Helix modem to the breakout board

• Use USB-C cable to breakout board to host ground station

• Connect power (5V) to green connector, see above photo to determine +(red) and -(black)

• Turn on power from power supply

Software Setup

VOXL 2 Software Setup

• adb onto VOXL 2

adb shell

voxl2:/$

• Run the following the begin modem setup:

voxl2:/$ voxl-configure-modem 
 
What type of modem are you using?

If you are unsure of which modem you have, take a look at the following datasheets:

v2 LTE Modem: https://docs.modalai.com/lte-modem-and-usb-add-on-v2-datasheet/
Microhard Modem: https://docs.modalai.com/microhard-add-on-datasheet/

1) v2
2) microhard
3) doodle
4) quectel

• Select doodle from the menu

#? 3
 
Enter the IP address you would like to the VOXL to use on the Doodle network:
Note: The chosen IP address must be of the form: 10.223.0.XXX

Default - 10.223.0.100

1) default
2) custom

• Select the static IP you would like your VOXL 2’s eth0 network interface to be set to, either choose default or another IP on the 10.223 subnet

#? 1 

qrb5165 based device detected
reloading systemd services
enabling voxl-modem systemd service
starting voxl-modem systemd service
DONE configuring voxl-modem

• The VOXL2 will now enable the voxl-modem service in order to enable the Helix modem connection and set the static IP on bootup

• Verify that the eth0 network interface has enumerated and that the IP has been set correctly:

ifconfig eth0
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.223.0.100  netmask 255.0.0.0  broadcast 10.255.255.255
        ether 00:30:1a:4f:96:05  txqueuelen 1000  (Ethernet)
        RX packets 2930  bytes 661816 (661.8 KB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 5264  bytes 290037 (290.0 KB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

Ground Station Software Setup

• Set a static IP address for the host PC on the Doodle network, Ubuntu 18.04 shown below:

In this case, the IP address of the host PC will be set to 10.223.0.150

Connecting to QGroundControl

Now that both the VOXL side and ground station side software have been setup you should be able to ping one device from the other.

For example, one can ping the ground station from VOXL by doing the following:

voxl2:/$ ping 10.223.0.150
PING 10.223.0.150 (10.223.0.150): 56 data bytes
64 bytes from 10.223.0.150: icmp_seq=0 ttl=64 time=0.126 ms
64 bytes from 10.223.0.150: icmp_seq=1 ttl=64 time=0.169 ms
64 bytes from 10.223.0.150: icmp_seq=2 ttl=64 time=0.115 ms
64 bytes from 10.223.0.150: icmp_seq=3 ttl=64 time=0.117 ms
64 bytes from 10.223.0.150: icmp_seq=4 ttl=64 time=0.121 ms

Since we are able to get packets from drone to ground station we can now connect our VOXL 2 / drone to QGroundControl.

Check the configuration of voxl-mavlink-server if it does not connect immediately. voxl-mavlink-server is the main routing process for MAVLink data on VOXL 2.