Professional Documents
Culture Documents
edition
Contents
1 Introducing Erle-Copter 3
1.1 A marketplace for drone apps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 Parts 4
4 Learn to y 9
4.1 Flying modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5 First ight 14
5.1 Attaching propellers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.2 Connecting to Erle-Brain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.3 Steps to ight save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6 Store 16
6.1 Snappy Ubuntu Core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.1.1 Software architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.2 Installing an app (snap) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.3 Creating a drone app . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
6.3.1 Building the app . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.3.2 Installing the app . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.3.3 Running the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.3.4 Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
A Erle-Brain 21
B ROS 22
C Specication 23
D Resources 23
E License 24
1 INTRODUCING ERLE-COPTER
Erle-Copter is a Linux-based drone that uses robotic frameworks such as ROS (the Robot Oper-
ating System) and the award winning APM software autopilot to achieve different ight modes.
Its ideal for outdoor operations and it has been designed for an extended ight time with a
takeoff weight of up to 2 kilograms.
Erle-Copter is the rst smart drone that ies with Snappy Ubuntu Core and includes
ROS as the SDK for drone app development.
More at ubuntu.com/things.
2 PARTS
Below the parts that Erle-Copter contains are described. Do not hesitate and ask questions in
our forum.
Radio controller
4 x Brushless motors.
GPS + Compass
Propellers 104.5
Fly in very large open area void of obstacles and away from trafc and people. Be aware
of surroundings.
Be sure you have calibrated the IMUs and the compass and you hace GPS x (Slow con-
tinuous blue ashing).
Erle-Copter will not avoid obstacles on its own unless it has been programmed for
it. As the operator, it is your job to recognize and avoid obstructions while ying.
Always y in an open area away from people and buildings; do not attempt to y
indoors or in a conned space.
Erle-Copter has powerful motors and high-speed propellers. Never place your
hands near the propellers while Erle-Copter is armed.
All unmanned aerial vehicle (UAV) operators should abide by all regulations from such
organizations as the ICAO (International Civil Aviation Organization) and their own na-
tional airspace regulations.
FRAME 1: SAFETY
Environmental factors, such as wind and GPS irregularities, can cause instability in ight.
Erle-Copter will attempt to compensate for these factors by triggering a failsafe if it de-
tects an unsafe ying condition due to loss of controller signal, loss of GPS signal, or low
battery (see below for details). If you observe any inconsistent behavior, land, and con-
sult our team at forum.erlerobotics.com.
RADIO FAILSAFE
Always use the controller as a primary or backup control system when ying. Ensure that the
controller is turned on any time Erle-Copter is powered. If this failsafe is enabled it will get
triggered under the following circumstances:
The wires connecting the receiver to the ight controller are broken (unlikely).
Motors will be immediately disarmed if the vehicle is landed OR in stabilize or acro mode
and the pilots throttle is at zero
Return-to-Launch (RTL) if the vehicle has a GPS lock and is more than 2 meters from the
home position.
no GPS lock OR
is within 2 meters of home OR
the FS_THR_ENABLE parameter is set to Enabled Always Land
Continue with the mission if the vehicle is in AUTO mode and the FS_THR_ENABLE pa-
rameter is set to Enabled Continue with Mission in Auto Mode.
The GPS Failsafe is enabled by default but you can enable or disable it on the Mis-
sion Planners Standard Parameter List, by set the FS_GPS_ENABLE parameter to
0 (Disable) or 1 (Land) or 2 (switch to AltHold). It is highly recommended to leave it
enabled and no known reason why it should ever be disabled.
If you lose GPS lock or experience a GPS Glitch for 5 seconds while in a mode that
requires the GPS (Auto, Guided, Loiter, RTL, Circle, Position or Drift) mode it will
initiate a Land (or AltHold if FS_GPS_ENABLE is set to 2).
LOW BATTERY
When the battery reaches a low state (voltage under certain value), Erle-Copter will land with
a quick repeating tone. If Erle-Copter reaches the low battery limit during a mission, it will re-
turn to the launch point before landing.
This failsafe permits to you to minimize the risks of having a sudden death of Erle-Copter
and enables a better use of your LiPo batteries.
More about low failsafe battery here.
When the failsafe triggers, Erle-Brains tone-alarm will sound. If telemetry is attached
EKF variance will appear on the HUD. And EKF/DCM error will be written to the
dataash logs.
If ying in a ight mode that does not require GPS nothing further will happen but
you will be unable to switch into an autopilot ight mode (Loiter, PosHold, RTL, Guided,
Auto) until the failure clears. If ying in a mode that requires GPS (Loiter, PosHold, RTL,
Guided, Auto) the vehicle will switch to pilot controlled LAND. Meaning the pilot will
have control of the roll and pitch angle but the vehicle will descend, land and nally
disarm its motors. The pilot can, like always switch into a manual ight mode including
Stabilize or AltHold to bring the vehicle home.
The EKF check and failsafe can be disabled by setting the EKF_CHECK_THRESH to 0 through
the Ground Control Stations Cong/Tuning Full Parameter List. Alternatively it can be made
less sensitive by increasing this parameter from 0.8 to 0.9 or 1.0. The downside of increasing
this parameters value is that during a yaway caused by a bad compass or GPS glitching, the
vehicle will y further away before the vehicle is automatically switched to LAND mode.
4 LEARN TO FLY
THROTTLE
YAW
Flight Tip
When adjusting orientation, move the left stick horizontally without changing its vertical
position.
Flight Tip
Erle-Copter moves according to its orientation. The yellow arms face forward, and the
black arms face backward. Before using the right stick, use yaw to keep Erle-Copter fac-
ing in outward orientation so that the black arms face towards you and the yellow arms
face away from you.
STABILIZE
Stabilize mode allows you to y your vehicle manually, but self-levels the roll and pitch axes.
ALT HOLD
In altitude hold mode, the copter maintains
a consistent altitude using the internal pres-
Note
sure sensors while allowing roll, pitch, and
In order to maintain the altitude in this
yaw to be controlled normally.
mode the throttle stick should be in the
middle (40% to 60%).
Altitude hold mode is used as the basis of au-
tonomous modes such as LOITER, AUTO, etc.
LOITER
Loiter mode automatically attempts to maintain the current location, heading and altitude us-
ing GPS. The pilot may y the copter in Loiter mode as if it were in manual. Releasing the sticks
will continue to hold position.
Note
Good GPS position, low magnetic interference on the compass and low vibrations are all
important in achieving good loiter performance.
RTL
RTL stands for Return to Launch and when activated, Erle-Copter navigates from its current
position to hover above the home position. The home positioned is set as the point where the
copter was armed.
The copter will rst rise to RTL_ALT before returning home or maintain the current altitude
if the current altitude is higher than RTL_ALT. The default value for RTL_ALT is 15m.
GUIDED
Guided mode is not a traditional ight mode that would be assigned to a mode switch like other
ight modes. The guided mode capability is enabled using a ground station application and
telemetry radio. This capability allows you to interactively command the copter to travel to a
target location by clicking on a point on the Ground Station Flight Data map. Once the location
is reached, the copter will hover at that location, waiting for the next target.
FOLLOW ME
The follow me mode makes it possible for you to have your copter follow you as you move, using
a telemetry radio and a ground station. its easiest to use a phone or tablet as your Follow Me
ground station . Follow Me mode uses dynamic waypoint feature.
AUTO
In Auto mode Erle-Copter will follow a pre-programmed mission script stored in the brain which
is made up of navigation commands (i.e. waypoints) and do commands (i.e. commands that
do not affect the location of the copter including triggering a camera shutter).
Note
Auto mode incorporates the altitude control from altitude hold mode and position con-
trol from Loiter mode and should not be attempted before these modes are ying well.
All the same requirements apply including ensuring that vibration levels and compass in-
terference levels are acceptable and that the GPS is functioning well including returning
an HDOP of under 2.0.
AUTOTUNE
AutoTune attempts to tune the stabilization algorithm to provide the highest response without
signicant overshoot. It does this by twitching the copter in the roll and pitch access which
means that the copter needs to be basically yable in AltHold mode before attempting to use
AutoTune.
FRAME 2: NOTE
This mode is just to optimize copters ight, Erle-Robotics will deliver vehicles parame-
ters list to the customers.
5 FIRST FLIGHT
Propeller
Note
Ensure that the controller is always turned on while Erle-Copter is powered.
6 STORE
This section will describe the app store for robots (drones) that Erle Robotics is pushing through
its partnership with Canonical to support the next generation of drones that will be connected
to the internet, update automatically and will have access to an app store for drones. Following
up with our passion for bringing Linux-based drones to the market we are happy to share that
the rst apps are starting to show up in the store and are freely available.
Weve partnered with Canonical to deliver the next generation of robots connected to the
internet and having access to automatic security upgrades, applications and developer tools.
There are four layers that make up a snappy machine: the hardware layer, provided by the
device manufacturer or Canonical, the system layer, provided by Canonical, a layer of frame-
works that extend the base system produced by vendors in collaboration with Canonical, and a
set of snappy applications, provided directly by vendors. Updating any piece just means using
the new version of a read-only image, reverting to a previous version is just as easy.
Once the process has nished, youll get a screen like the following:
All done! Now you have hello world app installed and run the app with:
echo.hello-world.canonical
obtaining:
Hello World
The following code will help us understand how to create a simple drone application that
will print in the standart output the date in the drone.
FRAME 5: STRUCTURE
meta
erle-small.png
package.yaml
readme.md
src
script.sh
a meta folder
FRAME 6: META/PACKAGE.YAML
name: erle-date.erle
vendor: Erle Robotics
icon: meta/erle-small.png
version: 1.0
architecture: armhf
binaries:
- name: src/script.sh
maintainer: Erle Robotics
FRAME 7: META/README.MD
Erle Robotics date snap example
FRAME 8: SRC/SCRIPT.SH
#!/bin/bash
From the root directory of the app we proceed using the following command:
snappy build .
After having installed the app, you should be able to run it through:
erle-date.erle.script.sh
6.3.4 SOURCES
A ERLE-BRAIN
Erle-brain is an open hardware and open source Linux-based autopilot to make drones. It con-
sists of a BeagleBone Black and a PixHawk Fire Cape and comes with a Debian image ashed,
ROS preinstalled and the latest ready to y code.
APM
9 PWM outputs
B ROS
ROS (Robot Operating System) is a BSD-licensed system for controlling robotic components
from a PC. A ROS system is comprised of a number of independent nodes, each of which com-
municates with the other nodes using a publish/subscribe messaging model. For example, a
particular sensors driver might be implemented as a node, which publishes sensor data in a
stream of messages. These messages could be consumed by any number of other nodes, in-
cluding lters, loggers, and also higher-level systems such as guidance, pathnding, etc.
Note that nodes in ROS do not have to be on the same system (multiple computers) or even
of the same architecture. You could have a Arduino publishing messages, a laptop subscribing
to them, and an Android phone driving motors. This makes ROS really exible and adaptable
to the needs of the user. ROS is also open source, maintained by many people.
C SPECIFICATION
Autopilot Erle-Brain
Firmware ArduCopter
GPS uBlox GPS with Compass
Telemetry radio Radio Telemetry (915 MHz or 433 MHz)
Motors 950 kV
Frame type X
Propellers PROPELLERS 104.5 counterclockwise (PAIR)
PROPELLERS 104.5 clockwise (PAIR)
Low battery voltage 10.5V
High battery voltage 12.6V
Battery cell limits 4S
Radio range up to 1 Km
Flight time 15-20 minutes*
D RESOURCES
Hardware https://erlerobotics.com/blog/erle-copter/
Store https://erlerobotics.com/blog/tienda
Forum forum.erlerobotics.com
Online doc Erle-Copter gitbook
E LICENSE
Unless specied, this content is licensed under the Creative Commons Attribution-NonComercial-Share Alike 3.0 Unported License. To view
a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite
300, San Francisco, California, 94105, USA.
If you plan on using this material for commercial purposes get in touch with us at contact@erlerobot.com