mirror
/
stlink
kopia lustrzana https://github.com/stlink-org/stlink
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność
Open source version of the STMicroelectronics STLINK Tools
1 226 Commity
3 Gałęzie
12 Tagi
19 MiB
C 89.8%
CMake 8.5%
Assembly 0.9%
Makefile 0.5%
Shell 0.3%
 
 
 
 
 
Go to file
Guillaume Revaillot 46bf0abf77 add dual bank flash configuration info to chipid database. 
add a 'has_dual_bank' info to flash param, helping handling a couple of cases
 - selecting over dual bank specific code path without handling multiple chip id all over the code.
 - handling dual bank mode dynamic configuration
 		2020-04-06 18:42:46 +02:00
.github/ISSUE_TEMPLATE Merge pull request #908 from chenguokai/master 2020-04-06 13:40:52 +02:00
cmake fix intendation in Version.cmake 2020-03-21 21:31:12 +02:00
debian Merge branch 'pr-847/zx81a/master' into develop. 2020-02-21 01:07:52 +01:00
doc [doc] Added st-flash --flash CL option 2020-04-02 21:29:02 +02:00
etc update udev rules for stlinkv2-1 2020-03-31 15:26:27 +02:00
flashloaders Fixing low-voltage flashing on STM32F7 parts. (#567) 2017-03-14 18:54:02 +01:00
include add dual bank flash configuration info to chipid database. 2020-04-06 18:42:46 +02:00
scripts Prepare for win64 static executable builds 2017-01-28 11:30:30 +01:00
src add dual bank flash configuration info to chipid database. 2020-04-06 18:42:46 +02:00
stlinkv1_macosx_driver Resolved conflicts with develop branch. 2020-02-24 23:11:51 +01:00
tests check if app's need for libssp. 2020-03-21 14:48:40 +02:00
usr/lib/pkgconfig Debian packaging, CMake and README.md fixes (#683) 2018-03-16 16:41:07 +01:00
.appveyor.yml appveyor: Cache libusb-1.0.20.7z instead of non-allowed wildcard 2016-09-15 15:25:28 +02:00
.gitignore Fix mingw build (#610) 2017-06-29 21:33:31 +02:00
.travis-lin-mingw.sh Add win32 travis build (#2) 2020-02-29 16:23:22 +02:00
.travis.sh Resolved conflicts with develop branch. 2020-02-24 23:11:51 +01:00
.travis.yml Add win32 travis build (#2) 2020-02-29 16:23:22 +02:00
.version compare git version with .version 2020-03-01 22:39:43 +02:00
CHANGELOG.md Minor fixes in CHANGELOG.md 2020-03-22 00:47:39 +01:00
CMakeLists.txt check if app's need for libssp. 2020-03-21 14:48:40 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-02-20 00:24:18 +01:00
LICENSE.md General Project Update 2020-04-02 20:55:27 +02:00
Makefile Initial work to fix cygwin builds 2016-10-22 09:44:37 +02:00
README.md [doc] Added reference to tutorial 2020-04-03 11:49:31 +02:00

README.md

Open source version of the STMicroelectronics Stlink Tools

BSD licensed GitHub release GitHub commits Downloads Linux Status macOS Status

Recent new features and bugfixes can be found in the Changelog of this software project.

Introduction

This stlink toolset supports several so called stlink programmer boards (and clones thereof) which use a microcontroller chip to translate commands from USB to JTAG.

These programmer boards are available in four versions:

  • STLINKv1:
    • transport layer: SCSI passthru commands over USB
    • present on STM32VL discovery kits
  • STLINKv2:
    • transport layer: raw USB commands
    • present on STM32L discovery and nucleo and later kits
  • STLINKv2-1:
    • transport layer: raw USB commands
    • present on some STM32 nucleo boards
  • STLINKv3:
    • not yet supported by this toolset (but planned)

Supported hardware combinations

Currently known working combinations of programmers and targets are listed in devices_boards.md.

Tutorial & HOWTO

Our [tutorial.md](doc/tutorial.md may help you along with some advanced tasks and additional info.

Installation

Windows: download v1.6.0 from the releases page.

Windows pre-compiled binaries are available at http://www.emb4fun.de/archive/stlink/index.html (outdated, not recommended for use)

macOS: install from homebrew or download v1.6.0 from the releases page.

Linux:

We recommend to install stlink-tools from the package repository of the used distribution:

Other Operating Systems:

Installation from source (advanced users)

When there is no executable available for your platform or you need the latest (possible unstable) version you need to compile the toolset yourself. This procedure is explained in the compiling manual.

Contributing and versioning

  • The semantic versioning scheme is used. Read more at semver.org
  • Before creating a pull request, please ALWAYS open a new issue for the discussion of the intended new features. Bugfixes don't require a discussion via a ticket-issue. However they should always be described in a few words as soon as they appear to help others as well.
  • Contributors and/or maintainers may submit comments or request changes to patch-proposals and/or pull-requests.
  • ATTENTION: NEVER EVER use the '#' character to count-up single points within a listing as '#' is exclusively reserved for referencing github issues and pull-requests. Otherwise you accidentally introduce false cross references within the project.
  • Please start new forks from the develop branch if possible as pull requests will go into this branch as well.

License

The stlink library and tools are licensed under the BSD-3 license.

The flashloaders/stm32l0x.s and flashloaders/stm32lx.s source files are licensed under the GPLv2+.

Current state of the project

Known missing features

Some features are currently missing from the texane/stlink toolset. Here we would appreciate any help and would love to welcome new contributors who want to get involved:

  • Instrumentation Trace Macro (ITM) Cell (#136)
  • OTP & EEPROM area programming (#202, #333, #686)
  • Protection bits area reading (#346)
  • Writing external memory connected to an STM32 controller (e.g Quad SPI NOR flash) (#412)
  • MCU hotplug (#449)
  • Writing options bytes (region) (#458)
  • Support for STLINKv3 programmer (#820)