rp-hal-boards/boards/pico
Wilfried Chauveau 990d964a93
Implement peripheral support for i2c and an advanced example (#162)
* Implement peripheral support for i2c and an advanced example for the pico board.

* Simplify i2c peripheral bootstrap and add a "free" function to allow switching modes.

* Set dependency to futures & nostd_async to specific version/revision.

* move enum & struct to the start of the file

* Add a bit of documentation to the pico_i2c_controller_peripheral demo.

* Migrate to pico_i2c_controller_peripheral to embassy & simplify the peripheral support

nostd_async is broken since last stable roll out.
The pico_i2c_controller_peripheral is being migrated to use embassy's executor.
The Controller Async API is now aligned with embassy's traits to facilitate integration.

The peripheral no longer require async to run and now appears as an event iterator.

Embassy's support relies on unstable features (generic_associated_types and type_alias_impl_traits)
and is therefore gated behind the `embassy-traits` feature flag.

* make futures & embassy optional for the pico board too

* Pin embassy to a specific rev.

* Impl embassy_traits::i2c::WriteIter & enable unlimited transfer size on i2c

* Applies comment suggestion from @9names for the advanced i2c example.

Co-authored-by: 9names <60134748+9names@users.noreply.github.com>

* use `I2C block` instead of `IP`.

* Fix formatting (unnecessary space at end of line)

* Enhance explanation for why `rd_req()`  is not cleared in `Iterator::next`'s
implementation.

Co-authored-by: 9names <60134748+9names@users.noreply.github.com>
2021-11-08 23:23:28 +11:00
..
examples Implement peripheral support for i2c and an advanced example (#162) 2021-11-08 23:23:28 +11:00
src Improve clock frequency stuff for uninitialized clocks and add some examples (#64) 2021-07-26 20:24:58 +10:00
.gitignore Add bsp for Pico and Pimoroni Pico LiPo 2021-07-07 00:17:57 +10:00
Cargo.toml Implement peripheral support for i2c and an advanced example (#162) 2021-11-08 23:23:28 +11:00
README.md Addressing review comments. 2021-09-28 09:26:31 +01:00

pico - Board Support for the Raspberry Pi Pico

You should include this crate if you are writing code that you want to run on a Raspberry Pi Pico - the original launch PCB for the RP2040 chip.

This crate includes the rp2040-hal, but also configures each pin of the RP2040 chip according to how it is connected up on the Pico.

Using

To use this crate, your Cargo.toml file should contain:

pico = { git = "https://github.com/rp-rs/rp-hal.git" }

In your program, you will need to call pico::Pins::new to create a new Pins structure. This will set up all the GPIOs for any on-board devices. See the examples folder for more details.

Examples

General Instructions

To compile an example, clone the rp-hal repository and run:

rp-hal/boards/pico $ cargo build --release --example <name>

You will get an ELF file called ./target/thumbv6m-none-eabi/release/examples/<name>, where the target folder is located at the top of the rp-hal repository checkout. Normally you would also need to specify --target=thumbv6m-none-eabi but when building examples from this git repository, that is set as the default.

If you want to convert the ELF file to a UF2 and automatically copy it to the USB drive exported by the RP2040 bootloader, simply boot your board into bootloader mode and run:

rp-hal/boards/pico $ cargo run --release --example <name>

If you get an error about not being able to find elf2uf2-rs, try:

$ cargo install elf2uf2-rs

then try repeating the cargo run command above.

pico_blinky

Flashes the Pico's on-board LED on and off.

pico_gpio_in_out

Reads the 'Boot Select' pin and drives the on-board LED to match it (i.e. on when pressed, off when not pressed).

pico_rtic

Demonstrates the use of the Real-Time Interrupt-driven Concurrency Framework on the Raspberry Pi Pico.

pico_countdown_blinky

Another LED blinking example, but using a Timer in count-down mode.

Puts out an analog 'triangle wave' on GPIO 25, using the PWM hardware.

pico_usb_serial

Creates a USB Serial device on a Pico board.

The USB Serial device will print HelloWorld on start-up, and then echo any incoming characters - except that any lower-case ASCII characters are converted to the upper-case equivalent.

pico_usb_serial_interrupt

Creates a USB Serial device on a Pico board, but demonstrating handling interrupts when USB data arrives.

pico_usb_twitchy_mouse

Demonstrates emulating a USB Human Input Device (HID) Mouse. The mouse cursor will jiggle up and down.

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.

The steps are:

  1. Fork the Project by clicking the 'Fork' button at the top of the page.
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Make some changes to the code or documentation.
  4. Commit your Changes (git commit -m 'Add some AmazingFeature')
  5. Push to the Feature Branch (git push origin feature/AmazingFeature)
  6. Create a New Pull Request
  7. An admin will review the Pull Request and discuss any changes that may be required.
  8. Once everyone is happy, the Pull Request can be merged by an admin, and your work is part of our project!

Code of Conduct

Contribution to this crate is organized under the terms of the Rust Code of Conduct, and the maintainer of this crate, the rp-rs team, promises to intervene to uphold that code of conduct.

License

The contents of this repository are dual-licensed under the MIT OR Apache 2.0 License. That means you can chose either the MIT licence or the Apache-2.0 licence when you re-use this code. See MIT or APACHE2.0 for more information on each specific licence.

Any submissions to this project (e.g. as Pull Requests) must be made available under these terms.