AHDL in Delphi/Pascal
MODELING LANGUAGE PASCAL
The main advantage of the modeling language is that the model (in modeling language) is compiled into an executable Dynamic Link Library (DLL), which is executed directly by the computer.The compilation of the modeling language model into the executable code can be performed by any commercial available compiler, which can generate a dynamic link library (DLL) executable file. Since the dll executable file consists of moveable code, it is only available for Windows 95/98/NT.
In this paragraph Delphi 3.0TM is chosen to construct the modeling language dll executable. As example a model of a first order differential equation is selected and described.
- In the block diagram model by using the block 'INF'. The output from the block 'INF' is y1
- As Standard Modeling Language by the file ml.dll, which is loaded in the menu 'Files' and interfacing using the blocks ToML and FromML. The output from the Standard Modeling Language is y2
- ,
- As Library Modeling Language block, the model can be used multiple times in the block diagram. To demonstrate this the output y3 and y4 are both modeled by a LibML block.
The Pascal file for the Standard Modeling Language is equal to the Pascal file for the Library Modeling Language. First the syntax of this Pascal file is discussed, second the differences between the Standard Modeling Language and the Library Modeling Language are discussed.
The Pascal file for the modeling language is displayed and consists of a number of distinct parts such as the
Section | Lines |
Library Name | 1 |
Local variable declarations | 15 to 17 |
Export section | 42 to 43 |
You always have to use this structure to set up a modeling language file.
Library Name
The name of the DLL file is inserted after the keyword LIBRARY in line 1. Use the same name as the MSDOS file name *.pas and *.dll.
Header
Line 2 to 14 show the header of the modeling language. The header indicates the start of a function in the modeling language. The name of the function is inserted after the keyword Function in line 2. This function name has to be included in the export section of the modeling language, see line 42 and 43. For standard modeling language the function name should be StandardML. For Library Modeling Language any name can be chosen. In this example the name StandardML is chosen to make the file compatible between Standard Modeling Language and Library Modeling Language. In this way the ML.DLL file can be accessed as Standard Modeling Language using ToML blocks, or as Library Modeling Language using the LibML block.
In the header the variables for data interfacing to the block diagram are declared. The common type is an array of extended. Only the address of this array is passed through the header, indicated by the keyword var in the lines 3 to 13.
Header, Input
Inputs of the block LibML for Library Modeling Language. For Standard Modeling Language this array is a copy of the array bus
Header, Bus
Inputs for the standard modeling language via the block ToML and output for the Standard Modeling Language via the block FromML. The array bus serves as a storage array for both the Standard Modeling Language and the Library Modeling Language.
You can build a counter based on the array bus like
bus[3]:=bus[3]+1;
Here bus variable number 3; bus[3] is used as counter. Also a shift register can be based on the array bus. You can store sampled data in the array using the following code
If Trigger>0 then |
Initial conditions for the differential equations in the modeling language.
Header, x
State variable array for the differential equations in the modeling language.
Header, dxdt
Derivative of the state variable array for the differential equations in the modeling language.
Header, Reserve1,..., Reserve4
Reserved arrays for future version of modeling language in CASPOC.
Header, p
Simulation parameters from CASPOC are available in the modeling language via the array p. In version 1.6 the following parameters are defined
p[1] Procedure number for the Standard Modeling Language as defined in the ToML and FromML blocks. p[1]=0 indicates the initialization of the modeling language.
p[2] Simulation time t.
p[3] Integration time step dt.
Header, m
Reserved arrays for future version of modeling language in CASPOC.
End of the header
Line 14 indicates the end of the header. The output of the function is of the type extended and is set as the output of the block LibML. The keyword EXPORT; indicates that the function is exported, see also line 43.
Local variable declarations
In line 15, 16 and 17 local variables are defined. all variables for algebraic operations involving the arrays from the header have to be declared of the type extended. Notice that the local variables loose their content after leaving the function in the modeling language. Therefore you can use them only for intermediate calculations within a function.
Main function
The code for the modeling language starts with Begin in line 18 and ends with End; in line 41.
The Case statement is used to identify different codes for initialization indicated by p[1]=0 and different procedure numbers indicated by p[1]. In this example only procedure number 1 is used as indicated in line 27. In the ToML and FromML blocks in the block diagram only procedure number 1 is used for the Standard Modeling Language. In the case of Library Modeling Language p[1]=0 for the initialization. During the rest of the simulation p[1]=1 for the Library Modeling Language.
Initialization of the bus variables is done directly on the array bus. Initialization of the differential equations is performed on the array x0.
The inputs for the LibML blocks are stored in the array Input for the Library Modeling Language. For the Standard Modeling Language the inputs defined in the block ToML are stored in the array bus. Before a call to the Standard Modeling Language the array bus is copied to the array input. In this way there is compatibility between the Standard Modeling Language and the Library Modeling Language. You can't use the array input for storage of data.
The actual model, the first order differential equation is modeled at line 32. Notice that the array dxdt can only be placed at the left side of the := symbol.
The string at line 36, stored in m[1], will appear in the menu 'Data', item 'Bus variables'.
The output for the Library Modeling Language of the block LibML is defined in line 40.
Export
The keyword Exports is used to export the name of the function in the dynamic link library file. In this way CASPOC can identify your function in the modeling language. Include here the names of the functions you defined in the headers.
End
Include a Begin End. Notice in the Pascal file to indicate the end of the library file, see line 44 and 45.
You can include more functions in a library. Each function should have its own header and main function as indicated by the lines 2 to 41.
The keyword Exports is defined only once. Each name of a function has to be included after the keyword exports.
Only the function with the name StandardML can be used for Standard Modeling Language.
* Definition of the step function
t TIME
K CON 0.5
tau CON 2
step SIGNAL t 0 1 1 0 0 0 1 5
* Block diagram model
* y(0) K tau
y1 INF step 0.2 0.5 2
* Standard Modeling Language
T_1 ToML K 1 1
T_2 ToML tau 1 2
T_3 ToML step 1 3
y2 FromML 1 4
* Library Modeling Language
y3 LibML data/ml/ml.dll StandardML(K,tau,step)
y4 LibML data/ml/ml.dll StandardML(K,tau,step)
* Value of bus[4] after a call to LibML by y3
bus4 BUS y3 4
.end
{ 1} LIBRARY ML; ; uses SysUtils, Classes; |