Teledyne Lecroy FrontLine Harmony User Manual

Teledyne Lecroy FrontLine Harmony User Manual

Test system

Advertisement

Quick Links

Harmony™ Test System User Manual

Advertisement

Table of Contents
loading

Summary of Contents for Teledyne Lecroy FrontLine Harmony

  • Page 1 Harmony™ Test System User Manual...
  • Page 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.
  • Page 3: Table Of Contents

    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 ........................
  • Page 4 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...
  • Page 5: What Is In This Manual

    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.
  • Page 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;...
  • Page 7 Figure 1.1 – Installed Applications Detected Frontline Harmony Hardware & Software User Manual...
  • Page 8: 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...
  • Page 9: 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...
  • Page 10 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...
  • Page 11: Chapter 2. Getting Started

    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.
  • Page 12 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...
  • Page 13: Attaching Antenna For Over-The-Air Operation

    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...
  • Page 14: 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).
  • Page 15 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).
  • Page 16 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.
  • Page 17 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...
  • Page 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...
  • Page 19: Launching The Software

    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.”...
  • Page 20 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 Frontline Harmony Hardware & Software User Manual...
  • Page 21: Chapter 3. Configuration Settings

    2. The Results Path will remain unspecified until you save your project, at which time you will name the location of your project files, specify a project name, and add a project description. (Figure 3.2) Frontline Harmony Hardware & Software User Manual...
  • Page 22: Tester And Iut Configuration

    Harmony software creates the folder. 3.1.2 Tester and IUT Configuration Click the “Tester and IUT Configuration” tab to configure settings affecting the Harmony tester, PC connection, and the IUT. (Figure 3.3) Frontline Harmony Hardware & Software User Manual...
  • Page 23 Seconds” textbox will be enabled when “Power Cycle” is selected. 9. Click the “IUT Supported Commands” button to populate the octet fields. Note: It is important to fill in the octet fields otherwise some tests will fail. Frontline Harmony Hardware & Software User Manual...
  • Page 24: Ixit Data

    Click the “IUT Information” tab to configure customer, manufacturer and product meta data. Some fields are required so that any Test Reports produced include the information expected in a Bluetooth validation report. (Figure 3.5) Frontline Harmony Hardware & Software User Manual...
  • Page 25 Figure 3.5 – IUT Information Frontline Harmony Hardware & Software User Manual...
  • Page 26: Chapter 4. Running Tests

    Verify that the IUT correctly handles the LE Write Suggested Data Length Command HCI/CCO/BV-12-C Verify that the IUT correctly handles the LE Remove Device From Resolving List Command HCI/CCO/BV-13-C Verify that the IUT correctly handles the LE Clear Resolving List Command Frontline Harmony Hardware & Software User Manual...
  • Page 27 Reject LE Periodic Advertising Create Sync Command to a Synchronized Advertising Set HCI/DDI/BV-03-C Set Advertise Enable HCI/DDI/BV-04-C Set Scan Enable HCI/DSU/BV-02-C Reset in advertising state HCI/DSU/BV-03-C Reset to slave HCI/DSU/BV-04-C Reset in scanning state Frontline Harmony Hardware & Software User Manual...
  • Page 28: Link Layer

    Channel Selection Algorithm #2 LL/CON/ADV/BV-09-C Tests that an advertiser IUT receives a connection request stops advertising after the reception and starts to maintain a connection in the slave role Frontline Harmony Hardware & Software User Manual...
  • Page 29 Tests that an initiator IUT sends a connection request to an advertiser using directed advertising and starts to maintain a connection in the master role when the advertisement indicates no support of Channel Selection Algorithm #2 Frontline Harmony Hardware & Software User Manual...
  • Page 30 Test that a master IUT is able to maintain a connection when the slave using the slave latency mechanism LL/CON/MAS/BV-03-C Master Sending Data LL/CON/MAS/BV-04-C MASTER - Master Receiving Data LL/CON/MAS/BV-05-C MASTER - Master Sending And Receiving Data Frontline Harmony Hardware & Software User Manual...
  • Page 31 Test that a master IUT is able to perform the PHY update procedure when asymmetric links are not supported LL/CON/MAS/BV-43-C Test that a master IUT is able to respond to a PHY update procedure from a slave device Frontline Harmony Hardware & Software User Manual...
  • Page 32 Constant Tone Extension Request Procedure, IUT Initiated, Periodic LL/CON/MAS/BV-58-C Constant Tone Extension Request Procedure, IUT Initiated, Responses Disabled LL/CON/MAS/BV-59-C Verifies that the IUT correctly handles the case where the remote does not support the Connection CTE Response feature. Frontline Harmony Hardware & Software User Manual...
  • Page 33 Constant Tone Extension Request Procedure, IUT Responding, Unsupported LL/CON/MAS/BV-84-C Periodic Advertising Sync Transfer Procedure, Advertising IUT Initiated LL/CON/MAS/BV-85-C Periodic Advertising Sync Transfer Procedure, Advertising IUT Initiated LL/CON/MAS/BV-86-C Periodic Advertising Sync Transfer Procedure, Advertising IUT Initiated Frontline Harmony Hardware & Software User Manual...
  • Page 34 PHY Update Procedure – Master Requests Asymmetrical, Slave Symmetrical LL/CON/MAS/BV-118-C Unrequested Constant Tone Extension, IUT Receiving, AoD – LE 2M PHY LL/CON/MAS/BV-119-C Constant Tone Extension Request Procedure, IUT Initiated, AoA – LE 2M Frontline Harmony Hardware & Software User Manual...
  • Page 35 SLAVE - Slave Request Version LL/CON/SLA/BV-20-C SLAVE - Slave Request Version LL/CON/SLA/BV-21-C SLAVE - Slave Acknowledgement Scheme LL/CON/SLA/BV-22-C SLAVE - Initiate Feature Exchange LL/CON/SLA/BV-23-C SLAVE - Initiate Feature Exchange - Master Does Not Support Frontline Harmony Hardware & Software User Manual...
  • Page 36 Test that a slave IUT follows all packet time restrictions both during and after PHY change when it responds to a PHY update procedure from a master device but no PHY change occurs Frontline Harmony Hardware & Software User Manual...
  • Page 37 Constant Tone Extension Request Procedure, IUT Initiated, AoA, Incorrect CRC – LE 1M PHY LL/CON/SLA/BV-77-C Verify that the IUT as Slave correctly handles reception of an LL_LENGTH_REQ PDU on the LE 1M PHY Frontline Harmony Hardware & Software User Manual...
  • Page 38 Periodic Advertising Sync Transfer Procedure, Accepting – Skipping Events LL/CON/SLA/BV-104-C Periodic Advertising Sync Transfer Procedure, Accepting – Already Synchronized LL/CON/SLA/BV-105-C Periodic Advertising Sync Transfer Procedure, Accepting – Extreme Timings LL/CON/SLA/BV-106-C Periodic Advertising Sync Transfer Procedure, Accepting – Synchronization Failure Frontline Harmony Hardware & Software User Manual...
  • Page 39 Disallow Extended Advertising PDU sizes for Legacy Advertising when advertising enabled LL/DDI/ADV/BI-06-C Disallow Extended Advertising PDU sizes for Scannable Legacy Advertising when advertising enabled LL/DDI/ADV/BV-01-C Non-Connectable Advertising Events LL/DDI/ADV/BV-02-C ADVERTISING - Undirected Advertising Events LL/DDI/ADV/BV-03-C ADVERTISING - Advertising Data: Non-Connectable Frontline Harmony Hardware & Software User Manual...
  • Page 40 PDUs in parallel with the correct payload fields timing and channel sequence for the maximum time allowed LL/DDI/ADV/BV-33-C Tests that an advertiser IUT can support multiple periodic advertising sets Frontline Harmony Hardware & Software User Manual...
  • Page 41 Extended Advertising, Periodic Advertising – LE Coded PHY LL/DDI/SCN/BI-01-C Tests that a scanner IUT ignores advertising indication packets with invalid CRC's LL/DDI/SCN/BI-02-C Tests that a scanner IUT ignores data in advertising packets with invalid checksums Frontline Harmony Hardware & Software User Manual...
  • Page 42 Lower Tester using its device identity address when the identity address and an associated IRK are in the resolving list using device privacy mode LL/DDI/SCN/BV-33-C Privacy - Extended Scanning, Active, Core 5.0 Frontline Harmony Hardware & Software User Manual...
  • Page 43 Active Scanning Invalid Address LL/ENC/SLA/BI-01-C Tests that a slave IUT ignores a packet starting an event belonging to a different connection LL/FRH/ADV/BV-01-C ADVERTISING/SLAVE - Accepting Connections With Hop Lengths LL/FRH/MAS/BV-01-C MASTER - Requesting Channel Map Update Frontline Harmony Hardware & Software User Manual...
  • Page 44 Resolving List connects to the devices that are only in the resolving list. The IUT should only connect to a Lower Tester upon successful resolution of the peer's resolvable private address Frontline Harmony Hardware & Software User Manual...
  • Page 45 LL/SEC/MAS/BV-06-C LE Authenticated Payload Timeout Timer (2) LL/SEC/MAS/BV-07-C LE Ping Procedure (2) LL/SEC/MAS/BV-08-C LE Authenticated Payload Timeout Timer (2) LL/SEC/MAS/BV-09-C LE Authenticated Payload Timeout Timer (2) LL/SEC/MAS/BV-10-C LE Authenticated Payload Timeout Timer (2) Frontline Harmony Hardware & Software User Manual...
  • Page 46 Initiate Sleep Clock Accuracy Update LL/TIM/MAS/BV-04-C Response to Sleep Clock Accuracy Update LL/TIM/MAS/BV-05-C Response without Reducing the Sleep Clock Accuracy LL/TIM/MAS/BV-06-C Extended Advertising, Secondary Channel, Latest Transmission to Advertiser – LE 2M PHY Frontline Harmony Hardware & Software User Manual...
  • Page 47: Importing Tests

    BLS document can be imported into Harmony to automatically select the tests. To import the tests: 1. Click “Import/Export” 2. Click “Import test selection from Bluetooth Launch Studio document…” 3. Point to the location of the file 4. Open the file. (Figure 4.2) Frontline Harmony Hardware & Software User Manual...
  • Page 48: Initiating Tests

    2. Makes sure all connected equipment is powered and running. 3. Once the desired tests are selected, click the “Run Tests” button to initiate. (Figure 4.4) 4. Clicking the “Run Tests” button automatically saves the project. Frontline Harmony Hardware & Software User Manual...
  • Page 49: Running Harmony Projects Unattended

    The Harmony Tester and Sodera firmware must be up to date and the licenses for Harmony Tester and Sodera cannot be expired (see Chapter 1 for information about hardware and software updates) Frontline Harmony Hardware & Software User Manual...
  • Page 50 5. The HarmonyLeTester.exe should start, the CI_Example.hprj project opened, and the selected Test Cases run. 6. After the Test Cases are all run and the HarmonyLeTester windows application closes, a summary of the results will be written to the console output. (Figure 4.7) Frontline Harmony Hardware & Software User Manual...
  • Page 51: Chapter 5. Test Results

    (Figure 5.1) 2. The Test Results pane displays the test name, the verdict/status of the test, the number of attempts made, the start time of the test, and the duration of the test. Frontline Harmony Hardware & Software User Manual...
  • Page 52 3. Tests that are still running will indicate that status in the “Verdict” column. Tests that have completed will be indicated by either a “Pass”, “Fail”, “Inconclusive”, “N/A”, or “Manual” in the “Verdict” column. (Figure 5.2) Frontline Harmony Hardware & Software User Manual...
  • Page 53: Review Previously Run Tests

    5.1.2 Review Previously Run Tests Previously run tests can be called up and reviewed at any time. 1. Click the “Run Explorer” tab to access previously completed tests. (Figure 5.3) Figure 5.3 – Run Explorer Frontline Harmony Hardware & Software User Manual...
  • Page 54: Produce Test Result Reports

    BLS document. To export the test results click “Import/Export”, click “Export test results to Bluetooth Launch Studio document…”, select the file, and click the “Export” button. (Figure 5.5.) Frontline Harmony Hardware & Software User Manual...
  • Page 55 Figure 5.4 – Testing Summary Frontline Harmony Hardware & Software User Manual...
  • Page 56: Results Files

    3. Click the “Go to Folder…” Shortcut to the Folder the Test Runs 1. Select the Run Explorer tab. 2. Right click the set of test runs of interest. 3. Click the “Go to Folder…” Frontline Harmony Hardware & Software User Manual...
  • Page 57: Log/Capture Files

    *.script.log – records the detail of the test case b. *.IUT.snoop.log - btsnoop capture of the HCI traffic to & from the IUT c. *.cfa – Sodera capture file d. *.scap, *.bes, *.frm, *.fsc, *.swsd, *.htm - Sodera capture-related files Frontline Harmony Hardware & Software User Manual...
  • Page 58: Chapter 6. General Information

    2. To open a capture file, open the “Capture File Viewer” from the “Frontline Harmony” folder, then use “File/Open” to navigate to the “Results” folder to open the appropriate .cfa file.
  • Page 59: Chapter 7. Regulatory

    Cet appareil est conforme aux RSS exempts de licence d'Industrie Canada. 1. Cet appareil ne doit pas causer d'interférences; et 2. Cet appareil doit accepter toute interférence, y compris les interférences susceptibles de provoquer un fonctionnement indésirable de l'appareil. Frontline Harmony Hardware & Software User Manual...

Table of Contents