imx-sdp

imx-sdp is a command-line utility that allows to boot NXP i.MX processors over Serial Download Protocol (SDP) via the USB interface.

This is a re-implementation of imx_usb_loader with the following design goals:

• Only implement the bare minimum to boot multiple stages over SDP (USB)
• Don't require configuration files

Invocation

Usage: build/imx-sdp [OPTION...] [STAGE...]

The following OPTIONs are available:

  -C, --directory  change working directory, after spec is read
  -h, --help  print this usage message
  -p, --path  specify the USB device path, e.g. 3-1.1
  -s, --spec  stage/step spec file
  -V, --version  print version
  -w, --wait  wait for the first stage

The STAGEs have the following format:

  <VID>:<PID>[,<STEP>...]
    VID  USB Vendor ID as 4-digit hex number
    PID  USB Product ID as 4-digit hex number

The STEPs can be one of the following operations:

  write_file:<FILE>:<ADDRESS>
    Write the contents of FILE to ADDRESS
  jump_address:<ADDRESS>
    Jump to the IMX image located at ADDRESS

Instead of specifying the stages and steps on the command line, they can be
specified in a YAML file instead (--spec option). Note, that providing the spec
on the command line and in a file are mutually exclusive.

Spec format

usb_path: 3-1.1
stages:
  - vid: 0x15a2
    pid: 0x0080
    steps:
      - op: write_file
        file: SPL
        address: 0x00907400
      - op: jump_address
        address: 0x00907400
  - vid: 0x1b67
    pid: 0x5ffe
    steps:
      - op: write_file
        file: u-boot.img
        address: 0x877fffc0
      - op: jump_address
        address: 0x877fffc0

Example invocation

imx-sdp --wait \
    15a2:0080,write_file:SPL:00907400,jump_address:00907400 \
    1b67:5ffe,write_file:u-boot.img:877fffc0,jump_address:877fffc0