Platform installation fails: "PROTOCOL_ERROR; received from peer"

[comet424]

Describe the problem

Installation of the "Silicon Labs" boards platform fails with the following error:

Downloading packages
SiliconLabs:gcc-arm-none-eabi@12.2.rel1
Failed to install platform: 'SiliconLabs:silabs:3.0.0'.
Error: 2 UNKNOWN: stream error: stream ID 1; PROTOCOL_ERROR; received from peer

It downloads half and then fails.

To reproduce

Run the following commands:

$ arduino-cli config set network.connection_timeout 0  # Disable Arduino CLI's timeout mechanism to exclude it as a factor.

$ arduino-cli core install SiliconLabs:silabs

Downloading packages
SiliconLabs:gcc-arm-none-eabi@12.2.rel1
Failed to install platform: 'SiliconLabs:silabs:3.0.0'.
Error: 2 UNKNOWN: stream error: stream ID 1; PROTOCOL_ERROR; received from peer

🐛 The download of the SiliconLabs:gcc-arm-none-eabi@12.2.rel1 tool dependency archive file failed.

Expected behavior

Platform installation is successful.

Arduino CLI version

Original report

1.2.0 (version used by Arduino IDE 2.3.6)

Last verified with

d5ef61d

Operating system

Windows

Operating system version

11

Additional context

The fault also occurs if I attempt to download the SiliconLabs:gcc-arm-none-eabi@12.2.rel1 archive directly:

$ wget https://github.com/SiliconLabs/arduino/releases/download/2.0.0/arm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst
--2025-09-19 13:29:23--  https://github.com/SiliconLabs/arduino/releases/download/2.0.0/arm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst
Resolving github.com (github.com)... 140.82.114.3
Connecting to github.com (github.com)|140.82.114.3|:443... connected.
HTTP request sent, awaiting response... 302 Found
Location: https://release-assets.githubusercontent.com/github-production-release-asset/740914384/3ef5ba22-f1a6-49c5-a095-8173db7547a5?sp=r&sv=2018-11-09&sr=b&spr=https&se=2025-09-19T21%3A27%3A21Z&rscd=attachment%3B+filename%3Darm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2025-09-19T20%3A26%3A32Z&ske=2025-09-19T21%3A27%3A21Z&sks=b&skv=2018-11-09&sig=2LQWc%2Bj5IO8tEwcnfI2eOF1%2B2PuaBy3VQzseOP3s2Wc%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc1ODMxNDA2MywibmJmIjoxNzU4MzEzNzYzLCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.zwVv9QrJvoNecrGI7xmVHvnIOQAAMqPkYmcXrBubH9g&response-content-disposition=attachment%3B%20filename%3Darm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst&response-content-type=application%2Foctet-stream [following]
--2025-09-19 13:29:24--  https://release-assets.githubusercontent.com/github-production-release-asset/740914384/3ef5ba22-f1a6-49c5-a095-8173db7547a5?sp=r&sv=2018-11-09&sr=b&spr=https&se=2025-09-19T21%3A27%3A21Z&rscd=attachment%3B+filename%3Darm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2025-09-19T20%3A26%3A32Z&ske=2025-09-19T21%3A27%3A21Z&sks=b&skv=2018-11-09&sig=2LQWc%2Bj5IO8tEwcnfI2eOF1%2B2PuaBy3VQzseOP3s2Wc%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc1ODMxNDA2MywibmJmIjoxNzU4MzEzNzYzLCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.zwVv9QrJvoNecrGI7xmVHvnIOQAAMqPkYmcXrBubH9g&response-content-disposition=attachment%3B%20filename%3Darm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst&response-content-type=application%2Foctet-stream
Resolving release-assets.githubusercontent.com (release-assets.githubusercontent.com)... 185.199.108.133, 185.199.109.133, 185.199.110.133, ...
Connecting to release-assets.githubusercontent.com (release-assets.githubusercontent.com)|185.199.108.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 279987372 (267M) [application/octet-stream]
Saving to: 'arm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst'

arm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst       67%[========================================================================================================>                                                   ] 180.00M   220KB/s    in 11m 4s  

2025-09-19 13:40:28 (278 KB/s) - Connection closed at byte 188743680. Retrying.

--2025-09-19 13:40:29--  (try: 2)  https://release-assets.githubusercontent.com/github-production-release-asset/740914384/3ef5ba22-f1a6-49c5-a095-8173db7547a5?sp=r&sv=2018-11-09&sr=b&spr=https&se=2025-09-19T21%3A27%3A21Z&rscd=attachment%3B+filename%3Darm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2025-09-19T20%3A26%3A32Z&ske=2025-09-19T21%3A27%3A21Z&sks=b&skv=2018-11-09&sig=2LQWc%2Bj5IO8tEwcnfI2eOF1%2B2PuaBy3VQzseOP3s2Wc%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc1ODMxNDA2MywibmJmIjoxNzU4MzEzNzYzLCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.zwVv9QrJvoNecrGI7xmVHvnIOQAAMqPkYmcXrBubH9g&response-content-disposition=attachment%3B%20filename%3Darm-gnu-toolchain-12.2.rel1-mingw-w64-i686-arm-none-eabi.zst&response-content-type=application%2Foctet-stream
Connecting to release-assets.githubusercontent.com (release-assets.githubusercontent.com)|185.199.108.133|:443... connected.
HTTP request sent, awaiting response... 618 jwt:expired
2025-09-19 13:40:30 ERROR 618: jwt:expired.

