#embedded #embedded-hal #no-std #compat #compatibility

no-std embedded-hal-compat

Compatibility layer for interoperability between different embedded-hal versions

7 releases

new 0.3.0 Jun 16, 2021
0.2.1 Jun 10, 2021
0.2.0 May 28, 2021
0.1.3 Mar 6, 2021
0.1.1 Feb 21, 2021

#58 in Hardware support

Download history 20/week @ 2021-02-26 53/week @ 2021-03-05 897/week @ 2021-03-12 1131/week @ 2021-03-19 463/week @ 2021-03-26 172/week @ 2021-04-02 117/week @ 2021-04-09 152/week @ 2021-04-16 56/week @ 2021-04-23 104/week @ 2021-04-30 28/week @ 2021-05-07 19/week @ 2021-05-14 198/week @ 2021-05-21 1214/week @ 2021-05-28 1685/week @ 2021-06-04 469/week @ 2021-06-11

1,933 downloads per month

MIT license

452 lines

Embedded HAL Compatibility Layer

A forward compatibility layer to smooth the transition between different versions of embedded-hal (specifically 0.2.x and 1.0.0-alpha.X series).

This resolves the problem where a HAL implementation (ie. the implementation for your processor) is still published at 0.2.x, and a driver expects 1.0.0-alpha.x. In the opposite situation, please fork and update the driver.


GitHub tag Build Status Crates.io Docs.rs

Work in progress, blocking objects implemented, missing nb things as well as any reasonable documentation.

How to use this:

  • Add embedded-hal-compat to your dependencies
  • Import with use embedded_hal_compat::IntoCompat;
  • Vicariously add .compat() on any embedded-hal outstanding type errors

How do I know that I need this?

Type errors. Lots of type errors.

(and cargo tree -i embedded-hal returns two versions)

Is this cursed?!

Yes. You're gonna end up with lots of cursed errors but at least you can compile things?

What kind of errors?

Because you'll have symbols with the same name you'll end up with errors like:

error[E0599]: no method named `delay_ms` found for mutable reference `&mut Compat<atsamd_hal::delay::Delay>` in the current scope
   --> src/main.rs:351:27
351 |         tlv.inner_delay().delay_ms(10u32);
    |                           ^^^^^^^^ method not found in `&mut Compat<atsamd_hal::delay::Delay>`

warning: unused import: `embedded_hal::blocking::delay::DelayMs`
  --> src/main.rs:22:5
22 | use embedded_hal::blocking::delay::DelayMs;
   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Suggesting you're missing an import that's obviously there, because you have the 0.2.x imports not the 1.0.0-alpha.x imports, and the method is called try_delay_ms in the updated HAL (a fairly common renaming).

You can fix this by importing the correct trait with something like: use embedded_hal_compat::eh1_0::blocking::delay::{DelayMs as _}; (this must be renamed with as / you can't use the prelude because the names overlap), and by swapping the method to use the correct try_ name.