mcuboot/README.md

# [mcuboot](http://mcuboot.com/)

[![Coverity Scan Build Status](https://scan.coverity.com/projects/12307/badge.svg)][coverity]
[![Build/Test](https://img.shields.io/travis/JuulLabs-OSS/mcuboot/master.svg?label=travis-ci)][travis]

[coverity]: https://scan.coverity.com/projects/mcuboot
[travis]: https://travis-ci.org/JuulLabs-OSS/mcuboot

This is mcuboot version 1.7.0-rc1

MCUboot is a secure bootloader for 32-bit MCUs. The goal of MCUboot is to
define a common infrastructure for the bootloader, system flash layout on
microcontroller systems, and to provide a secure bootloader that enables
simple software upgrades.

MCUboot is operating system and hardware independent and relies on
hardware porting layers from the operating. Currently, mcuboot works
with both the Apache Mynewt and Zephyr operating systems, but more
ports are planned in the future. RIOT is currently supported as a boot
target with a complete port planned.

## Using MCUboot

Instructions for different operating systems can be found here:
- [Zephyr](docs/readme-zephyr.md)
- [Mynewt](docs/readme-mynewt.md)
- [RIOT](docs/readme-riot.md)
- [Mbed-OS](docs/readme-mbed.md)
- [Simulator](sim/README.rst)

## Roadmap

The issues being planned and worked on are tracked using GitHub issues. To
participate please visit:

[MCUBoot GitHub Issues](https://github.com/JuulLabs-OSS/mcuboot/issues)

~~Issues were previously tracked on [MCUboot JIRA](https://runtimeco.atlassian.net/projects/MCUB/summary)
, but it is now deprecated.~~

## Browsing

Information and documentation on the bootloader are stored within the source.

~~It was previously also documented on confluence:
[MCUBoot Confluence](https://runtimeco.atlassian.net/wiki/discover/all-updates)
however, it is now deprecated and not currently maintained~~

For more information in the source, here are some pointers:

- [boot/bootutil](boot/bootutil): The core of the bootloader itself.
- [boot/boot\_serial](boot/boot_serial): Support for serial upgrade within the bootloader itself.
- [boot/zephyr](boot/zephyr): Port of the bootloader to Zephyr
- [boot/mynewt](boot/mynewt): Mynewt bootloader app
- [imgtool](scripts/imgtool.py): A tool to securely sign firmware images for booting by mcuboot.
- [sim](sim): A bootloader simulator for testing and regression

## Joining

Developers welcome!

* Our developer mailing list:
  https://groups.io/g/mcuboot
* Our Slack channel: https://mcuboot.slack.com/ <br />
  Get your invite [here!](https://join.slack.com/t/mcuboot/shared_invite/MjE2NDcwMTQ2MTYyLTE1MDA4MTIzNTAtYzgyZTU0NjFkMg)
* Our IRC channel: http://irc.freenode.net, #mcuboot
Add badges, link url - Add coverity and travis-ci badges - Link title to project url - Remove version information from header text Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-08-11 01:55:27 +08:00			`# [mcuboot](http://mcuboot.com/)`
update README 2017-02-08 05:12:19 +08:00
Add badges, link url - Add coverity and travis-ci badges - Link title to project url - Remove version information from header text Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-08-11 01:55:27 +08:00			`[![Coverity Scan Build Status](https://scan.coverity.com/projects/12307/badge.svg)][coverity]`
Fix main github repo links in docs This updates all references from github.com/runtimeco to github.com/JuulLabs-OSS in docs and yml files. Signed-off-by: Fabio Utzig <utzig@apache.org> 2018-11-16 04:48:59 +08:00			`[![Build/Test](https://img.shields.io/travis/JuulLabs-OSS/mcuboot/master.svg?label=travis-ci)][travis]`
Add badges, link url - Add coverity and travis-ci badges - Link title to project url - Remove version information from header text Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-08-11 01:55:27 +08:00
			`[coverity]: https://scan.coverity.com/projects/mcuboot`
Fix main github repo links in docs This updates all references from github.com/runtimeco to github.com/JuulLabs-OSS in docs and yml files. Signed-off-by: Fabio Utzig <utzig@apache.org> 2018-11-16 04:48:59 +08:00			`[travis]: https://travis-ci.org/JuulLabs-OSS/mcuboot`
Bump version to 0.9.0-rc2 Version is stored in repository.yaml for mynewt. Otherwise, put a single mention of it in the README.md. Signed-off-by: David Brown <david.brown@linaro.org> 2017-07-27 09:02:33 +08:00
Preps for 1.7.0-rc1 Update version fields for 1.7.0-rc1 release. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no> 2020-10-30 22:36:49 +08:00			`This is mcuboot version 1.7.0-rc1`
update README 2017-02-08 05:12:19 +08:00
README.md: Minor typographical and grammar fixes These are some minor fixes to the README.md files submitted by Aidan Earle <a_earle@live.com>. Signed-off-by: David Brown <david.brown@linaro.org> 2019-12-03 03:02:59 +08:00			`MCUboot is a secure bootloader for 32-bit MCUs. The goal of MCUboot is to`
Add badges, link url - Add coverity and travis-ci badges - Link title to project url - Remove version information from header text Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-08-11 01:55:27 +08:00			`define a common infrastructure for the bootloader, system flash layout on`
			`microcontroller systems, and to provide a secure bootloader that enables`
README.md: Minor typographical and grammar fixes These are some minor fixes to the README.md files submitted by Aidan Earle <a_earle@live.com>. Signed-off-by: David Brown <david.brown@linaro.org> 2019-12-03 03:02:59 +08:00			`simple software upgrades.`
update README 2017-02-08 05:12:19 +08:00
Add deprecated warning to Jira and Confluence links This will fix #336 by adding deprecation warning to Jira and Confluence links as these are not used by the project anymore. Signed-off-by: Sigvart M. Hovland <sigvart.m@gmail.com> 2018-09-30 00:58:55 +08:00			`MCUboot is operating system and hardware independent and relies on`
README.md: Minor typographical and grammar fixes These are some minor fixes to the README.md files submitted by Aidan Earle <a_earle@live.com>. Signed-off-by: David Brown <david.brown@linaro.org> 2019-12-03 03:02:59 +08:00			`hardware porting layers from the operating. Currently, mcuboot works`
			`with both the Apache Mynewt and Zephyr operating systems, but more`
			`ports are planned in the future. RIOT is currently supported as a boot`
Fix sentence wording per review Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-07-21 00:38:22 +08:00			`target with a complete port planned.`
update README 2017-02-08 05:12:19 +08:00
docs: Link to instructions from landing pages Link to usage instructions from the main README file and from docs/index.md so that the usage is visible from the root documentation files. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no> 2018-01-23 22:43:46 +08:00			`## Using MCUboot`

			`Instructions for different operating systems can be found here:`
			`- [Zephyr](docs/readme-zephyr.md)`
			`- [Mynewt](docs/readme-mynewt.md)`
			`- [RIOT](docs/readme-riot.md)`
Update main README with links to Mbed-OS documentation Signed-off-by: George Beckstein <becksteing@embeddedplanet.com> 2020-11-05 13:51:09 +08:00			`- [Mbed-OS](docs/readme-mbed.md)`
Add a link to the simulator from the top-level README Hopefully this will help a little with awareness of the existence of the simulator. Signed-off-by: David Brown <david.brown@linaro.org> 2020-05-12 04:10:00 +08:00			`- [Simulator](sim/README.rst)`
docs: Link to instructions from landing pages Link to usage instructions from the main README file and from docs/index.md so that the usage is visible from the root documentation files. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no> 2018-01-23 22:43:46 +08:00
update README 2017-02-08 05:12:19 +08:00			`## Roadmap`

Add deprecated warning to Jira and Confluence links This will fix #336 by adding deprecation warning to Jira and Confluence links as these are not used by the project anymore. Signed-off-by: Sigvart M. Hovland <sigvart.m@gmail.com> 2018-09-30 00:58:55 +08:00			`The issues being planned and worked on are tracked using GitHub issues. To`
			`participate please visit:`
update README 2017-02-08 05:12:19 +08:00
Fix main github repo links in docs This updates all references from github.com/runtimeco to github.com/JuulLabs-OSS in docs and yml files. Signed-off-by: Fabio Utzig <utzig@apache.org> 2018-11-16 04:48:59 +08:00			`[MCUBoot GitHub Issues](https://github.com/JuulLabs-OSS/mcuboot/issues)`
Add deprecated warning to Jira and Confluence links This will fix #336 by adding deprecation warning to Jira and Confluence links as these are not used by the project anymore. Signed-off-by: Sigvart M. Hovland <sigvart.m@gmail.com> 2018-09-30 00:58:55 +08:00
			`~~Issues were previously tracked on [MCUboot JIRA](https://runtimeco.atlassian.net/projects/MCUB/summary)`
			`, but it is now deprecated.~~`
update README 2017-02-08 05:12:19 +08:00
Add badges, link url - Add coverity and travis-ci badges - Link title to project url - Remove version information from header text Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-08-11 01:55:27 +08:00			`## Browsing`
update README 2017-02-08 05:12:19 +08:00
Add deprecated warning to Jira and Confluence links This will fix #336 by adding deprecation warning to Jira and Confluence links as these are not used by the project anymore. Signed-off-by: Sigvart M. Hovland <sigvart.m@gmail.com> 2018-09-30 00:58:55 +08:00			`Information and documentation on the bootloader are stored within the source.`
update README 2017-02-08 05:12:19 +08:00
Add deprecated warning to Jira and Confluence links This will fix #336 by adding deprecation warning to Jira and Confluence links as these are not used by the project anymore. Signed-off-by: Sigvart M. Hovland <sigvart.m@gmail.com> 2018-09-30 00:58:55 +08:00			`~~It was previously also documented on confluence:`
			`[MCUBoot Confluence](https://runtimeco.atlassian.net/wiki/discover/all-updates)`
			`however, it is now deprecated and not currently maintained~~`
update README 2017-02-08 05:12:19 +08:00
Add badges, link url - Add coverity and travis-ci badges - Link title to project url - Remove version information from header text Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-08-11 01:55:27 +08:00			`For more information in the source, here are some pointers:`
update README 2017-02-08 05:12:19 +08:00
Use relative links for docs - Also fix imgtool script link Signed-off-by: Fabio Utzig <utzig@apache.org> 2018-02-14 00:20:03 +08:00			`- [boot/bootutil](boot/bootutil): The core of the bootloader itself.`
			`- [boot/boot\_serial](boot/boot_serial): Support for serial upgrade within the bootloader itself.`
			`- [boot/zephyr](boot/zephyr): Port of the bootloader to Zephyr`
			`- [boot/mynewt](boot/mynewt): Mynewt bootloader app`
			`- [imgtool](scripts/imgtool.py): A tool to securely sign firmware images for booting by mcuboot.`
			`- [sim](sim): A bootloader simulator for testing and regression`
update README 2017-02-08 05:12:19 +08:00
Add IRC channel information Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-07-20 20:20:43 +08:00			`## Joining`
update README 2017-02-08 05:12:19 +08:00
Add IRC channel information Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-07-20 20:20:43 +08:00			`Developers welcome!`
update README 2017-02-08 05:12:19 +08:00
Add IRC channel information Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-07-20 20:20:43 +08:00			`* Our developer mailing list:`
README: update mailing list Update the top-level README.md file to refer to the new mailing list. Signed-off-by: David Brown <david.brown@linaro.org> 2020-02-08 02:53:06 +08:00			`https://groups.io/g/mcuboot`
Fix Slack's URL info Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-07-24 18:59:26 +08:00			`* Our Slack channel: https://mcuboot.slack.com/ <br />`
			`Get your invite [here!](https://join.slack.com/t/mcuboot/shared_invite/MjE2NDcwMTQ2MTYyLTE1MDA4MTIzNTAtYzgyZTU0NjFkMg)`
Add IRC channel information Signed-off-by: Fabio Utzig <utzig@apache.org> 2017-07-20 20:20:43 +08:00			`* Our IRC channel: http://irc.freenode.net, #mcuboot`