Teledyne Lecroy FrontLine Harmony User manual

Harmony™ Test System User Manual

Frontline Harmony Hardware & Software User Manual 2
Copyright © 2019 Teledyne LeCroy, Inc.
Frontline is a registered trademark of Teledyne LeCroy, Inc.
The following are trademarks of Teledyne LeCroy, Inc.
The Bluetooth SIG, Inc. owns the Bluetooth® word mark and logos, and any use of such marks by
Teledyne LeCroy, Inc. is under license.
All other trademarks and registered trademarks are property of their respective owners.

Frontline Harmony Hardware & Software User Manual 3
Table of Contents
What is in this manual .............................................................................................................................. 5
Chapter 1. Frontline Hardware & Software.................................................................................................. 6
1.1 Computer Minimum System Requirements ....................................................................................... 6
1.2 Software Installation........................................................................................................................... 6
1.3 Harmony Firmware ............................................................................................................................. 8
1.4 Sodera Firmware................................................................................................................................. 9
Chapter 2. Getting Started.......................................................................................................................... 11
2.1 Harmony Hardware.......................................................................................................................... 11
2.1.1 Attaching Cables for Conductive Operation ..................................................................................11
2.1.2 Attaching Antenna for Over-the-Air Operation .............................................................................13
2.1.3 Connecting/Powering the Frontline Harmony............................................................................... 14
2.1.4 Launching the Software .................................................................................................................19
Chapter 3. Configuration Settings...............................................................................................................21
3.1 Configuring the Software ..................................................................................................................21
3.1.1 Project Settings ..............................................................................................................................21
3.1.2 Tester and IUT Configuration......................................................................................................... 22
3.1.3 IXIT Data .........................................................................................................................................24
3.1.4 IUT Information.............................................................................................................................. 24
Chapter 4. Running Tests ............................................................................................................................ 26
4.1 Selecting Tests.................................................................................................................................. 26
4.1.1 HCI..................................................................................................................................................26
4.1.2 Link Layer .......................................................................................................................................28
4.1.3 Importing Tests .............................................................................................................................. 47
4.2 Initiating Tests.................................................................................................................................. 48
4.2.1 Run Tests........................................................................................................................................48
4.2.2 Running Harmony Projects Unattended ........................................................................................ 49
Chapter 5. Test Results ...............................................................................................................................51
5.1 On-Screen Test Results ....................................................................................................................51
5.1.1 Results Pane ................................................................................................................................... 51
5.1.2 Review Previously Run Tests.......................................................................................................... 53
5.2 Produce Test Result Reports............................................................................................................ 54
5.2.1 Reports...........................................................................................................................................54

Frontline Harmony Hardware & Software User Manual 4
5.3 Results Files......................................................................................................................................56
5.3.1 Location.......................................................................................................................................... 56
5.3.2 Log/Capture Files ...........................................................................................................................57
Chapter 6. General Information.................................................................................................................. 58
6.1 More Help ......................................................................................................................................... 58
6.1.1 Frontline Software .........................................................................................................................58
6.1.2 User Assistance ..............................................................................................................................58
Chapter 7. Regulatory .................................................................................................................................59
7.1 Certifications.....................................................................................................................................59
7.1.1 FCC - Federal Communications Commission.................................................................................59
7.1.2 RED - Radio Emissions Directive.................................................................................................... 59
7.1.3 ISED - Innovation, Science and Economic Development (RSS Radio Standards Specification).....59

Frontline Harmony Hardware & Software User Manual 5
What is in this manual
The Frontline Harmony Test System User Manual comprises the following chapters, which are organized
in the sequence you would normally follow to perform validation testing: set up, configure, test, report.
You can read them from beginning to end to gain a complete understanding of how to use the Frontline
Harmony hardware and software or you can skip around if you only need a refresher on a particular
topic. Use the Contents, Index, and Glossary to find the location of particular topics.
•Chapter 1. Frontline Hardware and Software. This chapter will describe the minimum computer
requirements, how to install the software and license key, and how firmware updates are
provided.
•Chapter 2. Getting Started. Here we describe how to set up and connect the hardware, and how
to apply power. This chapter also describes how to start the Frontline Harmony software.
•Chapter 3. Configuration Settings. The software is configured to capture data. Configuration
settings may vary depending on the user’s pc configuration and the implementation under test
(IUT).
•Chapter 4. Running Tests. This chapter describes how to run one or more validation tests.
•Chapter 5. Test Results. Here you will find how to view results, export reports, and use the files
stored in the Results folder.
•Chapter 6. General Information. This chapter provides additional information about the
troubleshooting failed tests with Frontline Sodera, and also provides information on how to
contact Frontline's Technical Support team should you need assistance.
Important note: The Harmony Test System includes a Frontline Sodera unit. Other Sodera units can
be used with the Harmony hardware, however they must have either a Dual Mode Advance license
or a Single Mode LE Advance license to work correctly with the system. Please use the “Renew PM”
application to check your license type. The Sodera unit you received with the Harmony Test System
is ensured to work correctly when used in tandem with your system’s Harmony hardware.

