Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

ConnectTool Help

ConnectTool, or CT, is a command line version of the Connect library. Ct.exe is a tool that allows users to interact with the device and copy files, start applications, etc.

CT is a collection of device commands with a common syntax for connecting to a device and getting help.

Note: CT.exe does not work with Brew 3.x/4.x devices.

The following is the format of CT commands:

ct

Command options are specific to the command, for example, and command option for the install command might specify whether to install an application to the device EFS or a removable memory card.

If more than one target is connected, some combination of the -p and -g flags are required. Valid values for these arguments can be found by running the command ct listtargets. The -p option does a substring search so often only entering the last 3 digits or so of a hardware ID is sufficient.

Syntax for ct commands is the following:

ct [-p <target_desc>] [-g ][-v][-h]

The gateway or -g option specifies the type of connection, USB or Simulator. The -p option specifies which device on that connection to use.

CT requires that the user specify which device commands should be executed on. This is because multiple devices can be connected to the same computer at the same time. If there is only a single target (Simulator or device) connected, no identification is required. A command can execute without either -g or -p to connect. For example the following command would execute properly:

ct enablestatus

If there is one physical device running and one Simulator target running, you only need to specify the -g option.

For Simulator, use the following command:

ct -g sim enablestatus

For device, use the following command:

ct -g dev enablestatus

If there's more than one device (or Simulator), use -p. For example, to refer to a device that has a serial number that contains 789, use the following command:

ct -p 789 enablestatus

if you have two connected devices, one with the electronic serial numbers (ESN) 0x54321012, and another with 0x56789012, the -p option would specify the second device since it contains the search string 789.

CT commands

Command Description
cp Copies files to/from a target
desenable [de] Enable a device using username/password
enablestatus [en] Check the test enablement status of a target
install Installs a .brewmp file
listtargets [lt] Shows connected Brew MP targets
ls Lists the contents of a directory on the target
mkdir Create a directory on a remote directory
reset Reset the target
rm Remove a file or directory on a target
run Runs a program
shell Executes a local shell command on a target file
sigenable [se] Enable a target using a test sig
start Starts an applet
stop Stops an applet

Displaying help for specific commands

To display options for a command, invoke the -h option for the command. For example, to display options for the cp command, type the following:

ct.exe cp -h

The output provides the syntax and parameter descriptions, as shown below:

cp: Copies files to/from a device

Description:
   Copies a file to or from a target or within a target.

Syntax:
   ct ... cp [-h] [-v] [-r] [-f] [x]  

Parameters:
   -h, --help          Show help for the program or a specific command
   -v, --verbose       Display extra information for commands
   -r, --recursive     Recursively copy the source directory
   -f, --force         Overwrite file if existing
   -x, --no-progress   Don't show progress updates