Setting Up an Embedded Rust Development Environment

2026-08-04T00:00:00+00:00

When developing embedded applications with Rust, you will need to install a few tools on your computer.</p>

If you’ve already written Rust programs on your desktop, most of the setup is already done. We only need to add support for embedded targets and install a few additional tools for flashing and debugging firmware.</p>

https://rust-lang.org/tools/install/</a></p>

On Linux and macOS, you can install Rust by running:</p>

curl</span> --proto</span> '</span>=https</span>'</span> --tlsv1.2 -sSf</span> https://sh.rustup.rs</span> |</span> sh</span></span></code></pre>
On Windows, download and run the installer from the Rust website.</p>

    </div>
    
        TIP</strong>
        To be frank, if this is your first time learning Rust, I do not recommend jumping straight into Embedded Rust. Spend some time learning the basics of Rust first. It will make your Embedded Rust journey much easier.</p>
After all, I assume you chose Rust not because you just want to copy and paste code. You want to understand how things work, enjoy the learning process, and benefit from the safety that Rust provides.</p>

    </div>
</div>
Once the installation is complete, verify it by running:</p>
rustc</span> --version</span></span>
cargo</span> --version</span></span>
rustup</span> --version</span></span></code></pre>
You should see the installed versions printed on the screen.</p>
</span></a>
Install the ARM Cortex-M Target</h2>
Rust supports many embedded architectures, including ARM Cortex-M, RISC-V, and Xtensa.</p>
In this article, we’ll install the ARM Cortex-M targets, as they are used by many popular development boards such as the Raspberry Pi Pico, Raspberry Pi Pico W, Pico 2, and STM32 Blue Pill.</p>

    </div>
    
        NOTE</strong>
        If you’re developing for an ESP32 board, the setup process is slightly different because ESP32 uses a different architecture. You’ll need to install the appropriate Rust target and development tools.</p>
If you’re looking for a step-by-step guide, I also have a dedicated free book on Embedded Rust with ESP32</a>.</p>

    </div>
</div>
Different microcontrollers use different Cortex-M cores, so Rust provides a separate compilation target for each one.</p>
Some common targets are:</p>
Cortex-M Core</th> Rust Target</th></tr></thead>

Cortex-M0 / M0+</td> thumbv6m-none-eabi</code></td></tr>
Cortex-M3</td> thumbv7m-none-eabi</code></td></tr>
Cortex-M4 / M7</td> thumbv7em-none-eabi</code></td></tr>
Cortex-M4F / M7F</td> thumbv7em-none-eabihf</code></td></tr>
Cortex-M33</td> thumbv8m.main-none-eabihf</code></td></tr>
</tbody></table>
Install the target for boards based on the ARM Cortex-M0+ core, such as the Raspberry Pi Pico and Pico W.</p>
rustup</span> target add thumbv6m-none-eabi</span></span></code></pre>
Install the target for boards based on the ARM Cortex-M3 core, such as the STM32 Blue Pill (STM32F103).</p>
rustup</span> target add thumbv7m-none-eabi</span></span></code></pre>
Install the target for boards based on the ARM Cortex-M33 core with hardware floating-point support, such as the Raspberry Pi Pico 2 (RP2350).</p>
rustup</span> target add thumbv8m.main-none-eabihf</span></span></code></pre></span></a>
Install probe-rs</h2>
Once you’ve compiled your Embedded Rust application, you’ll need a way to flash it onto your development board and debug it. probe-rs</code>, a modern tool for flashing, debugging, and interacting with embedded microcontrollers.</p>
I recommend following the installation instructions on the official probe-rs website:</p>
https://probe.rs/docs/getting-started/installation/</a></p>
Once the installation is complete, verify it by running:</p>
probe-rs</span> --version</span></span></code></pre>
If the version is printed successfully, probe-rs is installed correctly.</p>
</span></a>
Install cargo-generate</h2>
When starting a new project, you’ll often need to create the same files and write the same configuration before you can begin writing code. cargo-generate</code> is a tool that helps to create a new project from a template, so you don’t have to set up everything manually.</p>
I normally use cargo-generate</code> to create new projects from templates. There are many templates available from the community, and once you’re familiar with the Rust ecosystem, you can create your own templates, store them in a Git repository or local directory, and use them to generate future projects.</p>
Install it by running:</p>
cargo</span> install cargo-generate</span></span></code></pre>
Verify the installation by running:</p>
cargo</span> generate</span> --version</span></span></code></pre></span></a>
Install cargo-binutils (Optional)</h2>
cargo-binutils</code> provides additional commands for inspecting compiled binaries. It can display firmware size, disassemble machine code, and inspect symbols.</p>
While it isn’t required for Embedded Rust development, it can be useful when debugging or exploring what the compiler generated.</p>
Install it by running:</p>
cargo</span> install cargo-binutils</span></span>
rustup</span> component add llvm-tools</span></span></code></pre>
That’s it! Your Embedded Rust development environment is now ready.</p>

