adafruit / adafruit/circuitpython-org

Need explanations for each of the available variants of bootloaders

Offen
#1,455 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
website-content
Vorherrschende Sprache
HTML
Sterne
170
Forks
754
Ø Merge
1 T. 3 Std.
Gemergte PRs (30 T.)
6

Beschreibung

This might not be the best channel for reporting this issue, but I can't think of a better one. I'm using the MatrixPortal S3 merely as an example here, but the same need applies to any target.

I'm running into some issues flashing an Adafruit board I have. One of the things I have to do is install a UF2 bootloader. The problem is, the official bootloader download page (https://circuitpython.org/board/adafruit_matrixportal_s3/) offers a zip file for the bootloader firmware with seven different files. The instructions on the page say to install `combined.bin`.

* What are all the other files? The learning page references `tinyuf2_combo.bin`. How is this different from `combined.bin`?
* When flashing with `esptool.py`, should I flash `.uf2` or `.bin` files?
* What's the precise relationship between the Bootloader and CircuitPython itself?

Even if this information can't be robustly summarized on the specific download page, a link to the GitHub repo that generates the binaries would be helpful, and perhaps that repo could have comprehensive explanations of all the build artifacts.

As it is, you have to read dozens of pages on different sites to hopefully glean a partial understanding.

bootloader.bin
combined.bin
ota_data_initial.bin
partition-table.bin
partitions-8MB.csv
tinyuf2.bin
update-tinyuf2.uf2

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Rechercherichtung

Beginne mit der MatrixPortal S3-Downloadseite und den dort aufgeführten Artefakten: bootloader.bin, combined.bin, ota_data_initial.bin, partition-table.bin, partitions-8MB.csv, tinyuf2.bin und update-tinyuf2.uf2. Verfolge das verlinkte Repository zum Bootloader-Build und dokumentiere anschließend jedes Artefakt, die Auswahl der esptool.py-Datei und die Beziehung zwischen dem Bootloader und CircuitPython; abgeschlossen ist die Arbeit, wenn Leser nicht mehr viele externe Seiten konsultieren müssen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
documentation, embedded-iot
Issue-Typ
Dokumentation
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.