J-Link Commander

J-Link Commander (JLink.exe / JLinkExe) is a free, command line based utility that can be used for verifying proper functionality of J-Link as well as for simple analysis of the target system with J-Link. It supports some simple commands, such as memory dump, halt, step, go etc. to verify the target connection. The J-Link Commander is part of the J-Link Software and Documentation Pack, which is available for download on the SEGGER webpage.

The sources of the J-Link Commander are available as part of the J-Link SDK.

Contents

• 1 Commands
  • 1.1 ?
    • 1.1.1 Syntax
    • 1.1.2 Example
    • 1.2.1 Syntax
    • 1.3.1 Short command
    • 1.3.2 Syntax
    • 1.4.1 Syntax
    • 1.4.2 Example
    • 1.5.1 Syntax
    • 1.5.2 Example
    • 1.6.1 Syntax
    • 1.6.2 Example
    • 1.7.1 Syntax
    • 1.7.2 Example
    • 1.8.1 Syntax
    • 1.8.2 Example
    • 1.9.1 Syntax
    • 1.9.2 Example
    • 1.10.1 Short command
    • 1.10.2 Syntax
    • 1.10.3 Example
    • 1.11.1 Syntax
    • 1.11.2 Example
    • 1.12.1 Syntax
    • 1.12.2 Example
    • 1.13.1 Syntax
    • 1.13.2 Example
    • 1.14.1 Syntax
    • 1.15.1 Syntax
    • 1.15.2 Example
    • 1.16.1 Syntax
    • 1.16.2 Example
    • 1.17.1 Syntax
    • 1.17.2 Example
    • 1.18.1 Short command
    • 1.19.1 Short command
    • 1.20.1 Syntax
    • 1.21.1 Syntax
    • 1.22.1 Syntax
    • 1.23.1 Syntax
    • 1.24.1 Short command
    • 1.25.1 Short command
    • 1.26.1 Short command
    • 1.27.1 Syntax
    • 1.27.2 Example
    • 1.28.1 Short command
    • 1.28.2 Syntax
    • 1.28.3 Example
    • 1.29.1 Syntax
    • 1.29.2 Example
    • 1.32.1 Short command
    • 1.33.1 Short command
    • 1.34.1 Short command
    • 1.34.2 Syntax
    • 1.34.3 Example
    • 1.35.1 Short command
    • 1.36.1 Short command
    • 1.37.1 Short command
    • 1.37.2 Syntax
    • 1.37.3 Example
    • 1.38.1 Short command
    • 1.38.2 Syntax
    • 1.38.3 Example
    • 1.39.1 Short command
    • 1.39.2 Syntax
    • 1.39.3 Example
    • 1.41.1 Syntax
    • 1.43.1 Syntax
    • 1.43.2 Example
    • 1.44.1 Short command
    • 1.44.2 Syntax
    • 1.44.3 Example
    • 1.46.1 Syntax
    • 1.47.1 Short command
    • 1.47.2 Syntax
    • 1.48.1 Syntax
    • 1.48.2 Example
    • 1.49.1 Short command
    • 1.49.2 Syntax
    • 1.50.1 Short command
    • 1.50.2 Syntax
    • 1.51.1 Syntax
    • 1.52.1 Syntax
    • 1.52.2 Example
    • 1.53.1 Syntax
    • 1.53.2 Example
    • 1.54.1 Syntax
    • 1.55.1 Syntax
    • 1.55.2 Example
    • 1.56.1 Short command
    • 1.56.2 Syntax
    • 1.57.1 Short command
    • 1.57.2 Syntax
    • 1.59.1 Syntax
    • 1.59.2 Example
    • 1.60.1 Syntax
    • 1.60.2 Example
    • 1.61.1 Syntax
    • 1.61.2 Example
    • 1.62.1 Syntax
    • 1.62.2 Example
    • 1.63.1 Short command
    • 1.63.2 Syntax
    • 1.63.3 Example
    • 1.64.1 Short command
    • 1.64.2 Syntax
    • 1.64.3 Example
    • 1.65.1 Short command
    • 1.65.2 Syntax
    • 1.65.3 Example
    • 1.66.1 Short command
    • 1.66.2 Syntax
    • 1.66.3 Example
    • 1.67.1 Syntax
    • 1.67.2 Example
    • 1.68.1 Short command
    • 1.69.1 Short command
    • 1.69.2 Syntax
    • 1.70.1 Short command
    • 1.70.2 Syntax
    • 1.71.1 Short command
    • 1.71.2 Syntax
    • 1.71.3 Example
    • 1.72.1 Short command
    • 1.73.1 Short command
    • 1.75.1 Short command
    • 1.75.2 Syntax
    • 1.76.1 Short command
    • 1.76.2 Syntax
    • 1.88.1 Syntax
    • 1.88.2 Examples
    • 1.89.1 Syntax
    • 1.89.2 Examples
    • 1.90.1 Syntax
    • 1.90.2 Example
    • 1.91.1 Syntax
    • 1.91.2 Example
    • 1.92.1 Short command
    • 1.92.2 Syntax
    • 1.92.3 Example
    • 1.93.1 Short command
    • 1.93.2 Syntax
    • 1.93.3 Example
    • 1.94.1 Syntax
    • 1.94.2 Example
    • 1.95.1 Short command
    • 1.95.2 Syntax
    • 1.95.3 Example
    • 1.96.1 Short command
    • 1.96.2 Syntax
    • 1.98.1 Syntax
    • 1.99.1 Syntax
    • 1.100.1 Short command
    • 1.100.2 Syntax
    • 1.101.1 Short command
    • 1.101.2 Syntax
    • 1.102.1 Short command
    • 1.102.2 Syntax
    • 1.103.1 Short command
    • 1.103.2 Syntax
    • 1.104.1 Short command
    • 1.104.2 Syntax
    • 1.105.1 Syntax
    • 1.105.2 Example
    • 1.106.1 Short command
    • 1.106.2 Syntax
    • 1.107.1 Short command
    • 1.107.2 Syntax
    • 1.108.1 Short command
    • 1.109.1 Short command
    • 1.110.1 Short command
    • 1.111.1 Short command
    • 1.112.1 Short command
    • 1.113.1 Short command
    • 1.114.1 Short command
    • 1.115.1 Short command
    • 1.116.1 Short command
    • 1.117.1 Short command
    • 2.1 Reading from another MEM-AP
      • 2.1.1 Assumptions
      • 2.1.2 Commands used
      • 2.1.3 Example sequence
      • 12.1 Verifybin command

      Commands

      The table below lists the available commands of J-Link Commander. Detailed descriptions of the commands can be found in the sections below. All commands are accepted case insensitive.

      This list is only valid for the latest version of the J-Link Commander. In case of doubt, use the ? command.

      Command (long)	Command (short)	Explanation
      Basic
      ?	?	Show information about all or specific commands
      Exit	Exit	Close J-Link connection and quit
      ExitOnError	EoE	Exit on error
      Sleep	Sleep	Waits the given time (in milliseconds)
      Log	Log	Enables log to file
      ExpDevList	ExpDevList	Export device names from DLL internal device list to text file
      ExpDevListXML	ExpDevListXML	Export device names from DLL internal device list to XML file
      Configuration - J-Link
      USB	USB	Connect to J-Link via USB
      IP	IP	Connect to J-Link via TCP/IP or to Remote Server
      SelectProbe	SelPrb	Show list of all connected probes via specified interface. The Probe to communicate with can then be selected
      ShowEmuList	ShowEmuList	Show list of all connected probes via specified interface
      Power	Power	Switch power supply for target (5V-Supply pin) on or off
      VTREF	VTREF	Set fixed value for VTref on J-Link
      VCOM	VCOM	Enable/disable VCOM Takes effect after power cycle of the probe
      BootMode	BootMode	Select boot mode of the connected probe.
      Reboot	Reboot	Reboot the connected probe.
      Uptime	Uptime	Show Probe uptime since boot.
      ShowFWInfo	F	Show firmware info
      ShowHWStatus	St	Show hardware status
      License	License	Show list of all available license commands
      IPAddr	IPAddr	Show/Assign IP address and subnetmask of/to connected Probe
      GWAddr	GWAddr	Show/Assign network gateway address of/to connected Probe
      DNSAddr	DNSAddr	Show/Assign network DNS server address of/to connected Probe
      ShowConf	Conf	Show configuration of the connected Probe
      Calibrate	Calib	Calibrate the target current measurement
      Configuration - Target (CPU)
      Connect	Con	Connect to target device
      Device	Device	Select specific device J-Link shall connect to
      SelectInterface	SI	Select target interface
      Speed	Speed	Set target interface speed
      LE	LE	Change mode to little endian
      BE	BE	Change mode to big endian
      Debugging
      Halt	H	Halt CPU
      IsHalted	IH	Return current CPU state
      WaitHalt	WH	Wait until CPU is halted or timeout is reached
      Go	G	Start CPU if halted
      Reset	R	Reset CPU
      ResetX	RX	Reset CPU with delay after reset
      RSetType	Rst	Set the current reset type
      Step	S	Execute step(s) on the CPU
      IS	IS	Identify length of scan chain select register
      MS	MS	Measure length of scan chain
      Regs	Regs	Display CPU register contents
      RReg	RReg	Read register
      WReg	WReg	Write register
      MoE	MoE	Shows mode-of-entry (CPU halt reason)
      SetBP	SetBP	Set breakpoint
      ClearBP	ClrBP	Clear breakpoint
      SetWP	SetWP	Set watchpoint
      ClearWP	ClrWP	Clear watchpoint
      VCatch	VC	Write vector catch
      SetPC	SetPC	Set the PC to specified value
      ReadAP	ReadAP	Read CoreSight AP register
      WriteAP	WriteAP	Write CoreSight AP register
      ReadDP	ReadDP	Read CoreSight DP register
      WriteDP	WriteDP	Write CoreSight DP register
      RCP15Ex	RCE	Read CP15 register
      WCP15Ex	WCE	Write CP15 register
      Term	Term	Visualize printf output using DCC (SEGGER DCC handler running on target)
      Debugging - Memory operation
      Mem	Mem	Read memory and show corresponding ASCII values
      Mem8	Mem8	Read 8-bit items
      Mem16	Mem16	Read 16-bit items
      Mem32	Mem32	Read 32-bit items
      Write1	W1	Write 8-bit items
      Write2	W2	Write 16-bit items
      Write4	W4	Write 32-bit items
      Write8	W8	Write 64-bit items
      Debugging - JTAG related
      JTAGConf	JTAGConf	Set number of IR/DR bits before Target device
      JTAGId	I	Read JTAG Id
      WJTAGIR	WJIR	Write JTAG command (IR)
      WJTAGDR	WJDR	Write JTAG data (DR)
      WJTAGRaw	WJR	Write Raw JTAG data
      ResetTAP	RTAP	Reset TAP Controller using state machine (111110)
      ResetTRST	RT	Reset TAP Controller using nTRST
      Debugging - ICE
      ICE	ICE	Show state of the embedded ICE macrocell (ICE breaker)
      ReadICE	RI	Read Ice register
      WriteICE	WI	Write Ice register
      STRACE
      STraceStart	STStart	Starts STRACE
      STraceStop	STStop	Stops STRACE
      STraceRead	STRead	Reads collected STRACE data
      SWO
      SWOSpeed	SWOSpeed	Show supported SWO speeds
      SWOStart	SWOStart	Start SWO
      SWOStop	SWOStop	Stop SWO
      SWOStat	SWOStat	Display SWO status
      SWORead	SWORead	Read and display SWO data
      SWOShow	SWOShow	Read and analyze SWO data
      SWOFlush	SWOFlush	Flush SWO data
      SWOView	SWOView	View SWO terminal data
      Flash programming
      Erase	Erase	Erase flash (range) of selected device
      LoadFile	LoadFile	Load data file into target memory
      SaveBin	SaveBin	Save target memory range into binary file
      VerifyBin	VerifyBin	Verfy if specified bin file is at the specified target memory location
      Flasher File I/O Commands
      FWrite	FWr	(Flasher only) Write file to probe
      FRead	FRd	(Flasher only) Read file from probe
      FShow	FShow	(Flasher only) Read and display file from probe
      FDelete	FDel	(Flasher only) Delete file on probe
      FSize	FSz	(Flasher only) Display size of file on probe
      FList	FList	(Flasher only) List directory on probe
      SecureArea	SecureArea	(Flasher only) Creates/Removes secure area on probe
      Measurement and test commands
      PowerTrace	PowerTrace	Perform power trace (not supported by all models)
      TestWSpeed	TestW	Measure download speed into target memory
      TestRSpeed	TestR	Measure upload speed from target memory
      TestCSpeed	TestC	Measure CPU speed
      TestNWSpeed	TestNW	Measure network download speed
      TestNRSpeed	TestNR	Measure network upload speed
      MR	MR	Measure RTCK react time
      J-Link Pin control
      Clock	C	Output clock(s) on the TCK pin
      Clock00	C00	Output clock(s) on the TCK pin, with TDI == 0 and TMS == 0
      ClrTCK	TCK0	Clear TCK pin
      SetTCK	TCK1	Set TCK pin
      ClrTDI	TDI0	Clear TDI pin
      SetTDI	TDI1	Set TDI pin
      ClrTMS	TMS0	Clear TMS pin
      SetTMS	TMS1	Set TMS pin
      ClrTRST	TRST0	Clear TRST pin
      SetTRST	TRST1	Set TRST pin
      ClrRESET	R0	Clear RESET pin
      SetRESET	R1	Set RESET pin

      Show information about all commands or one specific command.

      Syntax

      Parameter	Meaning
      	(optional) Command, specific information is required for.

      Example

      Exit

      Close target device connection, J-Link connection and closes the application.

      Syntax

      ExitOnError

      Toggle exit J-Link Commander on error.

      Short command

      Syntax

      Parameter	Meaning
      0	Exit on error is off.
      1	Exit on error is on.

      Sleep

      Waits the given time. Usually used for J-Link Command Scripts.

      Syntax

      Parameter	Meaning
      Delay	Amount of time to sleep in ms.

      Example

      Log

      Enables log to file.

      Syntax

      Parameter	Meaning
      Filename	Log filename

      Example

      ExpDevList

      Export device names from DLL internal device list to text file.

      Syntax

      Parameter	Meaning
      Filename	Path to text file destination.

      Example

      ExpDevListXML

      Export device names from DLL internal device list to XML file.

      Syntax

      Parameter	Meaning
      Filename	Path to XML file destination.

      Example

      USB

      Connect to J-Link via USB. Opens the USB selection dialog if no port, SN or nickname (available from V7.92d) is passed.

      Syntax

      Parameter	Meaning
      SN/Nickname	(optional) Serial number or nickname (available from V7.92d) of the J-Link to connect to.

      Example

      IP

      Connect to J-Link via TCP/IP or to Remote Server. Opens the IP selection dialog if no parameter is passed.

      Syntax

      Parameter	Meaning
      IPAddr	(optional) IP Address of the J-Link to connect to.
      RemoteServerString	(optional) Remote server string of the J-Link remote server session to connect to.

      Example

      SelectProbe

      Show list of all connected probes via specified interface. The Probe to communicate with can then be selected.

      Short command

      Syntax

      Parameter	Meaning
      Interface	(optional) Interface, J-Links are supposed to be located at (USB, IP).

      Example

      SelectProbe USB IP

      ShowEmuList

      Show list of all connected probes via specified interface (e.g. USB/IP)

      Syntax

      Parameter	Meaning
      Interface	(optional) Interface, J-Links are supposed to be located at (USB, IP).

      Example

      ShowEmuList USB IP

      Power

      Switch power supply for target (J-Link pin 19, 5V-Supply) on or off, permanently or until next power-cycle.

      Syntax

      Parameter	Meaning
      State	On: Power supply on. Off: Power supply off.
      perm	Sets the specified State value as default.

      Example

      VTREF

      Set fixed value for VTref on J-Link (0 == Auto detection).

      Syntax

      Parameter	Meaning
      Value[mV]	Value, VTref is supposed to be set to in millivolt.

      Example

      BootMode

      Selects the boot mode of the connected probe if supported (available from V7.96n). A power cycle is necessary to enter new boot mode after selection.

      Syntax

      Parameter	Meaning
      Mode	0: J-Link 1: CMSIS-DAPv1 2: CMSIS-DAPv2

      Reboot

      Reboot the connected probe and reconnect to it. If connection cannot be established in ms, an error is assumed.

      Syntax

      Example

      Reboot // Reboot with default timeout. Reboot 10000 // Reboot with 10 sec. timeout.

      Uptime

      Show current uptime of the connected Probe since boot.

      Syntax

      Example

      VCOM

      Enable/disable VCOM. Takes effect after power cycle of the Probe.

      Syntax

      Example

      ShowFWInfo

      Show firmware info.

      Short command

      ShowHWStatus

      Show hardware status.

      Short command

      License

      Execute license command. if no command is passed: Show a list of all available license commands.

      Syntax

      Parameter Command	Meaning
      add	Store a custom license on J-Link. Syntax: LicAdd
      erase	Erase all custom licenses on J-Link.
      show	Show all licenses stored on J-Link.

      IPAddr

      Show/Assign IP address and subnetmask of/to connected Probe.

      Syntax

      GWAddr

      Show/Assign network gateway address of/to connected Probe.

      Syntax

      DNSAddr

      Show/Assign network DNS server address of/to connected Probe.

      Syntax

      ShowConf

      Show configuration of the connected Probe.

      Short command

      Calibrate

      Calibrate the target current measurement.

      Short command

      Connect

      Connect to target device. If no device was preselected, the user is asked to provide the missing information about the connected device.

      Short command

      Device

      Select specific device J-Link shall connect to. If ? is passed: Show device selection dialog.

      Syntax

      Parameter	Meaning
      DeviceName	Valid device name: Device is selected. ?: Shows device selection dialog.

      Example

      SelectInterface

      Select target interface.

      Short command

      Syntax

      Parameter	Meaning
      Interface	Any supported target interface (e.g SWD, JTAG, ICSP, FINE, . )

      Example

      Speed

      Set target interface speed.

      Syntax

      Parameter	Meaning
      Setting	Decimal value: Interface speed in kHz. auto: Interface speed is selected automatically. adaptive: Interface speed is set to adaptive.

      Example

      LE

      Change mode to little endian.

      BE

      Change mode to big endian.

      Halt

      Short command

      IsHalted

      Return current CPU state.

      Short command

      WaitHalt

      Wait until CPU is halted or timeout is reached. If no timeout (in ms) is provided, a default timeout of 1000 ms is used.

      Short command

      Syntax

      Parameter	Meaning
      TimeoutMs	(optional) Timeout in milliseconds.

      Example

      Go

      Start CPU if halted.

      Short command

      Reset

      Short command

      ResetX

      Reset CPU with delay after reset. This function is useful for some target devices which already contain an application or a boot loader and therefore need some time before the core is stopped, for example to initialize hardware, the memory management unit (MMU) or the external bus interface.

      Short command

      Syntax

      Parameter	Meaning
      DelayAfterReset	Delay in ms.

      Example

      RSetType

      Set the current reset type.

      Short command

      Syntax

      Parameter	Meaning
      Type	Desired reset type. If no type is provided, a list of all available types is printed.

      Example

      Step

      Execute step(s) on the CPU and show the executed instructions. If no number of steps is provided, one step is executed.

      Short command

      Syntax

      Example

      IS

      Identify length of scan chain select register.

      MS

      Measure length of scan chain.

      Syntax

      Parameter	Meaning
      ScanChain	Scan chain to be measured.

      Regs

      Display CPU register contents.

      RReg

      Read register. If no register name is passed, all available register names are printed.

      Syntax

      Parameter	Meaning
      RegIndex	Register to read.

      Example

      WReg

      Short command

      Syntax

      Parameter	Meaning
      RegName	Register to write to.
      Data	Data to write to the specified register.

      Example

      WReg "R15 (PC)" 0x20000000

      MoE

      Shows mode-of-entry (Reason why CPU is halted).

      SetBP

      Syntax

      Parameter	Meaning
      Addr	Address to be breakpointed.
      A/T	Only for ARM7/9/11 and Cortex-R4 devices: A: ARM mode T: THUMB mode
      W/H	Only for MIPS devices: W: MIPS32 mode (Word) H: MIPS16 mode (Half-word)
      S/H	S: Force software BP H: Force hardware BP

      ClearBP

      Short command

      Syntax

      SetWP

      Syntax

      Example

      // Stop if value 0x1000 is written to address 0x20000000 (32-bit access): SetWP 0x20000000 W S32 0x1000 0 0

      ClearWP

      Short command

      Syntax

      VCatch

      Write vector catch.

      Short command

      Syntax

      SetPC

      Set the PC to specified value.

      Syntax

      Parameter	Meaning
      Addr	Address the PC should be set to.

      ReadAP

      Reads from a CoreSight AP register. This command performs a full-qualified read which means that it tries to read until the read has been accepted or too many WAIT responses have been received. In case actual read data is returned on the next read request (this is the case for example with interface JTAG) this command performs the additional dummy read request automatically.

      Syntax

      Parameter	Meaning
      RegIndex	Index of AP register to read

      Example

      • See: Reading from another MEM-AP
      • Read AP[0], IDR (register 3, bank 15):
        

      WriteDP 2 0x000000F0 // Select AP[0] bank 15 ReadAP 3 // Read AP[0] IDR

      WriteAP

      Writes to a CoreSight AP register. This command performs a full-qualified write which means that it tries to write until the write has been accepted or too many WAIT responses have been received.

      Syntax

      Parameter	Meaning
      RegIndex	Index of AP register to write
      Data32Hex	Data to write

      Example

      ReadDP

      Reads from a CoreSight DP register. This command performs a full-qualified read which means that it tries to read until the read has been accepted or too many WAIT responses have been received. In case actual read data is returned on the next read request (this is the case for example with interface JTAG, not with SWD) this command performs the additional dummy read request automatically.

      Syntax

      Parameter	Meaning
      RegIndex	Index of DP register to read

      WriteDP

      Writes to a CoreSight DP register. This command performs a full-qualified write which means that it tries to write until the write has been accepted or too many WAIT responses have been received.

      Syntax

      Parameter	Meaning
      RegIndex	Index of DP register to write
      Data32Hex	Data to write

      Example

      RCP15Ex

      Read CP15 register.

      Short command

      Syntax

      WCP15Ex

      Write CP15 register.

      Short command

      Syntax

      Term

      Visualize printf output using DCC (SEGGER DCC handler running on target).

      Mem

      Read memory from the target system and show corresponding ASCII values. If necessary, the target CPU is halted in order to read memory. Zone names will be displayed on first connect to target with J-Link commander if available.

      Syntax

      Example

      Mem 0x0 0x100
      or
      mem AHB-AP (AP1):0x20000000 0x100

      Mem8

      Read memory from the target system in units of 8-bit. If necessary, the target CPU is halted in order to read memory.

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      NumItems	Number of items to read. Maximum is 0x100000.

      Example

      Mem16

      Read memory from the target system in units of 16-bits. If necessary, the target CPU is halted in order to read memory.

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      NumItems	Number of items to read. Maximum is 0x100000.

      Example

      Mem32

      Read memory from the target system in units of 32-bits. If necessary, the target CPU is halted in order to read memory.

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      NumItems	Number of items to read. Maximum is 0x100000.

      Example

      Write1

      Write one single byte to the target system.

      Short command

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      Data	8-bits of data to write.

      Example

      Write2

      Write 16-bit items.

      Short command

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      Data	16-bits of data to write.

      Example

      Write4

      Write 32-bit items.

      Short command

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      Data	32-bits of data to write.

      Example

      W4 0x0 00112233

      Write8

      Write 64-bit items.

      Note:
      Supported since V7.86b

      Short command

      Syntax

      Parameter	Meaning
      Zone	Name of memory zone to access.
      Addr	Start address.
      Data	64-bits of data to write.

      Example

      W8 0x0 0x0011223344556677

      JTAGConf

      Configure JTAG scan chain with multiple devices on it.
      For more detailed information on how to configure a scan chain with multiple devices please refer to Determining values for scan chain configuration.
      

      Syntax

      Parameter	Meaning
      IRPre	Sum of IRLens of all devices closer to TDO, where IRLen is the number of bits in the IR (Instruction Register) of one device. -1 == auto-detection.
      DRPre	Number of devices closer to TDO. -1 == auto-detection.

      Example

      // // JTAG chain: TDI -> TAP#3 -> TAP#2 -> TAP#1 -> TAP#0 // TAP#3 (ARM DAP): IRLen = 4-bit // TAP#2 (RISC-V): IRLen = 5-bit // TAP#1 (RISC-V): IRLen = 5-bit // TAP#0 (custom): IRLen = 7-bit // Connect to TAP#1 (RISC-V): JTAGConf 7 1 // IRPre = 7, DRPre = 1 Connect to TAP#2 (RISC-V): JTAGConf 12 2 // IRPre = 7 + 5, DRPre = 1 + 1 

      JTAGId

      Short command

      WJTAGIR

      Write JTAG command (IR). If no IRLen is passed, IRLen=4 is used.

      Short command

      Syntax

      Parameter	Meaning
      Insturction	Insturction to send as hexadecimal value.
      IRLen	Instruction register length of the current selected device.

      WJTAGDR

      Write JTAG data (DR).

      Short command

      Syntax

      Parameter	Meaning
      Data64	Data to send.
      NumBits	Number of bits to send.

      WJTAGRaw

      Write Raw JTAG data.

      Short command

      Syntax

      Parameter	Meaning
      NumBits	Number of bits to send.
      TMS	TMS Data to send (hex) in reverse bit order.
      TDI	TDI Data to send (hex) in reverse bit order.

      Example

      Execute SWD => JTAG switching sequence and read the IDCODE:

      J-Link>wjr 88, 0x00FFE73CFFFFFFFFFFFFFF, 00000000000000000000000 // SWD=>JTAG Switching sequence TDO: 0000000000000000000000 J-Link>wjr 56, 0x30000000007003, 0x00000000000FE0 // Read IDCODE TDO: 00974008EE0110

      ResetTAP

      Reset TAP Controller using state machine (111110).

      Short command

      ResetTRST

      Reset TAP Controller using nTRST.

      Short command

      ICE

      Show state of the embedded ICE macrocell (ICE breaker).

      ReadICE

      Read Ice register.

      Short command

      Syntax

      Parameter	Meaning
      RegIndex	Register index of register to read from.

      WriteICE

      Write Ice register.

      Short command

      Syntax

      Parameter	Meaning
      RegIndex	Register index of register to read from.
      Data	Data to write (in hex).

      STraceStart

      STraceStop

      STraceRead

      Reads collected STRACE data.

      SWOSpeed

      Show supported SWO speeds.

      SWOStart

      SWOStop

      SWOStat

      Display SWO status.

      SWORead

      Read and display SWO data.

      SWOShow

      Read, analyze and show SWO data.

      SWOFlush

      SWOView

      View SWO terminal data.

      Erase

      Erases all flash sectors or a certain flash range of the current device. A device has to be specified previously. When specified, all flash between the and will be erased. By default, the device is being reset before starting the erase operation. This may be skipped by adding "noreset".

      Syntax

      Examples

      Erase
      Erase 0x60000000 0x60001000
      Erase 0x60000000 0x60001000 noreset
      Erase 0 0 noreset

      LoadFile

      Program a given data file. For .bin files, a location has to be specified. By default also performs a verification of programmed data. Currently supported data files are:

      Syntax

      Parameter	Meaning
      Filename	Source filename.
      Addr	Only used for .bin files. Ignored for other formats. Destination address. If not passed, 0x0 is assumed.
      Reset	Used for setting the reset behaviour. "reset" used by default implicitly. When Reset is used "Addr" is always required, but the value is ignored for non .bin files.

      Examples

      loadfile C:\Work\MyData.hex
      loadfile C:\Work\MyData.bin 0x08000000
      loadfile C:\Work\MyData.hex 0 noreset
      loadfile C:\Work\MyData.bin 0x08000000 noreset
      

      SaveBin

      Save target memory range into binary file.

      Syntax

      Parameter	Meaning
      Filename	Destination file
      Addr	Source address.
      NumBytes	Number of bytes to read.

      Example

      SaveBin C:\Work\test.bin 0x0000000 0x100

      VerifyBin

      Verfy if specified .bin file is at the specified target memory location.

      Syntax

      Parameter	Meaning
      Filename	Sample bin.
      Addr	Start address of memory to verify.

      Example

      VerifyBin C:\Work\test.bin 0x0000000

      FWrite

      On probes which support file I/O this command writes a specific file. Currently, only Flasher models support file I/O. NumBytes is limited to 512 bytes at once. This means, if you want to write e.g. 1024 bytes, you have to send the command twice, using an appropriate offset when sending it the second time. Offset applies to both destination and source file.

      Short command

      Syntax

      Parameter	Meaning
      EmuFile	File name to write to.
      HostFile	Source file on the host
      Offset	Specifies the offset in the file, at which data writing is started.
      NumBytes	Maximum number of bytes to write.

      Example

      FWrite Flasher.dat C:\Project\Flasher.dat

      FRead

      On probes which support file I/O this command reads a specific file. Offset applies to both destination and source file.

      Short command

      Syntax

      Parameter	Meaning
      EmuFile	File name to read from.
      HostFile	Destination file on the host.
      Offset	Specifies the offset in the file, at which data reading is started.
      NumBytes	Maximum number of bytes to read.

      Example

      FRead Flasher.dat C:\Project\Flasher.dat

      FShow

      On probes which support file I/O this command reads and prints a specific file. Currently, only Flasher models support file I/O.

      Syntax

      Parameter	Meaning
      FileName	Source file name to read from the Flasher.
      -a	If set, Input will be parsed as text instead of being shown as hex.
      Offset	Specifies the offset in the file, at which data reading is started.
      NumBytes	Maximum number of bytes to read.

      Example

      FDelete

      On probes which support file I/O this command deletes a specific file.

      Short command

      Syntax

      Parameter	Meaning
      FileName	File to delete from the Flasher.

      Example

      FSize

      On probes which support file I/O this command gets the size of a specific file. Currently, only Flasher models support file I/O.

      Short command

      Syntax

      Parameter	Meaning
      FileName	Source file name to read from the Flasher.

      FList

      On probes which support file I/O this command shows the directory tree of the Flasher.

      SecureArea

      On probes which support file I/O this command creates/removes a secure area on the probe.

      Syntax

      PowerTrace

      Perform power trace (not supported by all models).

      Syntax

      TestWSpeed

      Measure download speed into target memory.

      Short command

      Syntax

      TestRSpeed

      Measure upload speed from target memory.

      Short command

      Syntax

      TestCSpeed

      Measure CPU speed.

      Short command

      Syntax

      TestNWSpeed

      Measure network download speed between the host and the probe.
      For a probe that is connected via USB, the USB download speed is measured.
      For a probe that is connected via TCP/IP, the TCP/IP download speed is measured.

      Short command

      Syntax

      TestNRSpeed

      Measure network upload speed between the probe and the host.
      For a probe that is connected via USB, the USB upload speed is measured.
      For a probe that is connected via TCP/IP, the TCP/IP upload speed is measured.

      Short command

      Syntax

      MR

      Measure RTCK reaction time.

      Syntax

      Parameter	Meaning
      RepCount	Number of times the test is repeated (Default: 1).

      Example

      Clock

      Output clock(s) on the TCK pin (J-Link pin 9).

      Short command

      Syntax

      Clock00

      Output clock(s) on the TCK pin (J-Link pin 9), with TDI == 0 and TMS == 0.

      Short command

      Syntax

      ClrTCK

      Clear TCK pin (J-Link pin 9).

      Short command

      SetTCK

      Set TCK pin (J-Link pin 9).

      Short command

      ClrTDI

      Clear TDI pin (J-Link pin 5).

      Short command

      SetTDI

      Set TDI pin (J-Link pin 5).

      Short command

      ClrTMS

      Clear TMS pin (J-Link pin 7).

      Short command

      SetTMS

      Set TMS pin (J-Link pin 7).

      Short command

      ClrTRST

      Clear TRST pin (J-Link pin 3).

      Short command

      SetTRST

      Set TRST pin (J-Link pin 3).

      Short command

      ClrRESET

      Clear RESET pin (J-Link pin 15).

      Short command

      SetRESET

      Set RESET pin (J-Link pin 15).

      Short command

      Command sequence examples

      This section provides some examples for the J-Link Commander Commands

      Reading from another MEM-AP

      This example shows how to read data via a MEM-AP.

      Assumptions

      • MCU with a core AP & another AP for background memory access
      • User wants to read data while the device is running, using background memory access.
      • AP[0]: AHB-AP: CPU
      • AP[1]: APB-AP: System AP (for background access)

      Commands used

      Example sequence

      WriteDP 2 0x01000000 // SELECT register: Select AP[1] bank 0 WriteAP 0 0x80006012 // CSW register: DbgSwEnable: Enable, AddrInc: Increment, Size: 32 bits WriteAP 1 0x00000000 // TAR register: Select address to start reading from ReadAP 3 // DRW register: Read @0x0000_0000 ReadAP 3 // DRW register: Read @0x0000_0004 . 

      Using J-Link Command Files

      J-Link commander can also be used in batch mode which allows the user to use J-Link commander for batch processing and without user interaction. Please do not confuse J-Link Command Files file with J-Link Script Files. When using J-Link commander in batch mode, the path to a command file is passed to it. The syntax in the command file is the same as when using regular commands in J-Link commander (one line per command). SEGGER recommends to always pass the device name via command line option due some devices need special handling on connect/reset in order to guarantee proper function. J-Link Command Files support C-Style comments.

      JLink.exe -device STM32F103ZE -CommandFile C:\\CommandFile.jlink

      Contents of CommandFile.jlink:
      

      si 1 // Select interface speed 4000 // Select speed /* Perform reset and halt */ r h loadfile C:\firmware.bin 0x08000000 // Load data file

      Perform flash download

      J-Link Commander allows to download data files of different types into the flash memory of the target systems.

      • Connect J-Link to the PC
      • Connect target system to J-Link
      • Start J-Link Commander
      • Enter the requested settings (e.g. target device, interface settings, etc. )
      • Type the following commands:
        • r
        • loadfile []

        

        Command line options

        The table below describes the different command line options, which are supported by J-Link Commander:

        Command line option	Explanation
        Batch mode specific
        -AutoConnect	Value==1: Forces the J-Link Commander to connect to the target, automatically.
        -CommandFile	Selects a J-Link Command file which contains the commands for batch mode / auto execution.
        -ExitOnError	Value==1: Exit J-Link Commander on Error.
        -NoGui	Value==1: Suppresses GUI dialogs.
        J-Link connection specific
        -IP	Selects a specific J-Link (via IP/Tunnel/Nickname) to connect to via TCP/IP.
        -USB	Selects a specific J-Link (via its serial number) or nickname (available from V7.92d) to connect to. Used in case multiple J-Links are connected to the same PC via USB.
        Device connection specific
        -Device	Selects the target device.
        -If	Configures the target interface.
        -JLinkScriptFile	Selects a specific J-Link script file to use.
        -JTAGConf ,	Configures the JTAG scan configuration of the target device. IRPre==-1 and DRPre==-1 can be passed to use auto-detection (=> first known device will be used).
        -Speed	Configures the target interface speed.
        Misc
        -Log	Sets a path a J-Link log file is to be created.
        -RTTTelnetPort	Set the J-Link RTT Telnet port to

        JLink.exe -device CC2538SF53 -if JTAG -speed 4000 -jtagconf -1,-1 -autoconnect 1 -CommandFile C:\Work\JLinkCommandFile.jlink

        Batch processing

        While J-Link Commander is mainly designed to be used in interactive mode (so the user manually enters commands), as a verification utility, it can also be automated.
        For this, a command file may be specified and passed via the -CommandFile command line parameter to J-Link Commander.

        A command file is a simple file that contains 1 command per line, as if they were entered manually in the terminal.

        JLink.exe -CommandFile C:\Work\JLinkCommandFile.jlink

        Command file contents:

        device CC2538SF53 si JTAG speed 4000 jtagconf -1,-1 connect

        JLink.exe return value

        The return value of the J-Link Commander application (JLink.exe) can be read out int the environment variable ERRORLEVEL.

        1. Returns an Error (ERRORLEVEL == 1)

        start /wait "J-Link Commander" "JLink.exe" -if InvalidInterfaceParameter ECHO error level is %ERRORLEVEL% pause

        2. Returns no Error (ERRORLEVEL == 0)

        start /wait "J-Link Commander" "JLink.exe" ECHO error level is %ERRORLEVEL% pause

        For information how to access the environment variable ERRORLEVEL within a java application please refer to: http://stackoverflow.com/questions/8922485/how-to-execute-echo-errorlevel-in-java

        Using J-Link Command Strings

        In order to use J-Link Command Strings in J-Link Commander, the native J-Link Commander command exec supplemented by one of the available J-Link Command Strings can be used.

        

        exec SupplyPower = 1 exec map reset exec map exclude 0x10000000-0x3FFFFFFF

        Changing J-Link Reset Strategy

        The reset strategy can be changed by executing the RSetType command:

        RSetType = 12

        Connecting to a specific J-Link

        It is possible to have multiple J-Links connected to the PC at the same time (for more information, see here. To connect to a specific J-Link in an automated way (no user interaction required), J-Link Commander needs to be told the S/N of the J-Link to connect to. This can be done via two different methods:

        • Specify the S/N directly via command line. See -SelectEmuBySN above for more information.
        • Specify "SelectEmuBySN " (without quotes) as first command in the J-Link command file that is passed to J-Link Commander via command line

        Setup External CFI NOR Flash

        J-Link Commander supports downloading bin files into external CFI flash memory. In the following, it is explained which steps are necessary to prepare J-Link Commander for download into external CFI flash memory based on a sample sequence for a ST STM32F103ZE device:

        r speed 1000 exec setcfiflash 0x64000000 - 0x64FFFFFF exec setworkram 0x20000000 - 0x2000FFFF w4 0x40021014 0x00000114 // RCC_AHBENR, FSMC clock enable w4 0x40021018 0x000001FD // GPIOD~G clock enable w4 0x40011400 0xB4BB44BB // GPIOD low config, NOE, NWE => Output, NWAIT => Input w4 0x40011404 0xBBBBBBBB // GPIOD high config, A16-A18 w4 0x40011800 0xBBBBBBBB // GPIOE low config, A19-A23 w4 0x40011804 0xBBBBBBBB // GPIOE high config, D5-D12 w4 0x40011C00 0x44BBBBBB // GPIOF low config, A0-A5 w4 0x40011C04 0xBBBB4444 // GPIOF high config, A6-A9 w4 0x40012000 0x44BBBBBB // GPIOG low config, A10-A15 w4 0x40012004 0x444B4BB4 // GPIOG high config, NE2 => output w4 0xA0000008 0x00001059 // CS control reg 2, 16-bit, write enable, Type: NOR flash w4 0xA000000C 0x10000505 // CS2 timing reg (read access) w4 0xA000010C 0x10000505 // CS2 timing reg (write access) speed 4000 mem 0x64000000 100 loadfile C:\STMB672_STM32F103ZE_TestBlinky.bin 0x64000000 mem 0x64000000 100

        Command specifics

        Verifybin command

        The verifybin command in J-Link Commander executes a simple read of memory and compares the data against the data in the specified bin file. Note that *no* initialization of any flash interface etc. is done on this command. For external QSPI flash for example this means that the pins and the QSPI controller of the target MCU have to be already initialized etc. for this command to succeed. This is different for "loadfile" which may trigger a flash download implicitly where a flash loader is started that takes care of the initialization. Also note that executing a "loadfile" command in advance, does not guarantee that a "verifybin" succeeds because the loadfile commands restores the controller state after it is done. So if the QSPI controller and/or pins were not initialized before the "loadfile" command, they are not after it either. They are only available while "loadfile" is active.

        Retrieved from "https://wiki.segger.com/index.php?title=J-Link_Commander&oldid=21062"
        • Pages using deprecated source tags
        • Pages with syntax highlighting errors