Workshop Sensors Fusion Library for Kinetis MCUs

Workshop Sensors Fusion Library for Kinetis MCUs
12/19/2014 11:25:38 AM
Workshop: Freescale
Sensor Fusion Library
for Kinetis MCUs
Lendo os movimentos da IoT
Agenda
Part 1: Motion Sensors Overview
Part 2: Movement and Orientation
• Part 3: Introduction to Sensor Fusion
• Part 4: Freescale Sensor Fusion Toolbox
• Part 5: Lab #1 – Play with fusion options
•
•
hour 1
Alessandro Cunha | FAE
Break
dez.2014
•
hour 2
Part 6: Freescale Sensor Fusion Library
Break
Part 7: Lab #2 – Build the embedded firmware
Part 8: Optional Lab #3 – Make some changes
• Part 9: Odds & Ends and Wrap-up
•
TM
hour 3
•
External Use
TM
External Use
1
Sensor Portfolio
Automotive, industrial, medical and consumer absolute and
differential sensors
Flow, comfort management, HVAC, medical, engine control
Pressure
Freescale Sensors Overview
TM
Accelerometer
Consumer and industrial low-g sensors and tilt sensors
Automotive medium- and high-g crash sensors
Vehicle stability, airbag, vibration monitor, tilt alignment
Magnetometer
Consumer and industrial magnetic field sensor and 3D
compass
Orientation alignment, proximity detection, magnetic switch
Gyroscope
Consumer and industrial angular rate sensors and 6/9-DOF
IMU
Automotive roll sensor and IMU
Stabilization, motion and gesture HMI, inertial navigation, gaming
Sensing
systems
Consumer and industrial MCU and sensor integrated platforms
Automotive tire pressure monitoring system
Smart sensors, pedometer, anti-tamper, fault prognostication
TM
External Use
2
External Use
3
Kinetis Microcontrollers Family
Freescale Microcontrollers Overview
TM
TM
External Use
4
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
5
1
12/19/2014 11:25:38 AM
Kinetis Microcontrollers
Freedom Boards K64F / K24F
Performance
World’s Broadest ARM Cortex-M Portfolio
Kinetis X Series
Kinetis K Series
Kinetis E Series
Kinetis L Series
Ultra-low power/cost ARM
Cortex-M0+ MCU families
from 48MHz / 8KB with mixedsignal, connectivity & HMI
features in low pin-count
packages.
Robust, 5V ARM Cortex-M0+
MCU families for use in high
electrical noise environments.
Safety features for highreliability applications
Industry-first ARM Cortex-M4
MCU families from 50MHz /
32KB with low power,
FlexMemory, mixed-signal and
broad connectivity, HMI &
security features.
General Purpose
Kinetis V Series
Kinetis M Series
Kinetis W Series
Integrated wireless
connectivity ARM Cortex-M4
and M0+ MCU families with
class-leading sub-1 GHz and
2.4 GHz RF transceivers
High-performance ARM
Cortex-M7 MCU families with
advanced memory and feature
integration for robust,
networked industrial and
consumer systems.
High accuracy metrology ARM
Cortex-M0+ MCU families for
single chip smart meter
implementations.
Segment Focused
High efficiency, high speed
peripherals ARM Cortex-M0+
& Cortex-M4 MCU families for
use in motor control & power
conversion.
Integration
Leading Performance - Low Power - Scalability - Industrial-grade reliability & temp
Freescale Bundled IDE, RTOS & Middleware - Rapid prototyping Platform - Broad ARM Ecosystem Support
TM
TM
External Use
6
Freescale Confidential – NDA Required – Subject to Change
External Use
7
Freedom Board K22F
Superset board for the
following devices:
• K22FN512
• K22FN256
• K22FN128
• K02FN128
Kinetis Design Studio (KDS)
TM
TM
External Use
8
External Use
Learn more at: www.freescale.com/KDS
(coming April 2014)
Kinetis Design Studio
No-cost integrated
development environment
(IDE) for Kinetis MCUs
Eclipse and GCC-based IDE
for C/C++ editing, compiling
and debugging
Atollic TrueSTUDIO
Product Features
•
•
Application
Specific
Middleware
Stacks
(TCP/IP, USB)
Software and Hardware
Evaluation & Dev Tools
BSP, Drivers &
HAL
•
Specifically designed for microcontroller applications,
easy to learn and use, yet powerful enough for the most
demanding embedded applications
•
•
A basic IDE that offers robust editing, compiling
and debugging
Advanced RTOS-aware debugger with
ETM/ETB/SWV/ITM tracing, live variable watch view and
fault analyzer. Dual-core and multi-processor debugging.
ARM C/C++ build toolchain and Execution Profiler and
Performance Analyzer enable highly optimized programs
•
•
Strong support for software engineering, workflow
management, team collaboration and improved software
quality.
Complete Code Coverage information about your
program's execution
•
Includes Processor Expert with Kinetis SDK
integration
Host operating systems:
•
Windows 7/8
•
Linux (Ubuntu, Redhat, Centos)
•
Mac OS X
Support for SEGGER, P&E and Open
SDA/CMSIS-DAP debugger targets
•
Support for Eclipse plug-ins including RTOSawareness (i.e. MQX, FreeRTOS)
•
CodeWarrior project importer
Bootloader
MCU Hardware
Professional ECLIPSE/GNU based IDE with a MISRA-C
checker, code complexity analysis and source code
review features.
Based on Eclipse, GCC, GDB and other opensource technologies
•
Operating
System
Keil Microcontroller Development Kit
•
A free of charge and unlimited IDE for Kinetis
MCUs
•
•
(DSP, Math,
Encryption)
Kinetis IDE Options (www.freescale.com/kide)
Featured IDEs:
Customer Application
Libraries
9
Green Hills MULTI
•
Complete & integrated software and hardware
environment with advanced multicore debugger
•
Industry first TimeMachine trace debugging & profiler
•
EEMBC certified top performing C/C++ compilers
Complimentary Solutions:
Kinetis Design Studio
•
A powerful and reliable IDE designed for ease of use with
outstanding compiler optimizations for size and speed
•
The broadest Freescale ARM/Cortex MCU offering with
dedicated versions available with functional safety
certification
•
Support for multi-core, low power debugging, trace, ...
mbed Development Platforms
•
Complimentary basic capability integrated development
environment (IDE) for Kinetis MCUs
•
Eclipse and GCC-based IDE for C/C++ editing, compiling
and debugging
TM
IAR Embedded Workbench
•
The fastest way to get started with Kinetis MCUs
•
Online project management and build tools – no
installation required; option to export to traditional IDEs
•
Includes comprehensive set of drivers, stacks and
middleware with a large community of developers.
TM
External Use
10
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
11
2
12/19/2014 11:25:38 AM
Kinetis IDE Comparison
Atollic TrueStudio Pro
Free version / Limitations
Processor Expert support
IDE Framework
Debugger
Compiler
Standard Libraries
Run Control Interfaces
Trace/Profiling Support
Kinetis SDK Support
Freescale MQX Kernel /
Task Awareness
Other RTOS Support
Includes
TrueSTUDIO Lite: 32KB
8KB for Cortex-M0(+)
Yes
Improved/simplified
Eclipse
GDB + proprietary
extensions
Atollic GNU gcc v4.7.3
newlib v1.19
newlib-nano v1.0
libstdc++ v6.0.17
Green Hills MULTI
IAR Embedded
Workbench for ARM
(EWARM)
Keil PRO Edition
Microcontroller Development Kinetis Design Studio
Kit (MDK)
Yes
Evaluation: 30-days
KickStart Edition: 32KB
Yes
Yes
Yes
Proprietary
Proprietary/Eclipse
Proprietary
Eclipse
Multi
IAR C-SPY
uVison
GDB
Evaluation: 30 days
MDK Lite: 32KB
Unlimited
Multi
IAR icc/c++
armcc
GNU gcc 4.8
Multi
IAR DLIB/CMSIS
ARM MicroLib
ARM Standard
newlib 1.19
newlib-nano 1.0
GHS Probe, GHS
P&E, SEGGER, CMSIS-DAP
SuperTrace Probe,
I-jet, P&E, SEGGER,
ULINK, ULINKpro, CMSIS-DAP,
P&E, SEGGER,
(coming soon), gdbserver
OpenOCD, CMSIS-DAP OpenOCD, CMSIS-DAP
P&E, SEGGER
OpenOCD/CMSIS-DAP
compatible probes
(coming soon)
No
Yes
Yes
Yes
Yes
1.0 GA (Summer 2014)
1.0 Beta (April 2014)
1.0 GA (Summer 2014)
1.0 GA (Summer 2014)
Yes
-
Yes
Yes
Coming Soon
FreeRTOS, uC/OS
uvelOSity
FreeRTOS, uCos
FreeRTOS, uCOS, Keil RTX
FreeRTOS, uCos
Wearables
TM
TM
External Use
12
External Use
14
TM
Full Feature OS
External Use
15
Wearable Market: Segmentation
Vertical
Function Specific OS
Categories
Fitness &
Wellness
I’m Watch
Bambook
13
TM
Smart Watches Available NOW
WIMM
External Use
Shanda
Samsung
Galaxy Gear
Pebble
Sony
SmartWatch2
Vea
Metawatch
Aframe Digital
Basis
Garmin
Samsung
Martian
Watches
Impulse
Kreyos
Cuckoo
Motorola
ACTV
Casio
Sports & Heart Rate Monitors
Pedometers, Activity Monitors
Smart Sport Glasses
Smart Clothing
Sleep Monitors
Emotional Measurements
Healthcare &
Medical
CGM (Continuous Glucose Monitoring )
ECG Monitoring
Pulse Oximetry
Blood Pressure Monitors
Drug Delivery (Insulin Pumps)
Wearable Patches (ECG, HRM, SpO2)
Infotainment
Smart Watches
Augmented Reality Headsets
Smart Glasses
Wearable Imaging Devices
Industrial &
Military
Hand-worn Terminals
Augmented Reality Headsets
Smart Clothing
TM
TM
External Use
16
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
17
3
12/19/2014 11:25:38 AM
Wearable Market: Diverse Usage Models
Wearables is Not Just Smart Watches…
Wearable Ring
Scanner
Headset Running
Voice Recognition
Nymi, Heart-rate Based
Password Authentication
Kiwi Wearables –
Personal Tracker
Smart Glasses
Fitness/
Activity Monitors
Angel – first open
sensor for health and
fitness
Bone Conduction
Bluetooth headset cap
Virtual Reality
Headset
TM
19
WearAble Reference Platform enabled by Freescale
Speeds and eases development for creating wearable devices by addressing
key technology challenges which frees developers to focus on creating
differentiated features
Main Board PCB target size:
38 mm x 14 mm
Connectivity
BATTERY SINGLE
CELL LIPO
(500mAh)
TOUCH INTERFACE
POWER
MANAGEMENT
Solomon Systech
SSD2805C
Maxim MAX77696
MEMORY
LPDDR2 + eMMC
Usability
Samsung MCP
KMN5W000ZM-B207
USB
3-axis ACCELERO
3-axis MAGNETO
i.MX 6SL
FXOS8700CQ
ARM ® Cortex™-A9
Apps Processor
DDR2
Running Android UART
SDIO
SDIO
BT/BTLE
W-LAN /
BLUETOOTH 4.0
WIFI
Murata LBEH17YSHC
HUB SENSOR
MCU – Kinetis KL16
Freescale
Technology
ARM Cortex™ M0+
MOTION SENSING
PEDOMETER
Daughter Board PCB target size:
42 mm x 42 mm
(1.65” x 1.65”)
TM
BOARD - to - BOARD
CONNECTOR
Miniaturization
EPD
CONNECTOR
RGB
SPI
MICRO USB
Maximizing Battery Life
LCD
CONNECTOR
MIPI
MMA9553
BOARD - to - BOARD
CONNECTOR
External Use
TBD
18
ET017QC1
External Use
EPD DISPLAY
TM
LCD DISPLAY
Headset
Computer
WIRELESS
CHARGING
BUTTON 1 BUTTON 2
TM
External Use
20
Remote Patient Monitoring: Freescale Sensors Proposal
What is this?
•
Proactive and preventative approach to
healthcare using sensors that effectively
monitor patients
Variants
• Smart Band-Aid
• Sensor connectivity
• ECG with acceleration monitoring
• Movement monitoring
• Gait monitoring
• Pendant – “I’ve fallen and I cant get up…”
• Medical tablet
External Use
21
Remote Patient Monitoring: Freescale Sensors Proposal
Enabled by Freescale Accelerometers, Gyroscopes, Sensing Platforms, Magnetic
Sensors and Touch Sensors
•
MMA9553L accelerometer/32 bit processor is the intelligent pedometer platform
•
FXLC95000 accelerometer/32 bit processor as a sensor hub and datalogger
•
MAG3110 magnetometer and MMA8491 3 axis accelerometer combined in the
FXOS8700, for orientation, motion, vibration, shock, fall, g-force, etc. are present
•
MPL3115A digital pressure
sensor for altimetry
•
MPR121 for touch sensing
•
FXAS21002 gyroscope
provides the stability needed
for a drift free readings; when
talking accelerometer think gyroscope
too…
TM
TM
External Use
22
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
23
4
12/19/2014 11:25:38 AM
Smart Watches Available NOW – SONY SWR10
Smart Watches Available NOW – SONY SWR10
TM
TM
External Use
24
Smart Watches Available NOW – SONY SWR10
External Use
25
Smart Watches Available in the future – SONY SWR30
TM
TM
External Use
26
Smart Watches Available in the future – SONY SWR50
External Use
27
Smart Watches Available in the future – SONY SWR50
TM
TM
External Use
28
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
29
5
12/19/2014 11:25:38 AM
Alessandro’s arm in the future
Wearebles in the future - http://youtu.be/-nVhBXuK-EI
TM
TM
External Use
30
External Use
31
WCT-5W1COILTX – EVALUATION BOARD
Wireless Charger
TM
TM
External Use
32
External Use
33
WCT-5W1COILTX – EVALUATION BOARD
Energy Harvesting
TM
TM
External Use
34
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
35
6
12/19/2014 11:25:38 AM
Energy Harvesting - Concept
Energy Harvesting - Application
TM
TM
External Use
36
Energy Harvesting – Energy sources
External Use
37
Energy Harvesting – Power behavior
TM
TM
External Use
38
External Use
39
Some Sensors are Physical, Some are “Virtual”
Sensor Type
Caveat
Accelerometer
With gravity
Physical
Without gravity
Virtual
Magnetic Field
Uncalibrated
Physical
Magnetic Field
Calibrated
Virtual
Gyroscope
Uncalibrated
Physical
Gyroscope
Calibrated
Virtual
Orientation
Rotation Matrix
Virtual
Orientation
Azimuth, pitch, roll and
rotation matrix
Linear Acceleration
Gravity
Part 1: Motion Sensors Overview
Physical / Virtual
Virtual
Virtual
Ambient Temperature
Physical
Light
Physical
Pressure
Physical
Proximity
Physical
Relative Humidity
Physical
Items in red are not supported by Freescale sensors.
TM
TM
External Use
40
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
41
7
12/19/2014 11:25:38 AM
Some Sensors are Physical, Some are “Virtual”
Sensor Type
Caveat
Rotation Vector
Physical / Virtual
9-axis
Virtual
Game Rotation Vector
Accel/gyro only
Virtual
Geomagnetic Rotation Vector
Accel/mag only
In this workshop…
•
− Magnetic
calibration
compass
− Virtual gyro
− Compute orientation
− Compute linear acceleration sans gravity
Virtual
Significant Motion
Virtual
Step Detector
Virtual
Step Counter
Virtual
• The list above summarizes sensors & sensor fusion components that might be
expected components for modern operating systems.
• All but the last 4 listed are supported by Android 4.3. “KitKat” offers support for the
last four.
• Other OS’s continue to evolve in a similar fashion.
Because “Sensor Fusion” is an extremely broad topic, this course
focuses on some specific examples:
− Electronic
•
•
Sensors used include: Accelerometer + Magnetometer + Gyro
For today’s session, we are ignoring: vibration analysis, gesture
detection, contextual awareness, navigation / location, auto crash
detection, auto stability control, etc.
• The possible list of sensors and types of sensor fusion is virtually unlimited.
TM
TM
External Use
42
External Use
43
An Accelerometer Measures Linear Acceleration plus
Gravity
Sensor Strengths & Weaknesses
Sensor
Strengths
Weaknesses
Accelerometer
• Inexpensive
• Extremely low power
• Very linear
• Very low noise
• Measures the sum of gravity and
acceleration. We need them
separate.
Magnetometer
• The only sensor that can orient
itself with regard to “North”
• Insensitive to linear acceleration
• Subject to magnetic interference
• Not “spatially constant”
Gyro
• Relatively independent of linear
acceleration
• Can be used to “gyro-compensate”
the magnetometer
• Power hog
• Long startup time
• Zero rate offset drifts over time
Pressure Sensor
• The only stand-alone sensor that
can give an indication of altitude
• Not well understood
• A “relative” measurement
• Subject to many interferences and
environmental factors
An accelerometer by itself is a “3 axis” system
When any axis is vertical, we cannot
detect rotation about that axis
+Z
+X
• Accelerometer
+Y
TM
TM
External Use
44
External Use
What do we mean: Accelerometers measure linear
acceleration plus gravity?
45
Adding a gyroscope
This “6 axis” system is known as an
Inertial Measurement Unit or “IMU”
This is a Right Hand System (RHR)
+Z
ωz
• Accelerometer
• Gyro
When horizontal, and at rest:
X=0
Y=0
Z = 1g
When horizontal, and
accelerating at 1g in the direction
of the arrow:
X = 1g
Y=0
Z = 1g
+X
ωx
+Y
ωy
A 3-axis gyroscope measures angular velocity about each of the 3 axes.
TM
TM
External Use
46
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
47
8
12/19/2014 11:25:38 AM
Adding a magnetometer
As an aside...
This “9 axis” system is known as a magnetic, angular rate & gravity (MARG) sensor
Add a processor and you have an attitude & heading reference system (AHRS)
+Z = up
ωz
+X = East
• Accelerometer
• Gyro
• Magnetometer
+Y = North
ωx
horizontal intensity = 23.4µT
ωy
ENU
A 3-axis magnetometer gives you the X/Y/Z components of the magnetic field.
In Grapevine Texas, during the week of FTF2014, almost 2/3 of
the earth’s magnetic field is directed DOWN
TM
TM
External Use
48
As an aside...
49
External Use
Adding a pressure sensor
This is a “10 axis” system
+Z = up
ωz
+X = East
• Accelerometer
• Gyro
• Magnetometer
ωx
• Pressure
+Y = North
horizontal intensity = 23.4µT
In Grapevine Texas, during the week of FTF2014, almost 2/3 of
the earth’s magnetic field is directed DOWN
ENU
ωy
Pressure is a scalar (versus vector) quantity
TM
TM
External Use
50
Pressure can give you an estimate of altitude
51
External Use
Notice this is a log scale... (think in dB, ok???)
Typical Sensor Power in µW
Altitude = K1 X (1 - (P/P0)K2)
• K1 = 44330.77 meters
• K2 = 0.190263 (unitless)
• P0 = 101325 Pascals
100000
14500
9500
10000
Power in µ W
1437,5
662,5
1000
1100
234
151,2
100
100
20
10
1
12.5Hz LP 400Hz LP
Acc only
Acc
12.5Hz
Mag
400Hz Mag Pedometer Pressure Hybrid Mag Gyro
(1Hz)
+ Accel
Standby
(200Hz)
Gyro RUN
This chart was created 2013, you can expect numbers to decrease over time.
TM
TM
External Use
52
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
53
9
12/19/2014 11:25:38 AM
Gyro Ready to active = 2/ODR + 10ms (now, think linear)
Typical Sensor Power in µW
Some observations
Accelerometers are the most power efficient motion sensor you’ll
find
They often include motion detection circuits – use those to power
the system up/down for idle periods
Accelerometers are low power because they are usually “passive”
devices. The proof mass moves only when the device is in motion.
Gyros have continuously moving proof masses, requiring much
higher currents to keep them in motion
TMR1-based magnetic sensors are arranged in a Wheatstone
bridge formation – requiring DC biases
Another good sensor to “gate” others is an ambient light sensor
•
16000
14500
14000
•
• Notice that the magnetometer
currents are approximately 5X to 6X
the accelerometer currents
12000
Power in µ W
10000
•
9500
8000
•
6000
•
4000
2000
1437,5
234
20
•
1100
662,5
151,2
100
0
1
12.5Hz LP 400Hz LP
Acc only
Acc
12.5Hz
Mag
400Hz Mag Pedometer Pressure Hybrid Mag
Gyro
(1Hz)
+ Accel
Standby
(200Hz)
Gyro RUN
TMR = Tunneling MagnetoResistive
TM
TM
External Use
54
External Use
55
Typical “Minimum” Sensor Complements / Application
Application
Acc
Portrait/landscape, tap detect, fall
detection
X
Pedometry, vibration analysis, tiltmeter
X
eCompass, pointing/remote control,
augmented/virtual reality
X
Mag
Gyro
X
Virtual gyro
X
X
Gyro-compensated eCompass
X
X
Activity monitors
X
X
X
X
Motion capture
Pressure
X
X
X
X
3D mapping & localization
X
X
X
Image stabilization, gesture recognition
X
Part 2: Movement and Orientation
X
X
TM
TM
External Use
56
External Use
57
Movement
Frames of Reference
Any movement from point A to point B can be decomposed into a translation
plus optional rotation
•
Most systems use a Cartesian frame of reference, but which one?
+Y = East
Position and Orientation
+X = North
4.5
4
Ψ
+Z = Up
3.5
NED
3
Z
2.5
2
1.5
+X = East
1
∆Y
0.5
+Z = Down
0
-0.5
5
∆X
4
4
3
+Y = North
3
2
2
1
1
0
Y
ENU
0
-1
-1
Aeronautics uses NED
Windows 8 and Android use ENU
X
We need at least 6 degrees of freedom (DOF) to describe a
movement in 3 dimensions: ∆X, ∆Y, ∆Z, Φ , θ, Ψ
TM
TM
External Use
58
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
59
10
12/19/2014 11:25:38 AM
There can be multiple, concurrent, frames of reference
Up
Body or Device Reference Frame
East
There are multiple representations for rotation
Options are:
• Euler Angles – intuitive (roll, pitch & yaw), but subject to gimbal lock
• Rotation Matrices – rotation as a matrix multiplication
• Axis / Angle – easy to understand, difficult to use
• Quaternions – similar to axis/angle, with a theoretical background that
makes them useful
• Freescale sensor fusion libraries support all forms!!!!!!!!!!!!
axis/angle
Earth Frame
North
The device orientation can be defined as the rotation necessary to
map the global frame of reference into alignment with the body
frame of reference (or vice versa).
Euler Angle Illustration
source: http://en.wikipedia.org/wiki/File:Euler2a.gif
TM
TM
External Use
60
External Use
61
What is Sensor Fusion?
Sensor fusion encompasses a variety of
techniques which:
•
Trade off strengths and weaknesses of the various
sensors to compute something more than can be
calculated using the individual sensors;
•
Improve the quality and noise level of computed
results by taking advantage of:
− Known data redundancies between sensors
− Knowledge of system transfer functions, dynamic
behavior and/or expected motion
Part 3: Introduction to Sensor Fusion
TM
TM
External Use
62
External Use
63
Learn more at: www.freescale.com/sensorfusion
Freescale Sensor Fusion Library
Full featured sensor fusion
library, including the award
winning e-compass software
$
Product Features
•
(DSP, Math,
Encryption)
•
•
Operating
System
BSP, Drivers &
HAL
Bootloader
MCU Hardware
•
3-axis, 2-axis heading, 6-axis
eCompass,6-axis indirect Kalman
filter, 3-axis relative rotation, and 9axis indirect Kalman filter
Programmable sampling, fusion
rates, and frame of reference,
Included projects
•
Application
Specific
Middleware
Stacks
(TCP/IP, USB)
Software and Hardware
Evaluation & Dev Tools
Libraries
Functionality
•
Fully open source, eliminating
proprietary constraints,
increasing flexibility, and
decreasing time-to-market
Customer Application
Sensor Fusion Data Flow for Consumer Devices
Kinetis K20, KL25Z, KL26Z, KL46Z,
and K64F Freedom boards
•
Use of Freescale Multi sensor
boards
•
CodeWarrior and Kinetis Design
Studio
Sensor Hub Functions
Configure, Power State, Data Control
Trim
hi/low/band
pass filtering
3-Axis Acc
FoR
mapping
Trim
hi/low/band
pass filtering
Acc x,y,z
3-Axis
Gyro
FoR
mapping
Trim
hi/low/band
pass filtering
ω x,y,z
3-Axis
Mag
FoR
mapping
Trim & Hard/Soft
compensation
hi/low/band
pass filtering
B x,y,z
Pressure
Pressure
Shake detection
Raw data calibration
parameters
FoR = Frame of Reference Mapping
Calculate
hard/soft iron
parameters
Additional commercial support and
services available
TM
shake event
Rotation matrix
Kalman
Filter or
similar
function
Geometric
computations
Quaternion
Tilt-compensated mag
heading
Orientation (φ, Θ, Ψ)
Sensor Fusion
TM
External Use
64
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
65
11
12/19/2014 11:25:38 AM
Magnetic Calibration
Freescale Magnetic Calibration Library
Soft Iron in fixed spatial relationship to
the sensor distorts the measured field.
The sphere is distorted into an ellipsoid.
Hard Iron (permanent magnet) in fixed
spatial relationship to the sensor adds an
offset.
•
Now bundled into the sensor fusion
library
4 and 7 and now 10 element solvers are
available in source form
As a virtual sensor in Freescale’s Intelligent
Sensing Framework (ISF)
• Freescale’s eCompass software received the
Electronic Products Magazine 2012 Product of
the Year Award.
−
•
Ideal
Measured
Both are linear effects1, and can be reversed – if you know what you are doing!
1
Assuming there is no magnetic hysteresis present
TM
TM
External Use
66
External Use
Magnetic Calibration Variations
Bcx
Bc = W-1(Bp – V)
where:
Bc
W -1
Bp
V
Bcy
Bcz
=
67
Electronic Compass
s1
s2
s3
Bpx
-
Vx
s2
s4
s5
Bpy
-
Vy
s3
s5
s6
Bpz
-
Vz
Calibrated magnetic vector
Inverse Soft Iron Matrix
Physical magnetic measurement
Hard Iron Offset Vector
The 4-element calibration computes Vx, Vy and Vz hard iron offsets plus magnitude of the geomagnetic
vector . W -1 = identity matrix
Once you have performed magnetic calibration, computing magnetic
north is easy using cross products
b
The 7-element calibration also computes s1, s4 and s6. Off diagonal components of W -1 are 0.
W -1 =
s1
0
0
0
s4
0
0
0
s6
s1
s2
s3
s2
s4
s5
s3
s5
s6
|a x b|
a
A = accelerometer reading
Up
East
Step 1
North
Step 4
B
The 10-element calibration computes all elements of W -1, including s2, s3, and s5
W -1 =
axb
Step 1: Eastest = Bc X A
Step 2: Normalize East = Eastest / |Eastest|
Step 3: Normalize Up = A / |A|
Eastest
Step 4: Magnetic North = A X East
Everyone uses the same equation.
The magic is in how you compute the coefficients.
Bc
See getRotationMatrix function at:
http://developer.android.com/reference/android/hardware/SensorManager.html
TM
TM
External Use
68
eCompass – Virtual Gyro
External Use
69
Virtual Gyro
If you calculate orientation from accel + mag, computing outputs for a virtual
gyro is easy:
angular rates = the time derivative of orientation
For rotation of fixed reference frame relative to body frame (equivalent to a gyro
output), we have:
1
Small signal rotation matrix = R = RΦRθRΨ = Ψ
-θ
dR/dT = d(RΦRθRΨ)/dT =
0
ωz
-ωy
-Ψ
1
Φ
-ωz
0
ωx
θ
-Φ
1
ωy
0 Ω 1,2 Ω 1,3
-ωx = ( 1/∆t ) ( Rt+1 RtT – I3x3 ) = Ω 2,1 0 Ω 2,3
0
Ω 3,1 Ω 3,2 0
ωx = (2Δt)-1 (Ω3,2 - Ω2,3)
ωy = (2Δt)-1 (Ω1,3 - Ω3,1)
ωz = (2Δt)-1 (Ω2,1 - Ω1,2)
This derivation utilizes small angle approximations. See https://community.freescale.com/community/the-embeddedbeat/blog/2013/03/12/building-a-virtual-gyro for derivation details.
TM
TM
External Use
70
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
71
12
12/19/2014 11:25:38 AM
eCompass – Virtual Gyro
eCompass – Virtual Gyro
TM
TM
External Use
72
External Use
eCompass – Virtual Gyro
73
eCompass – Virtual Gyro
TM
TM
External Use
74
External Use
Orientation
Taking it up a notch
Orientation can be thought of as a rotation from some standard reference (usually
the global frame).
For a set of sensors at rest, orientation can be considered to be the 3D rotation
necessary to map magnetic north into calibrated magnetic field reading and gravity
to measured accelerometer reading.
•
B = RM
0
BN
BZ
magnetic north in the ENU
frame of reference. BN is the
horizontal component of the
earth field, BZ is the vertical.
A = RM
A
B
|B|
RM
ENU
External Use
76
•
•
gravity in the ENU1
frame of reference
•
The MagCal / eCompass example is nice because it can be
explicitly calculated
Other systems can be much more complex
If we can model a system as a set of state variables, then we can
use a Kalman filter to separate noise from desired system behavior
A Kalman filter essentially does a linear regression between
measured and expected system response.
Results can be proved to be optimum in a least-squares sense.
= accelerometer reading (in gravities) at rest
= measured magnetic field after calibration
= magnitude of the earth field
= rotation matrix = orientation
= X=East, Y=North, Z=Up
1
TM
0
0
1
•
75
Use [0, 0, 1]T Windows 8. Use [0, 0, -1]T for Android.
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
TM
External Use
77
13
12/19/2014 11:25:38 AM
6-Axis Accel + Gyro Indirect Kalman Filter
9-axis accel + mag + gyro Indirect Kalman Filter
linear acceleration, orientation error
accelerometer
signal
linear acceleration, orientation error
accelerometer
signal
AccelerometerBased Inclination
Model
AccelerometerBased Inclination
Model
+
gyro
signal
+
orientation
gyro offset
magnetic disturbance
Kalman Filter
-
-
Gyro-Based
Inclination Model
gyro signal
Gyro-Based
Inclination
Model
gyro offset, orientation error
gyro offset,
orientation error
Kalman Filter
•
•
+
This algorithm has no sense of magnetic north
The output orientation may drift about the gravity vector as a
result of uncorrected gyro gain errors
magnetometer
signal
MagnetometerBased Inclination
Model
orientation
gyro offset
magnetic disturbance
linear acceleration
magnetometer disturbance, orientation error
TM
TM
External Use
78
External Use
79
Computing information is only
half the puzzle.
You have to do something with it.
Enter…
Part 4: Freescale Sensor Fusion Toolbox
TM
TM
External Use
80
External Use
The Freescale Sensor Fusion Toolbox
Accel
=
Embedded board running
the Freescale Sensor
Fusion Library for Kinetis
Gyro
81
The Freescale Sensor Fusion Toolbox
Mag
•
Provides visualization functions for the fusion library
•
Allows you to experiment with different sensor/algorithm choices
•
Gives you access to raw sensor data
•
Allows you to log sensor and fusion data for later use
•
Works with demo and development versions of the Freescale Sensor
Kinetis MCU
Bluetooth Module
Sensor output data is “fused” using
Freescale-developed code running on
Kinetis, and then “beamed” to a PC or
Android device, where it drives the GUI
Fusion Library
•
Platforms
• Android
• Windows PC
Phone/tablet running the Freescale
Sensor Fusion Toolbox for Android
TM
TM
External Use
82
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
83
14
12/19/2014 11:25:38 AM
The Freescale Sensor Fusion Toolbox Features by Platform
Feature
Android
PC
Bluetooth wireless link
Requires BT on PC (built-in or dongle)
Ethernet wireless link
On WiGo board only
-
UART over USB
-
1
OS requirements
>= Android 3.0
>= Windows 7.0
Support for native sensors
-
Device View
Panorama View
-
Statistics View
-
Canvas View
-
Orientation XY Plots
-
Inertial XY Plots
-
Magnetics
-
Kalman
-
Altimeter XY Plots
-
Data Logging Capability
1.
Availability
Google Play
Freescale website
Price
Free
Free
2.
3
2
3.
4
5
6
4.
Packet information
•
•
7
•
5.
Figures are from 28 August 2014 build of the application.
Appearance may vary for other versions.
6.
7.
choice of PC comm port
packet activity indicator
# of packet errors
Roll/Pitch/Yaw & MagCal status
Choice of sensor set & algorithm
Sensor board run time and build
parameters, Data logging on/off
This is the most intuitive way to confirm that your sensor fusion is working properly.
TM
84
External Use
PC Version – Sensors Tab
Sensors Data Tab
Dynamics Tab
Magnetics
• Kalman
• Altimeter
• Help
•
•
1
1 FRDM_K64F and FRDM_K20D50M projects require a Processor Expert configuration change to
run in wired mode.
External Use
Rotating 3D PCB display
Image align function
Navigation Tabs for:
•
Integrated documentation
TM
PC Version – Device View
85
PC Version – Dynamics Tab
1
Raw Accelerometer Values
Calibrated Magnetometer
Values
3. Raw Gyroscope Values
1
1.
Roll, pitch & compass heading
Current quaternion
3. Angular velocity
4. Linear Acceleration
1.
2.
2
3
2.
2
3
4
The PC is used for display only. All values are computed on the embedded board.
The PC is used for display only. All values are computed on the embedded board.
TM
TM
86
External Use
External Use
PC Version – MagneticsTab
87
PC Version – Kalman Tab
2
3
6
1.
2D representation of the
data point “cloud” used
for hard/soft iron
compensation
2.
Computed hard iron
vector
3.
Soft iron matrix
4.
Statistics
5.
Calibration status light
6.
Save to text file
4
6
1
1
1
Use this tab to view
how well your sensor
fusion “digests”
changes in its
environment.
1
2
3
1. Error in orientation estimate (X,Y,Z)
2. Computed gyro offset
3. Error in gyro offset estimate (X,Y,Z)
You can use this display to view how the magnetic constellation evolves
over time in response to changing magnetic environments.
TM
TM
External Use
88
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
89
15
12/19/2014 11:25:38 AM
PC Version – Altimeter Tab
PC Version – Help tab
1.
Altitude
2.
Temperature
Not available when using FRDM-FXS-9AXIS board
TM
TM
External Use
90
External Use
Important Point
91
Android Version Program Operation
output selection
The template programs contained in the Freescale Sensor Fusion
Library for Kinetis MCUs assume that you are utilizing the FRDMFXS-MULTI-B Bluetooth board.
• KL25Z, KL26Z and KL46Z projects can also be used via
UART/USB wired interface by the simple expedient of removing
jumper J7, which powers the Bluetooth module.
• This works because the same UART is drives the Bluetooth module
and the OpenSDA UART interface.
•
•
sensor selection
algorithm
selection
Panorama View
accel only
Sensors
Native to your
Android
Device
Device View
mag (2d)
gyro only
Remote
Sensor
Interface
K20D50M and K64F use separate physical UARTS for Bluetooth
and OpenSDA. You will need to reconfigure the Processor Expert
UART component in these projects if you wish to use a wired
UART/USB interface. Additional detail is in the user manual.
accel/mag
Log Window
accel/gyro
9-axis
Statistics View
Canvas View
Not Shown
TM
TM
External Use
92
External Use
93
Application Controls
ENU Frame of
Reference
+Y
Navigation
Control
Android Action Bar
The Options
Menu is a button
on some devices
Fusion Settings Bar
X = East
Y = North
Z = up
Sensor & Algorithm
Selection Here
If present, click to enable
low pass filter
+X
+Z is out of page
TM
TM
External Use
94
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
95
16
12/19/2014 11:25:38 AM
Stats Page
If you would like to try it…
For mag / accel / gyro and
rotation, the “Statistics” Views
displays:
• sensor description
• current sensor value
• min / mean / max values
• standard deviation
• noise / √Hz
http://play.google.com/store/apps/details?id=com.freescale.sensors.sfusion
When used with the “local” sensor
sources, this is a great way to gain
insight into devices from the
competition!
TM
TM
External Use
96
External Use
97
Freescale Sensor Expansion Boards
Kinetis KL25Z and K20D50M compatible Freescale Sensor Expansion Boards
Part Number
FRDM-FXS-
FRDM-FXS-MULTI*
KL25Z or
KL26Z or
KL46Z or
K20D50M or
K64F
FRDM-FXS-MULTI-B*
Part 6: Freescale Sensor Fusion Library for
Kinetis
TM
FRDM-FXS-9AXIS*
Description
Freescale Sensor
Expansion board
MPL3115A2
MMA8652
FXAS21000
FXOS8700
FXLS8471
MMA955x
MAG3110
Freescale Sensor
Expansion board with
Bluetooth and Battery
MPL3115A2
MMA8652
FXAS21000
FXOS8700
FXLS8471
MMA955x
MAG3110
Freescale Sensor
Expansion board with only
2 sensors
FXAS21000
FXOS8700
Pricing
Availability
$50
Now
$125
Now
$30
Now
TM
External Use
98
External Use
99
External Use
101
Freescale Sensor Expansion Boards
TM
TM
External Use
100
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
17
12/19/2014 11:25:38 AM
PREÇO CIF NO DIA 02 / 12 / 14 (DÓLAR A R$ 2,5624)
Ordering Details
Component
Price
Location
Sensor Fusion Library for Kinetis MCUs
Free
http://www.freescale.com/sensorfusion
Freescale Freedom Development Platform
KL25Z = $12.95
KL26Z = $15.00
KL46Z = $15.00
K20D50M = $18.00
K64F = $29.00
http://www.freescale.com/freedom
Freescale Freedom Development Platform
for Multiple Freescale Sensors
$30
$50
$125
http:www.freescale.com/FRDM-FXS-9AXIS
http:www.freescale.com/FRDM-FXS-MULTI
http:www.freescale.com/FRDM-FXS-MULTI-B
Freescale Sensor Fusion Toolboxes For
PC
Free
http://www.freescale.com/sensorfusion
Freescale Sensor Fusion Toolboxes
Android
Free
https://play.google.com/store/apps/details?id=com.freescale
.sensors.sfusion
Freescale Sensors
Various
http://www.freescale.com/sensors
Prices are current as of 6 Sept, 2014. They may vary in the future.
TM
TM
External Use
102
External Use
Sensor Fusion Development Kit
Freescale Sensor Fusion Library for Kinetis MCUs
•
Development Kit
•
•
accelerometer
and/or gyroscope
− and/or magnetometer
−
Includes
•
Kinetis FRDM-K64F Freedom board
•
Freedom Development Platform for
Freescale Sensors with Bluetooth®
Part numbers
•
FRDM-SFUSION with community
support ($170)
•
FRDM-SFUSION-S with 50 hours
commercial support ($10K)
Optimized for the computation of orientation with respect to a global
frame of reference as a function of sensor readings from:
−
Enables quick development and
prototype of sensor fusion applications
•
Commercial Support
Along with orientation, also computes:
−
•
Reduces project risk, accelerates time
to market
−
•
Prioritized and dedicated access
−
•
Guaranteed response time
−
•
Senior level developer access
−
•
Private portal with customer reporting
and dedicated escalation path
−
•
Annual Subscription
linear acceleration
magnetic interference and correction factors for same
magnetic inclination angle
gyroscope zero-rate offset
compass heading
virtual gyro from accelerometer / magnetometer
TM
TM
External Use
104
External Use
How to Engage with Sensor Fusion
http://www.freescale.com/sensorfusion
− Contains the latest sensor fusion information
− Downloadable SW and demos
− Blogs and app notes
• Sensor fusion development kits
− Available November 2014
− Combination of FRDM-MULTI-B and FRDMK64F boards
− Part numbers
•
FRDM-SFUSION-S with 50
hours of commercial
support
FRDM-SFUSION with
•
103
community support
105
Freescale Sensor Fusion Library for Kinetis MCUs
•
•
•
•
•
•
Supplied in source form under license from Freescale
Implemented as pure C-code sitting on top of device driver and
MQX-lite implementations created via Processor Expert
Shipped in the form of CodeWarrior projects compatible with the
Freescale Sensor Fusion Toolbox
Downloadable from http://www.freescale.com/sensorfusion
Community support available at
https://community.freescale.com/community/sensors/sensorfusion
Contract support services offered by Freescale. Contact:
[email protected] for details.
Factory contact
− [email protected]
− Email alias includes sensor and MCU teams
TM
TM
External Use
106
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
107
18
12/19/2014 11:25:38 AM
Features vs. Sensor Set
Feature
Filter Type
Roll / Pitch / Tilt in degrees
Option Details
Accel only
Accel + gyro
Accel + mag
Accel + mag + gyro
Low Pass
Indirect Kalman
Low Pass
Indirect Kalman
Yes
Yaw in degrees
Angular Rate1 in degrees/second
Compass heading (magnetic north) in degrees
Yes
Yes
No
Yes
Yes
Yes
virtual 3 axis
Yes
No
Yes
Details
Free when used with Freescale sensors (see license file for details)
Yes
No
virtual 2 axis2
No
Feature
License
The ANSI C99 source code was optimized on Freescale Kinetis MCUs
based upon ARM Cortex M0+, M4 and M4F processors, but should be
portable to any CPU.
CPU selection
Yes
Quaternion and rotation vector
Yes
Yes
Yes
Yes
Board customizable
Yes1
Rotation matrix
Yes
Yes
Yes
Yes
Sensor sample rate
Programmable
No
Yes
No
Yes
Fusion rate
NED (North-East-Down Frame of Reference
Yes3
Yes3
Yes
Yes
Frame of Reference
Programmable (NED, Android, or Windows 8)
ENU (Windows 8 variant) Frame of Reference
Linear acceleration separate from gravity
Yes3
Yes3
Yes
Yes
Algorithms Executing
Any combination of those shown in the prior slide
ENU (Android variant) Frame of Reference
Yes3
Yes3
Yes
Yes
Magnetic calibration included
No
No
Yes
Yes
Gyro offset calibration included
N/A
Yes
N/A
Yes
FRDM-KL25Z board support
Yes
Yes
Yes
Yes
FRDM-KL26Z board support
Yes
Yes
Yes
Yes
FRDM-KL46Z board support
Yes
Yes
Yes
Sleep mode enabled between samples/calculations
Yes
Yes
Yes
Yes
FRDM-K64F board support
Yes
Yes
Yes
Yes
Programmable
RTOS
MQX-Lite
Code flexibility
All code is supplied in source form
Access to Processor Expert
Yes
FRDM-K20D50M board support
Programmable, typically = sample rate/N
Yes
* Datasheet, User guide, Application Notes
* Template CodeWarrior projects
* Pre-compiled s-record files
Product Deliverables
1. Angular rate for configurations with a gyro include corrections for gyro offset
2. Subject to well-known limitation of being blind to rotation about axes aligned with gravity
3. These solutions do not include a magnetometer, therefore there is no sense of compass heading
[1]
FRDM_KL25Z, KL26Z, KL46Z, K20D50M and K64F are supported “out of the box” and may be used as templates for other board/MCU
combinations..
TM
TM
External Use
108
External Use
109
For this demo
You need
• Freescale Freedom boards shown
• USB cable
• Freescale Sensor Fusion Toolbox running
on a Windows Laptop
FRDM-FXS-9AXIS or
FRDM-FXS-MULTI or
FRDM-FXS-MULTI-B
FRDM-KL25Z or
FRDM-KL26Z or
FRDM-KL46Z or
(C:\Program Files\Freescale\Freescale Sensor Fusion
Toolbox/SensorFusion.exe)
•
Part 5: Play with fusion options
Freescale Sensor Fusion Library for
Kinetis MCUs
Plug your USB cable in
this connector
Make sure the switch on the top sensor
board is “on”.
If you have a MULTI-B board, remove
jumper J7
TM
TM
External Use
110
External Use
111
Experiment with each of the following options
#
Option
Comments
1
Accelerometer
Roll & Pitch only, no yaw
2
Gyroscope
Roll, Pitch & Yaw, but no absolute reference
3
Accelerometer +
Magnetometer (eCompass)
Roll, Pitch & Yaw relative to earth frame, but sensitive to
magnetic interference and linear acceleration
4
Accelerometer + Gyroscope
Roll, Pitch with respect to horizontal plane, yaw is relative
5
9-Axis Accelerometer +
Gyroscope + Magnetometer
Roll, Pitch & Yaw relative to earth frame, relatively independent
of magnetic interference and linear acceleration
Experiment with each tab function on the fusion toolbox
TM
Sensor Fusion Library Details
TM
External Use
112
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
113
19
12/19/2014 11:25:38 AM
Development Requirements
•
You must have either Kinetis Design Studio 1.1.1 or CodeWarrior 10.6
and Processor Expert to build sensor fusion applications using the
Freescale project templates.
Easy to use…
•
•
CodeWarrior can be downloaded from http://www.freescale.com/codewarrior.
Kinetis Design Studio can be downloaded from http://www.freescale.com/kds
−
−
In order to experiment with the demo program, you will need an Android
3.0 or higher device running the Freescale Sensor Fusion Toolbox OR the
PC-based variant of the toolbox. Details are available at
http://www.freescale.com/sensorfusion
• Fusion libraries and example projects supplied by the Freescale Sensor
Solutions Division
•
•
Development board(s)1 with:
•
Pre-built templates are targeted at specific Freedom boards
User code easily added to a single .c file within any of the
following functions:
−
void UserStartup(void);
−
void UserHighFrequencyTaskInit(void) ; // runs once, the first time through the 200Hz task
−
void UserHighFrequencyTaskRun(void); // runs each time the 200Hz task runs
−
void UserMediumFrequencyTaskInit(void); // runs once, the first time through the 25Hz task
−
void UserMediumFrequencyTaskRun(void); // runs each time the 25Hz task runs
Sensor and fusion values are simply read from predefined
global structures
Kinetis Cortex-M0+, M4 or M4F MCU
Freescale FXOS8700CQ 3-axis magnetometer + 3 axis accelerometer
Freescale FXAS21000 3-axis gyroscope
−
−
−
1
See details on “Freescale Sensor Expansion Boards”. Additional sensor combinations are supported in build.h. And of course,
you can add your own! Future expansion boards may replace the FXAS21000 with the FXAS21002, which is also supported.
TM
TM
External Use
114
user_tasks.c Template Page 1 of 3
#include "Cpu.h"
#include "Events.h"
#include "mqx_tasks.h"
#include "UART.h"
#include "include_all.h"
External Use
115
user_tasks.c Template Page 2 of 3
void UserHighFrequencyTaskInit(void) {
// User code to be executed ONE TIME the first time the high frequency task is run.
//
// PUT YOUR CODE HERE
//
return;
}
void UserStartup(void) {
// The following UART function call initializes Bluetooth communications used by the
// Freescale Sensor Fusion Toolbox. If the developer is not using the toolbox,
// these can be removed.
//
// initialize BlueRadios Bluetooth module
BlueRadios_Init(UART2_DeviceData);
// put code here to be executed at the end of the RTOS startup sequence.
//
// PUT YOUR CODE HERE
//
void UserMediumFrequencyTaskInit(void) {
// User code to be executed ONE TIME the first time the medium frequency task is run
//
// PUT YOUR CODE HERE
//
return;
}
void UserHighFrequencyTaskRun(void) {
// The default frequency at which this code runs is 200Hz.
// This code runs after sensors are sampled.
// In general, try to keep "high intensity" code out of UserHighFrequencyTaskRun.
// The high frequency task also has highest priority.
//
// PUT YOUR CODE HERE
//
return;
}
return;
TM
TM
External Use
116
user_tasks.c Template Page 3 of 3
void UserMediumFrequencyTaskRun(void) {
// This code runs after the Kalman filter loop
// The default frequency at which this code runs is 25Hz.
// The following UART function constructs and sends Bluetooth packets used by the
// Freescale Sensor Fusion Toolbox. If the developer is not using the toolbox,
// it can be removed.
// transmit orientation over the radio link
CreateAndSendBluetoothPacketsViaUART(UART2_DeviceData);
//
// PUT YOUR CODE HERE
//
return;
External Use
117
Access Fusion Inputs & Outputs Via a Standard
Set of Global Data Structures
Input Global Data Structures defined in build.h
Pointer Function
Structure Name
Accelerometer
thisAccel
Structure Type
AccelSensor
Magnetometer
thisMag
MagSensor
Gyroscope
thisGyro
GyroSensor
Output Global Data Structures defined in tasks.h
Pointer Function
Structure Name
Structure Type
Altimeter results
thisSV_1DOF_P_BASIC
SV_1DOF_P_BASIC
}
Steps to use:
1. Import project into CodeWarrior
2. Add your code as shown above
3. Build
4. Download and run
3-axis Accelerometer results
thisSV_3DOF_G_BASIC
SV_3DOF_G_BASIC
2D Magnetic-only eCompass results
thisSV_3DOF_B_BASIC
SV_3DOF_B_BASIC
Gyro-only orientation
thisSV_3DOF_Y_BASIC
SV_3DOF_Y_BASIC
eCompass results
thisSV_6DOF_GB_BASIC
SV_6DOF_GB_BASIC
accel+gyro results
thisSV_6DOF_GY_KALMAN
SV_6DOF_GY_KALMAN
thisSV_9DOF_GBY_KALMAN
SV_9DOF_GBY_KALMAN
9-axis results
TM
TM
External Use
118
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
119
20
12/19/2014 11:25:38 AM
Location of Variables Within the Global Structures
Description
Data Type
roll in degrees
pitch in degrees
yaw in degrees
compass heading in degrees
tilt angle in degrees
magnetic inclination angle in
degrees
geomagnetic vector
(microTeslas, global frame)
gyro offset in degrees/sec
linear acceleration in the
sensor frame in gravities
linear acceleration in the global
frame in gravities
quaternion (unitless)
float
float
float
float
float
float
G
(accel)
fLPPhi
fLPThe
fLPPsi
fLPRho
fLPChi
N/A
float
Here is an Example of Grabbing Quaternion Values
Fusion Algorithm Options
struct fquaternion fq;
// quaternion
GY
(accel + gyro)
fPhiPl
fThePl
fPsiPl
fRhoPl
fChiPl
N/A
GBY
9-axis
fPhiPl
fThePl
fPsiPl
fRhoPl
fChiPl
fDeltaPl
N/A
GB
(eCompass)
fLPPhi
fLPThe
fLPPsi
fLPRho
fLPChi
fDelta
fLPDelta
N/A
N/A
fmGl[3]
float
float
N/A
N/A
N/A
N/A
fbPl[3]
faSePl[3]
fbPl[3]
faSePl[3]
q1 = fq.q1;
float
N/A
N/A
N/A
faGlPl[3]
q3 = fq.q3;
fq
fLPq
fOmega[3]1
fR[3][3]
fLPR[3][3]
fLPRVec[3]
fdeltat
fq
fLPq
fOmega[3]
fR[3][3]
fLPR[3][3]
fLPRvec[3]
fdeltat
fqPl
fqPl
// more details/examples are presented in the following section
fOmega[3]2
fRPl[3][3]
fOmega[3] 2
fRPl[3][3]
fRVecPl[3]
fdeltat
fRVecPl[3]
fdeltat
float q0, q1, q2, q3;
//fq = thisSV_3DOF_G_BASIC.fLPq; // OR
//fq = thisSV_6DOF_GB_BASIC.fLPq; // OR
//fq = thisSV_6DOF_GY_KALMAN.fqPl; // OR
fq = thisSV_9DOF_GBY_KALMAN.fqPl;
q0 = fq.q0;
fquaternion
angular velocity in dps
orientation matrix (unitless)
float
float
rotation vector
time interval in seconds
float
float
q2 = fq.q2;
Data elements for altimeter, 2D eCompass, and gyro only are not shown.
TM
TM
External Use
120
External Use
Example: Reading Euler Angles
121
The Development Kit provides:
Using 3-axis model:
Access to raw fusion and magnetic calibration functions
Control over sampling and fusion rates
• Ability to add custom Hardware Abstraction Layer (HAL)
• Access to MQX-Lite customization via Processor Expert
•
float roll = thisSV_3DOF_G_BASIC.fLPPhi;
float pitch = thisSV_3DOF_G_BASIC.fLPThe;
float yaw = thisSV_3DOF_G_BASIC.fLPPsi;
•
Using 6-axis accel + mag (eCompass) model:
float roll = thisSV_6DOF_GB_BASIC.fLPPhi;
float pitch = thisSV_6DOF_GB_BASIC.fLPThe;
float yaw = thisSV_6DOF_GB_BASIC.fLPPsi;
Using 6-axis accel + gyro Kalman filter model:
float roll = thisSV_6DOF_GY_KALMAN.fPhiPl;
float pitch = thisSV_6DOF_GY_KALMAN.fThePl;
float yaw = thisSV_6DOF_GY_KALMAN.fPsiPl;
Using 9-axis Kalman filter model:
float roll = thisSV_9DOF_GBY_KALMAN.fPhiPl;
float pitch = thisSV_9DOF_GBY_KALMAN.fThePl;
float yaw = thisSV_9DOF_GBY_KALMAN.fPsiPl;
TM
TM
External Use
122
External Use
Product Development Kit Structure
MQXLITE
FLASH
Sources
approximations.h
build.h
drivers.h
Events.h
fusion.h
include_all.h
magnetic.h
<ProjName>.elf
(generated>
include
3.2 Project Overview
As shipped:
• FSFK_KL25Z; or
• FSFK_KL26Z; or
• FSFK_KL46Z; or
• FSFK_K20D50M; or
• FSFK_K64F
<ProjName>
123
kernel
psp
Library
prepopulated
with .s19 and
.bin files
matrix.h
mqx_tasks.h
orientation.h
tasks.h
user_tasks.h
approximations.c
drivers.c
Events.c
fusion.c
ProcessorExpert.pe
.project
magnetic.c
main.c
matrix.c
mqx_tasks.c
orientation.h
tasks.c
user_tasks.c
Files in bold red are most likely to
be customized on a per project
basis.
TM
TM
External Use
124
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
125
21
12/19/2014 11:25:38 AM
Source File Descriptions
Files
Source File Descriptions
Description
approximations.c
approximations.h
Reduced accuracy/power trig functions
build.h
Build options consolidated into a single file
drivers.c
drivers.h
Initialization of hardware timers and I2C drivers for inertial and
magnetic sensors. Contains
CreateAndSendBluetoothPacketsViaUART().
Events.c
Events.h
Callback functions for hardware events. Contains
UART_OnBlockReceived()
fusion.c
fusion.h
This is where the primary sensor fusion routines reside. All 3, 6 and 9-axis
fusion routines are here.
include_all.h
A catchall for all the other .h files
magnetic.c
magnetic.h
Magnetic calibration functions
Files
Description
main.c
Initializes and executes MQX
matrix.c
matrix.h
Optimized matrix manipulation functions
mqx_tasks.c
mqx_tasks.h
Creates and runs the Sampling, Fusion and Calibration tasks which in
turn call functions in tasks.c
orientation.c
orientation.h
This file contains functions designed to operate on, or compute,
orientations. These may be in rotation matrix form, quaternion form, or
Euler angles. It also includes functions designed to operate with specific
reference frames (Android, Windows 8, NED).
tasks.c
tasks.h
tasks.c provides the high level fusion library interface. It also
includes the option to apply a Hardware Abstraction Layer (HAL).
With proper attention to sensor orientations during PCB design,
tasks.c may never need modification.
user_tasks.c
user_tasks.h
Placeholder functions for // Put your code here
TM
TM
External Use
126
High Level Architecture
Our Sensor Fusion is Partitioned Into 3 Tasks
Main_task()
RdSensData_task()
Fusion_task()
MagCal_task()
MQX
fusion
orientation, matrix,
approximations
drivers & Events
I2C Interface
UART
Interface
200 Hz MQX Hardware Timer
FXOS8700
(Internal clock)
I2C
mqx_tasks
tasks
magnetic
127
External Use
GPIO
Interface
user
tasks
RdSensData_Init()
Fusion_Init()
RdSensData_Run()
Fusion_Run()
MagCal_Run()
ApplyAccelHAL()
ApplyMagHAL()
ApplyGyroHAL()
Specific to hardware
and sensors
Sampling Task
FXAS21000
25 Hz Software Event
(Internal clock)
Fusion Task
Hardware
Independent of
hardware and
sensors
~1 per minute Software Event
generated by
Processor Expert
I2C and UART communications to external devices
are encapsulated by drivers.c and Events.c
Magnetic Calibration
Task
primary fusion &
calibration functions
sampling interval = 5 ms
TM
TM
External Use
128
External Use
The Build Process
Make any desired
changes to the template
129
MCU Resources Used by the Template Projects
run
Processor
Expert
boardspecific
template
For K64, there is one intermediate (and
temporary) step here. Manually edit
CPU_Config.h, change the value for
NV_FSEC to 0xFE. This works around a
bug in the MBED bootloader firmware.
updated
project
with MQXlite
Build
using
Code
Warrior
Test via Freescale
Sensor Fusion Toolbox
for Windows or Android
Function
FSFK_KL25Z
FSFK_KL26Z
FSFK_KL46Z
FSFK_
K20D50M
FSFK_K64F
Cpu
MKL25Z128VLK4
MKL26Z128VLH4
MKL46Z256VMC4
MK20DX128VLH5
MK64FN1M0VLL12
LED_RED
PTB18
PTE29
PTE29
PTC3
PTB22
Illuminated when a magnetic
calibration is in progress
LED_GREEN
PTB19
PTE31
PTD5
PTD4
PTE26
Flickers when fusion algorithms
are running
LED_BLUE
PTD1
PTD5
PTE31
PTA2
PTB21
Currently unused
FTM
LPTMR0
LPTMR0
LPTMR0
LPTMR0
LPTMR0
Low frequency timer drives the
200 Hz sensor read process
UART
UART0 on
PTA2:1
UART0 on
PTA2:1
UART0 on
PTA2:1
UART1 on
PTE1:0
UART3 on
PTC17:16
Used for Bluetooth
communications
I2C
I2C1on PTC2:1
I2C1 on PTC2:1
I2C1 on PTC2:1
I2C0 on PTB1:0
I2C1 on
PTC11:10
Communicates to sensors
TestPin_KF_Time
PTC10
PTC10
PTC10
PTC10
PTC7
Output lines used for debug
purposes
TestPin_MagCal_
Time
PTC11
PTC11
PTC11
PTC1
PTC5
TM
Description
TM
External Use
130
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
131
22
12/19/2014 11:25:38 AM
Fusion Options Are Controlled Via build.h
Fusion Options Are Controlled Via build.h
#ifdef K20D50M
#define THIS_BOARD_ID
#endif
#ifdef FXLC95000CL
#define THIS_BOARD_ID
#endif
#ifdef KL26Z
#define THIS_BOARD_ID
#endif
#ifdef K64F
#define THIS_BOARD_ID
#endif
#ifdef KL16Z
#define THIS_BOARD_ID
#endif
#ifdef KL46Z
#define THIS_BOARD_ID
#endif
#ifdef KL46Z_STANDALONE
#define THIS_BOARD_ID
#endif
// coordinate system for the build
#define NED 0
#define ANDROID 1
#define WIN8 2
#define THISCOORDSYSTEM ANDROID
#ifndef BUILD_H
#define BUILD_H
// PCB HAL options
#define BOARD_WIN8_REV05
0
// with sensor shield
#define BOARD_FRDM_KL25Z
1
// with sensor shield
#define BOARD_FRDM_K20D50M
2
// with sensor shield
#define BOARD_FXLC95000CL
3
#define BOARD_FRDM_KL26Z
4
// with sensor shield
#define BOARD_FRDM_K64F
5
// with sensor shield
#define BOARD_FRDM_KL16Z
6
// with sensor shield
#define BOARD_FRDM_KL46Z
7
// with sensor shield
#define BOARD_FRDM_KL46Z_STANDALONE
8
// without sensor shield
// enter new PCBs here with incrementing values
// C Compiler Preprocessor define in the CodeWarrior project will choose which board to use
#ifdef REV05
#define THIS_BOARD_ID
BOARD_WIN8_REV05
BOARD_FRDM_K20D50M
BOARD_FRDM_FXLC95000CL
BOARD_FRDM_KL26Z
BOARD_FRDM_K64F
BOARD_FRDM_KL16Z
BOARD_FRDM_KL46Z
BOARD_FRDM_KL46Z_STANDALONE
//
//
//
//
identifier for
identifier for
identifier for
the coordinate
NED angle output
Android angle output
Windows 8 angle output
system to be used
#endif
#ifdef KL25Z
#define THIS_BOARD_ID
BOARD_FRDM_KL25Z
#endif
TM
TM
External Use
132
Fusion Options Are Controlled Via build.h
External Use
133
Fusion Options Are Controlled Via build.h
// sensors to be enabled: compile errors will warn if the sensors are not compatible with the algorithms.
// avoid enabling FXOS8700 plus MMA8652 and MAG3110 which will result in sensor read from all sensors
// with the data read first from FXOS8700 and then over-written by data from MMA8652 and MAG3110.
// it will still work but it's a waste of clock cycles.
#define USE_MPL3115
#define USE_FXOS8700
#define USE_FXAS21000
//#define USE_FXAS21002
//#define USE_MMA8652
//#define USE_MAG3110
// int16 build number sent in Bluetooth debug packet
#define THISBUILD 420
// power saving deep sleep
//#define DEEPSLEEP
// define to enable deep sleep power saving
// enforce a fatal compilation error if the K20D50M board is used with MMA8652
#if (THIS_BOARD_ID == BOARD_FRDM_K20D50M) && defined USE_MMA8652
#error This build creates an I2C conflict between MMA8451 on K20D50M board and MMA8652 on sensor board
#endif
. . .
// normally all enabled: degrees of freedom algorithms to be executed
#define COMPUTE_1DOF_P_BASIC
// 1DOF pressure (altitude) and temperature: (1x pressure)
#define COMPUTE_3DOF_G_BASIC
// 3DOF accel tilt: (1x accel)
#define COMPUTE_3DOF_B_BASIC
// 3DOF mag eCompass (vehicle): (1x mag)
#define COMPUTE_3DOF_Y_BASIC
// 3DOF gyro integration: (1x gyro)
#define COMPUTE_6DOF_GB_BASIC
// 6DOF accel and mag eCompass: (1x accel + 1x mag)
#define COMPUTE_6DOF_GY_KALMAN
// 6DOF accel and gyro (Kalman): (1x accel + 1x gyro)
#define COMPUTE_9DOF_GBY_KALMAN
// 9DOF accel, mag and gyro (Kalman): (1x accel + 1x mag + 1x gyro)
// UART (Bluetooth) serial port control
//#define UART_OFF
// define to measure MCU+algorithm current only
// sampling rate and kalman filter timing
#define FTM_INCLK_HZ
1000000 // int32: 1MHz FTM timer frequency set in PE: do not change
#define SENSORFS
200
// int32: 200Hz: frequency (Hz) of sensor sampling process
#define OVERSAMPLE_RATIO
8
// int32: 8x: 3DOF, 6DOF, 9DOF run at SENSORFS / OVERSAMPLE_RATIO Hz
TM
TM
External Use
134
External Use
135
For this lab
You need:
• Freescale Freedom boards shown
• USB cable
• Freescale Sensor Fusion Toolbox running on a
Windows Laptop
FRDM-FXS-9AXIS
(C:\Program Files\Freescale\Freescale Sensor Fusion Toolbox/SensorFusion.exe)
•
KL25Z
FSFK_KL25Z project template
(pre-installed on FTF laptops at C:/Temp)
You will install updated software images on your
board.
Plug your USB cable in
this connector
Make sure the KL25Z switch is “on”
Part 7: Explore the Sensor Fusion Library
Note: The same process described here works for
any of the fusion library template projects. You can
use any of KL25Z, KL26Z, KL46Z, K20D50M and
K64F Freedom boards.
TM
TM
External Use
136
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
137
23
12/19/2014 11:25:38 AM
IF your PC has the template pre-installed…
•
SKIP to Step 8
•
Otherwise, repeat Steps 1 through 7 on the following pages
Installation Step 1
a. Copy installer into your working directory
b. Double-click FreescaleSensorFusionInstaller.exe
TM
TM
External Use
138
External Use
139
Installation Step 2
Installation Step 3
Read the license terms, click “I Agree”
a. Review the system requirements.
b. Click “Next”
TM
TM
External Use
140
External Use
141
Installation Step 4
Installation Step 5
a. Select the destination folder (automatically defaults to the folder in which you
placed the installer).
b. Click “Next”
a. Select your choice of kits (defaults to CodeWarrior Fusion Projects and
documentation).
b. Click “Install”
TM
TM
External Use
142
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
143
24
12/19/2014 11:25:38 AM
Installation Step 6
Installation Step 7
a. Click “Close” to complete installation
a. Confirm presence of project template, tools and docs directory
TM
TM
External Use
144
External Use
145
Installation Step 8
Installation Step 9
a. Expand the template folder down into the FSFK_KL25Z/Sources directory
b. Confirm the that the set of files shown below is present
a. Start CodeWarrior 10.6
b. Select c:/Temp (or whatever directory you used) as your workspace
c. Click “OK”
TM
TM
External Use
146
Installation Step 10
External Use
147
Installation Step 11
a. From CodeWarrior, Select
File->Import->General>Existing Projects into
Workspace
b. Click “Next
a. Select the proper root
directory
b. Check the project to be
imported
c. Click Finish
TM
TM
External Use
148
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
149
25
12/19/2014 11:25:38 AM
Installation Step 12
a. Close the CodeWarrior “Welcome
Screen” if present
b. Expand the project folder to view
contents
Lab 2, Step 1
a. Double-click on
ProcessorExpert.pe. This will
bring up the components
browser
b. Click on “Generate
Processor Expert Code” icon
to run Processor Expert
Your project has been
successfully installed.
TM
TM
External Use
150
Lab 2, Step 2
External Use
151
Lab 2, Step 3
a) Plug your board in if it is not
plugged in
b) Run->Run Configurations
c) Expand CodeWarrior>FSFKKL25Z_FLASH_OpenSDA
(run configuration name
may vary)
d) Click “Run”
a. Select the project name
b. Click on the “Build” icon
TM
TM
External Use
152
Status check
External Use
153
Optional Lab 3, Step 1: Let’s modify a few things
In Sources/drivers.c
•
You should see the green LED blinking steadily, with a red flash a couple
of times per second
•
You have just successfully reprogrammed your board with the same
application we’ve already experimented with
•
Open up the Freescale Sensor Fusion Toolbox on your PC and confirm
that operation is unchanged
•
Open Sources/drivers.c and review function
CreateAndSendBluetoothPacketsViaUART(). This function pulls virtually
all fusion results from fusion output structures for transmission back to the
Sensor Fusion Toolbox.
•
This completes Lab2.
Add:
int16 iChi; // tilt angle
at the top of function CreateAndSendBlueToothPacketsViaUART()
Append statements to look up iChi to each of the case options of switch(globals.QuaternionPacketType) . The
7 statements needed are:
iChi = (int16) (10.0F * thisSV_3DOF_G_BASIC.fLPChi); // Q3
iChi = (int16) (10.0F * thisSV_3DOF_B_BASIC.fLPChi); // Q3M
iChi = (int16) (10.0F * thisSV_3DOF_Y_BASIC.fChi); // Q3G
iChi = (int16) (10.0F * thisSV_6DOF_GB_BASIC.fLPChi); //Q6MA
iChi = (int16) (10.0F * thisSV_6DOF_GY_KALMAN.fChiPl); // Q6AG
iChi = (int16) (10.0F * thisSV_9DOF_GBY_KALMAN.fChiPl); // Q9
iChi = 0; // NOT IMPLEMENTED. THIS IS A PLACEHOLDER // QCC
In the “if (globals.RPCPacketOn) section, replace:
sBufAppendItem(sUARTOutputBuf, &iIndex, (uint8*)&iPhi, 2);
sBufAppendItem(sUARTOutputBuf, &iIndex, (uint8*)&iThe, 2);
sBufAppendItem(sUARTOutputBuf, &iIndex, (uint8*)&iRho, 2);
with
int16 zero, compassPoint;
// Use iChi instead of iPhi
// Convert compass heading to a cruder N, NE, E, SE, S, SW, W, NW heading
// [12-7]: add the angles (resolution 0.1 deg per count) to the transmit buffer
zero = 0;
compassPoint = iRho-22.5;
compassPoint = compassPoint/450;
compassPoint = compassPoint * 450;
sBufAppendItem(sUARTOutputBuf, &iIndex, (uint8*)&iChi, 2);
sBufAppendItem(sUARTOutputBuf, &iIndex, (uint8*)&zero, 2);
sBufAppendItem(sUARTOutputBuf, &iIndex, (uint8*)&compassPoint, 2);
TM
TM
External Use
154
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
155
26
12/19/2014 11:25:38 AM
Lab 3, Step 2: Rebuild & experiment
Reminder: Global Data Structures
What should be the effect of the changes on the prior page?
Pointer Function
Structure Name
Structure Type
defined in include file
Accelerometer
thisAccel
AccelSensor
proj_config.h
Magnetometer
thisMag
MagSensor
Gyroscope
thisGyro
GyroSensor
Rebuild the project
b) Download and experiment with changes via the “Dynamics” tab
in the Freescale Sensor Fusion Toolbox running on your PC
3-axis results
thisSV_3DOF_G_BASIC
SV_3DOF_G_BASIC
eCompass results
thisSV_6DOF_GB_BASIC
SB_6DOF_GB_BASIC
accel+gyro results
thisSV_6DOF_GY_KALMAN
SV_6DOF_GY_KALMAN
Don’t forget to refer to the slides which specify available fusion
outputs.
9-axis results
thisSV_9DOF_GBY_KALMAN
SV_9DOF_GBY_KALMAN
Hint: iChi is tilt angle in degrees
a)
tasks_func.h
This concludes the 3nd lab.
TM
TM
External Use
156
External Use
157
Reminder: Location of variables within the global
structures
Description
data type
roll in degrees
pitch in degrees
yaw in degrees
compass heading in degrees
tilt angle in degrees
magnetic inclination angle in
degrees
geomagnetic vector
(microTeslas, global frame)
gyro offset in degrees/sec
linear acceleration in the
sensor frame in gravities
linear acceleration in the global
frame in gravities
quaternion (unitless)
float
N/A
Fusion Algorithm Options
GB
GY
(eCompass)
(accel + gyro)
fLPPhi
fPhiPl
fLPThe
fThePl
fLPPsi
fPsiPl
fLPRho
fRhoPl
fLPChi
fChiPl
fDelta
N/A
fLPDelta
N/A
N/A
float
float
N/A
N/A
N/A
N/A
float
N/A
fq
fLPq
fOmega[3]1
fR[3][3]
fLPR[3][3]
fLPRVec[3]
fdeltat
float
float
float
float
float
float
fquaternion
angular velocity in dps
orientation matrix (unitless)
float
float
rotation vector
time interval in seconds
float
float
G
(accel)
fLPPhi
fLPThe
fLPPsi
fLPRho
fLPChi
N/A
GBY
9-axis
fPhiPl
fThePl
fPsiPl
fRhoPl
fChiPl
fDeltaPl
fmGl[3]
fbPl[3]
faSePl[3]
fbPL[3]
faSePl[3]
N/A
N/A
fq
fLPq
fOmega[3]
fR[3][3]
fLPR[3][3]
fLPRvec[3]
fdeltat
fqPl
faGlPl[3]
fLPaGlPl[3]
fqPl
fOmega[3]2
fRPl[3][3]
fOmega[3] 2
fRPl[3][3]
fRVecPl[3]
fdeltat
fRVecPl[3]
fdeltat
Q & A Opportunity
TM
TM
External Use
158
External Use
159
In summary
Part 8: Odds & Ends & Review
Freescale offers the lowest cost, most complete, sensor fusion solution
available anywhere, with:
• Free when used with Freescale sensors (see license file for details)
• 3, 6 and 9-axis sensor fusion options
• Source code for all functions
• Working template programs
• Low cost hardware options
• Extensive documentation (data sheet, user manual and multiple app
notes, training slides and videos)
• Free Windows and Android applications to visualize fusion results
• Freescale community support at
https://community.freescale.com/community/sensors/sensorfusion
• Paid support available from Freescale’s Software Services team
([email protected])
• For more details, please visit http://www.freescale.com/sensorfusion
TM
TM
External Use
160
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
161
27
12/19/2014 11:25:38 AM
More Information on Freescale Sensor Solutions
Additional Resources
http://www.freescale.com/freedom
http://www.freescale.com/gyro
• http://www.freescale.com/sensors
• http://www.freescale.com/sensortoolbox
• www.twitter.com/Sensorfusion
•
•
•
•
•
•
•
•
Blogs: Smart Mobile Devices
− http://blogs.freescale.com/author/michaelestanley/
•
Android App available on Google Play
− Freescale Sensor Fusion Toolbox
•
•
http://www.freescale.com/sensorfusion
•
Orientation Representations: Part 1
Orientation Representations: Part 2
Hard and soft iron magnetic compensation explained
Freescale E-Compass Software
“Euler Angles” at http://en.wikipedia.org/wiki/Euler_Angles
“Introduction to Random Signals and Applied Kalman Filtering”, 3rd
edition, by Robert Grover brown and Patrick Y.C. Hwang, John
Wiley & Sons, 1997.
“Quaternions and Rotation Sequences”, Jack B. Kuipers, Princeton
University Press, 1999.
Matlab computer software by MathWorks http://www.mathworks.com/products/matlab/
TM
TM
External Use
162
External Use
Wrap-up
In this course, we have:
− Learned some motion sensor basics
− Learned what “orientation” is
− Reviewed a basic introduction to motion sensor fusion
− Learned about Freescale’s Freescale Sensor Fusion Library, and how
we might use it to create our own custom functions
− Experimented with the Freescale Sensor Fusion Toolbox
− Learned where to look for more information
163
Thank you for your time and
interest.
TM
TM
External Use
164
External Use
165
TM
www.Freescale.com
Auxiliary Slides
© 2014 Freescale Semiconductor, Inc. | External Use
TM
External Use
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
167
28
12/19/2014 11:25:38 AM
Use the right rotation representation at each stage of your
calculation
Topic
Quaternion
If a and b are 3x1 vectors, then
Rotation Matrix
Storage
Requires 16 bytes of storage in single
precision floating point (4 elements at 4 bytes
each)
Requires 36 bytes of storage (9 elements at
4 bytes each)
Computation (for
2 sequential
rotations)
4 elements each requiring 4 multiplies and 3
additions = 28 operations
9 elements, each requiring 3 multiplies and 2
additions = 45 operations
Vector rotation
Rotating a vector by pre- and postmultiplication of quaternion requires 52
operations
Rotating a vector via rotation matrix requires
15 operations (3 elements each requiring 3
multiplies and 2 additions)
Discontinuities
α° about any axis of rotation XYZ is
equivalent to -α° about axis of rotation -XYZ .
None
Ease of
Understanding
Generally takes a lot of study to understand
the details
From rotation matrix =
Conversion
m11
m12
m13
m21
m22
m23
m31
we have:
q0 = 0.5 sqrt(m11 + m22 + m33 + 1)
q1 = (m32 - m23) / (4q0)
q2 = (m13 - m31) / (4q0)
q3 = (m21 - m12) / (4q0)
m32
m33
A couple of really useful math identities
•
a
The dot product (a⋅b) is a scalar:
θ
− a⋅b = a1b1 + a2b2 + a3b3 = |a||b| cos θ
|a|cosθ
− θ is the angle between the two vectors = cos-1(a⋅b / (|a||b|))
•
The cross product (a X b) is another vector:
−
Easily understood by most engineers
a X b = |a||b| sin θ n, where n is a unit vector perpendicular to the
plane containing a and b
RM =
2q02 - 1 + 2q12
2q1q2 - 2q0q3
2q1q3 +2q0q2
2q1q2 + 2q0q3
2q02 - 1 + 2q22
2q2q3 - 2q0q1
2q1q3 - 2q0q2
2q2q3 + 2q0q1
2q02 -1 + 2q32
TM
TM
External Use
168
External Use
tasks.c
•
169
Project Configuration
Defines the following functions:
RdSensData_Init (void)
− RdSensData_Run (void)
− Fusion_Init (void)
− Fusion Run (void)
− MagCal_Run (void)
− ApplyHal (struct AccelSensor *pthisAccel, struct MagSensor *pthisMag, struct
•
−
•
b
build.h contains standard defines to control the build process
− THISCOORDINATESYSTEM
− Boolean
These are the main
functions called from MQX
GyroSensor *pthisGyro, int32 irow)
Compile options for tasks.c are responsible for binding in various
algorithms into the final application
= NED | ANDROID | WIN8
controls (uncomment #define to enable):
#define name
Function
DEEPSLEEP
Enable deep sleep in idle task()
UART_OFF
Disables UART communication for power
measurements
COMPUTE_3DOF_G_BASIC
Enable 3-axis accelerometer tilt algorithm
COMPUTE_6DOF_GB_BASIC
Enable 6-axis accel/mag eCompass algorithm
COMPUTE_6DOF_GY_KALMAN
Enable 6-axis accel/gyro Kalman algorithm
COMPUTE_9DOF_GBY_KALMAN
Enable 9-axis Kalman algorithm
TM
TM
External Use
170
External Use
Project Configuration
Events.c
#define SENSORFS 200 // int32: frequency (Hz) of sensor sampling process
#define OVERSAMPLE_RATIO 8 // ODR = SENSORFS/OVERSAMPLE_RATIO
•
Other configuration file changes are best made by the Freescale
software and services team
171
NMI interrupt handlers (not used)
Low frequency counter restart
• UART control functions
•
− UART_On-BlockReceived()
is where the application command
interpreter is located
− This is example code only, not a formal part of the fusion library
TM
TM
External Use
172
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
External Use
173
29
12/19/2014 11:25:38 AM
drivers.c major functions
mqx_tasks.c
Main_task() sets up periodic tasks then exits
RdSensData_task() is the high frequency sample task
• Fusion_task() is the medium frequency fusion task
•
FXOS8700_Init() initializes the FXOS87000CQ combo sensor
FXAS21000_Init() initializes the FXAS21000 gyro
MMA8652_Init() initializes the MMA8652 accelerometer
MAG3110_Init() initializes the MAG3310 magnetometer
FXAS21000_ReadData()
FXOS8700_ReadData()
MMA8652_ReadData()
MAG3110_ReadData()
•
− flash
green LED
Fusion_Run()
− send new packet via Bluetooth via CreateAndSendBluetooth
PacketsViaUART()
− set MagCal event as necessary
− calls
•
MagCal_task()
− flash
CreateAndSendBluetoothPacketsViaUART() sends data packets via Bluetooth
− run
red LED
MagCal_run(), which is part of the fusion library
TM
TM
External Use
174
External Use
main.c
•
175
Dependencies Between Project & Fusion Library/Source
“C” main()
Calling Function
Calling Function File
Calls
From
− PE_low_level_init()
RdSensData_Init
tasks.c
MPL3115_Init
FXOS8700_Init
FXAS21000_Init
MMA8652_Init
MAG3110_Init
drivers.c
− PEX_RTOS_START()
MPL3115_ReadData
FXOS8700_ReadData
FXAS21000_ReadData
MMA8652_ReadData
MAG3110_ReadData
RdSensData_Run
RdSensData_task
RdSensData_Run
RdSensData_Init
mqx_tasks.c
Fusion_task
Fusion_Init
Fusion_Run
MagCal_task
MagCal_Run
TM
tasks.c
TM
External Use
176
External Use
177
TM
www.Freescale.com
© 2014 Freescale Semiconductor, Inc. | External Use
Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PEG, PowerQUICC,
Processor Expert, QorIQ, Qorivva, SafeAssure, the SafeAssure logo, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off.
Airfast, BeeKit, BeeStack, CoreNet, Flexis, Layerscape, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, Ready Play, SMARTMOS, Tower, TurboLink, UMEMS,
Vybrid and Freescale are trademarks of Freescale Semiconductor, Inc. All other product or service names are the property of their respective owners. © 2014 Freescale Semiconductor,
Inc.
30
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement