micropython/examples/embedding
Jim Mussared 45ac651d1a all: Rename *umodule*.c to remove the "u" prefix.
Updates any includes, and references from Makefiles/CMake.

This essentially reverts what was done long ago in commit
136b5cbd76

This work was funded through GitHub Sponsors.

Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
2023-06-08 17:54:17 +10:00
..
Makefile examples/embedding: Rework example to use ports/embed. 2023-01-20 22:28:50 +11:00
Makefile.upylib all: Rename *umodule*.c to remove the "u" prefix. 2023-06-08 17:54:17 +10:00
README.md all: Fix spelling mistakes based on codespell check. 2023-04-27 18:03:06 +10:00
main.c examples/embedding: Rework example to use ports/embed. 2023-01-20 22:28:50 +11:00
micropython_embed.mk examples/embedding: Rework example to use ports/embed. 2023-01-20 22:28:50 +11:00
mpconfigport.h examples/embedding: Rework example to use ports/embed. 2023-01-20 22:28:50 +11:00

README.md

Example of embedding MicroPython in a standalone C application

This directory contains a simple example of how to embed MicroPython in an existing C application.

A C application is represented here by the file main.c. It executes two simple Python scripts which print things to the standard output.

Building the example

First build the embed port using:

$ make -f micropython_embed.mk

This will generate the micropython_embed directory which is a self-contained copy of MicroPython suitable for embedding. The .c files in this directory need to be compiled into your project, in whatever way your project can do that. The example here uses make and a provided Makefile.

To build the example project, based on main.c, use:

$ make

That will create an executable called embed which you can run:

$ ./embed

Out of tree build

This example is set up to work out of the box, being part of the MicroPython tree. Your application will be outside of this tree, but the only thing you need to do for that is to change MICROPYTHON_TOP (found in micropython_embed.mk) to point to the location of the MicroPython repository. The MicroPython repository may, for example, be a git submodule in your project.