Cortex-M Core</th>	Rust Target</th></tr></thead>
Cortex-M0 / M0+</td>	`thumbv6m-none-eabi</code></td></tr>`
Cortex-M3</td>	`thumbv7m-none-eabi</code></td></tr>`
Cortex-M4 / M7</td>	`thumbv7em-none-eabi</code></td></tr>`
Cortex-M4F / M7F</td>	`thumbv7em-none-eabihf</code></td></tr>`
Cortex-M33</td>	thumbv8m.main-none-eabihf</code></td></tr> </tbody></table> Install the target for boards based on the ARM Cortex-M0+ core, such as the Raspberry Pi Pico and Pico W.</p> rustup</span> target add thumbv6m-none-eabi</span></span></code></pre> Install the target for boards based on the ARM Cortex-M3 core, such as the STM32 Blue Pill (STM32F103).</p> rustup</span> target add thumbv7m-none-eabi</span></span></code></pre> Install the target for boards based on the ARM Cortex-M33 core with hardware floating-point support, such as the Raspberry Pi Pico 2 (RP2350).</p> rustup</span> target add thumbv8m.main-none-eabihf</span></span></code></pre></span></a> Install probe-rs</h2> Once you’ve compiled your Embedded Rust application, you’ll need a way to flash it onto your development board and debug it. probe-rs</code>, a modern tool for flashing, debugging, and interacting with embedded microcontrollers.</p> I recommend following the installation instructions on the official probe-rs website:</p> https://probe.rs/docs/getting-started/installation/</a></p> Once the installation is complete, verify it by running:</p> probe-rs</span> --version</span></span></code></pre> If the version is printed successfully, probe-rs is installed correctly.</p> </span></a> Install cargo-generate</h2> When starting a new project, you’ll often need to create the same files and write the same configuration before you can begin writing code. cargo-generate</code> is a tool that helps to create a new project from a template, so you don’t have to set up everything manually.</p> I normally use cargo-generate</code> to create new projects from templates. There are many templates available from the community, and once you’re familiar with the Rust ecosystem, you can create your own templates, store them in a Git repository or local directory, and use them to generate future projects.</p> Install it by running:</p> cargo</span> install cargo-generate</span></span></code></pre> Verify the installation by running:</p> cargo</span> generate</span> --version</span></span></code></pre></span></a> Install cargo-binutils (Optional)</h2> cargo-binutils</code> provides additional commands for inspecting compiled binaries. It can display firmware size, disassemble machine code, and inspect symbols.</p> While it isn’t required for Embedded Rust development, it can be useful when debugging or exploring what the compiler generated.</p> Install it by running:</p> cargo</span> install cargo-binutils</span></span> rustup</span> component add llvm-tools</span></span></code></pre> That’s it! Your Embedded Rust development environment is now ready.</p>

impl Blog for Rust - cortex-m

Setting Up an Embedded Rust Development Environment