https://blog.rust-embedded.org Blog of the Embedded Rust Working Group Zola en Wed, 20 Aug 2025 00:00:00 +0000 Wed, 20 Aug 2025 00:00:00 +0000 https://blog.rust-embedded.org/heapless-091/ https://blog.rust-embedded.org/heapless-091/ <p>Almost 2 years after the last release, the <a href="https://github.com/rust-embedded/heapless">heapless</a> crate has a new release. The first attempt at a <code>0.9.0</code> release was yanked due to including more breaking changes than intended. This has been fixed, and <code>0.9.1</code> has been released today.</p> <p>Compared to <code>0.8.0</code>, the <code>0.9.1</code> release contains a bunch of small everyday improvements and bugfixes. Most users of the library should be able to adapt with minimal changes. For more information, you can check out <a href="https://github.com/rust-embedded/heapless/blob/main/CHANGELOG.md">the changelog</a>. Here are some of the major changes that can improve your usage of the library.</p> <span id="continue-reading"></span><h1 id="the-view-types">The <code>View</code> types</h1> <p>One of the main constraints when working with <code>heapless</code> types is that they all have a <code>const generic</code>. In a lot of situations, these can now be removed thanks to the <code>View</code> types.</p> <p>A lot of embedded firmware will allocate a couple of buffers and pass them around to save on memory. To make it easy to change the size of the buffers, functions will carry along these <code>const generics</code>:</p> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span style="color:#b48ead;">use </span><span>heapless::Vec; </span><span style="color:#b48ead;">struct </span><span>App{ </span><span> … </span><span>} </span><span> </span><span style="color:#b48ead;">impl </span><span>App { </span><span> </span><span style="color:#b48ead;">pub fn </span><span style="color:#8fa1b3;">handle_request</span><span>&lt;</span><span style="color:#b48ead;">const</span><span> N: </span><span style="color:#b48ead;">usize</span><span>, </span><span style="color:#b48ead;">const</span><span> M: </span><span style="color:#b48ead;">usize</span><span>&gt;(</span><span style="color:#bf616a;">input</span><span>: &amp;</span><span style="color:#b48ead;">mut </span><span>Vec&lt;</span><span style="color:#b48ead;">u8</span><span>, N&gt;, </span><span style="color:#bf616a;">output</span><span>: &amp;</span><span style="color:#b48ead;">mut </span><span>Vec&lt;</span><span style="color:#b48ead;">u8</span><span>, M&gt;) -&gt; Result&lt;(), Error&gt; { </span><span> … </span><span> } </span><span>} </span></code></pre> <p>The new <code>View</code> variants of the types enable you to remove the <code>const generics</code> while still keeping the same functionality:</p> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span style="color:#b48ead;">use </span><span>heapless::VecView; </span><span style="color:#b48ead;">struct </span><span>App{ </span><span> … </span><span>} </span><span> </span><span style="color:#b48ead;">impl </span><span>App { </span><span> </span><span style="color:#b48ead;">pub fn </span><span style="color:#8fa1b3;">handle_request</span><span>(</span><span style="color:#bf616a;">input</span><span>: &amp;</span><span style="color:#b48ead;">mut </span><span>VecView&lt;</span><span style="color:#b48ead;">u8</span><span>&gt;, </span><span style="color:#bf616a;">output</span><span>: &amp;</span><span style="color:#b48ead;">mut </span><span>VecView&lt;</span><span style="color:#b48ead;">u8</span><span>&gt;) -&gt; Result&lt;(), Error&gt; { </span><span> … </span><span> } </span><span>} </span></code></pre> <p>Call sites of <code>handle_request</code> will be able to stay the same. The function will continue to accept <code>&amp;mut Vec&lt;u8, N&gt;</code>.</p> <p>So what's the difference between <code>VecView</code> and <code>Vec</code>?</p> <p>There are almost none, both are aliases of the same underlying type <code>VecInner</code>. The only limitation of <code>VecView</code> compared to <code>Vec</code> is that <code>VecView</code> is <code>!Sized</code>. This means that you cannot perform anything that would require the compiler to know the size of the <code>VecView</code> at compile-time. You will always need to manipulate <code>VecView</code> through pointer indirection (generally a reference). This means you can't just create a <code>VecView</code> out of thin air. The <code>VecView</code> is always a runtime "View" of an existing <code>Vec</code>.</p> <p>So how can we obtain a <code>VecView</code> ? It's pretty simple: <code>Vec</code> can be <em>coerced</em> into a <code>VecView</code>. Coercion (in this case <a href="https://doc.rust-lang.org/reference/type-coercions.html#r-coerce.unsize"><code>Unsized</code> coercion</a>), is a way the compiler can transform one type into another implicitly. In this case, the compiler is capable of converting pointers to a <code>Vec</code> (<code>&amp;Vec&lt;T, N&gt;</code>, <code>&amp;mut Vec&lt;T, N&gt;</code>, <code>Box&lt;Vec&lt;T, N&gt;&gt;</code> etc...) to pointers to a <code>VecView</code> (<code>&amp;VecView&lt;T&gt;</code>, <code>&amp;mut VecView&lt;T&gt;</code>, <code>Box&lt;VecView&lt;T&gt;&gt;</code> etc...), so you can use a reference to a <code>Vec</code> when a reference to a <code>VecView</code> is expected:</p> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span style="color:#b48ead;">use </span><span>heapless::{VecView, Vec}; </span><span style="color:#b48ead;">struct </span><span>App{ </span><span> … </span><span>} </span><span> </span><span style="color:#b48ead;">impl </span><span>App { </span><span> </span><span style="color:#b48ead;">pub fn </span><span style="color:#8fa1b3;">handle_request</span><span>(</span><span style="color:#bf616a;">input</span><span>: &amp;</span><span style="color:#b48ead;">mut </span><span>VecView&lt;</span><span style="color:#b48ead;">u8</span><span>&gt;, </span><span style="color:#bf616a;">output</span><span>: &amp;</span><span style="color:#b48ead;">mut </span><span>Vec&lt;</span><span style="color:#b48ead;">u8</span><span>&gt;) -&gt; Result&lt;(), Error&gt; { </span><span> … </span><span> } </span><span>} </span><span> </span><span style="color:#b48ead;">let mut</span><span> request: Vec&lt;</span><span style="color:#b48ead;">u8</span><span>, 256&gt; = Vec::new(); </span><span style="color:#b48ead;">let mut</span><span> reply: Vec&lt;</span><span style="color:#b48ead;">u8</span><span>, 256&gt; = Vec::new(); </span><span> </span><span>app.</span><span style="color:#96b5b4;">handle_request</span><span>(&amp;</span><span style="color:#b48ead;">mut</span><span> request, &amp;</span><span style="color:#b48ead;">mut</span><span> reply).</span><span style="color:#96b5b4;">unwrap</span><span>(); </span></code></pre> <p>If you prefer things to be explicit, the <code>View</code> variants of types (<code>Vec</code> is not the only data structure having <code>View</code> variants) can be obtained through <code>vec.as_view()</code> or through <code>vec.as_mut_view()</code>.</p> <p>The pointer to the <code>VecView</code> is the size of 2 <code>usize</code>: one for the address of the underlying <code>Vec</code>, and one for the capacity of the underlying <code>Vec</code>. This is exactly like slices. <code>VecView&lt;T&gt;</code> is to <code>Vec&lt;T, N&gt;</code> what a slice <code>[T]</code> is to an array <code>[T; N]</code>. Unless you need to store data on the stack, most often you will pass around <code>&amp;mut [T]</code> rather than <code>&amp;mut [T; N]</code>, because it's simpler. The same applies to <code>VecView</code>. Wherever you use <code>&amp;mut Vec&lt;T, N&gt;</code>, you can instead use <code>&amp;mut VecView&lt;T&gt;</code>.</p> <p>The <code>View</code> types are not available just for <code>Vec</code>. There are <code>View</code> versions of a lot of heapless types:</p> <ul> <li><code>Vec</code> has <code>VecView</code></li> <li><code>String</code> has <code>StringView</code></li> <li><code>Deque</code> has <code>DequeView</code></li> <li><code>LinearMap</code> has <code>LinearMapView</code></li> <li><code>HistoryBuf</code> has <code>HistoryBufView</code></li> <li><code>BinaryHeap</code> has <code>BinaryHeapView</code></li> <li><code>mpmc::Queue</code> has <code>mpmc::QueueView</code></li> <li><code>spsc::Queue</code> has <code>spsc::QueueView</code> (and now, the producer and consumer structs don't carry the const-generic)</li> <li><code>SortedLinkedList</code> has <code>SortedLinkedListView</code></li> </ul> <p><code>IndexMap</code> and <code>IndexSet</code> are the two remaining structures that don't have a <code>View</code> type available. We hope to be able to use it in the future.</p> <h2 id="benefits-of-the-view-types">Benefits of the view types</h2> <p>The benefits are multiple:</p> <h3 id="better-compatibility-with-dyn-traits">Better compatibility with <code>dyn Traits</code></h3> <p>If a trait has a function that takes a generic, it is not <code>dyn</code> compatible. By removing the const generic, the <code>View</code> types can make <code>dyn Trait</code> pass around data structures without having to hard-code a single size of buffer in the trait definition.</p> <h3 id="better-binary-size-and-compile-times">Better binary size and compile times</h3> <p>When you use const-generics, the compiler needs to compile a new version of the function for each value of the const-generic. Removing the const generic means cutting down on duplicated functions that are all almost the same, which improves both compile time and the size of the resulting binary.</p> <h3 id="better-ergonomics">Better ergonomics</h3> <p>The View types can remove a ton of excess noise from the generics.</p> <h1 id="the-lentype-optimization">The <code>LenType</code> optimization</h1> <p>Most often, buffers in embedded applications will not contain a huge number of items. Until <code>0.9.1</code> the capacity of a <code>heapless</code> data structure was almost always stored as a <code>usize</code>, which can often encode much more values than necessary.</p> <p>In 0.9.1, data structures now have a new optional generic parameter called <code>LenT</code>. This type accepts <code>u8</code>, <code>u16</code>, <code>u32</code>, and <code>usize</code>, and defaults to <code>usize</code> to keep typical uses of the library, simple.</p> <p>If you are seriously constrained by memory, a <code>Vec&lt;T, 28&gt;</code> (equivalent to <code>Vec&lt;T, 28, usize&gt;</code>) can become a <code>Vec&lt;T, 28, u8&gt;</code>, saving up to 7 bytes per <code>Vec</code>. This is not much, but in very small microcontrollers, it can make the difference between a program that uses all the memory available and one that just fits.</p> <h1 id="contributors">Contributors</h1> <p>This release was made possible by <a href="https://github.com/zeenix">@Zeenix</a> joining the embedded working group as part of the libs team to help maintain <code>heapless</code> and convincing <a href="https://github.com/sgued">@sgued</a> to do the same.</p> <p>The <code>View</code> types were a contributions from <a href="https://github.com/sgued">@sgued</a>, and the <code>LenType</code> were contributed by <a href="https://github.com/GnomedDev">@GnomedDev</a>. In total 38 contributors participated in all the other improvements to the crate and helped with maintainance.</p> Tue, 09 Jan 2024 00:00:00 +0000 https://blog.rust-embedded.org/embedded-hal-v1/ https://blog.rust-embedded.org/embedded-hal-v1/ <p>The Rust Embedded Working Group is proud to announce the release of <code>embedded-hal</code> version 1.0 together with the companion crates <code>embedded-hal-bus</code>, <code>embedded-hal-async</code> and <code>embedded-hal-nb</code>.</p> <p>Check out the <a href="https://github.com/rust-embedded/embedded-hal">repository</a>, the <a href="https://github.com/rust-embedded/embedded-hal#crates">API documentation</a> and the <a href="https://github.com/rust-embedded/embedded-hal/blob/master/docs/migrating-from-0.2-to-1.0.md">migration guide</a>.</p> <p>The <code>embedded-hal</code> crates provide traits (interfaces) for using peripherals commonly available in microcontrollers such as GPIO, UART, SPI or I2C. They allow writing drivers (for sensors, displays, actuators, network adapters, etc.) in a generic way, so they work on any microcontroller with an <code>embedded-hal</code> implementation without modifying them. It's a central piece of the Embedded Rust ecosystem, ensuring interoperability throughout.</p> <p>The 1.0 release has been in the works since 2020. Now that it's out, we consider all traits in it to be <em>stable</em>. The plan is to extend <code>embedded-hal</code> with more traits in future 1.x releases, not doing more breaking changes (i.e. there are no plans for a 2.0 release). This will provide a stable base for building HALs and drivers.</p> <p>So, what's new in <code>embedded-hal</code> 1.0?</p> <span id="continue-reading"></span> <p><img src="../embedded-ferris-soldering.png" alt="Ferris soldering embedded stuff" /> <em>Ferris with a soldering iron by <a href="https://waterpigs.co.uk/notes/5UrMgn/">Barnaby Walters</a>.</em></p> <h2 id="focus-on-drivers">Focus on drivers</h2> <p>Previous versions of <code>embedded-hal</code> had a dual goal of standardizing HAL APIs for end users, and allowing writing generic drivers. Experience has shown that these goals sometimes conflict with each other. As the latter brings much more value, 1.0 focuses on that.</p> <p>We've simplified some traits and merged others to remove interoperability gotchas.</p> <p>We've removed traits that were found to not be usable for generic drivers (most notably timers). The plan is to add them back in the future, with a better design. See the <a href="https://github.com/rust-embedded/embedded-hal/blob/master/docs/migrating-from-0.2-to-1.0.md">migration guide</a> for details and links to the tracking issues.</p> <h2 id="async">Async</h2> <p>A new addition is the <code>embedded-hal-async</code> crate, containing async versions of the traits. With the Rust 1.75 release, async traits are available on Rust stable. They can be used without heap allocations or dynamic dispatch (unlike previous macro-based polyfills like the <code>async-trait</code> crate), so they are a great fit for bare-metal embedded usage.</p> <p>Most <code>embedded-hal-async</code> traits are async versions of their blocking counterparts.</p> <p>However, one highlight is the <a href="https://docs.rs/embedded-hal-async/1.0.0/embedded_hal_async/digital/trait.Wait.html"><code>digital::Wait</code></a> trait, with methods like <code>wait_for_high()</code> and <code>wait_for_low()</code>. This trait adds support for using "IRQ" GPIO pins typically used by SPI and I2C devices to send an interrupt to the microcontroller. This frequently-requested feature turned out to be hard to abstract with traits, but is now feasible in an ergonomic way with async.</p> <h2 id="spi-bus-sharing">SPI bus sharing</h2> <p><img src="../spi-shared-bus.svg" alt="SPI bus/device diagram" /></p> <p>The <a href="https://docs.rs/embedded-hal/1.0.0/embedded_hal/spi/index.html"><code>SpiDevice</code></a> trait now allows sharing a SPI bus between multiple devices, each selected with its own CS pin. The design allows for unrelated drivers to talk to different devices in the same bus without conflicts and without being aware of each other.</p> <p>The trait is agnostic about the kind of mutex/locking mechanism. The <a href="https://docs.rs/embedded-hal-bus/0.1.0/embedded_hal_bus/spi/index.html"><code>embedded-hal-bus</code></a> crate provides implementations for commonly used mutexes, but it is possible to write your own for e.g. the mutex of your favourite RTOS.</p> <h2 id="error-handling">Error handling</h2> <p>Generic drivers can now inspect errors, thanks to them being required to implement an <code>Error</code> trait that allows querying the error "kind" out of a pre-selected set. HAL implementations can still use custom error types, and map errors that don't fit in these categories to the <code>Other</code> kind.</p> <p>All error types are also required to implement <code>Debug</code>, so <code>.unwrap()</code> and similar are now always available in generic drivers.</p> <h2 id="embedded-io">embedded-io</h2> <p>The <code>embedded-hal</code> project also hosts the <code>embedded-io</code> crates. They provide traits for byte-oriented I/O streams. Since serial ports (UART) are essentially byte streams, the serial-specific traits in <code>embedded-hal</code> have been removed in favor of <code>embedded-io</code>.</p> <p><code>embedded-io</code> has not reached 1.0 yet, but we expect that to happen in 2024.</p> <h2 id="thanks">Thanks</h2> <p>Thanks to the HAL team (<a href="https://github.com/therealprof">@therealprof</a>, <a href="https://github.com/ryankurte">@ryankurte</a>, <a href="https://github.com/eldruin">@eldruin</a>, <a href="https://github.com/Dirbaio">@dirbaio</a>, <a href="https://github.com/MabezDev">@MabezDev</a>), and to everyone who helped with testing, feedback and contributions for making <code>embedded-hal</code> 1.0 possible.</p> <p>Thanks to the Rust Foundation for sponsoring Dario Nieuwenhuis (<a href="https://github.com/Dirbaio">@dirbaio</a>)'s work on <code>embedded-hal</code> through the <a href="https://foundation.rust-lang.org/news/announcing-the-rust-foundation-s-2023-fellows/">Fellowship grants program</a>.</p> <p>And lastly, thanks to all the people releasing and maintaining HAL implementations and drivers using <code>embedded-hal</code>. <em>You</em> are the ones who make <code>embedded-hal</code> actually useful in the real world!</p> Tue, 22 Mar 2022 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-31/ https://blog.rust-embedded.org/newsletter-31/ <h2 id="highlights">Highlights</h2> <ul> <li>AdaCore and Ferrous Systems have joined forces to support Rust in safety- and mission-critical environments. <ul> <li><a href="https://blog.adacore.com/adacore-and-ferrous-systems-joining-forces-to-support-rust">Announcement from AdaCore</a></li> <li><a href="https://ferrous-systems.com/blog/ferrous-systems-adacore-joining-forces/">Announcement from Ferrous Systems</a></li> </ul> </li> <li>AUTOSAR announces <a href="https://www.autosar.org/news-events/details/autosar-announces-new-working-group-for-programming-language-rust-in-automotive-software-context-202/">new Working Group for Programming Language Rust in Automotive Software context</a>.</li> </ul> <span id="continue-reading"></span><h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/newsletter-next.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li> <p><a href="https://crates.io/crates/svd2rust">svd2rust</a> released v0.20.0.</p> </li> <li> <p>The new version of the <a href="https://docs.rust-embedded.org/discovery">Discovery book</a> targeting the micro:bit development board was released.</p> </li> <li> <p><a href="https://crates.io/crates/embedded-hal">embedded-hal</a> 1.0.0-alpha.6 and 1.0.0-alpha.7 released, with a number of new features and changes as we work towards the final 1.0 release. Most notably, CAN (Controller Area Network) traits were added and some traits with unconstrained associated types were removed.</p> </li> <li> <p><a href="https://crates.io/crates/embedded-hal">embedded-hal</a> 0.2.7 released, including CAN (Controller Area Network) traits which were backported.</p> </li> <li> <p><a href="https://crates.io/crates/embedded-dma">embedded-dma</a> 0.2.0 released, including const generics support and resolves some confusion around <code>'static</code>.</p> </li> <li> <p>A project to develop asynchronous versions of the <code>embedded-hal</code> traits has been started. See the current <a href="https://github.com/rust-embedded/embedded-hal/issues/356">roadmap</a> and please join the effort!</p> </li> <li> <p><a href="https://crates.io/crates/linux-embedded-hal">linux-embedded-hal</a> 0.4.0-alpha.2 released updating <code>embedded-hal</code> to version 1.0.0-alpha.7.</p> </li> <li> <p>New Rust Embedded ecosystem for the radiation-hardened Vorago VA108xx family of devices: <a href="https://egit.irs.uni-stuttgart.de/rust/va108xx">va108xx</a> PAC, <a href="https://egit.irs.uni-stuttgart.de/rust/va108xx-hal">va108xx-hal</a> HAL and <a href="https://egit.irs.uni-stuttgart.de/rust/vorago-reb1">vorago-reb1</a> BSP with <a href="https://robamu.github.io/post/rust-ecosystem/">blogpost</a></p> </li> <li> <p>New <a href="https://egit.irs.uni-stuttgart.de/rust/max116xx-10bit">device driver crate</a> for the MAX116xx 10-bit ADC devices with <a href="https://robamu.github.io/post/max11619-driver-rust/">blogpost</a></p> </li> <li> <p>The RIOT operating system now <a href="https://doc.riot-os.org/using-rust.html">has upstream support for Rust applications</a>.</p> <p>This encompasses support in the build system, high-level <a href="https://crates.io/crates/riot-wrappers">wrappers</a> that make the OS's C mechanisms safe and idiomatic to use, and <a href="https://gitlab.com/etonomy/riot-examples">additional examples</a> maintained externally. The wrappers implement high-level traits (e.g. from <a href="https://crates.io/crates/embedded-hal">embedded-hal</a>, <a href="https://crates.io/crates/embedded-nal">embedded-nal</a> and <a href="https://crates.io/crates/mutex-traits">mutex-traits</a>) where practical.</p> </li> <li> <p>A <a href="https://tweedegolf.nl/en/blog/65/async-rust-vs-rtos-showdown">blog post by Tweede Golf</a> about comparing Embassy with FreeRTOS.</p> </li> <li> <p><a href="https://crates.io/crates/eeprom24x">eeprom24x</a> I2C EEPROM driver 0.5.0 released, adding support for STM M24C01 and M24C02 devices as well as implementing the <a href="https://github.com/rust-embedded-community/embedded-storage"><code>embedded-storage</code></a> traits.</p> </li> <li> <p><a href="https://crates.io/crates/measurements">measurements</a> 0.10.4 and 0.11.0 released, most notably adding support for humidity and density.</p> </li> <li> <p><a href="https://github.com/9names">9names</a> released a platform-agnostic <a href="https://crates.io/crates/wii-ext">driver for Wii Extension Controllers</a> and published a <a href="https://9names.github.io/driver/embedded/rust/2022/02/14/wii-ext-rs.html">blog post</a>. This driver supports Nunchuk controllers as well as the many variants of the Classic Controller (Original/Pro/NES/SNES).</p> </li> <li> <p>Drogue Device now features an <a href="https://blog.drogue.io/bluetooth-mesh/">async Bluetooth Mesh stack</a>.</p> </li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository.</p> <h2 id="get-involved">Get Involved</h2> <p>This <a href="https://github.com/rust-embedded/wg">Embedded WG</a> blog is where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>!</p> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/newsletter-next.md">the next newsletter</a>, send us a pull request!</p> Tue, 28 Dec 2021 00:00:00 +0000 https://blog.rust-embedded.org/this-year-in-embedded-rust-2021/ https://blog.rust-embedded.org/this-year-in-embedded-rust-2021/ <p>As 2021 draws to a close, we thought we'd take a look back at what's happened over the last year in Embedded Rust, both within the working group and in the larger community.</p> <span id="continue-reading"></span><h2 id="meetings">Meetings</h2> <p>We continued our weekly Rust Embedded Working Group meetings on <a href="https://matrix.to/#/#rust-embedded:matrix.org">our Matrix channel</a>. They take place at 8pm Berlin time every Tuesday, and are open to the public. You can find all the <a href="https://github.com/rust-embedded/wg/tree/master/minutes">minutes on Github</a>.</p> <h2 id="newsletters">Newsletters</h2> <p>The <a href="https://blog.rust-embedded.org/">blog</a> saw five new newsletters posted, keeping everyone up to date with what's hot in Embedded Rust. Make sure you bookmark or subscribe with your favourite RSS reader so you never miss an update! Please do also keep your contributions coming, as we love hearing about what everyone gets up to in Embedded Rust outside of the official Rust Embedded Working Group projects.</p> <h2 id="platform-support">Platform Support</h2> <p>Outside of the working group, platform support communities provide vendor-specific support for particular microcontrollers and development boards.</p> <p>2021 saw a brand-new microcontroller vendor hit the scene - Raspberry Pi! Their debut RP2040 microcontroller has two Cortex-M0 cores, and certainly made us all think about how we can try to make our software safe to use on multi-core systems. A new <a href="https://github.com/rp-rs">rp-rs</a> community sprang up and continues to make good progress supporting all areas of the RP2040 with good quality examples.</p> <p>This year also saw Espressif officially adopt Rust and <a href="https://mabez.dev/blog/posts/esp-rust-espressif/">they hired @mabez</a> from the <a href="https://github.com/esp-rs">esp-rs</a> community to help out!</p> <p>Other platform support communities continued to develop this year:</p> <ul> <li><a href="https://github.com/atsamd-rs">atsamd-rs</a> for Atmel ARM SAM-D and SAM-E microcontrollers (<a href="https://matrix.to/#/#atsamd-rs_community:gitter.im">Matrix chat</a>)</li> <li><a href="https://github.com/avr-rust">avr-rust</a> for Atmel AVR microcontrollers (<a href="https://matrix.to/#/#avr-rust_Lobby:gitter.im">Matrix chat</a>)</li> <li><a href="https://github.com/esp-rs">esp-rs</a> for Espressif ESP8266 and ESP32 Wi-Fi chips (<a href="https://matrix.to/#/#esp-rs:matrix.org">Matrix chat</a>)</li> <li><a href="https://github.com/imxrt-rs">imxrt-rs</a> for NXP ARM iMX.RT microcontrollers</li> <li><a href="https://github.com/lpc55">lpc55</a> for NXP ARM LPC55xx microcontrollers (<a href="https://matrix.to/#/#lpc55:matrix.org">Matrix chat</a>)</li> <li><a href="https://github.com/nrf-rs">nrf-rs</a> for Nordic ARM nRF51, 52 and 9160 Bluetooth/LTE devices (<a href="https://matrix.to/#/#nrf-rs:matrix.org">Matrix chat</a>)</li> <li><a href="https://github.com/riscv-rust">riscv-rust</a> for all kinds of RISC-V devices</li> <li><a href="https://github.com/rp-rs">rp-rs</a> for Raspberry Pi's RP2040 microcontroller (<a href="https://matrix.to/#/#rp-rs:matrix.org">Matrix chat</a>)</li> <li><a href="https://github.com/stm32-rs">stm32-rs</a> for all of ST Micro's 32-bit ARM microcontrollers (<a href="https://matrix.to/#/#stm32-rs:matrix.org">Matrix chat</a>)</li> </ul> <p>If you're a platform support community not on the list please get in touch, we'd love to hear from you!</p> <h2 id="other-embedded-projects">Other Embedded Projects</h2> <p>While not officially part of the Embedded Working Group, the following projects all continued to develop over 2021:</p> <ul> <li>The concurrency framework <a href="https://rtic.rs">RTIC</a> (<a href="https://github.com/rtic-rs">GitHub</a>, <a href="https://matrix.to/#/#rtic:matrix.org">Matrix</a>) hit version 1.0!</li> <li>The async framework <a href="https://embassy.dev">Embassy</a> (<a href="https://github.com/embassy-rs">GitHub</a>, <a href="https://matrix.to/#/#embassy-rs:matrix.org">Matrix</a>) has been under heavy development and now supports STM32, nRF and RP2040 platforms.</li> <li>The debug and programming library and tools from <a href="https://probe.rs">probe-rs</a> (<a href="https://github.com/probe-rs">GitHub</a>, <a href="https://matrix.to/#/#probe-rs:matrix.org">Matrix</a>) released v0.11 and v0.12 of their library and tools including <a href="https://github.com/probe-rs/cargo-embed">cargo-embed</a>.</li> <li>The <a href="https://knurling.ferrous-systems.com/">Knurling</a> project (<a href="https://github.com/knurling-rs">GitHub</a>) has had several releases of their tools such as <a href="https://github.com/knurling-rs/probe-run">probe-run</a>.</li> <li>The <a href="https://github.com/smoltcp-rs/smoltcp">smoltcp</a> embedded TCP/IP stack released v0.7 and v0.8, with many improvements including to the DHCP client and adding IEEE 802.15.4 support.</li> <li><a href="https://github.com/embedded-graphics">embedded-graphics</a> (<a href="https://matrix.to/#/#rust-embedded-graphics:matrix.org">Matrix</a>), a graphics library for embedded applications, had a major new v0.7 release (see the <a href="https://github.com/embedded-graphics/embedded-graphics/blob/master/MIGRATING-0.6-0.7.md">migration notes</a>).</li> <li>The <a href="https://oxidecomputer.github.io/hubris/">Hubris</a> RTOS and its companion debugger Humility, by <a href="https://oxide.computer/">Oxide Computer</a>, had their first release.</li> </ul> <h2 id="our-repositories">Our Repositories</h2> <p>We continued to work on and maintain a number of key Embedded Rust repositories. The following repos all had commits during 2021:</p> <ul> <li><a href="https://github.com/rust-embedded/embedded-hal">embedded-hal</a>: The Embedded Hardware Abstraction Layer is a set of traits for describing common peripherals in a hardware-independent way. It continues its march towards 1.0 status, with a series of 1.0-alpha releases. It should hit 1.0 milestone some time in 2022! 120 commits over 27 files this year.</li> <li><a href="https://github.com/rust-embedded/discovery">discovery</a>: This book on Discovering Embedded Programming using Rust had a re-write this year - it's now based around the BBC micro:Bit! 251 commits over 187 files this year.</li> <li><a href="https://github.com/rust-embedded/book">book</a>: Our guide to all things Embedded Rust continues to be updated and improved, with 39 commits this year.</li> <li><a href="https://github.com/rust-embedded/embedonomicon">embedonomicon</a>: Our guide to all the low-down details on how to bring-up a new <code>#[no_std]</code> platform with Rust saw 15 commits this year.</li> <li><a href="https://github.com/rust-embedded/svd2rust">svd2rust</a>: This tool generates our 'Peripheral Access Crates' from a <a href="https://www.keil.com/pack/doc/CMSIS/SVD/html/index.html">System View Description</a> file of the chip provided by the manufacturer. 122 commits over 17 files this year.</li> <li><a href="https://github.com/rust-embedded/svd">svd</a>: The core libraries used by svd2rust and other tools to manipulate SVD files had 103 commits over 39 files this year.</li> <li><a href="https://github.com/rust-embedded/awesome-embedded-rust">awesome-embedded-rust</a>: Our list of the very best in Embedded Rust keeps growing with 97 commits this year.</li> <li><a href="https://github.com/rust-embedded/cortex-m">cortex-m</a>, <a href="https://github.com/rust-embedded/cortex-m-rt">cortex-m-rt</a>, and <a href="https://github.com/rust-embedded/cortex-m-quickstart">cortex-m-quickstart</a>: Our platform support crates for the Arm Cortex-M architecture saw continued development, with 93 and 54 commits respectively, and a new v0.7 of cortex-m-rt released this year.</li> <li><a href="https://github.com/rust-embedded/cortex-a">cortex-a</a>: Our platform support crate for the Arm Cortex-A architecture saw 25 commits this year.</li> <li><a href="https://github.com/rust-embedded/riscv">riscv</a> and <a href="https://github.com/rust-embedded/riscv-rt">riscv-rt</a>: Our platform support crates for the RISC-V architecture saw 74 and 12 commits respectively this year, with a v0.7 release of riscv.</li> <li><a href="https://github.com/rust-embedded/msp430">msp430</a> and <a href="https://github.com/rust-embedded/msp430">msp430-rt</a>: Our platform support crates for the MSP430 architecture.</li> <li><a href="https://github.com/rust-embedded/gpio-cdev">gpio-cdev</a>, <a href="https://github.com/rust-embedded/rust-spidev">rust-spidev</a>, <a href="https://github.com/rust-embedded/rust-sysfs-gpio">rust-sysfs-gpio</a>, <a href="https://github.com/rust-embedded/rust-i2cdev">rust-i2cdev</a>, and <a href="https://github.com/rust-embedded/linux-embedded-hal">linux-embedded-hal</a>: Support for embedded Linux continued with 177 commits across these projects.</li> <li><a href="https://github.com/rust-embedded/r0">r0</a> was a cross-platform initialisation library, but we deprecated it this year to move such initialisation into platform-specific libraries such as cortex-m-rt.</li> </ul> Tue, 16 Nov 2021 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-30/ https://blog.rust-embedded.org/newsletter-30/ <!-- TODO before release set `draft` to `false` and `in_search_index` to `true` --> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/dkhayes117">@dkhayes117</a> joined the embedded working group's RISC-V team</li> <li>Rust std support <a href="https://github.com/rust-lang/rust/pull/87666">added for the ESP32</a></li> <li><a href="https://mabez.dev/blog/posts/esp-rust-18-10-2021/">Rust on Espressif chips update</a></li> <li><a href="https://blog.drogue.io/lorawan-update/">State of LoRaWAN support</a></li> </ul> <span id="continue-reading"></span><h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/newsletter-next.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://crates.io/crates/cortex-m-rt">cortex-m-rt</a> v0.7.0 was released, with a number of bug fixes.</li> <li><a href="https://crates.io/crates/embedded-hal">embedded-hal</a> 0.2.6 released with some backports from the upcoming 1.0 release: the new Transactional SPI and I2C interface, 10-bit I2C addressing mode, <code>set_state</code> method for <code>OutputPin</code>, and new <code>IoPin</code> trait.</li> <li><a href="https://crates.io/crates/embedded-hal">embedded-hal</a> 1.0.0-alpha.5 released, with a number of new features and changes as we work towards the final 1.0 release.</li> <li><a href="https://crates.io/crates/linux-embedded-hal">linux-embedded-hal</a> 0.3.1 and 0.3.2 released with some backports and updates including an implementation of the Transactional SPI and I2C interface and a bugfix for active-low output pins.</li> <li><a href="https://crates.io/crates/linux-embedded-hal">linux-embedded-hal</a> 0.4.0-alpha.1 released adapted to the <code>embedded-hal</code> 1.0.0-alpha.5 release and a bugfix for active-low output pins.</li> <li><a href="https://crates.io/crates/gpio-cdev">gpio-cdev</a> 0.5.0 released with some updates, including updating to <code>tokio</code> 1.0.</li> <li><a href="https://crates.io/crates/sysfs-gpio">sysfs-gpio</a> 0.6.0 released with some updates, including updating to <code>tokio</code> 1.0.</li> <li><a href="https://crates.io/crates/i2cdev">i2cdev</a> 0.5.0 released with some updates.</li> <li><a href="https://crates.io/crates/spidev">spidev</a> 0.5.0 released with some updates.</li> <li><a href="https://crates.io/crates/drogue-tls">drogue-tls</a> 0.3.0 released with some updates.</li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository.</p> <h2 id="get-involved">Get Involved</h2> <p>This <a href="https://github.com/rust-embedded/wg">Embedded WG</a> blog is where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>!</p> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/newsletter-next.md">the next newsletter</a>, send us a pull request!</p> Tue, 27 Jul 2021 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-29/ https://blog.rust-embedded.org/newsletter-29/ <h2 id="highlights">Highlights</h2> <ul> <li> <p><a href="https://flott-motion.org/news/last-month-in-flott-may-2021/">Last Month in Flott</a>, the monthly newsletter for Flott has been published. Flott is an open source toolkit for motion control software in Rust (designed to run everywhere, including microcontrollers).</p> </li> <li> <p>The <a href="https://crates.io/crates/microbit">microbit crate</a> has released v0.9.0, moved under the <a href="https://github.com/nrf-rs/microbit">nrf-rs</a> organisational umbrella, <strong>and</strong> gained <a href="https://github.com/nrf-rs/microbit/pull/44">micro:bit v2</a> support. 🎉</p> </li> <li> <p>The <a href="https://crates.io/crates/switch-hal">switch-hal crate</a> released v0.4.0, adding <a href="https://docs.rs/switch-hal/0.4.0/switch_hal/trait.StatefulOutputSwitch.html">StatefulOutputSwitch</a> for platforms that support <code>StatefulOutputPin</code>.</p> </li> <li> <p>The <a href="https://probe.rs">probe-rs</a> project, which provides debugging and flash programming for a variety of embedded targets, released version <a href="https://probe.rs/blog/release-0-11-0/">v0.11.0</a>, with a number of performance and functionality improvements.</p> </li> <li> <p><a href="https://crates.io/crates/cortex-m">cortex-m</a> released version 0.7.3, improving ease-of-use for the <code>Delay</code> implementation and fixing native builds on non-x86 hosts.</p> </li> <li> <p><a href="https://crates.io/crates/cortex-m-rt">cortex-m-rt</a> released version 0.6.15, backporting various fixes to the linker script and helping prepare for a new 0.7 release soon.</p> </li> <li> <p><a href="https://github.com/rust-embedded/cross">cross</a> has posted a <a href="https://github.com/rust-embedded/cross/issues/574">call for help</a> looking for new maintainers: if you use cross and would like to help out, please check it out!</p> </li> </ul> <span id="continue-reading"></span><h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-08-24-newsletter-30.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://windfis.ch">Windfisch</a> published their <a href="https://github.com/Windfisch/midikraken">Midikraken</a>, an extensible up-to-16-port MIDI-USB-Interface that also will support standalone operation (e.g. MIDI routing) soon. The project uses Rust's RTIC framework to drive a STM32F103 microcontroller board (a.k.a. "Blue Pill") and is open-source and open-hardware. The firmware is in active development and lots of cool new features are down the way! Kits for self-assembly will likely be sold some day in the future.</li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository.</p> <p>This is the 29th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <h2 id="get-involved">Get Involved</h2> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-08-24-newsletter-30.md">the next newsletter</a>, send us a pull request!</p> Tue, 20 Apr 2021 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-28/ https://blog.rust-embedded.org/newsletter-28/ <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://flott-motion.org/news/last-month-in-flott-april-2021/">Last Month in Flott</a>, the monthly newsletter for Flott has been published. Flott is an open source toolkit for motion control software in Rust (designed to run everywhere, including microcontrollers).</li> </ul> <span id="continue-reading"></span><h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-05-07-newsletter-29.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li>Crate <a href="https://crates.io/crates/device-driver">device-driver</a> has released version 0.2.0!<br /> (Since 0.1.0, added customizable bit ordering and more pac-like write and modify interface)</li> <li>After almost a year <a href="https://crates.io/crates/stm32f4xx-hal">stm32f4xx-hal</a> has released version 0.9.0! Get it while it's hot. 🔥🌶️</li> <li><a href="https://crates.io/crates/embedded-graphics/0.7.0-beta.1">embedded-graphics 0.7.0-beta.1 released</a> as the first stable step towards the long awaited 0.7.0! There should be no major/breaking changes after this release as we work mostly on documentation, bugfixes and polish. See the release notes <a href="https://github.com/embedded-graphics/embedded-graphics/releases/tag/embedded-graphics-v0.7.0-beta.1">here</a>.</li> <li><a href="https://crates.io/crates/svd2rust">svd2rust 0.18.0</a> was released, bringing a number of changes to PAC generation; if you maintain a PAC please try it out!</li> <li><a href="https://crates.io/crates/shared-bus">shared-bus 0.2.1</a> was released, with support for concurrency frameworks like RTIC. Check the <a href="https://docs.rs/shared-bus/latest/shared_bus/type.BusManagerAtomicCheck.html">relevant documentation</a> for more details.</li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository.</p> <h2 id="get-involved">Get Involved</h2> <p>This is the 28th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>!</p> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-05-07-newsletter-29.md">the next newsletter</a>, send us a pull request!</p> <!-- TODO before release add the next template! --> Tue, 16 Mar 2021 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-27/ https://blog.rust-embedded.org/newsletter-27/ <h2 id="highlights">Highlights</h2> <ul> <li> <p><a href="https://github.com/hannobraun">@hannobraun</a> published <a href="https://flott-motion.org/news/last-month-in-flott-march-2021/">Last Month in Flott - March 2021</a>, the monthly newsletter for Flott. Flott is an open source toolkit for motion control software in Rust (designed to run everywhere, including microcontrollers).</p> </li> <li> <p>The <a href="https://github.com/rust-embedded/cortex-m">cortex-m crate</a> has been updated to 0.7, including a recent release of 0.7.2, please update your dependencies and let us know if you encounter any issues!</p> </li> <li> <p>The Embedded Rust documentation and books have moved URLs, and are now all available from https://docs.rust-embedded.org.</p> </li> <li> <p>This blog has also moved URLs, and is now available at https://blog.rust-embedded.org</p> </li> <li> <p>Our weekly meetings continue at 8PM Berlin Time on our Matrix channel, <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>. Join us to catch up on the latest developments in the Embedded Rust ecosystem!</p> </li> </ul> <span id="continue-reading"></span><h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-04-16-newsletter-28.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/hannobraun">@hannobraun</a> released <a href="https://flott-motion.org/news/ramp-maker-0-2/">RampMaker 0.2</a>, a library for generating stepper motor acceleration profiles, and <a href="https://flott-motion.org/news/stepper-0-5/">Stepper 0.5</a>, the universal stepper motor interface. Both libraries are part of the <a href="https://flott-motion.org/">Flott</a> motion control toolkit.</li> <li><a href="https://github.com/embassy-rs/embassy">embassy</a>, an async/await executor designed for embedded usage and currently supporting nRF and STM32F4 devices, is nearing its first crates.io release. Feedback and testing would be welcome!</li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository.</p> <h2 id="get-involved">Get Involved</h2> <p>This is the 27th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <!-- TODO uncomment --> <!-- Discuss on [#rust-embedded:matrix.org], [users.rust-lang.org], [on twitter], or [on reddit]! --> <!-- [#rust-embedded:matrix.org]: https://matrix.to/#/#rust-embedded:matrix.org --> <!-- [users.rust-lang.org]: https://example.org/#TODO --> <!-- [on twitter]: https://example.org/#TODO --> <!-- [on reddit]: https://example.org/#TODO --> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-04-16-newsletter-28.md">the next newsletter</a>, send us a pull request!</p> <!-- TODO before release add the next template! --> Tue, 16 Feb 2021 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-26/ https://blog.rust-embedded.org/newsletter-26/ <h2 id="highlights">Highlights</h2> <ul> <li> <p><a href="https://twitter.com/CecileTonglet">@cecton</a> wrote a blog post targeted to experienced developers but embedded development beginners: <a href="https://blog.cecton.com/posts/rust-and-arduino-part1/">Rust, Arduino and Embedded Development as a Beginner: Part 1</a></p> </li> <li> <p><a href="https://twitter.com/braincode">@brainstorm</a> and <a href="https://twitter.com/_joshajohnson">@joshajohnson</a> Created a RTIC example for an HID mouse with a blackberry trackball <a href="https://github.com/brainstorm/bbtrackball-rs">bbtrackball-rs</a>.</p> </li> <li> <p>The <a href="https://github.com/knurling-rs/meta">knurling-rs</a> tooling initiative by <a href="https://ferrous-systems.com">Ferrous Systems</a> has grown: after <a href="https://ferrous-systems.com/blog/defmt/"><code>defmt</code></a>, the project has publicly released three new tools:</p> <ul> <li><a href="https://github.com/knurling-rs/flip-link"><code>flip-link</code></a>, a linker wrapper that adds zero-cost stack overflow protection to your project</li> <li><a href="https://github.com/knurling-rs/probe-run"><code>probe-run</code></a>, a Cargo runner that seamlessly runs embedded programs on your target device as if they were native ones</li> <li><a href="https://github.com/knurling-rs/defmt-test"><code>defmt-test</code></a>, a proc-macro to write and run unit tests on embedded devices</li> </ul> </li> <li> <p>The Rust Embedded Working Group's MSRV (Minimum Supported Rust Version) policy has been updated and now only requires that crates build on the latest stable Rust release. See <a href="https://github.com/rust-embedded/wg/pull/523">msrv</a> for more details.</p> </li> </ul> <span id="continue-reading"></span><h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-03-16-newsletter-27.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/eldruin">@eldruin</a> released a platform-agnostic <a href="https://crates.io/crates/embedded-ccs811">driver for the CCS811</a> indoor air quality sensor and published a <a href="https://blog.eldruin.com/ccs811-indoor-air-quality-sensor-driver-in-rust/">blog post</a> including example setups.</li> <li><a href="https://github.com/diondokter">@diondokter</a> released a first version of <a href="https://crates.io/crates/device-driver">device-driver</a> which can aid driver developers in developing device drivers. For now only register interfaces are supported as is laid out in <a href="https://twitter.com/Geoxion/status/1303849776665026561">this twitter thread</a>.</li> <li><a href="https://twitter.com/dbrgn/">@dbrgn</a> released version 0.2 of the <a href="https://docs.rs/debouncr/">debouncr</a> crate. It now supports stateful debouncing, meaning that the user can now choose whether every bouncing→stable transition should be detected as an edge, or only high↔︎low transitions.</li> </ul> <!-- LINK SECTION FOR HIGHLIGHTS AND EMBEDDED PROJECTS --> <h2 id="get-involved">Get Involved</h2> <p>This is the 26th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>!</p> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2021-03-16-newsletter-27.md">the next newsletter</a>, send us a pull request!</p> Mon, 24 Aug 2020 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-25/ https://blog.rust-embedded.org/newsletter-25/ <p>This is the 25th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>As a note, some of these stories have happened over the past months. We're still working on catching up, but wanted to share them with you!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>, <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-25/47744">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1298004492475150338">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/ifxv2h/the_embedded_working_group_newsletter_25/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-08-31-newsletter-26.md">the next newsletter</a>, send us a pull request!</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="http://github.com/braun-embedded">@hannobraun</a> wrote an <a href="https://braun-embedded.com/dw1000/">article about his DW1000 driver</a>.</li> <li><a href="https://github.com/andre-richter">@andre-richter</a> added a new tutorial to the <a href="https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials">Operating System development tutorials in Rust on the Raspberry Pi</a> series: <ul> <li><a href="https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials/tree/master/14_exceptions_part2_peripheral_IRQs">Tutorial 14: Exceptions Part 2: Peripheral IRQs</a> - Including drivers for the BCM and GICv2 interrupt controllers.</li> </ul> </li> <li>In recent nightlies,<code>rust-std</code> support for the two <code>bare-metal</code> <code>aarch64</code> targets <a href="https://github.com/rust-lang/rust/pull/68334">has landed</a>. <ul> <li>Add them using <code>rustup target add aarch64-unknown-none-softfloat</code> or <code>rustup target add aarch64-unknown-none</code>.</li> <li><a href="https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials/commit/c4f9432e131f6aa6dd58b9ba795d67ec3bfd3c7f">See it in action here</a> for building a kernel without the need for third-party tools like <code>xbuild</code> or <code>xargo</code>.</li> </ul> </li> <li><a href="https://github.com/therealprof">@therealprof</a> wrote an <a href="https://therealprof.github.io/blog/usb-c-pill-part1/">introduction article about the "USB-C pill"</a>.</li> <li><a href="https://github.com/bobmcwhirter">@bobmcwhirter</a> wrote an article about using an <a href="https://blog.drogue.io/wifi-offload/">ESP8266 as a WiFi offload with an STM32F401RE</a></li> <li><a href="https://ferrous-systems.com">Ferrous Systems</a> released <a href="https://ferrous-systems.com/blog/defmt/">defmt</a>, a highly efficient Rust logging framework for embedded devices</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li><a href="https://twitter.com/Rubberduck203">@rubberduck203</a> released the experimental <a href="https://crates.io/crates/switch-hal">switch-hal crate</a>, which provides a zero-cost abstraction over Active High/Active Low GPIO, allowing application developers to more clearly express their intent and for drivers to avoid making runtime decisions about driving a line high or low based on the pin's active level.</li> <li><a href="https://twitter.com/Rubberduck203">@rubberduck203</a> has also released the <a href="https://crates.io/crates/stm32f3-discovery">stm32f3-discovery board support crate</a> as an alternative to the unmaintained <code>f3</code> crate.</li> <li>The <a href="https://github.com/rubberduck203/stm32f3-discovery-quickstart/">stm32f3-discovery-quickstart</a> template has been updated to utilize both the <a href="https://crates.io/crates/stm32f3-discovery">stm32f3-discovery board support crate</a> and the <a href="https://crates.io/crates/switch-hal">switch-hal crate</a>. It also now includes VS Code tasks for cleaning, building examples, and building in release mode.</li> <li><a href="https://github.com/proman21">@proman21</a> has released a beta version of <a href="https://github.com/proman21/samd-timer/">samd-timer</a>, an abstraction for the Timer peripherals present on Atmel SAM microcontrollers. This library provides lower-level control over these timers than <a href="https://github.com/atsamd-rs/atsamd/">atsamd-hal</a>, while remaining compatible with the HAL clock system.</li> <li><a href="https://github.com/dbrgn">@dbrgn</a> and <a href="https://github.com/rnestler">@rnestler</a> released a first version of the <a href="https://docs.rs/shtcx/">shtcx</a> embedded-hal driver for Sensirion SHTCx series humidity/temperature sensors. The driver is feature-complete, but currently supports only a blocking API. The crate will be updated with an alternative non-blocking API soon.</li> <li><a href="https://github.com/ra-kete">@ra-kete</a> released the <a href="https://crates.io/crates/microfft">microfft crate</a>, a library for computing fast fourier transforms on embedded devices.</li> <li><a href="https://github.com/dajamante">@dajamante</a> added an <a href="https://github.com/Dajamante/avr-car">obstacle avoiding robot</a> with more <a href="https://github.com/Dajamante/avr-car/blob/master/article.md">details in this article</a>.</li> <li><a href="https://github.com/therealprof">@therealprof</a> released the <a href="https://crates.io/crates/display-interface">display-interface crate</a>, an abstraction over the different possibilities to drive a display.</li> <li><a href="https://github.com/bugadani">@bugadani</a> released the <a href="https://github.com/bugadani/embedded-text">embedded-text crate</a>, a text rendering library built on top of <a href="https://github.com/jamwaffles/embedded-graphics">embedded-graphics</a>.</li> <li><a href="https://github.com/bobmcwhirter">@bobmcwhirter</a> released the <a href="https://crates.io/crates/drogue-esp8266">drogue-esp8266</a>, a WiFi-offload embedded-nal implementation crate.</li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-08-31-newsletter-26.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">47</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">33</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">38</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">52</td><td style="text-align: left">+7</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">85</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">41</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip-1">no-std crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">3</td><td style="text-align: left">0</td></tr> </tbody></table> Mon, 17 Aug 2020 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-24/ https://blog.rust-embedded.org/newsletter-24/ <p>This is the 24th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>We've been on an unscheduled hiatus for the past six months or so, but it's time for us to return! Today we're doing a quick fast-forward of all of the great things that have been released while we've been on break.</p> <p>For the next few weeks, we'll be doing a special "catch-up" schedule, meaning we'll be releasing articles weekly until we've caught up with all of the recent changes. Once we've wrapped that up, we'll go back to a regular monthly cadence.</p> <p>We've also added a few new folks to the <a href="https://github.com/rust-embedded/wg#the-resources-team">resources team</a> say hello to <a href="https://github.com/hargonix/">@hargoniX</a>, <a href="https://github.com/eldruin">@eldruin</a> and <a href="https://github.com/kalkyl">@kalkyl</a> who will be helping out with the newsletter!</p> <p>Want to have your project mentioned? Make sure you <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-08-24-newsletter-25.md">let us know</a> so we can include it!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>, <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-24/47405">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1295330780688809986">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/ibcvnz/the_embedded_working_group_newsletter_24/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-08-24-newsletter-25.md">the next newsletter</a>, send us a pull request!</p> <h2 id="the-great-catch-up">The Great Catch-Up!</h2> <p>Here's a whirlwind overview of some of the things that have been released and changed over the past six months or so! We'll cover some of these updates in more detail over the coming weeks!</p> <h3 id="renames">Renames</h3> <ul> <li>The RTFM framework has been renamed to RTIC - Real Time Interrupt-driven Concurrency!</li> </ul> <h3 id="resources">Resources</h3> <ul> <li>We've added <a href="https://os.phil-opp.com/">phil's OS blog</a> to our list of resources</li> <li><a href="https://github.com/hargonix">@hargoniX</a> has added a blog post on <a href="https://hboeving.dev/blog/rust-2c-driver-p1/">embedded driver writing</a></li> </ul> <h3 id="tooling">Tooling</h3> <ul> <li>the <a href="https://probe.rs">probe-rs organization</a> has added a lot of wonderful new tooling, including <a href="https://crates.io/crates/cargo-flash">cargo-flash</a> and <a href="https://crates.io/crates/cargo-embed">cargo-embed</a></li> <li><a href="https://crates.io/crates/cargo-hf2">cargo-hf2</a> for "A small cargo subcommand to download cargo builds to Microsoft UF2 bootloaders via HID USB"</li> <li>The <a href="https://github.com/knurling-rs/meta">Knurling-rs</a> project for embedded tooling has kicked off by releasing <a href="https://github.com/knurling-rs/probe-run">probe-run</a></li> </ul> <h3 id="bindings">Bindings</h3> <ul> <li><a href="https://crates.io/crates/freertos-rust">FreeRTOS-rust</a> as RTOS bindings (not to be confused with <a href="https://crates.io/crates/freertos_rs">FreeRTOS.rs</a> )</li> </ul> <h3 id="new-possibilities">New Possibilities</h3> <ul> <li>It is <a href="https://ferrous-systems.com/blog/stable-async-on-embedded/">now possible</a> to run <a href="https://blog.rust-lang.org/2020/06/04/Rust-1.44.0.html">async/await on embedded</a>!</li> <li>Applications can now be compiled for <a href="https://github.com/rust-lang/rust/issues/44052#issuecomment-663394401">AVR in mainline Rust nightly builds</a>!</li> </ul> <h3 id="pacs">PACs</h3> <ul> <li><a href="https://crates.io/crates/msp430fr2355">msp430fr2355 PAC</a> has been added</li> <li><a href="https://crates.io/crates/ambiq-apollo1-pac">ambiq-apollo1-pac</a>, <a href="https://crates.io/crates/ambiq-apollo2-pac">ambiq-apollo2-pac</a> and <a href="https://crates.io/crates/ambiq-apollo3p-pac">ambiq-apollo3p-pac</a> have been added</li> </ul> <h3 id="hals">HALs</h3> <ul> <li><a href="https://crates.io/crates/msp430fr2x5x-hal">msp430fr2x5x-hal</a> has been added</li> </ul> <h3 id="bsps">BSPs</h3> <ul> <li>a <a href="https://crates.io/crates/onebitsy">BSP for the onebitsy</a></li> <li>Several Adafruit BSPs: <ul> <li><a href="https://crates.io/crates/metro_m0">metro_m0</a></li> <li><a href="https://crates.io/crates/pygamer">pygamer</a></li> <li><a href="https://crates.io/crates/feather-f405">feather-f405</a></li> <li><a href="https://crates.io/crates/feather_m0">feather_m0</a></li> <li><a href="https://crates.io/crates/feather_m4">feather_m4</a></li> <li><a href="https://crates.io/crates/circuit_playground_express">circuit_playground_express</a></li> <li><a href="https://crates.io/crates/edgebadge">edgebadge</a></li> <li><a href="https://crates.io/crates/gemma_m0">gemma_m0</a></li> <li><a href="https://crates.io/crates/itsybitsy_m0">itsybitsy_m0</a></li> <li><a href="https://crates.io/crates/itsybitsy_m4">itsybitsy_m4</a></li> <li><a href="https://crates.io/crates/trinket_m0">trinket_m0</a></li> </ul> </li> <li>Several arduino BSPs: <ul> <li><a href="https://crates.io/crates/arduino_mkrvidor4000">arduino_mkrvidor4000</a></li> <li><a href="https://crates.io/crates/arduino_mkrzero">arduino_mkrzero</a></li> <li><a href="https://crates.io/crates/arduino_nano33iot">arduino_nano33iot</a></li> </ul> </li> <li>The <a href="https://crates.io/crates/samd21_mini">samd21_mini BSP</a></li> <li>The <a href="https://crates.io/crates/xiao_m0">xiao_m0 BSP</a></li> </ul> <h3 id="general-abstraction-crates">General abstraction crates</h3> <ul> <li>The <a href="https://github.com/BlackbirdHQ/atat">atat crate</a> for parsing AT commands</li> </ul> <h3 id="drivers">Drivers</h3> <ul> <li><a href="https://crates.io/crates/adxl313">ADXL313</a></li> <li><a href="https://crates.io/crates/anyleaf">AnyLeaf</a></li> <li><a href="https://crates.io/crates/dht-sensor">dht-sensor</a></li> <li><a href="https://crates.io/crates/max6955">MAX6955</a></li> <li><a href="https://crates.io/crates/microchip-eeprom-25lcxx">MCP25LCXX</a></li> <li><a href="https://crates.io/crates/microchip-tc72r-rs">TC72</a></li> <li><a href="http://crates.io/crates/st7789">ST7789</a></li> <li><a href="https://crates.io/crates/dw1000">DW1000</a></li> <li><a href="https://crates.io/crates/adafruit-7segment">Adafruit-7segment</a></li> </ul> <h3 id="wip-drivers">WIP Drivers</h3> <ul> <li><a href="https://crates.io/crates/bmi160">BMI160</a></li> <li><a href="https://crates.io/crates/epd-waveshare">epd-waveshare</a></li> <li><a href="https://crates.io/crates/hrs3300">HRS3300</a></li> <li><a href="https://crates.io/crates/hdc20xx">HDC20xx</a></li> <li><a href="https://crates.io/crates/isl29125">ISL29125</a></li> <li><a href="https://crates.io/crates/lsm9ds1">LSM9DS1</a></li> <li><a href="https://crates.io/crates/ltr-559">ltr-559</a></li> <li><a href="https://github.com/rafaelcaricio/lvgl-rs">lvgl</a></li> <li><a href="https://github.com/eldruin/max170xx-rs">MAX170xx</a></li> <li><a href="https://crates.io/crates/max3010x">MAX3010x</a></li> <li><a href="https://crates.io/crates/mcp4725">MCP4725</a></li> <li><a href="https://crates.io/crates/mlx9061x">MLX9061x</a></li> <li><a href="https://github.com/BlackbirdHQ/ublox-cellular-rs">ublox-cellular-rs</a></li> </ul> <h3 id="no-std-crates">no_std crates</h3> <ul> <li><a href="https://crates.io/crates/debouncr">debouncr</a></li> <li><a href="https://crates.io/crates/embedded-crc-macros">embedded-crc-macros</a></li> <li><a href="https://crates.io/crates/embedded-websocket">embedded-websocket</a></li> <li><a href="https://crates.io/crates/endian_codec">endian_codec</a></li> <li><a href="https://crates.io/crates/gdbstub">gdbstub</a></li> <li><a href="https://crates.io/crates/microfft">microfft</a></li> <li><a href="https://crates.io/crates/smbus-pec">smbus-pec</a></li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">46</td><td style="text-align: left">+4</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">33</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">38</td><td style="text-align: left">+17</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">45</td><td style="text-align: left">+9</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">84</td><td style="text-align: left">+13</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">41</td><td style="text-align: left">+7</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip-1">no-std crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">3</td><td style="text-align: left">+0</td></tr> </tbody></table> Sat, 01 Feb 2020 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-23/ https://blog.rust-embedded.org/newsletter-23/ <p>This is the 23rd newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>, <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-23/37708">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1223606976527114240">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/ex6ike/the_23rd_embedded_working_group_newsletter/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-02-29-newsletter-24.md">the next newsletter</a>, send us a pull request!</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/lupyuen">@lupyuen</a> has been doing very cool things with Rust and the PineTime smart watch - see <a href="https://medium.com/@ly.lee/porting-druid-rust-widgets-to-pinetime-smart-watch-7e1d5a5d977a">Porting druid Rust Widgets to PineTime Smart Watch</a> and <a href="https://medium.com/@ly.lee/optimising-pinetimes-display-driver-with-rust-and-mynewt-3ba269ea2f5c">Optimising PineTime’s Display Driver with Rust and Mynewt</a>.</li> <li><a href="https://github.com/rust-embedded/rust-raspi3-OS-tutorials/tree/master/13_integrated_testing">The Raspberry Pi OS dev tutorial</a> got a new chapter on Kernel Unit, Integration and Console tests using QEMU</li> <li>Google announced <a href="https://security.googleblog.com/2020/01/say-hello-to-opensk-fully-open-source.html">OpenSK</a>, an open source security key based on <a href="https://www.tockos.org/">TockOS</a> in Embedded Rust</li> <li><a href="https://ferrous-systems.com">Ferrous Systems</a> announced the second iteration of <a href="https://oxidizeconf.com">Oxidize</a>, an embedded Rust conference in Berlin Germany, will take place in July of 2020. Read the <a href="https://ferrous-systems.com/blog/oxidize-2020/">Announcement Blog Post</a> for more details</li> <li><a href="https://github.com/PLCnext/">PLCnext</a> shared a <a href="https://github.com/PLCnext/rust-sample-runtime">Sample Rust Runtime</a> and a how-to guide for running deterministic real-time Rust on an industrial Linux device</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li><a href="https://github.com/almindor">@almindor</a> released a platform-agnostic <a href="https://crates.io/crates/max7219">driver for the MAX7219</a> segmented display and published a <a href="https://blog.katona.me/2019/12/22/MAX7219-segmented-display-driver-in-Rust/">blog post</a> including a picture of an example setup.</li> <li><a href="https://github.com/dbrgn/embedded-hal-mock/">embedded-hal-mock</a> has released 0.7.1 on crates.io with <a href="https://docs.rs/embedded-hal-mock/0.7.1/embedded_hal_mock/i2c/index.html#testing-error-handling">support for error expectations</a>. This means that you can now unit test the error handling logic of your embedded-hal driver crates.</li> <li><a href="https://twitter.com/Rubberduck203">@rubberduck203</a> added VS Code configurations to the <a href="https://github.com/rust-embedded/cortex-m-quickstart">cortex-m-quickstart</a> and published a <a href="https://christopherjmcclellan.wordpress.com/2019/12/31/debugging-rust-cortex-m-with-vs-code-take-2/">blog post</a>. Debugging Cortex-M projects in editor with VS Code now works out of the box.</li> <li><a href="https://twitter.com/Rubberduck203">@rubberduck203</a> released a <a href="https://github.com/rubberduck203/stm32f3-discovery-quickstart">quickstart template for the STM32F3DISCOVERY board</a> with pre-configured linker script &amp; build targets.</li> <li><a href="https://github.com/jkristell">@jkristell</a> released version 0.6 of the <a href="https://github.com/jkristell/infrared">Infrared</a> crate and published a <a href="https://jott.se/blog/infrared">blog post</a> on how to add remote control support to an embedded Rust project.</li> <li>Steven Walter gave a talk at <a href="http://www.rust-belt-rust.com/">Rust Belt Rust</a> about <a href="https://www.youtube.com/watch?v=EoV94cg_Tug">introducing Rust into an existing embedded Linux project</a>.</li> <li><a href="https://github.com/arosspope">@arosspope</a> released an implementation of <a href="https://github.com/arosspope/usnake">the game snake for the stm32f3 discovery board</a> using RTFM.</li> <li>Rust firmware for <a href="https://github.com/quartiq/stabilizer">Stabilizer</a> has been released. <a href="https://github.com/sinara-hw/Stabilizer/wiki">Stabilizer</a> is an open hardware, high speed, multi channel, STM32H743 based feedback controller for Quantum Physics applications. The firmware features <a href="https://github.com/rtfm-rs/cortex-m-rtfm">RTFM v0.5</a> and <a href="https://github.com/m-labs/smoltcp">smoltcp</a>. Support for several analog front end mezzanines like current stabilization or Pound-Drever-Hall locks is being developed.</li> <li><a href="https://twitter.com/42technology">@42technology</a> announced they have ported Cloudflare's Rust-language <a href="https://en.wikipedia.org/wiki/QUIC">QUIC</a> library (known as '<a href="https://github.com/cloudflare/quiche">quiche</a>') to the Nordic nRF9160, producing possibly the world's first QUIC demonstration on that platform.</li> <li><a href="https://github.com/atsamd-rs/atsamd">atsamd-hal</a> 0.8.2 released, which includes work by <a href="https://github.com/twitchyliquid64">@twitchyliquid64</a> and <a href="https://github.com/jacobrosenthal">@jacobrosenthal</a> implementing USB support for SAMD21 and SAMD51 devices.</li> <li><a href="https://github.com/Disasm">@Disasm</a> released <a href="https://github.com/riscv-rust/longan-nano/">longan-nano</a> and <a href="https://github.com/riscv-rust/seedstudio-gd32v">seedstudio-gd32v</a> board support crates with examples for the corresponding RISC-V boards.</li> </ul> <!-- LINK SECTION FOR HIGHLIGHTS AND EMBEDDED PROJECTS --> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-02-29-newsletter-24.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">42</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">32</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">21</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">36</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">71</td><td style="text-align: left">+4</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">34</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip-1">no-std crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">3</td><td style="text-align: left">0</td></tr> </tbody></table> Wed, 01 Jan 2020 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-22/ https://blog.rust-embedded.org/newsletter-22/ <p>This is the 22nd newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>, <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-22/36377">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1212379226231492614">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/eiisk9/the_22nd_embedded_working_group_newsletter/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-01-30-newsletter-23.md">the next newsletter</a>, send us a pull request!</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/andre-richter">@andre-richter</a> added a new tutorial for the <code>Operating System development tutorials in Rust on the Raspberry Pi</code> series: <ul> <li>Tutorial 13: <a href="https://github.com/rust-embedded/rust-raspi3-OS-tutorials/tree/master/13_integrated_testing">Integrated Testing</a> - Kernel <code>Unit tests</code>, <code>Integration tests</code> and <code>Console tests</code> using <code>QEMU</code>.</li> </ul> </li> <li><a href="https://twitter.com/bitshiftmask">@jamesmunns</a> sketched out a few introductory notes about foundational Embedded Rust Crates like <code>r0</code>, <code>cortex-m</code>, <code>PAC</code>s, and <code>HAL</code>s. See <a href="https://twitter.com/bitshiftmask/status/1210714309124186112">part 1</a> and <a href="https://twitter.com/bitshiftmask/status/1211031300531986432">part 2</a> on Twitter!</li> <li><a href="https://twitter.com/bitshiftmask">@jamesmunns</a> wrote about the cost of <a href="https://jamesmunns.com/blog/fmt-unreasonably-expensive/">Formatting in Embedded Rust</a> as part of the <a href="https://twitter.com/hashtag/rust2020">#rust2020</a> effort, and how to reduce code size while maintaining panic debug-ability</li> <li><a href="https://github.com/craigjb">Craig Bishop</a> wrote an overview of <a href="https://craigjb.com/2019/12/31/stm32l0-rust/">Getting Started on the STM32L0</a>, which contains an excellent breakdown of what makes up an Embedded Rust project</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li> <p><a href="https://github.com/andre-richter">@andre-richter</a> released v0.1.0 of <a href="https://crates.io/crates/qemu-exit"><code>qemu-exit</code></a>. This library provides functions to gracefully exit a running QEMU session from within your Rust binary with an user-defined exit code. This can be used for unit or integration tests that run inside QEMU. Currently supports <code>aarch64</code> and <code>x86_64</code> architectures.</p> </li> <li> <p><a href="https://github.com/eldruin">@eldruin</a> released a platform-agnostic <a href="https://crates.io/crates/si4703">driver for the Si4703</a> FM radio turner (receiver) and published a <a href="https://blog.eldruin.com/si4703-fm-radio-receiver-driver-in-rust/">blog post</a> including a picture of an example setup.</p> </li> <li> <p><a href="https://github.com/eldruin">@eldruin</a> released a platform-agnostic <a href="https://crates.io/crates/pwm-pca9685">driver for the PCA9685</a> PWM LED/Servo controller driver and published a <a href="https://blog.eldruin.com/pca9685-pwm-led-servo-controller-driver-in-rust/">blog post</a> including a video of the device controlling RGB LEDs and several Servo motors simultaneously.</p> </li> <li> <p><a href="https://github.com/eldruin">@eldruin</a> released a platform-agnostic <a href="https://crates.io/crates/veml6030">driver for Vishay's VEML6030 and VEML7700</a> ambient light sensors and published a <a href="https://blog.eldruin.com/veml6030-ambient-light-sensor-driver-in-rust/">blog post</a> about it.</p> </li> <li> <p><a href="https://github.com/nickray">@nickray</a> released <code>salty</code> (<a href="https://api.salty.rs">API</a>, <a href="https://book.salty.rs">book</a>, <a href="https://code.salty.rs">code</a>), a library for fast Ed25519 signatures on Cortex-M4 and Cortex-M33 microcontrollers. It presents the <code>ed25519-dalek</code> API, but is self-contained and uses the fastest currently published field operations implementation, due to Bjoern Haase, based on the <code>UMAAL</code> DSP instruction <code>(a: u32, b: u32, c: u32, d: u32) -&gt; (a * b + c + d): u64</code>. Testing is done on the <code>musca-b1</code> Cortex-M33 microcontroller, simulated in QEMU v4. Additionally, a C API is included.</p> </li> <li> <p><a href="https://github.com/nickray">@nickray</a> released <code>littlefs2</code> (<a href="https://docs.rs/littlefs2">API</a>, <a href="https://github.com/nickray/littlefs2">code</a>), an idiomatic Rust API for the <a href="https://github.com/ARMmbed/littlefs"><code>littlefs</code></a> filesystem for microcontrollers, modeled after <code>std::fs</code>. The upstream library claims to be resilient against power-loss, and supports features like dynamic wear-leveling with bad block detection, inline files for efficient use of storage, and custom user attributes on files and directories.</p> </li> <li> <p><a href="https://github.com/nickray">@nickray</a> released <code>nisty</code> (<a href="https://docs.rs/nisty">API</a>, <a href="https://github.com/nickray/nisty">code</a>), a companion library to <code>salty</code> with similar API, but for NIST P-256 signatures on Cortex-M4 and Cortex-M33 microcontrollers. It offers deterministic signatures, idiomatic conversions, and uses <a href="https://github.com/kmackay/micro-ecc"><code>micro-ecc</code></a> as backend implementation, which also has <code>UMAAL</code> DSP instruction optimizations.</p> </li> <li> <p><a href="https://github.com/probe-rs/probe-rs">probe-rs</a> has finally released 0.3.0 on crates.io. Its <code>cargo-flash</code> extension has improved by a large margin! Flashing speed has increased 10x and it is possible to virtually flash any ARM core thanks to the use of CMSIS-Pack flash algorithms.</p> <ul> <li>You can create your own target description from a CMSIS-Pack with the use of <a href="https://github.com/probe-rs/target-gen">target-gen</a></li> <li>Built in algorithms support the <strong>nRF51xxx, nRF91xxx, nRF52xxx, STM32F1xx, LPC8xx and LPC55S66 and LPC55S69</strong> series using a <strong>DAPLink</strong> or an <strong>ST-Link</strong>.</li> <li>Please file a <a href="https://github.com/probe-rs/probe-rs/pulls">PR</a> if you extracted an algorithm for your chip and tested it!</li> <li>We are looking for contributors. We have lots of non-ARM-specific stuff to do as well, such as improving erroring, useability and documentation including a webpage on the newly acquired <a href="https://probe.rs">probe.rs</a> domain.</li> <li>Join us on <a href="https://matrix.to/#/#probe-rs:matrix.org">#probe-rs:matrix.org</a></li> <li>0.4.0 will finally feature GDB support :) Stay tuned!</li> </ul> </li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2020-01-30-newsletter-23.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">39</td><td style="text-align: left">+7</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">31</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">33</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">67</td><td style="text-align: left">-2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">32</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip-1">no-std crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">3</td><td style="text-align: left">0</td></tr> </tbody></table> Sat, 30 Nov 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-21/ https://blog.rust-embedded.org/newsletter-21/ <p>This is the 21st newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://matrix.to/#/#rust-embedded:matrix.org">#rust-embedded:matrix.org</a>, <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-21/35191">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1200762672117166081">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/e3w3bz/the_21st_embedded_working_group_newsletter/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-12-26-newsletter-22.md">the next newsletter</a>, send us a pull request!</p> <h2 id="highlights">Highlights</h2> <ul> <li>Don't forget to join our <a href="https://matrix.to/#/#rust-embedded:matrix.org">Community Chat on Matrix</a>, with more than 250 Embedded Rustaceans!</li> <li><a href="https://github.com/andre-richter">@andre-richter</a> added two new tutorials for the <code>Operating System development tutorials in Rust on the Raspberry Pi</code> series: <ul> <li>Tutorial 11: <a href="https://github.com/rust-embedded/rust-raspi3-OS-tutorials/tree/master/11_virtual_memory">Virtual Memory</a></li> <li>Tutorial 12: <a href="https://github.com/rust-embedded/rust-raspi3-OS-tutorials/tree/master/12_cpu_exceptions_part1">CPU Exceptions: Part 1</a></li> </ul> </li> <li><a href="https://github.com/jamesmunns">@jamesmunns</a> streamed some work on developing interrupt and panic code <a href="https://www.youtube.com/watch?v=KT6VnwuouPY">on youtube</a></li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li><a href="https://github.com/eldruin">@eldruin</a> released a platform-agnostic <a href="https://crates.io/crates/opt300x">driver for the OPT300x</a> family of ambient light sensors and published a <a href="https://blog.eldruin.com/opt300x-ambient-light-sensor-driver-in-rust/">blog post</a> with a picture of the device taking lux measurements.</li> <li>@mciantyre published a custom runtime and peripheral access crates to support development on the Teensy 4. Check out <a href="https://github.com/mciantyre/teensy4-rs">the repo</a> to see how it works, discuss the approach, and try it out.</li> <li><a href="https://github.com/japaric">@japaric</a> released version v0.1.0 of <a href="https://crates.io/crates/ufmt/0.1.0"><code>ufmt</code></a>, a smaller (6-40x) and faster (2-9x) alternative to <code>core::fmt</code> that's free of dynamic dispatch, recursion (where possible) and panicking branches. <code>ufmt</code> is <em>not</em> a drop-in replacement for <code>core::fmt</code> but it provides <code>uDebug</code> and <code>uDisplay</code> traits and a family of <code>uwrite!</code> macros. In this release the <code>uwrite!</code> macros, and the rest of the crate, work on the stable channel.</li> <li><a href="https://github.com/jamesmunns">@jamesmunns</a> released two embedded crates: <ul> <li><a href="https://crates.io/crates/panic-persist"><code>panic-persist</code></a>: A panic handler crate inspired by <code>panic-ramdump</code> that logs panic messages to a region of RAM defined by the user, allowing for discovery of panic messages post-mortem using normal program control flow.</li> <li><a href="https://crates.io/crates/cmim"><code>cmim</code></a>, or Cortex-M Interrupt Move: A crate for Cortex-M devices to move data to interrupt context, without needing a critical section to access the data within an interrupt, and to remove the need for the "mutex dance"</li> </ul> </li> <li><a href="https://github.com/tarcieri">@tarcieri</a> released <a href="https://docs.rs/aead"><code>aead</code></a> v0.2, providing generic traits for Authenticated Encryption with Associated Data (AEAD) ciphers, which now supports <a href="https://docs.rs/chacha20poly1305/0.3.0/chacha20poly1305/#in-place-usage-eliminates-alloc-requirement">ergonomic <code>alloc</code>-free operation</a> via an integration with the <a href="https://docs.rs/heapless"><code>heapless</code></a> crate. This trait is now implemented by <a href="https://github.com/rustcrypto/aeads#crates">several crates providing pure Rust implementations of AEAD modes</a> which may be interesting to embedded users seeking to encrypt/data data in <code>heapless</code> buffers, including the <a href="https://docs.rs/chacha20poly1305/"><code>chacha20poly1305</code></a> and <a href="https://docs.rs/aes-siv/"><code>aes-siv</code></a> crates (and forthcoming support in the <a href="https://github.com/martindisch/aes-ccm/issues/2"><code>aes-ccm</code></a> crate).</li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-12-26-newsletter-22.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">32</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">29</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">30</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">69</td><td style="text-align: left">-1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">30</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip-1">no-std crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">3</td><td style="text-align: left">0</td></tr> </tbody></table> Tue, 05 Nov 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-20/ https://blog.rust-embedded.org/newsletter-20/ <p>This is the 20th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-20/34341">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1191816369798561793">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/ds55s6/the_20th_embedded_rust_working_group_newsletter/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-11-28-newsletter-21.md">the next newsletter</a>, send us a pull request!</p> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li><a href="https://github.com/ctron/">Jens Reimann</a> has assembled a <a href="https://github.com/ctron/rust-esp-container/">docker image</a> for developing Rust on the ESP8266 and ESP32 series of devices, including stable <code>alloc</code> support!</li> </ul> <ul> <li><a href="http://github.com/lucasbrendel/">Lucas Brendel</a> working on peripheral access crates as well as a shared embedded HAL for the Infineon XMC4 series of microcontrollers in the <a href="https://github.com/xmc-rs/">xmc-rs organization</a>. Peripheral access crates are available and the HAL is in the very early stages of development.</li> </ul> <ul> <li><a href="https://www.42technology.com">42 Technology</a> have published the source code for their Nordic <a href="https://github.com/42-technology-ltd">nRF9160 demonstration application</a>, along with a Rust crate which wraps up Nordic's proprietary C driver library. They also have a piece comparing Embedded Rust and Embedded C published in the German language magazine <a href="https://www.iot-design.de/allgemein/robuste-entwicklung-mit-rust/">IOT Design</a> this month.</li> </ul> <ul> <li><a href="https://github.com/thejpster">theJPster</a>'s <a href="https://github.com/thejpster/monotron">Monotron</a> got a write-up in <a href="https://hackaday.com/2019/10/05/the-monotron-a-rusty-retrocomputer/">Hackaday</a>. Moves are also afoot for a next-generation Monotron - codename <a href="https://github.com/Neotron-Compute/Neotron-Book/blob/master/src/SUMMARY.md">Neotron 1000</a> - complete with a book! Check it out if you're interested developing a modern-day version of CP/M, written in Rust.</li> </ul> <ul> <li><a href="https://github.com/probe-rs/probe-rs">probe-rs</a> finally has released on crates.io. The library enables you to inspect, debug and flash ARM cores. Flash the ARM core your future embedded Rust project with <a href="https://github.com/probe-rs/probe-rs/tree/master/cargo-flash">cargo-flash</a>, fully integrated into cargo. Flashing works for the <strong>nRF51822, nRF52832, nRF52840, STMF042 and STMF429xI</strong> using a <strong>DAPLink</strong> or an <strong>ST-Link</strong>. The upcomming 0.3.0 release will also enable your to flash any ARM core (provided an an ARM CMSIS-Pack exists in a known registry).</li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-11-28-newsletter-21.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <!-- TODO fill in the numbers before release --> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">31</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">28</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">28</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">70</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">28</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip-1">no-std crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">3</td><td style="text-align: left">+3</td></tr> </tbody></table> Thu, 03 Oct 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-19/ https://blog.rust-embedded.org/newsletter-19/ <p>This is the 19th newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-19/33253">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1179902902116241410">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/dcz96x/the_embedded_working_group_newsletter_19/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-10-31-newsletter-20.md">the next newsletter</a>, send us a pull request!</p> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li> <p>Google is working on a <a href="https://www.coreboot.org/">Coreboot</a> replacement called <a href="https://github.com/oreboot/oreboot">Oreboot</a>, i.e. Coreboot minus the 'C'. Slides for a talk <a href="https://osfc.io/uploads/talk/paper/23/Oreboot.pdf">about oreboot</a> are also available.</p> </li> <li> <p><a href="https://github.com/eldruin">@eldruin</a> released a platform-agnostic <a href="https://crates.io/crates/veml6075">driver for the VEML6075</a> UVA and UVB light sensor (so you can optimize your suntan) and published a <a href="https://blog.eldruin.com/veml6075-uva-uvb-uv-index-light-sensor-driver-in-rust/">blog post</a> with some pictures of the device in action.</p> </li> <li> <p><a href="https://github.com/therealprof">@therealprof</a> wrote a <a href="https://therealprof.github.io/blog/digital-v1-to-digital-v2/">blog post</a> about porting an <a href="https://github.com/rust-embedded/embedded-hal/">Embedded HAL</a> impl of the digital::v1 traits for GPIOs to digital::v2.</p> </li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-10-31-newsletter-20.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">30</td><td style="text-align: left">+8</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">26</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">27</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">68</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">28</td><td style="text-align: left">+2</td></tr> </tbody></table> Tue, 02 Jul 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-18/ https://blog.rust-embedded.org/newsletter-18/ <p>This is the eighteenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <!-- TODO uncomment --> <!-- Discuss on [users.rust-lang.org], [on twitter], or [on reddit]! --> <!-- [users.rust-lang.org]: https://example.org/#TODO --> <!-- [on twitter]: https://example.org/#TODO --> <!-- [on reddit]: https://example.org/#TODO --> <span id="continue-reading"></span><!-- If you want to mention something in [the next newsletter], send us a pull request! --> <!-- [the next newsletter]: https://github.com/rust-embedded/blog/edit/master/content/${TODO}.md --> <h2 id="the-winner-of-the-chat-vote-matrix">The winner of the Chat Vote: Matrix</h2> <p>About a month ago, due to Mozilla's plans to discontinue Mozilla IRC, we released <a href="https://github.com/rust-embedded/wg/blob/master/rfcs/0351-chat-vote.md">RFC 0351: Chat Vote</a> and started a <a href="https://github.com/rust-embedded/wg/issues/357">public vote</a> on which chat platform to use for the Rust Embedded Working Group in the future.</p> <p>The winner of that vote was <strong>Matrix</strong>, with 160 votes, followed by IRC with 103 votes and Discord with 74 votes. As Matrix has won by more than 3 votes, it will become the new official chat platform for Rust Embedded! The name of our new channel is <a href="https://matrix.to/#/#rust-embedded:matrix.org"><code>#rust-embedded:matrix.org</code></a>, and you can join it right now using a client like <a href="https://about.riot.im/">Riot</a>.</p> <p>We will be trialling the new Matrix channel for the next two weeks, using it as our primary and official communication channel. After the trial period, we will evaluate any issues that came up during it, and decide how to proceed. More details about the organization of the channel can be found in the <a href="https://github.com/rust-embedded/wg/blob/matrix/ops/matrix.md">operational notes</a>.</p> <p>Since IRC ended in second place, and it's our current platform, we'll also be establishing a bridge between the Matrix channel and IRC during the trial. This way, users have the option to continue using IRC if they so desire.</p> <p>To avoid the administrative overhead of having to switch bridged channels later, we will soon bridge directly to the <code>#rust-embedded</code> channel on Freenode, <em>not</em> to the Mozilla IRC channel. The bridge will be activated once we've worked out the Freenode channel registration.</p> <p>While Matrix is a federated protocol, we are not planning on running our own infrastructure for now - instead, we will be using the <code>matrix.org</code> IRC bridge, and users are free to register on <code>matrix.org</code> or any other homeserver of their choosing. If this turns out to be a problem during the trial period, we may reconsider this decision.</p> <p>We're also looking into a static log viewer, that would allow us to publish search-engine-indexable channel logs for public reading, similar to the public logs that we currently have. This may require us to self-host a static log generator such as <a href="https://github.com/matrix-org/matrix-static">matrix-static</a>. Suggestions for other solutions are welcome!</p> <h2 id="highlights">Highlights</h2> <ul> <li> <p>We've had a bunch of Embedded Rust related events over the past couple of months. EWG member @thejpster was at ACCU 2019 (the Association of C and C++ Users Annual Conference), in Bristol, UK, on 12 April, delivering a talk on Embeddded Rust and the Monotron. Jonathan was then speaking at the Centre for Computing History in Cambridge, UK on 18 April, followed by hosting Oxidize at the end of April! Next up, Monotron is visiting Rust Conf in Portland, USA in late August. Don't forget, if you've been giving or attending Embedded Rust talks, drop us a line for the next newsletter!</p> </li> <li> <p><a href="https://rust-embedded.github.io/showcase/">The embedded showcase</a> gained 3 new entries! We are still looking for cool embedded projects to serve that can serve as examples of what can be done in Rust. Don't hesitate to <a href="https://github.com/rust-embedded/showcase#submit-your-project">submit yours</a>!</p> </li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li> <p><a href="https://github.com/laanwj">@laanwj</a>, <a href="https://github.com/Disasm">@Disasm</a> and <a href="https://github.com/burrbull">@burrbull</a> are working on <a href="https://github.com/riscv-rust/k210-crates">Rust support for the Kendryte K210 RISC-V chips</a>.</p> </li> <li> <p><a href="https://github.com/Disasm">@Disasm</a> and <a href="https://github.com/almindor">@almindor</a> updated <a href="https://github.com/riscv-rust/riscv-rust-quickstart">riscv-rust-quickstart</a>: now you can run Rust on the HiFive1 Rev B board.</p> </li> <li> <p><a href="https://github.com/Disasm">@Disasm</a> released <a href="https://crates.io/crates/stm32-usbd">stm32-usbd</a>: a fork of <a href="https://github.com/mvirkkunen/stm32f103xx-usb">stm32f103xx-usb</a> adopted for multiple STM32 device families.</p> </li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <!-- TODO fill in the numbers before release --> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">22</td><td style="text-align: left">+4</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">25</td><td style="text-align: left">+6</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">18</td><td style="text-align: left">+5</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">25</td><td style="text-align: left">+4</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">67</td><td style="text-align: left">+4</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">26</td><td style="text-align: left">+1</td></tr> </tbody></table> Tue, 07 May 2019 00:00:00 +0000 https://blog.rust-embedded.org/embedded-rust-in-2019/ https://blog.rust-embedded.org/embedded-rust-in-2019/ <p>It's been a busy year for many of the members of the Embedded-WG this year, and we had a chance to catch up at OxidizeConf a few weeks ago. We discussed two main things, Moving off of Mozilla IRC, and our goals for (part of) 2019.</p> <span id="continue-reading"></span><h2 id="goals-for-2019">Goals for 2019</h2> <p>In 2018, the Embedded WG pushed hard to get the Cortex-M targets supported as stable targets in the upstream Rust project. Since then, due to work and life responsibilities, a number of us have been particularly busy in 2019.</p> <p>At Oxidize, we discussed what our 2019 goals should be. There were suggestions to get some the foundational level crates like <code>cortex-m</code>, <code>cortex-m-rt</code>, and tools like <code>svd2rust</code> to a "1.0 state". However, while there were a number of improvements we could think of, we couldn't draw any clear lines of what it would take for us to be comfortable cutting a 1.0 release of these projects.</p> <p>Based on the two points above, we discussed a slightly different plan: <strong>Focusing on building out the ecosystem in 2019</strong>, by building more "fun" stuff, like example projects, cool applications, and extracting and publishing reusable components from these projects to fill in the embedded Rust ecosystem.</p> <p>By focusing on building out, instead of trying to perfect what we already have, we hope to find out the things we don't know we are missing, and inspire other members of the community to begin working and building with Embedded Rust. We'll keep this as a focus through the summer (until September or October 2019). This can be thought of as a parallel to the upstream <a href="https://blog.rust-lang.org/2017/05/05/libz-blitz.html">"Libs Blitz"</a> that the Rust project successfully completed in 2017.</p> <p>Our weekly meetings will likely relax a bit, and will generally change focus to quickly discuss any high priority issues, then open up to a more informal "show and tell", where people can discuss the things they have been building and would like to share. We hope you'll all join us to share the wonderful things you build this summer in embedded Rust!</p> <h2 id="moving-off-mozilla-irc">Moving off Mozilla IRC</h2> <p>At the end of April, Mozilla announced that they would be shutting down <code>irc.mozilla.org</code>. The Rust project as a whole will generally be moving on to other platforms such as Discord and Zulip.</p> <p>The Embedded Working Group is actually one of the few (if not only) working groups that still primarily rely on IRC. We have a few hundred people who idle in the room, and tend to have fairly active discussions there, including our weekly status meetings. We have discussed moving to other platforms previously, but have been unable to get any sort of consensus on what to move to instead. Those discussions lead to a fruitful evaluation of alternatives and led to a pre-selection of suitable services.</p> <p>To move things forward <a href="https://github.com/rust-embedded/wg/blob/master/rfcs/0351-chat-vote.md">RFC 0351 Chat Vote</a> has been proposed and accepted by the WG which was subsequently implemented by opening <a href="https://github.com/rust-embedded/wg/issues/357">voting issue</a> to poll the public opinion on this matter. Anyone with a GitHub account is invited to cast vote(s) until <strong>23:59 CEST on Sunday, 2019-06-23</strong>, the detailed rules are explained in the issue and fair discussion is very welcome.</p> Fri, 22 Mar 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-17/ https://blog.rust-embedded.org/newsletter-17/ <p>This is the seventeenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-17/26551">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1109141455510097922">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/b47pl7/embedded_wg_newsletter_17_the_embedded_rust/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-04-05.md">the next newsletter</a>, send us a pull request!</p> <h2 id="highlights">Highlights</h2> <ul> <li>The <a href="https://rust-embedded.github.io/showcase/">embedded showcase</a> gained its first entry! The <a href="https://github.com/TeXitoi/rusty-clock">rusty clock</a> project, an alarm clock that features pressure, temperature and humidity on an e-paper display and 5 programmable alarms. We are still looking for cool embedded projects to serve that can serve as examples of what can be done in Rust. Don't hesitate to <a href="https://github.com/rust-embedded/showcase#submit-your-project">submit</a> yours!</li> <li><a href="https://oxidizeconf.com">OxidizeConf</a>, the first embedded Rust conference, has announced speakers! Check out <a href="https://oxidizeconf.com/schedule/">the lineup here</a>!</li> <li><a href="https://twitter.com/antvangelder">Antoine van Gelder</a> wrote about using Peripheral Access Crates to <a href="https://flowdsp.io/blog/stm32f3-01-interrupts/">program interrupts</a> on the STM32F3 Discovery board</li> <li><a href="https://github.com/jamesmunns">James Munns</a> gave a talk at Rust Berlin about what happens <a href="https://www.youtube.com/watch?v=RIHVoNDxNuk">before <code>main()</code></a> in embedded Rust projects</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li> <p><a href="https://github.com/jjkt">@jjkt</a> is working on <a href="https://github.com/jjkt/zmu"><code>zmu</code></a>, an emulator for microcontroller based systems. Zmu is work in progress but can already emulate substantial parts of Cortex M - based MCUs core architecture features.</p> </li> <li> <p><a href="https://github.com/japaric">@japaric</a> <a href="https://twitter.com/japaricious/status/1105368938018267136">released</a> <a href="https://github.com/japaric/cargo-call-stack/blob/master/CHANGELOG.md#v012---2019-03-12">v0.1.2</a> of <a href="https://crates.io/crates/cargo-call-stack/0.1.2"><code>cargo-call-stack</code></a>, a static stack usage analyzer, and published a <a href="https://blog.japaric.io/stack-analysis/">blog post</a> with details about its implementation.</p> </li> <li> <p><a href="https://twitter.com/wezm">Wesley Moore</a> wrote <a href="https://www.wezm.net/technical/2019/03/sensortag-embedded-rust-coding-retreat/">a blog post</a> about getting Rust running on the TI SensorTag, see the <a href="https://git.sr.ht/~wezm/sensortag">project on sourcehut</a>!</p> </li> <li> <p><a href="https://github.com/tarcieri">@tarcieri</a> <a href="https://twitter.com/bascule/status/1105455019959058433">released</a> a board support crate for the <a href="https://github.com/rust-embedded/wg/issues/286">Adafruit NeoTrellis M4</a> along with a platform-independent driver for its <a href="https://github.com/atsamd-rs/atsamd/pull/47">adxl343</a> accelerometer and support for using the accelerometer to detect the <a href="https://github.com/atsamd-rs/atsamd/pull/48">device's orientation</a>.</p> </li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-04-05.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <!-- TODO fill in the numbers before release --> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">18</td><td style="text-align: left">~</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">~</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">~</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">21</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">63</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">25</td><td style="text-align: left">+1</td></tr> </tbody></table> Wed, 06 Mar 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-16/ https://blog.rust-embedded.org/newsletter-16/ <p>This is the sixteenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-16/25987">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1103416332786302977">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/ay4js3/embedded_wg_newsletter_16_not_yet_awesome/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-03-20-newsletter-17.md">the next newsletter</a>, send us a pull request!</p> <h2 id="highlights">Highlights</h2> <ul> <li>Know of something that isn't awesome in embedded Rust yet? Let us know by adding it to the <a href="https://github.com/rust-embedded/not-yet-awesome-embedded-rust">Not <em>Yet</em> Awesome Embedded Rust List</a>!</li> </ul> <ul> <li>The Embedded WG continues to receive <a href="https://github.com/rust-embedded/showcase#submit-your-project">submissions</a> for <a href="https://github.com/rust-embedded/showcase">the embedded showcase</a>. We are looking for cool embedded Rust projects (applications, not libraries or tools) with visuals (pictures or videos) that can serve as examples of what can be done in Rust.</li> </ul> <ul> <li> <p><a href="https://www.42technology.com">42 Technology</a> <a href="https://twitter.com/42Technology/status/1099009843967471617">announced</a> that they have got Rust running on the new Cortex-M33 powered <a href="https://www.nordicsemi.com/Products/Low-power-cellular-IoT/nRF9160">Nordic nRF9160 LTE SiP</a>.</p> </li> <li> <p><a href="https://twitter.com/bitshiftmask">James Munns</a> has posted the <a href="https://www.youtube.com/watch?v=S0VI70nY6Vo">first video</a> of a <a href="https://www.youtube.com/playlist?list=PLX44HkctSkTewrL9frlUz0yeKLKecebT1">series of streams</a> developing a home wireless sensor node network. The stream focuses on teaching embedded, Rust, and IoT topics.</p> </li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <ul> <li> <p><a href="https://github.com/hannobraun">@hannobraun</a> published <a href="https://crates.io/crates/dwm1001"><code>dwm1001</code></a>, a board support crate for the Decawave DWM1001 module, which features a Nordic nRF52832 microcontroller and a Decawave DW1000 radio transceiver.</p> </li> <li> <p>The RTFM (Real Time For the Masses) team has released <a href="https://crates.io/crates/cortex-m-rtfm"><code>cortex-m-rtfm</code></a> <a href="https://github.com/japaric/cortex-m-rtfm/blob/master/CHANGELOG.md#v042---2019-02-27">v0.4.2</a>; the most important new feature in this release are reproducible builds. They are also looking for user input on several open <a href="https://github.com/japaric/cortex-m-rtfm/issues?q=is%3Aissue+is%3Aopen+label%3ARFC">RFCs</a>.</p> </li> </ul> <ul> <li><a href="https://github.com/japaric/">@japaric</a> has <a href="https://mobile.twitter.com/japaricious/status/1102275637606338562">released</a> <a href="https://crates.io/crates/cargo-call-stack"><code>cargo-call-stack</code></a> <a href="https://github.com/japaric/cargo-call-stack/blob/master/CHANGELOG.md#v011---2019-03-03">v0.1.1</a>. <code>cargo-call-stack</code> is a static, whole program stack analysis tool; this version ships many new improvements: filtering, cleaner graphs, support for programs that use recursion, dynamic dispatch or function pointer calls, plus numerous bug fixes.</li> </ul> <ul> <li><a href="https://github.com/jamwaffles">@jamwaffles</a> has published version v0.4.7 of the <a href="https://crates.io/crates/embedded-graphics/0.4.7"><code>embedded-graphics</code></a> crate. This version ships with BMP support! For more details read <a href="https://wapl.es/rust/2019/03/04/embedded-graphics-0.4.7-bmp-support.html">the announcement blog post</a>.</li> </ul> <ul> <li><a href="https://github.com/tarcieri">@tarcieri</a> extracted the <a href="https://crates.io/crates/micromath"><code>micromath</code></a> crate out of the <a href="https://crates.io/crates/accelerometer"><code>accelerometer</code></a> crate. It provides a fast, embedded-friendly arithmetic library (utilizing approximations which trade precision for improved performance and reduced code size), 2D/3D vector types, and statistical analysis functions.</li> </ul> <ul> <li><a href="https://github.com/shella">@shella</a> created <a href="https://github.com/atsamd-rs/atsamd/pull/55"><code>pyportal</code></a>, a board support crate for the <a href="https://www.adafruit.com/product/4116">Adafruit PyPortal</a>, which features an ILI9341 LCD touchscreen and ESP32 Wifi controller.</li> </ul> <p>If you have an embedded project or blog post you would like to have featured in the next Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-03-20-newsletter-17.md">the next newsletter</a>, we would love to show it off!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#peripheral-access-crates">Peripheral Access Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">18</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">~</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">20</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">61</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">24</td><td style="text-align: left">+1</td></tr> </tbody></table> Wed, 20 Feb 2019 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-15/ https://blog.rust-embedded.org/newsletter-15/ <p>This is the fifteenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-15/25481">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1098218372469268480">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/asohul/embedded_wg_newsletter_15_ewg_all_hands_the/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-03-06-newsletter-16.md">the next newsletter</a>, send us a pull request!</p> <h2 id="embedded-at-rust-all-hands-2019">Embedded at Rust All Hands 2019</h2> <p>Some members of the Embedded Working Group attended the Rust All Hands two weeks ago. There they had the chance to discuss the needs of the embedded community (as identified in <a href="https://github.com/rust-embedded/wg/issues/256">this survey</a>) with the different Rust teams and other WGs. Here's a summary of what was discussed:</p> <ul> <li>"const generics"</li> </ul> <p>The ability to parameterize over values, for example you could use this feature to write a fixed capacity <code>Vec</code>: <code>struct Vec&lt;T, const N: usize&gt; { buffer: [T; N], len: usize }</code>. There are a few compiler refactors going on that are required to land this in nightly so the status is "WIP". We'll have future meetings with the compiler team to try to identify and prioritize the parts of the feature that embedded developers need.</p> <ul> <li><code>const fn</code> with trait bounds on stable.</li> </ul> <p>For example, <code>impl&lt;T&gt; Struct&lt;T&gt; where T: Trait { pub const fn new() -&gt; Self { .. } }</code>. A lengthy <a href="https://github.com/rust-rfcs/const-eval/pull/8">pre-RFC discussion</a> has concluded and a <a href="https://github.com/rust-lang/rfcs/pull/2632">proper RFC has been proposed</a>.</p> <ul> <li><code>core::mem::MaybeUninit</code> on stable.</li> </ul> <p>The plan is to stabilize a <a href="https://github.com/rust-lang/rust/issues/53491#issuecomment-463753719">minimal, uncontroversial subset of the API</a> to make this available on stable ASAP.</p> <ul> <li><code>std::io</code> in <code>core</code> / <code>alloc</code>.</li> </ul> <p>It's not possible to move <code>std::io::{Read,Write}</code> into <code>alloc</code> or <code>core</code> because the API depends on OS specific bits (e.g. <code>last_os_error</code>). An option may be to add a new set of <code>Read</code> / <code>Write</code> traits to <code>core</code>, maybe with associated error types, and then try to bridge these to <code>std::io::{Read,Write}</code> using blanket implementations / super traits, but this needs more research.</p> <ul> <li>fix <a href="https://github.com/rust-lang/cargo/issues/5730">rust-lang/cargo#5730</a></li> </ul> <p>This bug breaks <code>no_std</code> builds that use build scripts unless the authors of the build dependencies are aware of the issue and actively work around it. The Cargo team is well aware of the problem. Unfortunately, it's hard to fix and the fix will likely be opt-in because it changes the current semantics.</p> <ul> <li>Stabilize RFC 2282 - <a href="https://github.com/rust-lang/rust/issues/48683">"Cargo profile dependencies"</a></li> </ul> <p>This feature lets you optimize dependencies when using the <code>dev</code> profile; useful to keep <code>dev</code> binaries small enough to fit in Flash without sacrificing all debuggability. A new <a href="https://github.com/rust-lang/cargo/pull/6577"><code>build</code> profile</a> will be added to cover the configuration of proc macros, build scripts, compiler plugins and their dependencies. The new profile solves the remaining unresolved question around RFC 2282.</p> <ul> <li>Stabilize <code>core::arch::arm</code></li> </ul> <p>This module contains functions for instructions like <code>wfi</code> and <code>nop</code>, and SIMD instructions; stabilizing this removes the pressure for stable inline assembly (<code>asm!</code>). A member of the libs team is interested in this and will help us push it towards the finish line. <a href="https://github.com/rust-lang-nursery/stdsimd/pull/557">A PR in this space</a> has recently landed.</p> <ul> <li>Asserts in <code>const fn</code> context become compiler errors.</li> </ul> <p>We understood that there are still several design / implementation issues that need to be discussed before this is stabilized, but in the meantime you can use the perma-unstable <code>-Z unleash-the-miri-inside-of-you</code> flag to do all sort of stuff in const context.</p> <ul> <li>std-aware Cargo.</li> </ul> <p><a href="https://github.com/jamesmunns">@jamesmunns</a> has written a <a href="https://github.com/jamesmunns/rfcs/pull/1">pre-rfc</a> for an incremental implementation of this feature based on our discussions with people from the libs and Cargo teams and the WASM WG.</p> <ul> <li>Improve searching for <code>no_std</code> crates on crates.io.</li> </ul> <p>The backend supports searching within a category (like the <code>no_std</code> category) but there's no UI for it right now. This and fixing a bug where searches only return items found until a exact match was found (instead of returning all relevant matches) are in the crates.io team TODO list.</p> <ul> <li>Fix: infinite loops (e.g. <code>loop {}</code>) are lowered to an abort instruction.</li> </ul> <p>Ideally, this should be fixed in LLVM proper but it's hard to fix. It's possible to fix this in rustc but the fix is likely to regress the performance of <code>loop</code>s. The compiler team will follow up with two unstable flags to evaluate the (performance) impact of fixing this. The first flag applies the fix to only <code>loop</code>s in return position of divergent function and the second flag applies the fix to all <code>loop</code>s.</p> <ul> <li>Math support in core</li> </ul> <p>That is <code>0f32.sin()</code> should "Just Work" in <code>no_std</code> crates. There are a few questions about how to best implement this without degrading performance of applications that link to <code>std</code> (we want those to use the arch optimized routines in e.g. glibc's libm instead of the generic Rust implementation) and we need a champion to do the research.</p> <ul> <li>Cargo build hooks</li> </ul> <p>This refers to the ability to run custom code after <code>cargo build</code>. We covered use cases, their requirements and discussed the trade-offs of a more general Cargo tasks (e.g. <code>cargo $task</code>) mechanism vs a more targeted post-build script (e.g. <code>post-build.rs</code>) mechanism. Expect more news (a (pre-)RFC) from the WASM WG on this front.</p> <ul> <li>Slimmer <code>core::fmt</code>.</li> </ul> <p>The current implementation of <code>core::fmt</code> uses trait objects and function pointers to make all uses of <code>core::fmt</code> fast to compile but this makes <code>core::fmt</code> impossible to inline which makes <code>no_std</code> programs that use formatting large in (binary) size. It might be possible to leverage std-aware Cargo to fix this: we could add a Cargo feature to <code>core</code> to replace the current implementation with one that's fully inlineable but as featureful as the current one -- this should produce smaller binaries.</p> <p>For a bit more of detail you can check the <a href="https://github.com/rust-embedded/wg/blob/master/minutes/2019-02-12.irc.log">logs</a> and <a href="https://github.com/rust-embedded/wg/blob/master/minutes/2019-02-12.md#notes-from-rust-all-hands">minutes</a> from two meetings ago; they include our notes from the All Hands</p> <h2 id="highlights">Highlights</h2> <ul> <li>The Embedded WG has started receiving <a href="https://github.com/rust-embedded/showcase#submit-your-project">submissions</a> for <a href="https://github.com/rust-embedded/showcase">the embedded showcase</a>! We are looking for cool embedded Rust projects with visuals (pictures or videos) that can serve as examples of what can be done in Rust.</li> </ul> <ul> <li>The <a href="https://github.com/stm32-rs">stm32-rs</a> organization has emerged to collate work on STM32 crates.</li> </ul> <ul> <li>Similarly, the <a href="https://github.com/lpc-rs">lpc-rs</a> organization has emerged to work on LPC microcontrollers by NXP.</li> </ul> <ul> <li>Also, the <a href="https://github.com/nrf-rs">nrf-rs</a> organization has emerged to focus on the nRF family of microcontrollers by Nordic Semiconductors.</li> </ul> <ul> <li><a href="https://github.com/adamgreig">@adamgreig</a> has released an experimental PAC (Peripheral Access Crate) alternative for STM32 microcontrollers: <a href="https://github.com/adamgreig/stm32ral">stm32ral</a> that compiles in about 3 seconds. (PACs are known for compile times in the order of hundreds of seconds.)</li> </ul> <ul> <li>As of <code>nightly-2019-02-05</code> the <a href="https://docs.rust-embedded.org/book/index.html">embedded Rust Book</a> is included as part of the docs shipped with the Rust toolchain! <a href="https://doc.rust-lang.org/nightly/#embedded-systems">This is the online version</a>.</li> </ul> <ul> <li>The Rust compiler now has <a href="https://github.com/rust-lang/rust/pull/58406">cross compilation support for 64-bit RISCV</a>. Install the bare metal targets with <code>rustup target</code> (see <code>rustup target list</code>).</li> </ul> <ul> <li>The Rust compiler also gained <a href="https://github.com/rust-lang/rust/pull/56769">compilation support for x86_64 UEFI</a> in the form of the <code>x86_64-unknown-uefi</code> target.</li> </ul> <ul> <li>Formatting numbers with <code>core::fmt</code> has <a href="https://github.com/rust-lang/rust/pull/58272">become slimmer</a>. Some users have reported binary size reductions of up to 26% (800B) in ARMv6-M binaries.</li> </ul> <ul> <li>The <a href="https://github.com/copterust/">copterust org</a> has <a href="https://github.com/rust-embedded/awesome-embedded-rust/pull/142">shared a bunch of driver crates</a> for interfacing sensors commonly found in flight controllers (drones).</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>If you have an embedded project or blog post you would like to have featured in the Embedded WG Newsletter, make sure to add it to <a href="https://github.com/rust-embedded/blog/edit/master/content/2019-03-06-newsletter-16.md">the next newsletter</a>, we would love to show it off!</p> <ul> <li>Version v0.4.1 of <a href="https://crates.io/crates/cortex-m-rtfm">Real Time For the Masses</a> (RTFM), a concurrency framework for building real time systems, has been released! This version <a href="https://github.com/japaric/cortex-m-rtfm/pull/140">fixes a soundness hole</a> and includes a <a href="https://japaric.github.io/cortex-m-rtfm/book/ru/index.html">Russian translation</a> of the RTFM book.</li> </ul> <ul> <li><a href="https://github.com/jamwaffles">@jamwaffles</a> has <a href="https://mobile.twitter.com/jam_waffles/status/1095784282189189121">published</a> a driver crate for the SH1106, an OLED display, and an <a href="https://wapl.es/electronics/rust/2019/02/13/sh1106-driver.html">introduction blog post</a> for their crate.</li> </ul> <ul> <li><a href="https://github.com/thejpster">@thejpster</a> has <a href="https://www.reddit.com/r/rust/comments/ascvls/introducing_embeddedsdmmc_a_purerust_no_std_sd/">released</a> <a href="https://crates.io/crates/embedded-sdmmc"><code>embedded-sdmmc</code></a>, a pure-Rust #[no_std] SD card and FAT16/FAT32 library</li> </ul> <ul> <li><a href="https://github.com/hannobraun">@hannobraun</a> has published two crates: <a href="https://crates.io/crates/ieee802154"><code>ieee802154</code></a>, a partial implementation of the IEEE 802.15.4 standard, and <a href="https://crates.io/crates/dw1000"><code>dw1000</code></a>, an embedded-hal driver for the Decawave DW1000 wireless transceiver chip.</li> </ul> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">16</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">15</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">19</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">59</td><td style="text-align: left">+13</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">23</td><td style="text-align: left">+6</td></tr> </tbody></table> Wed, 14 Nov 2018 00:00:00 +0000 https://blog.rust-embedded.org/this-year-in-embedded-rust/ https://blog.rust-embedded.org/this-year-in-embedded-rust/ <p>This year the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> set out to build the solid foundation that the embedded Rust ecosystem requires to thrive. As we approach the date of the 2018 edition release we reflect on our progress and share our achievements with you in this post.</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-wg-this-year-in-embedded-rust/22263">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1062664608538918913">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/9wz716/the_embedded_wg_this_year_in_embedded_rust/">on reddit</a>!</p> <span id="continue-reading"></span><h2 id="embedded-rust-on-stable">Embedded Rust on stable</h2> <p>Stability -- AKA "my crate should not break when moving to a newer toolchain" -- was the single most requested feature by the embedded community during the 2018 roadmap planning phase.</p> <p>Embedded development has been tied to the nightly channel since its very beginning, and the people that have been doing embedded development for a while have endured many breaking changes. Thankfully, those days are over: Rust 1.30 marks the first stable release where you can build fully working embedded programs without relying on unstable features.</p> <p>Furthermore, we now have some <a href="https://github.com/rust-lang/rust/pull/53996">unit</a> <a href="https://github.com/rust-lang/rust/pull/53190">tests</a> that check embedded code in the compiler test suite so unintentional breakage will be caught before it makes its way into the nightly channel.</p> <h2 id="a-smooth-starting-point">A smooth starting point</h2> <p>"How do I get started with embedded Rust?" has been a common question on IRC for a long time. It has not been an easy question to answer, though: maintaining documentation that relies on unstable features for a long period of time has been an uphill battle so newcomers have often run into outdated docs.</p> <p>But now that stable embedded Rust is here we have put together an authoritative resource for getting started with embedded Rust: <a href="https://docs.rust-embedded.org/book">The Embedded Rust Book</a>. We have put a lot of effort in making the first experience as frictionless as possible with the help of <a href="https://github.com/rust-embedded/cortex-m-quickstart">templates</a> and <a href="https://github.com/rust-embedded/cargo-binutils">tooling</a>.</p> <p>The embedded Rust book is not just a getting started guide; it's also meant to be the document that teaches you how to effectively use the language to write correct embedded software. We are currently amassing all our hard earned experience into patterns and tips that we are adding to this book.</p> <h2 id="resources-for-everyone">Resources for everyone</h2> <p>The Embedded Rust Book is aimed at people that have some experience with embedded development, but we recognize that Rust has great potential for becoming people's first choice for getting their feet wet with embedded development so we have updated and will continue to work on resources, like <a href="https://docs.rust-embedded.org/discovery">the Discovery book</a>, that are aimed at that demographic.</p> <p>We also recognize that the target audience for embedded Rust has different levels of expertise with embedded systems and a varied set of interests so we are also building advances resources like <a href="https://docs.rust-embedded.org/embedonomicon">the embedonomicon</a> and collecting more targeted resources, like crates, in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">awesome-embedded-rust</a> list. You can find these and other of our resources in our <a href="https://docs.rust-embedded.org">docs webpage</a>.</p> <h2 id="an-organized-community-effort">An organized community effort</h2> <p>All this has been accomplished with the hard work of many volunteers, both <a href="https://github.com/rust-embedded/wg#organization">WG members</a> and other community members. The WG members, in particular, are committed to maintaining the <a href="https://github.com/rust-embedded/wg#projects-1">core crates</a> and <a href="https://github.com/rust-embedded/wg#projects-8">documentation</a> that the ecosystem relies on. All these resources have been taken under the umbrella of the <a href="https://github.com/rust-embedded">rust-embedded</a> organization.</p> <h2 id="wg-teams">WG teams</h2> <p>The embedded space is huge: there are several architectures used in this space, many application areas, and embedded developers work with different sets of constraints: real-time constraints, memory constraints, energy / power constraints, etc.</p> <p>For this reason we have been creating and growing specialized teams within the WG by adding members with different areas of expertise. This ensures that we have different perspectives when making API design decisions in core crates and when communicating the needs of the embedded community to the other Rust teams. Having specialized teams also means that the crates developed by the org can be assigned to the people with the right technical background.</p> <h2 id="on-the-upcoming-2018-edition">On the upcoming 2018 edition</h2> <p>In this last sprint towards the 2018 edition we are focusing our efforts in our <a href="https://docs.rust-embedded.org">documentation</a>!</p> <p>You can help us by proofreading our docs, reporting errors, giving feedback on the existing content, requesting new topics and writing about topics that have not yet been covered. Every little bit of help is greatly appreciated!</p> <p>One important note: our documentation makes use of the 2018 edition which requires you to use the beta channel until 1.31 is released in early December. We suggest that you use the beta channel until then to get the best experience.</p> <h2 id="beyond-2018">Beyond 2018</h2> <p>Our work doesn't stop the day Rust 1.31 comes out; the 2018 edition is just the starting line of embedded Rust. As we continue to learn how to effectively use Rust for embedded development we'll continue to refine and expand our documentation as well as the core crates we maintain and develop.</p> <p>Also, at this point in time ARM Cortex-M is our most mature target architecture and the majority of crates on crates.io target this architecture, but we have laid the groundwork for supporting other targets like bare metal ARM Cortex-A, ARM Cortex-R, MSP430 and RISCV. We'll continue to work on getting these targets on parity with the ARM Cortex-M target during the next year.</p> <p>Finally, we'd love to hear what <strong>you</strong> would like to see happen in the embedded space in 2019. We are collecting a <a href="https://github.com/rust-embedded/wg/issues/256">"wishlist"</a> of things the embedded community would like to see get done, fixed and / or stabilized in 2019. Need some API in core to be stabilized? Would like to get some Cargo bug / papercut fixed? Let us know and we'll look into making it happen! We'll use this data to set out an embedded Rust roadmap for 2019.</p> <p>Here's to a 2019 with <em>more</em> embedded Rust success stories (yes, "more"; wait for the upcoming revamped rust-lang website ;-)). Happy embedded hacking!</p> Sun, 28 Oct 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-14/ https://blog.rust-embedded.org/newsletter-14/ <p>This is the fourteenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>This is a special "spotlight" edition of the newsletter, where we look at a few topics in a bit more detail. Let us know what you think of the new format, and if there is anything you'd like to see included in <a href="https://github.com/rust-embedded/blog/issues/22">the next newsletter</a>!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-14/21795">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1057222850787053568">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/9smq6f/embedded_wg_newsletter_14_spotlight_edition/">on reddit</a>!</p> <span id="continue-reading"></span><h2 id="embedded-rust-applications-on-stable">Embedded Rust Applications on Stable!</h2> <hr> <blockquote class="twitter-tweet" data-lang="en"><p lang="en" dir="ltr">Rust 1.30 is here! Proc macros, no_std binaries, and a progress bar for cargo! 🎊🎉🦀 <a href="https://t.co/IXm5xFYlhU">https://t.co/IXm5xFYlhU</a></p>&mdash; Rust Language (@rustlang) <a href="https://twitter.com/rustlang/status/1055499747056852993?ref_src=twsrc%5Etfw">October 25, 2018</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script> <p>Now that <code>#[panic_handler]</code> is stabilized in <a href="https://blog.rust-lang.org/2018/10/25/Rust-1.30.0.html">1.30</a>, you can write Cortex-M bare-metal applications with the stable compiler. All our Rust Embedded crates, such as <code>cortex-m</code>, <code>cortex-m-rt</code> and <code>embedded-hal</code> should be ready to use on stable, but please note our two tutorial books <a href="https://rust-embedded.github.io/discovery/">Discovery</a> and <a href="https://rust-embedded.github.io/book/">The Embedded Rust Book</a> still require 1.30 beta or 1.31 beta as they use 2018 edition syntax (which isn't stabilized until the 1.31 release).</p> <p>If you are able to trial 1.31 beta, you can help us test:</p> <ul> <li>Minimal <code>const</code> functions (useful for initializing static variables)</li> <li>2018 edition syntax (including changes to <code>use</code> and <code>extern crate</code>)</li> </ul> <h2 id="the-newest-embedded-wg-team-cortex-a">The Newest Embedded WG Team: Cortex-A!</h2> <hr> <p><img src="../screenshot-cortex-a.png" alt="Screenshot of Cortex-A RFC" /></p> <p>The Embedded Working Group has launched a Cortex-A team, to focus on supporting developers working on bare-metal, micro kernel, and other low-level tasks using ARM's Cortex-A series of microprocessors.</p> <p>The team kicked off with four members: <a href="https://github.com/andre-richter">@andre-richter</a>, <a href="https://github.com/parched">@parched</a>, <a href="https://github.com/raw-bin">@raw-bin</a>, and <a href="https://github.com/wizofe">@wizofe</a>, and have already started assembling initial <a href="https://github.com/rust-embedded/wg/milestone/5">goals for their team</a>.</p> <h2 id="the-monotron-visits-rust-belt-rust">The Monotron Visits Rust Belt Rust</h2> <hr> <blockquote class="twitter-tweet" data-conversation="none" data-lang="en"><p lang="en" dir="ltr">Astonishing. Smashed my high score! <a href="https://t.co/WG9FXc8Kao">pic.twitter.com/WG9FXc8Kao</a></p>&mdash; Jonathan Pallant (@therealjpster) <a href="https://twitter.com/therealjpster/status/1053698944360951813?ref_src=twsrc%5Etfw">October 20, 2018</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script> <p><a href="https://github.com/thejpster">@thejpster</a>'s project, the <a href="https://github.com/thejpster/monotron">monotron</a>, travelled to Ann Arbor Michigan for <a href="https://rust-belt-rust.com/">Rust Belt Rust 2018</a>. Since its <a href="https://www.youtube.com/watch?v=pTEYqpcQ6lg">last conference appearance</a>, it has gained a whole new <a href="https://twitter.com/therealjpster/status/1055187256091332608">list of features</a>, including a serial application loader, a 3 channel wave table synthesizer, Atari Joystick support, and more!</p> <p>Check out the video above for a demo of Snake on the monotron hardware.</p> <h2 id="peripheral-ownership-woes-not-with-shared-bus">Peripheral Ownership Woes? Not With <code>shared-bus</code>!</h2> <hr> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span style="color:#b48ead;">extern crate</span><span> shared_bus; </span><span> </span><span style="color:#65737e;">// Create your bus peripheral as usual: </span><span style="color:#65737e;">// let i2c = I2c::i2c1(dp.I2C1, (scl, sda), 90.khz(), clocks, &amp;mut rcc.apb1); </span><span> </span><span style="color:#b48ead;">let</span><span> manager = shared_bus::CortexMBusManager::new(i2c); </span><span> </span><span style="color:#65737e;">// You can now acquire bus handles: </span><span style="color:#b48ead;">let mut</span><span> handle = manager.</span><span style="color:#96b5b4;">acquire</span><span>(); </span><span style="color:#65737e;">// handle implements `i2c::{Read, Write, WriteRead}`, depending on the </span><span style="color:#65737e;">// implementations of the underlying peripheral </span><span> </span><span style="color:#65737e;">// Now, this works! :+1: </span><span style="color:#b48ead;">let</span><span> port_a = Pcf8574(manager.</span><span style="color:#96b5b4;">acquire</span><span>(), </span><span style="color:#d08770;">0x39</span><span>).</span><span style="color:#96b5b4;">unwrap</span><span>(); </span><span style="color:#b48ead;">let</span><span> port_b = Pcf8574(manager.</span><span style="color:#96b5b4;">acquire</span><span>(), </span><span style="color:#d08770;">0x38</span><span>).</span><span style="color:#96b5b4;">unwrap</span><span>(); </span></code></pre> <p>In most <code>embedded-hal</code> compatible drivers, the driver takes either ownership or a mutable reference to the peripheral used to interact with a component, such as I2C or SPI. For some protocols, such as I2C, which might have multiple devices connected to the same peripheral, managing ownership can be difficult (see <a href="https://github.com/rust-embedded/embedded-hal/issues/35">embedded-hal/35</a> for discussion).</p> <p>To address this, <a href="https://github.com/Rahix">@Rahix</a> developed <a href="https://github.com/Rahix/shared-bus">shared-bus</a>, a crate which provides safe shared access to these peripherals through the use of a mutex. This allows for access of the underlying peripheral in as many drivers as you need! Check out the <a href="https://blog.rahix.de/001-shared-bus/">release blog post</a> for more details, and for examples on how to use this for your projects.</p> <h2 id="the-embedded-rust-community-is-growing">The Embedded Rust Community is Growing!</h2> <hr> <blockquote class="twitter-tweet" data-lang="en"><p lang="en" dir="ltr">Happy Tuesday! Quick poll: What are you using <a href="https://twitter.com/hashtag/embedded?src=hash&amp;ref_src=twsrc%5Etfw">#embedded</a> <a href="https://twitter.com/rustlang?ref_src=twsrc%5Etfw">@rustlang</a> for right now?<br><br>RTs appreciated!</p>&mdash; Rust Embedded Working Group (@rustembedded) <a href="https://twitter.com/rustembedded/status/1052189142065405952?ref_src=twsrc%5Etfw">October 16, 2018</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script> <p>As we get closer to our goal of stable embedded development with Rust for the 2018 edition launch, the embedded community is ramping up. We did a quick twitter poll which received hundreds of responses, and heard from developers using or evaluating embedded rust for personal and work projects.</p> <p>The <a href="https://github.com/rust-embedded/wg">Embedded WG</a> has also grown, starting off this year with 8 developers on a single team, to a group of <strong>27 developers</strong> across <strong>11 teams</strong>, each with their own area of focus within the embedded rust space.</p> <p>Now is a great time to start working with Embedded Rust, and we can't wait to see what the next year brings!</p> <h2 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h2> <hr> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">16</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">16</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">46</td><td style="text-align: left">+6</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">17</td><td style="text-align: left">+3</td></tr> </tbody></table> Tue, 09 Oct 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-13/ https://blog.rust-embedded.org/newsletter-13/ <p>This is the thirteenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-13/21137">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1049739952601395201">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/9ms5jk/embedded_wg_newsletter_13_industrial_io_bluetooth/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/issues/17">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>The <code>min_const_fn</code> feature <a href="https://github.com/rust-lang/rust/pull/54835">has landed</a>, allowing for stable use of <code>const fn</code> functions in an embedded context in the upcoming 1.31 release of Rust!</li> <li><a href="https://github.com/fpagliughi">Frank Pagliughi</a> has kicked off <a href="https://github.com/fpagliughi/rust-industrial-io"><code>rust-industrial-io</code></a>, a crate providing an interface to <code>libiio</code> on linux, which is used for communication with industrial sensors and actuators</li> <li><a href="https://github.com/gregokent">gregokent</a> has started development on <a href="https://github.com/gregokent/cortex-r-rt"><code>cortex-r-rt</code></a>, a runtime crate for Cortex-R processors</li> <li>The HAL Impl crate for the Texas Instruments TM4C123 now <a href="https://twitter.com/therealjpster/status/1047872901628792832">works on 1.30-beta</a>! <strong>Now is a great time to ensure that your embedded crates will work flawlessly with the 2018 Edition of Rust!</strong></li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-embedded/blog/issues/17">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/e-matteson">e-matteson</a> has released their <a href="https://github.com/e-matteson/keypad"><code>keypad</code> driver</a>, which can be used with keypad matrix circuits. Check out more <a href="https://www.reddit.com/r/rust/comments/9j42o9/weekly_driver_keypad_matrix_circuits/">details on reddit</a></li> <li><a href="https://github.com/danielgallagher0">Daniel Gallagher</a> has recently released two handy Bluetooth crates in an <a href="https://219design.com/bluetooth-low-energy-with-rust/">intro blog</a> post: <ul> <li><a href="https://crates.io/crates/bluenrg"><code>bluenrg</code></a>, an embedded-hal crate used to interface with STMicro's series of microcontrollers</li> <li><a href="https://crates.io/crates/bluetooth-hci">Bluetooth HCI</a>, a helper crate for interfacing with the Bluetooth Host-Controller interface</li> </ul> </li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">16</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">15</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">40</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">14</td><td style="text-align: left">+1</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>Interested in implementing a new target for Embedded Rust? Nuvoton has a <a href="https://direct.nuvoton.com/de/numaker-pfm-m2351">development board</a> for the Cortex-M23. Check out the <a href="https://github.com/rust-embedded/wg/issues/88">thumbv8m tracking issue</a> if you want to help!</li> </ul> Tue, 25 Sep 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-12/ https://blog.rust-embedded.org/newsletter-12/ <p>This is the twelfth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://users.rust-lang.org/t/the-embedded-working-group-newsletter-12/20749">users.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1044930201925439490">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/9j2620/the_embedded_working_group_newsletter_12/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/issues/15">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>We now have a category for Embedded on the <a href="https://users.rust-lang.org/c/embedded">users.rust-lang.org forum</a>! This is a great place to ask larger questions, or to share more details about your projects!</li> <li>You can now build embedded <a href="https://twitter.com/japaricious/status/1042440110418153473">binaries on stable</a> with the <code>1.30-beta</code> release of Rust! Check it out and <a href="https://github.com/rust-embedded/wg/issues">open an issue</a> if you run in to any issues with your projects!</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-embedded/blog/issues/15">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/eldruin">Diego Barrios Romero</a> has released his <a href="https://blog.eldruin.com/24x-serial-eeprom-driver-in-rust/">eeprom24x</a> crate, an <code>embedded-hal</code> compatible driver for EEPROM memory chips such as the Microchip/Atmel <code>AT24C32</code>, <code>24AA32A</code>, <code>AT24C256</code>, or STMicroelectronics' <code>M24C32</code></li> <li><a href="https://github.com/trangar/">Trangar</a> managed to drive <a href="https://twitter.com/victorkoenders/status/1042786930335903745">56 ArtNet Torches</a> using Rust, based on his <a href="https://github.com/Trangar/artnet_protocol">ArtNet Protocol</a> crate</li> <li>The <code>no_std</code> synthesizer from the last newsletter has been implemented on-hardware by <a href="https://github.com/thejpster">Jonathan Pallant</a>, giving the <a href="https://github.com/thejpster/monotron">Monotron</a> a <a href="https://twitter.com/therealjpster/status/1043942194015555584">PWM audio driver</a>!</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">16</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">40</td><td style="text-align: left">-1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">0</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>Interested in implementing a new target for Embedded Rust? Nuvoton has a <a href="https://direct.nuvoton.com/de/numaker-pfm-m2351">development board</a> for the Cortex-M23. Check out the <a href="https://github.com/rust-embedded/wg/issues/88">thumbv8m tracking issue</a> if you want to help!</li> </ul> Sun, 09 Sep 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-11/ https://blog.rust-embedded.org/newsletter-11/ <p>This is the eleventh newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://internals.rust-lang.org/t/the-embedded-working-group-newsletter-11/8377">internals.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1039055481946492928">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/9eku70/rust_embedded_working_group_newsletter_11_cortexr/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/issues/12">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li><code>rustc</code> now supports 4 <strong>Cortex-R</strong> targets thanks to the work of <a href="https://github.com/paoloteti">paoloteti</a> in the Cortex-R space! You can build programs for these targets using nothing but the Rust toolchain</li> <li><a href="https://github.com/jamesmunns">James Munns</a> gave a talk <a href="https://www.youtube.com/watch?v=t99L3JHhLc0">at RustConf 2018</a>, covering the basics of embedded systems, and how Rust's Zero Cost Abstractions are a perfect match for bare metal systems</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-embedded/blog/issues/12">the next newsletter</a>, we would love to show it off!</p> <ul> <li>Support for the Arduino MKRZERO board <a href="https://twitter.com/gonadic_io/status/1035916949287575552">has landed</a> in the <a href="https://github.com/wez/atsamd21-rs">atsamd21-rs</a> repository! This is a Board Support Crate for various development board based on the Atmel/Microchip samd21 Cortex-M microcontroller</li> <li><a href="https://github.com/branan">Branan Riley</a> is working on the <a href="https://twitter.com/branan/status/1038222375790161920">fourth chapter</a> of his <a href="https://branan.github.io/teensy/">Exploring Rust on Teensy</a> series, which will focus on using <code>futures-rs</code> to represent DMA transfers</li> <li><a href="https://github.com/korken89">Emil Fresk</a> shared some shots of his next <a href="https://twitter.com/korken89/status/1038494310830952449">Visual Inertial PCB</a>, which includes an STM32 running control algorithms written in Rust!</li> <li><a href="https://github.com/thejpster">Jonathan Pallant</a> added a bare-metal <a href="https://twitter.com/therealjpster/status/1036298070022086656">four-channel synthesizer</a> for his Monotron project, and even included a short <a href="https://www.youtube.com/watch?v=NvfyFhFK11g">demo audio clip</a>!</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">16</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">41</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">0</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>Take a minute to check out the <a href="https://github.com/search?q=org%3Arust-embedded+is%3Aissue+is%3Aopen+milestone%3Arc1+label%3A%22help+wanted%22&amp;type=Issues">wg help wanted issues</a> as labeled on our issue tracker!</li> </ul> Tue, 28 Aug 2018 00:00:00 +0000 https://blog.rust-embedded.org/2018-08-2x-psa-cortex-m-breakage/ https://blog.rust-embedded.org/2018-08-2x-psa-cortex-m-breakage/ <p>The default linker for the 4 ARM Cortex-M targets listed below has changed from <code>arm-none-eabi-gcc</code> to <code>rust-lld</code> in the latest nightly.</p> <ul> <li><code>thumbv6m-none-eabi</code></li> <li><code>thumbv7m-none-eabi</code></li> <li><code>thumbv7em-none-eabi</code></li> <li><code>thumbv7em-none-eabihf</code></li> </ul> <p>This will break the builds of <em>binaries</em> and <em>cdylibs</em> that were using the old default linker (<code>arm-none-eabi-gcc</code>) <em>and</em> additionally pass extra flags to the linker using any of these rustc flags: <code>-C link-arg</code>, <code>-C link-args</code>, <code>-Z pre-link-arg</code> or <code>-Z pre-link-args</code>. Building libraries (<code>rlib</code>s and <code>staticlib</code>s) is not affected by this change.</p> <span id="continue-reading"></span> <p>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.</p> <h3 id="rationale">Rationale</h3> <p>This breaking change was intentional.</p> <p>We, the <a href="https://github.com/rust-embedded/wg">embedded WG</a>, 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 <code>arm-none-eabi-gcc</code> or <code>arm-none-eabi-ld</code>) to build Rust programs.</p> <p>Before landing this change we first <a href="https://github.com/rust-embedded/wg/issues/160">consulted</a> 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.</p> <p>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.</p> <h3 id="how-to-fix-your-build">How to fix your build</h3> <p>If you are affected by this change you'll observe a linker error with a message similar to one shown below:</p> <pre data-lang="console" style="background-color:#2b303b;color:#c0c5ce;" class="language-console "><code class="language-console" data-lang="console"><span>$ # these are the custom linker flags of the project </span><span>$ cat .cargo/config </span></code></pre> <pre data-lang="toml" style="background-color:#2b303b;color:#c0c5ce;" class="language-toml "><code class="language-toml" data-lang="toml"><span>[target.thumbv7m-none-eabi] </span><span style="color:#bf616a;">runner </span><span>= &#39;</span><span style="color:#a3be8c;">arm-none-eabi-gdb</span><span>&#39; </span><span style="color:#bf616a;">rustflags </span><span>= [ </span><span> &quot;</span><span style="color:#a3be8c;">-C</span><span>&quot;, &quot;</span><span style="color:#a3be8c;">link-arg=-Wl,-Tlink.x</span><span>&quot;, </span><span> &quot;</span><span style="color:#a3be8c;">-C</span><span>&quot;, &quot;</span><span style="color:#a3be8c;">link-arg=-nostartfiles</span><span>&quot;, </span><span>] </span><span> </span><span>[build] </span><span style="color:#bf616a;">target </span><span>= &quot;</span><span style="color:#a3be8c;">thumbv7m-none-eabi</span><span>&quot; </span></code></pre> <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>$ cargo build </span><span>error: linking with `rust-lld` failed: exit code: 1 </span><span> | </span><span> = note: &quot;rust-lld&quot; &quot;-flavor&quot; &quot;gnu&quot; (..) </span><span> = note: rust-lld: error: unknown argument: -Wl,-Tlink.x </span><span> rust-lld: error: unknown argument: -nostartfiles </span></code></pre> <p>There are two ways to fix the problem.</p> <h4 id="option-a-switch-back-to-gcc">Option A: switch back to GCC</h4> <p>The easiest way is to switch back to using <code>arm-none-eabi-gcc</code> as the linker. To do so pass the flag <code>-C linker=arm-none-eabi-gcc</code> to rustc. In the above example you can do that in the <code>.cargo/config</code> file.</p> <pre data-lang="console" style="background-color:#2b303b;color:#c0c5ce;" class="language-console "><code class="language-console" data-lang="console"><span>$ # these are the custom linker flags of the project </span><span>$ cat .cargo/config </span></code></pre> <pre data-lang="toml" style="background-color:#2b303b;color:#c0c5ce;" class="language-toml "><code class="language-toml" data-lang="toml"><span>[target.thumbv7m-none-eabi] </span><span style="color:#bf616a;">runner </span><span>= &#39;</span><span style="color:#a3be8c;">arm-none-eabi-gdb</span><span>&#39; </span><span style="color:#bf616a;">rustflags </span><span>= [ </span><span> &quot;</span><span style="color:#a3be8c;">-C</span><span>&quot;, &quot;</span><span style="color:#a3be8c;">linker=arm-none-eabi-gcc</span><span>&quot;, </span><span style="color:#65737e;"># ADDED </span><span> &quot;</span><span style="color:#a3be8c;">-C</span><span>&quot;, &quot;</span><span style="color:#a3be8c;">link-arg=-Wl,-Tlink.x</span><span>&quot;, </span><span> &quot;</span><span style="color:#a3be8c;">-C</span><span>&quot;, &quot;</span><span style="color:#a3be8c;">link-arg=-nostartfiles</span><span>&quot;, </span><span>] </span><span> </span><span>[build] </span><span style="color:#bf616a;">target </span><span>= &quot;</span><span style="color:#a3be8c;">thumbv7m-none-eabi</span><span>&quot; </span></code></pre> <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>$ cargo build &amp;&amp; echo It works now </span><span>It works now </span></code></pre> <h4 id="option-b-tweak-the-additional-linker-arguments">Option B: tweak the additional linker arguments</h4> <p>The other option is to tweak the additional linker arguments so they'll be accepted by LLD. In the above example the <code>-nostartfiles</code> flag can be dropped because that's the default behavior of LLD, and the flags prefixed by <code>-Wl,</code> will have to lose their prefix.</p> <pre data-lang="console" style="background-color:#2b303b;color:#c0c5ce;" class="language-console "><code class="language-console" data-lang="console"><span>$ # these are the custom linker flags of the project </span><span>$ cat .cargo/config </span></code></pre> <pre data-lang="toml" style="background-color:#2b303b;color:#c0c5ce;" class="language-toml "><code class="language-toml" data-lang="toml"><span>[target.thumbv7m-none-eabi] </span><span style="color:#bf616a;">runner </span><span>= &#39;</span><span style="color:#a3be8c;">arm-none-eabi-gdb</span><span>&#39; </span><span style="color:#bf616a;">rustflags </span><span>= [ </span><span> &quot;</span><span style="color:#a3be8c;">-C</span><span>&quot;, &quot;</span><span style="color:#a3be8c;">link-arg=-Tlink.x</span><span>&quot;, </span><span style="color:#65737e;"># CHANGED </span><span style="color:#65737e;"># &quot;-C&quot;, &quot;link-arg=-nostartfiles&quot;, # REMOVED </span><span>] </span><span> </span><span>[build] </span><span style="color:#bf616a;">target </span><span>= &quot;</span><span style="color:#a3be8c;">thumbv7m-none-eabi</span><span>&quot; </span></code></pre> <pre data-lang="console" style="background-color:#2b303b;color:#c0c5ce;" class="language-console "><code class="language-console" data-lang="console"><span>$ cargo build &amp;&amp; echo It works now </span><span>It works now </span></code></pre> <p>With this approach your build will no longer depend on an external linker.</p> <h4 id="should-i-prefer-option-a-or-b">Should I prefer option A or B?</h4> <p>If you are linking to a system installed C library like <code>newlib-arm-none-eabi</code> then you should continue to use GCC. The default library search path of <code>arm-none-eabi-gcc</code> includes the path to those libraries.</p> <p>If you are not linking to any C code then you should prefer LLD then you won't need to install the <code>arm-none-eabi</code> toolchain.</p> Tue, 28 Aug 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-10/ https://blog.rust-embedded.org/newsletter-10/ <p>This is the tenth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <p>Discuss on <a href="https://internals.rust-lang.org/t/the-10th-embedded-wg-newsletter-and-a-new-blog/8326">internals.rust-lang.org</a>, <a href="https://twitter.com/rustembedded/status/1034765727423717376">on twitter</a>, or <a href="https://www.reddit.com/r/rust/comments/9b8gry/the_10th_embedded_wg_newsletter_and_a_new_blog/">on reddit</a>!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/blog/issues/6">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>We have <a href="https://rust-embedded.github.io/blog/">a blog</a>! We'll be posting newsletters, notices for upcoming changes, and embedded related articles there in the upcoming future. Use RSS? It has an <a href="https://rust-embedded.github.io/blog/rss.xml">RSS feed</a>! Check out the <a href="https://github.com/rust-embedded/blog">blog on github</a> to make any corrections or to contribute an article</li> <li>Nightly Rust has <a href="https://rust-embedded.github.io/blog/2018-08-2x-psa-cortex-m-breakage/">switched to <code>lld</code></a> for Cortex-M targets as a default. See the blog post for how to handle this change</li> <li>There have been updates to <a href="https://github.com/rust-embedded/cortex-m/blob/master/CHANGELOG.md#v056---2018-08-27"><code>cortex-m</code></a>, <a href="https://github.com/rust-embedded/cortex-m-rt/blob/master/CHANGELOG.md#v053---2018-08-27"><code>cortex-m-rt</code></a>, and <a href="https://github.com/rust-embedded/cortex-m-quickstart/blob/master/CHANGELOG.md#v034---2018-08-27"><code>cortex-m-quickstart</code></a>! Check out the linked changelogs to see what is new. Also, the latest release of each of these no longer require <code>arm-none-eabi-gcc</code>!</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-embedded/blog/issues/6">the next newsletter</a>, we would love to show it off!</p> <ul> <li>Support for <code>aarch64-unknown-none</code> has <a href="https://github.com/rust-lang/rust/commit/898950caf1a7bc9b6c41e74bbfac9591724f307c">landed upstream</a>! It is now possible to write bare-metal Rust code for 64-bit ARM architectures</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-embedded/wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">14</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">39</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td><td style="text-align: left">+1</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>Take a minute to check out the <a href="https://github.com/search?q=org%3Arust-embedded+is%3Aissue+is%3Aopen+milestone%3Arc1+label%3A%22help+wanted%22&amp;type=Issues">wg help wanted issues</a> as labeled on our issue tracker!</li> </ul> Sun, 12 Aug 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-9/ https://blog.rust-embedded.org/newsletter-9/ <p>This is the ninth newsletter of the <a href="https://github.com/rust-embedded/wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-embedded/wg/issues/164">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>The Embedded Working Group has moved! You can find our new coordination repo at <a href="https://github.com/rust-embedded/wg">rust-embedded/wg</a> on GitHub, and crates maintained by the working group in the <a href="https://github.com/rust-embedded">rust-embedded</a> organization</li> <li>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: <ul> <li>The <strong>Cortex-M</strong> team develops and maintains the core of the Cortex-M crate ecosystem</li> <li>The <strong>HAL team</strong> develops and maintains crates that ease the development of Hardware Abstraction Layers, Board Support Crates and drivers</li> <li>The <strong>MS430 team</strong> develops and maintains the core of the MSP430 crate ecosystem</li> <li>The <strong>RISCV team</strong> develops and maintains the core of the RISCV crate ecosystem</li> <li>The <strong>Resources team</strong> develops, maintains and curates resources on embedded Rust</li> <li>The <strong>Tools team</strong> maintains and develops core embedded tools</li> </ul> </li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-embedded/wg/issues/164">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/rust-lang/rust/pull/52787">rust-lang/rust#52787</a> has landed, adding support in <code>nightly</code> for the RISC-V architecture as a bare-metal target!</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">14</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td><td style="text-align: left">+1</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">38</td><td style="text-align: left">+3</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td><td style="text-align: left">0</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>We're considering changing to LLD as the default linker for <code>thumb</code> targets. Check out the RFC at <a href="https://github.com/rust-embedded/wg/issues/160">rust-embedded/wg#160</a>, and let us know what you think</li> </ul> Sun, 29 Jul 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-8/ https://blog.rust-embedded.org/newsletter-8/ <p>This is the eighth newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/134">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/japaric/libm#libm">libm</a>, the <code>no_std</code> port of MUSL's math library led by <a href="https://github.com/japaric">japaric</a> has finished its' first release! It can now be used by embedded (or <code>wasm</code>!) targets that need support for math functions.</li> <li><a href="https://github.com/droogmic">droogmic</a> is working on <a href="https://droogmic.github.io/microrust">microrust</a>, a port of <a href="https://github.com/japaric">japaric</a>'s Discovery book for the BBC MicroBit, based on the Nordic nRF51</li> <li><a href="https://github.com/sekineh">Hideki Sekine</a> and <a href="https://github.com/nerdyvaishali">Vaishali Thakkar</a> have landed initial support for an <a href="https://github.com/rust-lang/rust/pull/52465">Embedded CI Harness</a> in the <a href="https://github.com/rust-lang/rust"><code>rust-lang/rust</code></a> repo as part of the <a href="http://reach.rust-lang.org/">Increasing Rust's Reach</a> project. This opens the door for tests that will help prevent regressions in <code>rustc</code> and <code>cargo</code> for ARM Cortex-M targets</li> <li><a href="https://github.com/rust-lang-nursery/stdsimd/pull/518">CMSIS intrinsics</a> for ARM Cortex processors have landed in <a href="https://github.com/rust-lang-nursery/stdsimd">stdsimd</a>. Check out the <a href="https://doc.rust-lang.org/nightly/core/arch/arm/index.html">the docs</a> in nightly soon^† for info, thanks to <a href="https://github.com/paoloteti">Paolo Teti</a> and <a href="https://github.com/japaric">japaric</a>!</li> <li><a href="https://github.com/ashleygwilliams">Ashley Williams</a> released <a href="https://crates.io/crates/cargo-generate">cargo-generate</a>, a CLI tool for generating Cargo projects from a template, reducing the need to manually write boilerplate code. If you write some embedded templates, <a href="https://twitter.com/rustembedded">let us know</a>!</li> </ul> <p>†: The CMSIS intrinsics will show up in the docs after the next successful nightly build (after 2018-07-30)</p> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/134">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/djmcgill">David McGillicuddy</a> has released his crate, <a href="https://crates.io/crates/eight-segment">eight-segment</a>, an <code>embedded-hal</code> driver for displaying digits on 8 segment displays like the HDSP H-101</li> <li><a href="https://github.com/jamwaffles">James Waples</a> announced the newest release of his <a href="https://crates.io/crates/embedded-graphics">embedded-graphics</a> library <a href="https://twitter.com/jam_waffles/status/1022837939041132545">in a tweet</a>. This version fixes some small issues, as well as provides functionality to save memory</li> <li><a href="https://github.com/roosmaa">Mart Roosmaa</a> released <a href="https://github.com/roosmaa/bolos-rs">bolos-rs</a>, a 3rd party Rust SDK for the Ledger Nano cryptocurrency wallet. Check out his <a href="https://medium.com/@roosmaa/bringing-rust-to-ledger-hardware-wallet-ccf1356a7de1">Medium post</a> for more info!</li> <li>The <a href="https://crates.io/crates/cc1101">cc1101</a> crate can now recieve radio packets! Check out <a href="https://www.reddit.com/r/rust/comments/8zk03w/cc1101_crate_can_now_receive_radio_packets/">the reddit post</a> by <a href="https://github.com/dsvensson">Daniel Svensson</a>, as well as <a href="https://dsvensson.github.io/posts/2018-07-13-Electrosmog-trapping-with-CC1101.html#article">his blog post</a> for more info</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">14</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">8</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">+2</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">35</td><td style="text-align: left">+5</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#no-std-crates">no-std crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td><td style="text-align: left">+12</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>The Embedded-WG is looking for someone to write an <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/63#issuecomment-408509178">RFC for ARM Intrinsics</a> to get them stabilized</li> <li><a href="https://github.com/thejpster">Jonathan Pallant</a> is looking for ideas to implement for the Monotron project. Check out the <a href="http://railwayelectronics.blogspot.com/2018/07/where-next-for-monotron.html">monotron blog post</a> for more details!</li> <li>The <a href="https://github.com/japaric/libm#libm">libm</a> project is looking for help with <a href="https://github.com/japaric/libm/milestone/3">refactoring</a> in order to better support chips without hardware double-floating-point support</li> </ul> Sun, 15 Jul 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-7/ https://blog.rust-embedded.org/newsletter-7/ <p>This is the seventh newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/121">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>We have launched the <a href="https://twitter.com/rustembedded">Embedded WG Twitter</a>! 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!</li> <li>Work started on <a href="https://github.com/japaric/libm">porting</a> MUSL's <code>libm</code> (for math functions like <code>sin</code>, <code>cos</code>, etc.) has started, and already has <a href="https://github.com/japaric/libm/issues?q=is%3Aopen+is%3Aissue+milestone%3Awasm">26 of 32 functions</a> ported! This crate will hopefully be included in the <code>core</code> of Rust, so it can be used by <code>no_std</code> targets such as embedded or wasm.</li> <li>The Atomic*.{load,store} API is <a href="https://github.com/rust-lang/rust/pull/51953">now available</a> for the thumbv6m and msp430 targets.</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/121">the next newsletter</a>, we would love to show it off!</p> <ul> <li>This week we have two Multirotor Flight Controller projects starting in Rust! They are both based on the <a href="https://github.com/japaric/stm32f30x-hal">stm32f3</a> family of chips from STMicro. <ul> <li><a href="https://github.com/korken89">Emil Fresk</a> posted <a href="https://twitter.com/korken89/status/1016975023930830848">on Twitter</a> about his project <a href="https://github.com/korken89/trustflight_firmware">TrustFlight</a>, which is an open source, Rust based software library for controlling the <a href="https://github.com/korken89/trustflight_hardware">TrustFlight HW</a> he designed.</li> <li><a href="https://github.com/JoshMcguigan">Josh Mcguigan</a> announced in his <a href="https://www.joshmcguigan.com/blog/betafpv-drone-flight-controller-hello-rust/">Blog Post</a> that he is planning to develop a firmware package for the <a href="https://betafpv.com/products/beta75-bnf-tiny-whoop-quadcopter">BetaFPV F3</a>, which is an off the shelf flight controller</li> </ul> </li> <li>We also have two projects aiming to make use of Rust on the Raspberry Pi a little easier: <ul> <li><a href="https://gitlab.com/AGausmann">Adam Gausmann</a> shared his <a href="https://gitlab.com/AGausmann/rustberry">Rustberry</a> project <a href="https://www.reddit.com/r/rust/comments/8x1ayd/calling_all_raspberry_pi_owners_rustberry_010_has/">on Reddit</a>, which includes register maps and an I/O library for the Raspberry Pi</li> <li><a href="https://github.com/rahul-thakoor">Rahul Thakoor</a> shared his <a href="https://github.com/rahul-thakoor/rust_gpiozero">rust_gpiozero</a> crate <a href="https://medium.com/@rahulthakoor/physical-computing-with-rust-on-raspberry-pi-a7b6f34261a6">on Medium</a>, which is based on the Python library of similar name. He has also started writing <a href="https://rahul-thakoor.github.io/physical-computing-rust/">a series of tutorials</a> for developers new to working with physical hardware.</li> </ul> </li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th><th style="text-align: left">Diff</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">14</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">6</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td><td style="text-align: left">0</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">30</td><td style="text-align: left">0</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>Help contribute to development of <a href="https://github.com/japaric/libm">Rust's libm</a> to get math functions built in to <code>core</code> for <code>no_std</code> targets!</li> </ul> Sun, 01 Jul 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-6/ https://blog.rust-embedded.org/newsletter-6/ <p>This is the sixth newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>This newsletter covers the past ~6 weeks.</p> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/103">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/jcreedon">Jacob Creedon</a> gave an introduction talk about using Rust with embedded systems at the <a href="https://www.crowdsupply.com/teardown/portland-2018">Teardown Conference</a> in Portland, check out <a href="http://github.jcreedon.com/static/EmbeddedWithRustSlidesTeardown2018.pdf">Jacob's Slides</a> or the <a href="http://youtu.be/g25xsK3HKkE">Video of Jacob's Talk</a></li> <li>The <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a>'s own <a href="https://github.com/thejpster">theJPster</a> talked about the <a href="https://github.com/thejpster/monotron">Monotron</a> at <a href="https://paris.rustfest.eu/">RustFest Paris</a>, you can see <a href="http://railwayelectronics.blogspot.co.uk/2018/05/talking-about-monotron-at-rustfest.html">JP's Slides</a>, or check out the <a href="https://media.ccc.de/v/rustfest18-11-monotron_making_a_80s_style_computer_with_a_20_dev_kit">Video of JP's Talk</a></li> <li><a href="https://github.com/japaric">Jorge Aparicio</a>, <a href="https://github.com/pftbest">Vadzim Dambrouski</a> and <a href="https://github.com/hannobraun">Hanno Braun</a> 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.</li> <li>The <code>#[panic_implementation]</code> feature has <a href="https://github.com/rust-lang/rust/pull/50338">landed</a> and has been proposed for stabilization (<a href="https://github.com/rust-lang/rust/issues/44489#issuecomment-398965878">FCP merge</a>). This feature lets you define the behavior of <code>panic!</code> in <code>#[no_std]</code> context and it's the final piece for making embedded Rust development possible on the stable channel. :tada:</li> <li>The <a href="https://github.com/japaric/discovery">Discovery</a> book has been updated to work with the <a href="https://users.rust-lang.org/t/cortex-m-library-development-now-possible-on-beta-and-the-path-towards-stable-embedded-rust/17420">preview of stable embedded Rust</a>.</li> <li>A new <a href="https://internals.rust-lang.org/t/llvm-tools-a-new-rustup-component-for-binary-inspection-objdump-nm-size-and-profiling-prota/7830"><code>llvm-tools</code> rustup component</a> 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!</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/103">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/rudihorn">rudihorn</a> shared <a href="https://github.com/rudihorn/light-cli">light-cli</a>, a lightweight, no_std, and heapless CLI tool</li> <li><a href="https://github.com/paoloteti">Paolo Teti</a> shared <a href="https://github.com/paoloteti/ti-hercules-bsp">ti-hercules-bsp</a>, a board support package for Texas Instruments TMS570 MCUs, used by safety critical industries such as automotive and aerospace</li> <li><a href="https://github.com/marcelbuesing">Marcel Buesing</a> posted their driver crate for the <a href="https://github.com/marcelbuesing/bme680">bme680</a> environmental sensor</li> <li><a href="https://github.com/roysmeding">Roy Smeding</a> is working on support for the <a href="https://github.com/roysmeding/stm32f334/">stm32f334</a> chip from STMicro</li> <li>The <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a>'s own <a href="https://github.com/jcsoo">Jonathan Soo</a> announced his project, <a href="http://www.bobbin.io/blog/post/bobbin_sdk_richer_hardware/">Bobbin SDK</a>, a set of tools to make it easier to share code between different chips from the same or different vendors</li> <li><a href="https://github.com/emosenkis">Eitan Mosenkis</a> did <a href="https://users.rust-lang.org/t/rust-on-esp8266/12933/8">a major update</a> of their <a href="https://github.com/emosenkis/esp-rs">esp-rs</a> script which produces a project to compile Rust code for the ESP8266 via the <a href="https://github.com/thepowersgang/mrustc">mrustc</a> Rust to C compiler.</li> <li><a href="https://github.com/hannobraun">Hanno Braun</a> released v0.2 of <a href="https://github.com/braun-robotics/rust-lpc82x-hal">lpc82x-hal</a>, which includes a radical simplification of the API, allowing for stronger compile-time state guarantees. Check out the <a href="https://users.rust-lang.org/t/lpc82x-hal-0-2-rust-on-lpc82x-microcontrollers/18144">lpc82x-hal announcement</a> for more info!</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">14</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">11</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">6</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">30</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>We are seeking <a href="https://github.com/japaric/cargo-binutils/issues">input about the user interface</a> the <a href="https://github.com/japaric/cargo-binutils"><code>cargo-binutils</code></a> subcommands should expose. These subcommands provide access to the LLVM tools provided by the <code>llvm-tools</code> rustup component mentioned above.</li> <li>Are you using embedded Rust in production? We are <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/108">collecting commercial testimonials</a> 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!</li> </ul> Tue, 15 May 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-5/ https://blog.rust-embedded.org/newsletter-5/ <p>This is the fifth bi-weekly newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/98">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>We had a bonus Embedded-WG Newsletter this week about the <a href="https://users.rust-lang.org/t/cortex-m-library-development-now-possible-on-beta-and-the-path-towards-stable-embedded-rust/17420">path forward</a> towards stable Embedded Rust, and what you can do as a crate maintainer to help with the effort!</li> <li>The Tock-OS project posted about their <a href="https://www.tockos.org/blog/2018/mmio-registers/">MMIO Registers</a>, contrasting them to crates generated by <code>svd2rust</code></li> <li>There were a couple of great posts about developing with Rust on Embedded targets from <a href="https://www.219design.com/rust-on-the-stmicro-nucleo/">219 Design</a> and <a href="https://nercury.github.io/rust/embedded/experiments/2018/04/29/rust-embedded-01-discovery-vl-flipping-bits.html">nercury</a></li> <li>If Game Boy Advance development with Rust sounds interesting to you, make sure you check out the <a href="https://github.com/tbelaire/rusty-TONC">rusty-TONC</a> and <a href="https://github.com/jkarns275/stdgba">stdgba</a> projects</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/98">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/kjetilkjeka">Kjetil Kjeka</a> shared their crate <a href="https://crates.io/crates/ux">uX</a> pronounced as "unsigned X" for working with non standard integer types (like <code>u7</code>, <code>u63</code>, etc) which act like the built in unsigned integer types</li> <li><a href="https://github.com/adamgreig">Adam Greig</a> shared two crates: <ul> <li><a href="https://github.com/adamgreig/stm32-rs">stm32-rs</a>, a tool for cleaning up Chip Support Crates for STM32 microcontrollers and making it easier to work between multiple devices</li> <li><a href="https://github.com/AirborneEngineering/blethrs">blethrs</a>, an ethernet bootloader for STM32F4 chips, using the <a href="https://github.com/m-labs/smoltcp">smoltcp</a> networking stack</li> </ul> </li> <li><a href="https://github.com/jamwaffles">James Waples</a> released a driver for <a href="https://crates.io/crates/ssd1306">ssd1306</a> based OLED displays, read the <a href="https://wapl.es/electronics/rust/2018/04/30/ssd1306-driver.html">announcement blog</a> for more info</li> <li><a href="https://github.com/jscarrott">John Scarrott</a> released a Chip Support Crate for the <a href="https://crates.io/crates/nrf52840">nRF52840</a> chip from Nordic Semiconductor</li> <li><a href="https://github.com/krk">Kerem</a> posted a new Chip Support Crate for the Nordic Semiconductor nRF51, and joined development of the existing <a href="https://crates.io/crates/nrf51-hal">nrf51-hal</a> HAL Impl Crate</li> <li><a href="https://github.com/teozkr">Teo Röijezon</a> released a combo of a <a href="https://crates.io/crates/stm32f0x0">stm32f0x0</a> Chip Support Crate, as well as a <a href="https://crates.io/crates/stm32f0x0-hal">stm32f0x0-hal</a> HAL Impl Crate</li> <li><a href="https://github.com/rahul-thakoor">Rahul Thakoor</a> shipped a driver crate for <a href="https://crates.io/crates/mma7660fc">mma7660fc</a> based 3-axis accelerometers. Check out the <a href="https://rahul-thakoor.github.io/an-i2c-rust-driver-for-mma7660fc-based-3-axis-digital-accelerometer/">mma7660fc blog</a> announcement</li> <li><a href="https://github.com/whitequark">whitequark</a> shared their <a href="https://github.com/whitequark/rust-log_buffer">log_buffer</a> crate for storing UTF-8 text in a ring buffer, and accessing it as <code>&amp;str</code>s</li> <li><a href="https://github.com/memoryruins">Michael</a> shared <a href="https://github.com/AltSysrq/proptest">proptest</a>, a tool for performing Property Based Testing, which now has no_std support thanks to a PR from <a href="https://github.com/ZackPierce">Zack Pierce</a></li> <li><a href="https://github.com/thejpster">theJPster</a> has been working on <a href="https://github.com/thejpster/monotron">Monotron</a> - a small 8-bit style home computer with a ROM written in Rust - ready for his talk at <a href="https://paris.rustfest.eu/">RustFest</a>. For this, he's been working on crates for <a href="https://github.com/thejpster/vga-framebuffer-rs">generating VGA video</a>, <a href="https://github.com/thejpster/pc-keyboard">decoding PS/2 keyboard scancodes</a> and <a href="https://github.com/thejpster/menu">interactive text-based menu systems</a>.</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">10</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">6</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">9</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">29</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>Make sure to check out the <a href="https://users.rust-lang.org/t/cortex-m-library-development-now-possible-on-beta-and-the-path-towards-stable-embedded-rust/17420">path forward</a> post, and report any issues you find!</li> <li>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. <a href="https://github.com/thejpster">theJPster</a> 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 <a href="https://twitter.com/therealjpster">@therealjpster</a> on Twitter or email <a href="mailto:pi@thejpster.org.uk">pi@thejpster.org.uk</a>.</li> <li>Some members of the embedded WG will attend the <a href="https://paris.rustfest.eu/">RustFest</a> impl days in two weeks. If you want to make Rust awesome for embedded development come help us! We have <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/90#issuecomment-389321129">tasks with mentors and some hardware to give away!</a>. Let us know if you are interested in helping out by commenting on that issue.</li> </ul> Sun, 13 May 2018 00:00:00 +0000 https://blog.rust-embedded.org/the-path-towards-stable/ https://blog.rust-embedded.org/the-path-towards-stable/ <h2 id="cortex-m-library-development-now-possible-on-beta-and-the-path-towards-stable-embedded-rust">Cortex-M library development now possible on beta and the path towards stable embedded Rust</h2> <blockquote> <p><strong>TL;DR</strong></p> <ul> <li>1.27 = embedded (Cortex-M) <em>library</em> development on stable</li> <li>1.28 or 1.29 = embedded (Cortex-M) <em>application</em> development on stable</li> <li>We are making breaking changes in the ecosystem in order to move towards development on the stable channel</li> <li>If you are a crate maintainer / author, make sure you test your crates with the new versions of <code>cortex-m</code> (and similar) on the current <code>beta</code> release of Rust</li> <li>If the latest version of a dependency doesn't compile on <code>beta</code>, file an issue and/or ping us on the #rust-embedded IRC channel</li> <li>Thanks for your patience!</li> </ul> </blockquote> <p>We are happy to announce that <em>library</em> development for the Cortex-M targets is now possible on the beta channel! :tada:</p> <span id="continue-reading"></span> <p>For example, to cross compile a library crate for the Cortex-M3 you would run these commands:</p> <pre data-lang="console" style="background-color:#2b303b;color:#c0c5ce;" class="language-console "><code class="language-console" data-lang="console"><span>$ # switch to the beta channel </span><span>$ rustup default beta </span><span> </span><span>$ # install the rust-std component (pre-compiled core) for the target </span><span>$ rustup target add thumbv7m-none-eabi </span><span> </span><span>$ # get some source to build </span><span>$ cargo clone cortex-m --vers 0.5.0 &amp;&amp; cd cortex-m </span><span> </span><span>$ # then It Just Works </span><span>$ cargo build --target thumbv7m-none-eabi </span></code></pre> <p>What about embedded <em>application</em> development? There is just a single unstable feature that prevents us from building a <code>no_std</code> binary on stable: the <code>panic_fmt</code> lang item. This unstable feature will soon be removed in favor of the <code>#[panic_implementation]</code> feature (<a href="https://github.com/rust-lang/rust/pull/50338">implementation PR</a>), 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).</p> <h2 id="making-the-cortex-m-ecosystem-work-on-stable">Making the Cortex-M ecosystem work on stable</h2> <p>"<code>no_std</code> binaries are <em>possible</em> on stable" is very different from "<em>my</em> 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.</p> <p>Legend: <code>crate-name</code> - link to CHANGELOG - link to stabilization PR - <del>removed unstable features</del></p> <ul> <li><a href="https://docs.rs/cortex-m-quickstart/~0.3"><code>cortex-m-quickstart</code></a> - <a href="https://github.com/japaric/cortex-m-quickstart/blob/master/CHANGELOG.md#v030---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/cortex-m-quickstart/pull/29">PR</a></li> </ul> <ul> <li><a href="https://crates.io/crates/cortex-m-rt/0.5.0"><code>cortex-m-rt</code></a> - <a href="https://github.com/japaric/cortex-m-rt/blob/master/CHANGELOG.md#v050---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/cortex-m-rt/pull/69">PR</a> - <del>asm!</del> <del>core_intrinsics</del> <del>global_asm!</del> <del>lang_items</del> <del>linkage</del> <del>naked_functions</del> <del>used</del></li> </ul> <ul> <li><a href="https://crates.io/crates/cortex-m-semihosting/0.3.0"><code>cortex-m-semihosting</code></a> - <a href="https://github.com/japaric/cortex-m-semihosting/blob/master/CHANGELOG.md#v030---2018-05-10">CHANGELOG</a> - <a href="https://github.com/japaric/cortex-m-semihosting/pull/16">PR</a></li> </ul> <ul> <li><a href="https://crates.io/crates/cortex-m/0.5.0"><code>cortex-m</code></a> - <a href="https://github.com/japaric/cortex-m/blob/master/CHANGELOG.md#v050---2018-05-11">CHANGELOG</a> - <a href="https://github.com/japaric/cortex-m/pull/88">PR</a> - <del>asm!</del> <del>const_fn</del></li> </ul> <ul> <li><a href="https://crates.io/crates/embedded-hal/0.2.0"><code>embedded-hal</code></a> - <a href="https://github.com/japaric/embedded-hal/blob/master/CHANGELOG.md#v020---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/embedded-hal/pull/80">PR</a> - <del>never_type</del></li> </ul> <ul> <li><a href="https://crates.io/crates/f3/0.6.0"><code>f3</code></a> - <a href="https://github.com/japaric/f3/blob/master/CHANGELOG.md#v060---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/f3/pull/93">PR</a></li> </ul> <ul> <li><a href="https://crates.io/crates/l3gd20/0.2.0"><code>l3gd20</code></a> - <a href="https://github.com/japaric/l3gd20/blob/master/CHANGELOG.md#v020---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/l3gd20/pull/4">PR</a> - <del>Unsized</del></li> </ul> <ul> <li><a href="https://crates.io/crates/lsm303dlhc/0.2.0"><code>lsm303dlhc</code></a> - <a href="https://github.com/japaric/lsm303dlhc/blob/master/CHANGELOG.md#v020---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/lsm303dlhc/pull/4">PR</a> - <del>Unsized</del></li> </ul> <ul> <li><a href="https://crates.io/crates/stm32f103xx/0.10.0"><code>stm32f103xx</code></a> - <a href="https://github.com/japaric/stm32f103xx/blob/master/CHANGELOG.md#v0100---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/stm32f103xx/pull/24">PR</a> - <del>const_fn</del> <del>global_asm!</del> <del>try_from</del> <del>use_extern_macros</del> <del>used</del></li> </ul> <ul> <li><a href="https://crates.io/crates/stm32f30x-hal/0.2.0"><code>stm32f30x-hal</code></a> - <a href="https://github.com/japaric/stm32f30x-hal/blob/master/CHANGELOG.md#v020---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/stm32f30x-hal/pull/25">PR</a> - <del>never_type</del></li> </ul> <ul> <li><a href="https://crates.io/crates/stm32f30x/0.7.0"><code>stm32f30x</code></a> - <a href="https://github.com/japaric/stm32f30x/blob/master/CHANGELOG.md#v070---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/stm32f30x/pull/16">PR</a> - <del>const_fn</del> <del>global_asm!</del> <del>try_from</del> <del>use_extern_macros</del> <del>used</del></li> </ul> <ul> <li><a href="https://crates.io/crates/svd2rust/0.13.0"><code>svd2rust</code></a> (output of) - <a href="https://github.com/japaric/svd2rust/blob/master/CHANGELOG.md#v0130---2018-05-12">CHANGELOG</a> - <a href="https://github.com/japaric/svd2rust/pull/203">PR</a> - <del>const_fn</del> <del>global_asm!</del> <del>try_from</del> <del>use_extern_macros</del> <del>used</del></li> </ul> <p>There's a lot of breaking changes there but the most visible one is <code>cortex-m-rt</code> because it changes how applications are structured. Check the <a href="https://docs.rs/cortex-m-quickstart/~0.3"><code>cortex-m-quickstart</code></a> template for instructions on how to set up an embedded application using the latest versions of everything.</p> <p>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 <a href="https://crates.io/crates/heapless"><code>heapless</code></a> and <a href="https://crates.io/crates/cortex-m-rtfm"><code>cortex-m-rtfm</code></a>, which needs to be update to work with <code>cortex-m-rt</code> v0.5.0.</p> <h3 id="how-you-can-help-us">How you can help us</h3> <p>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 <a href="https://crates.io/keywords/panic-impl">panic handler crate</a>, 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.</p> <p>If you are the author of a Cortex-M device crate, a crate generated using <code>svd2rust</code>, moving it to stable only requires regenerating it using <code>svd2rust</code> v0.13.0. Do note that the generation process <a href="https://docs.rs/svd2rust/0.13.0/svd2rust/#usage">has changed</a> for the Cortex-M target; also make sure you bump the minor version when you publish a new version.</p> <p>If you are the author of a driver crate or a HAL implementation, please update your crate to use v0.2.0 of <code>embedded-hal</code> 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 <code>embedded-hal</code> dependency is a breaking change (drivers that depend on <code>embedded-hal</code> v0.1.0 can't be used with HAL implementation crates that depend on <code>embedded-hal</code> v0.2.0).</p> <p>If you are porting an application to the newest <code>cortex-m-*</code> crates you may hit these errors:</p> <ul> <li>"error: requires <code>start</code> lang_item" on binary crates. You need to switch from the standard <code>main</code> interface to <code>#![no_main]</code> + <code>entry!</code>. Use the <a href="https://docs.rs/cortex-m-quickstart/0.3.0/cortex_m_quickstart/examples/_0_minimal/index.html">examples</a> in the quickstart template as a reference.</li> </ul> <ul> <li>"error[E0015]: calls in statics are limited to constant functions, tuple structs and tuple variants". <code>const fn</code> is not a stable feature so it's not used in the API by default. The <code>cortex-m</code> provides a <code>"const-fn"</code> feature to opt into this unstable feature and expose <code>const</code> functions in the API; other dependencies should / probably provide a similar feature.</li> </ul> <h2 id="what-does-this-all-mean-for-you">What does this all mean for you?</h2> <p>To those of you who have been doing embedded development on nightly: things will get <em>much easier</em> from now on. We have reduced the number of unstable features in core crates of the Cortex-M ecosystem to <strong>zero</strong>. 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: <code>panic_fmt</code> will be removed as announced above. This will break the <a href="https://crates.io/keywords/panic-impl">panic handler crates</a>; however, the breakage will be isolated to those crates and the fix will consist of simply updating the dependency version.</p> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/blob/master/books/embedded-rust-book/README.md">embedded Rust book</a> will become the resource to get started on embedded Rust, but it doesn't quite exist right now.</p> <h2 id="what-about-architectures-other-than-arm-cortex-m">What about architectures other than ARM Cortex-M?</h2> <p>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:</p> <ul> <li> <p>MSP430 being the second oldest embedded / <code>no_std</code> target is the closest one to make it to stable (as a tier 2 target) by the edition release. The main blocker is that <code>extern "msp430-interrupt"</code> is not available on stable but I think that may be possible to work around using external C / assembly files + FFI.</p> </li> <li> <p>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.</p> </li> <li> <p>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.</p> </li> </ul> <hr /> <p>This work is part of the <a href="https://github.com/rust-lang-nursery/embedded-wg">embedded WG</a> effort towards <a href="https://github.com/rust-lang-nursery/embedded-wg">making embedded development possible on the stable channel</a>. (We are almost done! :tada:)</p> Sat, 28 Apr 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-4/ https://blog.rust-embedded.org/newsletter-4/ <p>This is the fourth bi-weekly newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/93">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>The <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> IRC meetings are now explicitly public, and the agendas for the next meeting can be found in the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues">WG Issues</a>, like <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/91">this issue</a> for the next meeting</li> <li><a href="https://github.com/djmcgill">David</a> shared his utility <a href="https://github.com/djmcgill/form"><code>Form</code></a>, which takes a single <code>lib.rs</code> (like those created by <code>svd2rust</code> or <code>bindgen</code>), and splits it into structured modules. Check out the <a href="https://github.com/jamesmunns/nrf52/tree/master/src"><code>nrf52</code></a> Chip Support Crate as an example, and try it out for your generated projects!</li> <li><a href="https://github.com/astro">astro</a> shared <a href="https://crates.io/crates/managed"><code>managed</code></a>, A library that provides a way to logically own objects, whether or not heap allocation is available</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/93">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/danielgallagher0">Daniel</a> started work on <a href="https://github.com/danielgallagher0/bluetooth-hci"><code>bluetooth-hci</code></a>, an abstraction layer for HCI based Bluetooth Controllers, and is using it in his <a href="https://github.com/danielgallagher0/bluenrg"><code>bluenrg</code></a> crate for STMicro's BlueNRG RF modules</li> <li><a href="https://github.com/cr1901">cr1901</a> shared his <a href="https://github.com/cr1901/AT2XT"><code>AT2XT</code></a> 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 <code>rtfm</code>, and runs on an <code>msp430</code> microcontroller. Check out the <a href="https://github.com/rust-lang-nursery/embedded-wg/pull/94#issuecomment-385172043">short blurb</a> by <a href="https://github.com/cr1901">cr1901</a> summarizing the project</li> <li><a href="https://github.com/hannobraun">hannobraun</a> released v0.3 of his <a href="https://crates.io/crates/lpc82x"><code>lpc82x</code></a> Chip Support Crate for NXP's LPC82x family of microcontrollers, as well as v0.1 of <a href="https://crates.io/crates/lpc82x-hal"><code>lpc82x-hal</code></a>. Check out the <a href="https://users.rust-lang.org/t/lpc82x-hal-0-1-hardware-abstraction-layer-for-nxp-lpc82x-mcus/17116">lpc82x-hal announcement</a> here!</li> <li><a href="https://github.com/japaric">japaric</a> released v0.3.1 of <a href="https://crates.io/crates/heapless"><code>heapless</code></a> which now contains fixed capacity implementations of <code>HashMap</code> and <code>HashSet</code> that work on <code>no_std</code>, do not require an allocator, and use <code>u32</code> hashes (instead of the default <code>u64</code>).</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">12</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">10</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#board-support-crates">Board Support Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">6</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">7</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">27</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>The <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> is looking for contributors for the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/90">Rustfest Impl Period</a>. If you will be attending RustFest in Paris, let us know!</li> <li>Progress is being made towards <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/42#issuecomment-384524779">Stable Embedded Rust</a>, try out the current preview, and we would love some feedback!</li> </ul> Sat, 14 Apr 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-3/ https://blog.rust-embedded.org/newsletter-3/ <p>This is the third bi-weekly newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/84">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li>Crates for the Embedded Rust Ecosystem are now being tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository</li> <li>Progress has been made as part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/42">Embedded Rust on Stable</a> initiative, including: <ul> <li><code>extern crate compiler_builtins</code> is <a href="https://users.rust-lang.org/t/psa-breaking-change-extern-crate-compiler-builtins-is-now-included-in-no-std-crates/16704">now included in the no_std prelude</a></li> <li><a href="https://users.rust-lang.org/t/psa-you-no-longer-need-xargo-to-do-arm-cortex-m-development/16703">xargo no longer needed</a> for ARM Cortex-M development</li> </ul> </li> <li>We also made some progress on simplifying the embedded development setup: You can now link Embedded Rust programs <a href="https://users.rust-lang.org/t/cortex-m-rt-v0-4-0-now-you-can-link-arm-cortex-m-programs-using-lld/16751">using lld</a></li> <li><a href="https://github.com/ithinuel">Wilfried</a> kicked off a blog series about <a href="http://ithinuel.me/embedded-rust-why/">using embedded rust</a></li> <li><a href="https://github.com/andre-richter">Andre Richter</a> is writing a tutorial for using Rust to write <a href="https://github.com/andre-richter/rust-raspi3-tutorial">bare metal Raspberry Pi 3</a> applications</li> <li>The Embedonomicon and the Embedded Rust Books are <a href="https://github.com/rust-lang-nursery/embedded-wg/pull/78">now kept</a> in the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> repository, and pull requests are welcome!</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/84">the next newsletter</a>, we would love to show it off!</p> <ul> <li><a href="https://github.com/japaric">japaric</a> released an initial version of <a href="https://github.com/japaric/cargo-binutils">cargo-binutils</a>, which will allow you to use LLVM's binutils (like <code>nm</code>, <code>size</code>, <code>objcopy</code>, etc.) in the format <code>cargo objcopy</code> (once <a href="https://github.com/rust-lang/rust/issues/49584">issue 49584</a> has landed)</li> <li><a href="https://github.com/myeisha">myeisha</a> released the first version of their <a href="https://crates.io/crates/thumb2-stack-size">thumb2-stack-size</a> tool, which helps determine the maximum stack size used in embedded code</li> </ul> <h3 id="embedded-hal-ecosystem-crates"><code>embedded-hal</code> Ecosystem Crates</h3> <p>As part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>, crates that are part of the <code>embedded-hal</code> ecosystem are now tracked in the <a href="https://github.com/rust-embedded/awesome-embedded-rust">Awesome Embedded Rust</a> repository. Here is a current snapshot of what is available there:</p> <table><thead><tr><th style="text-align: left">Type</th><th style="text-align: left">Status</th><th style="text-align: left">Count</th></tr></thead><tbody> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#device-crates">Device Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">13</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#hal-implementation-crates">HAL Impl Crates</a></td><td style="text-align: left">released</td><td style="text-align: left">10</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#driver-crates">Driver Crates Released</a></td><td style="text-align: left">released</td><td style="text-align: left">7</td></tr> <tr><td style="text-align: left"><a href="https://github.com/rust-embedded/awesome-embedded-rust#wip">Driver Crates WIP</a></td><td style="text-align: left">WIP</td><td style="text-align: left">26</td></tr> </tbody></table> <h2 id="help-wanted">Help Wanted</h2> <ul> <li>We need help working on <a href="https://github.com/rust-lang/rust/issues/44489#issuecomment-381324623">RFC2070</a>, stabilizing usage of custom Panic behavior. <a href="https://github.com/nagisa">nagisa</a> is willing to mentor!</li> <li>If you use inline assembly in your Embedded Rust programs, help us capture what assembly operations are <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/63#issue-305114817">used most often</a> so we can stabilize them as intrinsics</li> </ul> Thu, 29 Mar 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-2/ https://blog.rust-embedded.org/newsletter-2/ <p>This is the second bi-weekly newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> where we highlight new progress, celebrate cool projects, thank the community, and advertise projects that need help!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/72">the next newsletter</a>, make sure to leave a comment on the issue.</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/dbrgn">dbrgn</a> has kicked off an investigation on how to <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/70">mock embedded-hal</a> to make testing sensors easier</li> <li><a href="https://github.com/Emilgardis">emilgardis</a> and <a href="https://github.com/ryankurte">ryankurte</a> are busy <a href="https://github.com/japaric/svd/issues/46">refactoring</a> the <a href="https://github.com/japaric/svd">svd-parser</a> crate</li> <li><a href="https://github.com/japaric">japaric</a>, <a href="https://github.com/hannobraun">hannobraun</a>, and <a href="https://github.com/jamesmunns">jamesmunns</a> from the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a> attended the 2018 Rust All Hands in Berlin, working on our goal to make <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/42">stable embedded rust development</a> possible in 2018. See the bottom of this post for more details!</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/72">the next newsletter</a>, we would love to show it off!</p> <h3 id="embedded-hal-drivers"><code>embedded-hal</code> drivers</h3> <p>This is a list of recently released drivers that are part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>. There are currently 5 Released Drivers, 14 WIP Drivers, and lots of TODOs!</p> <ul> <li><a href="https://github.com/danielgallagher0">danielgallagher0</a> has released their <a href="https://medium.com/@pdanielgallagher/hts221-humidity-and-temperature-sensor-88056ea9e5fa">hts221</a> humidity and temperature sensor driver</li> <li><a href="https://github.com/MrBuddyCasino">MrBuddyCasino</a> has released their I2C based <a href="https://crates.io/crates/mcp9808">mcp9808</a> temperature sensor driver</li> <li><a href="https://github.com/ilya-epifanov">Ilya Epifanov</a> has released their I2C based <a href="https://github.com/ilya-epifanov/si5351">si5351</a> CMOS clock generator driver, check out the <a href="https://docs.rs/si5351/0.1.5/si5351/">si5351 docs</a> for more info</li> <li><a href="https://github.com/RandomInsano">Edwin Amsler</a> is working on their <a href="https://github.com/RandomInsano/axp209-rs">axp209</a> PMIC driver</li> <li><a href="https://github.com/dbrgn">dbrgn</a> is working on their Sensirion <a href="https://github.com/dbrgn/sgp30-rs">sgp30</a> low-power gas sensor driver</li> <li><a href="https://github.com/pcein">pcein</a> has started work on their <a href="https://github.com/pcein/pcd8544">pcd8544</a> for SPI based LCD controllers used in displays like the Nokia 5110</li> <li><a href="https://github.com/nordmoen">nordmoen</a> is working on their driver for the <a href="https://github.com/nordmoen/hc-sr04">hc-sr04</a> ultrasonic distance sensor</li> </ul> <h3 id="embedded-hal-board-chip-support-crates"><code>embedded-hal</code> Board/Chip Support Crates</h3> <ul> <li><a href="https://github.com/DoumanAsh">DoumanAsh</a> has started work on their <a href="https://github.com/DoumanAsh/stm32l4x6_hal">stm32l4x6-hal</a> chip support crate</li> </ul> <h2 id="thanks">Thanks</h2> <ul> <li>Thanks to all of the Rust Team and Working Group members who took time at the All Hands to tackle some important Embedded Issues</li> <li>Thanks to <a href="https://github.com/alexcrichton">Alex Chrichton</a> who pushed a fix to a <a href="https://github.com/rust-lang/rust/pull/49316">linker issue</a> mentioned in our <a href="https://github.com/rust-lang-nursery/embedded-wg/blob/master/newsletters/2018-03-15.md">last newsletter</a></li> </ul> <h2 id="help-wanted">Help Wanted</h2> <ul> <li><a href="https://github.com/SimonSapin">Simon Sapin</a> posted some working code for the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39#issuecomment-375262785">DS3234</a> SPI RTC, and is looking for someone to turn it into a maintained crate!</li> </ul> <p>If you have an embedded project that could use contributors or maintainers, leave a comment for <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/72">the next newsletter</a>!</p> <h1 id="special-feature-the-embedded-wg-at-the-2018-rust-all-hands">Special Feature: The Embedded WG at the 2018 Rust All Hands</h1> <p>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.</p> <p>These are the highlights of our talks.</p> <h2 id="embedded-rust-on-stable">Embedded Rust on stable</h2> <p>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:</p> <h3 id="unstable-feature-1-xargo">Unstable Feature #1: <code>xargo</code></h3> <p>We'll ship a rust-std component (pre-compiled <code>core</code>+<code>compiler-builtins</code>) for the <code>thumb*</code> and <code>msp430</code> targets. This removes the need for <code>xargo</code> so people will be able to do something like the following to cross compile to ARM Cortex-M:</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">rustup</span><span> target add thumb7m-none-eabi </span><span style="color:#bf616a;">cargo</span><span> build</span><span style="color:#bf616a;"> --target</span><span> thumbv7m-none-eabi </span></code></pre> <p><strong>Tracking issue</strong>: <a href="https://github.com/rust-lang/rust/issues/49382">rust-lang/rust#49382</a>.</p> <h3 id="unstable-feature-2-compiler-builtins">Unstable Feature #2: <code>compiler-builtins</code></h3> <p><code>extern crate compiler_builtins</code> is unstable to directly use. The fix we have decided on is to inject that as part of the prelude you get from <code>#![no_std]</code>.</p> <p>So, today <code>#![no_std]</code> expands to something like this:</p> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span>#![</span><span style="color:#bf616a;">no_std</span><span>] </span><span style="color:#b48ead;">extern crate</span><span> core; </span></code></pre> <p>With our change the expansion will run like this:</p> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span>#![</span><span style="color:#bf616a;">no_std</span><span>] </span><span style="color:#b48ead;">extern crate</span><span> core; </span><span> </span><span style="color:#65737e;">// but this doesn&#39;t #![feature(compiler_builtins_lib)] </span><span style="color:#b48ead;">extern crate</span><span> compiler_builtins; </span></code></pre> <p>In the future we might want to merge <code>compiler-builtins</code> into <code>core</code> but that requires more effort and can still be done if we do the <code>#![no_std]</code> prelude approach right now.</p> <p><strong>Tracking issue:</strong> <a href="https://github.com/rust-lang/rust/issues/49380">rust-lang/rust#49380</a></p> <h3 id="unstable-feature-3-panic-fmt">Unstable Feature #3: <code>panic_fmt</code></h3> <p>There's an accepted RFC (#2070) for a stable mechanism to select the behavior of <code>panic!</code> in <code>no_std</code> context, and there's a know issue where the arguments of <code>panic_fmt</code> are kept in the binary even when they are unused by the <code>panic_fmt</code> implementation (cf. <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/41">rust-lang/embedded-wg#41</a>).</p> <p>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. <a href="https://github.com/nagisa">nagisa</a> will likely propose an alternate solution that involves having Cargo select the panic provider crate.</p> <h2 id="non-critical-unstable-features">Non critical unstable features</h2> <p>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.</p> <h3 id="unstable-feature-4-const-fn">Unstable Feature #4: <code>const fn</code></h3> <p>This feature has been proposed for stabilization (cf. <a href="https://github.com/rust-lang/rust/issues/24111#issuecomment-376649804">rust-lang/rust#24111</a>).</p> <h3 id="unstable-feature-5-asm">Unstable Feature #5: <code>asm!</code></h3> <p><strong>Background</strong>: 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 <code>asm!</code> macro.</p> <p>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 <em>some</em> 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 <code>core::asm::$ARCH</code> module and they could either be implemented by lowering to a LLVM intrinsic or using inline assembly. For example:</p> <pre data-lang="rust" style="background-color:#2b303b;color:#c0c5ce;" class="language-rust "><code class="language-rust" data-lang="rust"><span style="color:#b48ead;">pub mod </span><span>asm { </span><span> </span><span style="color:#b48ead;">pub mod </span><span>arm { </span><span> #[</span><span style="color:#bf616a;">inline</span><span>(always)] </span><span> </span><span style="color:#b48ead;">pub fn </span><span style="color:#8fa1b3;">cpsid</span><span>() { </span><span> </span><span style="color:#b48ead;">unsafe </span><span>{ </span><span> asm!(&quot;</span><span style="color:#a3be8c;">cpsid i</span><span>&quot; ::: &quot;</span><span style="color:#a3be8c;">memory</span><span>&quot; : &quot;</span><span style="color:#a3be8c;">volatile</span><span>&quot;); </span><span> } </span><span> } </span><span> } </span><span>} </span></code></pre> <p>These would be stable APIs with an unstable implementation. If LLVM assembler syntax changes, the implementations of these functions would have to be updated.</p> <p>The embedded WG will submit an RFC proposing the <code>asm</code> module and that will include a list of assembly operations that (a) are common and (b) need to be inlined for different architectures.</p> <h3 id="unstable-feature-6-used">Unstable Feature #6: <code>#[used]</code></h3> <p>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 / <code>static</code> that needs to be in the final binary.</p> <p>We'll try to get it stabilized by the edition release but it's not a high priority feature.</p> <h2 id="stability-of-the-embedded-targets">Stability of the Embedded Targets</h2> <p>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.</p> <p>That effectively will make some of the embedded targets into the tier 1 platform. The core team is fine with adding the <code>thumb*</code> 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.</p> <p>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:</p> <ul> <li>It compiles and links</li> <li>Runs the cross compiled binary in QEMU doesn't crash and exits with exit code 0.</li> <li>Tracking the binary size of a program compiled with <code>-Os</code> / <code>-Oz</code> and notify someone or fail the build if the size changes by +/- 5-10% or something.</li> </ul> <h2 id="llvm-backends-that-are-not-yet-in-rustc">LLVM backends that are not yet in rustc</h2> <p>There are two embedded LLVM backends that have not yet been enabled in rustc for different reasons: AVR and RISCV.</p> <p>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 <code>#[cfg]</code> attributes to remove 128-bit integers and other things like float APIs.</p> <p>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.</p> <h2 id="tooling">Tooling</h2> <p>Getting tooling for e.g. binary inspection (e.g. <code>objdump</code>) 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:</p> <ul> <li>We put these tools in the sysroot and have them always shipped with the Rust toolchain so no <code>rustup component add</code> required -- this is already the case with <code>lld</code>. 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.</li> <li>We do <em>not</em> add these tools to the user <code>$PATH</code>. Instead some Cargo subcommand will be created by the embedded WG (e.g. <code>cargo objdump</code>) and that subcommand will look for <code>llvm-objdump</code> in the sysroot and do the right thing.</li> <li>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.).</li> </ul> <h3 id="the-embedded-rust-book">The Embedded Rust Book</h3> <p>We decided on an initial audience for the embedded book; we will be targeting people that know some embedded stuff <em>and</em> 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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/56">rust-lang-nursery/embedded-wg#56</a>.</p> Thu, 15 Mar 2018 00:00:00 +0000 https://blog.rust-embedded.org/newsletter-1/ https://blog.rust-embedded.org/newsletter-1/ <p>This is the first newsletter of the <a href="https://github.com/rust-lang-nursery/embedded-wg">Embedded WG</a>! 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!</p> <span id="continue-reading"></span> <p>If you want to mention something in <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/65">the next newsletter</a>, make sure to leave a comment on the issue!</p> <h2 id="highlights">Highlights</h2> <ul> <li><a href="https://github.com/helena-project/tock">Tock-OS</a> has released the <a href="https://www.tockos.org/blog/2018/talking-tock-35/">1.0 of their kernel</a>, gotten the Rust Userspace library back in order, and are working on a <a href="https://www.tockos.org/blog/2018/talking-tock-36/">new register interface</a></li> <li><a href="https://github.com/Emilgardis">Emilgardis</a>, <a href="https://github.com/jamesmunns">jamesmunns</a> and <a href="https://github.com/ryankurte">ryankurte</a> have become collaborators of the <a href="https://github.com/japaric/svd">svd</a> and <a href="https://github.com/japaric/svd2rust">svd2rust</a> projects.</li> <li><a href="https://github.com/hannobraun">hannobraun</a>, <a href="https://github.com/ilya-epifanov">ilya-epifanov</a>, <a href="https://github.com/thejpster">thejpster</a>, <a href="https://github.com/therealprof">therealprof</a> have become collaborators of the <a href="https://github.com/japaric/embedded-hal">embedded-hal</a> project.</li> <li><a href="https://github.com/dvc94ch">dvc94ch</a> has created the <a href="https://github.com/riscv-rust">riscv-rust</a> organization for all your embedded RISCV needs!</li> <li><a href="https://github.com/dylanmckay">dylanmckay</a> has begun <a href="https://github.com/avr-rust/rust/pull/91">rebasing</a> the avr-rust/rust fork onto a recent rust-lang/rust version, bringing in LLVM 6.0 support.</li> </ul> <h2 id="embedded-projects">Embedded Projects</h2> <p>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/65">the next newsletter</a>, we would love to show it off!</p> <h3 id="embedded-hal-drivers"><code>embedded-hal</code> drivers</h3> <p>This is a list of recently released drivers that are part of the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/39">Weekly Driver Initiative</a>. There are currently 5 Released Drivers, 14 WIP Drivers, and lots of TODOs!</p> <ul> <li><a href="https://github.com/pcein">pcein</a> has <a href="http://pramode.in/2018/02/24/an-introduction-to-writing-embedded-hal-based-drivers-in-rust/">released</a> the third weekly driver for the <a href="https://crates.io/crates/adc-mcp3008"><code>adc-mcp3008</code></a>, an 8-channel 10-bit ADC.</li> <li><a href="https://github.com/japaric">japaric</a> has <a href="http://blog.japaric.io/wd-4-enc28j60/">released</a> the fourth weekly driver for the <a href="https://crates.io/crates/enc28j60"><code>enc28j60</code></a>, an Ethernet controller with SPI interface.</li> <li><a href="https://github.com/dbrgn">dbrgn</a> has <a href="https://blog.dbrgn.ch/2018/3/13/rust-mcp3425-driver/">released</a> the fifth weekly driver for the <a href="https://crates.io/crates/mcp3425"><code>mcp3425</code></a>, a 16-bit ADC with I2C interface.</li> </ul> <h2 id="thanks">Thanks</h2> <ul> <li>Thanks to everyone who has been commenting on the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues">Embedded WG Issues</a>, especially for the <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/56">Embedded Rust Book</a> tracking issue!</li> <li><a href="https://github.com/varkor">varkor</a> has fixed a <a href="https://github.com/rust-lang/rust/issues/41315">long standing LLVM bug</a>, that artificially increased the binary size of Rust programs, and backported the patch to rustc.</li> <li>LLD is now being shipped with the Rust toolchain. <a href="https://github.com/FenrirWolf">FenrirWolf</a> <a href="https://github.com/japaric/xargo/pull/200">patched Xargo</a> so that Xargo users can make use of it too.</li> </ul> <h2 id="help-wanted">Help Wanted</h2> <p>If you have an embedded project that could use contributors or maintainers, leave a comment for <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/65">the next newsletter</a>!</p> <ul> <li>We are <a href="https://github.com/japaric/cortex-m-rt/issues/53">pretty close</a> to being able to use LLD to link Rust programs compiled for ARM Cortex-M but there are some <a href="https://github.com/japaric/cortex-m-rt/issues/53#issuecomment-371972935">LLD bugs</a> that still need to be fixed. Help reporting these bugs upstream would be greatly appreciated!</li> <li>Incremental compilation is in the roadmap for this year but it doesn't work with <code>no_std</code> binaries due to an <a href="https://github.com/rust-lang/rust/issues/18807">old rustc bug</a> related to linking. Help us fix it! There's a proposed solution <a href="https://github.com/rust-lang/rust/issues/47074#issuecomment-354588718">here</a>.</li> <li>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 <a href="https://github.com/rust-lang-nursery/embedded-wg/issues/63">#63</a>.</li> </ul>