https://github.com/fudanchii/imtomu-rs

Program Tomu board with Rust
https://github.com/fudanchii/imtomu-rs

Last synced: about 2 months ago
JSON representation

Program Tomu board with Rust

• Host: GitHub
• URL: https://github.com/fudanchii/imtomu-rs
• Owner: fudanchii
• License: bsd-2-clause
• Created: 2018-12-01T19:19:48.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-08-26T02:52:57.000Z (over 2 years ago)
• Last Synced: 2024-08-01T00:37:15.862Z (4 months ago)
• Language: Rust
• Size: 440 KB
• Stars: 19
• Watchers: 7
• Forks: 9
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• rust-embedded - `tomu-hal`
• awesome-embedded-rust - `tomu-hal`

README

        
imtomu-rs

---

Board support crate targeted for [Tim's Open Micro USB](http://tomu.im/)

Includes support for tomu-bootloader config (toboot v2).

work in progress

- [X] toboot config

- [ ] timers

- [X] GPIO (most of the functionality is implemented)

- [ ] USB

- [ ] AES

dependencies

---

To build embedded programs using this template you'll need:

- Rust stable, ie 1.31 or a newer toolchain.

- `rust-std` components (pre-compiled `core` crate) for the ARM Cortex-M

  targets. Run:

``` console

$ rustup target add thumbv6m-none-eabi

```

- llvm-tools-preview for `llvm-objcopy` to turn the elf into a binary for uploading. Run:

``` console

$ rustup component add llvm-tools-preview

```

- The [dfu-util](https://tomu.im/update#installing-dfu-util)

usage

---

```

cargo run --example blink --release

```

toboot config

---

Application can interact with tomu bootloader by using `toboot_config` macro.

It's fully typesafe so there's no need to worry you're putting wrong config. It will even warns you if you're trying to lock bootloader entry like this:

```rust

toboot_config! {

    lock_entry: true,

}

```

![warns](https://f4.fudan.ch/shx/putty_(3)_2019-01-28_13-43-45.png)

Full config as the following:

```rust

toboot_config! {

    config: [autorun_enable, irq_enable],

    lock_entry: false,

    // efm32hg309f64 has 64KiB flash memory,

    // each bit below represent 1 sector (1KiB)

    // which will be erased when tomu load its bootloader

    erase_mask_lo: 0, // 32bit uint

    erase_mask_hi: 0, // 32bit uint

}

```

Toboot api ref: [here](https://github.com/im-tomu/tomu-bootloader/blob/master/API.md).

examples

---

There are some examples on how to use tomu in examples folder.

license

---

Licensed under 2-clause BSD.