Wiki

This version (25 Jan 2022 19:36) was approved by Naveen Gowda.The Previously approved version (20 Jan 2022 12:17) is available.Diff

Click here to return to A2B Bus Analyzer Homepage.

A2B Bus Analyzer Quick Start Guide

Introduction

The guidelines on these pages are intended to help A2B users configure and use the Analog Devices' (ADI) A2B Bus Analyzer tool in Monitor and/or Node Emulator modes.

Installation and Upgrades

A2B Bus Analyzer can be downloaded from Software Downloads.

Supported Operating Systems

The A2B Bus Analyzer runs on Windows, Linux, and macOS. The Operating Systems table describes the operating system versions supported in this release. 

Platform Details
Windows Windows 10 Home, Pro, Enterprise (64-bit)
Linux Ubuntu 18.04+ (64-bit)
macOS 10.15.x Catalina

Software Installation Instructions

The following sub-sections include installation information for the supported OS platforms. 

Windows

  • To install the A2B Bus Analyzer, double-click on a2b_bus_analyzer-X.Y.Z-channel-win32-x64.exe.
  • The A2B Bus Analyzer is installed in the following default location: C:\Analog Devices\A2B Bus Analyzer.
  • To uninstall the A2B Bus Analyzer, go to the Programs and Features applet in the Control Panel.

Linux

  • To install A2B Bus Analyzer, download the .AppImage. Copy the file into a directory such as ~/Applications
  • If required, ensure that file has execute permissions by running chmod a+x a2b_bus_analyzer_*.AppImage
  • Launch A2B Bus Analyzer by running ./a2b_bus_analyzer-X.Y.Z-channel-x86_64_linux.AppImage
  • Simply delete the .AppImage file to uninstall A2B Bus Analyzer.

Note: By default a USB device is only accessible if the A2B Bus Analyzer is run with sudo. The Linux USB Configuration Script configures a USB device to be accessible by the currently logged-in user.

#!/bin/sh
 
# The following is an example script of how to configure your USB on Linux
# to be accessible by other users.
 
if [ $(id -u) != 0 ]; then
    echo "You must run this script with sudo:"
    echo "sudo $0 $*" exit 1
fi
adirules=/etc/udev/rules.d/adi.rules
# Customize the group name that can access your USB device(s)
adigroup=adiusb
echo "Creating '"$adirules"' ..."
echo ATTRS{idVendor}==\"064b\", GROUP=\"$adigroup\" > $adirules
echo ATTRS{idVendor}==\"0d28\", ATTRS{idProduct}==\"0204\", GROUP=\"$adigroup\" >> $adirules
echo "Done."
if [ -z $(getent group $adigroup) ]; then
    addgroup $adigroup
fi
echo "Adding user '"$SUDO_USER"' to group '"$adigroup"' ..."
usermod -a -G $adigroup $SUDO_USER
echo "Done."
echo "Restarting '/etc/init.d/udev' ..." /etc/init.d/udev restart
echo "Done."
lsusb | grep "ID 064b"
echo "===================================================================="
echo "You must restart your computer for these settings to take effect."
echo "" echo "If you wish to remove ADI device permissions:"
echo "sudo groupdel" $adigroup
echo "sudo rm" $adirules
echo "===================================================================="

macOS

  • To install the A2B Bus Analyzer double-click on a2b_bus_analyzer-X.Y.Z-channel-macos-x64.pkg
    • If the Installation Wizard does not launch, right-click the .pkg file and select Open with… | Installer.
  • The A2B Bus Analyzer is installed in /Applications.

Product Activation

To use the A2B Bus Analyzer product, you will need to activate your product with a License Key that was issued when you purchased the product.

The license is associated with the A2B Bus Analyzer hardware so you need to follow the steps at Bus Analyzer Setup in order to activate your license. Pressing the Software Power button while selecting the serial number of an unlicensed analyzer launches the license menus as described in this section.

A brand-new Analyzer will show a License error when you first try to connect to the device. Click Yes to continue with the activation process.

Select Activate or Update License…

