Uploading UF2 files with macOS 13.0 Ventura (fixed in 13.1) @Apple @microbit_edu @Raspberry_Pi @circuitpython

UPDATE: This problem has been fixed in macOs Ventura release 13.1.

 

It is still the case that UF2 uploading does not work on nRF52840 boards that use an older UF2 bootloader (versions 0.6.2 and newer work). On those boards, the bootloader appears to fail quickly, allowing no time to copy the UF2. The bootloader can be updated by following the directions here. Otherwise, on these nRF52840 boards, including the Adafruit Circuit Playground Bluefruit, the Feather nRF52840, and the ItsyBitsy nRF52840, the only way to load a UF2 file is to use a non-Ventura computer.

It is also still true that copying .hex files larger than 1MB does not work (e.g., on the micro:bit). See https://github.com/ARMmbed/DAPLink/issues/982 for workarounds and further investigation.

 

The new macOS release 13.0 (Ventura), has trouble uploading files to “fake” USB drives that are used for firmware updates on microcontroller boards. These fake USB drives are presented by UF2 bootloaders and also ARMmbed DAPlink bootloaders. UF2 bootloaders take .uf2 files and are used on Adafruit boards, Raspberry Pi Pico boards, and many other manufacturer’s boards. ARMmbed DAPlink takes .hex files and is used on the micro:bit and other boards.

The problem is in the macOS Finder. Dragging a firmware file to the drive produces “error code 100093”. This error apparently occurs because the Finder is trying to copy extended attributes to the drive.

On some boards, you can work around the problem by copying the file using the command line in Terminal. Use the cp -X command (capital X). For example, to upload a Circuitpython UF2 file to a Raspberry Pi Pico, you would do:

% cp -X adafruit-circuitpython-raspberry_pi_pico-en_US-7.3.3.uf2 /Volumes/RPI-RP2

However, this workaround does not work on nRF52840 boards that use an older UF2 bootloader (versions 0.6.2 and newer work). On those boards, the bootloader appears to fail quickly. Copying a UF2 file does not work, which is indicated by the UF2 filename appearing in the BOOT drive. The bootloader can be updated by following the directions here. Otherwise, on these nRF52840 boards, including the Adafruit Circuit Playground Bluefruit, the Feather nRF52840, and the ItsyBitsy nRF52840, the only way to load a UF2 file is to use a non-Ventura computer.

The Raspberry Pi folks have posted a very thorough writeup of this problem on their blog: The Ventura Problem.

For further information and similar workarounds, see:

This problem has been reported to Apple. If it affects your work, we encourage you to report it too , using the macOS Feedback Assistant tool. There are complete instructions for using the tool in the Raspberry Pi blog post linked above. Mention the existing Feedback numbers in your report to help Apple link these reports together: FB11725030 (Raspberry Pi’s report), and FB11727161 (Adafruit’s).

This problem does not affect use of the CIRCUITPY drive once CircuitPython is running, or similar  drives such as MicroPython’s PYFLASH drive. It only affects fake drives like the UF2 bootloader drives.

Update: For non-UF2 files, cp -X may fail if the file is larger than 1MB, according to a comment in the ARMmed/DAPlink issue above . This is because macOS may write the data non-sequentially. In that case use the rsync command instead. This shouldn’t be a problem for UF2 files as the file format is designed to avoid such problems: each block stores its own address as well as the total number of blocks so non-sequential writes don’t matter.


Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here: adafruit.com/editorialstandards

Join Adafruit on Mastodon

Adafruit is on Mastodon, join in! adafruit.com/mastodon

Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on code.org, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.

Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7pm ET! To join, head over to YouTube and check out the show’s live chat – we’ll post the link there.

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Join over 36,000+ makers on Adafruit’s Discord channels and be part of the community! http://adafru.it/discord

CircuitPython – The easiest way to program microcontrollers – CircuitPython.org


Maker Business — “Packaging” chips in the US

Wearables — Enclosures help fight body humidity in costumes

Electronics — Transformers: More than meets the eye!

Python for Microcontrollers — Python on Microcontrollers Newsletter: Silicon Labs introduces CircuitPython support, and more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi

Adafruit IoT Monthly — Guardian Robot, Weather-wise Umbrella Stand, and more!

Microsoft MakeCode — MakeCode Thank You!

EYE on NPI — Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey

New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — #NewProds 7/19/23 Feat. Adafruit Matrix Portal S3 CircuitPython Powered Internet Display!

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at AdafruitDaily.com !



No Comments

No comments yet.

Sorry, the comment form is closed at this time.