Frontline Harmony Hardware & Software User Manual 6
Chapter 1. Frontline Hardware & Software
The Frontline Harmony hardware interfaces with your computer that is running the Harmony software.
Frontline Harmony Test System is an easy to use and powerful tool to perform a wide variety of
Bluetooth low energy HCI and link layer validation testing. The Harmony Test System is a set of
integrated components, including the Frontline Harmony hardware; the Frontline Sodera Wideband
Bluetooth Protocol Analyzer; and the Harmony software.
This manual is a user guide that takes you from connecting and setting up the hardware through all of
the Frontline Harmony software functions for your Frontline hardware. Should you have any questions
contact the Frontline Technical Support Team.
1.1 Computer Minimum System Requirements
•Frontline supports the following computer systems configurations:
•Operating System: Windows 10
•USB Port: USB 2.0 High-Speed or or later
•The Frontline software must operate on a computer with the following minimum characteristics.
•Processor: Core i5 processor at 2.7 GHz
•RAM: 4 GB
•Free Hard Disk Space on C: drive: 20 GB
1.2 Software Installation
Download the installation software from a link that should have been provided to you. If you did not
receive that link, please contact the Frontline Technical Support Team.
The license key should also have been distributed directly to you. It is a file called “licenseKey.py,”
which should be saved in the following folder (making allowances for your specific environment):
C:\Users\UserName\AppData\Roaming\Frontline Test Equipment\LETester\licenseKey.py
Versions of Harmony software before Release 2.2 would automatically uninstall any previously installed
version of Harmony software. Starting with Release 2.2 the user has the option to leave earlier versions
installed, uninstall selected versions, or uninstall all previously installed versions through the following
pop-up:

Frontline Harmony Hardware & Software User Manual 7
Figure 1.1 – Installed Applications Detected

Frontline Harmony Hardware & Software User Manual 8
Note: If the user had previously installed Frontline hardware (such as BPA500 or BPA600) and the
Premium Maintenance for the devices have expired the following pop-up will appear and the pop-up
shown above will not be displayed during the installation of the Harmony software.
Figure 1.2 – Harmony Premium Maintenance Status
1.3 Harmony Firmware
The Harmony software will check the version of Harmony hardware firmware and determine if the
firmware needs to be upgraded or downgraded. If the firmware needs to be changed a popup window
like the one below will appear (Figure 1.3)

Frontline Harmony Hardware & Software User Manual 9
Figure 1.3 – Harmony Firmware Upgrade Notification
Follow the instructions in the popup window. Note: if the “Cancel” button is selected the firmware will
not be changed and the tests will not be run until the firmware is correct. If the firmware was not
changed when initially prompted one can change the firmware by going to Help > Update Harmony
Firmware…
If the “Upgrade Firmware” button or “Downgrade Firmware” button is clicked, another popup window
will open showing the progress of the firmware change (Figure 1.4). When the firmware change is
complete click the “Close” button.
Figure 1.4 – Updating Harmony Firmware
1.4 Sodera Firmware
The Harmony software will check the version of Sodera hardware firmware and determine if the
firmware needs to be upgraded or downgraded. If the firmware needs to be updated a popup window
like the one below will appear (Figure 1.5).

Frontline Harmony Hardware & Software User Manual 10
Figure 1.5 – Sodera Firmware Update Notification
Follow the instructions in the popup window. Note: if the “Cancel” button is selected the firmware will
not be changed and the tests will not be run until the firmware is correct. If the firmware was not
changed when initially prompted one can change the firmware by going to Help > Update Sodera
Firmware…
If the “Update Firmware” button is clicked, another popup window will open showing the progress of
the firmware change (Figure 1.6). When the firmware change is complete click the “Close” button.
Figure 1.6 – Sodera Firmware Update in Progress

Frontline Harmony Hardware & Software User Manual 11
Chapter 2. Getting Started
In this chapter we introduce you to the Frontline Harmony hardware and show how to start the
Frontline Harmony software and explain the basic software controls and features for conducting
validation tests.
2.1 Harmony Hardware
2.1.1 Attaching Cables for Conductive Operation
Since over-the-air sniffing can be compromised in noisy RF environments, conductive testing is the
recommended approach.
1. Attach one end of each of the three provided RF cables to the T-connector, also provided with
your Harmony Test System (Figure 2.1).
Figure 2.1 – RF Cables and T-Connector
2. To the other end of each RF cable, connect one of the three provided 20dB attenuators (Figure
2.2).

