EDA Debugger

EDA debugger is used for debugging the calculation of calculated vectors and functions of the EDA subsystem. This feature is included in a group of graphic objects for pictures as an EDA debugger.

This graphic object enables, directly in its interface, to connect to any EDA calculation in the application. Calculation means loading of calculated vector or calculation of function. The whole process of debugging is controlled in the graphical interface, i.e. in the EDA debugger.

Another method of usage of EDA debugger is the initiation of calculation for debugging directly from ESL script. This method requires supporting functions of the EDA debugger. In the first step, the user must create a debugging connection with the process that executes EDA calculations. To establish this connection, use the function %HI_EDADebugOpen. The function %HI_EDADebugClose closes this connection. After creating debug connection, the user may start the calculation of the calculated vector for debugging by calling the function %HI_EDADebugVectorRec. When calling %HI_EDADebugCalcFunctionRec, it activates debugging calculation of the EDA-L formula. Functions %HI_EDADebugVectorRec and %HI_EDADebugCalcFunctionRec do not wait for finishing the calculation that was started by these functions.

Third method of usage is the possibility of editing the formula of the vector. For editing, it's necessary to insert the initial formula using function %HI_SetText. The edited entry can then be retrieved by calling the %HI_GetText function. Pressing the "Syntax Check" button generates an OnDebuggerAction event. The result of the syntax check can then be inserted using the function %HI_SetDebuggerResult.

Example of an EDA debugger that is used in a picture opened in HI:

It consists of:

• Toolbar – contains buttons that are used for starting debugging, editing and entering debug commands.
• Tabs with calculations – contains source formulas of vector calculation.
• Info tabs:
  • Compile - contains compilation and static analysis reports.
  • Debug - contains messages that were generated during the calculation.
  • Notations – contains a list of lines that contain comments beginning with the word TODO or FIXME.
  • Watch – contains the tracked variables of the selected vector.
  • Breakpoints - contains a list of breakpoints placed in the editor.
• Call stack – contains the current list of nested vectors of aborted calculation.

Toolbar

Buttons represent the commands that control debugging of calculations.

Tabs with calculation

Tabs contains the vector formulas that were used when debugging connected calculations. Vector formula occurs in tabs automatically after aborting the calculation - tabs contain all vectors that are in the current call stack. Users may manually close (hide) the tab with the vector formula and then open it again (via the list of vectors).

Info tabs

Compile

The tab contains a list of messages from the static analysis and from the syntax check (set via %HI_SetDebuggerResult)

Debug

The tab contains messages that were generated during the calculation.

Notations

The tab contains a list of lines that contain a comment beginning with the text TODO or FIXME.

Watch

Tab of the values ​​of monitored local variables of the selected vector.

 
Selection may be defined by range and name. To display the items to the last one, enter the zero at the end of the range, e.g. 3,11-14,18,25-0.

The monitored variable/group of variables can be removed from the list with the help of a popup menu. The value can be changed directly in the list of watched variables.
A Popup menu that appears over the list of variables enables to:

• remove selected variable/group of variables,
• remove all variables,
• define new values for variables,
• delete the change of the value of selected variables.

Breakpoints

The tab displays all breakpoints placed in the current vector formula.

Call stack

The call stack displays the current list of vector nesting of aborted calculations. The first vector of the calculation is at the top of the list. Double-clicking over the list enables you to select the tab with the vector formula. The row, on which the calculation was aborted, will be selected automatically.

Example of starting calculation of vector for debugging from the script

 INT _serverId, _clientId
 INT _retCode
 
 ENTRY BTN_DebugVectorRec_OnClick
  RECORD NOALIAS (SD._System_HI_EDADebugVectorRec) _paramsRec
  TIME _bt, _et
 
 ; connection to process that executes EDA calculations
  _retCode := %HI_EDADebugOpen(_DBG, _serverId, _clientId)
 
 _bt := %StrToTimeEx("2015-01-01 00:00:00", "rrrr-mm-dd hh:mi:ss")
 _et := %StrToTimeEx("2015-02-01 00:00:00", "rrrr-mm-dd hh:mi:ss")
 _paramsRec[1]^structVersion := 1
 
 ; activating calculation of vector for debugging
 _retCode := %HI_EDADebugVectorRec(_DBG, "DBG.Main", _bt, _et, _paramsRec\HBJ)
 END BTN_DebugVectorRec_OnClick
 
 ENTRY BTN_DebugClose_OnClick
 ; closing debug connection
 _retCode := %HI_EDADebugClose(_DBG)
 END BTN_DebugClose_OnClick
 
 BEGIN
 ; getting ID of process EDA Client, which uses this HI, and EDA Server, to which the client is connected
 ; it is expected that connection to EDA already exists
 CALL %EDA_GetProcessId(_serverId, _clientId, _retCode)
 END