Callback Functions

Callback functions are special functions that execute in the non-real-time part of the controller. For example, if the controller is running in a real-time operating system, it cannot access files directly on the PC. Thus, when the controller encounters a File access function, it pauses the AeroScript program and triggers the execution of the function in the non-real-time environment.

There is a full list of callback functions in the Callback Functions table at the end of this page.

Callback Function Execution

The steps that follow show the order in which the controller executes a callback function:

The controller pauses the AeroScript program that is currently running.
The controller generates a callback interrupt.
The communication service, which runs in the non-real-time environment, gets the callback interrupt and sends a signal to the controller that it received the callback interrupt.

IMPORTANT: If this step does not occur in a sufficient quantity of time, the controller will return a CallbackNotRegistered error. When this error occurs, there is no application registered to handle the callback.

A host application retrieves the callback data and does the applicable function.
When the callback function is completed, the host application tells the controller to continue.
The controller continues to execute the AeroScript program.

Custom Callback

Use custom callbacks to pass execution to an external process that will be handled by the .NET, C, or Python API. These APIs expose the ability to handle callbacks of a specific callback identification number.

When the custom callback function is called from AeroScript, program execution waits for any registered .NET, C, or Python callback handler to execute. These handlers read the specified input arguments and, if applicable, they do operations based on those arguments.

For Example

The handlers can pass some data as an argument to a file or send data over the network.

Execution of the AeroScript program continues when the callback handler returns in the .NET, C, or Python API. The callback handler can return doubles, integers, strings, or any combination of these values to the AeroScript program.

For information about how to use the Callback() AeroScript function with the .NET, C, or Python API, see the Handle AeroScript Callbacks section of .NET Tasks, C Tasks, or Python Tasks.

function Callback($id as integer, $integerInputs[] as integer, $realInputs[] as real, $stringInputs[] as string, ref $integerOutputs[] as integer, ref $realOutputs[] as real, ref $stringOutputs[] as string)

Triggers a custom callback to be handled by an external process.

Arguments

$id The id number of the callback.

$integerInputs A list of integers to be provided to the external callback function.

$realInputs A list of reals to be provided to the external callback function.

$stringInputs A list of strings to be provided to the external callback function.

ref $integerOutputs A list of integers returned from the external callback function.

ref $realOutputs A list of reals returned from the external callback function.

ref $stringOutputs A list of strings returned from the external callback function.

Callback Functions

The table that follows includes a full list of callback functions.

Table: Callback Functions

