stlink

Versi open source dari STMicroelectronics STLINK Tools

Fitur baru dan perbaikan bug terkini dapat ditemukan di Changelog proyek perangkat lunak ini.

Lisensi

Pustaka dan alat stlink dilisensikan di bawah Lisensi BSD-3 .

Perkenalan

stlink adalah perangkat sumber terbuka untuk memprogram dan men-debug perangkat dan papan STM32 yang diproduksi oleh STMicroelectronics. Ini mendukung beberapa papan pemrogram STLINK (dan klonnya) yang menggunakan chip mikrokontroler untuk menerjemahkan perintah dari USB ke JTAG/SWD. Ada empat generasi yang tersedia di pasaran yang semuanya didukung oleh perangkat ini:

• STLINK/V1 [usang mulai 21-11-2019, dukungan lanjutan dari perangkat ini]
  • lapisan transport: perintah passthru SCSI melalui USB
  • pemrogram yang berdiri sendiri
  • terpasang pada papan Discovery STM32VL
• STLINK/V2
  • lapisan transport: perintah USB mentah
  • pemrogram yang berdiri sendiri
  • terpasang pada papan STM32L Discovery dan STM32 Nucleo
• STLINK/V2-1
  • lapisan transport: perintah USB mentah
  • on-board pada beberapa papan Nukleo STM32
• STLINK-V3
  • lapisan transport: perintah USB mentah
  • pemrogram yang berdiri sendiri (STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • on-board pada beberapa papan Nukleo STM32 (STLINK-V3E)

Pada tingkat pengguna tidak ada perbedaan penanganan atau pengoperasian antar revisi yang berbeda tersebut.

Perangkat STlink meliputi:

• st-info - alat informasi programmer dan chip
• st-flash - alat manipulasi flash
• st-trace - alat logging untuk mencatat informasi eksekusi
• st-util - server GDB (didukung dalam Visual Studio Code/VSCodium melalui plugin Cortex-Debug)
• stlink-lib - perpustakaan komunikasi
• stlink-gui - Antarmuka GUI [opsional]

Sistem operasi dan kombinasi perangkat keras yang didukung

Target MCU yang berfungsi saat ini tercantum disupport_devices.md.

Daftar operasi yang didukung dapat ditemukan di version_support.md.

Tutorial & CARA

Tutorial kami dapat membantu Anda dengan beberapa tugas lanjutan dan info tambahan.

Instalasi

jendela :

Pada Rilis v1.6.1 binari Windows yang berdiri sendiri tersedia (lagi) di halaman rilis proyek. Harap pastikan untuk memilih versi yang benar untuk sistem Anda (i686 atau x86_64). File arsip dapat dibuka ritsletingnya ke lokasi mana pun yang diinginkan karena tidak berisi jalur hardcode apa pun. Namun kami menyarankan untuk memindahkan folder aplikasi yang belum di-zip ke C:Program Files pada sistem 32-bit dan ke C:Program Files (x86) pada sistem 64-bit (perangkatnya adalah 32-bit).

Sebagai alternatif, seseorang dapat mengkompilasi dan menginstal dari sumber seperti yang dijelaskan dalam manual kompilasi kami.

Linux/Unix :

Kami merekomendasikan untuk menginstal stlink-tools dari repositori paket distribusi yang digunakan:

Catatan: Karena paket yang didistribusikan melalui repositori Debian dan Ubuntu berbeda dengan paket deb yang kami kelola sendiri, kami merekomendasikan untuk menggunakan paket deb yang kami kelola sendiri (lihat tautan di bawah). Hal ini memberikan peluang untuk menangani dan memperbaiki masalah paket yang dilaporkan pengguna secara langsung dalam proyek dan tidak berlebihan terhadap batasan apa pun yang berasal dari pedoman pemeliharaan eksternal.

• Debian Linux: (Tautan)
• Ubuntu Linux: (Tautan)
• Arch Linux: (Tautan)
• Alpine Linux: (Tautan)
• Fedora: (Tautan)
• FreeBSD: Pengguna dapat menginstal dari freshports

macOS :

Dukungan untuk macOS telah dihentikan dengan v1.8.0.

Silakan gunakan v1.7.0 sebagai gantinya, namun perhatikan bahwa versi ini tidak lagi dikelola dan didukung!

Instalasi dari sumber (pengguna tingkat lanjut)

Ketika tidak ada executable yang tersedia untuk platform Anda atau Anda memerlukan versi terbaru (mungkin tidak stabil), Anda perlu mengkompilasi sendiri perangkat tersebut. Prosedur ini dijelaskan dalam manual kompilasi.

Berkontribusi dan membuat versi

• Skema pembuatan versi semantik digunakan. Baca lebih lanjut di semver.org
• Sebelum membuat pull request, harap SELALU membuka terbitan baru untuk diskusi tentang fitur baru yang dimaksud. Perbaikan bug tidak memerlukan diskusi melalui masalah tiket. Namun hal tersebut harus selalu dijelaskan dalam beberapa kata segera setelah hal tersebut tampak membantu orang lain juga.
• Kontributor dan/atau pengelola dapat mengirimkan komentar atau meminta perubahan pada proposal patch dan/atau permintaan penarikan.
• PERHATIAN: JANGAN PERNAH menggunakan karakter '#' untuk menghitung satu poin dalam daftar karena '#' secara eksklusif disediakan untuk merujuk masalah GitHub dan permintaan tarik. Jika tidak, Anda secara tidak sengaja memasukkan referensi silang palsu ke dalam proyek.
• Silakan mulai fork baru dari cabang pengembangan, karena permintaan tarik akan masuk ke cabang ini juga.

Silakan lihat juga Pedoman Kontribusi kami.

Ulasan Pengguna

Saya harap ini tidak keluar dari topik, tapi saya sangat frustrasi dengan hal-hal yang berhubungan dengan AVR di OpenBSD, fakta bahwa stlink dibuat langsung tanpa perlu menyentuh apa pun sangatlah melegakan. Benar-benar membuat seluruh akhir pekan saya lebih baik! Saya berterima kasih kepada @Crest dan juga kepada tim stlink-org (@ Nightwalker-87 dan @ xor-gate tampaknya) telah membuat perangkat lunak yang tidak ramah terhadap OS "pinggiran". Terima kasih <3" - nbonfils, 12-11-2021