This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
resources:tools-software:a2b-bus-analyzer:release-notes [02 Sep 2021 10:54] – [Bus Monitor] Andrew McLachlan | resources:tools-software:a2b-bus-analyzer:release-notes [14 Nov 2023 11:46] (current) – 3.4.0 release notes S Fernandez | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== A2B Bus Analyzer Release Notes ====== | + | [[resources/ |
+ | ====== A2B Bus Analyzer | ||
+ | ==== New and Noteworthy ==== | ||
+ | === Improvements in Test Tone support === | ||
+ | == Support for multiple streams contributing to the same Test Tone == | ||
+ | Similarly to being able to select multiple streams contributing to the same source channel as released in 3.3.0, you can now select for the same test tone to go to multiple streams. | ||
+ | {{: | ||
+ | == Increased precision in Test Tone gain == | ||
+ | The precision of the gain has been increased to allow the gain to be changed in increments of 0.01 dB. | ||
+ | |||
+ | === Support for setting sub-specific registers in the Regs Any Node tab when emulating main === | ||
+ | Previous releases of the A2B Bus Analyzer only displayed the list of registers for the node being emulated. As a consequence of this, when emulating main, it was impossible to read/write sub-specific registers like mailbox registers. Further, emulating a AD242x main node with some AD243x sub nodes would result on not being able to read/write AD243x specific registers. | ||
+ | |||
+ | For this reason you now need to select which node to display the registers for before adding them to the register sequence. Reading/ | ||
+ | {{: | ||
+ | |||
+ | === Improved Emulator Start Sequence === | ||
+ | This release reduces the steps required to start the emulator. For this the " | ||
+ | |||
+ | === New SDK APIs for enhanced tone support === | ||
+ | Since the UI supports multiple streams for the same tone and a precision of cdB, new SDK APIs have been introduced which support the new tones, | ||
+ | |||
+ | The previous APIs a2ba_sdk_emulator_tone_start and a2ba_sdk_emulator_tone_update are now considered deprecated and may be removed in a future release. | ||
+ | |||
+ | See the SDK documentation in the SDK menu for more information about the arguments that these APIs support. | ||
+ | |||
+ | === Use of IntEnum rather than integers in the a2ba_sdk Python package === | ||
+ | Previous releases of the a2ba_sdk Python package used integers wherever the C interface used enumerations; | ||
+ | |||
+ | === New SDK menu for easy access === | ||
+ | In order to make the SDK documentation easier to find, the UI now contains a dedicated SDK menu item where you can export the SDK and access both the C/C%%++%% and python documentation in a clearer manner. | ||
+ | |||
+ | ====== A2B Bus Analyzer 3.3.0 Release Notes ====== | ||
+ | ==== New and Noteworthy ==== | ||
+ | === Selection of channels/ | ||
+ | Since version 3.2.0 channel/ | ||
+ | |||
+ | {{: | ||
+ | === Support for multiple streams contributing to the same Source channel (Line In/SPDIF In/USB In) === | ||
+ | Similarly to being able to select multiple channels for a given stream in Sink/ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === Selection of slots to store in standalone mode === | ||
+ | In 3.2, Standalone mode was introduced, allowing the A2B network activities to be sniffed by the Bus Monitor and get logged onto an SD card without the use of a computer for field/ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === Support for emulation of smart sub nodes === | ||
+ | Smart subnodes require certain register writes in order to be able to discover the network. For this reason, A2B Bus Analyzer 3.3.0 adds the capability of specifying an optional JSON or XML file which contains the register writes required. If a node number is specified in this file it is ignored. The format for the XML is the same as the one generated by Sigma Studio and the format for JSON is the same as generated by the A2B Bus Analyzer when saving a sequence in the Regs Any Node pane. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === Changes to format in import/ | ||
+ | o help discover smart sub-nodes, the A2B Bus Analyzer Application now allows the user to select a register sequence JSON or XML file before starting the emulator, to allow for registers to be read and written between Emulator Connect and Start. The JSON structure of the register sequence has changed, but ones from previous versions (3.2 and below) will still be compatible. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ==== Solved Issues ==== | ||
+ | For all solved issues see https:// | ||
+ | |||
+ | === Audio bit exactness and clock skew elimination === | ||
+ | Previous versions did not maintain bit exactness of USB Audio and interpolation/ | ||
+ | |||
+ | === Incorrect value used for delays in peripheral programming === | ||
+ | Version 3.2.0 introduced the peripheral programming window. Unfortunately there was a bug in the code where the value for " | ||
+ | |||
+ | === File Out may not work in windows systems that are not in English === | ||
+ | Version 3.2.0 of the A2B Bus Analyzer replaced the way file out is done in order to be able to support more than two channels. This version required the Audio Devices in Device Manager to be called “Microphone (A2B Bus Analyzer)” and/or “Speakers (A2B Bus Analyzer)”. In windows devices in other languages file out does not work since the device is not found. | ||
+ | ====== A2B Bus Analyzer 3.2.0 Release Notes ====== | ||
+ | ==== New and Noteworthy ==== | ||
+ | === New Stand-alone mode === | ||
+ | During field/ | ||
+ | |||
+ | Note that when the analyzer HW is recording data in stand-alone mode, the USB connection cannot be used and therefore the A2B Bus Analyzer application cannot be used at the same time. The position of the stand-alone switch was ignored in previous releases. | ||
+ | <note warning> | ||
+ | |||
+ | === New Peripheral Programming Window for Emulator Main === | ||
+ | The UI now incorporates as a tab in the register windows in which providing a XML file with I2C peripheral accesses in the same format generated by Sigma Studio, an output file is generated with the result of the accesses. Json is also supported but there are no tools currently that generate that file format. To match this there is a new SDK API in both python and C/Cpp which takes a whole file instead of a list of accesses. The API is // | ||
+ | |||
+ | === Changes to Audio File-Out - now linked to USB Out === | ||
+ | In order to be able to support file out to more than two channels, file out has been completely re-implemented to not poll the firmware for data. Instead, the output is redirected to USB Out and captured to a file from there. This means that as well as being able to record up to a total of 32 channels at a time, you can also record to file simultaneously from monitor and emulator. | ||
+ | |||
+ | As a consequence of the change, file out does not work on windows remote desktop sessions since the USB device is not found in device manager or on macOS when connecting remotely. This is the same limitation that other tools like Audacity have. | ||
+ | |||
+ | === Redesign of the audio panes === | ||
+ | There has been a redesign in the way that the tables with streams in order to remove the control pane. The change has been made to try to accommodate smaller screens better. From this versions, enabling Line Out/SPDIF out etc will be done from the stream description itself. As part of this redesign some of the previous user interface restrictions have been changed | ||
+ | |||
+ | ^Control^**3.1.0** ^**3.2.0** ^ | ||
+ | | Line Out used in both monitor and emulator simultaneously (total max 2 channels) | <fc # | ||
+ | | Line Out and SPDIF Out can be used simultaneously in monitor | <fc # | ||
+ | | Line Out and SPDIF Out can be used simultaneously in emulator | <fc # | ||
+ | | USB Out can be used at the same time in monitor and emulator | <fc # | ||
+ | | File Out can be used at the same time in monitor and emulator | <fc # | ||
+ | | Same sink stream can used in multiple controls simultaneously (other than Line out/SPDIF out) | <fc # | ||
+ | | Line In and SPDIF In can be used simultaneously in emulator | <fc # | ||
+ | | USB In and Out start the moment a stream is selected without an " | ||
+ | | Same source stream can used in multiple controls simultaneously (other than Line out/SPDIF out) | <fc # | ||
+ | | A stream can be selected for both left and right in Line and SPDIF | <fc # | ||
+ | |||
+ | === New SDK Python wheel version - new Ubuntu version === | ||
+ | This version includes a wheel for python 3.10 as well as the prior one for python 3.8. This has resulted in an increase to the minimum version of Ubuntu supported which has increased from 18.04 to 20.04. | ||
+ | |||
+ | ====== A2B Bus Analyzer 3.1.0 Release Notes ====== | ||
+ | ==== New and Noteworthy ==== | ||
+ | === AD2430/38 transceiver support === | ||
+ | This version includes Beta support for AD2430/38 emulator sub and main. The emulator transceiver drop-down includes the supported devices. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | The bus monitor features were always available for AD2430/38 even if this was not explicitly mentioned in the release notes. | ||
+ | |||
+ | For any known issues refer to [[resources: | ||
+ | |||
+ | === Enable monitoring of networks already discovered === | ||
+ | Previous versions of the A2B Bus Analyzer required network discovery to be triggered after the monitor had been enabled. This version introduces the ability of monitoring networks that have already been discovered by ticking a box in the UI. This would allow getting monitor events immediately but in order to see audio streams further steps need to be taken. Please see the A2B Bus Analyzer User Guide for more details. | ||
+ | |||
+ | === New user-accessible SDK APIs === | ||
+ | == APIs for programming peripherals == | ||
+ | The User-Accessible SDK now supports the APIs a2ba_sdk_peri_access and a2ba_sdk_peri_combined_accesses to program I2C peripherals from either python or C/C%%++%%. These APIs are only available when emulating main nodes. Please see the A2B Bus Analyzer SDK HTML API documentation for more information. | ||
+ | |||
+ | == APIs to support data tunnels == | ||
+ | The User-Accessible SDK now supports the APIs a2ba_sdk_emulator_spi_info, | ||
+ | |||
+ | === Incompatible change in User-accessible SDK API to allow monitoring of networks already discovered === | ||
+ | The API a2ba_sdk_monitor_enable now takes an argument which indicates whether monitor will work on an already discovered network or if the network must be discovered after the call to the API. Setting this parameter to 0 will result on the same behaviour as prior releases of the SDK. | ||
+ | |||
+ | === Volume setting for USB and SPDIF === | ||
+ | Previous versions of the SDK allowed changing volume (gain) in USB and SPDIF inputs and outputs. This has been removed and trying to call the API for anything other than Line In/Out results in an error. The volume setting for SPDIFF from the UI has been removed. | ||
+ | ====== A2B Bus Analyzer 3.0.1 Release Notes ====== | ||
+ | ==== Issues Adressed ==== | ||
+ | Due to the lack of security support for Python 3.6, the A2B Bus Analyzer SDK has been moved from Python 3.6 to Python 3.8 with this being the only version supported. | ||
+ | === User-accessible SDK for Python === | ||
+ | ====== A2B Bus Analyzer 3.0.0 Release Notes ====== | ||
+ | ==== New and Noteworthy ==== | ||
+ | === User-accessible SDK === | ||
+ | To assist with testing and scripting this release includes a user-accessible SDK (UASDK). In order to provide a consistent experience in all operating systems, customers are required to export the SDK to a user-specified location. | ||
+ | |||
+ | To do this in the Help menu select Export User-Accessible SDK which will generate the SDK structure in the chosen folder. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | The selected folder will contain a uasdk folder with all the required files to use the SDK, including a PDF user guide, the HTML documentation, | ||
+ | |||
+ | {{: | ||
+ | |||
+ | All SDK variants are 64-bit only. The supported bindings are C/C++ and python 3.6. | ||
+ | |||
+ | ====== A2B Bus Analyzer 2.3.0 Release Notes ====== | ||
+ | ==== New and Noteworthy ==== | ||
+ | === Emulator: Bulk register access support === | ||
+ | This release contains the initial support for generating sequences of register read and writes which can be from the current or other nodes. The support also offers delaying some of the accesses ensuring that previous accesses take place. | ||
+ | |||
+ | These sequences can be stored and loaded in/from files to help with large or well known sequences. | ||
+ | {{: | ||
+ | === Emulator: Multiple Test Tone support === | ||
+ | This release includes the ability of generating multiple test tones in the same application where each tone goes to a different stream | ||
+ | |||
+ | === Emulator: Multiple channel audio recording === | ||
+ | This release adds the ability of selecting up to two channels when recording audio to a file. Only one channel can be streamed from a .wav. | ||
+ | |||
+ | {{: | ||
- | ===== A2B Bus Analyzer | + | ====== A2B Bus Analyzer |
==== Introduction ==== | ==== Introduction ==== | ||
Line 19: | Line 180: | ||
|{{: | |{{: | ||
|{{: | |{{: | ||
+ | |||
+ | === USB === | ||
+ | |||
+ | A< | ||
==== A2B Bus Analyzer Installation ==== | ==== A2B Bus Analyzer Installation ==== | ||
Line 24: | Line 189: | ||
The A< | The A< | ||
- | {{: | + | {{: |
- | {{: | + | {{: |
- | {{: | + | {{: |
- | | + | |
=== Installation Instructions === | === Installation Instructions === | ||
Line 36: | Line 201: | ||
== Windows == | == Windows == | ||
- | * To install the A< | + | * To install the A< |
* The A< | * The A< | ||
* To uninstall the A< | * To uninstall the A< | ||
Line 44: | Line 209: | ||
* To install A< | * To install A< | ||
* If required, ensure that the downloaded file has execute permissions by running '' | * If required, ensure that the downloaded file has execute permissions by running '' | ||
- | * Launch the A2B Bus Analyzer by running '' | + | * Launch the A< |
* Delete the .AppImage file to uninstall A< | * Delete the .AppImage file to uninstall A< | ||
Line 88: | Line 253: | ||
== macOS == | == macOS == | ||
- | * To install theA< | + | * To install theA< |
* If the Installation Wizard does not launch, right-click the '' | * If the Installation Wizard does not launch, right-click the '' | ||
* The A< | * The A< | ||
Line 94: | Line 259: | ||
==== New and Noteworthy ==== | ==== New and Noteworthy ==== | ||
- | The following section describes new and noteworthy updates | + | === AD242x transceiver support === |
+ | This version includes support for AD242x emulator sub and main which also includes mixed AD242x and AD243x networks. | ||
+ | |||
+ | This version also includes an updated A2B (C) Stack version 19.10.0 with bug fixes and improvements | ||
+ | |||
+ | {{: | ||
==== Bus Monitor ==== | ==== Bus Monitor ==== | ||
- | A< | + | A< |
{{: | {{: | ||
Line 104: | Line 275: | ||
==== Emulator Main and Emulator Sub ==== | ==== Emulator Main and Emulator Sub ==== | ||
- | As well as supporting Bus Monitor, A< | + | As well as supporting Bus Monitor, A< |
- | {{: | + | {{: |
+ | |||
+ | === Emulator Audio Source === | ||
+ | |||
+ | A< | ||
+ | |||
+ | {{: | ||
=== SPI Data Tunnels === | === SPI Data Tunnels === | ||
- | As part of the emulator support the A< | + | As part of the emulator support the A< |
+ | |||
+ | {{: | ||
==== Quick Start Guide ==== | ==== Quick Start Guide ==== |