mirror of
https://github.com/saymrwulf/xous-core.git
synced 2026-11-18 08:52:45 +00:00
bump rev and update readme
This commit is contained in:
parent
fad43a1e0f
commit
b97a2f7042
2 changed files with 45 additions and 6 deletions
|
|
@ -1,6 +1,6 @@
|
||||||
[package]
|
[package]
|
||||||
name = "utralib"
|
name = "utralib"
|
||||||
version = "0.1.0"
|
version = "0.1.1"
|
||||||
authors = ["Sean Cross <sean@xobs.io>", "bunnie <bunnie@kosagi.com>"]
|
authors = ["Sean Cross <sean@xobs.io>", "bunnie <bunnie@kosagi.com>"]
|
||||||
edition = "2018"
|
edition = "2018"
|
||||||
license = "MIT OR Apache-2.0"
|
license = "MIT OR Apache-2.0"
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,46 @@
|
||||||
# UTRA
|
# UTRA (Unambiguous Thin Register Abstraction) Library Crate
|
||||||
|
|
||||||
The meat of this directory is auto-generated by svd2utra. Documentation
|
`utralib` is responsible for mapping a hardware target specification
|
||||||
on this API is also located in that directory.
|
to the set of physical memory locations used by the hardware.
|
||||||
|
|
||||||
The UTRA is published to crates.io to correspond to a given SoC version
|
The mapping is derived from an [SVD](https://www.keil.com/pack/doc/CMSIS/SVD/html/svd_Format_pg.html)
|
||||||
so that crates may depend upon it without referring to a local path.
|
file. SVD files are XML descriptions of a set of registers and fields that
|
||||||
|
has been adopted by LiteX, but is also broadly used by other silicon
|
||||||
|
vendors such as [ST](https://github.com/tinygo-org/stm32-svd).
|
||||||
|
|
||||||
|
Rust strongly discourages [auto-generated source content](https://github.com/rust-lang/cargo/issues/5073)
|
||||||
|
so this crate pre-generates the various configurations from SVD files
|
||||||
|
and stores them in the directory "generated".
|
||||||
|
|
||||||
|
However, the generated UTRA descriptions will automatically
|
||||||
|
regenerate if the source SVD files are modified, so during development
|
||||||
|
one may replace an SVD file and expect that the generated.rs files
|
||||||
|
should automatically update to reflect the changed SVD file.
|
||||||
|
|
||||||
|
## Target selection
|
||||||
|
|
||||||
|
Target selection is done with a pair of flags, one which specifies
|
||||||
|
the general target, and the other which whittles it down to a revision
|
||||||
|
of the target.
|
||||||
|
|
||||||
|
For traditional silicon platforms, the revision almost never changes.
|
||||||
|
For FPGA platforms, the revision can change and the convention adopted
|
||||||
|
here is to use the short 32-bit gitrev to specify a revision. Because
|
||||||
|
the 32-bit namespace is fairly small, the target name is still bundled
|
||||||
|
in with the revision specifier.
|
||||||
|
|
||||||
|
Thus, to fully specify a Precursor target, one will need to pass two
|
||||||
|
flags:
|
||||||
|
|
||||||
|
- `--features precursor`: specifies the target
|
||||||
|
- `--features precursor-c809403`: specifies the revision
|
||||||
|
|
||||||
|
The target specifier is meant to simplify top-level crate decisions
|
||||||
|
about which module to use to implement hardware features.
|
||||||
|
|
||||||
|
The revision is provided for very specific situations where a hardware
|
||||||
|
feature may or may not be present in a specific revision of an FPGA SoC.
|
||||||
|
|
||||||
|
The feature system could also be (ab)used to, for example, specify
|
||||||
|
an STM32 family and then the specific chip configuration of that family
|
||||||
|
with the revision.
|
||||||
Loading…
Reference in a new issue