nrfxlib-sys 0.1.2

Rust bindings to the Nordic nRF9160 Socket Library.
docs.rs failed to build nrfxlib-sys-0.1.2
Please check the build logs and, if you believe this is docs.rs' fault, open an issue.

nrfxlib-sys

This is a Rust wrapper for the Nordic nrfxlib driver, specifically libbsd for the nRF9160.

You will need to set the NRFXLIB_PATH environment variable to point to a checkout of https://github.com/NordicPlayground/nrfxlib. Be sure to comply with Nordic's licence for that repository.

You will also need to set the NEWLIB_PATH environment variable to point to a locally installed copy of the newlib C library headers. This is because Nordic's nrfxlib headers include <sys/types.h>, amongst other things. On Ubuntu, you might use /usr/include/newlib. If you have installed a GCC release from Arm, look in /opt/gcc* somewhere.

user@machine:~ $ git clone https://github.com/NordicPlayground/nrfxlib
user@machine:~ $ export NRFXLIB_PATH=~/nrfxlib
user@machine:~ $ export NEWLIB_PATH=/usr/include/newlib
user@machine:~ $ cd some_project
user@machine:~/some_project $ cargo build

Any binary which uses this crate is going to need to provide a bunch of C library functions, because Nordic's library expects them. This includes, but is not limited to:

  • atoi
  • snprintf
  • strol

You can't just link newlib, because that defines memset which clashes with the compiler-builtin definition of memset. Answers on a post-card please.

Licence

Any of the code in this specific repository is under the Blue Oak Licence. The Nordic components that you build this library with are under their own licence.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.

Changelog

Unreleased Changes (Source | Changes)

  • None

v0.1.2 (Source | Changes)

  • Add NEWLIB_PATH so user can point to correct newlib headers.

v0.1.1 (Source | Changes)

  • Updates to the README and crate metadata

v0.1.0 (Source)

  • First version