blob: c207f594ac4c68e1a0b68b14efb9a6d3a57ef80d (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
apps/interpreters README file
=============================
This apps/ directory is set aside to hold interpreters that may be
incorporated into NuttX.
ficl
----
This is DIY port of Ficl (the "Forth Inspired Command Language"). See
http://ficl.sourceforge.net/. It is a "DIY" port because the Ficl source
is not in that directory, only an environment and instructions that will
let you build Ficl under NuttX. The rest is up to you.
micropython
-----------
This is a port of a build environment for Micro Python:
https://micropython.org/
Configuration Options:
CONFIG_INTERPRETERS_MICROPYTHON - Enables support for the Micro Python
interpreter
CONFIG_INTERPRETERS_MICROPYTHON_URL - URL where Micro Python can be
downloaded. default "https://github.com/micropython/micropython/archive".
There are more recent snapshots at https://micropython.org/download/
CONFIG_INTERPRETERS_MICROPYTHON_VERSION - Version number. Default "1.3.8"
CONFIG_INTERPRETERS_MICROPYTHON_APPNAME - Executable name. Only needed
if CONFIG_NSH_BUILTIN_APPS=y. Default: "micropython"
CONFIG_INTERPRETERS_MICROPYTHON_STACKSIZE - Interpreter stack size. Only
needed if CONFIG_NSH_BUILTIN_APPS=y. Default: 2048
CONFIG_INTERPRETERS_MICROPYTHON_PRIORITY - Interpreter priority. Only
needed if CONFIG_NSH_BUILTIN_APPS=y. Default: 100
CONFIG_INTERPRETERS_MICROPYTHON_PROGNAME - Program name. Only needed
if CONFIG_BUILD_KERNEL=y. Default: "micropython"
NOTE that Micro Python is not included in this directory. Be default,
it will be downloaded at build time from the github . You can avoid
this download by pre-installing Micro Python. Before building, just
download Micro Python from:
https://micropython.org/download/
https://github.com/micropython/micropython/releases
Or clone from the GIT repository at:
https://github.com/micropython/
https://github.com/micropython/micropython
The Micro Python should be provided as a tarbll name:
apps/interpreters/micropython/v$(CONFIG_INTERPRETERS_MICROPYTHON_VERSION).tar.gz
and the unpacked code should reside in directory at:
apps/interpreters/micropython/micropython-$(CONFIG_INTERPRETERS_MICROPYTHON_VERSION)
This port was contributed by Dave Marples using Micro Python circa
1.3.8. It may not be compatible with other versions.
NOTES:
1. Micro Python will not build on Windows with a Windows native toolchain
due to use of POSIX paths in the Micro Python build system. It should build
correctly on Linux or under Cygwin with the NuttX buildroot tools.
2. Micro Python will not run correctly on a 64-bit target (such as the NuttX
simulation on a 64-bit platfform). In that case it generates assertions
like:
OverflowError: long int not supported in this build
This change to mpconfigport.h is a partial work-around but does not solve
all issues:
-#define MICROPY_LONGINT_IMPL (MICROPY_LONGINT_IMPL_MPL)
+#define MICROPY_LONGINT_IMPL (MICROPY_LONGINT_IMPL_LONGLONG)
Someday it will probably be necessary to autogenerate the mpconfigport.h
header file with the correct properties for the target system.\
pcode
-----
At present, only the NuttX Pascal add-on is supported. This NuttX add-on
must be downloaded separately (or is available in an GIT snapshot in the
misc/pascal directory).
This Pascal add-on must be installed into the NuttX apps/ directory. After
unpacking the Pascal add-on package, an installation script and README.txt
instructions can be found at pascal/nuttx.
INSTALL.sh -- The script that performs the operation. Usage:
./INSTALL.sh [-16|-32] <install-dir>
If you are using this standard NuttX apps/ package, the correct
location for the <install-dir> is apps/interpreters. That is
where the examples and build logic will expect to find the pcode
sub-directory.
Example:
./INSTALL.sh -16 $PWD/../../../apps/interpreters
After installation, the NuttX apps/interpresters directory will contain
the following files
pcode
|-- Makefile
|-- include
| `-- Common header files
|-- libboff
| `-- Pascal object format (POFF) library
`--insn
|-- include
| `-- model-specific header files
`-- prun
`-- model-specific source files
pashello
There is a simple Pascal example at apps/examples/pashello. This is the
standard "Hello, World!" example written in Pascal and interpreted from
Pascal P-Code at runtime. To use this example, place the following in
your defonfig file:
CONFIG_EXAMPLES_PASHELLO=y
CONFIG_INTERPRETERS_PCODE=y
prun
This directory holds some simple, convenience functions to simplify and
standardize the interaction with the P-Code library.
|
