beautypg.com

External_output( ) procedure, Usercode blocks, External_output( ) procedure -11 – National Instruments AutoCode NI MATRIX User Manual

Page 73: Usercode blocks -11

background image

Chapter 3

Ada Language Reference

© National Instruments Corporation

3-11

AutoCode Reference

External_Input( )

is much the same; it returns an input vector from

the software data bus.

External_Input( )

returns the value of

SCHEDULER_STATUS

, which is passed to it by the scheduler.

External_Output( ) Procedure

procedure External_Output(Bus: in RT_REAL_ARRAY;

YE_PTR: in RT_INTEGER;

NUMOUT: in RT_INTEGER;

SCHEDULER_STATUS: out INTEGER)

External_Output

is for use in simulation comparison mode. It

places output data values into an output pool in memory. In the target
version of

sa_utils.a/.ada

, the operation of

External_Output( )

is much the same; it posts an output vector to the software data bus.

External_Output( )

returns the value of

SCHEDULER_STATUS

,

which is passed to it by the scheduler.

UserCode Blocks

This section describes how to link UserCode Blocks (UCBs) with
AutoCode or SystemBuild applications.

Linking Handwritten UCBs with AutoCode Applications

To write the implementation code for UserCode Blocks (UCBs), refer to
the

sa_user_.a/.ada

and

sa_user.a/.ada

files, which are provided

in your

src

directory. These files contain an example of the declaration of

the calling sequence described in the

Calling UCBs

section. Make one or

more copies of these files and insert your code that implements the
functionality of the UCBs. You can place one or more uniquely named
UCB code procedures inside each copy of the

sa_user_.a/.ada

and

sa_user.a/.ada

files and give the copies any convenient names. If you

include renamed files, place the names in the stand-alone file compilation
script (

compile_ada_sa.sh

) for automatic compilation.

The computations performed by UCBs can update both block states and
outputs.