alex/rp-hal-boards
1
0
Fork 0
mirror of https://github.com/italicsjenga/rp-hal-boards.git synced 2024-12-24 05:01:31 +11:00
Code Issues Packages Projects Releases Wiki Activity
rp-hal-boards/rp2040-hal
History
Mathias Gottschlag 4db944ad4e pio: Fix clippy warnings and examples in doc comments.
2021-10-01 18:41:10 +02:00
..
examples pio: Split RX and TX FIFO functions into different types. 2021-09-30 09:07:15 +02:00
src pio: Fix clippy warnings and examples in doc comments. 2021-10-01 18:41:10 +02:00
.gitignore Initial Commit: Updated author information. 2021-01-22 09:18:12 -05:00
Cargo.toml pio: Improve documentation and add an example that uses pio_proc::pio!(). 2021-09-28 21:48:05 +02:00
README.md Addressing review comments. 2021-09-28 09:26:31 +01:00

README.md


Logo

rp-hal

High-level Rust drivers for the Raspberry Silicon RP2040 Microcontroller
Explore the API docs »

View Demos · Report a Bug · Chat on Matrix

Table of Contents
  1. Introduction
  2. Getting Started
  3. Roadmap
  4. Contributing
  5. License
  6. Contact
  7. Acknowledgements

Introduction

This is the rp2040-hal package - a library crate of high-level Rust drivers for the Raspberry Silicon RP2040 microcontroller, along with a collection of non-board specific example programs for you to study. You should use this crate in your application if you want to write code for the RP2040 microcontroller. The HAL in the name standards for Hardware Abstraction Layer, and comes from the fact that many of the drivers included implement the generic hardware-abstraction interfaces defined in the Rust Embedded Working Group's embedded-hal crate.

We also provide a series of Board Support Package (BSP) crates, which take this HAL crate and pre-configure the pins according to a specific PCB design. If you are using on of the supported boards, you should use one of those crates in preference, and return here to see documentation about specific peripherals on the RP2040 and how to use them. See the boards folder in https://github.com/rp-rs/rp-hal/ for more details.

Getting Started

To include this crate in your project, amend your Cargo.toml file to include

rp2040-hal = "0.3"

To obtain a copy of the source code (e.g. if you want to propose a bug-fix or new feature, or simply to study the code), run:

$ git clone https://github.com/rp-rs/rp-hal.git

For details on how to program an RP2040 microcontroller, see the top-level rp-hal README.

Roadmap

NOTE This HAL is under active development. As such, it is likely to remain volatile until a 1.0.0 release.

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT OR Apache2.0 License. See MIT or APACHE2.0 for more information.

Contact

Project Link: https://github.com/rp-rs/rp-hal/issues Matrix: #rp-rs:matrix.org

Acknowledgements