[![crates.io](https://img.shields.io/crates/d/jh71xx-pac.svg)](https://crates.io/crates/jh71xx-pac)
[![crates.io](https://img.shields.io/crates/v/jh71xx-pac.svg)](https://crates.io/crates/jh71xx-pac)
[![Build Status](https://ci.codeberg.org/api/badges/13179/status.svg)](https://ci.codeberg.org/repos/13179)

# JH71xx Peripheral Access Crate

Development has moved to Codeberg: <https://codeberg.org/weathered-steel/jh71xx-pac>

Low-level access crates for JH71xx-based SoCs. Currently, only the JH7110 SoC is supported.

The JH7100 SoC is discontinued, and the next SoC in the JH-series will be the JH8110.

**WARNING** This crate is in the very earliest stages of development. SVD files used to generate the Rust code are partially hand-crafted from referencing the [JH7110 Technical Reference Manual, preliminary release V2](https://doc-en.rvspace.org/JH7110/PDF/JH7110_TRM_StarFive_Preliminary_V2.pdf). Any mistakes are my own, and reviews/contributions are welcome.

## Generating Rust Code from SVD

Code generation uses the [`svd-generator`](https://crates.io/crates/svd-generator) tool, a Rust port of [`cmsis-svd-generator`](https://github.com/sifive/cmsis-svd-generator) from SiFive.

### Requirements:

- [dtc](https://github.com/dgibson/dtc)
- [rustfmt](https://crates.io/crates/rustfmt)
- [svd-generator](https://crates.io/crates/svd-generator)
- [svd2rust](https://crates.io/crates/svd2rust)
  - or [chiptool](https://github.com/embassy-rs/chiptool) (experimental)

To regenerate/update the Rust code:

```bash
$ bash ./generate.sh
```