CMSIS-Pack  Version 1.3
Delivery Mechanism for Software Packs
 All Pages
PackChk.exe

PackChk.exe is a utility for validation of a Software Pack. It operates on the unzipped content of the Software Pack and is located in the directory .\CMSIS\Utilities of the ARM::CMSIS Pack.

PackChk.exe performs the following operations:

  1. Reads the content of the specified *.PDSC file. The path to this *.PDSC file is considered as root directory of the Software Pack.
  2. Verifies the existence of all files in the Software Pack that are referenced in the *.PDSC file.
  3. Checks for presence and correctness of mandatory elements such as <vendor>, <version>, etc.
  4. Optional, all System View Description files (*.SVD) that are referenced in the *.PDSC file are checked using SVDConv.exe. Refer to SVD File Validation for details.
  5. Optional, the element <url> is checked.
  6. Optional, creates the standardized name of the Software Pack file.
  7. Sets the exit status reflect the result of the validation to:
    • 0 : no errors detected
    • 1 : errors during validation detected

Operation

PackChk.exe is invoked from the command line. The general command is:

PackChk.exe <pdsc_file> <options>


<options> Short Name Description
-n <file> Pack file name Write a standardized name for the Software Pack to the specified ASCII file.
-s Verify SVD files Each SVD file referenced in the *.PDSC file is validated with the SVDConv.exe. With this option set, SVDConv.exe is invoked from the same directory as PackChk.exe.
-u <url> Pack Server URL Verifies that the specified URL matches the <url> element in the *.PDSC file.
-v Verbose Prints extra process information.

Examples

Run PackChk.exe in verbose mode on the package description file called MyVendor.MyPack.pdsc. PackChk.exe reads this file and verifies it against the Software Pack that is located in the same directory.

PackChk.exe .\MyVendor.MyPack.pdsc -v

Run PackChk.exe on the package description file called MyVendor.MVCM3.pdsc, verify SVD files, verify the URL to the Pack Server, and generate a ASCII text file with the standardized name of the Software Pack.

PackChk.exe ".\MyVendor.MVCM3.pdsc" -s -u "http://www.myvendor.com/pack" -n packname.txt

Error and Warning Messages

The following table shows the errors and warnings issued by PackChk.

Internal Errors

For internal errors, please sent a problem report via email to cmsis.nosp@m.@arm.nosp@m..com.

Message Number Type Description Action
M100 ERROR GetModuleHandle failed Call support.
M101 ERROR Unknown error! Call support.
M102 ERROR MFC initialization failed Call support.
M103 ERROR Cannot launch SVDConv.exe Check your input and search paths. Copy SVDConv.exe into the directory of PackChk.exe. Default is CMSIS\Utilities
M104 ERROR Error calling SVDConv.exe Check that SVDConv.exe exists in the same path as PackChk.exe.
M105 ERROR Unknown SVD Check error Call support and provide the files you are using together with the SVDConv.exe and PackChk.exe.
M106 ERROR SVDConv received invalid parameter No arguments for SVDCONV.exe are allowed when used together with PackChk.exe.
M107 ERROR Lost xml file stream at line 'LINENUMBER' Repeat the process.

Invocation Errors

Message Number Type Description Action
M200 ERROR Invalid arguments! At least one argument is wrong. Correct the argument.
M201 ERROR Too many arguments! The list of arguments is too long. Check if you have used one argument twice.
M202 ERROR No PDSC input file specified Correct the command line. PackChk.exe expects a *.PDSC file name as input.
M203 ERROR Error reading PDSC file 'PATH/FILENAME'! Verify the PDSC file for consistency.
M204 ERROR File not found: 'PATH' The specified PDSC file could not be found in the PATH displayed in the message. Correct the path or the filename.
M205 ERROR Cannot create Pack Name file 'PATH' Check the disk space or your permissions. Correct the path name.
M206 ERROR Multiple PDSC files found in package: 'FILES' Only one PDSC file is allowed in a package. Remove unnecessary PDSC files. The message lists all *.PDSC files found.
M207 ERROR PDSC file name mismatch!
Expected: 'PDSC1.pdsc'
Actual : 'PDSC2.pdsc'
The PDSC file expected has not been found. Rename or exchange the PDSC file.
M208 ERROR Cannot find SVDConv.exe: 'PATH' SVDConv.exe was not found. Copy the executable into the directory of PackChk.exe or enter the path where SVDConv.exe is located. Default is CMSIS\Utilities.

