stlink

Versión de código abierto de las herramientas STLINK de STMicroelectronics

Se pueden encontrar nuevas funciones recientes y correcciones de errores en el registro de cambios de este proyecto de software.

Licencia

La biblioteca y las herramientas stlink tienen la licencia BSD-3 .

Introducción

stlink es un conjunto de herramientas de código abierto para programar y depurar dispositivos y placas STM32 fabricados por STMicroelectronics. Admite varias placas programadoras STLINK (y sus clones) que utilizan un chip microcontrolador para traducir comandos de USB a JTAG/SWD. Hay cuatro generaciones disponibles en el mercado, todas ellas compatibles con este conjunto de herramientas:

• STLINK/V1 [obsoleto a partir del 21-11-2019, soporte continuo por parte de este conjunto de herramientas]
  • capa de transporte: comandos de paso SCSI a través de USB
  • programador independiente
  • a bordo en placas STM32VL Discovery
• STLINK/V2
  • capa de transporte: comandos USB sin formato
  • programador independiente
  • Integrado en placas STM32L Discovery y STM32 Nucleo
• STLINK/V2-1
  • capa de transporte: comandos USB sin formato
  • Integrado en algunas placas STM32 Nucleo.
• STLINK-V3
  • capa de transporte: comandos USB sin formato
  • programador autónomo (STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • Integrado en algunas placas STM32 Nucleo (STLINK-V3E)

A nivel de usuario no hay diferencia en el manejo u operación entre estas diferentes revisiones.

El conjunto de herramientas STlink incluye:

• st-info : una herramienta de programación y información de chips
• st-flash : una herramienta de manipulación de flash
• st-trace : una herramienta de registro para registrar información sobre la ejecución
• st-util : un servidor GDB (compatible con Visual Studio Code/VSCOdium a través del complemento Cortex-Debug)
• stlink-lib - una biblioteca de comunicación
• stlink-gui - una interfaz GUI [opcional]

Sistemas operativos y combinaciones de hardware compatibles

Los objetivos de MCU que funcionan actualmente se enumeran en support_devices.md.

Puede encontrar una lista de operaciones compatibles en version_support.md.

Tutoriales y CÓMO

Nuestro tutorial puede ayudarle con algunas tareas avanzadas e información adicional.

Instalación

Ventanas :

A partir de la versión v1.6.1, los binarios independientes de Windows están disponibles (nuevamente) en la página de lanzamiento del proyecto. Asegúrese de seleccionar la versión correcta para su sistema (i686 o x86_64). El archivo comprimido se puede descomprimir en cualquier ubicación deseada, ya que no contiene rutas codificadas. Sin embargo, sugerimos mover la carpeta de la aplicación descomprimida a C:Program Files en sistemas de 32 bits y a C:Program Files (x86) en sistemas de 64 bits (el conjunto de herramientas es de 32 bits).

Alternativamente, se puede compilar e instalar desde el código fuente como se describe en nuestro manual de compilación.

Linux/Unix :

Recomendamos instalar stlink-tools desde el repositorio de paquetes de la distribución utilizada:

Nota: Como los paquetes distribuidos a través de los repositorios de Debian y Ubuntu difieren de nuestro paquete deb automantenido, recomendamos utilizar este último (consulte el enlace a continuación). Brinda la oportunidad de manejar y solucionar problemas de paquetes informados por los usuarios directamente dentro del proyecto y no es redundante para ninguna limitación derivada de pautas de mantenimiento externas.

• Debian Linux: (Enlace)
• Ubuntu Linux: (Enlace)
• Arch Linux: (Enlace)
• Linux alpino: (Enlace)
• Fedora: (Enlace)
• FreeBSD: los usuarios pueden instalar desde Freshports

MacOS :

La compatibilidad con macOS se eliminó con la versión 1.8.0.

Utilice la versión 1.7.0 en su lugar, pero tenga en cuenta que esta versión ya no se mantiene ni se admite.

Instalación desde fuente (usuarios avanzados)

Cuando no hay ningún ejecutable disponible para su plataforma o necesita la última versión (posiblemente inestable), debe compilar el conjunto de herramientas usted mismo. Este procedimiento se explica en el manual de compilación.

Contribuir y versionar

• Se utiliza el esquema de versiones semánticas. Lea más en semver.org
• Antes de crear una solicitud de extracción, SIEMPRE abra una nueva edición para discutir las nuevas funciones previstas. Las correcciones de errores no requieren una discusión a través de una emisión de ticket. Sin embargo, siempre deben describirse en pocas palabras tan pronto como parezcan ayudar a otros también.
• Los contribuyentes y/o mantenedores pueden enviar comentarios o solicitar cambios a las propuestas de parches y/o solicitudes de extracción.
• ATENCIÓN: NUNCA utilice el carácter '#' para contar puntos individuales dentro de una lista, ya que '#' está reservado exclusivamente para hacer referencia a problemas de GitHub y solicitudes de extracción. De lo contrario, introducirá accidentalmente referencias cruzadas falsas dentro del proyecto.
• Inicie nuevas bifurcaciones desde la rama de desarrollo, ya que las solicitudes de extracción también llegarán a esta rama.

Consulte también nuestras Pautas de contribución.

Reseñas de usuarios

Espero que no esté fuera de tema, pero me he sentido tan frustrado con las cosas relacionadas con AVR en OpenBSD, que el hecho de que stlink se construyera fuera de la caja sin necesidad de tocar nada fue un gran alivio. ¡Literalmente mejoró todo mi fin de semana! Supongo que es gracias a @Crest y también al equipo de stlink-org (@Nightwalker-87 y @xor-gate, al parecer) por haber creado un software que no es hostil para los sistemas operativos "marginales". Gracias <3" - nbonfils, 12.11.2021