From 81c235d27a79e989d1bcf87778b4b6dea20d6d2d Mon Sep 17 00:00:00 2001 From: James Munns Date: Sat, 25 Aug 2018 21:43:29 -0700 Subject: [PATCH 1/5] Vendor the "Hyde" theme --- themes/hyde/.gitignore | 2 + themes/hyde/LICENSE | 21 ++ themes/hyde/README.md | 67 ++++ themes/hyde/config.toml | 12 + themes/hyde/content/some-article.md | 14 + themes/hyde/content/some-other-article.md | 14 + themes/hyde/sass/hyde.scss | 250 +++++++++++++ themes/hyde/sass/poole.scss | 415 ++++++++++++++++++++++ themes/hyde/sass/print.scss | 19 + themes/hyde/screenshot.png | Bin 0 -> 59296 bytes themes/hyde/static/.gitkeep | 0 themes/hyde/templates/index.html | 70 ++++ themes/hyde/templates/page.html | 10 + themes/hyde/theme.toml | 22 ++ 14 files changed, 916 insertions(+) create mode 100644 themes/hyde/.gitignore create mode 100644 themes/hyde/LICENSE create mode 100644 themes/hyde/README.md create mode 100644 themes/hyde/config.toml create mode 100644 themes/hyde/content/some-article.md create mode 100644 themes/hyde/content/some-other-article.md create mode 100644 themes/hyde/sass/hyde.scss create mode 100644 themes/hyde/sass/poole.scss create mode 100644 themes/hyde/sass/print.scss create mode 100644 themes/hyde/screenshot.png create mode 100644 themes/hyde/static/.gitkeep create mode 100644 themes/hyde/templates/index.html create mode 100644 themes/hyde/templates/page.html create mode 100644 themes/hyde/theme.toml diff --git a/themes/hyde/.gitignore b/themes/hyde/.gitignore new file mode 100644 index 0000000..4139cd5 --- /dev/null +++ b/themes/hyde/.gitignore @@ -0,0 +1,2 @@ +.idea/ +public diff --git a/themes/hyde/LICENSE b/themes/hyde/LICENSE new file mode 100644 index 0000000..93ab851 --- /dev/null +++ b/themes/hyde/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2017 Vincent Prouillet + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/themes/hyde/README.md b/themes/hyde/README.md new file mode 100644 index 0000000..469718f --- /dev/null +++ b/themes/hyde/README.md @@ -0,0 +1,67 @@ +# hyde +Hyde is a brazen two-column [Gutenberg](https://github.com/Keats/gutenberg) based on the Jekyll theme of the same name that pairs a prominent sidebar with uncomplicated content. + +![Hyde screenshot](https://f.cloud.github.com/assets/98681/1831228/42af6c6a-7384-11e3-98fb-e0b923ee0468.png) + + +## Contents + +- [Installation](#installation) +- [Options](#options) + - [Sidebar menu](#sidebar-menu) + - [Sticky sidebar content](#sticky-sidebar-content) + - [Themes](#themes) + - [Reverse layout](#reverse-layout) + +## Installation +First download this theme to your `themes` directory: + +```bash +$ cd themes +$ git clone https://github.com/Keats/hyde.git +``` +and then enable it in your `config.toml`: + +```toml +theme = "hyde" +``` + +## Options + +### Sidebar menu +Set a field in `extra` with a key of `hyde_links`: +```toml +[extra] +hyde_links = [ + {url = "https://google.com", name = "Google.com"}, + {url = "https://google.fr", name = "Google.fr"}, +] +``` +Each link needs to have a `url` and a `name`. + +### Sticky sidebar content +By default Hyde ships with a sidebar that affixes it's content to the bottom of the sidebar. You can optionally disable this by setting `hyde_sticky` to false in your `config.toml`. + +### Themes +Hyde ships with eight optional themes based on the [base16 color scheme](https://github.com/chriskempson/base16). Apply a theme to change the color scheme (mostly applies to sidebar and links). + +![Hyde in red](https://f.cloud.github.com/assets/98681/1831229/42b0b354-7384-11e3-8462-31b8df193fe5.png) + +There are eight themes available at this time. + +![Hyde theme classes](https://f.cloud.github.com/assets/98681/1817044/e5b0ec06-6f68-11e3-83d7-acd1942797a1.png) + +To use a theme, set the `hyde_theme` field in `config.toml` to any of the themes name: + +```toml +[extra] +hyde_theme = "theme-base-08" +``` + +To create your own theme, look to the Themes section of [included CSS file](https://github.com/poole/hyde/blob/master/public/css/hyde.css). Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors. + +### Reverse layout + +![Hyde with reverse layout](https://f.cloud.github.com/assets/98681/1831230/42b0d3ac-7384-11e3-8d54-2065afd03f9e.png) + +Hyde's page orientation can be reversed by setting `hyde_reverse` to `true` in the `config.toml`. diff --git a/themes/hyde/config.toml b/themes/hyde/config.toml new file mode 100644 index 0000000..6e24e7e --- /dev/null +++ b/themes/hyde/config.toml @@ -0,0 +1,12 @@ +base_url = "https://gutenberg-hyde.netlify.com" +compile_sass = true +title = "Hyde theme" +description = "A clean blogging theme" + +[extra] +hyde_sticky = true +hyde_reverse = false +hyde_theme = "" +hyde_links = [ + {url = "https://google.com", name = "About"}, +] diff --git a/themes/hyde/content/some-article.md b/themes/hyde/content/some-article.md new file mode 100644 index 0000000..c3c8aee --- /dev/null +++ b/themes/hyde/content/some-article.md @@ -0,0 +1,14 @@ ++++ +title = "What is Gutenberg" +date = 2017-09-24 ++++ + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc eu feugiat sapien. Aenean ligula nunc, laoreet id sem in, interdum bibendum felis. Donec vel dui neque. Praesent ac sem ut justo volutpat rutrum a imperdiet tellus. Nam lobortis massa non hendrerit hendrerit. Vivamus porttitor dignissim turpis, eget aliquam urna tincidunt non. Aliquam et fringilla turpis. Nullam eros est, eleifend in ornare sed, hendrerit eget est. Aliquam tellus felis, suscipit vitae ex vel, fringilla tempus massa. Nulla facilisi. Pellentesque lobortis consequat lectus. Maecenas ac libero elit. + +Ut luctus dolor ut tortor hendrerit, sed hendrerit augue scelerisque. Suspendisse quis sodales dui, at tempus ante. Nulla at tempor metus. Aliquam vitae rutrum diam. Curabitur iaculis massa dui, quis varius nulla finibus a. Praesent eu blandit justo. Suspendisse pharetra, arcu in rhoncus rutrum, magna magna viverra erat, eget vestibulum enim tellus id dui. Nunc vel dui et arcu posuere maximus. Mauris quam quam, bibendum sed libero nec, tempus hendrerit arcu. Suspendisse sed gravida orci. Fusce tempor arcu ac est pretium porttitor. Aenean consequat risus venenatis sem aliquam, at sollicitudin nulla semper. Aenean bibendum cursus hendrerit. Nulla congue urna nec finibus bibendum. Donec porta tincidunt ligula non ultricies. + +Sed vulputate tristique elit, eget pharetra elit sodales sed. Proin dignissim ipsum lorem, at porta eros malesuada sed. Proin tristique eros eu quam ornare, suscipit luctus mauris lobortis. Phasellus ut placerat enim. Donec egestas faucibus maximus. Nam quis efficitur eros. Cras tincidunt, lacus ac pretium porta, dui dolor varius elit, eget laoreet justo justo vitae metus. Morbi eget nisi ut ex scelerisque lobortis ut in lorem. Vestibulum et lorem quis ipsum feugiat varius. Mauris nec nulla viverra nisi porttitor efficitur. Morbi vel purus eleifend, finibus erat non, placerat ipsum. Mauris et augue vel nisi volutpat aliquam. Curabitur malesuada tortor est, at condimentum neque eleifend in. + +Morbi id ornare lacus. Suspendisse ultrices rutrum posuere. Nullam porttitor libero quis ligula finibus semper. Mauris iaculis magna et nisl tristique, eget maximus ex feugiat. Nam eu felis leo. Quisque ultrices varius purus in molestie. Duis non accumsan ligula. Vivamus dignissim malesuada metus, vel hendrerit tellus viverra id. Curabitur posuere, mauris vitae dignissim dictum, velit mi condimentum lorem, nec varius velit arcu a mi. In dolor sapien, condimentum sed aliquam at, dignissim id purus. Cras lorem leo, vulputate ac ante sed, molestie tempus lectus. Curabitur efficitur libero quam, rhoncus faucibus libero pharetra nec. Curabitur lobortis ullamcorper nisl eu imperdiet. Duis porttitor interdum magna, ac eleifend orci consequat vitae. Aliquam augue felis, faucibus vel blandit sed, maximus non turpis. + +Quisque viverra a eros id auctor. Proin id nibh ut nisl dignissim pellentesque et ac mi. Nullam mattis urna quis consequat bibendum. Donec pretium dui elit, a semper purus tristique et. Mauris euismod nisl eu vehicula facilisis. Maecenas facilisis non massa non scelerisque. Integer malesuada cursus erat eu viverra. Duis ligula mi, eleifend vel justo id, laoreet porttitor ex. Etiam ultricies lacus lorem, sed aliquam nulla blandit in. Maecenas vel facilisis neque, vitae fringilla eros. In justo nibh, pellentesque sed faucibus nec, varius sit amet risus. diff --git a/themes/hyde/content/some-other-article.md b/themes/hyde/content/some-other-article.md new file mode 100644 index 0000000..290dbaa --- /dev/null +++ b/themes/hyde/content/some-other-article.md @@ -0,0 +1,14 @@ ++++ +title = "A first theme for Gutenberg" +date = 2017-09-25 ++++ + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc eu feugiat sapien. Aenean ligula nunc, laoreet id sem in, interdum bibendum felis. Donec vel dui neque. Praesent ac sem ut justo volutpat rutrum a imperdiet tellus. Nam lobortis massa non hendrerit hendrerit. Vivamus porttitor dignissim turpis, eget aliquam urna tincidunt non. Aliquam et fringilla turpis. Nullam eros est, eleifend in ornare sed, hendrerit eget est. Aliquam tellus felis, suscipit vitae ex vel, fringilla tempus massa. Nulla facilisi. Pellentesque lobortis consequat lectus. Maecenas ac libero elit. + +Ut luctus dolor ut tortor hendrerit, sed hendrerit augue scelerisque. Suspendisse quis sodales dui, at tempus ante. Nulla at tempor metus. Aliquam vitae rutrum diam. Curabitur iaculis massa dui, quis varius nulla finibus a. Praesent eu blandit justo. Suspendisse pharetra, arcu in rhoncus rutrum, magna magna viverra erat, eget vestibulum enim tellus id dui. Nunc vel dui et arcu posuere maximus. Mauris quam quam, bibendum sed libero nec, tempus hendrerit arcu. Suspendisse sed gravida orci. Fusce tempor arcu ac est pretium porttitor. Aenean consequat risus venenatis sem aliquam, at sollicitudin nulla semper. Aenean bibendum cursus hendrerit. Nulla congue urna nec finibus bibendum. Donec porta tincidunt ligula non ultricies. + +Sed vulputate tristique elit, eget pharetra elit sodales sed. Proin dignissim ipsum lorem, at porta eros malesuada sed. Proin tristique eros eu quam ornare, suscipit luctus mauris lobortis. Phasellus ut placerat enim. Donec egestas faucibus maximus. Nam quis efficitur eros. Cras tincidunt, lacus ac pretium porta, dui dolor varius elit, eget laoreet justo justo vitae metus. Morbi eget nisi ut ex scelerisque lobortis ut in lorem. Vestibulum et lorem quis ipsum feugiat varius. Mauris nec nulla viverra nisi porttitor efficitur. Morbi vel purus eleifend, finibus erat non, placerat ipsum. Mauris et augue vel nisi volutpat aliquam. Curabitur malesuada tortor est, at condimentum neque eleifend in. + +Morbi id ornare lacus. Suspendisse ultrices rutrum posuere. Nullam porttitor libero quis ligula finibus semper. Mauris iaculis magna et nisl tristique, eget maximus ex feugiat. Nam eu felis leo. Quisque ultrices varius purus in molestie. Duis non accumsan ligula. Vivamus dignissim malesuada metus, vel hendrerit tellus viverra id. Curabitur posuere, mauris vitae dignissim dictum, velit mi condimentum lorem, nec varius velit arcu a mi. In dolor sapien, condimentum sed aliquam at, dignissim id purus. Cras lorem leo, vulputate ac ante sed, molestie tempus lectus. Curabitur efficitur libero quam, rhoncus faucibus libero pharetra nec. Curabitur lobortis ullamcorper nisl eu imperdiet. Duis porttitor interdum magna, ac eleifend orci consequat vitae. Aliquam augue felis, faucibus vel blandit sed, maximus non turpis. + +Quisque viverra a eros id auctor. Proin id nibh ut nisl dignissim pellentesque et ac mi. Nullam mattis urna quis consequat bibendum. Donec pretium dui elit, a semper purus tristique et. Mauris euismod nisl eu vehicula facilisis. Maecenas facilisis non massa non scelerisque. Integer malesuada cursus erat eu viverra. Duis ligula mi, eleifend vel justo id, laoreet porttitor ex. Etiam ultricies lacus lorem, sed aliquam nulla blandit in. Maecenas vel facilisis neque, vitae fringilla eros. In justo nibh, pellentesque sed faucibus nec, varius sit amet risus. diff --git a/themes/hyde/sass/hyde.scss b/themes/hyde/sass/hyde.scss new file mode 100644 index 0000000..1ddbdda --- /dev/null +++ b/themes/hyde/sass/hyde.scss @@ -0,0 +1,250 @@ +/* + * __ __ + * /\ \ /\ \ + * \ \ \___ __ __ \_\ \ __ + * \ \ _ `\/\ \/\ \ /'_` \ /'__`\ + * \ \ \ \ \ \ \_\ \/\ \_\ \/\ __/ + * \ \_\ \_\/`____ \ \___,_\ \____\ + * \/_/\/_/`/___/> \/__,_ /\/____/ + * /\___/ + * \/__/ + * + * Designed, built, and released under MIT license by @mdo. Learn more at + * https://github.com/poole/hyde. + */ + + +/* + * Contents + * + * Global resets + * Sidebar + * Container + * Reverse layout + * Themes + */ + + +/* + * Global resets + * + * Update the foundational and global aspects of the page. + */ + +html { + font-family: "PT Sans", Helvetica, Arial, sans-serif; +} +@media (min-width: 48em) { + html { + font-size: 16px; + } +} +@media (min-width: 58em) { + html { + font-size: 20px; + } +} + + +/* + * Sidebar + * + * Flexible banner for housing site name, intro, and "footer" content. Starts + * out above content in mobile and later moves to the side with wider viewports. + */ + +.sidebar { + text-align: center; + padding: 2rem 1rem; + color: rgba(255,255,255,.5); + background-color: #202020; +} +@media (min-width: 48em) { + .sidebar { + position: fixed; + top: 0; + left: 0; + bottom: 0; + width: 18rem; + text-align: left; + } +} + +/* Sidebar links */ +.sidebar a { + color: #fff; +} + +/* About section */ +.sidebar-about h1 { + color: #fff; + margin-top: 0; + font-family: "Abril Fatface", serif; + font-size: 3.25rem; +} + +/* Sidebar nav */ +.sidebar-nav { + padding-left: 0; + list-style: none; +} +.sidebar-nav-item { + display: block; +} +a.sidebar-nav-item:hover, +a.sidebar-nav-item:focus { + text-decoration: underline; +} +.sidebar-nav-item.active { + font-weight: bold; +} + +/* Sticky sidebar + * + * Add the `sidebar-sticky` class to the sidebar's container to affix it the + * contents to the bottom of the sidebar in tablets and up. + */ + +@media (min-width: 48em) { + .sidebar-sticky { + position: absolute; + right: 1rem; + bottom: 1rem; + left: 1rem; + } +} + + +/* Container + * + * Align the contents of the site above the proper threshold with some margin-fu + * with a 25%-wide `.sidebar`. + */ + +.content { + padding-top: 4rem; + padding-bottom: 4rem; +} + +@media (min-width: 48em) { + .content { + max-width: 38rem; + margin-left: 20rem; + margin-right: 2rem; + } +} + +@media (min-width: 64em) { + .content { + margin-left: 22rem; + margin-right: 4rem; + } +} + + +/* + * Reverse layout + * + * Flip the orientation of the page by placing the `.sidebar` on the right. + */ + +@media (min-width: 48em) { + .layout-reverse .sidebar { + left: auto; + right: 0; + } + .layout-reverse .content { + margin-left: 2rem; + margin-right: 20rem; + } +} + +@media (min-width: 64em) { + .layout-reverse .content { + margin-left: 4rem; + margin-right: 22rem; + } +} + + + +/* + * Themes + * + * As of v1.1, Hyde includes optional themes to color the sidebar and links + * within blog posts. To use, add the class of your choosing to the `body`. + */ + +/* Base16 (http://chriskempson.github.io/base16/#default) */ + +/* Red */ +.theme-base-08 .sidebar { + background-color: #ac4142; +} +.theme-base-08 .content a, +.theme-base-08 .related-posts li a:hover { + color: #ac4142; +} + +/* Orange */ +.theme-base-09 .sidebar { + background-color: #d28445; +} +.theme-base-09 .content a, +.theme-base-09 .related-posts li a:hover { + color: #d28445; +} + +/* Yellow */ +.theme-base-0a .sidebar { + background-color: #f4bf75; +} +.theme-base-0a .content a, +.theme-base-0a .related-posts li a:hover { + color: #f4bf75; +} + +/* Green */ +.theme-base-0b .sidebar { + background-color: #90a959; +} +.theme-base-0b .content a, +.theme-base-0b .related-posts li a:hover { + color: #90a959; +} + +/* Cyan */ +.theme-base-0c .sidebar { + background-color: #75b5aa; +} +.theme-base-0c .content a, +.theme-base-0c .related-posts li a:hover { + color: #75b5aa; +} + +/* Blue */ +.theme-base-0d .sidebar { + background-color: #6a9fb5; +} +.theme-base-0d .content a, +.theme-base-0d .related-posts li a:hover { + color: #6a9fb5; +} + +/* Magenta */ +.theme-base-0e .sidebar { + background-color: #aa759f; +} +.theme-base-0e .content a, +.theme-base-0e .related-posts li a:hover { + color: #aa759f; +} + +/* Brown */ +.theme-base-0f .sidebar { + background-color: #8f5536; +} +.theme-base-0f .content a, +.theme-base-0f .related-posts li a:hover { + color: #8f5536; +} diff --git a/themes/hyde/sass/poole.scss b/themes/hyde/sass/poole.scss new file mode 100644 index 0000000..c277c14 --- /dev/null +++ b/themes/hyde/sass/poole.scss @@ -0,0 +1,415 @@ +/* + * ___ + * /\_ \ + * _____ ___ ___\//\ \ __ + * /\ '__`\ / __`\ / __`\\ \ \ /'__`\ + * \ \ \_\ \/\ \_\ \/\ \_\ \\_\ \_/\ __/ + * \ \ ,__/\ \____/\ \____//\____\ \____\ + * \ \ \/ \/___/ \/___/ \/____/\/____/ + * \ \_\ + * \/_/ + * + * Designed, built, and released under MIT license by @mdo. Learn more at + * https://github.com/poole/poole. + */ + + +/* + * Contents + * + * Body resets + * Custom type + * Messages + * Container + * Masthead + * Posts and pages + * Footnotes + * Pagination + * Reverse layout + * Themes + */ + + +/* + * Body resets + * + * Update the foundational and global aspects of the page. + */ + +* { + -webkit-box-sizing: border-box; + -moz-box-sizing: border-box; + box-sizing: border-box; +} + +html, +body { + margin: 0; + padding: 0; +} + +html { + font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; + font-size: 16px; + line-height: 1.5; +} +@media (min-width: 38em) { + html { + font-size: 20px; + } +} + +body { + color: #515151; + background-color: #fff; + -webkit-text-size-adjust: 100%; + -ms-text-size-adjust: 100%; +} + +/* No `:visited` state is required by default (browsers will use `a`) */ +a { + color: #268bd2; + text-decoration: none; +} +/* `:focus` is linked to `:hover` for basic accessibility */ +a:hover, +a:focus { + text-decoration: underline; +} + +/* Headings */ +h1, h2, h3, h4, h5, h6 { + margin-bottom: .5rem; + font-weight: bold; + line-height: 1.25; + color: #313131; + text-rendering: optimizeLegibility; +} +h1 { + font-size: 2rem; +} +h2 { + margin-top: 1rem; + font-size: 1.5rem; +} +h3 { + margin-top: 1.5rem; + font-size: 1.25rem; +} +h4, h5, h6 { + margin-top: 1rem; + font-size: 1rem; +} + +/* Body text */ +p { + margin-top: 0; + margin-bottom: 1rem; +} + +strong { + color: #303030; +} + + +/* Lists */ +ul, ol, dl { + margin-top: 0; + margin-bottom: 1rem; +} + +dt { + font-weight: bold; +} +dd { + margin-bottom: .5rem; +} + +/* Misc */ +hr { + position: relative; + margin: 1.5rem 0; + border: 0; + border-top: 1px solid #eee; + border-bottom: 1px solid #fff; +} + +abbr { + font-size: 85%; + font-weight: bold; + color: #555; + text-transform: uppercase; +} +abbr[title] { + cursor: help; + border-bottom: 1px dotted #e5e5e5; +} + +/* Code */ +code, +pre { + font-family: Menlo, Monaco, "Courier New", monospace; +} +code { + padding: .25em .5em; + font-size: 85%; + color: #bf616a; + background-color: #f9f9f9; + border-radius: 3px; +} +pre { + display: block; + margin-top: 0; + margin-bottom: 1rem; + padding: 1rem; + font-size: .8rem; + line-height: 1.4; + overflow-x: scroll; + background-color: #f9f9f9; +} +pre code { + padding: 0; + font-size: 100%; + color: inherit; + background-color: transparent; +} +.highlight { + margin-bottom: 1rem; + border-radius: 4px; +} +.highlight pre { + margin-bottom: 0; +} + +/* Quotes */ +blockquote { + padding: .5rem 1rem; + margin: .8rem 0; + color: #7a7a7a; + border-left: .25rem solid #e5e5e5; +} +blockquote p:last-child { + margin-bottom: 0; +} +@media (min-width: 30em) { + blockquote { + padding-right: 5rem; + padding-left: 1.25rem; + } +} + +img { + display: block; + margin: 0 0 1rem; + border-radius: 5px; + max-width: 100%; +} + +/* Tables */ +table { + margin-bottom: 1rem; + width: 100%; + border: 1px solid #e5e5e5; + border-collapse: collapse; +} +td, +th { + padding: .25rem .5rem; + border: 1px solid #e5e5e5; +} +tbody tr:nth-child(odd) td, +tbody tr:nth-child(odd) th { + background-color: #f9f9f9; +} + + +/* + * Custom type + * + * Extend paragraphs with `.lead` for larger introductory text. + */ + +.lead { + font-size: 1.25rem; + font-weight: 300; +} + + +/* + * Messages + * + * Show alert messages to users. You may add it to single elements like a `

