2.3. 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.
2.3.1. 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 Running Qualcomm Configuration Tool, 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.
2.3.2. 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.
2.3.3. 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.
2.3.4. 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.
2.3.5. 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.