stlink

STMicroelectronics STLINK 도구의 오픈 소스 버전

최근의 새로운 기능과 버그 수정은 이 소프트웨어 프로젝트의 변경 로그에서 찾을 수 있습니다.

특허

stlink 라이브러리와 도구는 BSD-3 라이선스 에 따라 라이선스가 부여됩니다.

소개

stlink는 STMicroelectronics에서 제조한 STM32 장치 및 보드를 프로그래밍하고 디버그하기 위한 오픈 소스 도구 세트입니다. 이는 USB에서 JTAG/SWD로 명령을 변환하기 위해 마이크로컨트롤러 칩을 사용하는 소위 STLINK 프로그래머 보드(및 그 클론)를 지원합니다. 이 도구 세트가 지원 하는 4개 세대가 시장에 나와 있습니다.

• STLINK/V1 [2019년 11월 21일 현재 더 이상 사용되지 않으며 이 도구 세트에서 계속 지원]
  • 전송 계층: USB를 통한 SCSI 통과 명령
  • 독립형 프로그래머
  • STM32VL 디스커버리 보드 온보드
• STLINK/V2
  • 전송 계층: 원시 USB 명령
  • 독립형 프로그래머
  • STM32L Discovery 및 STM32 Nucleo 보드 온보드
• STLINK/V2-1
  • 전송 계층: 원시 USB 명령
  • 일부 STM32 Nucleo 보드에 탑재됨
• STLINK-V3
  • 전송 계층: 원시 USB 명령
  • 독립형 프로그래머(STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • 일부 STM32 Nucleo 보드(STLINK-V3E)에 온보드

사용자 수준에서는 이러한 서로 다른 개정판 간의 처리 또는 작동에 차이가 없습니다.

STlink 도구 세트에는 다음이 포함됩니다.

• st-info - 프로그래머 및 칩 정보 도구
• st-flash - 플래시 조작 도구
• st-trace - 실행 정보를 기록하는 로깅 도구
• st-util - GDB 서버(Cortex-Debug 플러그인을 통해 Visual Studio Code/VSCodium에서 지원됨)
• stlink-lib - 통신 라이브러리
• stlink-gui - GUI 인터페이스 [선택 사항]

지원되는 운영 체제 및 하드웨어 조합

현재 알려진 작동 중인 MCU 대상은 Supported_devices.md에 나열되어 있습니다.

지원되는 운영 체제 목록은 version_support.md에서 확인할 수 있습니다.

튜토리얼 및 하우투

우리의 튜토리얼은 몇 가지 고급 작업 및 추가 정보와 함께 도움이 될 수 있습니다.

설치

윈도우 :

릴리스 v1.6.1부터 독립 실행형 Windows 바이너리는 프로젝트의 릴리스 페이지에서 (다시) 사용할 수 있습니다. 시스템에 맞는 올바른 버전(i686 또는 x86_64)을 선택하십시오. 아카이브 파일에는 하드코드된 경로가 포함되어 있지 않으므로 원하는 위치에 압축을 풀 수 있습니다. 그러나 압축을 푼 응용 프로그램 폴더를 32비트 시스템에서는 C:Program Files 로 이동하고 64비트 시스템에서는 C:Program Files (x86) 로 이동하는 것이 좋습니다(도구 세트는 32비트).

또는 컴파일 매뉴얼에 설명된 대로 소스에서 컴파일하고 설치할 수도 있습니다.

리눅스/유닉스 :

사용된 배포판의 패키지 저장소에서 stlink-tools 설치하는 것이 좋습니다.

참고: Debian 및 Ubuntu 리포지토리를 통해 배포되는 패키지는 자체 유지 관리되는 deb 패키지와 다르므로 대신 후자를 사용하는 것이 좋습니다(아래 링크 참조). 이는 프로젝트 내에서 직접 사용자가 보고한 패키지 문제를 처리하고 수정할 수 있는 기회를 제공하며 외부 유지 관리 지침에서 파생되는 제한 사항과 중복되지 않습니다.

• 데비안 리눅스: (링크)
• 우분투 리눅스: (링크)
• 아치 리눅스: (링크)
• 알파인 리눅스: (링크)
• 페도라: (링크)
• FreeBSD: 사용자는 freshports에서 설치할 수 있습니다.

macOS :

v1.8.0에서는 macOS에 대한 지원이 중단되었습니다.

대신 v1.7.0을 사용하세요. 하지만 이 버전은 더 이상 유지 관리 및 지원되지 않습니다!

소스에서 설치(고급 사용자)

플랫폼에 사용할 수 있는 실행 파일이 없거나 최신(불안정할 수 있음) 버전이 필요한 경우 도구 세트를 직접 컴파일해야 합니다. 이 절차는 컴파일 매뉴얼에 설명되어 있습니다.

기여 및 버전 관리

• 의미론적 버전 관리 체계가 사용됩니다. semver.org에서 자세한 내용을 읽어보세요.
• 끌어오기 요청을 생성하기 전에 항상 의도된 새 기능에 대한 논의를 위해 새 이슈를 열어주세요. 버그 수정에는 티켓 문제를 통한 논의가 필요하지 않습니다. 그러나 다른 사람들에게도 도움이 되는 것처럼 보이면 항상 몇 단어로 설명해야 합니다.
• 기여자 및/또는 유지관리자는 의견을 제출하거나 패치 제안 및/또는 풀 요청에 대한 변경을 요청할 수 있습니다.
• 주의: 절대로 '#' 문자를 사용하여 목록 내의 단일 포인트를 계산하지 마십시오 . '#'은 GitHub 문제 및 풀 요청을 참조하기 위해 독점적 으로 예약되어 있습니다. 그렇지 않으면 실수로 프로젝트 내에 잘못된 상호 참조가 도입됩니다.
• 끌어오기 요청도 이 분기로 이동하므로 개발 분기에서 새 포크를 시작하세요.

기여 가이드라인도 참조하세요.

사용자 리뷰

주제에서 벗어나지 않았으면 좋겠지만, 저는 OpenBSD의 AVR 관련 것들 때문에 너무 답답했습니다. 아무것도 건드릴 필요 없이 stlink가 기본적으로 구축되었다는 사실이 너무 안도감을 느꼈습니다. 말 그대로 내 주말 전체를 더 좋게 만들었습니다! "주요" OS에 비우호적이지 않은 소프트웨어를 만든 것은 @Crest와 stlink-org 팀(@Nightwalker-87 및 @xor-gate인 것 같습니다) 덕분입니다. 감사합니다 <3" - nbonfils, 2021년 11월 12일