Open source

Open source

Every public crate, from register to GUI: what it does, a code sample and where to read more.

1. ProductsDonguru · rePort · CAN line · IOWeaver · RockFace
2. API
   

   wire_weaver

   v0.4.0 · 866 downloads

   API description language and code generator: RPC, streams and properties, backwards and forwards compatible, no_std and no alloc.

   Source · Docs · docs.rs

   #[ww_trait]
   #[claim(exclusive)]
   pub trait Uart {
       #[counted]
       stream!(rx: RxChunk<'i>);
   
       #[credit]
       sink!(tx: MaxLen<RefVec<'i, u8>, UART_TX_MAX>);
   
       fn capabilities() -> Capabilities<'i>;
   }

3. Wire format
   

   shrink_wrap

   v0.1.2 · 1,699 downloads

   Compact zero-copy wire format for microcontrollers. No allocator, dynamic types, packed down to the bit.

   Source · docs.rs

   let mut buf = [0u8; 256];
   let mut wr = BufWriter::new(&mut buf);
   wr.write_bool(true).unwrap();
   wr.write_u8(0xaa).unwrap();
   let bytes = wr.finish().unwrap();
   assert_eq!(bytes, &[0x80, 0xaa]); // the bool takes one bit

4. Units
   

   exact_units

   not on crates.io yet

   Units of measure checked at compile time, with exact scales. The same bytes as the plain integer, no_std and no alloc.

   Source · Docs

   // exact or refused, never rounded through a float
   let t: Micros<u32> = Fixed::new(1500);
   assert_eq!(t.to::<Milli, u16>(), None); // 1500 µs is not a whole number of ms
   
   // zero cost: the type is the integer
   assert_eq!(size_of::<Micros<u32>>(), size_of::<u32>());

5. Firmware

   embedded_bedrock

   not on crates.io yet

   Bare-metal firmware template with ruggedizing, debugging and logging built in. Optional embassy, RTIC and HAL support.

   Source

   use bedrock_led::code::{blink, Code};
   
   // A firmware that won't start says why on its status LED,
   // then waits in the ROM bootloader to be flashed.
   if !guard.runs_board() {
       blink(Code::UnknownRework, |on| led_pin_set(on), |ms| cortex_m::asm::delay(ms * BOOT_CLOCK_KHZ));
       reboot_into_rom_bootloader();
   }

6. Firmware

   canzone work in progress

   renamed from mcan, not on crates.io yet

   Stand-alone Rust driver for the Bosch M_CAN controller, aimed at STM32 G0, G4, H5, H7 and L5. Goals: no panics, no blocking waits without a timeout, optional async.

   Source

   let mut can = unwrap!(can.into_config_mode());
   can.set_nominal_bit_timing(unwrap!(NominalBitTiming::new(1, 55, 8, 1)));
   unwrap!(can.set_layout(layout_fdcan1));
   can.set_automatic_bus_off_recovery(true);
   let mut can = unwrap!(can.into_normal());
   
   can.write_tx_buffer_pend(
       tx_buffers.idx1,
       TxFrameHeader::fd_brs(Id::Standard(unwrap!(StandardId::new(0x123)))),
       &[0xAA, 0xBB, 0xCC],
   );

7. Test bench

   choreograph

   not on crates.io yet

   Plans and runs jobs over shared instruments and resources, with priorities and deadlines. Says why each waiting job waits.

   Source

   [[resource]]
   name = "supply"
   kind = "supply"
   states = ["off", "3V0", "3V3", "3V6"]
   safe = "off"
   
   [[job]]
   name = "a-3V3"
   needs = [{ kind = "probe", state = "fw-a" }, { kind = "supply", state = "3V3" }]
   run = "10s"

8. GUI

   egui_tabular

   v0.2.0 · 41 downloads

   Fast table viewer and editor that only draws the visible rows. Data from vectors, files, databases or live bus traces.

   Source · docs.rs

   let mut table = VariantTable::new([ColumnDef::new("Name", VariantTy::Str)]);
   let mut view = TableView::new(TableViewOptions::default());
   let mut config = TableViewConfig::default();
   
   // Every frame:
   let output = view.show(ui, &mut table, &mut VariantCellUi, &mut config);

9. GUI

   vhrd_egui

   not on crates.io yet

   egui building blocks: the widget frame every panel sits in, a dock that moves widgets between windows, an HDR phosphor scope.

   Source

   let hints = SizeHints::new([90.0, 30.0], [200.0, 80.0], [360.0, 80.0]).tall(200.0);
   WidgetFrame::new("log")
       .sizes(hints)
       .show_area(ui, &mut state, |ui, area| {
           let rows = match area.height {
               Height::Min => 1,
               Height::Nom => 5,
               Height::Tall => 15,
           };
       });