Creating external modules

Sometimes, it may be desirable to develop a new module in a repository outside of the RIOT repository. This can be accomplished with external modules, which are created as follows:

In the Makefile of your application

You will have to add the following lines to the Makefile of each application using your external module:

EXTERNAL_MODULE_DIRS += /path/to/my/module

USEMODULE += my_module
INCLUDES += -I/path/to/the/include/folder/of/my/module

In the Makefile of your external module

As with all modules, your makefile should contain at least

include $(RIOTBASE)/Makefile.base

There are no changes necessary.

Please note that this feature exists for convenient development only. It is discouraged to open pul requests containing Makefiles using external modules.