8 releases (4 breaking)
0.18.0 | May 25, 2024 |
---|---|
0.17.1 | Apr 18, 2024 |
0.16.1 | Mar 5, 2024 |
0.16.0 | Oct 26, 2022 |
0.14.1 | Jan 3, 2022 |
#1857 in Embedded development
530KB
11K
SLoC
Hardware Abstration Layer for the Nordic nRF5340
This crate is a Hardware Abstraction Layer (HAL) for the Nordic nRF5340. It
wraps the PAC (nrf5340-pac
) and provides high level wrappers for the chip's
peripherals.
This crate knows nothing about your PCB layout, or which pins you have assigned to which functions. The only exception are the examples, which are written to run on the official nRF5340-DK developer kit.
Usage
You will require the thumbv8m.main-none-eabihf
target installed.
$ rustup target add thumbv8m.main-none-eabihf
Secure vs Non-Secure
This HAL is designed to run in non-secure mode, as should most of your application code. You will therefore need a 'bootloader' which starts in secure mode, moves the required peripherals into 'non-secure' world, and then jumps to your application.
We have succesfully used Nordic's Secure Partition Manager
from nRF SDK v1.7. SPM v1.7 is configured to expect your application at address
0x0005_0000
and so that is what memory.x
must specify as the start of Flash.
Note: Other versions of SPM might expect a different start address -
especially those compiled as a child image of another application (like
at_sample
)! You can see the start address on boot-up:
SPM: NS image at 0x50000
This tells you SPM is looking for a non-secure (NS) image at 0x0005_0000
.
To build SPM, run:
$ west init -m https://github.com/nrfconnect/sdk-nrf --mr v1.5.1 ncs
$ cd ncs
$ west update # This takes *ages*
$ cd nrf/examples/spm
$ west build --board=nrf5340dk_nrf5340_cpuapp
$ west flash
West is a Python tool supplied by Nordic for building the nRF Connect SDK. See Nordic's website for more details.
Your nRF5340-DK will now have SPM installed between 0x0000_0000
and
0x0004_FFFF
. Flashing your application at 0x0005_0000
should not affect SPM,
provided you do not select erase entire chip or somesuch!
If you want to change the flash address, supply your own memory.x
file in your
application crate (or your Board Support Crate) and write a build.rs
file that
copies your memory.x
over the top of this one.
Licence
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~10MB
~270K SLoC