Validation Errors

Message Number Type Description Action
M300 ERROR The following files are listed in PDSC but not part of the package:
'PATH':
'FILES'
The files listed should be part of the package. However, these files could not be added to the package. Check whether the files exist or check the file permissions.
M301 ERROR Checking Pack URL of PDSC file failed:
Expected URL : 'URL1'
Package URL : 'URL2'
The URL entered in the package does not match the value entered for comparison. Change the URL in the package. Check possible misspellings of URL1.
M302 ERROR No vendor tag found in the PDSC file! Add the <vendor> tag and provide the vendor name. For example: <vendor>Keil</vendor>. No vendor entered in the PDSC file. Enter the tag <vendor> and add the vendor name. Refer to /package.
M303 ERROR No package name found in the PDSC file! Add the <name> tag and provide the package name. No package name found in the PDSC file. Enter the tag <name> and add the package name. For example <name><MCU-Name>_DFP.</name>. The package name is mandatory to create the package. Refer to /package.
M304 ERROR No package URL (<url>-tag and/or value) found in PDSC file! Add the tag <url> and enter a URL in the PDSC file. The URL points to the web page from which users can download the package. Refer to /package.
M305 ERROR No package version ("version"-attribute in a <release>-tag) found in PDSC file! No version or release information found in the PDSC file. Add the attribute version to the tag <release> and enter the version number. Refer to /package/releases/release.
M306 ERROR No package description found in the PDSC file. Add the <description>-tag and provide a descriptive text. No package description was found in the PDSC file. Enter the tag <description> and briefly describe the package content. Refer to /package.
M307 ERROR Checking SVD file 'PATH' failed! Check the consistency of the *.SVD file. Refer to SVD File Validation.
M308 ERROR SVD file 'PATH' not found. Add the SVD file or correct the PDSC entry. The *.SVD file was not found in the path specified in the message. Add the SVD file or correct the entry in the *.PDSC file.
M309 ERROR Cannot read file information: 'PATH'. Access to the file specified failed. Check permissions and spelling.
M310 ERROR Filename mismatch (case sensitive):
PDSC name : 'PDSC_FILENAME'
Filename : 'SYSTEM'
Filenames are case sensitive. Correct spelling.
M311 WARNING Preamble for 'UTF' should not be used, specify via '<?xml' Specify the character set in the tag mentioned.
M312 WARNING Unsupported format or extra characters found before '<?xml': 'STR' Correct the XML file.
M313 WARNING UTF Format not supported: 'UTF' Select another UTF-format.
M314 ERROR Cannot decode XML special character: 'SPECIALCHAR'. Found END Tag! Correct the XML file.
M315 ERROR Cannot decode XML special character: 'SPECIALCHAR'. String too long! Correct the XML file.
M316 ERROR '<--' found, should this be a comment '<!--' ? Correct the XML file.
M317 ERROR Begin Tag seems to end with a Single Tag. Is this a typo? Correct the XML file.
M318 ERROR Inconsistent XML Structure Correct the XML file.
M319 ERROR XML Stack deeper than 30 Items! Giving up... Reduce the nested nodes.
M320 ERROR Begin Tag follows Text. Missing End Tag? Correct the XML file.
M321 ERROR Missing '"' in Attributes: 'ATTRLINE' Correct the XML file. Enclose values in " ".