Artefakt probe-rs
Prenosná binárna distribúcia probe-rs-tools, sady nástrojov na ladenie embedded cieľov ARM a RISC-V cez debug probe (probe-rs, cargo-flash, cargo-embed, DAP server). Tento repozitár využíva Embedbits Platform Artifact Handler na vyhľadanie, stiahnutie, overenie a konfiguráciu probe-rs v následných embedded projektoch.
Tento repozitár je rozdelený do troch vetiev/referencií podľa úlohy — vetva main (master), ktorú práve čítate, obsahuje iba túto dokumentáciu; skripty handlera sú vo vetve Core a verzované binárky sa publikujú ako GitHub Releases ukotvené vo vetve Bin.
Obsah repozitára
main / master
└── README.md ← This document — no other content
Core
├── ArtifactConfig.cmake ← Artifact metadata (name, version constraints, asset naming)
└── CMakeProbeRsDefaults.cmake ← probe-rs integration logic (artifact init, version lookup)
Bin (anchor branch — no tracked binary files)
└── (empty commits only; each release tag points here)
Úloha v platforme
Tento repozitár je jednou z viacerých distribúcií artefaktov v platforme Embedbits. Celkový tok vyzerá takto:
GitHub (Embedbits)
──────────────────────────────────────────────────────────
Artifact-probe-rs
main / master → README only (this document)
Core → ArtifactConfig.cmake, CMakeProbeRsDefaults.cmake
Bin → Anchor branch (empty commits)
Releases → probe-rs-<version>-<platform>.zip + .hash
tagged Bin/<version>-<platform> (platform: Win / Unix / DarwinARM)
ProbeRsImporter.sh publikuje každú verziu probe-rs ako GitHub Release — označené Bin/<version>-<platform> — namiesto súboru commitnutého do vetvy Bin. Samotná vetva Bin obsahuje iba prázdne kotviace commity, na ktoré ukazujú značky vydaní.
Platform Artifact Handler v následných projektoch odkazuje na vetvu Core ako na Git submodul. Počas konfigurácie CMake načíta ArtifactConfig.cmake, aby zistil, ktoré vydanie sa má stiahnuť, a potom stiahne a overí zodpovedajúci asset vydania pre aktuálnu platformu.
Štruktúra vetiev
| Vetva / referencia | Obsah |
|---|---|
main / master | Iba toto README — žiadny funkčný obsah |
Core | Skripty handlera CMake (ArtifactConfig.cmake, CMakeProbeRsDefaults.cmake) na použitie artefaktu |
Bin | Iba kotviaca vetva — nie sú v nej commitnuté žiadne binárky |
Značka vydania Bin/<version>-<platform> | GitHub Release, ktoré ako assety vydania nesie samotnú binárku .zip a súbor s kontrolným súčtom .hash, pre platform ∈ Win, Unix, DarwinARM |
Poznámka: Samotný protokol Embedbits Artifact Handler nie je viazaný na GitHub Releases — len importovacie skripty hostované na GitHube publikujú binárky práve takto. Na Git hostingu bez ekvivalentného Releases API handler podporuje aj zabalené binárky commitnuté priamo ako sledované súbory vo vetve
Bin, označené značkou pre každú verziu/platformu (Bin/<version>-<platform>), namiesto nahrania ako assety vydania. Handler CMake transparentne spracuje obe formy.
⚠️ Stiahnutie vydania
Binárky nie sú uložené ako sledované súbory vo vetve Bin — skripty handlera získate klonovaním vetvy Core a binárky sťahujte ako assety vydania pre konkrétnu značku namiesto klonovania vetvy Bin.
# Core handler scripts
git clone --branch Core --single-branch --depth=1 <repository_url> probe-rs-core
# Binary + checksum for one specific version/platform (GitHub Release asset)
gh release download Bin/0.32.0-Unix --repo Embedbits/Artifact-probe-rs --pattern "probe-rs-0.32.0-Unix.*"
Súčasti balíka
| Komponent | Popis |
|---|---|
probe-rs | Hlavné CLI: flashovanie, spúšťanie, RTT, GDB server, DAP server, REPL debuggera |
cargo-flash | Podpríkaz Cargo na zostavenie a flashnutie obrazu firmvéru |
cargo-embed | Podpríkaz Cargo na zostavenie, flashnutie a spustenie s interaktívnou reláciou (RTT, defmt, GDB) |
Použitie
Artefakt sa inštaluje automaticky počas fázy nastavenia artefaktov príkazom:
cmake -P Artifacts/ProbeRs/ArtifactConfig.cmake
Skript zabezpečí, že binárky probe-rs sú dostupné, v prípade potreby rozbalí archív a pridá nástroj do systémovej PATH pre nasledujúce kroky buildu/flashovania.
Funkcie handlera
ProbeRs_ArtifactInit(ARTIFACT_BIN_PATH)
Inicializuje artefakt: nájde (alebo stiahne) binárky probe-rs-tools a sprístupní ich adresár bin/ v ARTIFACT_BIN_PATH.
ProbeRs_GetArtifactVersion()
Vráti verziu aktuálne vyriešených binárok probe-rs-tools.
Verzovanie
Verzie artefaktu zodpovedajú priamo oficiálnym verziám vydaní probe-rs:
0.29.0, 0.30.0, 0.31.0, 0.32.0, ...
Nové verzie publikuje ProbeRsImporter.sh v repozitári GithubArtifactsHandler, ktorý stiahne oficiálne binárky probe-rs-tools, zabalí ich do archívov .zip s overením SHA-256 a publikuje ich ako GitHub Release označené Bin/<version>-<platform> — samotná vetva Bin sa posúva iba prázdnym kotviacim commitom, na ktorý značka ukazuje.
Poznámky
- Inštalácia nie je potrebná — binárky sú prenosné a samostatné.
- Offline použitie je podporované, keď je artefakt lokálne v cache.
- V Azure DevOps pipeline sa odporúča cachovať priečinok artefaktu, aby sa skrátil čas buildu.
Licencia
probe-rs sa distribuuje pod licenciou MIT / Apache License 2.0 (duálne licencovaný). Podrobnosti nájdete na: https://github.com/probe-rs/probe-rs/blob/master/LICENSE-MIT
Autori
- Mr.Nobody — embedbits.com
Príspevky sú vítané! Otvorte prosím pull request.