Function Name	Description
`Callback()`	Raises a custom callback that the .NET, C, or Python API handles. See the Handle AeroScript Callbacks section of .NET Tasks, C Tasks, or Python Tasks for more information.
`ProgramLoad()`	Loads a program to the specified task. See Program Control for more information.
`ProgramRun()`	Runs a program on the specified task. See Program Control for more information.
`DateTimeGet()`	Gets the current time on the controller. See DateTime Functions for more information.
`DateTimeExtract*()` Functions	Extracts the specified time component from the given epoch time. See DateTime Functions for more information.
`FileOpenBinary()` / `FileOpenText()`	Opens a file for binary or text I/O. See Open and Close a Handle for more information.
`FileClose()`	Closes the specified file. See Open and Close a Handle for more information.
`FileSetByteOffset()`	Sets the current byte offset for reading and writing in the specified file. See File Position for more information.
`FileGetByteOffset()`	Gets the current byte offset for reading and writing in the specified file. See File Position for more information.
`FileIsEndOfFile()`	Returns whether the current reading offset is at the end of the file. See File Position for more information.
`FileSize()`	Returns the size of the specified file. See File Position for more information.
`FileTextReadLine()` / `FileTextReadString()`	Reads a line or string from a text file. See Text Files for more information.
`FileTextWriteString()`	Writes a string to a text file. See Text Files for more information.
`FileBinaryRead*()` Functions	Returns data from a binary file interpreted as the specified data type. See Reading Binary Files for more information.
`FileBinaryWrite*()` Functions	Converts data to a specified data type and writes it to the specified file. See Writing Binary Files for more information.
`DirectoryCount()`	Returns the number of subdirectories within the specified directory. See Directories for more information.
`DirectoryFileCopy()`	Copies the specified file. See Directories for more information.
`DirectoryFileCount()`	Returns the number of files within the specified directory. See Directories for more information.
`DirectoryFileDelete()`	Deletes the specified file. See Directories for more information.
`DirectoryFileExists()`	Returns whether the specified file exists. See Directories for more information.
`DirectoryFileGetFileName()`	Returns the name of the file with the specified index within the specified directory. See Directories for more information.
`DirectoryFileMove()`	Moves the specified file. See Directories for more information.
`DirectoryGetName()`	Returns the name of the subdirectory with the specified index within the specified directory. See Directories for more information.
`DataCollectionAddAxisSignal()` / `DataCollectionAddTaskSignal()` / `DataCollectionAddSystemSignal()`	Adds an axis, task, or system status signal to the data collection configuration. See Configure Axis Signals, Configure Task Signals, and Configure System Signals for more information.
`DataCollectionReset()`	Resets the data collection configuration. See Configure Data Collection for more information.
`DataCollectionStart()`	Starts real-time data collection. See Start and Stop Data Collection for more information.
`DataCollectionStop()`	Stops real-time data collection. See Start and Stop Data Collection for more information.
`AppDataCollectionAddAxisSignal()` / `AppDataCollectionAddTaskSignal()` / `AppDataCollectionAddSystemSignal()`	Adds an axis, task, or system status signal to the data collection configuration. See Configure Axis Signals, Configure Task Signals, and Configure System Signals for more information.
`AppDataCollectionAddIndustrialEthernetMappingSignal()`	Adds an Industrial Ethernet mapping signal to the application's data collection configuration. See Configure Industrial Ethernet Signals for more information.
`AppDataCollectionReset()`	Resets the data collection configuration. See Configure Data Collection for more information.
`AppDataCollectionConfigure()`	Configures application data collection. See Configure the Number of Samples and Sample Time for Data Collection for more information.
`AppDataCollectionAutoSaveOn()` / `AppDataCollectionAutoSaveOff()`	Enables or disables the operation that automatically saves data collected through the `AppDataCollectionSnapshot()` function. See Configure Auto-Save for Snapshots for more information.
`CalibrationLoad()`	Loads and activates the specified axis calibration file or galvo power correction file. See Calibration Functions for more information.
`CalibrationUnload()`	Deactivates and unloads the calibration for the specified calibration type. See Calibration Functions for more information.
`AppIndicatorOn()`	Turns on all indicators with the specified ID. See `AppIndicatorOn()` for more information.
`AppIndicatorOff()`	Turns off all indicators with the specified ID. See `AppIndicatorOff()` for more information.
`AppMessageBox()`	Shows a message box that gives you information with a specified severity. See Message Box for more information.
`AppMessageDisplay()`	Shows the specified message. See Message Notifications for more information.
`AppMessageDisplayDismiss()`	Clears all of the application message notifications. See Message Notifications for more information.
`AppMessageFileOpen()`	Shows a dialog box that you can use to select a file to open. See File Open for more information.
`AppMessageFileSave()`	Shows a dialog box that you can use to select a file to save. See File Save for more information.
`AppMessageInputBox()`	Shows a message box that retrieves input data. See Message Input for more information.
`AppMessageMenu()`	Shows a list of items that you can select. See Message Menu for more information.
`AppFrequencyResponsePerformStabilityAnalysis()`	Does a stability analysis on a saved frequency response file and returns the stability metrics. See Stability Analysis for more information.
`AppFrequencyResponseTriggerMultisinePlus()`	Triggers a MultisinePlus frequency response transmission on the specified axis. See Frequency Response for more information.
`AppFrequencyResponseTriggerSinusoid()`	Triggers a Sinusoidal frequency response transmission on the specified axis. See Frequency Response for more information.
`AppFrequencyResponseTriggerWhiteNoise()`	Triggers a White Noise frequency response transmission on the specified axis. See Frequency Response for more information.
`AppFrequencyResponseTriggerMultisine()`	Triggers a Multisine frequency response transmission on the specified axis. See Frequency Response for more information.