---

Associated forum discussion: https://forum.arduino.cc/t/need-help-to-manually-install-seeeds-board-package/1406769

Additional reports

• https://forum.arduino.cc/t/cannot-install-stm32-nor-esp32-boards-to-arduino-ide-1-8-19/1405156
• https://forum.arduino.cc/t/espressif-board-manager-3-3-0-fails/1405287
• https://forum.arduino.cc/t/unable-to-install-stm32-based-boards/1406610

Related

• Attempt to resume file download from point of previous failure #1780
• Platform installation fails: "PROTOCOL_ERROR" #2973
• [request] Optimize library size (arduino-cli fails install with default timeout) SiliconLabs/arduino#151

Issue checklist

• I searched for previous reports in the issue tracker
• I verified the problem still occurs when using the latest nightly build
• My report contains all necessary details

[per1234]

Thanks for your report @comet424. The failure is caused by a change that GitHub recently made to how downloads of GitHub release assets are handled, as discussed here:

https://github.com/orgs/community/discussions/169381

GitHub recently reduced the expiration time set for the token that is used to download these files. The expiration is now set for five minutes after the initiation of the download. This means that the download is intentionally failed if it takes longer than ~5 minutes (there is apparently some leeway on the enforcement of the expiration).

The maintainers of the "Silicon Labs" boards platform chose to use a GitHub release asset to distribute the file that is failing to download and thus causing the platform installation to fail.

This means that the ability to successfully install a boards platform that depends on files hosted as GitHub release assets is dependent on the speed of your Internet connection. If the file can't be downloaded within five minutes, the platform installation fails with this "UNKNOWN: stream error: stream ID 1; PROTOCOL_ERROR; received from peer" error. It seems your Internet connection is too slow to download this file before the expiration of the token (mine is also).

This also means that anyone with a fast Internet connection will not be able to reproduce the fault.

Workaround

There are a couple of possible workarounds. I'll describe them below:

Free Up Bandwidth

If there are other uses of your Internet connection at the same time as you attempt the platform installation, the resulting reduction in the speed of the Internet connection available for the file download might mean the difference between the download completing in under or over five minutes.

So stop any other significant Internet usages (or wait until they are finished), then try installing the platform again, just as you did before. Hopefully it will be successful now. If not, try one of the other workarounds below.

Use a Faster Internet Connection

If you have access to an alternative Internet connection that has a higher download speed, switch to using that Internet connection, then attempt the platform installation once again.

You can switch back to the previous Internet connection after completing the installation.

Manually Download File

You can work around the problem by manually downloading the file using a tool that is capable of resuming downloads after a token expiration, then placing that file in the folder where Arduino IDE caches downloaded files. If the file is already present in the "downloads folder", Arduino IDE/Arduino CLI will use that file for the installation instead of downloading it. So this is an effective workaround.

If you already have a suitable download manager tool

If you already have a tool with that resumption capability (as it appears you do), then feel free to use that tool.

The general procedure is as follows:

1. Download the file.
2. Copy the file to the folder at the following path on your hard drive:
   • If you are using Linux:

     /home/<username>/.arduino15/staging/packages
     

     (Where <username> is your Linux username)
     ❗ The .arduino15 folder may be hidden by default in your file manager and terminal.
   • If you are using macOS:

     /Users/<username>/Library/Arduino15/staging/packages
     

     (Where <username> is your macOS username)
     ❗ The Library folder is hidden by default. You can make it visible by pressing the Command+Shift+. keyboard shortcut.
   • If you are using Windows:

     C:\Users\<username>\AppData\Local\Arduino15\staging\packages
     

     (Where <username> is your Windows username)
     ❗ If looking for it with your file manager or command line, note that the AppData folder is hidden by default. On Windows "File Explorer", you can make it visible by opening the "View" menu, then checking the box next to "☐ Hidden items".
3. Install the platform again using the Arduino IDE Boards Manager (or arduino-cli core install for Arduino CLI users).

If you do not already have a suitable download manager tool

The Google Chrome web browser does have some form of download resumption capability, but I actually haven't had any success when I tried to use it to resume downloads of the file. When I click "Resume" on the failed download, it immediately fails again with a "Site wasn't available" error (if I do it via the menu of the "Downloads" icon on the browser toolbar), or "Failed - Unknown server error. Please try again, or contact the server administrator." (if I do it via Chrome's "Downloads" page). I believe this is due to the fact that GitHub redirects the initial download URL to a temporary URL that is authenticated with the JWT token, and Chrome isn't smart enough to resume this type of download.

I am able to resume the failed download when I perform the download using using curl --continue-at - --location --remote-name.

