Git Product home page Git Product logo

eblink's Introduction

Cortex-M tool e.g. STlink V2 & V3 support

Win32, Linux_x86_64 and Raspberry

Auto detects Silabs, STmicro and Atmel

Warning:
Stop updating your stlink/v2 firmware to the latest if you want to keep using it for non-STmicro mcu's.
Firmware V2.J34 is confirmed to work with e.g. Silabs. You can check firmware version with the EBlink option -v5.
Most updates are mass storage related which we don't use anyway.

EBlink ARM Cortex-M debug tool with squirrel scripting device support

Windows installer available with windows shell context menu.
The installer set EB_DEFAULT_SCRIPT to "auto"(.script) so that all supported vendors are automaticlly detected (currently Silabs, STmicro and Atmel).

alt text

Project bucket list

  • Flash-breakpoints to increase the number of allowable breakpoints. Now we don't use external loaders anymore this is in reach as soon as we have a good ARM instruction emulator. Together with the speed of e.g. STlinkV3 and small page-size devices, this will be very convenient.
  • Complete CMIS-DAP(v2), this is for 40% ready
  • Implement SWO and ITM
When to consider EBlink instead of OpenOCD:
  • if you need live variables for e.g. Embitz (OpenOCD doesn't support live variables)
  • as a non-intrusive memory inspector (eblink supports hot-plugging and non-stop mode )
  • if you need a CLI memory reader to read particular memory locations (also on running targets) and print them at stdout
  • if you need a CLI programmer to modify particular in-place flash locations (checksum, serials etc)
  • for easy complex custom board reset strategies or memory maps with special options
  • for faster debug sessions because of the EBlink flash cache (e.g. only modified sectors are rewritten)
  • for using easy auto configuration scripts e.g. custom flashing of ext. EEprom's etc
  • as a remote (wifi) GDB server e.g. Raspberry (lightweight)
  • simple standalone flash tool (program, verify, compare or dump)

EBlink features:

  • Integrated target stack frame UNWIND in case of exception with message box popup in windows.
  • GDB server with flash caching, with EmBitz live variables/expression support!
  • Full Semi-hosting support
  • Supports Hotplug for Embitz 1.1 see issue and 2.0 (monitor command "IsRunning" for target state query)
  • Inplace memory (flash or ram) modifications of any length byte array from the command line (e.g. serials or checksum programming)
  • Any length byte array memory reading also on running target from the command line (automated testing)
  • Core control (halt, reset and resume) from the command line (automated testing)
  • Stand alone command line flashing tool (elf, ihex and srec) for production
  • Dump memory (also on running target) to file in Intel hex or binary format
  • Compare flash against a srec, ihex or elf file.
  • All device related functions by c-like squirrel scripting e.g. flash or ext. EEprom algorithms, device reset strategy etc etc
  • Ready for multiple interfaces

Remarks:

  1. EBlink uses ROM caching for speed performance. It is parsing the same XML memory map, which is provided by scripting, which is offered to GDB to get the memory information. If GDB reads memory from the ROM (flash) region then EBlink will not query the target but will instead return from cache. Sometimes, like debugging flash writing applications (e.g. bootloader), this behavior is not preferred and doesn't show the real flash modifications in GDB. If flash modifying code is debugged, turn off the caching with the "nc" GDB server option.

  2. By default, the "Connection under reset" for the stlink interface is enabled. For hotplugging use the CLI option --hotplug (-H) or the stlink interface swith "dr" (Disable Reset) e.g. -I stlink,dr Both options are the same but set at different levels.

ISSUES

  • If flash is empty but was started by e.g. powerup, a target exception is detected and an UNWIND is happening after first GDB launch because the exception flags of the MCU are set. This is not a bug but by design. Just ignore!
  • Non STmicro devices (e.g. Silabs, NXP) are only working with STlink-V2.

EBlink - usage:

EBlink <options>

-h,           --help			Print this help
-g,           --nogui			No GUI message boxes
-v <level>,   --verbose <0..8>		Specify level of verbose logging (default 4)
-a [type],    --animation [0..]		Set the animation type (0=off, 1 = cursor, >1 = dot)
-H,           --hotplug                 Don't reset/stop at target connection
-I <options>, --interf			Select interface
-T <options>, --target			Select target(optional)
-S <file>,    --script <file>		Add a device script file
-P <path>,    --path <path>		Add a search path for scripts
-D <def>,     --define <def>		Add a script global define "name=value"
-F <options>, --flash <options>		Run image flashing
-G [options], --gdb <options>		Launch GDB server

--script and --interf are mandatory, normally combined with --flash or/and --gdb

   e.g.
    EBlink -I stlink -S stm32-auto -G
    EBlink -I stlink -S stm32-auto -G -D FLASH_SIZE=1024 -D RAM_SIZE=16
    EBlink -I stlink,dr,speed=3000 -S silabs-auto -F erase,verify,run,file=mytarget.elf
    EBlink -I cmsis-dap -T cortex-m,nu -S stm32-auto -G port=4242,nc,s -S myReset.scr

==== Interfaces

name: CMSIS-DAP(v2) - ARM debug protocol driver

 Usage -I cmsis-dap[,options]

    dr           : Disable reset at connection (hotplug)
    speed=nnn    : Interface speed (default max possible)
    swd          : use SWD (default)
    jtag         : use Jtag
    voltage=<vcc>   : Set the target voltage, default 3.3(V) 
    serial=<serial> : Select probe explicit with serial#
    device=<usb_bus>:<usb_addr> : Select V2 probe explicit on bus

    e.g.  -I cmsis-dap,dr,speed=3000

<currently under construction>

name: STlink - STmicro V2/3 interface driver

 Usage -I stlink[,options]

    dr           : Disable reset at connection (same as cli --hotplug)
    speed=nnn    : Interface speed (default max possible)
    swd          : use SWD (default)
    jtag         : use Jtag
    speed=<speed>: Set the interface maximum speed
    serial=<serial> : Select probe explicit with serial#
    device=<usb_bus>:<usb_addr> : Select probe explicit on bus

    e.g.  -I stlink,dr,speed=3000

==== Targets

name: cortex-m

 Usage -T cortex-m[,options]

    fu=[0..2]    : Fault unwind level; 0=off, 1=forced only, 2= active break(default)
    reset[=0..2] : Reset the target, 0(default)=system,1=core,2=jtag
    halt         : Halt target
    resume       : Resume target

    e.g.  -T cortex-m,nu
          -T cortex-m,reset,resume

==== Flash loader

Usage -F [options]

    erase        : Chip erase the flash
    verify       : Verify flash after upload
    run          : Start image
	
    read=<byte length>@<address>
                 : Read memory location at address with a given length and print as hex string.
				   Use verbose level 0 for minimal print info."
	
    write=<hex byte(s)>@<address>
                 : Modify flash location at address with a given byte array
				 
    file=<file>  : Load the file, <file>.hex  = Intel HEX format
                                  <file>.srec = Motorola srec file format

                                  Default     = ELF file format
								  
    cmp=<file>   : Compare Flash with file, <file>.hex  = Intel HEX format
                                  <file>.srec = Motorola srec file format

                                  Default     = ELF file format		

    dump=<length>@<address>:<file> 
                 : Dump memory to file, <file>.hex  = Intel HEX format
	                            Default     = Binary file format									  

    e.g. -F file=test.elf
         -F run,file=test.hex		
         -F read=0x4@0x0800000A,read=12@0x0800000C			 
         -F run,verify,write=DEAD@0x08000004
         -F run,file=test.hex,write=45FECA1245@0x80000004,write=EBAB@0x08000100
         -F erase,verify,run,file=test.srec
         -F erase
         -F run			 

    Default (without erase) only modified sectors are (re)flashed.
Multiple writes and reads are allowed and is done after any file upload.

==== GDB server

 Usage -G [options]

    s            : Shutdown after disconnect
    nc           : Don't use EBlink flash cache
    port=ppp     : Select different TCP port, default 2331
    address=x.x.x.x : Select different listen address, default 0.0.0.0

    e.g.  -G s,nc

eblink's People

Contributors

embitz avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.