
.. _installing:


Installing Qualcomm Configuration Tool
======================================

The installation of this tool is dependent on which chip family the
tools has been packaged with, and the platform on which the tool runs.

QCS40x Family
-------------

This family of chips are audio products for Smart Speakers and
Soundbars. This Configuration Tool for this family of chips is
installable via a ``.exe`` installer on Windows, and a ``.deb`` file
for installation on Ubuntu desktops.


.. _installing_win:

Windows
~~~~~~~

The installer should be downloaded from the CreatePoint Tools section
of the QCS40x chip Product Kit. The file that is download is called
``QualcommDeviceConfigTool-<version>.exe``, and this should be
run to install the Configuration Tool. Windows 7, 8.1 and 10
are supported.


.. _installing_lnx:

Ubuntu 16.04
~~~~~~~~~~~~

The only Linux desktop variant that is supported is Ubuntu 16.04. The
installation might work on later releases, but this is not
guaranteed. The installer for this tool can be found in the Tools
section of the QCS40x chip Product Kit. The file
``pyconfigtool-<version>_all.deb`` should be downloaded. The browser
might automatically send this file to the Ubuntu Software Center
Application to install the Debian package file. Click on the "Install"
button if this is the case. **Note that the post-install scripts
might take a few minutes, and the Software Centre does not show
meaningful progress during this time.**

If the package is not automatically sent to the Software Center by the
browser, but is just downloaded somewhere, it can be invoked using the
following commands at a shell prompt::

  sudo dpkg -i /path/to/deb-file
  sudo apt-get install -f

which will install the Debian package file, and then ensure all the
dependencies are met, including running the post-install scripts that
are part of the package.
