bencorrado / wm-sdk

SDK to develop applications on the MCU running Wirepas Stack

Wirepas SDK

This repository contains Wirepas SDK, which allows the development of an application to be executed on the same chip as Wirepas Stack. This application is often referred as a Single-MCU application.

⚠️

To use the SDK, you need to have access to the Wirepas binaries. You need to have SLA agreement with Wirepas to get them. If you would like to become a SLA licensee, please contact [e-mail]

• Overview
• Documentation
• Wirepas binaries
• Environment
• How to build an application
• License

Overview

The following diagram, describes the main components of the SDK.

Documentation

The documentation of the SDK is written with Doxygen and generated on HTML format. In order to access it, please clone the repository locally and open the SDK_documentation.html link available at the root of the SDK with your favorite web browser.

Some information are available on this page too but it is just a subset of what the html documentation contains.

Wirepas binaries

As a Wirepas SLA licensee, you should have received access to protected zipped archive containing the Wirepas binaries. Please extract them at the root of image folder (All the *.a, *.hex and *.conf files must be at the root of this folder).

Environment

This SDK relies on GNU Arm toolchain. To use the SDK you will need to fulfill the following requirements:

1. A GCC Arm toolchain (version 7.2.1 is recommended)
2. The make tool
3. python 3.x
4. pycryptodome package for python (can be installed with pip)

In order to validate that your environment is correctly configured, you should be able to build the custom_app application.

For more information, please refer to Documentation Chapter

How to build an application

This SDK supports multiple target boards. All of them are listed under board folder and can be selected with target_board=<target_board>

This SDK contains multiple application examples that can be found under source folder and can be selected with app_name=<app_name>

⚠️

The first time you'll build an application, you'll be prompted to choose bootloader keys. Once chosen the first time, they will be used for all your images and must be kept secret. It is also possible to define keys per application.

To build the custom_app application for pca10040 board, please execute following command.

    make app_name=custom_app target_board=pca10040

After execution of this command, you should find the final_image_custom_app.hex under build/pca10040/custom_app folder.

For more information, please refer to Documentation Chapter

License

See LICENSE for full license details.