TrustedFirmware Git Browser
Code Review Sign In
review.trustedfirmware.org / mirror / mcuboot / 0be390e08e0791d1c1bf4a89073517d626ed31f7 / . / README.md
blob: 853569efd8236807b632df3d214f1e83022a5ba3 [file] [log] [blame] [view]
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]1# [mcuboot](http://mcuboot.com/)
2
Fabio Utzig0be390e2020-11-12 10:45:07 -0300[diff] [blame^]3[![Package on PyPI](https://img.shields.io/pypi/v/imgtool.svg)][pypi]
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]4[![Coverity Scan Build Status](https://scan.coverity.com/projects/12307/badge.svg)][coverity]
Fabio Utzig0be390e2020-11-12 10:45:07 -0300[diff] [blame^]5[![Build Status (Sim)](https://github.com/mcu-tools/mcuboot/workflows/Sim/badge.svg)][sim]
6[![Build Status (Mynewt)](https://github.com/mcu-tools/mcuboot/workflows/Mynewt/badge.svg)][mynewt]
7[![Publishing Status (imgtool)](https://github.com/mcu-tools/mcuboot/workflows/imgtool/badge.svg)][imgtool]
8[![Build Status (Travis CI)](https://img.shields.io/travis/mcu-tools/mcuboot/master.svg?label=travis-ci)][travis]
9[![Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)][license]
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]10
Fabio Utzig0be390e2020-11-12 10:45:07 -0300[diff] [blame^]11[pypi]: https://pypi.org/project/imgtool/
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]12[coverity]: https://scan.coverity.com/projects/mcuboot
Fabio Utzig0be390e2020-11-12 10:45:07 -0300[diff] [blame^]13[sim]: https://github.com/mcu-tools/mcuboot/actions?query=workflow:.github/workflows/sim.yaml
14[mynewt]: https://github.com/mcu-tools/mcuboot/actions?query=workflow:.github/workflows/mynewt.yaml
15[imgtool]: https://github.com/mcu-tools/mcuboot/actions?query=workflow:.github/workflows/imgtool.yaml
Fabio Utzigde1d72d2020-11-10 12:35:04 -0300[diff] [blame]16[travis]: https://travis-ci.org/mcu-tools/mcuboot
Fabio Utzig0be390e2020-11-12 10:45:07 -0300[diff] [blame^]17[license]: https://github.com/mcu-tools/mcuboot/blob/master/LICENSE
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]18
Andrzej Puzdrowskie7596612020-11-10 14:54:41 +0100[diff] [blame]19This is mcuboot version 1.7.0-rc2
David Browna3be2642017-07-26 19:02:33 -0600[diff] [blame]20
David Brown586c84e2019-12-02 12:02:59 -0700[diff] [blame]21MCUboot is a secure bootloader for 32-bit MCUs. The goal of MCUboot is to
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]22define a common infrastructure for the bootloader, system flash layout on
23microcontroller systems, and to provide a secure bootloader that enables
David Brown586c84e2019-12-02 12:02:59 -0700[diff] [blame]24simple software upgrades.
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]25
Sigvart M. Hovland68b30532018-09-29 18:58:55 +0200[diff] [blame]26MCUboot is operating system and hardware independent and relies on
David Brown586c84e2019-12-02 12:02:59 -0700[diff] [blame]27hardware porting layers from the operating. Currently, mcuboot works
28with both the Apache Mynewt and Zephyr operating systems, but more
29ports are planned in the future. RIOT is currently supported as a boot
Fabio Utzig756ca862017-07-20 13:38:22 -0300[diff] [blame]30target with a complete port planned.
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]31
Carles Cufi3b61e702018-01-23 15:43:46 +0100[diff] [blame]32## Using MCUboot
33
34Instructions for different operating systems can be found here:
35- [Zephyr](docs/readme-zephyr.md)
36- [Mynewt](docs/readme-mynewt.md)
37- [RIOT](docs/readme-riot.md)
George Beckstein1c399bb2020-11-05 00:51:09 -0500[diff] [blame]38- [Mbed-OS](docs/readme-mbed.md)
David Brown4cb70cc2020-05-11 14:10:00 -0600[diff] [blame]39- [Simulator](sim/README.rst)
Carles Cufi3b61e702018-01-23 15:43:46 +0100[diff] [blame]40
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]41## Roadmap
42
Sigvart M. Hovland68b30532018-09-29 18:58:55 +0200[diff] [blame]43The issues being planned and worked on are tracked using GitHub issues. To
44participate please visit:
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]45
Fabio Utzigde1d72d2020-11-10 12:35:04 -0300[diff] [blame]46[MCUBoot GitHub Issues](https://github.com/mcu-tools/mcuboot/issues)
Sigvart M. Hovland68b30532018-09-29 18:58:55 +0200[diff] [blame]47
48~~Issues were previously tracked on [MCUboot JIRA](https://runtimeco.atlassian.net/projects/MCUB/summary)
49, but it is now deprecated.~~
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]50
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]51## Browsing
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]52
Sigvart M. Hovland68b30532018-09-29 18:58:55 +0200[diff] [blame]53Information and documentation on the bootloader are stored within the source.
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]54
Sigvart M. Hovland68b30532018-09-29 18:58:55 +0200[diff] [blame]55~~It was previously also documented on confluence:
56[MCUBoot Confluence](https://runtimeco.atlassian.net/wiki/discover/all-updates)
57however, it is now deprecated and not currently maintained~~
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]58
Fabio Utzig811205e2017-08-10 14:55:27 -0300[diff] [blame]59For more information in the source, here are some pointers:
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]60
Fabio Utzigb519ed02018-02-13 14:20:03 -0200[diff] [blame]61- [boot/bootutil](boot/bootutil): The core of the bootloader itself.
62- [boot/boot\_serial](boot/boot_serial): Support for serial upgrade within the bootloader itself.
63- [boot/zephyr](boot/zephyr): Port of the bootloader to Zephyr
64- [boot/mynewt](boot/mynewt): Mynewt bootloader app
65- [imgtool](scripts/imgtool.py): A tool to securely sign firmware images for booting by mcuboot.
66- [sim](sim): A bootloader simulator for testing and regression
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]67
Fabio Utzig74023742017-07-20 09:20:43 -0300[diff] [blame]68## Joining
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]69
Fabio Utzig74023742017-07-20 09:20:43 -0300[diff] [blame]70Developers welcome!
Sterling Hughesb6903ec2017-02-07 13:12:19 -0800[diff] [blame]71
Fabio Utzig74023742017-07-20 09:20:43 -0300[diff] [blame]72* Our developer mailing list:
David Browna222bf32020-02-07 11:53:06 -0700[diff] [blame]73 https://groups.io/g/mcuboot
Fabio Utzig83e59292017-07-24 07:59:26 -0300[diff] [blame]74* Our Slack channel: https://mcuboot.slack.com/ <br />
75 Get your invite [here!](https://join.slack.com/t/mcuboot/shared_invite/MjE2NDcwMTQ2MTYyLTE1MDA4MTIzNTAtYzgyZTU0NjFkMg)
Fabio Utzig74023742017-07-20 09:20:43 -0300[diff] [blame]76* Our IRC channel: http://irc.freenode.net, #mcuboot