adafruit / adafruit/circuitpython-org
Need explanations for each of the available variants of bootloaders
- 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