45 lines
1.7 KiB
ReStructuredText
45 lines
1.7 KiB
ReStructuredText
|
===============================
|
||
|
``ficl`` Ficl Forth interpreter
|
||
|
===============================
|
||
|
|
||
|
Ficl is a programming language interpreter designed to be embedded into other
|
||
|
systems as a command, macro, and development prototyping language.
|
||
|
|
||
|
This is DIY port of Ficl (the "Forth Inspired Command Language"). See
|
||
|
http://ficl.sourceforge.net/. It is a "" 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.
|
||
|
|
||
|
Build Instructions
|
||
|
------------------
|
||
|
|
||
|
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.
|
||
|
|
||
|
1. ``cd`` to ``interpreters/ficl``
|
||
|
|
||
|
2. Download Ficl: http://sourceforge.net/projects/ficl/files/
|
||
|
|
||
|
3. Uznip the Ficl compressed file.
|
||
|
|
||
|
For example, ``unzip ficl-4.1.0.zip`` will leave the file
|
||
|
``interpreters/ficl/ficl-4.1.0``.
|
||
|
|
||
|
4. Configure to build Ficl in the ``interpreters/ficl`` directory using the
|
||
|
``configure.sh`` script.
|
||
|
|
||
|
For example, ``./configure.sh ficl-4.1.0`` will leave the Makefile fragment
|
||
|
``Make.srcs`` in the ficl build directory.
|
||
|
|
||
|
5. Create your NuttX configuration. Using the ``make menuconfig``, you should
|
||
|
select::
|
||
|
|
||
|
CONFIG_INTERPRETERS_FICL=y
|
||
|
|
||
|
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!
|