mirror of
https://github.com/ferrous-systems/embedded-trainings-2020.git
synced 2024-06-16 04:00:42 +00:00
61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# BSC Exercise
|
|
|
|
In this exercise you will learn how to write a board support crate by implementing buttons and the UARTE peripheral.
|
|
|
|
The template `down-the-stack/dk_bsc/src/lib.rs` already contains the LED and Timer implementations.
|
|
|
|
You can test after each step by running the following command out of `down-the-stack/apps`
|
|
```
|
|
cargo run --bin hello
|
|
```
|
|
|
|
This program will not call any of the functions you are implementing, so it does not matter if they are incomplete. It will refuse to build if there are errors present in the lib!
|
|
|
|
Note for trainer: Introduction to the exercise is a guided tour through the template, and it's architecture. Make the participants aware of the placeholders for their implementations. run the hello example on the unmodified lib.
|
|
|
|
|
|
## You will learn how to
|
|
* modify the `init()` function that brings up the board's peripherals
|
|
* how to configure pins
|
|
* how to write a function that checks the state of a pin
|
|
* write methods for a `struct`
|
|
* UARTE implementation
|
|
* implement a Trait
|
|
* to document and generate docs for your own library!
|
|
|
|
## Prerequisites
|
|
[todo!]
|
|
|
|
## Tasks
|
|
* Write a button implementation. This entails the following steps
|
|
✅ `struct Buttons` with 4 fields, that represents each of the four buttons
|
|
✅ `struct Button` that is a wrapper for the pin that a single button is connected to
|
|
✅ a method `is_pushed` that checks if a single button is pushed.
|
|
✅ initialize the pins in `fn init()`
|
|
✅ add the `struct Button` to the definition and instantiation of `struct Board`.
|
|
✅ Run `apps/buttons.rs` to test.
|
|
* Write a UARTE implementation.
|
|
|
|
## Knowledge
|
|
|
|
## Representation of Peripherals
|
|
The boards peripherals are represented as nested structs. The `struct Board` contains fields that represent single peripherals or groups of peripherals as structs, which in turn either contain a field of the single peripheral or ...
|
|
|
|
You have to add structs to represent the buttons and the UARTE peripheral to the board struct.
|
|
[todo!]
|
|
|
|
## Comments
|
|
[todo!]
|
|
|
|
## impl blocks
|
|
[todo!]
|
|
## Visibility of structs, fields and functions: the pub keyword
|
|
[todo!]
|
|
|
|
## Hardware documentation for pin configuration
|
|
|
|
Go to [Nordic Infocenter](https://infocenter.nordicsemi.com/topic/ug_nrf52840_dk/UG/dk/intro.html) to download the User Guide. You can find all the information that is relevant to this exercise in there.
|
|
|
|
|
|
|