[Tool] BB10MT Usage Documentation

[feihaibao]

BlackBerry 10 MultiTool Documentation

Overview
BB10MT is a cross-platform command-line tool for BlackBerry 10 device manipulation, QNX6 filesystem operations, and autoloader management. Works on both Linux and Windows as an alternative to cap.exe.

Dependencies
BB10MT Depends on the following: libusb, liblzo and fuse on Linux and liblzo, libusb on Windows.

QNX6 Filesystem Operations

Mount QNX6 Image

Code Select Expand

./bb10mt qnx6 mount -i <image_file> -m <mountpoint> [-f] [-d]Options:

• -i: QNX6FS image file (required)
  
• -m: Mount point (required)
  
• -f: Run in foreground
  
• -d: Enable FUSE debug output (slow)
  

Compact QNX6 Image

Code Select Expand

./bb10mt qnx6 compact -i <image_file>Reduces image size by removing unused space.

Create QNX6 Filesystem

Code Select Expand

./bb10mt qnx6 mkfs -i <image_file> [-b blocks] [-n inodes] [-s block_size]Options:

• -b: Blocks count (default: 10240)
  
• -n: Inodes count (default: 1024)
  
• -s: Block size in bytes, multiple of 512 (default: 4096)
  

Check/Repair QNX6 Filesystem

Code Select Expand

./bb10mt qnx6 fsck -i <image_file> [-f]Options:

• -f: Fix errors automatically
  

QCFM Container Operations

Unpack Container

Code Select Expand

./bb10mt unpack --container <container_file>Extracts all files from a QCFM container.

Pack Container

Code Select Expand

./bb10mt pack -c <output_container> -i <input_file> [-v versions] [-s] [-f]Options:

• -c: Output container file (required)
  
• -i: Input file or comma-separated files (required)
  
• -l: Input files list (text file)
  
• -v: QCFM versions, comma-separated (default: 2)
  
• -s: Add fake signature
  
• -f: Include empty blocks (fast mode)
  

Autoloader Operations

Split Autoloader

Code Select Expand

./bb10mt split -i <autoloader_file>Splits autoloader into individual components.

Create Autoloader

Code Select Expand

./bb10mt autoloader create -o <output_file> -c <cap_file> -i <input_files> [-l files_list] [-v version]Options:

• -o: Autoloader file (default: autoloader.exe)
  
• -c: Own cap.exe file (default: cap.exe)
  
• -i: Input files, comma-separated (required unless -l specified)
  
• -l: Input files list
  
• -v: Cap tail version (default: 2)
  

Extract CAP from Autoloader

Code Select Expand

./bb10mt autoloader extract -i <autoloader_file> [-c cap_output]Options:

• -i: Autoloader file (required)
  
• -c: Own cap.exe file (default: cap.exe)
  

Extract RAM Loaders

Code Select Expand

./bb10mt autoloader loaders -i <cap_cfp_file> [-o output_dir]Extracts RAM loaders from CAP, CFP, or autoloader files.
Options:

• -i: cap.exe/cfp.exe file (required)
  
• -o: Output directory (default: ramloaders)
  

Device Operations

Flash Files to Device

Code Select Expand

./bb10mt flash -i <file1,file2,...> [-v versions] [-r loader_dir] [-d delay]Options:

• -i: Input file or comma-separated files (required)
  
• -l: Input files list (text file)
  
• -v: QCFM versions, comma-separated (default: 1,2)
  
• -r: RAM loaders directory (default: loaders)
  
• -d: RAM loader delay in ms (default: 1000)
  

Show Device Info

Code Select Expand

./bb10mt info [-d delay]Displays connected device information.
Options:

• -d: RAM loader delay in ms (default: 1000)
  

Probe All Loaders

Code Select Expand

./bb10mt loader [-d delay]Options:

• -d: RAM-loader delay (default: 1000)
  

Connect to Device via SSH

Code Select Expand

./bb10mt connect -i <ip_address> -p <password> -k <public_key_path>Options:

• -i: Device IP address (required)
  
• -p: Device password (required)
  
• -k: Path to RSA public key to install (required)
  

BAR File Operations

Create BAR Template

Code Select Expand

./bb10mt bar template -p <base_dir> -n <bar_name>Options:

• -p: Path to base directory (required)
  
• -n: BAR name (required)
  

Update BAR Hashes

Code Select Expand

./bb10mt bar update -p <bar_path>Updates hashes in MANIFEST.MF after modifications.
Options:

• -p: Path to unpacked BAR (required)
  

Generate New IDs

Code Select Expand

./bb10mt bar ids -p <bar_path>Generates new IDs in MANIFEST.MF.
Options:

• -p: Path to unpacked BAR (required)
  

Install Unpacked BAR

Code Select Expand

./bb10mt bar install -p <bar_path> -m <mount_point>Options:

• -p: Path to unpacked BAR (required)
  
• -m: Path to mount point (required)
  

Raw Data Operations

Dump Raw Flash Image

Code Select Expand

./bb10mt raw dump -i <input_file> [-o output_dir] [-m mct_offset]Splits raw flash image into individual partitions.
Options:

• -i: Input file (required)
  
• -o: Output directory
  
• -m: MCT offset
  

Split NVRAM

Code Select Expand

./bb10mt raw nvram -i <input_file> [-o output_dir]Splits NVRAM into individual blocks.
Options:

• -i: Input file (required)
  
• -o: Output directory
  

RCFS Operations

Code Select Expand

./bb10mt rcfs -i <image_file> [-s script_file] [--vmdk]Options:

• -i: RCFS image file (required)
  
• -s: Script file for operations
  
• --vmdk: Process as VMWare disk image
  

Usage Examples

TBD...

Downloads

• BlackBerry 10 MultiTool (v0.5.0.5) - 03.09.2025 - Download
  
• BlackBerry 10 MultiTool (v0.2.1.3) - 24.07.2025 - Download
  
• BlackBerry 10 MultiTool (v0.1.0.10) - Download