Frontline Harmony Hardware & Software User Manual 12
Figure 2.2 – RF Cable and Attenuator
3. Attach one cable-connected attenuator to the Antenna (ANT) port of the Harmony hardware.
4. Attach one cable-connected attenuator to the Antenna port of the Frontline Sodera hardware.
5. Attach the last cable-connected attenuator to the RF output of the IUT.
Important note: If the IUT’s RF output isn’t capacitively coupled, attach the provided DC
blocker to the attenuator before connecting the attenuator to the RF output of the IUT (Figure
2.3). If you don’t know whether the IUT’s RF output is capacitively coupled, use of the DC
blocker is recommended.

Frontline Harmony Hardware & Software User Manual 13
Figure 2.3 – DC Blocker Connection to Attenuator
2.1.2 Attaching Antenna for Over-the-Air Operation
Although conductive testing will yield the best results, over-the-air testing can provide good results
when the testing is done in a controlled RF environment (e.g. an RF shielded room). If you choose to do
over-the-air testing, attach the supplied antenna to the Harmony hardware.
1. Attach the antenna to the SMA connector jack under the “ANT” label. (Figure 2.4)

Frontline Harmony Hardware & Software User Manual 14
Figure 2.4 – Antenna Connection
2.1.3 Connecting/Powering the Frontline Harmony
Once you have readied the Harmony hardware for conductive or over-the-air testing, the next step is to
power up and connect the Frontline Harmony to the computer.
1. Connect the provided 5VDC 1.2A adapter to the Power port on the Frontline Harmony back
panel (Figure 2.5).

Frontline Harmony Hardware & Software User Manual 15
Figure 2.5 – Power Connection
2. Plug the adapter into the AC power source. The rear panel Power light will illuminate.
Note: The Harmony hardware is designed to operate using only USB power in mobile settings, or
when access to a wall outlet is unavailable. Powering your Harmony hardware using a wall
outlet will provide more power to the USB ports.
3. Insert the supplied USB mini cable into the PC connection on the Frontline Harmony rear panel
(Figure 2.6).

Frontline Harmony Hardware & Software User Manual 16
Figure 2.6 – PC Connection
4. Insert the other end of the USB cable into the PC.
5. Insert the supplied USB mini cable into the Port 1 connection on the Frontline Harmony rear
panel (Figure 2.7). The second port is present to allow for possible future expansion.

Frontline Harmony Hardware & Software User Manual 17
Figure 2.7 – IUT Port Connections
6. Plug the other end of the Port USB cable into the IUT.
7. Connect Frontline Sodera’s PC Host port to PC via USB (Figure 2.8)
Figure 2.8 – Sodera PC Connection
Important note: The Harmony Test System includes a Frontline Sodera unit. Other Sodera units can
be used with the Harmony hardware, however they must have either a Dual Mode Advance license
or a Single Mode LE Advance license to work correctly with the system. Please use the “Renew PM”
application to check your license type. The Sodera unit you received with the Harmony Test System
is ensured to work correctly when used in tandem with your system’s Harmony hardware.

Frontline Harmony Hardware & Software User Manual 18
8. After making these connections, your setup should resemble a typical testing configuration
(Figure 2.9)
Figure 2.9 – Typical Testing Configuration

Frontline Harmony Hardware & Software User Manual 19
Figure 2.10 – Relay Connections
9. The relay (Figure 2.10) port is a solid state device used to externally control devices, like
switches, triggers, etc.
a. The center pin of the connector is Common (COM) and the other two pins are Normally
Open (NO) and Normally Closed (NC).
b. The relay provides a means by which users can reset their IUT between tests (e.g. by
removing and then reapplying power to the IUT, or by asserting & releasing a reset line).
2.1.4 Launching the Software
Installing the Frontline Harmony software creates folders necessary for the operation of the software.
After you’ve placed the “licenseKey.py” license key in the appropriate folder per section 1.3, you can
launch the software using one of two methods.
1. Click the Windows Start Menu, then under All Programs find the Frontline Harmony program
group and click on “Harmony Tester.”
2. Open the Frontline Harmony Folder that was added during installation to your desktop and click
on “Harmony Tester.”
3. The Harmony Tester interface is comprised of eight panes (Figure 2.11)
a. Test Selection – allows you to select tests to run
b. Run Explorer – allows you to review tests that have already been completed

Frontline Harmony Hardware & Software User Manual 20
c. Event Viewer – the Event Viewer is a record of significant events that occurred at any
time the Harmony LE Tester is running
d. Project Settings – provides test settings
e. Tester and IUT Configuration – provides for configuration of Harmony hardware and IUT
hardware
f. IXIT Data – provides for Implementation eXtra Information for Test (Implementation-
specific values that further describe the capabilities of the IUT, e.g. the limits of what is
supported).
g. IUT Information – provides for customer, manufacturer and product information
h. Test Results – provides pass/fail feedback on tests run
Figure 2.11 – Harmony Tester Interface