@@ -72,6 +72,7 @@ Alternatively, fallback implementation based on setjmp/longjmp can be used.
72
72
73
73
To build (see section below for required dependencies):
74
74
75
+ $ git submodule update --init
75
76
$ cd ports/unix
76
77
$ make axtls
77
78
$ make
@@ -104,32 +105,36 @@ Standard library modules come from
104
105
External dependencies
105
106
---------------------
106
107
107
- Building Unix version requires some dependencies installed. For
108
+ Building MicroPython ports may require some dependencies installed.
109
+
110
+ For Unix port, ` libffi ` library and ` pkg-config ` tool are required. On
108
111
Debian/Ubuntu/Mint derivative Linux distros, install ` build-essential `
109
112
(includes toolchain and make), ` libffi-dev ` , and ` pkg-config ` packages.
110
113
111
- Other dependencies can be built together with MicroPython. Oftentimes,
112
- you need to do this to enable extra features or capabilities. To build
114
+ Other dependencies can be built together with MicroPython. This may
115
+ be required to enable extra features or capabilities, and in recent
116
+ versions of MicroPython, these may be enabled by default. To build
113
117
these additional dependencies, first fetch git submodules for them:
114
118
115
119
$ git submodule update --init
116
120
117
- Use this same command to get the latest versions of dependencies, as
118
- they are updated from time to time. After that, in ` ports/unix/ ` dir, execute:
121
+ Use the same command to get the latest versions of dependencies, as
122
+ they are updated from time to time. After that, in the port directory
123
+ (e.g. ` ports/unix/ ` ), execute:
119
124
120
125
$ make deplibs
121
126
122
127
This will build all available dependencies (regardless whether they
123
128
are used or not). If you intend to build MicroPython with additional
124
129
options (like cross-compiling), the same set of options should be passed
125
- to ` make deplibs ` . To actually enabled use of dependencies, edit
130
+ to ` make deplibs ` . To actually enable/disable use of dependencies, edit
126
131
` ports/unix/mpconfigport.mk ` file, which has inline descriptions of the options.
127
- For example, to build SSL module (required for ` upip ` tool described above) ,
128
- set ` MICROPY_PY_USSL ` to 1.
132
+ For example, to build SSL module (required for ` upip ` tool described above,
133
+ and so enabled by dfeault), ` MICROPY_PY_USSL ` should be set to 1.
129
134
130
- In ` ports/unix/mpconfigport.mk ` , you can also disable some dependencies enabled
131
- by default, like FFI support, which requires libffi development files to
132
- be installed .
135
+ For some ports, building required dependences is transparent, and happens
136
+ automatically. They still need to be fetched with the git submodule command
137
+ above .
133
138
134
139
The STM32 version
135
140
-----------------
@@ -141,6 +146,7 @@ https://launchpad.net/gcc-arm-embedded
141
146
142
147
To build:
143
148
149
+ $ git submodule update --init
144
150
$ cd ports/stm32
145
151
$ make
146
152
0 commit comments