CrossLoad is a command line program that allows you to download and verify applications without using CrossStudio. This tool can be used for production purposes but is not designed to be used for development.

Usage
    crossload [options] [files...]
Options
-target 'target' | Specify the target interface to use. Use the -listtargets option to display the list of supported target interfaces.
-listtargets | List all of the supported target interfaces.
-solution 'file' | Specify the CrossWorks solution file to use.
-project 'name' | Specify the name of the project to use.
-config 'configuration' | Specify the build configuration to use.
-filetype 'filetype' | Specify the type of the file to download. By default CrossLoad will attempt to detect the file type, you should use this option if CrossLoad cannot determine the file type or to override the detection and force the type. Use the -listfiletypes option to display the list of supported file types.
-listfiletypes | List all of the supported file types.
-setprop 'property'='value' | Set the target property 'property' to 'value'.
-listprops | List the target properties of the target specified by the -target option.
-noverify | Do not carry out verification of download.
-nodownload | Do not carry out download, just verify.
-nodisconnect | Do not disconnect the target interface when finished.
-help | Display the command line options.
-verbose | Produce verbose output.
-quiet | Do not output any progress messages.

In order to carry out a download or verify CrossLoad needs to know what target interface to use. The supported target interfaces vary between systems, to produce a list of the currently supported target interfaces use the -listtargets option.

      crossload -listtargets

This command will produce a list of target interface names and descriptions:

        usb                   USB CrossConnect
        parport               Parallel Port Interface
        sim                   Simulator

Use the -target option followed by the target interface name to specify which target interface to use:

      crossload -target usb ...

CrossLoad is normally used to download and/or verify projects created and built with CrossStudio. To do this you need to specify the target interface you want to use, the CrossStudio solution file, the project name and the build configuration. The following command line will download and verify the debug version of the project MyProject contained within the MySolution.hzp solution file using a USB CrossConnect:

      crossload -target usb -solution MySolution.hzp -project MyProject -config Debug

In some cases it is useful to download a program that might not have been created using CrossStudio using the settings from an existing CrossStudio project. You might want to do this if your existing project describes specific loaders or scripts that are required in order to download the application. To do this you simply need to add the name of the file you want to download to the command line. For example the following command line will download the HEX file ExternalApp.hex using the release settings of the project MyProject using a USB CrossConnect:

      crossload -target usb -solution MySolution.hzp -project MyProject -config Release ExternalApp.hex

CrossLoad is able to download and verify a range of file types. The supported file types vary between systems, to display a list of the file types supported by CrossLoad use the -listfiletypes option:

      crossload -listfiletypes

This command will produce a list of the supported file types, for example:

      hzx                   CrossStudio Executable File
      bin                   Binary File
      ihex                  Intel Hex File
      hex                   Hex File
      tihex                 TI Hex File
      srec                  Motorola S-Record File

CrossLoad will attempt to determine the type of any load file given to it, if it cannot do this you may specify the file type using the -filetype option:

      crossload -target usb -solution MySolution.hzp -project MyProject -config Release ExternalApp.txt -filetype tihex

It is possible with some targets to carry out a download without the need to specify a CrossStudio project. In this case all you need to specify is the target interface and the load file. For example the following command line will download MyApp.s19 using a USB CrossConnect:

      crossload -target usb MyApp.s19

Each target interface has a range of configurable properties that allow you to customize the default behaviour. To produce a list of the target properties and their current value use the -listprops option:

      crossload -target parport -listprops

This command will produce a list of the parport target interfaces properties, a description of what the properties are and their current value:

      Name:        JTAG Clock Divider
      Description: The amount to divide the JTAG clock frequency.
      Value      : 1

      Name:        Parallel Port
      Description: The parallel port connection to use to connect to target.
      Value      : Lpt1

      Name:        Parallel Port Sharing
      Description: Specifies whether sharing of the parallel port with other device drivers or programs is permitted.
      Value      : No

You can modify a target property using the -setprop option. For example the following command line would set the parallel port interfaced used to lpt2:

      crossload -target parport -setprop "Parallel Port"="Ltp2" ...