.. _workflow:



Workflow for Qualcomm Configuration Tool
========================================

This tool is intended to make the job of modifying the numerous
configuration parameters on a chip image a little easier by arranging
the parameters into a tree of related domains.

There are two modes of operation of this tool:

#. Connected to a real attached device and configuring it directly.

#. Configuring a default set of parameters for a device class for
   future further configuration and downloading into a chip.

When the tool starts for the first time, a wizard dialog pops up
requesting a decision about which of these two modes should be used.


.. _workflow_direct:

Direct Connection to a Device
-----------------------------

Follow the chip-specific instructions for building and deploying the
image to the developer board. This will include instructions on
connecting the device to the Windows PC or the Linux desktop machine,
usually over a USB cable.

Start the Configuration tool as desbribed in :ref:`running_qconf`, and
in the "Set Device Wizard" dialog select the first option which is
labelled "Configure from a connected device". The next stage of the
wizard requests a confirmation that the tool can start probing looking
for attached devices that it knows about. Once this probe is complete
the Wizard will ask for confirmation of which device should be the one
that the tools should configure. If no devices are listed, then there
is some connection issue that needs to be resolved first.



.. _workflow_indirect:

No Connection to a Device
-------------------------

In this workflow mode, the tool is used to configure the defaults for
a particular device class to create a set of configuration values that
will be deployed either into a build system or to a device using the
Configuration Tool at some later stage.

Select the second option on the "Set Device Wizard" dialog which is
labelled "Configure from the default for a device". The next pages of
the wizard asks for confirmation of which device family, device type
and product variant that needs to be configured. Once this is
selected, the configuration parameters specific to this device family,
type and variant are displayed in the tool.


.. _workflow_domains:

Configuration Domains
---------------------

The left-hand side tree in the tool shows a hierarchy of items that
are called domains. In each domain there can be a number of
configuration items related to that domain. The domains and items
within them should contain enough documenation in the tool to make it
easy to navigate and configure as needed.

.. _workflow_deploy:

Deploying Configurations
------------------------

When running in **Connected** mode, the configuration data shown in
the tools User Interface can be downloaded directly onto the device by
clicking on the download toolbar icon. The tool should write the
configuration data to the device in the format that is required for
the type of device that is connected.


In **Disconnected** mode configurations need to be exported into a
format that can be inserted into a build system, or imported into the
Configuration tool as some later stage. Note that the tool saves
changes to configuration items in a local prioprietry format, so that
quiting and restarting the tool maintains the current data. If the
configuration needs to be sent elsewhere, however, it needs to be exported.

In the **File** menu of the application there are options to import
and export the data to other file formats. A common one is XML, and
both import and export are currently supported.

.. _tool_upgrade:

Upgrading Qualcomm Configuration Tool
-------------------------------------

The tool can be upgraded without uninstalling the previous version to
access new features or device configuration.  Upgrading the tool **does
not** delete previous configuration sessions which means that in order
to use new device configuration settings available in the new tool version
you **must** delete the existing database for that device, if it exists,
and choose the device again.
