https://github.com/luojia65/gd32vf103-hal

Hardware abstract layer (HAL) `embedded-hal` for RISC-V microcontroller GD32VF103 in Rust. Contributions welcomed!
https://github.com/luojia65/gd32vf103-hal

embedded-hal gd32v gd32vf103 microcontroller risc-v rust rust-embedded

Last synced: 3 months ago
JSON representation

Hardware abstract layer (HAL) `embedded-hal` for RISC-V microcontroller GD32VF103 in Rust. Contributions welcomed!

• Host: GitHub
• URL: https://github.com/luojia65/gd32vf103-hal
• Owner: gd32v-rust
• License: mit
• Created: 2019-09-06T04:03:13.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2021-12-28T04:26:47.000Z (almost 3 years ago)
• Last Synced: 2024-04-14T10:20:36.764Z (7 months ago)
• Topics: embedded-hal, gd32v, gd32vf103, microcontroller, risc-v, rust, rust-embedded
• Language: Rust
• Homepage:
• Size: 216 KB
• Stars: 60
• Watchers: 13
• Forks: 16
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-MIT

Awesome Lists containing this project

• rust-embedded - `gd32vf103-hal` - [](https://crates.io/crates/gd32vf103-hal) (HAL implementation crates / GigaDevice)
• awesome-embedded-rust - `gd32vf103-hal` - [](https://crates.io/crates/gd32vf103-hal) (HAL implementation crates / GigaDevice)

README

        
# `gd32vf103-hal`

> Hardware abstract layer ([HAL]) for the GD32VF103 RISC-V microcontroller

[HAL]: https://crates.io/crates/embedded-hal

[![crates.io](https://img.shields.io/crates/v/gd32vf103-hal.svg)](https://crates.io/crates/gd32vf103-hal)

[![Released API docs](https://docs.rs/gd32vf103-hal/badge.svg)](https://docs.rs/gd32vf103-hal)

This project is under early stage development; you may find example project and images [here](https://github.com/luojia65/example-gd32vf103).

Matrix: [#gd32v-rust:matrix.org](https://matrix.to/#/#gd32v-rust:matrix.org)

See also: [gd32vf103xx-hal](https://github.com/riscv-rust/gd32vf103xx-hal)

## Use this project

To use this HAL project, you may need Rust installed. Checkout `rustup.rs` if you don't have one.

You do not need to install GNU toolchain if you are an application developer.

Examples may be found at [`gd32vf103-example`](https://github.com/gd32v-rust/gd32vf103-example).

## Helps on assembling

ALERT: this section is only for HAL project itself. If you are an application developer, you do not

need to build this binary by yourself.

The assemble script requires you have `riscv32imac-unknown-elf-gcc` installed.

Configure and compile GNU toolchain using:

```shell

../configure --prefix=/opt/riscv32 --with-arch=rv32imac --with-abi=ilp32

```

```shell

make && make install

```

Run assemble script: (run on any path is okay)

```shell

./assemble.sh

```

## License

This project is licensed under either of

- MIT license ([LICENSE-MIT](LICENSE-MIT) or [http://opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))

- Mulan PSL v1 ([LICENSE-MULAN](LICENSE-MULAN) or [http://license.coscl.org.cn/MulanPSL](http://license.coscl.org.cn/MulanPSL))