I was also able to resume the download using wget --continue.

If you don't already have a download manager tool that supports resuming these downloads, I will suggest you use curl as, unlike Wget, this is preinstalled in Windows. I'll provide instructions you can follow to do that:

1. Right click the Windows "Start" button.
   A context menu will open.
2. Select "Search" from the menu.
   The Windows "Start" menu will open with a search field selected.
3. Type windows powershell ise in the search field.
4. Select "Windows PowerShell ISE" from the search results.
   A "Windows PowerShell ISE" window will open.
5. Type the following command in the Windows PowerShell ISE window:

   curl.exe --continue-at - --location --output-dir "$Env:LOCALAPPDATA\Arduino15\staging\packages" --remote-name https://github.com/SiliconLabs/arduino/releases/download/3.0.0/silabs_arduino_core-3.0.0.zst
   

6. Press the Enter key.
   The file download will now start.
7. Monitor the progress of the file download. After approximately five minutes have passed, it will exit with a message something like, which indicates that the download was not successful:

   curl: (18) end of response with 35384341 bytes missing
   

8. Repeat steps 5-7.
   The file download will now resume. Something that might be confusing is that the progress indicator only shows the progress during the current download attempt. The lack of a sign of the progress from the previous download attempt makes it seem like it started the download over from scratch rather than resuming. However, you will know it has indeed resumed because the command will print a message something like:

   ** Resuming transfer from byte position 111658240
   

9. Hopefully after the second attempt, the upload will complete, as indicated by the lack of a "curl: (18) end of response with \_\_\_ bytes missing" message when the command exits. However if it still didn't complete, you can simply repeat steps 5-7 as many times as it takes for the file to download completely.

After that, try installing the "Silicon Labs" platform via the Arduino IDE Boards Manager again, just as you did before. Hopefully this time it will be successful, as it will use the existing file you downloaded using curl instead of attempting to download it from the Internet.

---

❗ The problem also affects other boards platforms (e.g., "esp32", "STM32 MCU based boards").

Although the same general procedure can be used to workaround the problem for any platform, the above instructions contain parts that are specific to the "Silicon Labs" platform, and also specific to one of the multiple large files that must be downloaded to install that platform. They are also specific to Windows users.

If anyone is experiencing this problem with other files, platforms, or using other operating systems, just post on Arduino Forum and we'll provide the appropriate instructions there:

https://forum.arduino.cc/c/development-tools/arduino-cli/89

---

[comet424]

@per1234 hi ok ya there is no way i can download in 5 min.. that 600 meg file when you click on that link took 30 min or so my internet is only 3 megabit i live in the country so we cant get high speed.. no 1gb i just get 3 megabit if i lucky

so i did download there file and i placed it in the one folder but i followed youtube video but it didnt work where you place it in the
C:\Users<username>\AppData\Local\Arduino15\staging\packages

but it did nothing and apparently i posted that information i copied it but it seems to be deleted from my post... where i can download it from Github but i also use sometimes Download with the Internet Download Manager

also my comment i installed ide 2.2.1 and then 2.3.6 went missing too i had done what the videos said to fix the issue.. some how all my text went missing that i tried

i had followed the guys video but here is what i did

but you mentioned the folder goes into the staging packages.. did i even download the right file too? as its 600 meg zipped unzipped that folder is 1.84gb so i just put it in the staging location..
but ya this is bs as i had to use the Internet Download Manager to download it... so that means like Home Asistant that downloads from Github too that means my home assistant will have issues too?

[comet424]

oh and i had posted the link to the linke i used to download yet my article is all missing

but did i download the right file?
i went to
https://github.com/SiliconLabs/arduino

and then i clicked CODE and downloaded the Zip file..

and i copyed the zip file arduino-main.zip to that staging folder but when i load up ardunio ide and goto the board manager the seeed board didnt install and i click install and just downloading again

so i must have not downloaded the right file i take it?

here is the file in the stagging packages

[per1234]

but did i download the right file?

No, you did not. This is not an appropriate place to provide support. Please post over on Arduino Forum. I will see your post there and will be happy to provide support:

https://forum.arduino.cc/c/development-tools/ide-2-x/93

my article is all missing

I had to rewrite your issue because it was not of sufficient quality to allow the developers to efficiently evaluate and act on it. Please make a stronger effort in the future.

[comet424]

ah here i thought i did ok that i explained things right..

if you happened to be a an admin on the Arduino forum i tried to post on there .. but my username is reserved cuz it was deleted for in activitity and i cant re use my email with my username

guess ill try to make a new account.. but ok ill post over there

[per1234]

GitHub reports that they took measures to fix the problem:

https://github.com/orgs/community/discussions/169381#discussioncomment-14582859

I tested the download and found that the failure no longer occurs, even though the download took 12 minutes.

So I will close this as resolved. If anyone still encounters the "PROTOCOL_ERROR; received from peer" error when installing a platform, please comment here and we'll investigate further.

We are still tracking the request for providing a general purpose download resumption capability at #1780 (which might be useful for download failures caused by other problems, even if this specific problem has been solved by GitHub).