Lard Interpreter li

Modules

Most of the functionality of li is provided by modules, which are simply tcl programs that can be loaded at startup. li looks for modules in a default directory and then in any other directories specified by the LI_LOAD_PATH environment variable.

Modules contain dependency information, so if you specify a module that requires some other lower-level module to run those lower-level modules are loaded automatically.

Some modules will only behave correctly if loaded when li first starts. These modules report an error if you try to load them at a later time.

The following modules are provided:

Core modules

The following modules are always automatically loaded and provide essential basic functionality.

li

The li module provides the mechanisms for loading other modules.

bci

The bci module implements the bcode interpreter which actually executes the bcode programs.

stdio

The stdio module supports the LARD io library by providing command-line input/output.

Command-line modules

The following modules may be loaded to add extra functionality to the command-line environment.

config

The config module provides the ability to save the configuration of the execution environment.

Graphical user interface

windows

Load the windows module to start li's graphical user interface.

Core windows modules

The following modules are automatically loaded by the windows module.

winstatus

Displays a status line.

winstdio

Displays the input/output window.

winbci

Controls loading and running bcode files from the graphical interface.

Windows modules

The following modules extend the functionality of the graphical user interface.

winconfig

Provides a graphical interface to the config module.

winmodules

Provides a menu to load other modules.

winpos

Save the size and positions of windows on the screen in a configuration file.

sourceview

sourceview provides source-level debugging features (source window, single step, breakpoints). Your program must have been compiled with the -g flag to enable source level debugging.

channels

channels interacts with the LARD channels library to provide the channel viewer facility.

signals

signals interacts with the LARD signals library to provide the signal viewer facility.

simctrl

simctrl provides timestep, run until and run for functions.

bview

bview displays the Block View window which allows animated visualisation of the simulation.

msg

msg interacts with the LARD msg command to display debug/informational messages in the time view display.

tview

tview displays the Time View window which is the basis for the channels, signals and messages displays.

selector

selector provides a window which provides a hierarchical view of the simulation, and which is used by other modules to provide selective control.

tvec

tvec Provides test vector generation for the TimeMill interface.

Command modules

The following are not true modules; rather they are used to extend provide shortcuts by enabling some simulations to be run entirely from the command line arguments.

run

Run the simulation.

quit

Quit li.