Skip to content

Commit

Permalink
Update links due to repo transfer (#31)
Browse files Browse the repository at this point in the history
  • Loading branch information
andelf authored Sep 19, 2024
1 parent 7081f0a commit 661bb0c
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 18 deletions.
2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name = "hpm-hal"
version = "0.0.1"
edition = "2021"
authors = ["Andelf <[email protected]>"]
repository = "https://github.com/hpmicro-rs/hpm-hal"
repository = "https://github.com/hpmicro/hpm-hal"
documentation = "https://docs.rs/hpm-hal"
homepage = "https://github.com/hpmicro/hpm-hal"
categories = ["embedded", "hardware-support", "no-std"]
Expand Down
37 changes: 20 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
# hpm-hal

A Rust HAL implementation for the HPMicro's RISC-V MCUs.
A Rust HAL and [Embassy](https://embassy.dev/) driver implementation for the HPMicro's RISC-V MCUs.
The PAC(Peripheral Access Crate) is based on [hpm-data].

This crate is a working-in-progress and not ready for use.
This crate is a working-in-progress and not ready for production use.

## Project status
## Support Status

### MCU Family Support

| MCU Family | PAC | Demo | Embassy | SYSCTL | GPIO | UART | I2C | SPI | DMA | TMR | ADC | USB | CAN |
|------------|-----|------|---------|--------|------|------|-----|-----|-----|-----|-----|-----|-----|
| HPM6700 ||||| ✓+ | ✓+ | ✓+ | ✓+ | ✓+ | | | | |
| HPM6300 ||||| | | | | | | | | |
| HPM6300 ||||| ? | ? | ? | ? | ? | | | | |
| HPM6200 || | | | | | | | | | | | |
| HPM5300 ||||| ✓+ | ✓+ | ✓+ | ✓+ | ✓+ | ||||
| HPM6800 || | | | | | | | | | | | |
Expand All @@ -24,7 +24,7 @@ This crate is a working-in-progress and not ready for use.
- Blank: Not implemented
- +: Async support

### Peripherals
### Peripheral Support

- [x] Basic rt code: linker, startup
- [x] vectored interrupt handling
Expand Down Expand Up @@ -71,18 +71,19 @@ This crate is a working-in-progress and not ready for use.
- [x] SDRAM init
- [x] MCAN
- [x] basic `mcan` wrapper
- ~~[ ] async driver~~, better impl it in the App layer, see Mi motor demo
- ~~[ ] async driver~~, better impl it in the App layer, see XiaoMi CyberGear motor demo
- [ ] TSU management
- [x] USB via embassy-usb
- [x] Device
- [ ] Host
- [x] XPI NOR flash driver using embedded-storage
- [ ] power domain handling

### Long term Plans
### Related Crates

- [x] [andes-riscv] for specific CSRs
- [ ] hpm-riscv-rt for customized runtime (riscv-rt is not fit)
- [ ] power domain handling
- [x] [andes-riscv] for Andes' specific CSRs
- [x] [hpm-data] and [hpm-metapac] for Chip metadata and PAC generation
- [ ] hpm-riscv-rt for customized runtime (riscv-rt does not fit)

### Toolchain Support

Expand Down Expand Up @@ -129,22 +130,23 @@ The best reference is the examples in the `examples` directory and Github action
#### Step 1. Prepare Rust Toolchain

```bash
rustup default nightly
# lock to 2024-08-23 and wait for embassy-executor to be updated
rustup default nightly-2024-08-23
rustup target add riscv32imafc-unknown-none-elf
```

#### Step 2. Clone this repo

```bash
git clone https://github.com/hpmicro-rs/hpm-hal.git
git clone https://github.com/hpmicro/hpm-hal.git

# Or if you are using SSH

git clone [email protected]:hpmicro-rs/hpm-hal.git
git clone [email protected]:hpmicro/hpm-hal.git

# Or if you are using GitHub CLI

gh repo clone hpmicro-rs/hpm-hal
gh repo clone hpmicro/hpm-hal
```

#### Step 3. Run Examples
Expand All @@ -166,7 +168,7 @@ cargo run --release --bin blinky
## License

Embassy is licensed under either of
This repo is licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
<http://www.apache.org/licenses/LICENSE-2.0>)
Expand All @@ -178,8 +180,9 @@ at your option.

This crate is under active development. Before starting your work, it's better to create a "Work in Progress" (WIP) pull request describing your work to avoid conflicts.

[hpm-data]: https://github.com/andelf/hpm-data
[hpm-data]: https://github.com/hpmicro/hpm-data
[HPM OpenOCD]: https://github.com/hpmicro/riscv-openocd
[probe-rs]: https://github.com/probe-rs/probe-rs
[probe-rs HPM fork]: https://github.com/hpmicro-rs/probe-rs
[probe-rs HPM fork]: https://github.com/hpmicro/probe-rs
[andes-riscv]: https://github.com/hpmicro-rs/andes-riscv
[hpm-metapac]: https://docs.rs/hpm-metapac/latest/hpm_metapac

0 comments on commit 661bb0c

Please sign in to comment.