Capload is a ruby-based command line tool for macOS, Windows and Linux that lets you load Castles CAP files onto one or multiple Castles devices via USB.

Installation

Download the attached file and unzip it into a folder. On macOS, open a Terminal window in the folder where capload-0.1.0.gem is located. To install, type:

gem install capload

If you receive an error because you don’t have write permissions, try:

sudo gem install capload

And enter your password to install.

Usage

There are several ways to use the command-line interface:

• Load one or more named CAP files. Castles USB devices are scanned at run-time. If more than one is discovered, you will be presented with a choice to select one or more devices.

  $ capload ~/file.cap
  

• If you don’t want to be prompted, pass -a/--all to simultaneously send the same CAP file to all connected Castles devices.

  $ capload -a ~/file.cap
  

• Load multiple named CAP files.

  $ capload path/to/file1.cap path/to/file2.cap
  

• Instead of loading a CAP file, you can use the CLI to listen for data from any number of devices, and forward the data to stdout. This is useful when developing applications, because Castles devices send the output of running programs over the USB line.

  $ capload --tail

Command Line Options

Usage: capload [options] file1 .. fileN
-a, –all Target all detected Castles devices
-l, –list Lists all detected Castles devices, then exits
-L, –list-all Lists all connected USB devices, then exits
-q, –quiet Suppress normal output
-T, –tail Maintain connection afterward, and dump any data received to STDOUT
-t MILLISECONDS, Specify the time (in ms) to wait for the terminal to verify downloaded files
–verify-timeout
-u, –[no-]unattended Force to run in interactive/non-interactive mode
-V, –verbose Print verbose stack traces on errors
-v, –version Print the version of this software and exit