| ccollins476ad | fc6199e | 2016-12-12 17:53:39 -0600 | [diff] [blame] | 1 | # mcuboot |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 2 | |
| David Brown | a3be264 | 2017-07-26 19:02:33 -0600 | [diff] [blame^] | 3 | This is mcuboot, version 0.9.0-rc2 |
| 4 | |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 5 | ## Overview |
| 6 | |
| 7 | MCUBoot is a secure bootloader for 32-bit MCUs. The goal of MCUBoot is to |
| 8 | define a common infrastructure for the bootloader, system flash layout on |
| 9 | microcontroller systems, and to provide a secure bootloader that enables |
| 10 | easy software upgrade. |
| 11 | |
| 12 | MCUboot is operating system and hardware independent, and relies on |
| 13 | hardware porting layers from the operating system it works with. Currently |
| 14 | mcuboot works with both the Apache Mynewt, and Zephyr operating systems, but |
| Fabio Utzig | 097f76b | 2017-07-20 08:59:51 -0300 | [diff] [blame] | 15 | more ports are planned in the future. RIOT is currently supported as a boot |
| Fabio Utzig | 756ca86 | 2017-07-20 13:38:22 -0300 | [diff] [blame] | 16 | target with a complete port planned. |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 17 | |
| 18 | ## Roadmap |
| 19 | |
| Fabio Utzig | 097f76b | 2017-07-20 08:59:51 -0300 | [diff] [blame] | 20 | The issues being planned and worked on are tracked on Jira. To participate |
| 21 | please visit: |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 22 | |
| 23 | https://runtimeco.atlassian.net/projects/MCUB/summary |
| 24 | |
| 25 | ## Browsing |
| 26 | |
| 27 | Information and documentation on the bootloader is stored within the source, and on confluence: |
| 28 | |
| 29 | https://runtimeco.atlassian.net/wiki/discover/all-updates |
| 30 | |
| 31 | For more information in the source, here are some pointers: |
| 32 | |
| Sterling Hughes | 500705e | 2017-02-07 13:28:09 -0800 | [diff] [blame] | 33 | - [boot/bootutil](https://github.com/runtimeco/mcuboot/tree/master/boot/bootutil): The core of the bootloader itself. |
| 34 | - [boot/boot\_serial](https://github.com/runtimeco/mcuboot/tree/master/boot/boot_serial): Support for serial upgrade within the bootloader itself. |
| 35 | - [boot/zephyr](https://github.com/runtimeco/mcuboot/tree/master/boot/zephyr): Port of the bootloader to Zephyr |
| Fabio Utzig | 097f76b | 2017-07-20 08:59:51 -0300 | [diff] [blame] | 36 | - [boot/mynewt](https://github.com/runtimeco/mcuboot/tree/master/boot/mynewt): Mynewt bootloader app |
| Sterling Hughes | 500705e | 2017-02-07 13:28:09 -0800 | [diff] [blame] | 37 | - [imgtool](https://github.com/runtimeco/mcuboot/tree/master/imgtool): A tool to securely sign firmware images for booting by mcuboot. |
| 38 | - [sim](https://github.com/runtimeco/mcuboot/tree/master/sim): A bootloader simulator for testing and regression |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 39 | |
| Fabio Utzig | 7402374 | 2017-07-20 09:20:43 -0300 | [diff] [blame] | 40 | ## Joining |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 41 | |
| Fabio Utzig | 7402374 | 2017-07-20 09:20:43 -0300 | [diff] [blame] | 42 | Developers welcome! |
| Sterling Hughes | b6903ec | 2017-02-07 13:12:19 -0800 | [diff] [blame] | 43 | |
| Fabio Utzig | 7402374 | 2017-07-20 09:20:43 -0300 | [diff] [blame] | 44 | * Our developer mailing list: |
| 45 | http://lists.runtime.co/mailman/listinfo/dev-mcuboot_lists.runtime.co |
| Fabio Utzig | 83e5929 | 2017-07-24 07:59:26 -0300 | [diff] [blame] | 46 | * Our Slack channel: https://mcuboot.slack.com/ <br /> |
| 47 | Get your invite [here!](https://join.slack.com/t/mcuboot/shared_invite/MjE2NDcwMTQ2MTYyLTE1MDA4MTIzNTAtYzgyZTU0NjFkMg) |
| Fabio Utzig | 7402374 | 2017-07-20 09:20:43 -0300 | [diff] [blame] | 48 | * Our IRC channel: http://irc.freenode.net, #mcuboot |