`, + * or to a parent if there are multiple elements to show. + */ + +.message { + margin-bottom: 1rem; + padding: 1rem; + color: #717171; + background-color: #f9f9f9; +} + + +/* + * Container + * + * Center the page content. + */ + +.container { + max-width: 38rem; + padding-left: 1rem; + padding-right: 1rem; + margin-left: auto; + margin-right: auto; +} + + +/* + * Masthead + * + * Super small header above the content for site name and short description. + */ + +.masthead { + padding-top: 1rem; + padding-bottom: 1rem; + margin-bottom: 3rem; +} +.masthead-title { + margin-top: 0; + margin-bottom: 0; + color: #505050; +} +.masthead-title a { + color: #505050; +} +.masthead-title small { + font-size: 75%; + font-weight: 400; + color: #c0c0c0; + letter-spacing: 0; +} + + +/* + * Posts and pages + * + * Each post is wrapped in `.post` and is used on default and post layouts. Each + * page is wrapped in `.page` and is only used on the page layout. + */ + +.page, +.post { + margin-bottom: 4em; +} + +/* Blog post or page title */ +.page-title, +.post-title, +.post-title a { + color: #303030; +} +.page-title, +.post-title { + margin-top: 0; +} + +/* Meta data line below post title */ +.post-date { + display: block; + margin-top: -.5rem; + margin-bottom: 1rem; + color: #9a9a9a; +} + +/* Related posts */ +.related { + padding-top: 2rem; + padding-bottom: 2rem; + border-top: 1px solid #eee; +} +.related-posts { + padding-left: 0; + list-style: none; +} +.related-posts h3 { + margin-top: 0; +} +.related-posts li small { + font-size: 75%; + color: #999; +} +.related-posts li a:hover { + color: #268bd2; + text-decoration: none; +} +.related-posts li a:hover small { + color: inherit; +} + + +/* Footnotes */ +.footnote-definition:first-of-type { + border-top: 1px solid; + padding-top: 1rem; +} +.footnote-definition { + margin-top: 1rem; +} +.footnote-definition sup { + margin-left: -1rem; + float: left; +} + + +/* + * Pagination + * + * Super lightweight (HTML-wise) blog pagination. `span`s are provide for when + * there are no more previous or next posts to show. + */ + +.pagination { + overflow: hidden; /* clearfix */ + margin-left: -1rem; + margin-right: -1rem; + font-family: "PT Sans", Helvetica, Arial, sans-serif; + color: #ccc; + text-align: center; +} + +/* Pagination items can be `span`s or `a`s */ +.pagination-item { + display: block; + padding: 1rem; + border: 1px solid #eee; +} +.pagination-item:first-child { + margin-bottom: -1px; +} + +/* Only provide a hover state for linked pagination items */ +a.pagination-item:hover { + background-color: #f5f5f5; +} + +@media (min-width: 30em) { + .pagination { + margin: 3rem 0; + } + .pagination-item { + float: left; + width: 50%; + } + .pagination-item:first-child { + margin-bottom: 0; + border-top-left-radius: 4px; + border-bottom-left-radius: 4px; + } + .pagination-item:last-child { + margin-left: -1px; + border-top-right-radius: 4px; + border-bottom-right-radius: 4px; + } +} diff --git a/themes/hyde/sass/print.scss b/themes/hyde/sass/print.scss new file mode 100644 index 0000000..da8f1df --- /dev/null +++ b/themes/hyde/sass/print.scss @@ -0,0 +1,19 @@ +.sidebar { + display: none !important; +} + +.content { + margin: 0 auto; + width: 100%; + float: none; + display: initial; +} + +.container { + width: 100%; + float: none; + display: initial; + padding-left: 1rem; + padding-right: 1rem; + margin: 0 auto; +} diff --git a/themes/hyde/screenshot.png b/themes/hyde/screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..5e218059f2324aa0ac71c960dbffcac8b4342df5 GIT binary patch literal 59296 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

L(<*ZXeZeDkR7iB?49Ud7> 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 + + + + + + + + + {% block title %}{{ config.title }}{% endblock title %} + + + + + + + + {% if config.generate_rss %} + + {% endif %} + + {% block extra_head %} + {% endblock extra_head %} + + + + {% block sidebar %} +
+
+
+ {% block sidebar_about %} +

{{ config.title }}

 + {% if config.description %} +

{{config.description}}

+ {% endif %} + {% endblock sidebar_about %} +
+ +
    + {% block sidebar_nav %} + {% for link in config.extra.hyde_links %} +
  • {{link.name}}
    • + {% endfor %} + {% endblock sidebar_nav %} +
+
+
+ {% endblock sidebar %} + +
+ {% block content %} +
+ {% for page in section.pages | reverse %} +
+

+ + {{ page.title }} + +

+ + {{ page.date | date(format="%Y-%m-%d") }} +
+ {% endfor %} +
+ {% endblock content %} +
+ + + + diff --git a/themes/hyde/templates/page.html b/themes/hyde/templates/page.html new file mode 100644 index 0000000..35acc97 --- /dev/null +++ b/themes/hyde/templates/page.html @@ -0,0 +1,10 @@ +{% extends "index.html" %} + +{% block content %} +
+

{{ page.title }}

+ {{ page.date | date(format="%Y-%m-%d") }} + {{ page.content | safe }} +
+{% endblock content %} + diff --git a/themes/hyde/theme.toml b/themes/hyde/theme.toml new file mode 100644 index 0000000..87d35bc --- /dev/null +++ b/themes/hyde/theme.toml @@ -0,0 +1,22 @@ +name = "hyde" +description = "A classic blog theme" +license = "MIT" +homepage = "https://github.com/Keats/gutenberg-hyde" +min_version = "0.4" +demo = "https://gutenberg-hyde.netlify.com" + +[extra] +hyde_sticky = true +hyde_reverse = false +hyde_theme = "" +hyde_links = [ +] + +[author] +name = "Vincent Prouillet" +homepage = "https://vincent.is" + +[original] +author = "mdo" +homepage = "http://markdotto.com/" +repo = "https://www.github.com/mdo/hyde" From d28f135df97b12fb5b5ce4e06839db4d9578a966 Mon Sep 17 00:00:00 2001 From: James Munns Date: Sat, 25 Aug 2018 22:10:18 -0700 Subject: [PATCH 2/5] Update theme based on our needs --- config.toml | 24 +++ content/_index.md | 24 +++ static/ewg-logo-blue-white-on-transparent.svg | 201 ++++++++++++++++++ themes/hyde/templates/index.html | 14 +- 4 files changed, 261 insertions(+), 2 deletions(-) create mode 100644 config.toml create mode 100644 content/_index.md create mode 100644 static/ewg-logo-blue-white-on-transparent.svg diff --git a/config.toml b/config.toml new file mode 100644 index 0000000..9a4ffa9 --- /dev/null +++ b/config.toml @@ -0,0 +1,24 @@ +# The URL the site will be built for +base_url = "https://blog.rust-embedded.org" + +title = "Rust Embedded Working Group" +description = """ +Blog of the Embedded Rust Working Group +""" + +# Whether to automatically compile all Sass files in the sass directory +compile_sass = true + +# Whether to do syntax highlighting +# Theme can be customised by setting the `highlight_theme` variable to a theme supported by Gutenberg +highlight_code = true + +# Whether to build a search index to be used later on by a JavaScript library +build_search_index = true + +theme = "hyde" + +generate_rss = true + +[extra] +# Put all your custom variables here diff --git a/content/_index.md b/content/_index.md new file mode 100644 index 0000000..3eb9347 --- /dev/null +++ b/content/_index.md @@ -0,0 +1,24 @@ ++++ +# Whether to sort by "date", "order", "weight" or "none". More on that below +sort_by = "date" + +# Template to use to render this section page +template = "index.html" + +# How many pages to be displayed per paginated page. +# No pagination will happen if this isn't set or if the value is 0 +paginate_by = 5 + +# If set, will be the path used by paginated page and the page number will be appended after it. +# For example the default would be page/1 +paginate_path = "page" + +# Whether the section pages should be in the search index. This is only used if +# `build_search_index` is set to true in the config +in_search_index = true + +# Whether to render that section homepage or not. +# Useful when the section is only there to organize things but is not meant +# to be used directly +render = true ++++ diff --git a/static/ewg-logo-blue-white-on-transparent.svg b/static/ewg-logo-blue-white-on-transparent.svg new file mode 100644 index 0000000..629cd71 --- /dev/null +++ b/static/ewg-logo-blue-white-on-transparent.svg @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/themes/hyde/templates/index.html b/themes/hyde/templates/index.html index 9deef03..6fd73c8 100644 --- a/themes/hyde/templates/index.html +++ b/themes/hyde/templates/index.html @@ -29,7 +29,9 @@
{% block sidebar_about %} -

{{ config.title }}

 + + + {% if config.description %}

{{config.description}}

{% endif %} @@ -50,7 +52,7 @@
{% block content %}
- {% for page in section.pages | reverse %} + {% for page in paginator.pages %}

@@ -59,8 +61,16 @@

{{ page.date | date(format="%Y-%m-%d") }} + {{ page.summary | safe }} + + + Read More +

{% endfor %} + {% if paginator.previous %}< < Back{% endif %} + {% if paginator.next and paginator.previous %}|{% endif %} + {% if paginator.next %}Next > >{% endif %}
{% endblock content %}
From 38d783c9c552900116e4d77ed34303144fd28d5b Mon Sep 17 00:00:00 2001 From: James Munns Date: Sat, 25 Aug 2018 22:10:55 -0700 Subject: [PATCH 3/5] Populate with newsletter content --- content/2018-03-15.md | 89 +++++++ content/2018-03-29.md | 224 +++++++++++++++++ content/2018-04-14.md | 77 ++++++ content/2018-04-28.md | 81 +++++++ content/2018-05-13-the-path-towards-stable.md | 229 ++++++++++++++++++ content/2018-05-15.md | 119 +++++++++ content/2018-05-28.md | 115 +++++++++ content/2018-07-15.md | 82 +++++++ content/2018-07-29.md | 107 ++++++++ content/2018-08-12.md | 66 +++++ content/2018-08-2x-psa-cortex-m-breakage.md | 156 ++++++++++++ 11 files changed, 1345 insertions(+) create mode 100644 content/2018-03-15.md create mode 100644 content/2018-03-29.md create mode 100644 content/2018-04-14.md create mode 100644 content/2018-04-28.md create mode 100644 content/2018-05-13-the-path-towards-stable.md create mode 100644 content/2018-05-15.md create mode 100644 content/2018-05-28.md create mode 100644 content/2018-07-15.md create mode 100644 content/2018-07-29.md create mode 100644 content/2018-08-12.md create mode 100644 content/2018-08-2x-psa-cortex-m-breakage.md diff --git a/content/2018-03-15.md b/content/2018-03-15.md new file mode 100644 index 0000000..5e2c67d --- /dev/null +++ b/content/2018-03-15.md @@ -0,0 +1,89 @@ ++++ +title = "The Embedded Working Group Newsletter - 1" +date = 2018-03-15 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the first newsletter of the [Embedded WG]! We will be releasing this newsletter on a bi-weekly basis, and we are looking to highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue! + +## Highlights + +* [Tock-OS] has released the [1.0 of their kernel], gotten the Rust Userspace library back in order, and are working on a [new register interface] +* [Emilgardis], [jamesmunns] and [ryankurte] have become collaborators of the [svd] and [svd2rust] projects. +* [hannobraun], [ilya-epifanov], [thejpster], [therealprof] have become collaborators of the [embedded-hal] project. +* [dvc94ch] has created the [riscv-rust] organization for all your embedded RISCV needs! +* [dylanmckay] has begun [rebasing][avr-rust-rebase] the avr-rust/rust fork onto a recent rust-lang/rust version, bringing in LLVM 6.0 support. + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +### `embedded-hal` drivers + +This is a list of recently released drivers that are part of the [Weekly Driver Initiative]. There are currently 5 Released Drivers, 14 WIP Drivers, and lots of TODOs! + +* [pcein] has [released][pcein-blog] the third weekly driver for the [`adc-mcp3008`], an 8-channel 10-bit ADC. +* [japaric] has [released][enc-blog] the fourth weekly driver for the [`enc28j60`], an Ethernet controller with SPI interface. +* [dbrgn] has [released][mcp-blog] the fifth weekly driver for the [`mcp3425`], a 16-bit ADC with I2C interface. + +## Thanks + +* Thanks to everyone who has been commenting on the [Embedded WG Issues], especially for the [Embedded Rust Book] tracking issue! +* [varkor] has fixed a [long standing LLVM bug][gh41315], that artificially increased the binary size of Rust programs, and backported the patch to rustc. +* LLD is now being shipped with the Rust toolchain. [FenrirWolf] [patched Xargo][xargo-lld] so that Xargo users can make use of it too. + +## Help Wanted + +If you have an embedded project that could use contributors or maintainers, leave a comment for [the next newsletter]! + +* We are [pretty close][cortex-m-rt-lld] to being able to use LLD to link Rust programs compiled for ARM Cortex-M but there are some [LLD bugs][lld-issues] that still need to be fixed. Help reporting these bugs upstream would be greatly appreciated! +* Incremental compilation is in the roadmap for this year but it doesn't work with `no_std` binaries due to an [old rustc bug][gh18807] related to linking. Help us fix it! There's a proposed solution [here]. +* We want to explore stabilizing some assembly operations in core as an alternative to the unstable asm! macro. We would love some help identifying the assembly operations that need to be provided this way as some can be implemented in external assembly files without losing +semantics. Details in issue [#63]. + +[#63]: https://github.com/rust-lang-nursery/embedded-wg/issues/63 +[1.0 of their kernel]: https://www.tockos.org/blog/2018/talking-tock-35/ +[`adc-mcp3008`]: https://crates.io/crates/adc-mcp3008 +[`enc28j60`]: https://crates.io/crates/enc28j60 +[`mcp3425`]: https://crates.io/crates/mcp3425 +[avr-rust-rebase]: https://github.com/avr-rust/rust/pull/91 +[cortex-m-rt-lld]: https://github.com/japaric/cortex-m-rt/issues/53 +[dbrgn]: https://github.com/dbrgn +[dvc94ch]: https://github.com/dvc94ch +[dylanmckay]: https://github.com/dylanmckay +[Embedded Rust Book]: https://github.com/rust-lang-nursery/embedded-wg/issues/56 +[Embedded WG Issues]: https://github.com/rust-lang-nursery/embedded-wg/issues +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg +[embedded-hal]: https://github.com/japaric/embedded-hal +[Emilgardis]: https://github.com/Emilgardis +[enc-blog]: http://blog.japaric.io/wd-4-enc28j60/ +[FenrirWolf]: https://github.com/FenrirWolf +[gh18807]: https://github.com/rust-lang/rust/issues/18807 +[gh41315]: https://github.com/rust-lang/rust/issues/41315 +[hannobraun]: https://github.com/hannobraun +[here]: https://github.com/rust-lang/rust/issues/47074#issuecomment-354588718 +[ilya-epifanov]: https://github.com/ilya-epifanov +[jamesmunns]: https://github.com/jamesmunns +[japaric]: https://github.com/japaric +[lld-issues]: https://github.com/japaric/cortex-m-rt/issues/53#issuecomment-371972935 +[mcp-blog]: https://blog.dbrgn.ch/2018/3/13/rust-mcp3425-driver/ +[new register interface]: https://www.tockos.org/blog/2018/talking-tock-36/ +[pcein]: https://github.com/pcein +[pcein-blog]: http://pramode.in/2018/02/24/an-introduction-to-writing-embedded-hal-based-drivers-in-rust/ +[riscv-rust]: https://github.com/riscv-rust +[ryankurte]: https://github.com/ryankurte +[svd2rust]: https://github.com/japaric/svd2rust +[svd]: https://github.com/japaric/svd +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/65 +[thejpster]: https://github.com/thejpster +[therealprof]: https://github.com/therealprof +[Tock-OS]: https://github.com/helena-project/tock +[varkor]: https://github.com/varkor +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[xargo-lld]: https://github.com/japaric/xargo/pull/200 \ No newline at end of file diff --git a/content/2018-03-29.md b/content/2018-03-29.md new file mode 100644 index 0000000..3ff2e19 --- /dev/null +++ b/content/2018-03-29.md @@ -0,0 +1,224 @@ ++++ +title = "The Embedded Working Group Newsletter - 2" +date = 2018-03-29 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the second bi-weekly newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/72 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* [dbrgn] has kicked off an investigation on how to [mock embedded-hal] to make testing sensors easier +* [emilgardis] and [ryankurte] are busy [refactoring] the [svd-parser] crate +* [japaric], [hannobraun], and [jamesmunns] from the [Embedded WG] attended the 2018 Rust All Hands in Berlin, working on our goal to make [stable embedded rust development] possible in 2018. See the bottom of this post for more details! + +[japaric]: https://github.com/japaric +[hannobraun]: https://github.com/hannobraun +[jamesmunns]: https://github.com/jamesmunns +[mock embedded-hal]: https://github.com/rust-lang-nursery/embedded-wg/issues/70 +[stable embedded rust development]: https://github.com/rust-lang-nursery/embedded-wg/issues/42 +[refactoring]: https://github.com/japaric/svd/issues/46 +[svd-parser]: https://github.com/japaric/svd +[ryankurte]: https://github.com/ryankurte +[emilgardis]: https://github.com/Emilgardis + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +### `embedded-hal` drivers + +This is a list of recently released drivers that are part of the [Weekly Driver Initiative]. There are currently 5 Released Drivers, 14 WIP Drivers, and lots of TODOs! + +* [danielgallagher0] has released their [hts221] humidity and temperature sensor driver +* [MrBuddyCasino] has released their I2C based [mcp9808] temperature sensor driver +* [Ilya Epifanov] has released their I2C based [si5351] CMOS clock generator driver, check out the [si5351 docs] for more info +* [Edwin Amsler] is working on their [axp209] PMIC driver +* [dbrgn] is working on their Sensirion [sgp30] low-power gas sensor driver +* [pcein] has started work on their [pcd8544] for SPI based LCD controllers used in displays like the Nokia 5110 +* [nordmoen] is working on their driver for the [hc-sr04] ultrasonic distance sensor + +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[danielgallagher0]: https://github.com/danielgallagher0 +[hts221]: https://medium.com/@pdanielgallagher/hts221-humidity-and-temperature-sensor-88056ea9e5fa +[MrBuddyCasino]: https://github.com/MrBuddyCasino +[mcp9808]: https://crates.io/crates/mcp9808 +[Ilya Epifanov]: https://github.com/ilya-epifanov +[si5351]: https://github.com/ilya-epifanov/si5351 +[si5351 docs]: https://docs.rs/si5351/0.1.5/si5351/ +[Edwin Amsler]: https://github.com/RandomInsano +[axp209]: https://github.com/RandomInsano/axp209-rs +[pcein]: https://github.com/pcein +[pcd8544]: https://github.com/pcein/pcd8544 +[dbrgn]: https://github.com/dbrgn +[sgp30]: https://github.com/dbrgn/sgp30-rs +[nordmoen]: https://github.com/nordmoen +[hc-sr04]: https://github.com/nordmoen/hc-sr04 + +### `embedded-hal` Board/Chip Support Crates + +* [DoumanAsh] has started work on their [stm32l4x6-hal] chip support crate + +[DoumanAsh]: https://github.com/DoumanAsh +[stm32l4x6-hal]: https://github.com/DoumanAsh/stm32l4x6_hal + +## Thanks + +* Thanks to all of the Rust Team and Working Group members who took time at the All Hands to tackle some important Embedded Issues +* Thanks to [Alex Chrichton] who pushed a fix to a [linker issue] mentioned in our [last newsletter] + +[Alex Chrichton]: https://github.com/alexcrichton +[linker issue]: https://github.com/rust-lang/rust/pull/49316 +[last newsletter]: https://github.com/rust-lang-nursery/embedded-wg/blob/master/newsletters/2018-03-15.md + +## Help Wanted + +* [Simon Sapin] posted some working code for the [DS3234] SPI RTC, and is looking for someone to turn it into a maintained crate! + +[Simon Sapin]: https://github.com/SimonSapin +[DS3234]: https://github.com/rust-lang-nursery/embedded-wg/issues/39#issuecomment-375262785 + +If you have an embedded project that could use contributors or maintainers, leave a comment for [the next newsletter]! + +# Special Feature: The Embedded WG at the 2018 Rust All Hands + +This week 15 or so Rust teams/working groups met for the Rust All Hands event in Berlin. Some members of the embedded WG were present and we had a chance to talk to the compiler, core and infra teams. + +These are the highlights of our talks. + +## Embedded Rust on stable + +We had previously identified 3 unstable features / issues that tie embedded development to the nightly channel in https://github.com/japaric/stable-embedded-rust. We talked to the other Rust teams about the possibility of addressing these issues in time for the 2018 edition release and the conclusion was that they thought that the timeline was possible. These are the 3 unstable features we are referring to: + +### Unstable Feature #1: `xargo` + +We'll ship a rust-std component (pre-compiled `core`+`compiler-builtins`) for the `thumb*` and `msp430` targets. This removes the need for `xargo` so people will be able to do something like the following to cross compile to ARM Cortex-M: + +```bash +rustup target add thumb7m-none-eabi +cargo build --target thumbv7m-none-eabi +``` + +**Tracking issue**: [rust-lang/rust#49382]. + +[rust-lang/rust#49382]: https://github.com/rust-lang/rust/issues/49382 + +### Unstable Feature #2: `compiler-builtins` + +`extern crate compiler_builtins` is unstable to directly use. The fix we have decided on is to inject that as part of the prelude you get from `#![no_std]`. + +So, today `#![no_std]` expands to something like this: + +``` rust +#![no_std] +extern crate core; +``` + +With our change the expansion will run like this: + +``` rust +#![no_std] +extern crate core; + +// but this doesn't #![feature(compiler_builtins_lib)] +extern crate compiler_builtins; +``` + +In the future we might want to merge `compiler-builtins` into `core` but that requires more effort and can still be done if we do the `#![no_std]` prelude approach right now. + +**Tracking issue:** [rust-lang/rust#49380] + +[rust-lang/rust#49380]: https://github.com/rust-lang/rust/issues/49380 + +### Unstable Feature #3: `panic_fmt` + +There's an accepted RFC (#2070) for a stable mechanism to select the behavior of `panic!` in `no_std` context, and there's a know issue where the arguments of `panic_fmt` are kept in the binary even when they are unused by the `panic_fmt` implementation (cf. [rust-lang/embedded-wg#41]). + +[rust-lang/embedded-wg#41]: https://github.com/rust-lang-nursery/embedded-wg/issues/41 + +The main concern here was whether we'll be able to fix the binary size problem with the accepted design or if we'll need some new design. The compiler team thinks that this can be fixed with the existing design using MIR only rlibs but it's unlikely this will get fixed in time for the edition release. [nagisa] will likely propose an alternate solution that involves having Cargo select the panic provider crate. + +[nagisa]: https://github.com/nagisa + +## Non critical unstable features + +There are some other unstable features that don't prevent you from doing embedded development, however they come up often when doing no-std development. We had a chat with people on the compiler team about them. + +### Unstable Feature #4: `const fn` + +This feature has been proposed for stabilization (cf. [rust-lang/rust#24111]). + +[rust-lang/rust#24111]: https://github.com/rust-lang/rust/issues/24111#issuecomment-376649804 + +### Unstable Feature #5: `asm!` + +**Background**: Some assembly operations can be implemented as external assembly files that are then called into using FFI; other ops though do need to be inlined into the function from which they are called to prevent losing semantics. Using external assembly file can be done on the stable channel. The second type of operation requires the unstable `asm!` macro. + +The compiler team is not 100% sure on whether they want to stabilize inline assembly for the edition release. The embedded WG has proposed an alternative proposal: expose *some* assembly operations that need to be inlined as "Rust intrinsics" -- in a similar fashion to how SIMD is being implemented; these intrinsics would be in the `core::asm::$ARCH` module and they could either be implemented by lowering to a LLVM intrinsic or using inline assembly. For example: + +``` rust +pub mod asm { + pub mod arm { + #[inline(always)] + pub fn cpsid() { + unsafe { + asm!("cpsid i" ::: "memory" : "volatile"); + } + } + } +} +``` + +These would be stable APIs with an unstable implementation. If LLVM assembler syntax changes, the implementations of these functions would have to be updated. + +The embedded WG will submit an RFC proposing the `asm` module and that will include a list of assembly operations that (a) are common and (b) need to be inlined for different architectures. + +### Unstable Feature #6: `#[used]` + +This experimental feature has been in the compiler for a while and it's required in some scenarios when using LTO to prevent the compiler from dead-stripping some function / `static` that needs to be in the final binary. + +We'll try to get it stabilized by the edition release but it's not a high priority feature. + +## Stability of the Embedded Targets + +We don't only want to make embedded Rust possible on stable; we also want to make sure the embedded targets don't regress. So we are going to add tests to rust-lang/rust CI to make sure regression block PRs from landing. + +That effectively will make some of the embedded targets into the tier 1 platform. The core team is fine with adding the `thumb*` targets (ARM Cortex-M) to tier 1. Less maintained, still in development and not fully mature targets like AVR, MSP430 and RISCV will become tier 2 -- they'll be tested but won't block PRs and rust-std binaries will be produced but it's not guaranteed there will be binaries available for all nightly / beta / stable releases. + +We'll open an issue to discuss with the infra team the exact tests we want to add and track progress on that, but have already told them about the kind of tests we want to add and they thought those kind of tests are possible to implement. The kind of tests we discussed were: + +- It compiles and links +- Runs the cross compiled binary in QEMU doesn't crash and exits with exit code 0. +- Tracking the binary size of a program compiled with `-Os` / `-Oz` and notify someone or fail the build if the size changes by +/- 5-10% or something. + +## LLVM backends that are not yet in rustc + +There are two embedded LLVM backends that have not yet been enabled in rustc for different reasons: AVR and RISCV. + +In the case of AVR the main reason is that some LLVM codegen bugs prevent you from building core for AVR. These bugs are related to 128-bit integers and formatting floats. The libs team discussed this some time ago and they decided they are fine with landing arch specific `#[cfg]` attributes to remove 128-bit integers and other things like float APIs. + +In the case of RISCV the LLVM backend is currently under active development and our current version of LLVM doesn't fully support RISCV. We would have to backport several patches to make RISCV work on our LLVM version. The core team feels OK with backporting those patches as long as they have already landed in upstream LLVM, and are not still under review. + +## Tooling + +Getting tooling for e.g. binary inspection (e.g. `objdump`) can be hard on some platforms (e.g. Windows) specially for architecture which currently are not too widely used (e.g. RISCV). We can improve the situation here by shipping llvm tools with the Rust toolchain -- with one set of those tools you can inspect all the architectures that Rust supports. These are the thoughts of the core / infra team regarding this: + +- We put these tools in the sysroot and have them always shipped with the Rust toolchain so no `rustup component add` required -- this is already the case with `lld`. It might not be possible to provide these tools on all platforms but it's very likely they'll be available on tier 1 platforms. +- We do *not* add these tools to the user `$PATH`. Instead some Cargo subcommand will be created by the embedded WG (e.g. `cargo objdump`) and that subcommand will look for `llvm-objdump` in the sysroot and do the right thing. +- We make no guarantees about the semantics and interface of these tools being preserved over time (e.g. CLI changes, user facing output format changes, etc.). + +### The Embedded Rust Book + +We decided on an initial audience for the embedded book; we will be targeting people that know some embedded stuff *and* some Rust. The main reason for this is that if someone knows one and not the +other then they can go and read existing Rust documentation or the Discovery book and then read the embedded book. For more details check [rust-lang-nursery/embedded-wg#56]. + +[rust-lang-nursery/embedded-wg#56]: https://github.com/rust-lang-nursery/embedded-wg/issues/56 diff --git a/content/2018-04-14.md b/content/2018-04-14.md new file mode 100644 index 0000000..826716e --- /dev/null +++ b/content/2018-04-14.md @@ -0,0 +1,77 @@ ++++ +title = "The Embedded Working Group Newsletter - 3" +date = 2018-04-14 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the third bi-weekly newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/84 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* Crates for the Embedded Rust Ecosystem are now being tracked in the [Awesome Embedded Rust] repository +* Progress has been made as part of the [Embedded Rust on Stable] initiative, including: + * `extern crate compiler_builtins` is [now included in the no_std prelude] + * [xargo no longer needed] for ARM Cortex-M development +* We also made some progress on simplifying the embedded development setup: You can now link Embedded Rust programs [using lld] +* [Wilfried] kicked off a blog series about [using embedded rust] +* [Andre Richter] is writing a tutorial for using Rust to write [bare metal Raspberry Pi 3] applications +* The Embedonomicon and the Embedded Rust Books are [now kept] in the [Embedded WG] repository, and pull requests are welcome! + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Embedded Rust on Stable]: https://github.com/rust-lang-nursery/embedded-wg/issues/42 +[now included in the no_std prelude]: https://users.rust-lang.org/t/psa-breaking-change-extern-crate-compiler-builtins-is-now-included-in-no-std-crates/16704 +[xargo no longer needed]: https://users.rust-lang.org/t/psa-you-no-longer-need-xargo-to-do-arm-cortex-m-development/16703 +[using lld]: https://users.rust-lang.org/t/cortex-m-rt-v0-4-0-now-you-can-link-arm-cortex-m-programs-using-lld/16751 +[Wilfried]: https://github.com/ithinuel +[using embedded rust]: http://ithinuel.me/embedded-rust-why/ +[Andre Richter]: https://github.com/andre-richter +[bare metal Raspberry Pi 3]: https://github.com/andre-richter/rust-raspi3-tutorial +[now kept]: https://github.com/rust-lang-nursery/embedded-wg/pull/78 + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* [japaric] released an initial version of [cargo-binutils], which will allow you to use LLVM's binutils (like `nm`, `size`, `objcopy`, etc.) in the format `cargo objcopy` (once [issue 49584] has landed) +* [myeisha] released the first version of their [thumb2-stack-size] tool, which helps determine the maximum stack size used in embedded code + +[japaric]: https://github.com/japaric +[cargo-binutils]: https://github.com/japaric/cargo-binutils +[issue 49584]: https://github.com/rust-lang/rust/issues/49584 +[myeisha]: https://github.com/myeisha +[thumb2-stack-size]: https://crates.io/crates/thumb2-stack-size + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | +| :--- | :----- | :---- | +| [Device Crates] | released | 13 | +| [HAL Impl Crates] | released | 10 | +| [Driver Crates Released] | released | 7 | +| [Driver Crates WIP] | WIP | 26 | + +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip + +## Help Wanted + +* We need help working on [RFC2070], stabilizing usage of custom Panic behavior. [nagisa] is willing to mentor! +* If you use inline assembly in your Embedded Rust programs, help us capture what assembly operations are [used most often] so we can stabilize them as intrinsics + +[RFC2070]: https://github.com/rust-lang/rust/issues/44489#issuecomment-381324623 +[nagisa]: https://github.com/nagisa +[used most often]: https://github.com/rust-lang-nursery/embedded-wg/issues/63#issue-305114817 diff --git a/content/2018-04-28.md b/content/2018-04-28.md new file mode 100644 index 0000000..2eb9a76 --- /dev/null +++ b/content/2018-04-28.md @@ -0,0 +1,81 @@ ++++ +title = "The Embedded Working Group Newsletter - 4" +date = 2018-04-28 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the fourth bi-weekly newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/93 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* The [Embedded WG] IRC meetings are now explicitly public, and the agendas for the next meeting can be found in the [WG Issues], like [this issue] for the next meeting +* [David] shared his utility [`Form`], which takes a single `lib.rs` (like those created by `svd2rust` or `bindgen`), and splits it into structured modules. Check out the [`nrf52`] Chip Support Crate as an example, and try it out for your generated projects! +* [astro] shared [`managed`], A library that provides a way to logically own objects, whether or not heap allocation is available + +[WG Issues]: https://github.com/rust-lang-nursery/embedded-wg/issues +[this issue]: https://github.com/rust-lang-nursery/embedded-wg/issues/91 +[David]: https://github.com/djmcgill +[`Form`]: https://github.com/djmcgill/form +[`nrf52`]: https://github.com/jamesmunns/nrf52/tree/master/src +[astro]: https://github.com/astro +[`managed`]: https://crates.io/crates/managed + + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* [Daniel] started work on [`bluetooth-hci`], an abstraction layer for HCI based Bluetooth Controllers, and is using it in his [`bluenrg`] crate for STMicro's BlueNRG RF modules +* [cr1901] shared his [`AT2XT`] project, an adapter that allows use of low cost PS2 keyboards with older computers that expect (now very expensive) XT keyboards. The firmware for this project is based on `rtfm`, and runs on an `msp430` microcontroller. Check out the [short blurb] by [cr1901] summarizing the project +* [hannobraun] released v0.3 of his [`lpc82x`] Chip Support Crate for NXP's LPC82x family of microcontrollers, as well as v0.1 of [`lpc82x-hal`]. Check out the [lpc82x-hal announcement] here! +* [japaric] released v0.3.1 of [`heapless`] which now contains fixed capacity implementations of `HashMap` and `HashSet` that work on `no_std`, do not require an allocator, and use `u32` hashes (instead of the default `u64`). + +[`AT2XT`]: https://github.com/cr1901/AT2XT +[cr1901]: https://github.com/cr1901 +[japaric]: https://github.com/japaric +[`heapless`]: https://crates.io/crates/heapless +[Daniel]: https://github.com/danielgallagher0 +[`bluetooth-hci`]: https://github.com/danielgallagher0/bluetooth-hci +[`bluenrg`]: https://github.com/danielgallagher0/bluenrg +[hannobraun]: https://github.com/hannobraun +[`lpc82x`]: https://crates.io/crates/lpc82x +[`lpc82x-hal`]: https://crates.io/crates/lpc82x-hal +[lpc82x-hal announcement]: https://users.rust-lang.org/t/lpc82x-hal-0-1-hardware-abstraction-layer-for-nxp-lpc82x-mcus/17116 +[short blurb]: https://github.com/rust-lang-nursery/embedded-wg/pull/94#issuecomment-385172043 + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | +| :--- | :----- | :---- | +| [Device Crates] | released | 12 | +| [HAL Impl Crates] | released | 10 | +| [Board Support Crates] | released | 6 | +| [Driver Crates Released] | released | 7 | +| [Driver Crates WIP] | WIP | 27 | + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Board Support Crates]: https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip + +## Help Wanted + +* The [Embedded WG] is looking for contributors for the [Rustfest Impl Period]. If you will be attending RustFest in Paris, let us know! +* Progress is being made towards [Stable Embedded Rust], try out the current preview, and we would love some feedback! + +[Stable Embedded Rust]: https://github.com/rust-lang-nursery/embedded-wg/issues/42#issuecomment-384524779 +[Rustfest Impl Period]: https://github.com/rust-lang-nursery/embedded-wg/issues/90 diff --git a/content/2018-05-13-the-path-towards-stable.md b/content/2018-05-13-the-path-towards-stable.md new file mode 100644 index 0000000..ac1de1a --- /dev/null +++ b/content/2018-05-13-the-path-towards-stable.md @@ -0,0 +1,229 @@ ++++ +title = "The Path Towards Stable" +date = 2018-05-13 +draft = false +in_search_index = true +template = "page.html" ++++ + +## Cortex-M library development now possible on beta and the path towards stable embedded Rust + +> **TL;DR** +> +> * 1.27 = embedded (Cortex-M) *library* development on stable +> * 1.28 or 1.29 = embedded (Cortex-M) *application* development on stable +> * We are making breaking changes in the ecosystem in order to move towards development on the +> stable channel +> * If you are a crate maintainer / author, make sure you test your crates with the new versions of +> `cortex-m` (and similar) on the current `beta` release of Rust +> * If the latest version of a dependency doesn't compile on `beta`, file an issue and/or ping us on +> the #rust-embedded IRC channel +> * Thanks for your patience! + +We are happy to announce that *library* development for the Cortex-M targets is now possible on the +beta channel! :tada: + + + +For example, to cross compile a library crate for the Cortex-M3 you would run these commands: + +``` console +$ # switch to the beta channel +$ rustup default beta + +$ # install the rust-std component (pre-compiled core) for the target +$ rustup target add thumbv7m-none-eabi + +$ # get some source to build +$ cargo clone cortex-m --vers 0.5.0 && cd cortex-m + +$ # then It Just Works +$ cargo build --target thumbv7m-none-eabi +``` + +What about embedded *application* development? There is just a single unstable feature that prevents +us from building a `no_std` binary on stable: the `panic_fmt` lang item. This unstable feature will +soon be removed in favor of the `#[panic_implementation]` feature ([implementation PR]), which is +slated for stabilization in time for the edition release (we are hoping to stabilize it as early as +1.28 but we'll see). + +[implementation PR]: https://github.com/rust-lang/rust/pull/50338 + +## Making the Cortex-M ecosystem work on stable + +"`no_std` binaries are *possible* on stable" is very different from "*my* embedded application +builds on stable". The later requires all the dependencies to also compile on stable. So we are +starting to migrate the Cortex-M ecosystem to work on stable. All the crates listed below are now +compiling on the beta channel. + +Legend: `crate-name` - link to CHANGELOG - link to stabilization PR - ~removed unstable features~ + +- [`cortex-m-quickstart`][c0] - [CHANGELOG][ch0] - [PR][p0] + +[c0]: https://docs.rs/cortex-m-quickstart/~0.3 +[ch0]: https://github.com/japaric/cortex-m-quickstart/blob/master/CHANGELOG.md#v030---2018-05-12 +[p0]: https://github.com/japaric/cortex-m-quickstart/pull/29 + +- [`cortex-m-rt`][c1] - [CHANGELOG][ch1] - [PR][p1] - ~asm!~ ~core_intrinsics~ ~global_asm!~ + ~lang_items~ ~linkage~ ~naked_functions~ ~used~ + +[c1]: https://crates.io/crates/cortex-m-rt/0.5.0 +[ch1]: https://github.com/japaric/cortex-m-rt/blob/master/CHANGELOG.md#v050---2018-05-12 +[p1]: https://github.com/japaric/cortex-m-rt/pull/69 + +- [`cortex-m-semihosting`][c2] - [CHANGELOG][ch2] - [PR][p2] + +[c2]: https://crates.io/crates/cortex-m-semihosting/0.3.0 +[ch2]: https://github.com/japaric/cortex-m-semihosting/blob/master/CHANGELOG.md#v030---2018-05-10 +[p2]: https://github.com/japaric/cortex-m-semihosting/pull/16 + +- [`cortex-m`][c3] - [CHANGELOG][ch3] - [PR][p3] - ~asm!~ ~const_fn~ + +[c3]: https://crates.io/crates/cortex-m/0.5.0 +[ch3]: https://github.com/japaric/cortex-m/blob/master/CHANGELOG.md#v050---2018-05-11 +[p3]: https://github.com/japaric/cortex-m/pull/88 + +- [`embedded-hal`][c4] - [CHANGELOG][ch4] - [PR][p4] - ~never_type~ + +[c4]: https://crates.io/crates/embedded-hal/0.2.0 +[ch4]: https://github.com/japaric/embedded-hal/blob/master/CHANGELOG.md#v020---2018-05-12 +[p4]: https://github.com/japaric/embedded-hal/pull/80 + +- [`f3`][c5] - [CHANGELOG][ch5] - [PR][p5] + +[c5]: https://crates.io/crates/f3/0.6.0 +[ch5]: https://github.com/japaric/f3/blob/master/CHANGELOG.md#v060---2018-05-12 +[p5]: https://github.com/japaric/f3/pull/93 + +- [`l3gd20`][c6] - [CHANGELOG][ch6] - [PR][p6] - ~Unsized~ + +[c6]: https://crates.io/crates/l3gd20/0.2.0 +[ch6]: https://github.com/japaric/l3gd20/blob/master/CHANGELOG.md#v020---2018-05-12 +[p6]: https://github.com/japaric/l3gd20/pull/4 + +- [`lsm303dlhc`][c7] - [CHANGELOG][ch7] - [PR][p7] - ~Unsized~ + +[c7]: https://crates.io/crates/lsm303dlhc/0.2.0 +[ch7]: https://github.com/japaric/lsm303dlhc/blob/master/CHANGELOG.md#v020---2018-05-12 +[p7]: https://github.com/japaric/lsm303dlhc/pull/4 + +- [`stm32f103xx`][c8] - [CHANGELOG][ch8] - [PR][p8] - ~const_fn~ ~global_asm!~ ~try_from~ + ~use_extern_macros~ ~used~ + +[c8]: https://crates.io/crates/stm32f103xx/0.10.0 +[ch8]: https://github.com/japaric/stm32f103xx/blob/master/CHANGELOG.md#v0100---2018-05-12 +[p8]: https://github.com/japaric/stm32f103xx/pull/24 + +- [`stm32f30x-hal`][c9] - [CHANGELOG][ch9] - [PR][p9] - ~never_type~ + +[c9]: https://crates.io/crates/stm32f30x-hal/0.2.0 +[ch9]: https://github.com/japaric/stm32f30x-hal/blob/master/CHANGELOG.md#v020---2018-05-12 +[p9]: https://github.com/japaric/stm32f30x-hal/pull/25 + +- [`stm32f30x`][c10] - [CHANGELOG][ch10] - [PR][p10] - ~const_fn~ ~global_asm!~ ~try_from~ + ~use_extern_macros~ ~used~ + +[c10]: https://crates.io/crates/stm32f30x/0.7.0 +[ch10]: https://github.com/japaric/stm32f30x/blob/master/CHANGELOG.md#v070---2018-05-12 +[p10]: https://github.com/japaric/stm32f30x/pull/16 + +- [`svd2rust`][c11] (output of) - [CHANGELOG][ch11] - [PR][p11] - ~const_fn~ ~global_asm!~ + ~try_from~ ~use_extern_macros~ ~used~ + +[c11]: https://crates.io/crates/svd2rust/0.13.0 +[ch11]: https://github.com/japaric/svd2rust/blob/master/CHANGELOG.md#v0130---2018-05-12 +[p11]: https://github.com/japaric/svd2rust/pull/203 + +There's a lot of breaking changes there but the most visible one is `cortex-m-rt` because it changes +how applications are structured. Check the [`cortex-m-quickstart`][c0] template for instructions on +how to set up an embedded application using the latest versions of everything. + +There are still a lot of crates that will need to be updated to work on beta. Among the more general +purpose ones we have [`heapless`] and [`cortex-m-rtfm`], which needs to be update to work with +`cortex-m-rt` v0.5.0. + +[`heapless`]: https://crates.io/crates/heapless +[`cortex-m-rtfm`]: https://crates.io/crates/cortex-m-rtfm + +### How you can help us + +Try to compile your Cortex-M crate using the beta channel! If your crate is an application the build +will certainly fail, but check if all the dependencies, excluding the [panic handler crate][phc], +compile on beta. If any dependency doesn't compile on the beta channel let the author know, but +first check if there's a new version of the crate that already compiles on the beta channel. And if +you feel up to the task you could even send a PR to the dependency to make it compile on beta -- the +list of stabilization PRs in the previous section may give you a clue on how to move the crate to +beta. + +If you are the author of a Cortex-M device crate, a crate generated using `svd2rust`, moving it to +stable only requires regenerating it using `svd2rust` v0.13.0. Do note that the generation process +[has changed] for the Cortex-M target; also make sure you bump the minor version when you publish a +new version. + +[has changed]: https://docs.rs/svd2rust/0.13.0/svd2rust/#usage + +If you are the author of a driver crate or a HAL implementation, please update your crate to use +v0.2.0 of `embedded-hal` and test that it builds on beta. Make sure you bump the minor version when +you publish a new version of your crate -- bumping the version of the `embedded-hal` dependency is a +breaking change (drivers that depend on `embedded-hal` v0.1.0 can't be used with HAL implementation +crates that depend on `embedded-hal` v0.2.0). + +If you are porting an application to the newest `cortex-m-*` crates you may hit these errors: + +- "error: requires `start` lang_item" on binary crates. You need to switch from the standard `main` + interface to `#![no_main]` + `entry!`. Use the [examples][qse] in the quickstart template as a + reference. + +[qse]: https://docs.rs/cortex-m-quickstart/0.3.0/cortex_m_quickstart/examples/_0_minimal/index.html + +- "error[E0015]: calls in statics are limited to constant functions, tuple structs and tuple + variants". `const fn` is not a stable feature so it's not used in the API by default. The + `cortex-m` provides a `"const-fn"` feature to opt into this unstable feature and expose `const` + functions in the API; other dependencies should / probably provide a similar feature. + +## What does this all mean for you? + +To those of you who have been doing embedded development on nightly: things will get *much easier* +from now on. We have reduced the number of unstable features in core crates of the Cortex-M +ecosystem to **zero**. Although you will have to continue to use nightly for application development +you can expect zero breakage from these crates when updating the nightly compiler. There is one +expected breakage coming soon though: `panic_fmt` will be removed as announced above. This will +break the [panic handler crates][phc]; however, the breakage will be isolated to those crates and +the fix will consist of simply updating the dependency version. + +[phc]: https://crates.io/keywords/panic-impl + +To those of you who have been meaning to dive into embedded Rust development: we'll soon be done +with our "embedded Rust on stable" tasks and we'll move our focus to documenting the embedded +development process, tooling and ecosystem. The [embedded Rust book][book] will become the resource +to get started on embedded Rust, but it doesn't quite exist right now. + +[book]: https://github.com/rust-lang-nursery/embedded-wg/blob/master/books/embedded-rust-book/README.md + +## What about architectures other than ARM Cortex-M? + +The path carved for ARM Cortex-M can be followed by the other architectures (ARM Cortex-R, AVR, +MSP430, RISCV, etc.). Each architecture presents its own extra set of challenges though: + +- MSP430 being the second oldest embedded / `no_std` target is the closest one to make it to stable + (as a tier 2 target) by the edition release. The main blocker is that `extern "msp430-interrupt"` + is not available on stable but I think that may be possible to work around using external C / + assembly files + FFI. + +- Both AVR and RISCV are blocked from being included in the Rust compiler due to either the + immaturity of the LLVM backend or LLVM backend bugs. Not many (embedded) Rust developers can also + hack LLVM backends so we are short handed on the AVR front; OTOH, the RISCV is being actively + developed by third parties so it's probably just a matter of time before we add it to rustc. + +- ARM Cortex-R LLVM backend is probably in good shape due to the similarities between its + instruction set and the ARM Cortex-M instruction set, so adding the target to the compiler should + be straightforward. However, the crate ecosystem is nonexistent at this point so there's a lot of + work to be done on that front. + +--- + +This work is part of the [embedded WG][ewg] effort towards [making embedded development possible on +the stable channel][stable]. (We are almost done! :tada:) + +[ewg]: https://github.com/rust-lang-nursery/embedded-wg +[stable]: https://github.com/rust-lang-nursery/embedded-wg diff --git a/content/2018-05-15.md b/content/2018-05-15.md new file mode 100644 index 0000000..d379b95 --- /dev/null +++ b/content/2018-05-15.md @@ -0,0 +1,119 @@ ++++ +title = "The Embedded Working Group Newsletter - 5" +date = 2018-05-15 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the fifth bi-weekly newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/98 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* We had a bonus Embedded-WG Newsletter this week about the [path forward] towards stable Embedded Rust, and what you can do as a crate maintainer to help with the effort! +* The Tock-OS project posted about their [MMIO Registers], contrasting them to crates generated by `svd2rust` +* There were a couple of great posts about developing with Rust on Embedded targets from [219 Design] and [nercury] +* If Game Boy Advance development with Rust sounds interesting to you, make sure you check out the [rusty-TONC] and [stdgba] projects + +[path forward]: https://users.rust-lang.org/t/cortex-m-library-development-now-possible-on-beta-and-the-path-towards-stable-embedded-rust/17420 +[MMIO Registers]: https://www.tockos.org/blog/2018/mmio-registers/ + +[219 Design]: https://www.219design.com/rust-on-the-stmicro-nucleo/ +[nercury]: https://nercury.github.io/rust/embedded/experiments/2018/04/29/rust-embedded-01-discovery-vl-flipping-bits.html + +[rusty-TONC]: https://github.com/tbelaire/rusty-TONC +[stdgba]: https://github.com/jkarns275/stdgba + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* [Kjetil Kjeka] shared their crate [uX] pronounced as "unsigned X" for working with non standard integer types (like `u7`, `u63`, etc) which act like the built in unsigned integer types +* [Adam Greig] shared two crates: + * [stm32-rs], a tool for cleaning up Chip Support Crates for STM32 microcontrollers and making it easier to work between multiple devices + * [blethrs], an ethernet bootloader for STM32F4 chips, using the [smoltcp] networking stack +* [James Waples] released a driver for [ssd1306] based OLED displays, read the [announcement blog] for more info +* [John Scarrott] released a Chip Support Crate for the [nRF52840] chip from Nordic Semiconductor +* [Kerem] posted a new Chip Support Crate for the Nordic Semiconductor nRF51, and joined development of the existing [nrf51-hal] HAL Impl Crate +* [Teo Röijezon] released a combo of a [stm32f0x0] Chip Support Crate, as well as a [stm32f0x0-hal] HAL Impl Crate +* [Rahul Thakoor] shipped a driver crate for [mma7660fc] based 3-axis accelerometers. Check out the [mma7660fc blog] announcement +* [whitequark] shared their [log_buffer] crate for storing UTF-8 text in a ring buffer, and accessing it as `&str`s +* [Michael] shared [proptest], a tool for performing Property Based Testing, which now has no_std support thanks to a PR from [Zack Pierce] +* [theJPster] has been working on [Monotron] - a small 8-bit style home computer with a ROM written in Rust - ready for his talk at [RustFest]. For this, he's been working on crates for [generating VGA video], [decoding PS/2 keyboard scancodes] and [interactive text-based menu systems]. + +[Kjetil Kjeka]: https://github.com/kjetilkjeka +[uX]: https://crates.io/crates/ux + +[Adam Greig]: https://github.com/adamgreig +[stm32-rs]: https://github.com/adamgreig/stm32-rs +[blethrs]: https://github.com/AirborneEngineering/blethrs +[smoltcp]: https://github.com/m-labs/smoltcp + +[James Waples]: https://github.com/jamwaffles +[ssd1306]: https://crates.io/crates/ssd1306 +[announcement blog]: https://wapl.es/electronics/rust/2018/04/30/ssd1306-driver.html + +[John Scarrott]: https://github.com/jscarrott +[nRF52840]: https://crates.io/crates/nrf52840 + +[Kerem]: https://github.com/krk +[nrf51-hal]: https://crates.io/crates/nrf51-hal + +[Teo Röijezon]: https://github.com/teozkr +[stm32f0x0]: https://crates.io/crates/stm32f0x0 +[stm32f0x0-hal]: https://crates.io/crates/stm32f0x0-hal + +[Rahul Thakoor]: https://github.com/rahul-thakoor +[mma7660fc]: https://crates.io/crates/mma7660fc +[mma7660fc blog]: https://rahul-thakoor.github.io/an-i2c-rust-driver-for-mma7660fc-based-3-axis-digital-accelerometer/ + +[whitequark]: https://github.com/whitequark +[log_buffer]: https://github.com/whitequark/rust-log_buffer + +[Michael]: https://github.com/memoryruins +[proptest]: https://github.com/AltSysrq/proptest +[Zack Pierce]: https://github.com/ZackPierce + +[theJPster]: https://github.com/thejpster +[Monotron]: https://github.com/thejpster/monotron +[RustFest]: https://paris.rustfest.eu/ +[generating VGA video]: https://github.com/thejpster/vga-framebuffer-rs +[decoding PS/2 keyboard scancodes]: https://github.com/thejpster/pc-keyboard +[interactive text-based menu systems]: https://github.com/thejpster/menu + + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | +| :--- | :----- | :---- | +| [Device Crates] | released | 12 | +| [HAL Impl Crates] | released | 10 | +| [Board Support Crates] | released | 6 | +| [Driver Crates Released] | released | 9 | +| [Driver Crates WIP] | WIP | 29 | + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Board Support Crates]: https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip + +## Help Wanted + +* Make sure to check out the [path forward] post, and report any issues you find! +* Raspberry Fields is a festival of digital making, centered around the Raspberry Pi. It's taking place on Saturday 30 June and Sunday 1 July, in Cambridge, England. [theJPster] would love to set up a Rust stall, to talk to everyone about the advantages Rust offers and how they can get in to Rust on the Raspberry Pi. But to make that work, he needs your help! If you're interested, contact [@therealjpster] on Twitter or email . +* Some members of the embedded WG will attend the [RustFest] impl days in two weeks. If you want to make Rust awesome for embedded development come help us! We have [tasks with mentors and some hardware to give away!][impl-days]. Let us know if you are interested in helping out by commenting on that issue. + +[@therealjpster]: https://twitter.com/therealjpster +[impl-days]: https://github.com/rust-lang-nursery/embedded-wg/issues/90#issuecomment-389321129 diff --git a/content/2018-05-28.md b/content/2018-05-28.md new file mode 100644 index 0000000..504e62a --- /dev/null +++ b/content/2018-05-28.md @@ -0,0 +1,115 @@ ++++ +title = "The Embedded Working Group Newsletter - 6" +date = 2018-07-01 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the sixth newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +This newsletter covers the past ~6 weeks. + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/103 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* [Jacob Creedon] gave an introduction talk about using Rust with embedded systems at the [Teardown Conference] in Portland, check out [Jacob's Slides] or the [Video of Jacob's Talk] +* The [Embedded WG]'s own [theJPster] talked about the [Monotron] at [RustFest Paris], you can see [JP's Slides], or check out the [Video of JP's Talk] +* [Jorge Aparicio], [Vadzim Dambrouski] and [Hanno Braun] from the embedded WG also attended RustFest Paris and the following impl days. They worked towards embedded Rust on stable, better embedded Rust tooling and better MSP430 support; gave away some hardware; and chatted with lots of people interested in embedded Rust. +* The `#[panic_implementation]` feature has [landed][panic-impl-pr] and has been proposed for stabilization ([FCP merge][panic-impl-fcp]). This feature lets you define the behavior of `panic!` in `#[no_std]` context and it's the final piece for making embedded Rust development possible on the stable channel. :tada: +* The [Discovery] book has been updated to work with the [preview of stable embedded Rust]. +* A new [`llvm-tools` rustup component] is now available on recent nightly releases. It contains LLVM tools to inspect Rust binaries regardless of their target architecture. One set of tools for ARM Cortex-M, MSP430, x86_64 and other architectures! + +[theJPster]: https://github.com/thejpster +[Monotron]: https://github.com/thejpster/monotron +[RustFest Paris]: https://paris.rustfest.eu/ +[JP's Slides]: http://railwayelectronics.blogspot.co.uk/2018/05/talking-about-monotron-at-rustfest.html +[Video of JP's Talk]: https://media.ccc.de/v/rustfest18-11-monotron_making_a_80s_style_computer_with_a_20_dev_kit + +[Jacob Creedon]: https://github.com/jcreedon +[Jacob's Slides]: http://github.jcreedon.com/static/EmbeddedWithRustSlidesTeardown2018.pdf +[Video of Jacob's Talk]: http://youtu.be/g25xsK3HKkE +[Teardown Conference]: https://www.crowdsupply.com/teardown/portland-2018 + +[Jorge Aparicio]: https://github.com/japaric +[Vadzim Dambrouski]: https://github.com/pftbest +[Hanno Braun]: https://github.com/hannobraun + +[panic-impl-pr]: https://github.com/rust-lang/rust/pull/50338 +[panic-impl-fcp]: https://github.com/rust-lang/rust/issues/44489#issuecomment-398965878 + +[Discovery]: https://github.com/japaric/discovery +[preview of stable embedded Rust]: https://users.rust-lang.org/t/cortex-m-library-development-now-possible-on-beta-and-the-path-towards-stable-embedded-rust/17420 + +[`llvm-tools` rustup component]: https://internals.rust-lang.org/t/llvm-tools-a-new-rustup-component-for-binary-inspection-objdump-nm-size-and-profiling-prota/7830 + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* [rudihorn] shared [light-cli], a lightweight, no_std, and heapless CLI tool +* [Paolo Teti] shared [ti-hercules-bsp], a board support package for Texas Instruments TMS570 MCUs, used by safety critical industries such as automotive and aerospace +* [Marcel Buesing] posted their driver crate for the [bme680] environmental sensor +* [Roy Smeding] is working on support for the [stm32f334] chip from STMicro +* The [Embedded WG]'s own [Jonathan Soo] announced his project, [Bobbin SDK], a set of tools to make it easier to share code between different chips from the same or different vendors +* [Eitan Mosenkis] did [a major update] of their [esp-rs] script which produces a project to compile Rust code for the ESP8266 via the [mrustc] Rust to C compiler. +* [Hanno Braun] released v0.2 of [lpc82x-hal], which includes a radical simplification of the API, allowing for stronger compile-time state guarantees. Check out the [lpc82x-hal announcement] for more info! + +[rudihorn]: https://github.com/rudihorn +[light-cli]: https://github.com/rudihorn/light-cli + +[Paolo Teti]: https://github.com/paoloteti +[ti-hercules-bsp]: https://github.com/paoloteti/ti-hercules-bsp + +[Marcel Buesing]: https://github.com/marcelbuesing +[bme680]: https://github.com/marcelbuesing/bme680 + +[Jonathan Soo]: https://github.com/jcsoo +[Bobbin SDK]: http://www.bobbin.io/blog/post/bobbin_sdk_richer_hardware/ + +[Roy Smeding]: https://github.com/roysmeding +[stm32f334]: https://github.com/roysmeding/stm32f334/ + +[Eitan Mosenkis]: https://github.com/emosenkis +[a major update]: https://users.rust-lang.org/t/rust-on-esp8266/12933/8 +[esp-rs]: https://github.com/emosenkis/esp-rs +[mrustc]: https://github.com/thepowersgang/mrustc + +[lpc82x-hal]: https://github.com/braun-robotics/rust-lpc82x-hal +[lpc82x-hal announcement]: https://users.rust-lang.org/t/lpc82x-hal-0-2-rust-on-lpc82x-microcontrollers/18144 + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | +| :--- | :----- | :---- | +| [Device Crates] | released | 14 | +| [HAL Impl Crates] | released | 11 | +| [Board Support Crates] | released | 6 | +| [Driver Crates Released] | released | 9 | +| [Driver Crates WIP] | WIP | 30 | + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Board Support Crates]: https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip + +## Help Wanted + +* We are seeking [input about the user interface] the [`cargo-binutils`] subcommands should expose. These subcommands provide access to the LLVM tools provided by the `llvm-tools` rustup component mentioned above. +* Are you using embedded Rust in production? We are [collecting commercial testimonials] about embedded Rust for the webpage the embedded WG will have on the revamped rust-lang.org website. Even if you can't give details about the product you are building we would still love to hear from you! + +[input about the user interface]: https://github.com/japaric/cargo-binutils/issues +[`cargo-binutils`]: https://github.com/japaric/cargo-binutils + +[collecting commercial testimonials]: https://github.com/rust-lang-nursery/embedded-wg/issues/108 diff --git a/content/2018-07-15.md b/content/2018-07-15.md new file mode 100644 index 0000000..10f1820 --- /dev/null +++ b/content/2018-07-15.md @@ -0,0 +1,82 @@ ++++ +title = "The Embedded Working Group Newsletter - 7" +date = 2018-07-15 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the seventh newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/121 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* We have launched the [Embedded WG Twitter]! We'll be publishing things like our newsletter here, so go ahead and follow to stay up to date. If you have something you're working on and want to share, feel free to @ us so we can retweet it! +* Work started on [porting] MUSL's `libm` (for math functions like `sin`, `cos`, etc.) has started, and already has [26 of 32 functions] ported! This crate will hopefully be included in the `core` of Rust, so it can be used by `no_std` targets such as embedded or wasm. +* The Atomic\*.{load,store} API is [now available] for the thumbv6m and msp430 targets. + +[Embedded WG Twitter]: https://twitter.com/rustembedded +[26 of 32 functions]: https://github.com/japaric/libm/issues?q=is%3Aopen+is%3Aissue+milestone%3Awasm +[porting]: https://github.com/japaric/libm +[now available]: https://github.com/rust-lang/rust/pull/51953 + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* This week we have two Multirotor Flight Controller projects starting in Rust! They are both based on the [stm32f3] family of chips from STMicro. + * [Emil Fresk] posted [on Twitter] about his project [TrustFlight], which is an open source, Rust based software library for controlling the [TrustFlight HW] he designed. + * [Josh Mcguigan] announced in his [Blog Post] that he is planning to develop a firmware package for the [BetaFPV F3], which is an off the shelf flight controller +* We also have two projects aiming to make use of Rust on the Raspberry Pi a little easier: + * [Adam Gausmann] shared his [Rustberry] project [on Reddit], which includes register maps and an I/O library for the Raspberry Pi + * [Rahul Thakoor] shared his [rust_gpiozero] crate [on Medium], which is based on the Python library of similar name. He has also started writing [a series of tutorials] for developers new to working with physical hardware. + + +[stm32f3]: https://github.com/japaric/stm32f30x-hal +[Emil Fresk]: https://github.com/korken89 +[on Twitter]: https://twitter.com/korken89/status/1016975023930830848 +[TrustFlight]: https://github.com/korken89/trustflight_firmware +[TrustFlight HW]: https://github.com/korken89/trustflight_hardware +[Josh Mcguigan]: https://github.com/JoshMcguigan +[Blog Post]: https://www.joshmcguigan.com/blog/betafpv-drone-flight-controller-hello-rust/ +[BetaFPV F3]: https://betafpv.com/products/beta75-bnf-tiny-whoop-quadcopter + +[Adam Gausmann]: https://gitlab.com/AGausmann +[Rustberry]: https://gitlab.com/AGausmann/rustberry +[on Reddit]: https://www.reddit.com/r/rust/comments/8x1ayd/calling_all_raspberry_pi_owners_rustberry_010_has/ +[Rahul Thakoor]: https://github.com/rahul-thakoor +[rust_gpiozero]: https://github.com/rahul-thakoor/rust_gpiozero +[on Medium]: https://medium.com/@rahulthakoor/physical-computing-with-rust-on-raspberry-pi-a7b6f34261a6 +[a series of tutorials]: https://rahul-thakoor.github.io/physical-computing-rust/ + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | Diff | +| :--- | :----- | :---- | :--- | +| [Device Crates] | released | 14 | 0 | +| [HAL Impl Crates] | released | 11 | 0 | +| [Board Support Crates] | released | 6 | 0 | +| [Driver Crates Released] | released | 9 | 0 | +| [Driver Crates WIP] | WIP | 30 | 0 | + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Board Support Crates]: https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip + +## Help Wanted + +* Help contribute to development of [Rust's libm] to get math functions built in to `core` for `no_std` targets! + +[Rust's libm]: https://github.com/japaric/libm diff --git a/content/2018-07-29.md b/content/2018-07-29.md new file mode 100644 index 0000000..142d2bb --- /dev/null +++ b/content/2018-07-29.md @@ -0,0 +1,107 @@ ++++ +title = "The Embedded Working Group Newsletter - 8" +date = 2018-07-29 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the eighth newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-lang-nursery/embedded-wg/issues/134 +[Embedded WG]: https://github.com/rust-lang-nursery/embedded-wg + +## Highlights + +* [libm], the `no_std` port of MUSL's math library led by [japaric] has finished its' first release! It can now be used by embedded (or `wasm`!) targets that need support for math functions. +* [droogmic] is working on [microrust], a port of [japaric]'s Discovery book for the BBC MicroBit, based on the Nordic nRF51 +* [Hideki Sekine] and [Vaishali Thakkar] have landed initial support for an [Embedded CI Harness] in the [`rust-lang/rust`] repo as part of the [Increasing Rust's Reach] project. This opens the door for tests that will help prevent regressions in `rustc` and `cargo` for ARM Cortex-M targets +* [CMSIS intrinsics] for ARM Cortex processors have landed in [stdsimd]. Check out the [the docs] in nightly soon† for info, thanks to [Paolo Teti] and [japaric]! +* [Ashley Williams] released [cargo-generate], a CLI tool for generating Cargo projects from a template, reducing the need to manually write boilerplate code. If you write some embedded templates, [let us know]! + +†: The CMSIS intrinsics will show up in the docs after the next successful nightly build (after 2018-07-30) + +[japaric]: https://github.com/japaric +[libm]: https://github.com/japaric/libm#libm + +[droogmic]: https://github.com/droogmic +[microrust]: https://droogmic.github.io/microrust + +[Embedded CI Harness]: https://github.com/rust-lang/rust/pull/52465 +[Increasing Rust's Reach]: http://reach.rust-lang.org/ +[Hideki Sekine]: https://github.com/sekineh +[Vaishali Thakkar]: https://github.com/nerdyvaishali +[`rust-lang/rust`]: https://github.com/rust-lang/rust + +[Ashley Williams]: https://github.com/ashleygwilliams +[cargo-generate]: https://crates.io/crates/cargo-generate +[her tweet]: https://twitter.com/ag_dubs/status/1022191996293865472 +[let us know]: https://twitter.com/rustembedded + +[CMSIS intrinsics]: https://github.com/rust-lang-nursery/stdsimd/pull/518 +[stdsimd]: https://github.com/rust-lang-nursery/stdsimd +[the docs]: https://doc.rust-lang.org/nightly/core/arch/arm/index.html +[Paolo Teti]: https://github.com/paoloteti + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* [David McGillicuddy] has released his crate, [eight-segment], an `embedded-hal` driver for displaying digits on 8 segment displays like the HDSP H-101 +* [James Waples] announced the newest release of his [embedded-graphics] library [in a tweet]. This version fixes some small issues, as well as provides functionality to save memory +* [Mart Roosmaa] released [bolos-rs], a 3rd party Rust SDK for the Ledger Nano cryptocurrency wallet. Check out his [Medium post] for more info! +* The [cc1101] crate can now recieve radio packets! Check out [the reddit post] by [Daniel Svensson], as well as [his blog post] for more info + +[cc1101]: https://crates.io/crates/cc1101 +[the reddit post]: https://www.reddit.com/r/rust/comments/8zk03w/cc1101_crate_can_now_receive_radio_packets/ +[Daniel Svensson]: https://github.com/dsvensson +[his blog post]: https://dsvensson.github.io/posts/2018-07-13-Electrosmog-trapping-with-CC1101.html#article + +[David McGillicuddy]: https://github.com/djmcgill +[eight-segment]: https://crates.io/crates/eight-segment + +[James Waples]: https://github.com/jamwaffles +[in a tweet]: https://twitter.com/jam_waffles/status/1022837939041132545 +[embedded-graphics]: https://crates.io/crates/embedded-graphics + +[Mart Roosmaa]: https://github.com/roosmaa +[Medium post]: https://medium.com/@roosmaa/bringing-rust-to-ledger-hardware-wallet-ccf1356a7de1 +[bolos-rs]: https://github.com/roosmaa/bolos-rs + + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | Diff | +| :--- | :----- | :---- | :--- | +| [Device Crates] | released | 14 | 0 | +| [HAL Impl Crates] | released | 11 | 0 | +| [Board Support Crates] | released | 8 | +2 | +| [Driver Crates Released] | released | 11 | +2 | +| [Driver Crates WIP] | WIP | 35 | +5 | +| [no-std crates] | released | 12 | +12 | + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Board Support Crates]: https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip +[no-std crates]: https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates + +## Help Wanted + +* The Embedded-WG is looking for someone to write an [RFC for ARM Intrinsics] to get them stabilized +* [Jonathan Pallant] is looking for ideas to implement for the Monotron project. Check out the [monotron blog post] for more details! +* The [libm] project is looking for help with [refactoring] in order to better support chips without hardware double-floating-point support + +[Jonathan Pallant]: https://github.com/thejpster +[RFC for ARM Intrinsics]: https://github.com/rust-lang-nursery/embedded-wg/issues/63#issuecomment-408509178 +[monotron blog post]: http://railwayelectronics.blogspot.com/2018/07/where-next-for-monotron.html +[refactoring]: https://github.com/japaric/libm/milestone/3 \ No newline at end of file diff --git a/content/2018-08-12.md b/content/2018-08-12.md new file mode 100644 index 0000000..5c1c3b9 --- /dev/null +++ b/content/2018-08-12.md @@ -0,0 +1,66 @@ ++++ +title = "The Embedded Working Group Newsletter - 9" +date = 2018-08-12 +draft = false +in_search_index = true +template = "page.html" ++++ + +This is the ninth newsletter of the [Embedded WG] where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help! + + + +If you want to mention something in [the next newsletter], make sure to leave a comment on the issue. + +[the next newsletter]: https://github.com/rust-embedded/wg/issues/164 +[Embedded WG]: https://github.com/rust-embedded/wg + +## Highlights + +* The Embedded Working Group has moved! You can find our new coordination repo at [rust-embedded/wg] on GitHub, and crates maintained by the working group in the [rust-embedded] organization +* The Embedded Working Group has grown! We are now 18 people grouped in the following 6 teams to allow for better focus on these topics: + * The **Cortex-M** team develops and maintains the core of the Cortex-M crate ecosystem + * The **HAL team** develops and maintains crates that ease the development of Hardware Abstraction Layers, Board Support Crates and drivers + * The **MS430 team** develops and maintains the core of the MSP430 crate ecosystem + * The **RISCV team** develops and maintains the core of the RISCV crate ecosystem + * The **Resources team** develops, maintains and curates resources on embedded Rust + * The **Tools team** maintains and develops core embedded tools + +[rust-embedded/wg]: https://github.com/rust-embedded/wg +[rust-embedded]: https://github.com/rust-embedded + +## Embedded Projects + +If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to mention it on the tracking issue for [the next newsletter], we would love to show it off! + +* [rust-lang/rust#52787] has landed, adding support in `nightly` for the RISC-V architecture as a bare-metal target! + +[rust-lang/rust#52787]: https://github.com/rust-lang/rust/pull/52787 + +### `embedded-hal` Ecosystem Crates + +As part of the [Weekly Driver Initiative], crates that are part of the `embedded-hal` ecosystem are now tracked in the [Awesome Embedded Rust] repository. Here is a current snapshot of what is available there: + +| Type | Status | Count | Diff | +| :--- | :----- | :---- | :--- | +| [Device Crates] | released | 14 | 0 | +| [HAL Impl Crates] | released | 11 | 0 | +| [Board Support Crates] | released | 9 | +1 | +| [Driver Crates Released] | released | 11 | 0 | +| [Driver Crates WIP] | WIP | 38 | +3 | +| [no-std crates] | released | 12 | 0 | + +[Awesome Embedded Rust]: https://github.com/rust-embedded/awesome-embedded-rust +[Weekly Driver Initiative]: https://github.com/rust-lang-nursery/embedded-wg/issues/39 +[Device Crates]: https://github.com/rust-embedded/awesome-embedded-rust#device-crates +[HAL Impl Crates]: https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates +[Board Support Crates]: https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates +[Driver Crates Released]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates +[Driver Crates WIP]: https://github.com/rust-embedded/awesome-embedded-rust#wip +[no-std crates]: https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates + +## Help Wanted + +* We're considering changing to LLD as the default linker for `thumb` targets. Check out the RFC at [rust-embedded/wg#160], and let us know what you think + +[rust-embedded/wg#160]: https://github.com/rust-embedded/wg/issues/160 diff --git a/content/2018-08-2x-psa-cortex-m-breakage.md b/content/2018-08-2x-psa-cortex-m-breakage.md new file mode 100644 index 0000000..66b2054 --- /dev/null +++ b/content/2018-08-2x-psa-cortex-m-breakage.md @@ -0,0 +1,156 @@ ++++ +title = "PSA: Cortex-M Breakage (LLD as the default linker)" +date = 2018-08-24 +draft = false +in_search_index = true +template = "page.html" ++++ + +> PSA: building binaries and cdylibs for the ARM Cortex-M architecture will break with today's nightly + +The default linker for the 4 ARM Cortex-M targets listed below has changed from +`arm-none-eabi-gcc` to `rust-lld` in the latest nightly. + +- `thumbv6m-none-eabi` +- `thumbv7m-none-eabi` +- `thumbv7em-none-eabi` +- `thumbv7em-none-eabihf` + +This will break the builds of *binaries* and *cdylibs* that were using the +old default linker (`arm-none-eabi-gcc`) *and* additionally pass extra flags to +the linker using any of these rustc flags: `-C link-arg`, `-C link-args`, `-Z +pre-link-arg` or `-Z pre-link-args`. Building libraries (`rlib`s and +`staticlib`s) is not affected by this change. + + + +This change won't affect stable users when it reaches the 1.30 release because, +as of 1.28, it's not possible to build binaries or cdylibs for those targets on +the stable channel. Building libraries for those targets is possible on stable +but it's not affected by this change. + +### Rationale + +This breaking change was intentional. + +We, the [embedded WG], wanted to reduce the number of external tools required to +build embedded programs for the ARM Cortex-M architecture. By switching the +default linker to the LLD linker that's shipped with the Rust toolchain the user +no longer needs to install an ARM linker (like `arm-none-eabi-gcc` or +`arm-none-eabi-ld`) to build Rust programs. + +[embedded WG]: https://github.com/rust-embedded/wg + +Before landing this change we first [consulted] with the community if they +thought this breaking change was worth it. We received over 20 positive responses +representing the Cortex-M team (part of the embedded WG), the Tock OS project, +the embed-rs organization and independent developers. + +The consensus was that it was worth to make the default configuration more self +contained and that if we were to make the change it had to be made before it +became possible to build binaries on stable otherwise it wouldn't be possible +to make this change without breaking stable builds. + +[consulted]: https://github.com/rust-embedded/wg/issues/160 + +### How to fix your build + +If you are affected by this change you'll observe a linker error with a message +similar to one shown below: + +``` console +$ # these are the custom linker flags of the project +$ cat .cargo/config +``` + +``` toml +[target.thumbv7m-none-eabi] +runner = 'arm-none-eabi-gdb' +rustflags = [ + "-C", "link-arg=-Wl,-Tlink.x", + "-C", "link-arg=-nostartfiles", +] + +[build] +target = "thumbv7m-none-eabi" +``` + +``` +$ cargo build +error: linking with `rust-lld` failed: exit code: 1 + | + = note: "rust-lld" "-flavor" "gnu" (..) + = note: rust-lld: error: unknown argument: -Wl,-Tlink.x + rust-lld: error: unknown argument: -nostartfiles +``` + +There are two ways to fix the problem. + +#### Option A: switch back to GCC + +The easiest way is to switch back to using `arm-none-eabi-gcc` as the linker. To +do so pass the flag `-C linker=arm-none-eabi-gcc` to rustc. In the above example +you can do that in the `.cargo/config` file. + +``` console +$ # these are the custom linker flags of the project +$ cat .cargo/config +``` + +``` toml +[target.thumbv7m-none-eabi] +runner = 'arm-none-eabi-gdb' +rustflags = [ + "-C", "linker=arm-none-eabi-gcc", # ADDED + "-C", "link-arg=-Wl,-Tlink.x", + "-C", "link-arg=-nostartfiles", +] + +[build] +target = "thumbv7m-none-eabi" +``` + +``` +$ cargo build && echo It works now +It works now +``` + +#### Option B: tweak the additional linker arguments + +The other option is to tweak the additional linker arguments so they'll be +accepted by LLD. In the above example the `-nostartfiles` flag can be dropped +because that's the default behavior of LLD, and the flags prefixed by `-Wl,` +will have to lose their prefix. + +``` console +$ # these are the custom linker flags of the project +$ cat .cargo/config +``` + +``` toml +[target.thumbv7m-none-eabi] +runner = 'arm-none-eabi-gdb' +rustflags = [ + "-C", "link-arg=-Tlink.x", # CHANGED +# "-C", "link-arg=-nostartfiles", # REMOVED +] + +[build] +target = "thumbv7m-none-eabi" +``` + +``` console +$ cargo build && echo It works now +It works now +``` + +With this approach your build will no longer depend on an external linker. + +#### Should I prefer option A or B? + +If you are linking to a system installed C library like `newlib-arm-none-eabi` +then you should continue to use GCC. The default library search path of +`arm-none-eabi-gcc` includes the path to those libraries. + +If you are not linking to any C code then you should prefer LLD then you won't +need to install the `arm-none-eabi` toolchain. From e749386d6828bed212a8626ff61bf580b19775e1 Mon Sep 17 00:00:00 2001 From: James Munns Date: Sat, 25 Aug 2018 22:18:10 -0700 Subject: [PATCH 4/5] Add links --- config.toml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/config.toml b/config.toml index 9a4ffa9..d569a3a 100644 --- a/config.toml +++ b/config.toml @@ -21,4 +21,7 @@ theme = "hyde" generate_rss = true [extra] -# Put all your custom variables here +hyde_links = [ + {url = "https://rust-lang.org", name = "The Rust Language"}, + {url = "https://github.com/rust-embedded/wg", name = "Embedded WG"}, +] \ No newline at end of file From 230d70f2ad9d8fd24ed2d9bad23b6578112295a0 Mon Sep 17 00:00:00 2001 From: James Munns Date: Sat, 25 Aug 2018 22:32:59 -0700 Subject: [PATCH 5/5] Link to self --- config.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/config.toml b/config.toml index d569a3a..be10955 100644 --- a/config.toml +++ b/config.toml @@ -24,4 +24,5 @@ generate_rss = true hyde_links = [ {url = "https://rust-lang.org", name = "The Rust Language"}, {url = "https://github.com/rust-embedded/wg", name = "Embedded WG"}, + {url = "https://github.com/rust-embedded/blog", name = "The Blog on GitHub"}, ] \ No newline at end of file