Enter the License key that you received when you purchased the A2B Bus Analyzer select the Activate online if you have access to the Internet or Activate offline if you already have a validation code or you want to request one.

Complete the required fields and click Activate. Your product should now be activated. Use Help | Email Support… menu option to contact technical support should you have any issues.

Software Upgrades

Updating A2B Bus Analyzer Application

The upgrade process is the same for all supported operating systems.

Run the A2B Bus Analyzer, visit the Home screen, click 'Check for Updates'. If a newer version is available 'Download' and then 'Restart to Install' to update your copy of A2B Bus Analyzer.

You can also use the Help | Check for Updates… menu item to find out if there are any new updates available.

After the A2B Bus Analyzer software updates, settings from the previous version are preserved.

Updating A2B Bus Analyzer firmware

The current firmware version on the device is shown on the Home screen after connecting to an A2B Bus Analyzer device.

If a firmware update is available, click 'Update Firmware' and follow the on-screen instructions to flash the new version to your A2B Bus Analyzer.

A2B Bus Analyzer Package Contents

Sl. No.Content Quantity
1 A2B Bus Analyzer HW Unit 1
2 USB-A to Micro-B cable 1
3 12V power supply adapter (US) 1
4 A2B Cable with HDAC to Duraclik connectors 1
5 A2B Cable with HDAC to HDAC connectors 2
6 A2B Cable with Duraclik connectors 2
7 A2B Analyzer Application download instructions1

Getting Started with A2B Bus Analyzer

Bus Analyzer Setup

1. Connect the A2B Bus Analyzer to your PC using the supplied USB-A to Micro-B cable.

2. Connect 12V power supply to A2B Bus Analyzer.

3. Ensure your A2B Bus Analyzer software is installed, registered, and upgraded as explained in the Installation and Upgrades section of this guide.

Using Analyzer as Bus Monitor

1. Complete steps in the Bus Analyzer Setup section above.

2. Connect A2B Bus Analyzer unit between two nodes in an A2B network.

Note: It is recommended to place the analyzer between the Main and first Sub node (Sub node 0) to allow capturing of all events on the bus.

3. Launch the A2B Bus Analyzer application and create a new project or open an existing project using the links on the Welcome panel.

4. Switch to Bus Monitor view using the link in the side panel.

5. Connect to your A2B Bus Analyzer device by selecting it from the device selection drop-down menu then clicking the Power button. Once connected, the Power button becomes green.

6. Activate bus monitoring by sliding the Enable switch.

7. Click Play to start capturing audio and event traffic on the bus.

Note: Event and Audio Traffic area will remain blank until the network host initiates A2B discovery.

8. Switch to the A2B network host program (e.g., SigmaStudio, Head-unit software) and initiate discovery process.

9. With network discovery initiated on the host, the A2B Bus Analyzer application will begin capturing event and audio traffic. Use Audio-Output controls to playback captured audio on the device's Line Out/SPDIF Out or Save as .WAV File or even stream to Host PC over USB using drivers appropriate for your platform (ASIO/ALSA/CoreAudio).

10. Click Stop to finish collecting audio and event traffic. Collected data can be saved to a file (CSV or JSON) using the Download button.

Using Analyzer as Node Emulator

Main Node Emulator

1. Complete steps in the Bus Analyzer Setup section above.

2. Connect Sub node or chain of Sub nodes to the node emulator port labelled “TOWARDS SUB” on STD or HIGH PWR depending on the power configuration of the node being emulated.

Note: AD242x node emulator is also supported on STD PWR. Thus use emulator port labelled “TOWARDS SUB” on STD PWR port to connect sub node(s) when emulating AD242x Main node.

3. Switch to the A2B Bus Analyzer application and create a new project or open an existing project using the options on the Welcome panel. Ensure to check Enable Standard-Power/High-Power Emulator option if available when creating a new project.

4. Switch to Emulator view (Std/High) using the side panel and turn on the function by sliding the Enable switch. Ensure the Power icon is green at this time. If not green, click on the Reset, wait for a few seconds (until the status LED on the unit turns full green) and connect again using the Power icon.

