stlink

Версия с открытым исходным кодом инструментов STMicroelectronics STLINK.

Последние новые функции и исправления ошибок можно найти в журнале изменений этого программного проекта.

Лицензия

Библиотека и инструменты stlink лицензируются по лицензии BSD-3 .

Введение

stlink — это набор инструментов с открытым исходным кодом для программирования и отладки устройств и плат STM32, производимых STMicroelectronics. Он поддерживает несколько так называемых программаторов STLINK (и их клонов), которые используют чип микроконтроллера для преобразования команд из USB в JTAG/SWD. На рынке доступны четыре поколения, все из которых поддерживаются этим набором инструментов:

• STLINK/V1 [устарело с 21 ноября 2019 г., поддержка продолжается этим набором инструментов]
  • Транспортный уровень: сквозные команды SCSI через USB
  • автономный программатор
  • встроенный в платы Discovery STM32VL
• СТЛИНК/В2
  • транспортный уровень: необработанные команды USB
  • автономный программатор
  • встроен в платы STM32L Discovery и STM32 Nucleo
• СТЛИНК/В2-1
  • транспортный уровень: необработанные команды USB
  • встроен в некоторые платы STM32 Nucleo
• СТЛИНК-В3
  • транспортный уровень: необработанные команды USB
  • автономный программатор (STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • встроен в некоторые платы STM32 Nucleo (STLINK-V3E)

На уровне пользователя нет никакой разницы в обращении или работе между этими разными версиями.

Набор инструментов STlink включает в себя:

• st-info — программатор и инструмент для получения информации о чипах
• st-flash — инструмент для работы с флэш-памятью
• st-trace — инструмент журналирования для записи информации о выполнении
• st-util — сервер GDB (поддерживается в Visual Studio Code/VSCodium через плагин Cortex-Debug)
• stlink-lib — библиотека связи
• stlink-gui — графический интерфейс [необязательно]

Поддерживаемые операционные системы и комбинации оборудования

Известные на данный момент рабочие цели MCU перечислены в support_devices.md.

Список поддерживаемых операций можно найти в version_support.md.

Учебное пособие и инструкции

Наше руководство может помочь вам с некоторыми сложными задачами и дополнительной информацией.

Установка

Окна :

Начиная с версии 1.6.1 автономные двоичные файлы Windows доступны (снова) на странице выпуска проекта. Убедитесь, что вы выбрали правильную версию для вашей системы (i686 или x86_64). Архивный файл можно распаковать в любое место, поскольку он не содержит жестко запрограммированных путей. Однако мы предлагаем переместить папку разархивированного приложения в C:Program Files в 32-битных системах и в C:Program Files (x86) в 64-битных системах (набор инструментов 32-битный).

В качестве альтернативы можно скомпилировать и установить из исходного кода, как описано в нашем руководстве по компиляции.

Линукс/Юникс :

Рекомендуем установить stlink-tools из репозитория пакетов используемого дистрибутива:

Примечание. Поскольку пакеты, распространяемые через репозитории Debian и Ubuntu, отличаются от нашего автономного deb-пакета, мы рекомендуем вместо этого использовать последний (см. ссылку ниже). Он предоставляет возможность обрабатывать и исправлять проблемы с пакетами, о которых сообщают пользователи, непосредственно в проекте и не является избыточным для каких-либо ограничений, вытекающих из внешних руководств по обслуживанию.

• Debian Linux: (Ссылка)
• Ubuntu Linux: (Ссылка)
• Арч Linux: (Ссылка)
• Альпийский Linux: (Ссылка)
• Федора: (Ссылка)
• FreeBSD: пользователи могут устанавливать из Freshports.

macOS :

Поддержка macOS прекращена в версии 1.8.0.

Вместо этого используйте версию 1.7.0, но учтите, что эта версия больше не поддерживается!

Установка из исходников (продвинутые пользователи)

Если для вашей платформы нет исполняемого файла или вам нужна последняя (возможно, нестабильная) версия, вам необходимо скомпилировать набор инструментов самостоятельно. Эта процедура описана в инструкции по составлению.

Содействие и управление версиями

• Используется семантическая схема версионирования. Подробнее читайте на сайте semver.org.
• Прежде чем создавать запрос на включение, ВСЕГДА открывайте новый выпуск для обсуждения предполагаемых новых функций. Исправления ошибок не требуют обсуждения через тикет. Однако их всегда следует описывать в нескольких словах, поскольку они могут помочь и другим.
• Участники и/или сопровождающие могут отправлять комментарии или запрашивать изменения в предложениях по исправлениям и/или запросах на включение.
• ВНИМАНИЕ: НИКОГДА не используйте символ «#» для подсчета отдельных точек в листинге, поскольку символ «#» зарезервирован исключительно для ссылки на проблемы GitHub и запросы на извлечение. В противном случае вы случайно введете в проект ложные перекрестные ссылки.
• Пожалуйста, запустите новые форки из ветки разработки, поскольку запросы на включение также будут поступать в эту ветку.

Также ознакомьтесь с нашими Правилами внесения взносов.

Отзывы пользователей

Надеюсь, это не вышло за рамки темы, но я был настолько расстроен вещами, связанными с AVR в OpenBSD, что тот факт, что stlink собран из коробки без необходимости ничего трогать, был таким облегчением. Буквально сделал все мои выходные лучше! Я полагаю, что благодаря @Crest, а также команде stlink-org (@Nightwalker-87 и @xor-gate, кажется), они создали программное обеспечение, которое не является недружелюбным по отношению к «маргинальным» ОС. Спасибо <3» - нбонфилс, 11.12.2021