Interface Control Documents
Overview
QCT Interface Control Documents (ICDs) describe the DIAG protocol and packet structures for log items as well as command request\response pairs. There are multiple documents for all supported QCT technologies. These documents allow tool vendors and special projects to decode and use log files collected by QXDM Pro.
ICDs describe the interface between Qualcomm MSM chipsets and diagnostic tools such as QXDM Pro for the 3GPP and 3GPP2 based air-interface standards.- Includes software protocol layers 1 through 3 (Layer 3 is the binary message only. Not ASCII)
- Describes the exact format of log packets and events with detailed field descriptions which is essential for 3rd party companies to develop diagnostic tools
Supported Technologies
| Interface Control Document |
| GSM/GPRS/EDGE |
| CDMA 1x and 1xEV |
| WCDMA/HSPA+ |
| LTE |
Also Available:
Layer 3 ICD (layer 3 messages only, includes all technologies listed above)
ISF Format ICD Availability
QXDM Pro ISF Format
QXDM Pro's ISF (Item Store Format) is an internal Qualcomm format and is not available. Using the ICD, you can create logs in DLF format (Diagnostic Log Format). The DLF format is exactly the binary format described in the ICDs. QXDM Pro includes a DLF-to-ISF converter that will allow you to convert your DLF file to ISF format if you wish to open your file in QXDM Pro for further analysis.
QXDM Pro includes a DLF-to-ISF converter that will allow you to open the file in QXDM and even replay it. The DLF format is exactly the binary format described in the ICDs. ISF wraps additional data around the DLF and that format is not supported externally. If you stick to the file format specified in the ICD, then you can build DLF files that can be converted to replayable\loadable ISF files (although they will not contain any PC timestamps per item, which is one of the major differences between ISF and DLF)
QXDM Pro ISF Access SDK
Post-processing tool manufacturers and vendors that purchase an ICD are also offered a QXDM Pro ISF Access SDK at no extra charge. This SDK allows you to enhance your tools to process ISF logs directly (without conversion to DLF) and without the requirement to install QXDM on the same host PC that is running the post-processing application.
The QXDM Pro ISF Access SDK allows the ISF to be read, which includes the per-item time stamps, no matter what the source of the data item is. A problem with the legacy DLF log file format from CAIT was a synthetic clock had to be maintained for all non-target generated data items (GPS, for example). This was necessary to allow for mapping of target-generated data items to be shown over space and synchronized in time as well. With ISF logs, all items are time stamped from a common source: the PC's clock. This is done on top of the target-provided clock which is part of the item payload.
The QXDM Pro Item Store Access SDK is not Microsoft COM enabled. The only document for this DLL is installed when the SDK is installed. Do not confuse the ISF Access SDK API with the ISF Processing Interface installed with QXDM. Automation samples for the ISF Processing Interface are located in the QXDM Automation Samples folder (Start Menu -> QXDM -> QXDM Data will bring up the containing folder in Windows Explorer).
For either mechanism, the simplest approach for someone familiar with the legacy DLF file format is to:
-
Open the ISF via LoadItemStore.
-
Obtain the number of items (N) in the ISF via GetItemCount.
-
Iterate over items 0 to N-1. For the ISF Processing Interface one calls GetItem, for the SDK this is not required.
-
Call GetItemDLFBuffer. This will return the binary data for the specified item in the familiar DLF format.
For additional information, please send your questions to qct-tools-info@qualcomm.com. To request a quotation, please send email to qct-tools-quotes@qualcomm.com.
Subscribe to RSS