5. Configure the device by setting properties as per the node being emulated. Ensure to set Emulate option to ‘Main’. When emulating a Main node, the network information corresponding to the connected nodes shall be provided as a .dat file exported from SigmaStudio (or SigmaStudio+) for A2B.

Note: A2B SW release package Rel 19.9.0 or higher must be used to export adi_a2b_busconfig.dat when using SigmaStudio. Refer to SigmaStudio user guide documentation available in the A2B SW package on how to create A2B project in SigmaStudio and export a .dat file. The SW release package details for SigmaStudio+ will be provided when that product is available.

6. Click on the ‘Apply’ button to set the emulator in Main node mode and initiate the discovery/configuration of the network as per the provided .dat file.

7. A successful discovery of the network is indicated with the Discovery status icon turning green.

8. Switch to the Audio panel to view audio streams sourced or sinked by the node. Use Audio Output controls to listen/save/stream any audio stream(s) of interest. Use Audio Input controls to feed audio from Line/SPDIF/File/USB In or Test Tones/Loop back options on to the bus.

9. Switch to the Data panel to view SPI data tunnel streams (if any) available on the node. Use Data controls to send/receive data over SPI tunnels different transfer modes.

Sub Node Emulator

1. Complete steps in the Bus Analyzer Setup section above.

2. Insert the Analyzer unit in an A2B network at a desired Sub node position to be emulated. Connect the unit to an upstream node, using TOWARDS MAIN, and to a downstream node, using TOWARDS SUB (if it is not the last node), on STD or HIGH PWR node emulator ports depending on the power configuration of the node being emulated.

Note: AD242x node emulator is also supported on STD PWR. Thus use emulator ports labelled TOWARDS MAIN and TOWARDS SUB on STD PWR when emulating AD242x Sub node.

3. Switch to A2B Bus Analyzer application and create a new project or open an existing project using the options on the Welcome panel. Ensure to check Enable Standard-Power/High-Power Emulator option if available when creating a new project.

4. Switch to Emulator view (Std/High) using the side panel and turn on the function by sliding the Enable switch. Ensure the Power icon is green at this time. If not green, click on the Reset, wait for a few seconds until the status LED on the unit turns full green and connect again using the Power icon.

5. Configure the device by setting properties as per the node being emulated. Ensure to set Emulate option to ‘Sub’.

Note: When emulating a Sub node, the configuration information corresponding to the emulated node is automatically detected by the Analyzer from the bus.

6. Click on the ‘Apply’ button to set the emulator in Sub node mode (indicated by Node Active icon turning green).

7. Switch to the A2B network host program (e.g., SigmaStudio or Head-unit software) and initiate discovery process.

Note: A2B SW release package Rel 19.9.0 or higher must be used when using SigmaStudio. Refer to SigmaStudio user guide documentation available in the A2B SW package on how to create A2B project in SigmaStudio. The SW release package details for SigmaStudio+ will be provided when That product is available.

8. With network discovery initiated on the host, Analyzer will auto detect the settings for the Sub node being emulated (based on the Analyzer position in the network) and configures itself to emulate the Sub node. A successful discovery of Analyzer as a sub node is indicated by the Discovery status icon turning green.

9. Switch to the Audio panel to view audio streams sourced or sinked by the node. Use Audio Output controls to listen/save/stream any audio stream(s) of interest. Use Audio Input controls to feed audio from Line/SPDIF/File/USB In or Test Tones/Loop back options on to the bus.

10. Switch to the Data panel to view SPI data tunnel streams (if any) available on the node. Use Data controls to send/receive data over SPI tunnels different transfer modes.

Further documentation

Most of the user documentation is located, with this guide in the Analog Devices wiki under A2B Bus Analyzer Homepage.

The exception is a more in-depth user guide PDF which can be found in the A2B Bus Analyzer software installation. You can access it under the Help menu

resources/tools-software/a2b-bus-analyzer/quick-start-guide.txt · Last modified: 25 Jan 2022 19:36 by Naveen Gowda