RIOT-OS/RIOT
RIOT-OS/RIOT
1
0
Fork 0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Code Releases Activity
d724e71a26
RIOT/examples/bindist
History
Gaëtan Harter d724e71a26 makefiles: Add an APPLICATION_MODULE variable 
Set the application module name with APPLICATION_MODULE.
The default module name is "application_$(APPLICATION)".

This should fix name conflicts where an application/test has the same name as
an existing module and so both write to the same archive.
2018-01-30 17:27:03 +01:00
..
abc examples: add example for "make bindist" 2016-03-30 11:00:31 +02:00
main.c examples: add example for "make bindist" 2016-03-30 11:00:31 +02:00
Makefile makefiles: Add an APPLICATION_MODULE variable 2018-01-30 17:27:03 +01:00
README.md examples/bindist: some improvements 2017-08-29 18:04:00 +02:00

README.md

Introduction

RIOT allows for creating a "binary distribution", which can be used to ship proprietary, compiled objects in a way that makes it possible to re-link them against a freshly compiled RIOT. This "binary distribution" also contains version information and md5 hashes of a linked binary, making verification of correctness of a link possible.

This application serves as simple example for "make bindist". It consists of an application module (bindist.a) and another example module (abc.a).

See https://github.com/RIOT-OS/RIOT/wiki/LGPL-guide for background information.

Instructions

Calling "make bindist" creates a folder "bindist", which only contains the compiled and linked binary, bindist.a, abc.a and Makefiles.

In order to recompile RIOT, adjust "RIOTBASE" in Makefile to point to a RIOT source checkout, then call "make check_bindist".

RIOT will be build as usual, but just take the pre-compiled bindist.a and abc.a. Their source is not necessary. The resulting binary will then be compared with te precompiled "bindist.elf" (using md5sum) and the result gets printed. If the same RIOT source tree and build environment (compiler version, etc.) was used, the binaries should match.

Step-by-step:

  1. cd /examples/bindist

  2. make all

  3. make bindist

  4. cd bindist

  5. <adjust RIOTBASE variable (../.. -> ../../..)

  6. make check_bindist

Needed Makefile changes

In order to enable "make bindist" for your application, several things have to be changed in the main application's Makefile.

See this application's Makefile as example.