summaryrefslogtreecommitdiff
path: root/docs/develop/cmodules.rst
diff options
context:
space:
mode:
authorDamien George <damien.p.george@gmail.com>2019-12-16 23:04:01 +1100
committerDamien George <damien.p.george@gmail.com>2019-12-19 17:07:53 +1100
commit8449e41818f26c1e3a970d7181bb82ae2d3e2278 (patch)
treeaf481b25ab0b58110085c3cd41e6adcbb820d163 /docs/develop/cmodules.rst
parente58c7ce3d64fe17a58e75616a4992921f6bc5738 (diff)
docs/develop: Add documentation on how to build native .mpy modules.
Diffstat (limited to 'docs/develop/cmodules.rst')
-rw-r--r--docs/develop/cmodules.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/develop/cmodules.rst b/docs/develop/cmodules.rst
index ba43c3dc9..a4c473347 100644
--- a/docs/develop/cmodules.rst
+++ b/docs/develop/cmodules.rst
@@ -1,3 +1,5 @@
+.. _cmodules:
+
MicroPython external C modules
==============================
@@ -17,6 +19,10 @@ more sense to keep this external to the main MicroPython repository.
This chapter describes how to compile such external modules into the
MicroPython executable or firmware image.
+An alternative approach is to use :ref:`natmod` which allows writing custom C
+code that is placed in a .mpy file, which can be imported dynamically in to
+a running MicroPython system without the need to recompile the main firmware.
+
Structure of an external C module
---------------------------------