nuttx-apps/interpreters/ficl/README.md

40 lines
1.4 KiB
Markdown
Raw Normal View History

2020-07-23 15:19:35 +02:00
# Interpreters / `ficl` Ficl
2020-07-23 15:19:35 +02:00
Ficl is a programming language interpreter designed to be embedded into other
systems as a command, macro, and development prototyping language. Ficl is an
acronym for _Forth Inspired Command Language_. See http://ficl.sourceforge.net/
2020-07-23 15:19:35 +02:00
## Build Instructions
2020-07-23 15:19:35 +02:00
Disclaimer: This installation steps have only been exercised using Ficl 4.1.0.
With new versions you will likely have to make some adjustments to this
instructtions or to the files within this directory. Think of this information
as _recommendations_ - not necessarily proven instructions.
2020-07-23 15:19:35 +02:00
1. `cd` to `interpreters/ficl`
2. Download Ficl: http://sourceforge.net/projects/ficl/files/
3. Uznip the Ficl compressed file.
2020-07-23 15:19:35 +02:00
For example, `unzip ficl-4.1.0.zip` will leave the file
`interpreters/ficl/ficl-4.1.0`.
2020-07-23 15:19:35 +02:00
4. Configure to build Ficl in the `interpreters/ficl` directory using the
`configure.sh` script.
2020-07-23 15:19:35 +02:00
For example, `./configure.sh ficl-4.1.0` will leave the Makefile fragment
`Make.srcs` in the ficl build directory.
2020-07-23 15:19:35 +02:00
5. Create your NuttX configuration. Using the `make menuconfig`, you should
select:
2020-07-23 15:19:35 +02:00
```conf
CONFIG_INTERPRETERS_FICL=y
```
2013-06-02 01:25:16 +02:00
2020-07-23 15:19:35 +02:00
6. Configure and build NuttX. On successful completion, the Ficl objects will be
available in `apps/libapps.a` and that NuttX binary will be linked against
that file. Of course, Ficl will do nothing unless you have written some
application code that uses it!