--- title: About MCU Firmware slug: one/mcu-firmware/about docTags: createdAt: 2026-06-10T18:09:42.876Z --- This page explains the structure of the MCU Firmware sub-project, provides links to all the resources and explains how to contribute to the sub-project. ![MCU Firmware on Flipper One](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/Qo3kaAU_6M-wft3oYpOvR_mcu-flipper-one.png) Flipper One has two processors. The low-power MCU (RP2350) manages power, the display, button and touchpad input, and Power Bank mode. The high-performance CPU runs Linux and handles user applications, networking, high-speed peripherals (USB3, PCIe), AI acceleration (NPU), and graphics output (HDMI, DisplayPort). The MCU Firmware sub-project consists of: - βœ… [Task tracker](https://github.com/orgs/flipperdevices/projects/8) - πŸ“ [Firmware sources](https://github.com/flipperdevices/flipperone-mcu-firmware) - 🏭 [Firmware update server](https://update.flipperzero.one/builds/flipper-one-mcu/dev/) We'd love your feedback β€” look for tasks tagged **help wanted** in the task tracker, or contribute directly to the GitHub repository via pull requests. ![MCU firmware subproject structure](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/NP2WYNeZPZ3SOAr_X3ZpN_mcu-firmware-subproject-structure.jpg) *** ## βœ… Task tracker All MCU Firmware team tasks are tracked in the GitHub project [Flipper One β€” MCU Firmware](https://github.com/orgs/flipperdevices/projects/8). There, you can see what the engineering team is working on and follow progress and discussions. ![MCU Firmware sub-project task tracker on GitHub](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/xRZg9xEjQ4OfcwEdkLXmt_mcu-firmware-board-explainer.png "MCU Firmware sub-project task tracker on GitHub") **Some tasks are open** to the community and marked with a **help wanted** label. You’re welcome to join the discussion on these tasks or submit your design proposals. *** ## πŸ“ Firmware sources This sub-project includes a public [MCU Firmware](https://github.com/flipperdevices/flipperone-mcu-firmware) GitHub repository containing RP2350 firmware sources. You can [build the firmware](docId\:rPL7t5P9mlahA2PNMzj63) locally from sources. The resulting `.UF2` firmware file can be flashed to the MCU via USB by following the instructions in [Firmware update](docId\:hyJBtrZpTqlR9GQlxOXxB). Learn more about the firmware architecture on the [Firmware architecture](docId\:Vju8IFfx0zjqxiWgWEQHO) page. *** ## πŸ”„ Firmware update server Every merge into the `dev` branch, as well as every pull request in the firmware repository, triggers an automated build on the firmware build server and uploads `.UF2` files to the [Firmware Update Server](https://update.flipperzero.one/builds/flipper-one-mcu/dev/). ![MCU firmware update server](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/FHlj3xjtvxCSh6HzyJgyH_mcu-firmware-update-server.png "MCU firmware build server web interface") *** ## How to contribute The MCU Firmware sub-project accepts contributions in two forms: **issues and comments** to report bugs, propose features, or share ideas on existing tasks, and **pull requests for code changes** to the MCU firmware sources. See the [Contribution guide](https://github.com/flipperdevices/flipperone-mcu-firmware/blob/dev/CONTRIBUTING.md) in the MCU Firmware repository for the full workflow, including issue handling, AI-assisted development rules, and PR conventions. β€Ž ### Comment on an open task or open a new issue :::hint{type="info"} **⚠️ Contributions only β€” no flooding** To keep collaboration productive, please keep issues and comments on-topic β€” they are for contribution-related discussion only. If you have an idea or concern, first turn it into a concrete contribution and share it as a comment on an existing task or as a new issue. For general questions or discussions, you're always welcome to join the conversation on [social media](https://x.com/Flipper_RND) or [Discord](https://discord.com/invite/flipper)! ::: ![Contribute a comment on an open task](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/mGixx9NyTNUXJZaGb-pS9_cpu-contribute-a-comment.jpg) ### Comment on an open task If you have ideas on how to improve the MCU firmware, you can contribute by commenting on a **help wanted** task and attaching screenshots, videos, code snippets, or links: ::::WorkflowBlock :::WorkflowBlockItem **Pick a task.** In the [MCU Firmware GitHub project](https://github.com/orgs/flipperdevices/projects/8), browse the open tasks and click the one labeled **help wanted** that you want to contribute to. ::: :::WorkflowBlockItem **Write your suggestion.** In the comments section, clearly describe your suggestion and, if helpful, attach a screenshot, video, code snippet, or link to a draft pull request. ![Good vs bad comment on an MCU Firmware task](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/7P5f3QhR3h-dqFuE-uJ1g_docs-good-vs-bad-comment.png) Attachment size limit: - Images: 10 MB - Videos: 100 MB ::: :::WorkflowBlockItem **Click Comment** to submit. ::: :::: ### Open a new issue If you find a bug or have a feature idea, search the [MCU Firmware issues](https://github.com/flipperdevices/flipperone-mcu-firmware/issues) first to confirm it hasn't already been reported, then open a new one. ::::WorkflowBlock :::WorkflowBlockItem **Search existing issues** in the [MCU Firmware repository](https://github.com/flipperdevices/flipperone-mcu-firmware/issues) to make sure your bug or proposal hasn't already been reported. ::: :::WorkflowBlockItem **Open a new issue.** Click **New issue** and provide enough detail to reproduce the bug or understand the proposal β€” steps, expected vs. actual behavior, hardware revision, firmware version, screenshots, or logs where relevant. ::: :::WorkflowBlockItem **Follow the discussion.** Watch the issue for notifications β€” we may ask clarifying questions. ::: :::: We review all issues and comments carefully! We may ask additional questions in the thread, so please watch for GitHub notifications in your email. β€Ž *** ### Contribute to MCU Firmware via a pull request ![Contribute via a pull request](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/2PySJDSMUUOfSnBWm8pnd_mcu-contribute-via-pr.jpg) Contributing via pull requests allows anyone to propose changes to the MCU firmware sources. Once a PR is merged, your changes become part of the official MCU firmware builds. ::::WorkflowBlock :::WorkflowBlockItem **Fork and clone the** [MCU Firmware](https://github.com/flipperdevices/flipperone-mcu-firmware) **repository.** ::: :::WorkflowBlockItem **Make your changes** in the cloned repository. ::: :::WorkflowBlockItem **Build the firmware locally** to make sure the firmware still builds with your changes. Learn more on the [How to build firmware](docId\:rPL7t5P9mlahA2PNMzj63) page. ::: :::WorkflowBlockItem **Open a pull request** to the MCU Firmware repository. ::: :::: We review all pull requests carefully! We may ask additional questions in the PR thread, so please watch for GitHub notifications in your email.