Teledyne Lecroy FrontLine Harmony User Manual

Harmony™ Test System User Manual

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 2

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 3

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 4

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 5

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 6

Figure 1.1 – Installed Applications Detected

Frontline Harmony Hardware & Software User Manual 7

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 8

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 9

Figure 1.5 – Sodera Firmware Update Notification

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 10

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 11

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 12

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 13

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 14

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 15

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 16

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

Frontline Harmony Hardware & Software User Manual 17

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 18

+ 41 hidden pages